@cratis/chronicle 0.0.1

package/dist/Events/Constraints/IConstraint.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=IConstraint.js.map

package/dist/Events/Constraints/IConstraint.js.map

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

package/dist/Events/Constraints/IConstraintBuilder.d.ts

@@ -0,0 +1,37 @@
+import { IUniqueConstraintBuilder } from './IUniqueConstraintBuilder';
+/**
+ * Defines the builder for building constraints.
+ * Matches the C# IConstraintBuilder contract.
+ */
+export interface IConstraintBuilder {
+    /**
+     * Scopes the constraint per event source type.
+     * @returns This builder for fluent chaining.
+     */
+    perEventSourceType(): IConstraintBuilder;
+    /**
+     * Scopes the constraint per event stream type.
+     * @returns This builder for fluent chaining.
+     */
+    perEventStreamType(): IConstraintBuilder;
+    /**
+     * Scopes the constraint per event stream identifier.
+     * @returns This builder for fluent chaining.
+     */
+    perEventStreamId(): IConstraintBuilder;
+    /**
+     * Starts building a unique constraint using a fluent builder callback.
+     * @param callback - Callback that configures the unique constraint via {@link IUniqueConstraintBuilder}.
+     * @returns This builder for fluent chaining.
+     */
+    unique(callback: (builder: IUniqueConstraintBuilder) => void): IConstraintBuilder;
+    /**
+     * Adds a unique constraint for a specific event type.
+     * This means there can only be one instance of this event type per event source identifier.
+     * @param message - Optional violation message.
+     * @param name - Optional constraint name.
+     * @returns This builder for fluent chaining.
+     */
+    uniqueFor(eventType: Function, message?: string, name?: string): IConstraintBuilder;
+}
+//# sourceMappingURL=IConstraintBuilder.d.ts.map

package/dist/Events/Constraints/IConstraintBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConstraintBuilder.d.ts","sourceRoot":"","sources":["../../../Events/Constraints/IConstraintBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,CAAC;IAEzC;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,CAAC;IAEzC;;;OAGG;IACH,gBAAgB,IAAI,kBAAkB,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,kBAAkB,CAAC;IAElF;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACvF"}

package/dist/Events/Constraints/IConstraintBuilder.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=IConstraintBuilder.js.map

package/dist/Events/Constraints/IConstraintBuilder.js.map

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

package/dist/Events/Constraints/IConstraints.d.ts

@@ -0,0 +1,23 @@
+import { ConstraintId } from './ConstraintId';
+/**
+ * Defines a system to work with constraints, including discovery and registration with the Kernel.
+ */
+export interface IConstraints {
+    /**
+     * Discovers all constraints from the registered client artifacts.
+     * @returns A promise that resolves when discovery is complete.
+     */
+    discover(): Promise<void>;
+    /**
+     * Registers all discovered constraints with the Chronicle Kernel.
+     * @returns A promise that resolves when registration is complete.
+     */
+    register(): Promise<void>;
+    /**
+     * Checks whether a constraint exists for the given identifier.
+     * @param id - The constraint identifier to look up.
+     * @returns True if a matching constraint exists; otherwise false.
+     */
+    hasFor(id: ConstraintId): boolean;
+}
+//# sourceMappingURL=IConstraints.d.ts.map

package/dist/Events/Constraints/IConstraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConstraints.d.ts","sourceRoot":"","sources":["../../../Events/Constraints/IConstraints.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC;CACrC"}

package/dist/Events/Constraints/IConstraints.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=IConstraints.js.map

package/dist/Events/Constraints/IConstraints.js.map

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

package/dist/Events/Constraints/IUniqueConstraintBuilder.d.ts

