@cratis/chronicle 0.0.1

package/Projections/declarative/IAddBuilder.ts

@@ -0,0 +1,18 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines a builder for configuring an add operation on a read model property.
+ * @template TEvent - The event type.
+ * @template TParentBuilder - The parent builder type for fluent return.
+ */
+export interface IAddBuilder<TEvent, TParentBuilder> {
+    /**
+     * Adds the value of the specified event property to the read model property.
+     * @param eventPropertyAccessor - Accessor for the source property on the event.
+     * @returns The parent builder for fluent chaining.
+     */
+    with(eventPropertyAccessor: PropertyAccessor<TEvent>): TParentBuilder;
+}

package/Projections/declarative/IAddChildBuilder.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines a builder for configuring how a child model is added from an event.
+ * @template TChildModel - The child model type.
+ * @template TEvent - The event type.
+ */
+export interface IAddChildBuilder<TChildModel, TEvent> {
+    /**
+     * Specifies the property on the child model used to identify instances in the collection.
+     * @param childPropertyAccessor - Accessor for the identifying property on the child model.
+     * @returns This builder for fluent chaining.
+     */
+    identifiedBy(childPropertyAccessor: PropertyAccessor<TChildModel>): IAddChildBuilder<TChildModel, TEvent>;
+
+    /**
+     * Specifies the event property used as the key when adding a child.
+     * @param eventPropertyAccessor - Accessor for the key property on the event.
+     * @returns This builder for fluent chaining.
+     */
+    usingKey(eventPropertyAccessor: PropertyAccessor<TEvent>): IAddChildBuilder<TChildModel, TEvent>;
+}

package/Projections/declarative/IAllSetBuilder.ts

@@ -0,0 +1,31 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines a builder for set operations that apply to all events (fromEvery).
+ * @template TReadModel - The read model type.
+ * @template TParentBuilder - The parent builder type for fluent return.
+ */
+export interface IAllSetBuilder<TReadModel, TParentBuilder> {
+    /**
+     * Maps the value to the specified read model property.
+     * @param readModelPropertyAccessor - Accessor for the target property on the read model.
+     * @returns The parent builder for fluent chaining.
+     */
+    to(readModelPropertyAccessor: PropertyAccessor<TReadModel>): TParentBuilder;
+
+    /**
+     * Maps the value from a named event context property.
+     * @param contextPropertyName - The name of the event context property to read from.
+     * @returns The parent builder for fluent chaining.
+     */
+    toEventContextProperty(contextPropertyName: string): TParentBuilder;
+
+    /**
+     * Maps the value from the event source identifier.
+     * @returns The parent builder for fluent chaining.
+     */
+    toEventSourceId(): TParentBuilder;
+}

package/Projections/declarative/IChildrenBuilder.ts

@@ -0,0 +1,31 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+import { IProjectionBuilder } from './IProjectionBuilder';
+
+/**
+ * Defines the builder for a children collection sub-projection.
+ * @template TParentReadModel - The parent read model type.
+ * @template TChildReadModel - The child read model type.
+ */
+export interface IChildrenBuilder<TParentReadModel, TChildReadModel>
+    extends IProjectionBuilder<TChildReadModel, IChildrenBuilder<TParentReadModel, TChildReadModel>> {
+    /**
+     * Sets the property on the child model that identifies instances in the collection.
+     * @param propertyAccessor - Accessor for the identifying property on the child model.
+     * @returns This builder for fluent chaining.
+     */
+    identifiedBy(
+        propertyAccessor: PropertyAccessor<TChildReadModel>
+    ): IChildrenBuilder<TParentReadModel, TChildReadModel>;
+
+    /**
+     * Defines the event and property from which the child is created as a value.
+     * @param propertyAccessor - Accessor for the property on the event representing the child.
+     * @returns This builder for fluent chaining.
+     */
+    fromEventProperty<TEvent>(
+        propertyAccessor: PropertyAccessor<TEvent>
+    ): IChildrenBuilder<TParentReadModel, TChildReadModel>;
+}

package/Projections/declarative/ICompositeKeyBuilder.ts

