@cratis/chronicle 0.0.1

package/Projections/Projections.ts

@@ -0,0 +1,463 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import {
+    AutoMap,
+    ProjectionOwner
+} from '@cratis/chronicle.contracts';
+import { Constructor } from '@cratis/fundamentals';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import { EventSequenceId } from '../EventSequences/EventSequenceId';
+import { getEventTypeFor } from '../Events/eventTypeDecorator';
+import { getReadModelMetadata } from '../ReadModels';
+import { TypeIntrospector } from '../types';
+import { IProjections } from './IProjections';
+import { getProjectionMetadata } from './declarative/projection';
+import { ProjectionBuilderFor } from './declarative/ProjectionBuilderFor';
+import type { IProjectionFor } from './declarative/IProjectionFor';
+import { getAddFromMetadata } from './modelBound/addFrom';
+import { getChildrenFromMetadata } from './modelBound/childrenFrom';
+import { getClearWithClassMetadata, getClearWithPropertyMetadata } from './modelBound/clearWith';
+import { getCountMetadata } from './modelBound/count';
+import { getDecrementMetadata } from './modelBound/decrement';
+import { getFromEveryMetadata } from './modelBound/fromEvery';
+import { getFromEventMetadata, hasFromEventMetadata } from './modelBound/fromEvent';
+import { getIncrementMetadata } from './modelBound/increment';
+import { getJoinMetadata } from './modelBound/join';
+import { ProjectionId } from './ProjectionId';
+import { isNested } from './modelBound/nested';
+import { isNotRewindable } from './modelBound/notRewindable';
+import { getRemovedWithClassMetadata, getRemovedWithPropertyMetadata } from './modelBound/removedWith';
+import { getRemovedWithJoinClassMetadata, getRemovedWithJoinPropertyMetadata } from './modelBound/removedWithJoin';
+import { getSetFromMetadata } from './modelBound/setFrom';
+import { getSetFromContextMetadata } from './modelBound/setFromContext';
+import { getSetValueMetadata } from './modelBound/setValue';
+import { getSubtractFromMetadata } from './modelBound/subtractFrom';
+
+type ContractEventType = { Id: string; Generation: number; Tombstone: boolean };
+
+interface ResolvedModelBoundMetadata {
+    id: ProjectionId;
+    eventSequenceId: string | undefined;
+    readModelIdentifier: string;
+}
+
+/**
+ * Implements {@link IProjections}, managing discovery and registration of projections
+ * with the Chronicle Kernel.
+ */
+export class Projections implements IProjections {
+    private readonly _declarative = new Map<string, Constructor>();
+    private readonly _modelBound = new Map<string, Constructor>();
+
+    /**
+     * Creates a new {@link Projections} instance.
+     * @param _clientArtifacts - Provider for discovered client artifact types.
+     */
+    constructor(
+        private readonly _eventStore: string,
+        private readonly _connection: ChronicleConnection,
+        private readonly _clientArtifacts: IClientArtifactsProvider
+    ) {}
+
+    /** @inheritdoc */
+    async discover(): Promise<void> {
+        this._declarative.clear();
+        this._modelBound.clear();
+
+        for (const type of this._clientArtifacts.projections) {
+            const metadata = getProjectionMetadata(type);
+            if (metadata) {
+                this._declarative.set(metadata.id.value, type);
+            }
+        }
+
+        for (const type of this._clientArtifacts.readModels) {
+            if (!hasFromEventMetadata(type)) {
+                continue;
+            }
+
+            const metadata = this.resolveModelBoundMetadata(type);
+            if (!metadata) {
+                continue;
+            }
+
+            if (!this._modelBound.has(metadata.id.value)) {
+                this._modelBound.set(metadata.id.value, type);
+            }
+        }
+    }
+
+    /** @inheritdoc */
+    async register(): Promise<void> {
+        if (this._declarative.size === 0 && this._modelBound.size === 0) {
+            await this.discover();
+        }
+
+        const projections = [
+            ...Array.from(this._declarative.values()).map(type => this.buildDeclarativeDefinition(type)),
+            ...Array.from(this._modelBound.values()).map(type => this.buildModelBoundDefinition(type))
+        ];
+
+        if (projections.length === 0) {
+            return;
+        }
+
+        const readModels = this.buildReadModelDefinitions(projections);
+        if (readModels.length > 0) {
+            await this._connection.readModels.registerMany({
+                EventStore: this._eventStore,
+                Owner: 1,
+                ReadModels: readModels,
+                Source: 1
+            });
+        }
+
+        for (const projection of projections) {
+            try {
+                await this._connection.projections.register({
+                    EventStore: this._eventStore,
+                    Owner: ProjectionOwner.PROJECTION_OWNER_Client,
+                    Projections: [projection]
+                });
+            } catch (error) {
+                const identifier = String((projection as { Identifier?: unknown }).Identifier ?? '<unknown>');
+                throw new Error(`Failed to register projection '${identifier}': ${String(error)}`);
+            }
+        }
+    }
+
+    private buildReadModelDefinitions(projections: any[]): any[] {
+        const byReadModel = new Map<string, any>();
+
+        for (const projection of projections) {
+            const readModelIdentifier = projection.ReadModel;
+            if (!readModelIdentifier || byReadModel.has(readModelIdentifier)) {
+                continue;
+            }
+
+            byReadModel.set(readModelIdentifier, {
+                Type: {
+                    Identifier: readModelIdentifier,
+                    Generation: 1
+                },
+                ContainerName: readModelIdentifier,
+                DisplayName: readModelIdentifier,
+                Sink: {
+                    ConfigurationId: this.toContractsGuid('00000000-0000-0000-0000-000000000000'),
+                    TypeId: this.toContractsGuid('22202c41-2be1-4547-9c00-f0b1f797fd75')
+                },
+                Schema: this.getReadModelSchema(readModelIdentifier),
+                Indexes: [],
+                ObserverType: 2,
+                ObserverIdentifier: projection.Identifier,
+                Owner: 1,
+                Source: 1
+            });
+        }
+
+        return Array.from(byReadModel.values());
+    }
+
+    private getReadModelSchema(readModelIdentifier: string): string {
+        for (const type of this._clientArtifacts.readModels) {
+            const metadata = getReadModelMetadata(type);
+            if (!metadata) {
+                continue;
+            }
+
+            if (metadata.id.value === readModelIdentifier || type.name === readModelIdentifier) {
+                return JSON.stringify(metadata.schema);
+            }
+        }
+
+        return '{}';
+    }
+
+    private buildDeclarativeDefinition(type: Constructor): any {
+        const metadata = getProjectionMetadata(type);
+        if (!metadata) {
+            throw new Error(`Type '${type.name}' is missing declarative projection metadata.`);
+        }
+
+        const builder = new ProjectionBuilderFor<unknown>();
+        const instance = new type() as IProjectionFor<unknown>;
+        instance.define(builder);
+        const definition = builder.build(metadata.id.value, type.name) as Record<string, unknown>;
+
+        const explicitReadModelIdentifier = definition.ReadModel as string;
+        if (explicitReadModelIdentifier === type.name) {
+            const inferredReadModelIdentifier = this.inferReadModelIdentifier(builder.getMappedReadModelProperties());
+            if (inferredReadModelIdentifier) {
+                definition.ReadModel = inferredReadModelIdentifier;
+            }
+        }
+
+        return definition;
+    }
+
+    private inferReadModelIdentifier(mappedProperties: string[]): string | undefined {
+        if (mappedProperties.length === 0) {
+            return undefined;
+        }
+
+        const matchingReadModels = this._clientArtifacts.readModels
+            .map(type => ({ type, metadata: getReadModelMetadata(type) }))
+            .filter(candidate => candidate.metadata)
+            .filter(candidate => {
+                const readModelProperties = Array.from(candidate.metadata!.members.keys());
+                return mappedProperties.every(property => readModelProperties.includes(property));
+            });
+
+        if (matchingReadModels.length !== 1) {
+            return undefined;
+        }
+
+        return matchingReadModels[0].metadata!.id.value;
+    }
+
+    private buildModelBoundDefinition(type: Constructor): any {
+        const metadata = this.resolveModelBoundMetadata(type);
+        if (!metadata) {
+            throw new Error(`Type '${type.name}' is missing model-bound projection metadata.`);
+        }
+
+        const properties = TypeIntrospector.getTrackedProperties(type);
+        const prototype = type.prototype;
+
+        const fromByEventType = new Map<string, { Key: ContractEventType; Value: { Properties: Record<string, string>; Key: string; ParentKey: string } }>();
+        const joinByEventType = new Map<string, { Key: ContractEventType; Value: { On: string; Properties: Record<string, string>; Key: string } }>();
+        const removedWithByEventType = new Map<string, { Key: ContractEventType; Value: { Key: string; ParentKey: string } }>();
+        const removedWithJoinByEventType = new Map<string, { Key: ContractEventType; Value: { Key: string } }>();
+
+        const fromEvents = getFromEventMetadata(type);
+        for (const fromEvent of fromEvents) {
+            const eventType = this.toContractEventType(fromEvent.eventType);
+            const eventKey = this.getEventTypeMapKey(eventType);
+            fromByEventType.set(eventKey, {
+                Key: eventType,
+                Value: {
+                    Properties: {},
+                    Key: fromEvent.constantKey ?? fromEvent.key ?? '$eventSourceId',
+                    ParentKey: fromEvent.parentKey ?? ''
+                }
+            });
+        }
+
+        const clearWithClass = getClearWithClassMetadata(type);
+        if (clearWithClass.length > 0) {
+            throw new Error(`Model-bound projection '${type.name}' uses @clearWith on class level, which is not implemented yet.`);
+        }
+
+        const removedWithClass = getRemovedWithClassMetadata(type);
+        for (const removed of removedWithClass) {
+            const eventType = this.toContractEventType(removed.eventType);
+            removedWithByEventType.set(this.getEventTypeMapKey(eventType), {
+                Key: eventType,
+                Value: { Key: removed.key ?? '$eventSourceId', ParentKey: removed.parentKey ?? '' }
+            });
+        }
+
+        const removedWithJoinClass = getRemovedWithJoinClassMetadata(type);
+        for (const removed of removedWithJoinClass) {
+            const eventType = this.toContractEventType(removed.eventType);
+            removedWithJoinByEventType.set(this.getEventTypeMapKey(eventType), {
+                Key: eventType,
+                Value: { Key: removed.key ?? '$eventSourceId' }
+            });
+        }
+
+        for (const property of properties) {
+            this.throwIfUnsupportedModelBoundDecorators(type.name, prototype, property);
+
+            for (const mapping of getSetFromMetadata(prototype, property)) {
+                const entry = this.ensureFromEntry(fromByEventType, mapping.eventType);
+                entry.Value.Properties[property] = mapping.eventPropertyName ?? property;
+            }
+
+            for (const mapping of getSetFromContextMetadata(prototype, property)) {
+                const entry = this.ensureFromEntry(fromByEventType, mapping.eventType);
+                entry.Value.Properties[property] = mapping.contextPropertyName ?? property;
+            }
+
+            for (const mapping of getSetValueMetadata(prototype, property)) {
+                const entry = this.ensureFromEntry(fromByEventType, mapping.eventType);
+                entry.Value.Properties[property] = JSON.stringify(mapping.value);
+            }
+
+            for (const mapping of getJoinMetadata(prototype, property)) {
+                const entry = this.ensureJoinEntry(joinByEventType, mapping.eventType);
+                entry.Value.On = mapping.on ?? entry.Value.On;
+                entry.Value.Properties[property] = mapping.eventPropertyName ?? property;
+            }
+
+            const fromEvery = getFromEveryMetadata(prototype, property);
+            if (fromEvery) {
+                // Applied later to projection.All
+            }
+
+            for (const removed of getRemovedWithPropertyMetadata(prototype, property)) {
+                const eventType = this.toContractEventType(removed.eventType);
+                removedWithByEventType.set(this.getEventTypeMapKey(eventType), {
+                    Key: eventType,
+                    Value: { Key: removed.key ?? '$eventSourceId', ParentKey: removed.parentKey ?? '' }
+                });
+            }
+
+            for (const removed of getRemovedWithJoinPropertyMetadata(prototype, property)) {
+                const eventType = this.toContractEventType(removed.eventType);
+                removedWithJoinByEventType.set(this.getEventTypeMapKey(eventType), {
+                    Key: eventType,
+                    Value: { Key: removed.key ?? '$eventSourceId' }
+                });
+            }
+        }
+
+        const allProperties: Record<string, string> = {};
+        for (const property of properties) {
+            const fromEvery = getFromEveryMetadata(prototype, property);
+            if (fromEvery) {
+                allProperties[property] = fromEvery.contextProperty
+                    ? fromEvery.contextProperty
+                    : (fromEvery.property ?? property);
+            }
+        }
+
+        return {
+            EventSequenceId: metadata.eventSequenceId ?? EventSequenceId.eventLog.value,
+            Identifier: metadata.id.value,
+            ReadModel: metadata.readModelIdentifier,
+            IsActive: true,
+            IsRewindable: !isNotRewindable(type),
+            InitialModelState: '{}',
+            From: Array.from(fromByEventType.values()),
+            Join: Array.from(joinByEventType.values()),
+            Children: {},
+            FromEvery: [],
+            All: {
+                Properties: allProperties,
+                IncludeChildren: false,
+                AutoMap: AutoMap.Inherit
+            },
+            FromEventProperty: undefined,
+            RemovedWith: Array.from(removedWithByEventType.values()),
+            RemovedWithJoin: Array.from(removedWithJoinByEventType.values()),
+            LastUpdated: { Value: new Date().toISOString() },
+            Tags: [],
+            AutoMap: AutoMap.Disabled,
+            Nested: {}
+        };
+    }
+
+    private resolveModelBoundMetadata(type: Constructor): ResolvedModelBoundMetadata | undefined {
+        const readModelMetadata = getReadModelMetadata(type);
+
+        if (readModelMetadata && hasFromEventMetadata(type)) {
+            return {
+                id: new ProjectionId(readModelMetadata.id.value),
+                eventSequenceId: undefined,
+                readModelIdentifier: readModelMetadata.id.value
+            };
+        }
+
+        return undefined;
+    }
+
+    private throwIfUnsupportedModelBoundDecorators(typeName: string, prototype: object, property: string): void {
+        if (getAddFromMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @addFrom on '${property}', which is not implemented yet.`);
+        }
+        if (getSubtractFromMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @subtractFrom on '${property}', which is not implemented yet.`);
+        }
+        if (getIncrementMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @increment on '${property}', which is not implemented yet.`);
+        }
+        if (getDecrementMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @decrement on '${property}', which is not implemented yet.`);
+        }
+        if (getCountMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @count on '${property}', which is not implemented yet.`);
+        }
+        if (getChildrenFromMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @childrenFrom on '${property}', which is not implemented yet.`);
+        }
+        if (isNested(prototype, property)) {
+            throw new Error(`Model-bound projection '${typeName}' uses @nested on '${property}', which is not implemented yet.`);
+        }
+        if (getClearWithPropertyMetadata(prototype, property).length > 0) {
+            throw new Error(`Model-bound projection '${typeName}' uses @clearWith on '${property}', which is not implemented yet.`);
+        }
+    }
+
+    private ensureFromEntry(
+        fromByEventType: Map<string, { Key: ContractEventType; Value: { Properties: Record<string, string>; Key: string; ParentKey: string } }>,
+        eventTypeConstructor: Function
+    ): { Key: ContractEventType; Value: { Properties: Record<string, string>; Key: string; ParentKey: string } } {
+        const eventType = this.toContractEventType(eventTypeConstructor);
+        const key = this.getEventTypeMapKey(eventType);
+        const existing = fromByEventType.get(key);
+        if (existing) {
+            return existing;
+        }
+
+        const created = {
+            Key: eventType,
+            Value: {
+                Properties: {},
+                Key: '$eventSourceId',
+                ParentKey: ''
+            }
+        };
+        fromByEventType.set(key, created);
+        return created;
+    }
+
+    private ensureJoinEntry(
+        joinByEventType: Map<string, { Key: ContractEventType; Value: { On: string; Properties: Record<string, string>; Key: string } }>,
+        eventTypeConstructor: Function
+    ): { Key: ContractEventType; Value: { On: string; Properties: Record<string, string>; Key: string } } {
+        const eventType = this.toContractEventType(eventTypeConstructor);
+        const key = this.getEventTypeMapKey(eventType);
+        const existing = joinByEventType.get(key);
+        if (existing) {
+            return existing;
+        }
+
+        const created = {
+            Key: eventType,
+            Value: {
+                On: '',
+                Properties: {},
+                Key: '$eventSourceId'
+            }
+        };
+        joinByEventType.set(key, created);
+        return created;
+    }
+
+    private toContractEventType(eventTypeConstructor: Function): ContractEventType {
+        const eventType = getEventTypeFor(eventTypeConstructor);
+        if (eventType.id.value === '') {
+            throw new Error(`Event type '${eventTypeConstructor.name}' is not decorated with @eventType().`);
+        }
+        return {
+            Id: eventType.id.value,
+            Generation: eventType.generation.value,
+            Tombstone: false
+        };
+    }
+
+    private getEventTypeMapKey(eventType: ContractEventType): string {
+        return `${eventType.Id}:${eventType.Generation}:${eventType.Tombstone ? '1' : '0'}`;
+    }
+
+    private toContractsGuid(value: string): { lo: number; hi: number } {
+        const hex = value.replace(/-/g, '');
+        return {
+            hi: Number(BigInt(`0x${hex.substring(0, 16)}`)),
+            lo: Number(BigInt(`0x${hex.substring(16, 32)}`))
+        };
+    }
+}

