@cratis/chronicle 0.0.1

package/dist/Reducers/reducer.js

@@ -0,0 +1,59 @@
+// 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 { ReducerId } from './ReducerId';
+import { DecoratorType, TypeDiscoverer } from '../types';
+/** Metadata key used to store reducer information on a class. */
+const REDUCER_METADATA_KEY = 'chronicle:reducer';
+/**
+ * TypeScript decorator that marks a class as a reducer and associates it with a unique
+ * identifier. This is the TypeScript equivalent of the C# `[Reducer]` attribute.
+ *
+ * Reducers observe events from an event sequence and fold them into a read model.
+ * Each handler method receives the event, the current state (or undefined), and an
+ * optional context, and returns the new state.
+ *
+ * @param id - The unique identifier for the reducer. Defaults to the class name if omitted.
+ * @param eventSequenceId - Optional explicit event sequence identifier.
+ * @param readModel - Optional read model type produced by the reducer.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @reducer()
+ * class EmployeeReducer {
+ *     async employeeHired(event: EmployeeHired, state?: EmployeeState): Promise<EmployeeState> {
+ *         return { ...state, name: `${event.firstName} ${event.lastName}` };
+ *     }
+ * }
+ * ```
+ */
+export function reducer(id = '', eventSequenceId, readModel) {
+    return (target) => {
+        const constructor = target;
+        const reducerId = new ReducerId(id || constructor.name);
+        const metadata = { id: reducerId, eventSequenceId, readModel };
+        Reflect.defineMetadata(REDUCER_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.Reducer, constructor, reducerId.value);
+        if (readModel) {
+            TypeDiscoverer.default.register(DecoratorType.ReadModel, readModel, readModel.name);
+        }
+    };
+}
+/**
+ * Gets the {@link ReducerMetadata} associated with a class decorated with {@link reducer}.
+ * @param target - The class constructor to retrieve the metadata for.
+ * @returns The associated ReducerMetadata, or undefined if not decorated.
+ */
+export function getReducerMetadata(target) {
+    return Reflect.getMetadata(REDUCER_METADATA_KEY, target);
+}
+/**
+ * Checks whether a class has been decorated with {@link reducer}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a reducer decorator; false otherwise.
+ */
+export function isReducer(target) {
+    return Reflect.hasMetadata(REDUCER_METADATA_KEY, target);
+}
+//# sourceMappingURL=reducer.js.map

package/dist/Reducers/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../Reducers/reducer.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD,iEAAiE;AACjE,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAgBjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,EAAE,eAAwB,EAAE,SAAuB;IACtF,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,MAAkB,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAoB,EAAE,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;QAChF,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,OAAO,EACrB,WAA0B,EAC1B,SAAS,CAAC,KAAK,CAClB,CAAC;QAEF,IAAI,SAAS,EAAE,CAAC;YACZ,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,SAAS,EACvB,SAAS,EACT,SAAS,CAAC,IAAI,CACjB,CAAC;QACN,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB;IACtC,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/Schemas/JsonSchema.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Represents a JSON Schema object.
+ */
+export type JsonSchema = {
+    $schema?: string;
+    title?: string;
+    description?: string;
+    type?: 'null' | 'boolean' | 'object' | 'array' | 'number' | 'string' | 'integer';
+    format?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    additionalProperties?: boolean | JsonSchema;
+    enum?: Array<string | number | boolean | null>;
+};
+//# sourceMappingURL=JsonSchema.d.ts.map

package/dist/Schemas/JsonSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSchema.d.ts","sourceRoot":"","sources":["../../Schemas/JsonSchema.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAClD,CAAC"}

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

package/dist/Schemas/JsonSchema.js.map

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

package/dist/Schemas/JsonSchemaGenerator.d.ts

@@ -0,0 +1,26 @@
+import 'reflect-metadata';
+import { JsonSchema } from './JsonSchema';
+/**
+ * Generates JSON schemas for class constructors using reflection metadata.
+ */
+export declare class JsonSchemaGenerator {
+    private static readonly _knownTypeFormats;
+    private static readonly _formatAliases;
+    /**
+     * Creates an empty schema for a type name.
+     * @param title - The title to use for the schema.
+     * @returns An empty object schema.
+     */
+    static createEmptySchema(title: string): JsonSchema;
+    /**
+     * Generates a JSON schema for a class constructor.
+     * @param target - The class constructor to generate schema for.
+     * @param members - Optional pre-introspected members for reuse.
+     * @returns The generated JSON schema.
+     */
+    static generate(target: Function, members?: ReadonlyMap<string, Function | undefined>): JsonSchema;
+    private static mapRuntimeTypeToSchema;
+    private static getKnownTypeFormat;
+    private static normalizeFormat;
+}
+//# sourceMappingURL=JsonSchemaGenerator.d.ts.map

