@cratis/chronicle 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventTypes.d.ts","sourceRoot":"","sources":["../../Events/EventTypes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAUtC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAXrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD;;;;;OAKG;gBAEkB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,mBAAmB,EAChC,gBAAgB,EAAE,wBAAwB;IAG/D,kBAAkB;IAClB,IAAI,GAAG,IAAI,WAAW,EAAE,CAEvB;IAED,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC/B,kBAAkB;IAClB,MAAM,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO;IAIhC,kBAAkB;IAClB,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW;CAO3C"}

package/dist/Events/EventTypes.js

@@ -0,0 +1,83 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { getEventTypeMetadata, getEventTypeJsonSchemaFor } from './eventTypeDecorator';
+/**
+ * Implements {@link IEventTypes}, managing discovery and registration of event types
+ * with the Chronicle Kernel.
+ */
+export class EventTypes {
+    _eventStore;
+    _connection;
+    _clientArtifacts;
+    _types = new Map();
+    /**
+     * 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, _connection, _clientArtifacts) {
+        this._eventStore = _eventStore;
+        this._connection = _connection;
+        this._clientArtifacts = _clientArtifacts;
+    }
+    /** @inheritdoc */
+    get all() {
+        return [...this._types.values()];
+    }
+    /** @inheritdoc */
+    async discover() {
+        this._types.clear();
+        for (const type of this._clientArtifacts.eventTypes) {
+            const metadata = getEventTypeMetadata(type);
+            if (metadata) {
+                this._types.set(metadata.eventType.id.value, type);
+            }
+        }
+    }
+    /** @inheritdoc */
+    async register() {
+        if (this._types.size === 0) {
+            await this.discover();
+        }
+        const registrations = [...this._types.entries()].map(([, type]) => {
+            const metadata = getEventTypeMetadata(type);
+            const schema = getEventTypeJsonSchemaFor(type);
+            return {
+                Type: {
+                    Id: metadata.eventType.id.value,
+                    Generation: metadata.eventType.generation.value,
+                    Tombstone: false
+                },
+                Schema: JSON.stringify(schema),
+                Generations: [{
+                        Generation: metadata.eventType.generation.value,
+                        Schema: JSON.stringify(schema)
+                    }],
+                Migrations: [],
+                EventStore: this._eventStore
+            };
+        });
+        if (registrations.length === 0) {
+            return;
+        }
+        await this._connection.eventTypes.register({
+            EventStore: this._eventStore,
+            Types: registrations,
+            DisableValidation: false
+        });
+    }
+    /** @inheritdoc */
+    hasFor(id) {
+        return this._types.has(id.value);
+    }
+    /** @inheritdoc */
+    getTypeFor(id) {
+        const type = this._types.get(id.value);
+        if (!type) {
+            throw new Error(`No event type registered for id '${id.value}'.`);
+        }
+        return type;
+    }
+}
+//# sourceMappingURL=EventTypes.js.map

package/dist/Events/EventTypes.js.map

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

package/dist/Events/IEventTypes.d.ts

@@ -0,0 +1,32 @@
+import { Constructor } from '@cratis/fundamentals';
+import { EventTypeId } from './EventTypeId';
+/**
+ * Defines a system to work with event types, including discovery and registration with the Kernel.
+ */
+export interface IEventTypes {
+    /** Gets all registered event type constructors. */
+    readonly all: Constructor[];
+    /**
+     * Discovers all event types from the registered client artifacts.
+     * @returns A promise that resolves when discovery is complete.
+     */
+    discover(): Promise<void>;
+    /**
+     * Registers all discovered event types with the Chronicle Kernel.
+     * @returns A promise that resolves when registration is complete.
+     */
+    register(): Promise<void>;
+    /**
+     * Checks whether an event type constructor exists for the given identifier.
+     * @param id - The event type identifier to look up.
+     * @returns True if a matching type exists; otherwise false.
+     */
+    hasFor(id: EventTypeId): boolean;
+    /**
+     * Gets the event type constructor for the given identifier.
+     * @param id - The event type identifier to look up.
+     * @returns The constructor for the event type.
+     */
+    getTypeFor(id: EventTypeId): Constructor;
+}
+//# sourceMappingURL=IEventTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IEventTypes.d.ts","sourceRoot":"","sources":["../../Events/IEventTypes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC;IAE5B;;;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,WAAW,GAAG,OAAO,CAAC;IAEjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;CAC5C"}

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