@@ -0,0 +1,44 @@
+import { PropertyAccessor } from '@cratis/fundamentals';
+/**
+ * Defines the builder for building unique constraints.
+ * Matches the C# IUniqueConstraintBuilder contract.
+ */
+export interface IUniqueConstraintBuilder {
+    /**
+     * Defines the name of the unique constraint.
+     * The name is optional and if not provided, it will use the type name the constraint belongs to.
+     * @param name - Name to use.
+     * @returns This builder for fluent chaining.
+     */
+    withName(name: string): IUniqueConstraintBuilder;
+    /**
+     * Constrains on specific properties of an event type.
+     * @param properties - Property accessor expressions for specifying the properties on the event.
+     * @returns This builder for fluent chaining.
+     */
+    on<TEvent>(...properties: PropertyAccessor<TEvent>[]): IUniqueConstraintBuilder;
+    /**
+     * Ignores casing when comparing property values during constraint evaluation.
+     * @returns This builder for fluent chaining.
+     */
+    ignoreCasing(): IUniqueConstraintBuilder;
+    /**
+     * Specifies the event type that removes this unique constraint (e.g. a deletion event).
+     * @param eventType - The event constructor that removes the constraint.
+     * @returns This builder for fluent chaining.
+     */
+    removedWith(eventType: Function): IUniqueConstraintBuilder;
+    /**
+     * Specifies a static message to use when the unique constraint is violated.
+     * @param message - The violation message.
+     * @returns This builder for fluent chaining.
+     */
+    withMessage(message: string): IUniqueConstraintBuilder;
+    /**
+     * Specifies a provider function that produces the violation message dynamically.
+     * @param messageProvider - Callback that returns the violation message.
+     * @returns This builder for fluent chaining.
+     */
+    withMessageFrom(messageProvider: () => string): IUniqueConstraintBuilder;
+}
+//# sourceMappingURL=IUniqueConstraintBuilder.d.ts.map

package/dist/Events/Constraints/IUniqueConstraintBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUniqueConstraintBuilder.d.ts","sourceRoot":"","sources":["../../../Events/Constraints/IUniqueConstraintBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAEjD;;;;OAIG;IACH,EAAE,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,wBAAwB,CAAC;IAEhF;;;OAGG;IACH,YAAY,IAAI,wBAAwB,CAAC;IAEzC;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,QAAQ,GAAG,wBAAwB,CAAC;IAE3D;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAEvD;;;;OAIG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,MAAM,GAAG,wBAAwB,CAAC;CAC5E"}

package/dist/Events/Constraints/IUniqueConstraintBuilder.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=IUniqueConstraintBuilder.js.map

package/dist/Events/Constraints/IUniqueConstraintBuilder.js.map

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

package/dist/Events/Constraints/UniqueConstraintBuilder.d.ts

@@ -0,0 +1,42 @@
+import { PropertyAccessor } from '@cratis/fundamentals';
+import { IUniqueConstraintBuilder } from './IUniqueConstraintBuilder';
+/** Captured definition of a unique constraint event entry. */
+export interface UniqueConstraintEventEntry {
+    eventTypeId: string;
+    properties: string[];
+}
+/** Captured definition of a unique constraint. */
+export interface UniqueConstraintCapture {
+    name?: string;
+    eventDefinitions: UniqueConstraintEventEntry[];
+    ignoreCasing: boolean;
+    removedWithEventTypeId?: string;
+    message?: string;
+}
+/**
+ * Implements {@link IUniqueConstraintBuilder}, capturing the unique constraint definition
+ * for later serialization and registration with the Kernel.
+ */
+export declare class UniqueConstraintBuilder implements IUniqueConstraintBuilder {
+    private readonly _capture;
+    private _currentEventTypeId?;
+    constructor(capture: UniqueConstraintCapture);
+    /** @inheritdoc */
+    withName(name: string): IUniqueConstraintBuilder;
+    /** @inheritdoc */
+    on<TEvent>(...properties: PropertyAccessor<TEvent>[]): IUniqueConstraintBuilder;
+    /** @inheritdoc */
+    ignoreCasing(): IUniqueConstraintBuilder;
+    /** @inheritdoc */
+    removedWith(eventType: Function): IUniqueConstraintBuilder;
+    /** @inheritdoc */
+    withMessage(message: string): IUniqueConstraintBuilder;
+    /** @inheritdoc */
+    withMessageFrom(messageProvider: () => string): IUniqueConstraintBuilder;
+    /**
+     * Sets the current event type context for subsequent {@link on} calls.
+     * @param eventTypeId - The event type identifier string.
+     */
+    withEventType(eventTypeId: string): UniqueConstraintBuilder;
+}
+//# sourceMappingURL=UniqueConstraintBuilder.d.ts.map

