@cratis/chronicle 0.1.0 → 0.2.1

package/dist/readModels/ReadModelSnapshot.d.ts

@@ -0,0 +1,15 @@
+import type { AppendedEvent, Guid as ContractsGuid } from '@cratis/chronicle.contracts';
+/**
+ * Represents a read model snapshot together with the events that produced it.
+ */
+export interface ReadModelSnapshot<TReadModel> {
+    /** The read model state at the snapshot. */
+    readonly readModel: TReadModel;
+    /** The events that were applied to reach the snapshot. */
+    readonly events: AppendedEvent[];
+    /** When the snapshot occurred. */
+    readonly occurred: Date | undefined;
+    /** The correlation identifier for the snapshot, when available. */
+    readonly correlationId: ContractsGuid | undefined;
+}
+//# sourceMappingURL=ReadModelSnapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReadModelSnapshot.d.ts","sourceRoot":"","sources":["../../readModels/ReadModelSnapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,UAAU;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAE/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAEjC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC;IAEpC,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;CACrD"}

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

package/dist/readModels/ReadModelSnapshot.js.map

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

package/dist/readModels/ReadModels.d.ts

@@ -0,0 +1,42 @@
+import type { Constructor } from '@cratis/fundamentals';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import type { IMaterializedReadModels } from './IMaterializedReadModels';
+import type { IReadModels } from './IReadModels';
+import type { ReadModelChangeset } from './ReadModelChangeset';
+import type { ReadModelSnapshot } from './ReadModelSnapshot';
+/**
+ * Implements {@link IReadModels} by working with the Chronicle read-model gRPC service.
+ */
+export declare class ReadModels implements IReadModels {
+    private readonly _eventStore;
+    private readonly _namespace;
+    private readonly _connection;
+    private readonly _clientArtifacts;
+    readonly materialized: IMaterializedReadModels;
+    constructor(_eventStore: string, _namespace: string, _connection: ChronicleConnection, _clientArtifacts: IClientArtifactsProvider);
+    /** @inheritdoc */
+    register<TReadModel>(readModelType?: Constructor<TReadModel>): Promise<void>;
+    /** @inheritdoc */
+    getInstanceById<TReadModel>(readModelType: Constructor<TReadModel>, key: string, sessionId?: string): Promise<TReadModel>;
+    /** @inheritdoc */
+    getInstances<TReadModel>(readModelType: Constructor<TReadModel>, eventCount?: bigint): Promise<TReadModel[]>;
+    /** @inheritdoc */
+    getSnapshotsById<TReadModel>(readModelType: Constructor<TReadModel>, key: string): Promise<ReadModelSnapshot<TReadModel>[]>;
+    /** @inheritdoc */
+    watch<TReadModel>(readModelType: Constructor<TReadModel>): AsyncIterable<ReadModelChangeset<TReadModel>>;
+    /** @inheritdoc */
+    dehydrateSession<TReadModel>(sessionId: string, readModelType: Constructor<TReadModel>, key: string): Promise<void>;
+    /** @inheritdoc */
+    release<TReadModel>(readModelType: Constructor<TReadModel>, instance: TReadModel): Promise<TReadModel>;
+    /** @inheritdoc */
+    releaseMany<TReadModel>(readModelType: Constructor<TReadModel>, instances: TReadModel[]): Promise<TReadModel[]>;
+    private resolveReadModels;
+    private resolveReadModel;
+    private toDefinition;
+    private getReadModelSchema;
+    private deserializeReadModel;
+    private schemaHasComplianceMetadata;
+    private extractSubject;
+}
+//# sourceMappingURL=ReadModels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReadModels.d.ts","sourceRoot":"","sources":["../../readModels/ReadModels.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAa7D;;GAEG;AACH,qBAAa,UAAW,YAAW,WAAW;IAItC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IANrC,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;gBAG1B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,mBAAmB,EAChC,gBAAgB,EAAE,wBAAwB;IAK/D,kBAAkB;IACZ,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAclF,kBAAkB;IACZ,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoB/H,kBAAkB;IACZ,YAAY,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,UAAU,GAAE,MAA4B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmBvI,kBAAkB;IACZ,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;IAkBjI,kBAAkB;IACX,KAAK,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAkB/G,kBAAkB;IACZ,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzH,kBAAkB;IACZ,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB5G,kBAAkB;IACZ,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKrH,OAAO,CAAC,iBAAiB;IA0EzB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,cAAc;CAQzB"}

package/dist/readModels/ReadModels.js