package/dist/Events/IEventTypes.js.map

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

package/dist/Events/eventTypeDecorator.d.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+import { EventType } from './EventType';
+import { JsonSchema } from '../Schemas';
+/**
+ * Metadata stored for an event type class.
+ */
+export interface EventTypeMetadata {
+    /** The event type descriptor for the event class. */
+    readonly eventType: EventType;
+    /** The reflected members and their runtime types. */
+    readonly members: ReadonlyMap<string, Function | undefined>;
+    /** The generated schema for the event class. */
+    readonly schema: JsonSchema;
+}
+/**
+ * TypeScript decorator that marks a class as an event type and associates it with a specific
+ * {@link EventType} identifier and generation. This is the TypeScript equivalent of the
+ * C# `[EventType]` attribute.
+ *
+ * Overloads:
+ * - `@eventType()` -> uses class name as id, generation 1, tombstone false.
+ * - `@eventType(generation)` -> uses class name as id and provided generation.
+ * - `@eventType(tombstone)` -> uses class name as id/generation and provided tombstone.
+ * - `@eventType(generation, tombstone)` -> uses class name as id.
+ * - `@eventType(id, generation, tombstone)` -> full explicit form.
+ *
+ * @param idOrGenerationOrTombstone - Optional id, generation, or tombstone based on overload.
+ * @param generationOrTombstone - Optional generation or tombstone based on overload.
+ * @param tombstone - Optional explicit tombstone for the explicit id overload.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @eventType()
+ * class EmployeeHired {
+ *     constructor(readonly firstName: string, readonly lastName: string) {}
+ * }
+ * ```
+ */
+export declare function eventType(): ClassDecorator;
+export declare function eventType(id: string): ClassDecorator;
+export declare function eventType(id: string, generation: number): ClassDecorator;
+export declare function eventType(id: string, generation: number, tombstone: boolean): ClassDecorator;
+export declare function eventType(generation: number): ClassDecorator;
+export declare function eventType(generation: number, tombstone: boolean): ClassDecorator;
+export declare function eventType(tombstone: boolean): ClassDecorator;
+/**
+ * Gets the {@link EventType} associated with a class decorated with {@link eventType}.
+ * @param target - The class constructor to retrieve the event type for.
+ * @returns The associated EventType, or EventType.unknown if not decorated.
+ */
+export declare function getEventTypeFor(target: Function): EventType;
+/**
+ * Checks whether a class has been decorated with {@link eventType}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has an event type decorator; false otherwise.
+ */
+export declare function hasEventType(target: Function): boolean;
+/**
+ * Gets the metadata associated with a class decorated with {@link eventType}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export declare function getEventTypeMetadata(target: Function): EventTypeMetadata | undefined;
+/**
+ * Generates a JSON schema for the provided event type class.
+ * @param target - The event class constructor to generate schema for.
+ * @returns The generated JSON schema.
+ */
+export declare function getEventTypeJsonSchemaFor(target: Function): JsonSchema;
+//# sourceMappingURL=eventTypeDecorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventTypeDecorator.d.ts","sourceRoot":"","sources":["../../Events/eventTypeDecorator.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAK7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAE5D,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAAC;AAC5C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAAC;AACtD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;AAC1E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,CAAC;AAC9F,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;AAC9D,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,CAAC;AAClF,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,CAAC;AAgD9D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAOtE"}

package/dist/Events/eventTypeDecorator.js