package/dist/Events/Constraints/UniqueConstraintBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueConstraintBuilder.d.ts","sourceRoot":"","sources":["../../../Events/Constraints/UniqueConstraintBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAoC,MAAM,sBAAsB,CAAC;AAE1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAUtE,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,mBAAmB,CAAC,CAAS;gBAEzB,OAAO,EAAE,uBAAuB;IAI5C,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB;IAKhD,kBAAkB;IAClB,EAAE,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,wBAAwB;IAc/E,kBAAkB;IAClB,YAAY,IAAI,wBAAwB;IAKxC,kBAAkB;IAClB,WAAW,CAAC,SAAS,EAAE,QAAQ,GAAG,wBAAwB;IAM1D,kBAAkB;IAClB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB;IAKtD,kBAAkB;IAClB,eAAe,CAAC,eAAe,EAAE,MAAM,MAAM,GAAG,wBAAwB;IAKxE;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB;CAI9D"}

package/dist/Events/Constraints/UniqueConstraintBuilder.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 { PropertyPathResolverProxyHandler } from '@cratis/fundamentals';
+import { getEventTypeFor } from '../eventTypeDecorator';
+/** Resolves a property path string from a {@link PropertyAccessor}. */
+function resolvePropertyPath(accessor) {
+    const handler = new PropertyPathResolverProxyHandler();
+    const proxy = new Proxy({}, handler);
+    accessor(proxy);
+    return handler.path;
+}
+/**
+ * Implements {@link IUniqueConstraintBuilder}, capturing the unique constraint definition
+ * for later serialization and registration with the Kernel.
+ */
+export class UniqueConstraintBuilder {
+    _capture;
+    _currentEventTypeId;
+    constructor(capture) {
+        this._capture = capture;
+    }
+    /** @inheritdoc */
+    withName(name) {
+        this._capture.name = name;
+        return this;
+    }
+    /** @inheritdoc */
+    on(...properties) {
+        if (!this._currentEventTypeId) {
+            return this;
+        }
+        const paths = properties.map(p => resolvePropertyPath(p));
+        const existing = this._capture.eventDefinitions.find(d => d.eventTypeId === this._currentEventTypeId);
+        if (existing) {
+            existing.properties.push(...paths);
+        }
+        else {
+            this._capture.eventDefinitions.push({ eventTypeId: this._currentEventTypeId, properties: paths });
+        }
+        return this;
+    }
+    /** @inheritdoc */
+    ignoreCasing() {
+        this._capture.ignoreCasing = true;
+        return this;
+    }
+    /** @inheritdoc */
+    removedWith(eventType) {
+        const et = getEventTypeFor(eventType);
+        this._capture.removedWithEventTypeId = et.id.value;
+        return this;
+    }
+    /** @inheritdoc */
+    withMessage(message) {
+        this._capture.message = message;
+        return this;
+    }
+    /** @inheritdoc */
+    withMessageFrom(messageProvider) {
+        this._capture.message = messageProvider();
+        return this;
+    }
+    /**
+     * Sets the current event type context for subsequent {@link on} calls.
+     * @param eventTypeId - The event type identifier string.
+     */
+    withEventType(eventTypeId) {
+        this._currentEventTypeId = eventTypeId;
+        return this;
+    }
+}
+//# sourceMappingURL=UniqueConstraintBuilder.js.map

package/dist/Events/Constraints/UniqueConstraintBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueConstraintBuilder.js","sourceRoot":"","sources":["../../../Events/Constraints/UniqueConstraintBuilder.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAoB,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,uEAAuE;AACvE,SAAS,mBAAmB,CAAI,QAA6B;IACzD,MAAM,OAAO,GAAG,IAAI,gCAAgC,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAU,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC,IAAI,CAAC;AACxB,CAAC;AAiBD;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACf,QAAQ,CAA0B;IAC3C,mBAAmB,CAAU;IAErC,YAAY,OAAgC;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,QAAQ,CAAC,IAAY;QACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,EAAE,CAAS,GAAG,UAAsC;QAChD,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACtG,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,YAAY;QACR,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,WAAW,CAAC,SAAmB;QAC3B,MAAM,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QACnD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,eAAe,CAAC,eAA6B;QACzC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,eAAe,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,WAAmB;QAC7B,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC;QACvC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/Events/Constraints/constraint.d.ts

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import { ConstraintId } from './ConstraintId';
+/**
+ * Metadata stored on a constraint class.
+ */
+export interface ConstraintMetadata {
+    /** The unique identifier for the constraint. */
+    readonly id: ConstraintId;
+}
+/**
+ * TypeScript decorator that marks a class as an event constraint.
+ * The decorated class may implement {@link IConstraint} to define the constraint rules.
+ * @param id - The unique identifier for the constraint. Defaults to the class name if omitted.
+ * @returns A class decorator.
+ */
+export declare function constraint(id?: string): ClassDecorator;
+/**
+ * Gets the {@link ConstraintMetadata} associated with a class decorated with {@link constraint}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export declare function getConstraintMetadata(target: Function): ConstraintMetadata | undefined;
+/**
+ * Checks whether a class has been decorated with {@link constraint}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a constraint decorator; false otherwise.
+ */
+export declare function isConstraint(target: Function): boolean;
+//# sourceMappingURL=constraint.d.ts.map