@@ -0,0 +1,270 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { ReadModelObserverType as ContractReadModelObserverType } from '@cratis/chronicle.contracts';
+import { JsonSerializer } from '@cratis/fundamentals';
+import { toContractsGuid } from '../connection/Guid';
+import { EventSequenceId } from '../eventSequences/EventSequenceId';
+import { getProjectionMetadata } from '../projections/declarative/projection';
+import { hasFromEventMetadata } from '../projections/modelBound/fromEvent';
+import { getReducerMetadata } from '../reducers/reducer';
+import { JsonSchemaGenerator } from '../schemas';
+import { WellKnownSinks } from '../sinks';
+import { getReadModelMetadata } from './readModel';
+import { MaterializedReadModels } from './MaterializedReadModels';
+const unlimitedEventCount = BigInt('18446744073709551615');
+/**
+ * Implements {@link IReadModels} by working with the Chronicle read-model gRPC service.
+ */
+export class ReadModels {
+    _eventStore;
+    _namespace;
+    _connection;
+    _clientArtifacts;
+    materialized;
+    constructor(_eventStore, _namespace, _connection, _clientArtifacts) {
+        this._eventStore = _eventStore;
+        this._namespace = _namespace;
+        this._connection = _connection;
+        this._clientArtifacts = _clientArtifacts;
+        this.materialized = new MaterializedReadModels(_eventStore, _namespace, _connection);
+    }
+    /** @inheritdoc */
+    async register(readModelType) {
+        const readModels = this.resolveReadModels(readModelType);
+        if (readModels.length === 0) {
+            return;
+        }
+        await this._connection.readModels.registerMany({
+            EventStore: this._eventStore,
+            Owner: 1,
+            Source: 1,
+            ReadModels: readModels.map(readModel => this.toDefinition(readModel))
+        });
+    }
+    /** @inheritdoc */
+    async getInstanceById(readModelType, key, sessionId) {
+        const readModel = this.resolveReadModel(readModelType);
+        const response = await this._connection.readModels.getInstanceByKey({
+            EventStore: this._eventStore,
+            Namespace: this._namespace,
+            ReadModelIdentifier: readModel.identifier,
+            EventSequenceId: readModel.eventSequenceId,
+            ReadModelKey: key,
+            SessionId: sessionId ?? ''
+        });
+        const instance = this.deserializeReadModel(readModelType, response.ReadModel);
+        if (readModel.observerType === ContractReadModelObserverType.Reducer && this.schemaHasComplianceMetadata(readModel.schema)) {
+            return this.release(readModelType, instance);
+        }
+        return instance;
+    }
+    /** @inheritdoc */
+    async getInstances(readModelType, eventCount = unlimitedEventCount) {
+        const readModel = this.resolveReadModel(readModelType);
+        const response = await this._connection.readModels.getAllInstances({
+            EventStore: this._eventStore,
+            Namespace: this._namespace,
+            ReadModelIdentifier: readModel.identifier,
+            EventSequenceId: readModel.eventSequenceId,
+            EventCount: eventCount
+        });
+        const instances = response.Instances.map(instance => this.deserializeReadModel(readModelType, instance));
+        if (readModel.observerType === ContractReadModelObserverType.Reducer && this.schemaHasComplianceMetadata(readModel.schema)) {
+            return this.releaseMany(readModelType, instances);
+        }
+        return instances;
+    }
+    /** @inheritdoc */
+    async getSnapshotsById(readModelType, key) {
+        const readModel = this.resolveReadModel(readModelType);
+        const response = await this._connection.readModels.getSnapshotsByKey({
+            EventStore: this._eventStore,
+            Namespace: this._namespace,
+            ReadModelIdentifier: readModel.identifier,
+            EventSequenceId: readModel.eventSequenceId,
+            ReadModelKey: key
+        });
+        return response.Snapshots.map(snapshot => ({
+            readModel: this.deserializeReadModel(readModelType, snapshot.ReadModel),
+            events: (snapshot.Events ?? []),
+            occurred: snapshot.Occurred?.Value ? new Date(snapshot.Occurred.Value) : undefined,
+            correlationId: snapshot.CorrelationId
+        }));
+    }
+    /** @inheritdoc */
+    async *watch(readModelType) {
+        const readModel = this.resolveReadModel(readModelType);
+        for await (const changeset of this._connection.readModels.watch({
+            EventStore: this._eventStore,
+            Namespace: this._namespace,
+            ReadModelIdentifier: readModel.identifier,
+            EventSequenceId: readModel.eventSequenceId
+        })) {
+            yield {
+                namespace: changeset.Namespace,
+                key: changeset.ModelKey,
+                readModel: this.deserializeReadModel(readModelType, changeset.ReadModel),
+                removed: changeset.Removed
+            };
+        }
+    }
+    /** @inheritdoc */
+    async dehydrateSession(sessionId, readModelType, key) {
+        const readModel = this.resolveReadModel(readModelType);
+        await this._connection.readModels.dehydrateSession({
+            EventStore: this._eventStore,
+            Namespace: this._namespace,
+            ReadModelIdentifier: readModel.identifier,
+            EventSequenceId: readModel.eventSequenceId,
+            ReadModelKey: key,
+            SessionId: sessionId
+        });
+    }
+    /** @inheritdoc */
+    async release(readModelType, instance) {
+        const readModel = this.resolveReadModel(readModelType);
+        const schema = this.getReadModelSchema(readModelType, readModel.identifier);
+        const payload = JsonSerializer.serialize(instance);
+        const subject = this.extractSubject(instance);
+        const response = await this._connection.compliance.release({
+            EventStore: this._eventStore,
+            Namespace: this._namespace,
+            Subject: subject,
+            Schema: schema,
+            Payload: payload
+        });
+        if (response.HasError) {
+            throw new Error(`Failed to release PII: ${response.Error}`);
+        }
+        return this.deserializeReadModel(readModelType, response.Payload);
+    }
+    /** @inheritdoc */
+    async releaseMany(readModelType, instances) {
+        const releasePromises = instances.map(instance => this.release(readModelType, instance));
+        return Promise.all(releasePromises);
+    }
+    resolveReadModels(readModelType) {
+        const resolved = new Map();
+        for (const projectionType of this._clientArtifacts.projections) {
+            const metadata = getProjectionMetadata(projectionType);
+            if (!metadata?.readModelType) {
+                continue;
+            }
+            if (readModelType && metadata.readModelType !== readModelType) {
+                continue;
+            }
+            const readModelMetadata = getReadModelMetadata(metadata.readModelType);
+            const identifier = readModelMetadata?.id.value ?? metadata.readModelType.name;
+            resolved.set(identifier, {
+                type: metadata.readModelType,
+                identifier,
+                eventSequenceId: metadata.eventSequenceId ?? EventSequenceId.eventLog.value,
+                observerType: ContractReadModelObserverType.Projection,
+                observerIdentifier: metadata.id.value,
+                schema: this.getReadModelSchema(metadata.readModelType, identifier)
+            });
+        }
+        for (const modelBoundType of this._clientArtifacts.readModels) {
+            if (!hasFromEventMetadata(modelBoundType)) {
+                continue;
+            }
+            if (readModelType && modelBoundType !== readModelType) {
+                continue;
+            }
+            const metadata = getReadModelMetadata(modelBoundType);
+            if (!metadata) {
+                continue;
+            }
+            resolved.set(metadata.id.value, {
+                type: modelBoundType,
+                identifier: metadata.id.value,
+                eventSequenceId: EventSequenceId.eventLog.value,
+                observerType: ContractReadModelObserverType.Projection,
+                observerIdentifier: metadata.id.value,
+                schema: JSON.stringify(metadata.schema)
+            });
+        }
+        for (const reducerType of this._clientArtifacts.reducers) {
+            const metadata = getReducerMetadata(reducerType);
+            if (!metadata?.readModel) {
+                continue;
+            }
+            if (readModelType && metadata.readModel !== readModelType) {
+                continue;
+            }
+            const readModelMetadata = getReadModelMetadata(metadata.readModel);
+            const identifier = readModelMetadata?.id.value ?? metadata.readModel.name;
+            resolved.set(identifier, {
+                type: metadata.readModel,
+                identifier,
+                eventSequenceId: metadata.eventSequenceId ?? EventSequenceId.eventLog.value,
+                observerType: ContractReadModelObserverType.Reducer,
+                observerIdentifier: metadata.id.value,
+                schema: this.getReadModelSchema(metadata.readModel, identifier)
+            });
+        }
+        return Array.from(resolved.values());
+    }
+    resolveReadModel(readModelType) {
+        const [resolved] = this.resolveReadModels(readModelType);
+        if (!resolved) {
+            throw new Error(`Unknown read model '${readModelType.name}'. Make sure it is decorated and discoverable.`);
+        }
+        return resolved;
+    }
+    toDefinition(readModel) {
+        return {
+            Type: {
+                Identifier: readModel.identifier,
+                Generation: 1
+            },
+            ContainerName: readModel.identifier,
+            DisplayName: readModel.identifier,
+            Sink: {
+                ConfigurationId: toContractsGuid(WellKnownSinks.Null),
+                TypeId: toContractsGuid(WellKnownSinks.MongoDB)
+            },
+            Schema: readModel.schema,
+            Indexes: [],
+            ObserverType: readModel.observerType,
+            ObserverIdentifier: readModel.observerIdentifier,
+            Owner: 1,
+            Source: 1
+        };
+    }
+    getReadModelSchema(readModelType, identifier) {
+        const metadata = getReadModelMetadata(readModelType);
+        if (metadata) {
+            return JSON.stringify(metadata.schema);
+        }
+        return JSON.stringify(JsonSchemaGenerator.generate(readModelType) ?? JsonSchemaGenerator.createEmptySchema(identifier));
+    }
+    deserializeReadModel(readModelType, json) {
+        if (!json) {
+            return Object.create(readModelType.prototype);
+        }
+        return JsonSerializer.deserialize(readModelType, json);
+    }
+    schemaHasComplianceMetadata(schema) {
+        try {
+            const parsed = JSON.parse(schema);
+            const properties = parsed.properties;
+            if (!properties) {
+                return false;
+            }
+            return Object.values(properties).some(property => Array.isArray(property.compliance) && property.compliance.length > 0);
+        }
+        catch {
+            return false;
+        }
+    }
+    extractSubject(instance) {
+        // By convention, use the 'id' property as the subject
+        const anyInstance = instance;
+        if (anyInstance.id !== undefined && anyInstance.id !== null) {
+            return String(anyInstance.id);
+        }
+        throw new Error('Read model instance must have an "id" property to serve as the subject for PII release');
+    }
+}
+//# sourceMappingURL=ReadModels.js.map