@@ -0,0 +1,86 @@
+// 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 { EventType } from './EventType';
+import { EventTypeId } from './EventTypeId';
+import { EventTypeGeneration } from './EventTypeGeneration';
+import { DecoratorType, TypeDiscoverer, TypeIntrospector } from '../types';
+import { JsonSchemaGenerator } from '../Schemas';
+/** Metadata key used to store event type information on a class. */
+const EVENT_TYPE_METADATA_KEY = 'chronicle:eventType';
+export function eventType(idOrGenerationOrTombstone, generationOrTombstone, tombstone = false) {
+    let id = '';
+    let generation = EventTypeGeneration.firstValue;
+    let isTombstone = false;
+    if (typeof idOrGenerationOrTombstone === 'string') {
+        id = idOrGenerationOrTombstone;
+        if (typeof generationOrTombstone === 'number') {
+            generation = generationOrTombstone;
+        }
+        if (typeof generationOrTombstone === 'boolean') {
+            isTombstone = generationOrTombstone;
+        }
+        else {
+            isTombstone = tombstone;
+        }
+    }
+    else if (typeof idOrGenerationOrTombstone === 'number') {
+        generation = idOrGenerationOrTombstone;
+        if (typeof generationOrTombstone === 'boolean') {
+            isTombstone = generationOrTombstone;
+        }
+    }
+    else if (typeof idOrGenerationOrTombstone === 'boolean') {
+        isTombstone = idOrGenerationOrTombstone;
+    }
+    return (target) => {
+        const constructor = target;
+        const eventTypeId = new EventTypeId(id || constructor.name);
+        const eventTypeInstance = new EventType(eventTypeId, new EventTypeGeneration(generation), isTombstone);
+        const members = TypeIntrospector.getMembers(constructor);
+        const metadata = {
+            eventType: eventTypeInstance,
+            members,
+            schema: JsonSchemaGenerator.generate(constructor, members)
+        };
+        Reflect.defineMetadata(EVENT_TYPE_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.EventType, constructor, eventTypeId.value);
+    };
+}
+/**
+ * Gets the {@link EventType} associated with a class decorated with {@link eventType}.
+ * @param target - The class constructor to retrieve the event type for.
+ * @returns The associated EventType, or EventType.unknown if not decorated.
+ */
+export function getEventTypeFor(target) {
+    return getEventTypeMetadata(target)?.eventType ?? EventType.unknown;
+}
+/**
+ * Checks whether a class has been decorated with {@link eventType}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has an event type decorator; false otherwise.
+ */
+export function hasEventType(target) {
+    return getEventTypeMetadata(target) !== undefined;
+}
+/**
+ * Gets the metadata associated with a class decorated with {@link eventType}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export function getEventTypeMetadata(target) {
+    return Reflect.getMetadata(EVENT_TYPE_METADATA_KEY, target);
+}
+/**
+ * Generates a JSON schema for the provided event type class.
+ * @param target - The event class constructor to generate schema for.
+ * @returns The generated JSON schema.
+ */
+export function getEventTypeJsonSchemaFor(target) {
+    const metadata = getEventTypeMetadata(target);
+    if (metadata) {
+        return metadata.schema;
+    }
+    return JsonSchemaGenerator.createEmptySchema(target.name);
+}
+//# sourceMappingURL=eventTypeDecorator.js.map

package/dist/Events/eventTypeDecorator.js.map

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

package/dist/Events/index.d.ts

@@ -0,0 +1,12 @@
+export { EventType } from './EventType';
+export { EventTypeId } from './EventTypeId';
+export { EventTypeGeneration } from './EventTypeGeneration';
+export { eventType, getEventTypeFor, hasEventType, getEventTypeMetadata, getEventTypeJsonSchemaFor } from './eventTypeDecorator';
+export type { EventTypeMetadata } from './eventTypeDecorator';
+export type { EventContext } from './EventContext';
+export type { CausationEntry } from './CausationEntry';
+export type { AppendedEvent } from './AppendedEvent';
+export type { IEventTypes } from './IEventTypes';
+export { EventTypes } from './EventTypes';
+export * from './Constraints';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Events/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjI,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,cAAc,eAAe,CAAC"}

package/dist/Events/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { EventType } from './EventType';
+export { EventTypeId } from './EventTypeId';
+export { EventTypeGeneration } from './EventTypeGeneration';
+export { eventType, getEventTypeFor, hasEventType, getEventTypeMetadata, getEventTypeJsonSchemaFor } from './eventTypeDecorator';
+export { EventTypes } from './EventTypes';
+export * from './Constraints';
+//# sourceMappingURL=index.js.map

package/dist/Events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Events/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAMjI,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,cAAc,eAAe,CAAC"}

package/dist/Grpc.d.ts