package/dist/Events/Constraints/constraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint.d.ts","sourceRoot":"","sources":["../../../Events/Constraints/constraint.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,GAAE,MAAW,GAAG,cAAc,CAY1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEtD"}

package/dist/Events/Constraints/constraint.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 'reflect-metadata';
+import { ConstraintId } from './ConstraintId';
+import { DecoratorType, TypeDiscoverer } from '../../types';
+/** Metadata key used to store constraint information on a class. */
+const CONSTRAINT_METADATA_KEY = 'chronicle:constraint';
+/**
+ * TypeScript decorator that marks a class as an event constraint.
+ * The decorated class may implement {@link IConstraint} to define the constraint rules.
+ * @param id - The unique identifier for the constraint. Defaults to the class name if omitted.
+ * @returns A class decorator.
+ */
+export function constraint(id = '') {
+    return (target) => {
+        const constructor = target;
+        const constraintId = new ConstraintId(id || constructor.name);
+        const metadata = { id: constraintId };
+        Reflect.defineMetadata(CONSTRAINT_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.Constraint, constructor, constraintId.value);
+    };
+}
+/**
+ * Gets the {@link ConstraintMetadata} associated with a class decorated with {@link constraint}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export function getConstraintMetadata(target) {
+    return Reflect.getMetadata(CONSTRAINT_METADATA_KEY, target);
+}
+/**
+ * Checks whether a class has been decorated with {@link constraint}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a constraint decorator; false otherwise.
+ */
+export function isConstraint(target) {
+    return Reflect.hasMetadata(CONSTRAINT_METADATA_KEY, target);
+}
+//# sourceMappingURL=constraint.js.map

package/dist/Events/Constraints/constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint.js","sourceRoot":"","sources":["../../../Events/Constraints/constraint.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,oEAAoE;AACpE,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAUvD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE;IACtC,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,MAAkB,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAuB,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;QAC1D,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,UAAU,EACxB,WAA0B,EAC1B,YAAY,CAAC,KAAK,CACrB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgB;IACzC,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/Events/Constraints/index.d.ts

@@ -0,0 +1,13 @@
+export { ConstraintId } from './ConstraintId';
+export type { IConstraint } from './IConstraint';
+export type { IConstraintBuilder } from './IConstraintBuilder';
+export type { IUniqueConstraintBuilder } from './IUniqueConstraintBuilder';
+export { constraint, getConstraintMetadata, isConstraint } from './constraint';
+export type { ConstraintMetadata } from './constraint';
+export type { IConstraints } from './IConstraints';
+export { Constraints } from './Constraints';
+export { ConstraintBuilder } from './ConstraintBuilder';
+export type { ConstraintCapture, ConstraintScopeCapture, UniqueEventTypeCapture } from './ConstraintBuilder';
+export { UniqueConstraintBuilder } from './UniqueConstraintBuilder';
+export type { UniqueConstraintCapture, UniqueConstraintEventEntry } from './UniqueConstraintBuilder';
+//# sourceMappingURL=index.d.ts.map

package/dist/Events/Constraints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../Events/Constraints/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/Events/Constraints/index.js

@@ -0,0 +1,8 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { ConstraintId } from './ConstraintId';
+export { constraint, getConstraintMetadata, isConstraint } from './constraint';
+export { Constraints } from './Constraints';
+export { ConstraintBuilder } from './ConstraintBuilder';
+export { UniqueConstraintBuilder } from './UniqueConstraintBuilder';
+//# sourceMappingURL=index.js.map

package/dist/Events/Constraints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../Events/Constraints/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/Events/EventContext.d.ts

