@cratis/chronicle 6.47.0 → 6.49.0

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

@@ -20,6 +20,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. */

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,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;CACrC"}

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/toClientEventContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toClientEventContext.d.ts","sourceRoot":"","sources":["../../events/toClientEventContext.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA2B5E"}
+{"version":3,"file":"toClientEventContext.d.ts","sourceRoot":"","sources":["../../events/toClientEventContext.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA4B5E"}

package/dist/events/toClientEventContext.js

@@ -16,6 +16,7 @@ export function toClientEventContext(context) {
         eventSourceType: context.EventSourceType,
         eventStreamType: context.EventStreamType,
         eventStreamId: context.EventStreamId,
+        eventSource: context.EventSource ? context.EventSource : undefined,
         subject: context.Subject,
         hash: context.Hash,
         observationState: context.ObservationState,

package/dist/events/toClientEventContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"toClientEventContext.js","sourceRoot":"","sources":["../../events/toClientEventContext.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC1D,OAAO;QACH,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5C,SAAS,EAAE,IAAI,SAAS,CACpB,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAC5C,IAAI,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,mBAAmB,CAAC,UAAU,CAAC,EACxF,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,KAAK,CACxC;QACD,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;QACjD,aAAa,EAAE,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;QAClE,SAAS,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7E,UAAU,EAAE,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;KAC1D,CAAC;AACN,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAsC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1I,CAAC"}
+{"version":3,"file":"toClientEventContext.js","sourceRoot":"","sources":["../../events/toClientEventContext.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC1D,OAAO;QACH,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAClE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5C,SAAS,EAAE,IAAI,SAAS,CACpB,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAC5C,IAAI,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,mBAAmB,CAAC,UAAU,CAAC,EACxF,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,KAAK,CACxC;QACD,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;QACjD,aAAa,EAAE,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;QAClE,SAAS,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7E,UAAU,EAAE,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;KAC1D,CAAC;AACN,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAsC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1I,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as events from './events/index.js';
 import * as eventSequences from './eventSequences/index.js';
+import * as eventSources from './eventSources/index.js';
 import * as reactors from './reactors/index.js';
 import * as reducers from './reducers/index.js';
 import * as seeding from './seeding/index.js';
@@ -43,6 +44,7 @@ export { ChronicleLogLevel } from './logging/ChronicleLogLevel.js';
 export { DiagChronicleLogger } from './logging/DiagChronicleLogger.js';
 export * from './events/index.js';
 export * from './eventSequences/index.js';
+export * from './eventSources/index.js';
 export * from './reactors/index.js';
 export * from './reducers/index.js';
 export * from './seeding/index.js';
@@ -65,5 +67,5 @@ export * from './transactions/index.js';
 export * from './eventStoreSubscriptions/index.js';
 export * from './compliance/index.js';
 export * from './confidentiality/index.js';
-export { events, eventSequences, reactors, reducers, seeding, readModels, projections, jobs, patterns, webhooks, externalServices, identities, observation, sinks, schemas, types, artifacts, identity, auditing, correlation, transactions, eventStoreSubscriptions, compliance, confidentiality, };
+export { events, eventSequences, eventSources, reactors, reducers, seeding, readModels, projections, jobs, patterns, webhooks, externalServices, identities, observation, sinks, schemas, types, artifacts, identity, auditing, correlation, transactions, eventStoreSubscriptions, compliance, confidentiality, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -2,6 +2,7 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 import * as events from './events/index.js';
 import * as eventSequences from './eventSequences/index.js';
+import * as eventSources from './eventSources/index.js';
 import * as reactors from './reactors/index.js';
 import * as reducers from './reducers/index.js';
 import * as seeding from './seeding/index.js';
@@ -40,6 +41,7 @@ export { ChronicleLogLevel } from './logging/ChronicleLogLevel.js';
 export { DiagChronicleLogger } from './logging/DiagChronicleLogger.js';
 export * from './events/index.js';
 export * from './eventSequences/index.js';
+export * from './eventSources/index.js';
 export * from './reactors/index.js';
 export * from './reducers/index.js';
 export * from './seeding/index.js';
@@ -62,5 +64,5 @@ export * from './transactions/index.js';
 export * from './eventStoreSubscriptions/index.js';
 export * from './compliance/index.js';
 export * from './confidentiality/index.js';
-export { events, eventSequences, reactors, reducers, seeding, readModels, projections, jobs, patterns, webhooks, externalServices, identities, observation, sinks, schemas, types, artifacts, identity, auditing, correlation, transactions, eventStoreSubscriptions, compliance, confidentiality, };
+export { events, eventSequences, eventSources, reactors, reducers, seeding, readModels, projections, jobs, patterns, webhooks, externalServices, identities, observation, sinks, schemas, types, artifacts, identity, auditing, correlation, transactions, eventStoreSubscriptions, compliance, confidentiality, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/projections/eventContextPropertyExpression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventContextPropertyExpression.d.ts","sourceRoot":"","sources":["../../projections/eventContextPropertyExpression.ts"],"names":[],"mappings":"AA+CA,kGAAkG;AAClG,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAuB3E"}
+{"version":3,"file":"eventContextPropertyExpression.d.ts","sourceRoot":"","sources":["../../projections/eventContextPropertyExpression.ts"],"names":[],"mappings":"AAgDA,kGAAkG;AAClG,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAuB3E"}

package/dist/projections/eventContextPropertyExpression.js

@@ -20,6 +20,7 @@ const contextProperties = {
     correlationId: true,
     causation: true,
     tags: true
+    // eventSource is deliberately not projectable: its kernel resolution is not part of the supported expression set.
 };
 // Mirror the kernel's DerivedPropertyFunctions registry: Week() applies to dates only.
 const derivedFunctions = { week: 'Week' };

package/dist/projections/eventContextPropertyExpression.js.map

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

package/dist/readModels/IReadModelWatcher.d.ts

@@ -0,0 +1,30 @@
+import type { ReadModelChangeset } from './ReadModelChangeset.js';
+/**
+ * A single-consumer stream of read model changes, started when createWatcher() is called.
+ * Terminal stream or connection failures retain buffered changes: iteration drains them
+ * before rejecting with the original error. Overflow and disposal discard buffered changes.
+ */
+export interface IReadModelWatcher<TReadModel> extends AsyncIterable<ReadModelChangeset<TReadModel>> {
+    /**
+     * Resolves on the kernel's subscription acknowledgment, without requiring iteration.
+     * When resumption is opted into, read this property again after disconnect for the next subscription.
+     * An already pending promise carries across lifecycle reconnects; a previously resolved
+     * promise cannot be revoked. Rejects if the watcher stops before acknowledgment.
+     */
+    readonly subscribed: Promise<void>;
+    /**
+     * Registers a callback after each subscription acknowledgment following the first.
+     * Having at least one registered callback opts into resumption on transport failures and
+     * completion. Without callbacks or the resume option, transport errors reject iteration.
+     * Refresh your query here: changes during an outage are not replayed. Register before
+     * awaiting subscribed; callbacks are not replayed for late registrations.
+     * Callbacks run in registration order and are awaited before reading more changes on
+     * the resumed stream. Do not wait for iteration inside a callback. A thrown error or
+     * rejected promise fails iteration. Reconnects retain already received changes.
+     * @returns An idempotent function that unregisters the callback. Disposal also unregisters it.
+     */
+    onResubscribed(callback: () => void | Promise<void>): () => void;
+    /** Stops the stream and completes pending iteration. Safe to call more than once. */
+    dispose(): void;
+}
+//# sourceMappingURL=IReadModelWatcher.d.ts.map

package/dist/readModels/IReadModelWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReadModelWatcher.d.ts","sourceRoot":"","sources":["../../readModels/IReadModelWatcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,UAAU,CAAE,SAAQ,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChG;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;IAEjE,qFAAqF;IACrF,OAAO,IAAI,IAAI,CAAC;CACnB"}

package/dist/readModels/IReadModelWatcher.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=IReadModelWatcher.js.map

package/dist/readModels/IReadModelWatcher.js.map

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

package/dist/readModels/IReadModels.d.ts

@@ -1,6 +1,8 @@
 import type { Constructor } from '@cratis/fundamentals';
 import type { IMaterializedReadModels } from './IMaterializedReadModels.js';
+import type { IReadModelWatcher } from './IReadModelWatcher.js';
 import type { ReadModelChangeset } from './ReadModelChangeset.js';
+import type { ReadModelWatchOptions } from './ReadModelWatchOptions.js';
 import type { ReadModelSnapshot } from './ReadModelSnapshot.js';
 /**
  * Defines a system that works with read models in the event store.
@@ -54,11 +56,23 @@ export interface IReadModels {
      */
     getSnapshotsById<TReadModel>(readModelType: Constructor<TReadModel>, key: string): Promise<ReadModelSnapshot<TReadModel>[]>;
     /**
-     * Watches changes for a specific read model type.
+     * Watches changes for a specific read model type, opening the stream on the first next().
+     * Pulls changes only as the consumer requests them, without a client-side buffer or overflow limit.
      * @param readModelType - The read model type to observe.
-     * @returns An async iterable of read model changes.
+     * @returns An async iterable of read model changes. Transport failures reject iteration.
+     * @remarks Keeps its original return type so existing watch implementations and mocks can
+     * return plain async iterables. Use createWatcher for readiness and lifetime controls.
      */
     watch<TReadModel>(readModelType: Constructor<TReadModel>): AsyncIterable<ReadModelChangeset<TReadModel>>;
+    /**
+     * Starts a single-consumer watcher immediately, without requiring iteration for readiness.
+     * @param readModelType - The read model type to observe.
+     * @param options - Cancellation, opt-in resumption, and an optional overflow-failure limit.
+     * @returns A watcher with subscription readiness, resubscription callbacks, and explicit disposal.
+     * Transport failures reject iteration unless resume is true or an onResubscribed callback
+     * is registered. Resumed watches retain received changes but do not replay outage gaps.
+     */
+    createWatcher<TReadModel>(readModelType: Constructor<TReadModel>, options?: ReadModelWatchOptions): IReadModelWatcher<TReadModel>;
     /**
      * Dehydrates a read model session.
      * @param sessionId - The session identifier to dehydrate.

package/dist/readModels/IReadModels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IReadModels.d.ts","sourceRoot":"","sources":["../../readModels/IReadModels.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAE/C;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;;;OAQG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE1H;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAElI;;;;;OAKG;IACH,YAAY,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7G;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAE5H;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzG;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpH;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvG;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEhH;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtJ"}
+{"version":3,"file":"IReadModels.d.ts","sourceRoot":"","sources":["../../readModels/IReadModels.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAE/C;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;;;OAQG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE1H;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAElI;;;;;OAKG;IACH,YAAY,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7G;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAE5H;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzG;;;;;;;OAOG;IACH,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAElI;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpH;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvG;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEhH;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtJ"}