package/dist/Schemas/JsonSchemaGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSchemaGenerator.d.ts","sourceRoot":"","sources":["../../Schemas/JsonSchemaGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;GAEG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAGtC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAEnC;IAEH;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAWnD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,UAAU;IAclG,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA6BrC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAgBjC,OAAO,CAAC,MAAM,CAAC,eAAe;CAIjC"}

package/dist/Schemas/JsonSchemaGenerator.js

@@ -0,0 +1,90 @@
+// 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 { Guid } from '@cratis/fundamentals';
+import { TypeIntrospector } from '../types';
+/**
+ * Generates JSON schemas for class constructors using reflection metadata.
+ */
+export class JsonSchemaGenerator {
+    static _knownTypeFormats = new Map([
+        [Guid, { type: 'string', format: 'guid' }],
+        [Date, { type: 'string', format: 'date-time' }]
+    ]);
+    static _formatAliases = new Map([
+        ['uuid', 'guid']
+    ]);
+    /**
+     * Creates an empty schema for a type name.
+     * @param title - The title to use for the schema.
+     * @returns An empty object schema.
+     */
+    static createEmptySchema(title) {
+        return {
+            $schema: 'https://json-schema.org/draft/2020-12/schema',
+            title,
+            type: 'object',
+            properties: {},
+            required: [],
+            additionalProperties: false
+        };
+    }
+    /**
+     * Generates a JSON schema for a class constructor.
+     * @param target - The class constructor to generate schema for.
+     * @param members - Optional pre-introspected members for reuse.
+     * @returns The generated JSON schema.
+     */
+    static generate(target, members) {
+        const membersToUse = members ?? TypeIntrospector.getMembers(target);
+        const schemaProperties = {};
+        for (const [memberName, memberType] of membersToUse.entries()) {
+            schemaProperties[memberName] = this.mapRuntimeTypeToSchema(memberType);
+        }
+        return {
+            ...this.createEmptySchema(target.name),
+            properties: schemaProperties,
+            required: Array.from(membersToUse.keys()),
+        };
+    }
+    static mapRuntimeTypeToSchema(runtimeType) {
+        const knownTypeFormat = this.getKnownTypeFormat(runtimeType);
+        if (knownTypeFormat) {
+            return knownTypeFormat;
+        }
+        if (runtimeType === String) {
+            return { type: 'string' };
+        }
+        if (runtimeType === Number) {
+            return { type: 'number' };
+        }
+        if (runtimeType === Boolean) {
+            return { type: 'boolean' };
+        }
+        if (runtimeType === Array) {
+            return { type: 'array', items: { type: 'object' } };
+        }
+        if (runtimeType && runtimeType !== Object) {
+            return this.generate(runtimeType);
+        }
+        return { type: 'object' };
+    }
+    static getKnownTypeFormat(runtimeType) {
+        if (!runtimeType) {
+            return undefined;
+        }
+        const known = this._knownTypeFormats.get(runtimeType);
+        if (!known) {
+            return undefined;
+        }
+        return {
+            type: known.type,
+            format: this.normalizeFormat(known.format)
+        };
+    }
+    static normalizeFormat(format) {
+        const normalized = format.toLowerCase();
+        return this._formatAliases.get(normalized) ?? normalized;
+    }
+}
+//# sourceMappingURL=JsonSchemaGenerator.js.map

package/dist/Schemas/JsonSchemaGenerator.js.map

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

package/dist/Schemas/index.d.ts

@@ -0,0 +1,4 @@
+export { JsonSchemaGenerator } from './JsonSchemaGenerator';
+export { jsonSchemaProperty, getTrackedJsonSchemaProperties } from './jsonSchemaProperty';
+export type { JsonSchema } from './JsonSchema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Schemas/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/Schemas/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { JsonSchemaGenerator } from './JsonSchemaGenerator';
+export { jsonSchemaProperty, getTrackedJsonSchemaProperties } from './jsonSchemaProperty';
+//# sourceMappingURL=index.js.map