@@ -0,0 +1,22 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines a builder for constructing composite keys from multiple event properties.
+ * @template TKeyType - The composite key type.
+ * @template TEvent - The event type.
+ */
+export interface ICompositeKeyBuilder<TKeyType, TEvent> {
+    /**
+     * Maps a source event property to a target key property.
+     * @param targetPropertyAccessor - Accessor for the property on the key type to populate.
+     * @param sourcePropertyAccessor - Accessor for the property on the event to read from.
+     * @returns This builder for fluent chaining.
+     */
+    set(
+        targetPropertyAccessor: PropertyAccessor<TKeyType>,
+        sourcePropertyAccessor: PropertyAccessor<TEvent>
+    ): ICompositeKeyBuilder<TKeyType, TEvent>;
+}

package/Projections/declarative/IFromBuilder.ts

@@ -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.
+
+import { IReadModelPropertiesBuilder } from './IReadModelPropertiesBuilder';
+
+/**
+ * Defines the builder for configuring property mappings from a specific event type.
+ * @template TReadModel - The read model type.
+ * @template TEvent - The event type.
+ */
+export interface IFromBuilder<TReadModel, TEvent>
+    extends IReadModelPropertiesBuilder<TReadModel, TEvent, IFromBuilder<TReadModel, TEvent>> {}

package/Projections/declarative/IFromEveryBuilder.ts

@@ -0,0 +1,24 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+import { IAllSetBuilder } from './IAllSetBuilder';
+
+/**
+ * Defines the builder for configuring property mappings that apply to every projected event.
+ * @template TReadModel - The read model type.
+ */
+export interface IFromEveryBuilder<TReadModel> {
+    /**
+     * Begins a set operation on the specified read model property.
+     * @param readModelPropertyAccessor - Accessor for the read model property to set.
+     * @returns An all-set builder for specifying the value source.
+     */
+    set(readModelPropertyAccessor: PropertyAccessor<TReadModel>): IAllSetBuilder<TReadModel, IFromEveryBuilder<TReadModel>>;
+
+    /**
+     * Excludes child projections from the fromEvery definition.
+     * @returns This builder for fluent chaining.
+     */
+    excludeChildProjections(): IFromEveryBuilder<TReadModel>;
+}

package/Projections/declarative/IJoinBuilder.ts

@@ -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.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+import { IReadModelPropertiesBuilder } from './IReadModelPropertiesBuilder';
+
+/**
+ * Defines the builder for configuring a join projection from a specific event type.
+ * @template TReadModel - The read model type.
+ * @template TEvent - The event type.
+ */
+export interface IJoinBuilder<TReadModel, TEvent>
+    extends IReadModelPropertiesBuilder<TReadModel, TEvent, IJoinBuilder<TReadModel, TEvent>> {
+    /**
+     * Sets the property on the read model that forms the relationship for the join.
+     * @param readModelPropertyAccessor - Accessor for the read model property to join on.
+     * @returns This builder for fluent chaining.
+     */
+    on(readModelPropertyAccessor: PropertyAccessor<TReadModel>): IJoinBuilder<TReadModel, TEvent>;
+}

package/Projections/declarative/INestedBuilder.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { IProjectionBuilder } from './IProjectionBuilder';
+
+/**
+ * Defines the builder for a nested single-object sub-projection.
+ * @template TParentReadModel - The parent read model type.
+ * @template TNestedReadModel - The nested object read model type.
+ */
+export interface INestedBuilder<TParentReadModel, TNestedReadModel>
+    extends IProjectionBuilder<TNestedReadModel, INestedBuilder<TParentReadModel, TNestedReadModel>> {
+    /**
+     * Specifies the event type that clears (sets to null) this nested object.
+     * @param eventType - The event constructor that triggers clearing this nested object.
+     * @returns This builder for fluent chaining.
+     */
+    clearWith(eventType: Function): INestedBuilder<TParentReadModel, TNestedReadModel>;
+}

package/Projections/declarative/IProjectionBuilder.ts