package/Projections/declarative/AllSetBuilder.ts

@@ -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 { PropertyAccessor, PropertyPathResolverProxyHandler } from '@cratis/fundamentals';
+import { IAllSetBuilder } from './IAllSetBuilder';
+
+/**
+ * Concrete implementation of {@link IAllSetBuilder} for fromEvery mappings.
+ * @template TReadModel - The read model type.
+ * @template TParentBuilder - The parent builder type.
+ */
+export class AllSetBuilder<TReadModel, TParentBuilder> implements IAllSetBuilder<TReadModel, TParentBuilder> {
+    constructor(
+        private readonly _targetProperty: string,
+        private readonly _setProperty: (property: string, expression: string) => void,
+        private readonly _parent: TParentBuilder
+    ) {}
+
+    /** @inheritdoc */
+    to(readModelPropertyAccessor: PropertyAccessor<TReadModel>): TParentBuilder {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        readModelPropertyAccessor(proxy as TReadModel);
+        this._setProperty(this._targetProperty, handler.property);
+        return this._parent;
+    }
+
+    /** @inheritdoc */
+    toEventContextProperty(contextPropertyName: string): TParentBuilder {
+        this._setProperty(this._targetProperty, `$context.${contextPropertyName}`);
+        return this._parent;
+    }
+
+    /** @inheritdoc */
+    toEventSourceId(): TParentBuilder {
+        this._setProperty(this._targetProperty, '$eventSourceId');
+        return this._parent;
+    }
+}