package/dist/Schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Schemas/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/Schemas/jsonSchemaProperty.d.ts

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+/**
+ * Decorates a class property so its runtime type metadata can be used for JSON schema generation.
+ * @returns A property decorator.
+ */
+export declare function jsonSchemaProperty(): PropertyDecorator;
+/**
+ * Gets all tracked schema properties for a type.
+ * @param target - The class constructor to inspect.
+ * @returns The tracked property names.
+ */
+export declare function getTrackedJsonSchemaProperties(target: Function): string[];
+//# sourceMappingURL=jsonSchemaProperty.d.ts.map

package/dist/Schemas/jsonSchemaProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaProperty.d.ts","sourceRoot":"","sources":["../../Schemas/jsonSchemaProperty.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAItD;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAEzE"}

package/dist/Schemas/jsonSchemaProperty.js

@@ -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 'reflect-metadata';
+import { TypeIntrospector } from '../types';
+/**
+ * Decorates a class property so its runtime type metadata can be used for JSON schema generation.
+ * @returns A property decorator.
+ */
+export function jsonSchemaProperty() {
+    return (target, propertyKey) => {
+        TypeIntrospector.trackProperty(target.constructor, propertyKey.toString());
+    };
+}
+/**
+ * Gets all tracked schema properties for a type.
+ * @param target - The class constructor to inspect.
+ * @returns The tracked property names.
+ */
+export function getTrackedJsonSchemaProperties(target) {
+    return TypeIntrospector.getTrackedProperties(target);
+}
+//# sourceMappingURL=jsonSchemaProperty.js.map

package/dist/Schemas/jsonSchemaProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaProperty.js","sourceRoot":"","sources":["../../Schemas/jsonSchemaProperty.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,EAAE;QACpD,gBAAgB,CAAC,aAAa,CAAC,MAAM,CAAC,WAAuB,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAgB;IAC3D,OAAO,gBAAgB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC"}

package/dist/Tracing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The name of the Chronicle instrumentation library.
+ * Use this name to filter or configure Chronicle client spans in your observability backend.
+ */
+export declare const ChronicleInstrumentationName = "@cratis/chronicle";
+/**
+ * The OpenTelemetry tracer used by the Chronicle client for all instrumentation.
+ * This tracer is pre-configured with the Chronicle library name and is used to
+ * create spans around every client operation.
+ *
+ * If your application has configured an OpenTelemetry SDK (e.g. via {@link https://www.npmjs.com/package/@opentelemetry/sdk-node}),
+ * Chronicle spans will automatically flow through it.
+ * If no SDK is configured, the no-op tracer is used and no overhead is incurred.
+ */
+export declare const ChronicleTracer: import("@opentelemetry/api").Tracer;
+//# sourceMappingURL=Tracing.d.ts.map

package/dist/Tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracing.d.ts","sourceRoot":"","sources":["../Tracing.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,qCAAgD,CAAC"}

package/dist/Tracing.js

@@ -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 { trace } from '@opentelemetry/api';
+/**
+ * The name of the Chronicle instrumentation library.
+ * Use this name to filter or configure Chronicle client spans in your observability backend.
+ */
+export const ChronicleInstrumentationName = '@cratis/chronicle';
+/**
+ * The OpenTelemetry tracer used by the Chronicle client for all instrumentation.
+ * This tracer is pre-configured with the Chronicle library name and is used to
+ * create spans around every client operation.
+ *
+ * If your application has configured an OpenTelemetry SDK (e.g. via {@link https://www.npmjs.com/package/@opentelemetry/sdk-node}),
+ * Chronicle spans will automatically flow through it.
+ * If no SDK is configured, the no-op tracer is used and no overhead is incurred.
+ */
+export const ChronicleTracer = trace.getTracer(ChronicleInstrumentationName);
+//# sourceMappingURL=Tracing.js.map

package/dist/Tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracing.js","sourceRoot":"","sources":["../Tracing.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/artifacts/DefaultClientArtifactsProvider.d.ts