@@ -0,0 +1,98 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+import { IChildrenBuilder } from './IChildrenBuilder';
+import { IFromBuilder } from './IFromBuilder';
+import { IFromEveryBuilder } from './IFromEveryBuilder';
+import { IJoinBuilder } from './IJoinBuilder';
+import { INestedBuilder } from './INestedBuilder';
+import { IRemovedWithBuilder } from './IRemovedWithBuilder';
+import { IRemovedWithJoinBuilder } from './IRemovedWithJoinBuilder';
+
+/**
+ * Defines the core builder interface for configuring a projection.
+ * @template TReadModel - The read model type this projection produces.
+ * @template TBuilder - The concrete builder type for fluent return.
+ */
+export interface IProjectionBuilder<TReadModel, TBuilder> {
+    /**
+     * Enables automatic property mapping by naming convention.
+     * @returns This builder for fluent chaining.
+     */
+    autoMap(): TBuilder;
+
+    /**
+     * Disables automatic property mapping by naming convention.
+     * @returns This builder for fluent chaining.
+     */
+    noAutoMap(): TBuilder;
+
+    /**
+     * Provides initial property values for newly created read model instances.
+     * @param initialValueProvider - A factory function that returns the initial values.
+     * @returns This builder for fluent chaining.
+     */
+    withInitialValues(initialValueProvider: () => TReadModel): TBuilder;
+
+    /**
+     * Configures a projection from a specific event type.
+     * @param eventType - The event class constructor.
+     * @param builderCallback - Optional callback for configuring property mappings.
+     * @returns This builder for fluent chaining.
+     */
+    from<TEvent>(eventType: new (...args: any[]) => TEvent, builderCallback?: (builder: IFromBuilder<TReadModel, TEvent>) => void): TBuilder;
+
+    /**
+     * Configures a join projection from a specific event type.
+     * @param eventType - The event class constructor.
+     * @param builderCallback - Optional callback for configuring the join mappings.
+     * @returns This builder for fluent chaining.
+     */
+    join<TEvent>(eventType: new (...args: any[]) => TEvent, builderCallback?: (builder: IJoinBuilder<TReadModel, TEvent>) => void): TBuilder;
+
+    /**
+     * Configures property mappings that apply to every projected event type.
+     * @param builderCallback - Callback for configuring the fromEvery mappings.
+     * @returns This builder for fluent chaining.
+     */
+    fromEvery(builderCallback: (builder: IFromEveryBuilder<TReadModel>) => void): TBuilder;
+
+    /**
+     * Specifies the event type that causes this read model instance to be removed.
+     * @param eventType - The event class constructor.
+     * @param builderCallback - Optional callback for configuring the removal behavior.
+     * @returns This builder for fluent chaining.
+     */
+    removedWith<TEvent>(eventType: new (...args: any[]) => TEvent, builderCallback?: (builder: IRemovedWithBuilder<TReadModel, TEvent>) => void): TBuilder;
+
+    /**
+     * Specifies the joined event type that causes this read model instance to be removed.
+     * @param eventType - The event class constructor.
+     * @param builderCallback - Optional callback for configuring the removal behavior.
+     * @returns This builder for fluent chaining.
+     */
+    removedWithJoin<TEvent>(eventType: new (...args: any[]) => TEvent, builderCallback?: (builder: IRemovedWithJoinBuilder<TReadModel, TEvent>) => void): TBuilder;
+
+    /**
+     * Configures a child collection projection on the specified read model property.
+     * @param targetPropertyAccessor - Accessor for the collection property on the read model.
+     * @param builderCallback - Callback for configuring the children projection.
+     * @returns This builder for fluent chaining.
+     */
+    children<TChildModel>(
+        targetPropertyAccessor: PropertyAccessor<TReadModel>,
+        builderCallback: (builder: IChildrenBuilder<TReadModel, TChildModel>) => void
+    ): TBuilder;
+
+    /**
+     * Configures a nested single-object projection on the specified read model property.
+     * @param targetPropertyAccessor - Accessor for the nested property on the read model.
+     * @param builderCallback - Callback for configuring the nested projection.
+     * @returns This builder for fluent chaining.
+     */
+    nested<TNestedModel>(
+        targetPropertyAccessor: PropertyAccessor<TReadModel>,
+        builderCallback: (builder: INestedBuilder<TReadModel, TNestedModel>) => void
+    ): TBuilder;
+}