package/dist/readModels/ReadModels.js.map

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

package/dist/readModels/index.d.ts

@@ -0,0 +1,10 @@
+export { ReadModelId } from './ReadModelId';
+export type { IReadModels } from './IReadModels';
+export type { IMaterializedReadModels } from './IMaterializedReadModels';
+export { ReadModels } from './ReadModels';
+export { MaterializedReadModels } from './MaterializedReadModels';
+export type { ReadModelChangeset } from './ReadModelChangeset';
+export type { ReadModelSnapshot } from './ReadModelSnapshot';
+export { readModel, getReadModelMetadata, isReadModel } from './readModel';
+export type { ReadModelMetadata } from './readModel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../readModels/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/readModels/index.js

@@ -0,0 +1,7 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { ReadModelId } from './ReadModelId';
+export { ReadModels } from './ReadModels';
+export { MaterializedReadModels } from './MaterializedReadModels';
+export { readModel, getReadModelMetadata, isReadModel } from './readModel';
+//# sourceMappingURL=index.js.map

package/dist/readModels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../readModels/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/readModels/readModel.d.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { ReadModelId } from './ReadModelId';
+import { JsonSchema } from '../schemas';
+/**
+ * Metadata stored on a read model class.
+ */
+export interface ReadModelMetadata {
+    /** The unique identifier for the read model. */
+    readonly id: ReadModelId;
+    /** The reflected members and their runtime types. */
+    readonly members: ReadonlyMap<string, Function | undefined>;
+    /** The generated JSON schema for the read model. */
+    readonly schema: JsonSchema;
+}
+/**
+ * TypeScript decorator that marks a class as a read model and captures reflection metadata.
+ * @param id - The unique identifier for the read model. Defaults to the class name if omitted.
+ * @returns A class decorator.
+ */
+export declare function readModel(id?: string): ClassDecorator;
+/**
+ * Gets the {@link ReadModelMetadata} associated with a class decorated with {@link readModel}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export declare function getReadModelMetadata(target: Function): ReadModelMetadata | undefined;
+/**
+ * Checks whether a class has been decorated with {@link readModel}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a read model decorator; false otherwise.
+ */
+export declare function isReadModel(target: Function): boolean;
+//# sourceMappingURL=readModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readModel.d.ts","sourceRoot":"","sources":["../../readModels/readModel.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAK7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IAEzB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAE5D,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,GAAE,MAAW,GAAG,cAAc,CAiBzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAErD"}