@@ -0,0 +1,31 @@
+import { Constructor } from '@cratis/fundamentals';
+import { IClientArtifactsProvider } from './IClientArtifactsProvider';
+import { TypeDiscoverer } from '../types/TypeDiscoverer';
+/**
+ * Represents the default provider for discovered client artifacts.
+ */
+export declare class DefaultClientArtifactsProvider implements IClientArtifactsProvider {
+    private readonly discoverer;
+    /** Singleton default provider using the shared {@link TypeDiscoverer}. */
+    static readonly default: DefaultClientArtifactsProvider;
+    /**
+     * Initializes a new instance of the {@link DefaultClientArtifactsProvider} class.
+     * @param discoverer - The discoverer instance that provides discovered types.
+     */
+    constructor(discoverer: TypeDiscoverer);
+    /** @inheritdoc */
+    get eventTypes(): Constructor[];
+    /** @inheritdoc */
+    get readModels(): Constructor[];
+    /** @inheritdoc */
+    get reactors(): Constructor[];
+    /** @inheritdoc */
+    get reducers(): Constructor[];
+    /** @inheritdoc */
+    get constraints(): Constructor[];
+    /** @inheritdoc */
+    get projections(): Constructor[];
+    /** @inheritdoc */
+    get modelBoundProjections(): Constructor[];
+}
+//# sourceMappingURL=DefaultClientArtifactsProvider.d.ts.map

package/dist/artifacts/DefaultClientArtifactsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultClientArtifactsProvider.d.ts","sourceRoot":"","sources":["../../artifacts/DefaultClientArtifactsProvider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;GAEG;AACH,qBAAa,8BAA+B,YAAW,wBAAwB;IAQ/D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAPvC,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,OAAO,iCAA8D;IAErF;;;OAGG;gBAC0B,UAAU,EAAE,cAAc;IAEvD,kBAAkB;IAClB,IAAI,UAAU,IAAI,WAAW,EAAE,CAE9B;IAED,kBAAkB;IAClB,IAAI,UAAU,IAAI,WAAW,EAAE,CAE9B;IAED,kBAAkB;IAClB,IAAI,QAAQ,IAAI,WAAW,EAAE,CAE5B;IAED,kBAAkB;IAClB,IAAI,QAAQ,IAAI,WAAW,EAAE,CAE5B;IAED,kBAAkB;IAClB,IAAI,WAAW,IAAI,WAAW,EAAE,CAE/B;IAED,kBAAkB;IAClB,IAAI,WAAW,IAAI,WAAW,EAAE,CAE/B;IAED,kBAAkB;IAClB,IAAI,qBAAqB,IAAI,WAAW,EAAE,CAEzC;CACJ"}

package/dist/artifacts/DefaultClientArtifactsProvider.js

@@ -0,0 +1,48 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { DecoratorType } from '../types/DecoratorType';
+import { TypeDiscoverer } from '../types/TypeDiscoverer';
+/**
+ * Represents the default provider for discovered client artifacts.
+ */
+export class DefaultClientArtifactsProvider {
+    discoverer;
+    /** Singleton default provider using the shared {@link TypeDiscoverer}. */
+    static default = new DefaultClientArtifactsProvider(TypeDiscoverer.default);
+    /**
+     * Initializes a new instance of the {@link DefaultClientArtifactsProvider} class.
+     * @param discoverer - The discoverer instance that provides discovered types.
+     */
+    constructor(discoverer) {
+        this.discoverer = discoverer;
+    }
+    /** @inheritdoc */
+    get eventTypes() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.EventType);
+    }
+    /** @inheritdoc */
+    get readModels() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.ReadModel);
+    }
+    /** @inheritdoc */
+    get reactors() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.Reactor);
+    }
+    /** @inheritdoc */
+    get reducers() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.Reducer);
+    }
+    /** @inheritdoc */
+    get constraints() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.Constraint);
+    }
+    /** @inheritdoc */
+    get projections() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.Projection);
+    }
+    /** @inheritdoc */
+    get modelBoundProjections() {
+        return this.discoverer.getTypesByDecoratorType(DecoratorType.ModelBoundProjection);
+    }
+}
+//# sourceMappingURL=DefaultClientArtifactsProvider.js.map