package/Projections/declarative/IProjectionBuilderFor.ts

@@ -0,0 +1,38 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { IProjectionBuilder } from './IProjectionBuilder';
+
+/**
+ * Defines the top-level projection builder for a specific read model type.
+ * Extends the core builder with projection-wide configuration options.
+ * @template TReadModel - The read model type this projection produces.
+ */
+export interface IProjectionBuilderFor<TReadModel>
+    extends IProjectionBuilder<TReadModel, IProjectionBuilderFor<TReadModel>> {
+    /**
+     * Specifies the event sequence this projection should read from.
+     * @param eventSequenceId - The identifier of the event sequence.
+     * @returns This builder for fluent chaining.
+     */
+    fromEventSequence(eventSequenceId: string): IProjectionBuilderFor<TReadModel>;
+
+    /**
+     * Sets the container name used to store read model instances (e.g., collection or table name).
+     * @param name - The container name.
+     * @returns This builder for fluent chaining.
+     */
+    containerName(name: string): IProjectionBuilderFor<TReadModel>;
+
+    /**
+     * Marks this projection as not rewindable, preventing historical event replay.
+     * @returns This builder for fluent chaining.
+     */
+    notRewindable(): IProjectionBuilderFor<TReadModel>;
+
+    /**
+     * Marks this projection as passive, meaning it will not actively observe events.
+     * @returns This builder for fluent chaining.
+     */
+    passive(): IProjectionBuilderFor<TReadModel>;
+}

package/Projections/declarative/IProjectionFor.ts

@@ -0,0 +1,18 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { IProjectionBuilderFor } from './IProjectionBuilderFor';
+
+/**
+ * Defines the contract for a declarative projection class bound to a specific read model type.
+ * Implement this interface on any class decorated with {@link projection} to provide a type-safe
+ * builder-based configuration for the projection.
+ * @template TReadModel - The read model type this projection produces.
+ */
+export interface IProjectionFor<TReadModel> {
+    /**
+     * Configures the projection using the provided builder.
+     * @param builder - The projection builder to configure.
+     */
+    define(builder: IProjectionBuilderFor<TReadModel>): void;
+}

package/Projections/declarative/IReadModelPropertiesBuilder.ts