package/dist/readModels/readModel.js

@@ -0,0 +1,44 @@
+// 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 { ReadModelId } from './ReadModelId';
+import { DecoratorType, TypeDiscoverer, TypeIntrospector } from '../types';
+import { JsonSchemaGenerator } from '../schemas';
+/** Metadata key used to store read model information on a class. */
+const READ_MODEL_METADATA_KEY = 'chronicle:readModel';
+/**
+ * TypeScript decorator that marks a class as a read model and captures reflection metadata.
+ * @param id - The unique identifier for the read model. Defaults to the class name if omitted.
+ * @returns A class decorator.
+ */
+export function readModel(id = '') {
+    return (target) => {
+        const constructor = target;
+        const readModelId = new ReadModelId(id || constructor.name);
+        const members = TypeIntrospector.getMembers(constructor);
+        const metadata = {
+            id: readModelId,
+            members,
+            schema: JsonSchemaGenerator.generate(constructor, members)
+        };
+        Reflect.defineMetadata(READ_MODEL_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.ReadModel, constructor, readModelId.value);
+    };
+}
+/**
+ * Gets the {@link ReadModelMetadata} associated with a class decorated with {@link readModel}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export function getReadModelMetadata(target) {
+    return Reflect.getMetadata(READ_MODEL_METADATA_KEY, target);
+}
+/**
+ * Checks whether a class has been decorated with {@link readModel}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a read model decorator; false otherwise.
+ */
+export function isReadModel(target) {
+    return Reflect.hasMetadata(READ_MODEL_METADATA_KEY, target);
+}
+//# sourceMappingURL=readModel.js.map