package/Projections/declarative/FromBuilder.ts

@@ -0,0 +1,144 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor, PropertyPathResolverProxyHandler } from '@cratis/fundamentals';
+import { IAddBuilder } from './IAddBuilder';
+import { IAddChildBuilder } from './IAddChildBuilder';
+import { ICompositeKeyBuilder } from './ICompositeKeyBuilder';
+import { IFromBuilder } from './IFromBuilder';
+import { ISetBuilder } from './ISetBuilder';
+import { ISubtractBuilder } from './ISubtractBuilder';
+import { SetBuilder } from './SetBuilder';
+
+/**
+ * Accumulated property mapping for a from clause.
+ */
+export interface FromEntry {
+    properties: Record<string, string>;
+    key: string;
+    parentKey: string;
+}
+
+/**
+ * Concrete implementation of {@link IFromBuilder}.
+ * @template TReadModel - The read model type.
+ * @template TEvent - The event type.
+ */
+export class FromBuilder<TReadModel, TEvent> implements IFromBuilder<TReadModel, TEvent> {
+    readonly entry: FromEntry = {
+        properties: {},
+        key: '$eventSourceId',
+        parentKey: ''
+    };
+
+    /** @inheritdoc */
+    set(readModelPropertyAccessor: PropertyAccessor<TReadModel>): ISetBuilder<TEvent, IFromBuilder<TReadModel, TEvent>> {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        readModelPropertyAccessor(proxy as TReadModel);
+        const rmProp = handler.property;
+        return new SetBuilder<TEvent, IFromBuilder<TReadModel, TEvent>>(
+            rmProp,
+            (rp, expr) => { this.entry.properties[rp] = expr; },
+            this
+        );
+    }
+
+    /** @inheritdoc */
+    usingKey(keyAccessor: PropertyAccessor<TEvent>): this {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        keyAccessor(proxy as TEvent);
+        this.entry.key = handler.property;
+        return this;
+    }
+
+    /** @inheritdoc */
+    usingKeyFromContext(contextPropertyName: string): this {
+        this.entry.key = `$context.${contextPropertyName}`;
+        return this;
+    }
+
+    /** @inheritdoc */
+    usingParentKey(keyAccessor: PropertyAccessor<TEvent>): this {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        keyAccessor(proxy as TEvent);
+        this.entry.parentKey = handler.property;
+        return this;
+    }
+
+    /** @inheritdoc */
+    usingParentKeyFromContext(contextPropertyName: string): this {
+        this.entry.parentKey = `$context.${contextPropertyName}`;
+        return this;
+    }
+
+    /** @inheritdoc */
+    usingCompositeKey<TKeyType>(_builderCallback: (builder: ICompositeKeyBuilder<TKeyType, TEvent>) => void): this {
+        throw new Error('usingCompositeKey is not implemented yet.');
+    }
+
+    /** @inheritdoc */
+    usingParentCompositeKey<TKeyType>(_builderCallback: (builder: ICompositeKeyBuilder<TKeyType, TEvent>) => void): this {
+        throw new Error('usingParentCompositeKey is not implemented yet.');
+    }
+
+    /** @inheritdoc */
+    usingConstantKey(value: string): this {
+        this.entry.key = value;
+        return this;
+    }
+
+    /** @inheritdoc */
+    usingConstantParentKey(value: string): this {
+        this.entry.parentKey = value;
+        return this;
+    }
+
+    /** @inheritdoc */
+    increment(readModelPropertyAccessor: PropertyAccessor<TReadModel>): this {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        readModelPropertyAccessor(proxy as TReadModel);
+        this.entry.properties[handler.property] = '$increment';
+        return this;
+    }
+
+    /** @inheritdoc */
+    decrement(readModelPropertyAccessor: PropertyAccessor<TReadModel>): this {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        readModelPropertyAccessor(proxy as TReadModel);
+        this.entry.properties[handler.property] = '$decrement';
+        return this;
+    }
+
+    /** @inheritdoc */
+    add(_readModelPropertyAccessor: PropertyAccessor<TReadModel>): IAddBuilder<TEvent, this> {
+        throw new Error('add is not implemented yet.');
+    }
+
+    /** @inheritdoc */
+    subtract(_readModelPropertyAccessor: PropertyAccessor<TReadModel>): ISubtractBuilder<TEvent, this> {
+        throw new Error('subtract is not implemented yet.');
+    }
+
+    /** @inheritdoc */
+    count(_readModelPropertyAccessor: PropertyAccessor<TReadModel>): this {
+        throw new Error('count is not implemented yet.');
+    }
+
+    /** @inheritdoc */
+    addChild<TChildModel>(
+        _targetPropertyAccessor: PropertyAccessor<TReadModel>,
+        _eventPropertyAccessorOrBuilderCallback: PropertyAccessor<TEvent> | ((builder: IAddChildBuilder<TChildModel, TEvent>) => void)
+    ): this {
+        throw new Error('addChild is not implemented yet.');
+    }
+
+    /** @inheritdoc */
+    setThisValue(): ISetBuilder<TEvent, this> {
+        throw new Error('setThisValue is not implemented yet.');
+    }
+}