@@ -0,0 +1,19 @@
+import { ServiceError, ClientUnaryCall } from '@grpc/grpc-js';
+/**
+ * Provides utility methods for working with gRPC clients.
+ */
+export declare class Grpc {
+    /**
+     * Promisifies a gRPC unary call that uses a callback-based API.
+     * @param callFunction - A function that invokes the gRPC method with a callback.
+     * @returns A Promise that resolves with the response or rejects with the service error.
+     */
+    static call<TResponse>(callFunction: (callback: (error: ServiceError | null, response: TResponse) => void) => ClientUnaryCall): Promise<TResponse>;
+}
+/**
+ * Promisifies a gRPC unary call that uses a callback-based API.
+ * @param callFunction - A function that invokes the gRPC method with a callback.
+ * @returns A Promise that resolves with the response or rejects with the service error.
+ */
+export declare function promisifyGrpcCall<TResponse>(callFunction: (callback: (error: ServiceError | null, response: TResponse) => void) => ClientUnaryCall): Promise<TResponse>;
+//# sourceMappingURL=Grpc.d.ts.map

package/dist/Grpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grpc.d.ts","sourceRoot":"","sources":["../Grpc.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,qBAAa,IAAI;IACb;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,EACjB,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,KAAK,IAAI,KAAK,eAAe,GACvG,OAAO,CAAC,SAAS,CAAC;CAWxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EACvC,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,KAAK,IAAI,KAAK,eAAe,GACvG,OAAO,CAAC,SAAS,CAAC,CAEpB"}

package/dist/Grpc.js

@@ -0,0 +1,33 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Provides utility methods for working with gRPC clients.
+ */
+export class Grpc {
+    /**
+     * Promisifies a gRPC unary call that uses a callback-based API.
+     * @param callFunction - A function that invokes the gRPC method with a callback.
+     * @returns A Promise that resolves with the response or rejects with the service error.
+     */
+    static call(callFunction) {
+        return new Promise((resolve, reject) => {
+            callFunction((error, response) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve(response);
+                }
+            });
+        });
+    }
+}
+/**
+ * Promisifies a gRPC unary call that uses a callback-based API.
+ * @param callFunction - A function that invokes the gRPC method with a callback.
+ * @returns A Promise that resolves with the response or rejects with the service error.
+ */
+export function promisifyGrpcCall(callFunction) {
+    return Grpc.call(callFunction);
+}
+//# sourceMappingURL=Grpc.js.map

package/dist/Grpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grpc.js","sourceRoot":"","sources":["../Grpc.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAIrG;;GAEG;AACH,MAAM,OAAO,IAAI;IACb;;;;OAIG;IACH,MAAM,CAAC,IAAI,CACP,YAAsG;QAEtG,OAAO,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,YAAY,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC7B,IAAI,KAAK,EAAE,CAAC;oBACR,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtB,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC7B,YAAsG;IAEtG,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC"}

package/dist/IChronicleClient.d.ts