@@ -0,0 +1,132 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+import { ICompositeKeyBuilder } from './ICompositeKeyBuilder';
+import { IAddBuilder } from './IAddBuilder';
+import { IAddChildBuilder } from './IAddChildBuilder';
+import { ISetBuilder } from './ISetBuilder';
+import { ISubtractBuilder } from './ISubtractBuilder';
+
+/**
+ * Defines the common read model property mapping operations shared by from and join builders.
+ * @template TReadModel - The read model type.
+ * @template TEvent - The event type.
+ * @template TBuilder - The concrete builder type for fluent return.
+ */
+export interface IReadModelPropertiesBuilder<TReadModel, TEvent, TBuilder> {
+    /**
+     * Uses an event property as the key for this projection.
+     * @param keyAccessor - Accessor for the event property used as key.
+     * @returns This builder for fluent chaining.
+     */
+    usingKey(keyAccessor: PropertyAccessor<TEvent>): TBuilder;
+
+    /**
+     * Uses a named event context property as the key for this projection.
+     * @param contextPropertyName - The name of the context property.
+     * @returns This builder for fluent chaining.
+     */
+    usingKeyFromContext(contextPropertyName: string): TBuilder;
+
+    /**
+     * Uses an event property as the parent key for child projections.
+     * @param keyAccessor - Accessor for the event property used as parent key.
+     * @returns This builder for fluent chaining.
+     */
+    usingParentKey(keyAccessor: PropertyAccessor<TEvent>): TBuilder;
+
+    /**
+     * Uses a named event context property as the parent key for child projections.
+     * @param contextPropertyName - The name of the context property.
+     * @returns This builder for fluent chaining.
+     */
+    usingParentKeyFromContext(contextPropertyName: string): TBuilder;
+
+    /**
+     * Uses a composite key built from multiple event properties.
+     * @param builderCallback - Callback for configuring the composite key builder.
+     * @returns This builder for fluent chaining.
+     */
+    usingCompositeKey<TKeyType>(builderCallback: (builder: ICompositeKeyBuilder<TKeyType, TEvent>) => void): TBuilder;
+
+    /**
+     * Uses a composite parent key built from multiple event properties.
+     * @param builderCallback - Callback for configuring the composite key builder.
+     * @returns This builder for fluent chaining.
+     */
+    usingParentCompositeKey<TKeyType>(builderCallback: (builder: ICompositeKeyBuilder<TKeyType, TEvent>) => void): TBuilder;
+
+    /**
+     * Uses a constant string value as the key for this projection.
+     * @param value - The constant key value.
+     * @returns This builder for fluent chaining.
+     */
+    usingConstantKey(value: string): TBuilder;
+
+    /**
+     * Uses a constant string value as the parent key for this projection.
+     * @param value - The constant parent key value.
+     * @returns This builder for fluent chaining.
+     */
+    usingConstantParentKey(value: string): TBuilder;
+
+    /**
+     * Increments the specified read model property by one when this event occurs.
+     * @param readModelPropertyAccessor - Accessor for the read model property to increment.
+     * @returns This builder for fluent chaining.
+     */
+    increment(readModelPropertyAccessor: PropertyAccessor<TReadModel>): TBuilder;
+
+    /**
+     * Decrements the specified read model property by one when this event occurs.
+     * @param readModelPropertyAccessor - Accessor for the read model property to decrement.
+     * @returns This builder for fluent chaining.
+     */
+    decrement(readModelPropertyAccessor: PropertyAccessor<TReadModel>): TBuilder;
+
+    /**
+     * Begins an add operation on the specified read model property.
+     * @param readModelPropertyAccessor - Accessor for the read model property to add to.
+     * @returns An add builder for specifying the event property value.
+     */
+    add(readModelPropertyAccessor: PropertyAccessor<TReadModel>): IAddBuilder<TEvent, TBuilder>;
+
+    /**
+     * Begins a subtract operation on the specified read model property.
+     * @param readModelPropertyAccessor - Accessor for the read model property to subtract from.
+     * @returns A subtract builder for specifying the event property value.
+     */
+    subtract(readModelPropertyAccessor: PropertyAccessor<TReadModel>): ISubtractBuilder<TEvent, TBuilder>;
+
+    /**
+     * Counts the number of matching events into the specified read model property.
+     * @param readModelPropertyAccessor - Accessor for the read model property to store the count in.
+     * @returns This builder for fluent chaining.
+     */
+    count(readModelPropertyAccessor: PropertyAccessor<TReadModel>): TBuilder;
+
+    /**
+     * Adds a child model from the event to a collection property on the read model.
+     * @param targetPropertyAccessor - Accessor for the collection property on the read model.
+     * @param eventPropertyAccessorOrBuilderCallback - Either a direct event property accessor or a builder callback.
+     * @returns This builder for fluent chaining.
+     */
+    addChild<TChildModel>(
+        targetPropertyAccessor: PropertyAccessor<TReadModel>,
+        eventPropertyAccessorOrBuilderCallback: PropertyAccessor<TEvent> | ((builder: IAddChildBuilder<TChildModel, TEvent>) => void)
+    ): TBuilder;
+
+    /**
+     * Begins a set operation to map an event property to the specified read model property.
+     * @param readModelPropertyAccessor - Accessor for the read model property to set.
+     * @returns A set builder for specifying the event property value.
+     */
+    set(readModelPropertyAccessor: PropertyAccessor<TReadModel>): ISetBuilder<TEvent, TBuilder>;
+
+    /**
+     * Begins a set operation that maps the entire event value to a read model property.
+     * @returns A set builder for specifying the target read model property.
+     */
+    setThisValue(): ISetBuilder<TEvent, TBuilder>;
+}