package/dist/artifacts/DefaultClientArtifactsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultClientArtifactsProvider.js","sourceRoot":"","sources":["../../artifacts/DefaultClientArtifactsProvider.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAIrG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;GAEG;AACH,MAAM,OAAO,8BAA8B;IAQV;IAP7B,0EAA0E;IAC1E,MAAM,CAAU,OAAO,GAAG,IAAI,8BAA8B,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAErF;;;OAGG;IACH,YAA6B,UAA0B;QAA1B,eAAU,GAAV,UAAU,CAAgB;IAAG,CAAC;IAE3D,kBAAkB;IAClB,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC;IAED,kBAAkB;IAClB,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC;IAED,kBAAkB;IAClB,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,kBAAkB;IAClB,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,kBAAkB;IAClB,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,kBAAkB;IAClB,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,kBAAkB;IAClB,IAAI,qBAAqB;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACvF,CAAC"}

package/dist/artifacts/IClientArtifactsProvider.d.ts

@@ -0,0 +1,21 @@
+import { Constructor } from '@cratis/fundamentals';
+/**
+ * Defines a provider capable of returning discovered client artifact types.
+ */
+export interface IClientArtifactsProvider {
+    /** Gets discovered event type constructors. */
+    readonly eventTypes: Constructor[];
+    /** Gets discovered read model constructors. */
+    readonly readModels: Constructor[];
+    /** Gets discovered reactor constructors. */
+    readonly reactors: Constructor[];
+    /** Gets discovered reducer constructors. */
+    readonly reducers: Constructor[];
+    /** Gets discovered constraint constructors. */
+    readonly constraints: Constructor[];
+    /** Gets discovered declarative projection constructors. */
+    readonly projections: Constructor[];
+    /** Gets discovered model-bound projection constructors. */
+    readonly modelBoundProjections: Constructor[];
+}
+//# sourceMappingURL=IClientArtifactsProvider.d.ts.map

package/dist/artifacts/IClientArtifactsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IClientArtifactsProvider.d.ts","sourceRoot":"","sources":["../../artifacts/IClientArtifactsProvider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC;IAEnC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC;IAEnC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEjC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEjC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,QAAQ,CAAC,qBAAqB,EAAE,WAAW,EAAE,CAAC;CACjD"}

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

package/dist/artifacts/IClientArtifactsProvider.js.map

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

package/dist/artifacts/index.d.ts

@@ -0,0 +1,3 @@
+export type { IClientArtifactsProvider } from './IClientArtifactsProvider';
+export { DefaultClientArtifactsProvider } from './DefaultClientArtifactsProvider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../artifacts/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/artifacts/index.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 { DefaultClientArtifactsProvider } from './DefaultClientArtifactsProvider';
+//# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../artifacts/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAGrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/connection/ChronicleConnection.d.ts