@@ -0,0 +1,33 @@
+import { ChronicleOptions } from './ChronicleOptions';
+import { EventStoreName } from './EventStoreName';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName';
+import { IEventStore } from './IEventStore';
+/**
+ * Defines the Cratis Chronicle client API surface.
+ *
+ * The Chronicle client is the primary entry point for interacting with the
+ * Chronicle Kernel. Use it to obtain event stores, which in turn provide access
+ * to event sequences for appending and observing events.
+ */
+export interface IChronicleClient {
+    /** The options used to configure the client. */
+    readonly options: ChronicleOptions;
+    /**
+     * Gets or creates an event store by name and optional namespace.
+     * If no namespace is provided, the default namespace is used.
+     * @param name - The name of the event store.
+     * @param namespace - Optional namespace name within the event store.
+     * @returns The event store.
+     */
+    getEventStore(name: string | EventStoreName, namespace?: string | EventStoreNamespaceName): Promise<IEventStore>;
+    /**
+     * Lists all event stores registered with the Chronicle Kernel.
+     * @returns An array of event store names.
+     */
+    getEventStores(): Promise<EventStoreName[]>;
+    /**
+     * Disposes of the client and releases all underlying resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=IChronicleClient.d.ts.map

package/dist/IChronicleClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IChronicleClient.d.ts","sourceRoot":"","sources":["../IChronicleClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IAEnC;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjH;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE5C;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB"}

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

package/dist/IChronicleClient.js.map

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

package/dist/IEventStore.d.ts

@@ -0,0 +1,44 @@
+import { IEventLog } from './EventSequences/IEventLog';
+import { IEventSequence } from './EventSequences/IEventSequence';
+import { EventSequenceId } from './EventSequences/EventSequenceId';
+import { EventStoreName } from './EventStoreName';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName';
+import { IEventTypes } from './Events/IEventTypes';
+import { IConstraints } from './Events/Constraints/IConstraints';
+import { IProjections } from './Projections/IProjections';
+import { IReactors } from './Reactors/IReactors';
+import { IReducers } from './Reducers/IReducers';
+/**
+ * Defines the API surface for an event store.
+ * An event store is a logical grouping of event sequences within a namespace.
+ */
+export interface IEventStore {
+    /** The name of the event store. */
+    readonly name: EventStoreName;
+    /** The namespace of the event store. */
+    readonly namespace: EventStoreNamespaceName;
+    /** The primary event log sequence for this event store. */
+    readonly eventLog: IEventLog;
+    /** The event types manager for this event store. */
+    readonly eventTypes: IEventTypes;
+    /** The constraints manager for this event store. */
+    readonly constraints: IConstraints;
+    /** The projections manager for this event store. */
+    readonly projections: IProjections;
+    /** The reactors manager for this event store. */
+    readonly reactors: IReactors;
+    /** The reducers manager for this event store. */
+    readonly reducers: IReducers;
+    /**
+     * Gets an event sequence by its identifier.
+     * @param id - The identifier of the event sequence to retrieve.
+     * @returns The event sequence with the given identifier.
+     */
+    getEventSequence(id: EventSequenceId): IEventSequence;
+    /**
+     * Lists the namespaces available in this event store.
+     * @returns An array of namespace names.
+     */
+    getNamespaces(): Promise<EventStoreNamespaceName[]>;
+}
+//# sourceMappingURL=IEventStore.d.ts.map

package/dist/IEventStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEventStore.d.ts","sourceRoot":"","sources":["../IEventStore.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAE5C,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,eAAe,GAAG,cAAc,CAAC;IAEtD;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACvD"}

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

package/dist/IEventStore.js.map

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

package/dist/Metrics.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The name of the Chronicle metrics instrumentation library.
+ * This matches {@link ChronicleInstrumentationName} from Tracing so that all Chronicle
+ * telemetry is grouped under a single instrumentation scope in your observability backend.
+ */
+export declare const ChronicleMeterName = "@cratis/chronicle";
+/**
+ * The OpenTelemetry meter used by the Chronicle client for all metric instrumentation.
+ *
+ * If your application has configured an OpenTelemetry SDK (e.g. via {@link https://www.npmjs.com/package/@opentelemetry/sdk-node}),
+ * Chronicle metrics will automatically flow through it.
+ * If no SDK is configured, the no-op meter is used and no overhead is incurred.
+ */
+export declare const ChronicleMeter: import("@opentelemetry/api").Meter;
+/**
+ * Pre-built metric instruments for all Chronicle client operations.
+ * These are created once and shared across all invocations.
+ */
+export declare const ChronicleMetrics: {
+    /**
+     * Counts the number of individual events appended to an event sequence.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`,
+     * `chronicle.event_sequence_id`, `chronicle.event_type_id`
+     */
+    eventsAppended: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+    /**
+     * Counts the number of batch-append operations performed on an event sequence.
+     * Each call to appendMany counts as one batch regardless of how many events it contains.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`,
+     * `chronicle.event_sequence_id`, `chronicle.events_count`
+     */
+    batchAppendsPerformed: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+    /**
+     * Counts the number of event store retrieval operations.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`
+     */
+    eventStoreRetrievals: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+    /**
+     * Measures the duration of append operations in milliseconds.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`,
+     * `chronicle.event_sequence_id`, `chronicle.event_type_id`
+     */
+    appendDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+    /**
+     * Measures the duration of batch-append operations in milliseconds.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`,
+     * `chronicle.event_sequence_id`, `chronicle.events_count`
+     */
+    appendManyDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+    /**
+     * Counts the number of append constraint violations encountered.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`,
+     * `chronicle.event_sequence_id`
+     */
+    constraintViolations: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+    /**
+     * Counts the number of append errors encountered.
+     *
+     * Attributes: `chronicle.event_store`, `chronicle.namespace`,
+     * `chronicle.event_sequence_id`
+     */
+    appendErrors: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+};
+//# sourceMappingURL=Metrics.d.ts.map

package/dist/Metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../Metrics.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,oCAAuC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IACzB;;;;;OAKG;;IAMH;;;;;;OAMG;;IAMH;;;;OAIG;;IAMH;;;;;OAKG;;IASH;;;;;OAKG;;IASH;;;;;OAKG;;IAMH;;;;;OAKG;;CAKN,CAAC"}