package/dist/readModels/readModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readModel.js","sourceRoot":"","sources":["../../readModels/readModel.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAc,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7D,oEAAoE;AACpE,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAgBtD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE;IACrC,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,MAAkB,CAAC;QACvC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAsB;YAChC,EAAE,EAAE,WAAW;YACf,OAAO;YACP,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;SAC7D,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,SAAS,EACvB,WAA0B,EAC1B,WAAW,CAAC,KAAK,CACpB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAgB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgB;IACxC,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/reducers/IReducers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReducers.d.ts","sourceRoot":"","sources":["../../reducers/IReducers.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/reducers/IReducers.js.map

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

package/dist/reducers/ReducerId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReducerId.d.ts","sourceRoot":"","sources":["../../reducers/ReducerId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,SAAS;IACN,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/reducers/ReducerId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReducerId.js","sourceRoot":"","sources":["../../reducers/ReducerId.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,SAAS;IACG;IAArB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ"}

package/dist/reducers/Reducers.d.ts

@@ -0,0 +1,41 @@
+import 'reflect-metadata';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import { ConnectionLifecycle } from '../connection/ConnectionLifecycle';
+import { IReducers } from './IReducers';
+/**
+ * Implements {@link IReducers}, managing discovery and registration of reducers
+ * with the Chronicle Kernel via bidirectional gRPC streaming.
+ */
+export declare class Reducers implements IReducers {
+    private readonly _clientArtifacts;
+    private readonly _connection;
+    private readonly _eventStoreName;
+    private readonly _namespace;
+    private readonly _logger;
+    private readonly _lifecycle;
+    private readonly _reducers;
+    private readonly _queues;
+    private _registered;
+    /**
+     * Creates a new {@link Reducers} instance.
+     * @param _clientArtifacts - Provider for discovered client artifact types.
+     * @param _connection - The Chronicle gRPC connection.
+     * @param _eventStoreName - The name of the event store.
+     * @param _namespace - The namespace within the event store.
+     * @param lifecycle - The connection lifecycle used to react to disconnect events.
+     */
+    constructor(_clientArtifacts: IClientArtifactsProvider, _connection: ChronicleConnection, _eventStoreName: string, _namespace: string, lifecycle: ConnectionLifecycle);
+    /** @inheritdoc */
+    discover(): Promise<void>;
+    /** @inheritdoc */
+    register(): Promise<void>;
+    private registerReadModels;
+    private getReducerSchema;
+    private startObservation;
+    private getReducerReadModelIdentifier;
+    private observeReducer;
+    private getEventTypesFor;
+    private disconnectAll;
+}
+//# sourceMappingURL=Reducers.d.ts.map

package/dist/reducers/Reducers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reducers.d.ts","sourceRoot":"","sources":["../../reducers/Reducers.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAIxE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA2ExC;;;GAGG;AACH,qBAAa,QAAS,YAAW,SAAS;IAgBlC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAlB/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiD;IACzE,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;OAOG;gBAEkB,gBAAgB,EAAE,wBAAwB,EAC1C,WAAW,EAAE,mBAAmB,EAChC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EACnC,SAAS,EAAE,mBAAmB;IAUlC,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBjB,kBAAkB;IAoChC,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,6BAA6B;YASvB,cAAc;IA+H5B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,aAAa;CAMxB"}