package/Projections/declarative/IRemovedWithBuilder.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines the builder for configuring the removal of a read model instance via an event.
+ * @template TReadModel - The read model type.
+ * @template TEvent - The event type that triggers removal.
+ */
+export interface IRemovedWithBuilder<TReadModel, TEvent> {
+    /**
+     * Uses an event property as the key to identify the instance to remove.
+     * @param keyAccessor - Accessor for the event property used as key.
+     * @returns This builder for fluent chaining.
+     */
+    usingKey(keyAccessor: PropertyAccessor<TEvent>): IRemovedWithBuilder<TReadModel, TEvent>;
+
+    /**
+     * Uses a named event context property as the key to identify the instance to remove.
+     * @param contextPropertyName - The name of the event context property.
+     * @returns This builder for fluent chaining.
+     */
+    usingKeyFromContext(contextPropertyName: string): IRemovedWithBuilder<TReadModel, TEvent>;
+}

package/Projections/declarative/IRemovedWithJoinBuilder.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines the builder for configuring the removal of a read model instance via a join event.
+ * @template TReadModel - The read model type.
+ * @template TEvent - The event type that triggers removal.
+ */
+export interface IRemovedWithJoinBuilder<TReadModel, TEvent> {
+    /**
+     * Sets the read model property that forms the relationship for the join removal.
+     * @param readModelPropertyAccessor - Accessor for the read model property to join on.
+     * @returns This builder for fluent chaining.
+     */
+    on(readModelPropertyAccessor: PropertyAccessor<TReadModel>): IRemovedWithJoinBuilder<TReadModel, TEvent>;
+
+    /**
+     * Uses an event property as the key to identify the instance to remove.
+     * @param keyAccessor - Accessor for the event property used as key.
+     * @returns This builder for fluent chaining.
+     */
+    usingKey(keyAccessor: PropertyAccessor<TEvent>): IRemovedWithJoinBuilder<TReadModel, TEvent>;
+}

package/Projections/declarative/ISetBuilder.ts

@@ -0,0 +1,38 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines a builder for configuring a set operation on a read model property.
+ * @template TEvent - The event type.
+ * @template TParentBuilder - The parent builder type for fluent return.
+ */
+export interface ISetBuilder<TEvent, TParentBuilder> {
+    /**
+     * Maps the read model property from the specified event property.
+     * @param eventPropertyAccessor - Accessor for the source property on the event.
+     * @returns The parent builder for fluent chaining.
+     */
+    to(eventPropertyAccessor: PropertyAccessor<TEvent>): TParentBuilder;
+
+    /**
+     * Sets the read model property to a constant value.
+     * @param value - The constant value to assign.
+     * @returns The parent builder for fluent chaining.
+     */
+    toValue<TProperty>(value: TProperty): TParentBuilder;
+
+    /**
+     * Maps the read model property from a named event context property.
+     * @param contextPropertyName - The name of the event context property to read from.
+     * @returns The parent builder for fluent chaining.
+     */
+    toEventContextProperty(contextPropertyName: string): TParentBuilder;
+
+    /**
+     * Maps the read model property from the event source identifier.
+     * @returns The parent builder for fluent chaining.
+     */
+    toEventSourceId(): TParentBuilder;
+}

package/Projections/declarative/ISubtractBuilder.ts

@@ -0,0 +1,18 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor } from '@cratis/fundamentals';
+
+/**
+ * Defines a builder for configuring a subtract operation on a read model property.
+ * @template TEvent - The event type.
+ * @template TParentBuilder - The parent builder type for fluent return.
+ */
+export interface ISubtractBuilder<TEvent, TParentBuilder> {
+    /**
+     * Subtracts the value of the specified event property from the read model property.
+     * @param eventPropertyAccessor - Accessor for the source property on the event.
+     * @returns The parent builder for fluent chaining.
+     */
+    with(eventPropertyAccessor: PropertyAccessor<TEvent>): TParentBuilder;
+}