@@ -0,0 +1,117 @@
+import { type ChronicleConnectionOptions, type ChronicleServices } from '@cratis/chronicle.contracts';
+import type { ConnectionServiceClient } from '@cratis/chronicle.contracts';
+/**
+ * Wraps the contracts connection and allows recreating the underlying channel
+ * during reconnect while keeping a stable object reference for consumers.
+ */
+export declare class ChronicleConnection implements ChronicleServices {
+    private readonly _options;
+    private _inner;
+    private _authenticatedConnectionService?;
+    /**
+     * Creates a new {@link ChronicleConnection}.
+     * @param _options - Connection options used to create and recreate the underlying connection.
+     */
+    constructor(_options: ChronicleConnectionOptions);
+    /**
+     * Gets the connection string currently used by the inner connection.
+     */
+    get connectionString(): import("@cratis/chronicle.contracts").ChronicleConnectionString;
+    /**
+     * Gets whether the current inner connection is connected.
+     */
+    get isConnected(): boolean;
+    /**
+     * Event stores service.
+     */
+    get eventStores(): import("@cratis/chronicle.contracts").EventStoresClient<{}>;
+    /**
+     * Namespaces service.
+     */
+    get namespaces(): import("@cratis/chronicle.contracts").NamespacesClient<{}>;
+    /**
+     * Recommendations service.
+     */
+    get recommendations(): import("@cratis/chronicle.contracts").RecommendationsClient<{}>;
+    /**
+     * Identities service.
+     */
+    get identities(): import("@cratis/chronicle.contracts").IdentitiesClient<{}>;
+    /**
+     * Event sequences service.
+     */
+    get eventSequences(): import("@cratis/chronicle.contracts").EventSequencesClient<{}>;
+    /**
+     * Event types service.
+     */
+    get eventTypes(): import("@cratis/chronicle.contracts").EventTypesClient<{}>;
+    /**
+     * Constraints service.
+     */
+    get constraints(): import("@cratis/chronicle.contracts").ConstraintsClient<{}>;
+    /**
+     * Observers service.
+     */
+    get observers(): import("@cratis/chronicle.contracts").ObserversClient<{}>;
+    /**
+     * Failed partitions service.
+     */
+    get failedPartitions(): import("@cratis/chronicle.contracts").FailedPartitionsClient<{}>;
+    /**
+     * Reactors service.
+     */
+    get reactors(): import("@cratis/chronicle.contracts").ReactorsClient<{}>;
+    /**
+     * Reducers service.
+     */
+    get reducers(): import("@cratis/chronicle.contracts").ReducersClient<{}>;
+    /**
+     * Projections service.
+     */
+    get projections(): import("@cratis/chronicle.contracts").ProjectionsClient<{}>;
+    /**
+     * Read models service.
+     */
+    get readModels(): import("@cratis/chronicle.contracts").ReadModelsClient<{}>;
+    /**
+     * Jobs service.
+     */
+    get jobs(): import("@cratis/chronicle.contracts").JobsClient<{}>;
+    /**
+     * Event seeding service.
+     */
+    get eventSeeding(): import("@cratis/chronicle.contracts").EventSeedingClient<{}>;
+    /**
+     * Server service.
+     */
+    get server(): import("@cratis/chronicle.contracts").ServerClient<{}>;
+    /**
+     * Connection service — used to register this client with the kernel keep-alive mechanism.
+     * Uses an authenticated client (same auth middleware as all other services).
+     */
+    get connections(): ConnectionServiceClient;
+    /**
+     * Connects the current inner connection.
+     */
+    connect(): Promise<void>;
+    /**
+     * Recreates the inner connection (new gRPC channel) without calling connect().
+     * Use this before probing with a real RPC call to ensure a fresh IDLE channel.
+     */
+    resetChannel(): void;
+    /**
+     * Recreates and connects the inner connection.
+     */
+    reconnect(): Promise<void>;
+    /**
+     * Disconnects the current inner connection.
+     */
+    disconnect(): void;
+    /**
+     * Disposes the current inner connection.
+     */
+    dispose(): void;
+    private createInnerConnection;
+}
+export type { ChronicleConnectionOptions } from '@cratis/chronicle.contracts';
+//# sourceMappingURL=ChronicleConnection.d.ts.map

package/dist/connection/ChronicleConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChronicleConnection.d.ts","sourceRoot":"","sources":["../../connection/ChronicleConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAGN,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAG3E;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,iBAAiB;IAQhD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAPrC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,+BAA+B,CAAC,CAA0B;IAElE;;;OAGG;gBAC0B,QAAQ,EAAE,0BAA0B;IAIjE;;OAEG;IACH,IAAI,gBAAgB,oEAEnB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,WAAW,gEAEd;IAED;;OAEG;IACH,IAAI,UAAU,+DAEb;IAED;;OAEG;IACH,IAAI,eAAe,oEAElB;IAED;;OAEG;IACH,IAAI,UAAU,+DAEb;IAED;;OAEG;IACH,IAAI,cAAc,mEAEjB;IAED;;OAEG;IACH,IAAI,UAAU,+DAEb;IAED;;OAEG;IACH,IAAI,WAAW,gEAEd;IAED;;OAEG;IACH,IAAI,SAAS,8DAEZ;IAED;;OAEG;IACH,IAAI,gBAAgB,qEAEnB;IAED;;OAEG;IACH,IAAI,QAAQ,6DAEX;IAED;;OAEG;IACH,IAAI,QAAQ,6DAEX;IAED;;OAEG;IACH,IAAI,WAAW,gEAEd;IAED;;OAEG;IACH,IAAI,UAAU,+DAEb;IAED;;OAEG;IACH,IAAI,IAAI,yDAEP;IAED;;OAEG;IACH,IAAI,YAAY,iEAEf;IAED;;OAEG;IACH,IAAI,MAAM,2DAET;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,uBAAuB,CAWzC;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACH,YAAY,IAAI,IAAI;IAUpB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,qBAAqB;CAG7B;AAED,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC"}