package/Projections/declarative/FromEveryBuilder.ts

@@ -0,0 +1,46 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyAccessor, PropertyPathResolverProxyHandler } from '@cratis/fundamentals';
+import { IAllSetBuilder } from './IAllSetBuilder';
+import { IFromEveryBuilder } from './IFromEveryBuilder';
+import { AllSetBuilder } from './AllSetBuilder';
+
+/**
+ * Accumulated mapping entry for fromEvery.
+ */
+export interface FromEveryEntry {
+    properties: Record<string, string>;
+    includeChildren: boolean;
+}
+
+/**
+ * Concrete implementation of {@link IFromEveryBuilder}.
+ * @template TReadModel - The read model type.
+ */
+export class FromEveryBuilder<TReadModel> implements IFromEveryBuilder<TReadModel> {
+    readonly entry: FromEveryEntry = {
+        properties: {},
+        includeChildren: true
+    };
+
+    /** @inheritdoc */
+    set(readModelPropertyAccessor: PropertyAccessor<TReadModel>): IAllSetBuilder<TReadModel, IFromEveryBuilder<TReadModel>> {
+        const handler = new PropertyPathResolverProxyHandler();
+        const proxy = new Proxy({}, handler);
+        readModelPropertyAccessor(proxy as TReadModel);
+        const property = handler.property;
+
+        return new AllSetBuilder<TReadModel, IFromEveryBuilder<TReadModel>>(
+            property,
+            (targetProperty, expression) => { this.entry.properties[targetProperty] = expression; },
+            this
+        );
+    }
+
+    /** @inheritdoc */
+    excludeChildProjections(): IFromEveryBuilder<TReadModel> {
+        this.entry.includeChildren = false;
+        return this;
+    }
+}