@@ -0,0 +1,20 @@
+import { EventType } from './EventType';
+import { CausationEntry } from './CausationEntry';
+/**
+ * Represents contextual information about an appended event.
+ */
+export interface EventContext {
+    /** The sequence number of the event in the event sequence. */
+    readonly sequenceNumber: number;
+    /** The unique identifier of the event source. */
+    readonly eventSourceId: string;
+    /** The type of the event. */
+    readonly eventType: EventType;
+    /** The timestamp when the event occurred. */
+    readonly occurred: Date;
+    /** The correlation identifier for the event. */
+    readonly correlationId: string;
+    /** The causation chain for the event. */
+    readonly causation: ReadonlyArray<CausationEntry>;
+}
+//# sourceMappingURL=EventContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventContext.d.ts","sourceRoot":"","sources":["../../Events/EventContext.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;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,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;CACrD"}

package/dist/Events/EventContext.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=EventContext.js.map

package/dist/Events/EventContext.js.map

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

package/dist/Events/EventType.d.ts

@@ -0,0 +1,23 @@
+import { EventTypeId } from './EventTypeId';
+import { EventTypeGeneration } from './EventTypeGeneration';
+/**
+ * Represents the type of an event.
+ */
+export declare class EventType {
+    readonly id: EventTypeId;
+    readonly generation: EventTypeGeneration;
+    readonly tombstone: boolean;
+    /** Represents an unknown event type. */
+    static readonly unknown: EventType;
+    constructor(id: EventTypeId, generation: EventTypeGeneration, tombstone?: boolean);
+    /** @inheritdoc */
+    toString(): string;
+    /**
+     * Parse from a string representation of event type to actual type.
+     * The expected format is id+generation. Ex: EmployeeHired+1.
+     * @param input - The string representation to parse.
+     * @returns The parsed EventType.
+     */
+    static parse(input: string): EventType;
+}
+//# sourceMappingURL=EventType.d.ts.map

package/dist/Events/EventType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventType.d.ts","sourceRoot":"","sources":["../../Events/EventType.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,qBAAa,SAAS;IAKd,QAAQ,CAAC,EAAE,EAAE,WAAW;IACxB,QAAQ,CAAC,UAAU,EAAE,mBAAmB;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO;IAN/B,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CAAC,OAAO,YAAwE;gBAGlF,EAAE,EAAE,WAAW,EACf,UAAU,EAAE,mBAAmB,EAC/B,SAAS,GAAE,OAAe;IAGvC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;IAIlB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;CAUzC"}

package/dist/Events/EventType.js

@@ -0,0 +1,40 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { EventTypeId } from './EventTypeId';
+import { EventTypeGeneration } from './EventTypeGeneration';
+/**
+ * Represents the type of an event.
+ */
+export class EventType {
+    id;
+    generation;
+    tombstone;
+    /** Represents an unknown event type. */
+    static unknown = new EventType(EventTypeId.unknown, EventTypeGeneration.first, false);
+    constructor(id, generation, tombstone = false) {
+        this.id = id;
+        this.generation = generation;
+        this.tombstone = tombstone;
+    }
+    /** @inheritdoc */
+    toString() {
+        return `${this.id.value}+${this.generation.value}`;
+    }
+    /**
+     * Parse from a string representation of event type to actual type.
+     * The expected format is id+generation. Ex: EmployeeHired+1.
+     * @param input - The string representation to parse.
+     * @returns The parsed EventType.
+     */
+    static parse(input) {
+        const segments = input.split('+');
+        if (segments.length === 1) {
+            return new EventType(new EventTypeId(segments[0]), EventTypeGeneration.first, false);
+        }
+        if (segments.length === 2) {
+            return new EventType(new EventTypeId(segments[0]), new EventTypeGeneration(parseInt(segments[1], 10)), false);
+        }
+        return new EventType(new EventTypeId(segments[0]), new EventTypeGeneration(parseInt(segments[1], 10)), segments[2] === 'true');
+    }
+}
+//# sourceMappingURL=EventType.js.map

package/dist/Events/EventType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventType.js","sourceRoot":"","sources":["../../Events/EventType.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,OAAO,SAAS;IAKL;IACA;IACA;IANb,wCAAwC;IACxC,MAAM,CAAU,OAAO,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAE/F,YACa,EAAe,EACf,UAA+B,EAC/B,YAAqB,KAAK;QAF1B,OAAE,GAAF,EAAE,CAAa;QACf,eAAU,GAAV,UAAU,CAAqB;QAC/B,cAAS,GAAT,SAAS,CAAiB;IACpC,CAAC;IAEJ,kBAAkB;IAClB,QAAQ;QACJ,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa;QACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,SAAS,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,SAAS,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAClH,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IACnI,CAAC"}

package/dist/Events/EventTypeGeneration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Represents the generation of an event type.
+ */
+export declare class EventTypeGeneration {
+    readonly value: number;
+    /** The first generation value. */
+    static readonly firstValue = 1;
+    /** The first generation of any event type. */
+    static readonly first: EventTypeGeneration;
+    constructor(value: number);
+    /** @inheritdoc */
+    toString(): string;
+}
+//# sourceMappingURL=EventTypeGeneration.d.ts.map

package/dist/Events/EventTypeGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventTypeGeneration.d.ts","sourceRoot":"","sources":["../../Events/EventTypeGeneration.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,mBAAmB;IAOhB,QAAQ,CAAC,KAAK,EAAE,MAAM;IANlC,kCAAkC;IAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAK;IAE/B,8CAA8C;IAC9C,MAAM,CAAC,QAAQ,CAAC,KAAK,sBAA2D;gBAE3D,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/Events/EventTypeGeneration.js

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the generation of an event type.
+ */
+export class EventTypeGeneration {
+    value;
+    /** The first generation value. */
+    static firstValue = 1;
+    /** The first generation of any event type. */
+    static first = new EventTypeGeneration(EventTypeGeneration.firstValue);
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value.toString();
+    }
+}
+//# sourceMappingURL=EventTypeGeneration.js.map

package/dist/Events/EventTypeGeneration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventTypeGeneration.js","sourceRoot":"","sources":["../../Events/EventTypeGeneration.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAOP;IANrB,kCAAkC;IAClC,MAAM,CAAU,UAAU,GAAG,CAAC,CAAC;IAE/B,8CAA8C;IAC9C,MAAM,CAAU,KAAK,GAAG,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhF,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC"}

package/dist/Events/EventTypeId.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Represents the unique identifier for an event type.
+ */
+export declare class EventTypeId {
+    readonly value: string;
+    /**
+     * Represents an unknown event type identifier.
+     */
+    static readonly unknown: EventTypeId;
+    constructor(value: string);
+    /** @inheritdoc */
+    toString(): string;
+}
+//# sourceMappingURL=EventTypeId.d.ts.map

package/dist/Events/EventTypeId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventTypeId.d.ts","sourceRoot":"","sources":["../../Events/EventTypeId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,WAAW;IAMR,QAAQ,CAAC,KAAK,EAAE,MAAM;IALlC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,cAA2D;gBAE7D,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/Events/EventTypeId.js

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the unique identifier for an event type.
+ */
+export class EventTypeId {
+    value;
+    /**
+     * Represents an unknown event type identifier.
+     */
+    static unknown = new EventTypeId('00000000-0000-0000-0000-000000000000');
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=EventTypeId.js.map

package/dist/Events/EventTypeId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventTypeId.js","sourceRoot":"","sources":["../../Events/EventTypeId.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,WAAW;IAMC;IALrB;;OAEG;IACH,MAAM,CAAU,OAAO,GAAG,IAAI,WAAW,CAAC,sCAAsC,CAAC,CAAC;IAElF,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC"}

package/dist/Events/EventTypes.d.ts

@@ -0,0 +1,33 @@
+import { Constructor } from '@cratis/fundamentals';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import { EventTypeId } from './EventTypeId';
+import { IEventTypes } from './IEventTypes';
+/**
+ * Implements {@link IEventTypes}, managing discovery and registration of event types
+ * with the Chronicle Kernel.
+ */
+export declare class EventTypes implements IEventTypes {
+    private readonly _eventStore;
+    private readonly _connection;
+    private readonly _clientArtifacts;
+    private readonly _types;
+    /**
+     * Creates a new {@link EventTypes} instance.
+     * @param _eventStore - The name of the event store these types 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(): Constructor[];
+    /** @inheritdoc */
+    discover(): Promise<void>;
+    /** @inheritdoc */
+    register(): Promise<void>;
+    /** @inheritdoc */
+    hasFor(id: EventTypeId): boolean;
+    /** @inheritdoc */
+    getTypeFor(id: EventTypeId): Constructor;
+}
+//# sourceMappingURL=EventTypes.d.ts.map