@cratis/chronicle 0.0.1

package/dist/types/TypeDiscoverer.js

@@ -0,0 +1,91 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import path from 'path';
+/**
+ * Encapsulates discovery and registry operations for decorator-based artifacts.
+ */
+export class TypeDiscoverer {
+    /** Shared default discoverer instance. */
+    static default = new TypeDiscoverer();
+    static _registeredTypes = new Map();
+    _glob;
+    _importFile;
+    /**
+     * Initializes a new instance of the {@link TypeDiscoverer} class.
+     * @param glob - Optional glob function used to resolve file paths.
+     * @param importFile - Optional importer used to load discovered files.
+     */
+    constructor(glob, importFile) {
+        this._glob = glob ?? TypeDiscoverer.resolveWithGlobPackage;
+        this._importFile = importFile ?? TypeDiscoverer.importDiscoveredFile;
+    }
+    /**
+     * Discovers and imports all files matching one or more glob patterns.
+     * @param pattern - One or more file glob patterns.
+     */
+    async discover(pattern) {
+        const patterns = Array.isArray(pattern) ? pattern : [pattern];
+        const files = await this._glob(patterns);
+        for (const file of files) {
+            await this._importFile(path.resolve(file));
+        }
+    }
+    /**
+     * Registers a discoverable type for a decorator category.
+     * @param decoratorType - The decorator category to register for.
+     * @param type - The type constructor to register.
+     * @param name - Optional explicit discovery name for the type.
+     */
+    register(decoratorType, type, name) {
+        const discoveredName = name ?? type.name;
+        const typesForDecorator = TypeDiscoverer._registeredTypes.get(decoratorType) ?? new Map();
+        typesForDecorator.set(discoveredName, type);
+        TypeDiscoverer._registeredTypes.set(decoratorType, typesForDecorator);
+    }
+    /**
+     * Gets all registered types for a decorator category.
+     * @param decoratorType - The decorator category to retrieve types for.
+     * @returns The registered types.
+     */
+    getTypesByDecoratorType(decoratorType) {
+        return Array.from((TypeDiscoverer._registeredTypes.get(decoratorType) ?? new Map()).values());
+    }
+    /**
+     * Gets a registered type by decorator category and name.
+     * @param decoratorType - The decorator category to resolve.
+     * @param name - The registered name of the type.
+     * @returns The matching type, if any.
+     */
+    getTypeByDecoratorTypeAndName(decoratorType, name) {
+        return TypeDiscoverer._registeredTypes.get(decoratorType)?.get(name);
+    }
+    /**
+     * Clears all registered types.
+     * Primarily intended for test isolation.
+     */
+    clear() {
+        TypeDiscoverer._registeredTypes.clear();
+    }
+    static async resolveWithGlobPackage(pattern) {
+        let globFunction;
+        try {
+            const globModule = await import('glob');
+            globFunction = globModule.glob;
+        }
+        catch {
+            throw new Error('Could not load a compatible "glob" function for type discovery.');
+        }
+        if (typeof globFunction !== 'function') {
+            throw new Error('The "glob" module was loaded but does not export a function named "glob".');
+        }
+        const files = await globFunction(pattern);
+        if (!Array.isArray(files) || files.some(file => typeof file !== 'string')) {
+            throw new Error('Type discovery glob resolution did not return an array of file paths.');
+        }
+        return files;
+    }
+    static async importDiscoveredFile(filePath) {
+        return await import(filePath);
+    }
+}
+//# sourceMappingURL=TypeDiscoverer.js.map

package/dist/types/TypeDiscoverer.js.map

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

package/dist/types/TypeIntrospector.d.ts

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+/**
+ * Provides reflection-based type introspection utilities for decorated Chronicle artifacts.
+ */
+export declare class TypeIntrospector {
+    /**
+     * Tracks a property name on a type so it can be included in reflection-based introspection.
+     * @param target - The class constructor to track the property for.
+     * @param propertyName - The property name to track.
+     */
+    static trackProperty(target: Function, propertyName: string): void;
+    /**
+     * Gets all tracked properties for a type.
+     * @param target - The class constructor to inspect.
+     * @returns The tracked property names.
+     */
+    static getTrackedProperties(target: Function): string[];
+    /**
+     * Gets members and their runtime types for a class.
+     * Members are discovered from tracked properties and constructor parameters.
+     * @param target - The class constructor to inspect.
+     * @returns A map of member name to runtime type.
+     */
+    static getMembers(target: Function): Map<string, Function | undefined>;
+    private static tryGetDefaultPropertyValues;
+    private static getRuntimeTypeFromValue;
+    private static getConstructorParameterNames;
+    private static extractParameterName;
+}
+//# sourceMappingURL=TypeIntrospector.d.ts.map

package/dist/types/TypeIntrospector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeIntrospector.d.ts","sourceRoot":"","sources":["../../types/TypeIntrospector.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAK1B;;GAEG;AACH,qBAAa,gBAAgB;IACzB;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IASlE;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE;IAIvD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IA4BtE,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAc1C,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA2BtC,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAmD3C,OAAO,CAAC,MAAM,CAAC,oBAAoB;CActC"}

package/dist/types/TypeIntrospector.js

@@ -0,0 +1,154 @@
+// 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';
+/** Metadata key for tracked schema properties on a target type. */
+const TRACKED_PROPERTIES_METADATA_KEY = 'chronicle:typeIntrospection:properties';
+/**
+ * Provides reflection-based type introspection utilities for decorated Chronicle artifacts.
+ */
+export class TypeIntrospector {
+    /**
+     * Tracks a property name on a type so it can be included in reflection-based introspection.
+     * @param target - The class constructor to track the property for.
+     * @param propertyName - The property name to track.
+     */
+    static trackProperty(target, propertyName) {
+        const trackedProperties = this.getTrackedProperties(target);
+        if (trackedProperties.includes(propertyName)) {
+            return;
+        }
+        Reflect.defineMetadata(TRACKED_PROPERTIES_METADATA_KEY, [...trackedProperties, propertyName], target);
+    }
+    /**
+     * Gets all tracked properties for a type.
+     * @param target - The class constructor to inspect.
+     * @returns The tracked property names.
+     */
+    static getTrackedProperties(target) {
+        return Reflect.getMetadata(TRACKED_PROPERTIES_METADATA_KEY, target) ?? [];
+    }
+    /**
+     * Gets members and their runtime types for a class.
+     * Members are discovered from tracked properties and constructor parameters.
+     * @param target - The class constructor to inspect.
+     * @returns A map of member name to runtime type.
+     */
+    static getMembers(target) {
+        const members = new Map();
+        const defaultValues = this.tryGetDefaultPropertyValues(target);
+        for (const property of this.getTrackedProperties(target)) {
+            let runtimeType = Reflect.getMetadata('design:type', target.prototype, property);
+            if (!runtimeType || runtimeType === Object) {
+                runtimeType = this.getRuntimeTypeFromValue(defaultValues[property]);
+            }
+            members.set(property, runtimeType);
+        }
+        const constructorParameterNames = this.getConstructorParameterNames(target);
+        const constructorParameterTypes = Reflect.getMetadata('design:paramtypes', target) ?? [];
+        for (let index = 0; index < constructorParameterNames.length; index++) {
+            const parameterName = constructorParameterNames[index];
+            if (members.has(parameterName)) {
+                continue;
+            }
+            members.set(parameterName, constructorParameterTypes[index]);
+        }
+        return members;
+    }
+    static tryGetDefaultPropertyValues(target) {
+        try {
+            const parameters = Array.from({ length: target.length }, () => undefined);
+            const instance = Reflect.construct(target, parameters);
+            if (!instance || typeof instance !== 'object') {
+                return {};
+            }
+            return instance;
+        }
+        catch {
+            return {};
+        }
+    }
+    static getRuntimeTypeFromValue(value) {
+        if (typeof value === 'string') {
+            return String;
+        }
+        if (typeof value === 'number') {
+            return Number;
+        }
+        if (typeof value === 'boolean') {
+            return Boolean;
+        }
+        if (Array.isArray(value)) {
+            return Array;
+        }
+        if (value && typeof value === 'object') {
+            const constructor = value.constructor;
+            if (constructor && constructor !== Object) {
+                return constructor;
+            }
+        }
+        return undefined;
+    }
+    static getConstructorParameterNames(target) {
+        const source = target.toString();
+        const constructorKeyword = 'constructor(';
+        const constructorStart = source.indexOf(constructorKeyword);
+        if (constructorStart < 0) {
+            return [];
+        }
+        let index = constructorStart + constructorKeyword.length;
+        let depth = 1;
+        let parameterSegment = '';
+        while (index < source.length && depth > 0) {
+            const character = source[index];
+            if (character === '(') {
+                depth++;
+                parameterSegment += character;
+            }
+            else if (character === ')') {
+                depth--;
+                if (depth > 0) {
+                    parameterSegment += character;
+                }
+            }
+            else {
+                parameterSegment += character;
+            }
+            index++;
+        }
+        const names = [];
+        let current = '';
+        for (const character of parameterSegment) {
+            if (character === ',') {
+                const candidate = current.trim();
+                if (candidate.length > 0) {
+                    names.push(candidate);
+                }
+                current = '';
+            }
+            else {
+                current += character;
+            }
+        }
+        const lastCandidate = current.trim();
+        if (lastCandidate.length > 0) {
+            names.push(lastCandidate);
+        }
+        return names
+            .map(name => this.extractParameterName(name))
+            .filter(name => name.length > 0);
+    }
+    static extractParameterName(rawParameter) {
+        if (/[{}\[\]]/.test(rawParameter)) {
+            return '';
+        }
+        const withoutRest = rawParameter.startsWith('...') ? rawParameter.substring(3) : rawParameter;
+        const equalsIndex = withoutRest.indexOf('=');
+        const withoutDefaultValue = equalsIndex >= 0 ? withoutRest.substring(0, equalsIndex) : withoutRest;
+        const colonIndex = withoutDefaultValue.indexOf(':');
+        const withoutTypeAnnotation = colonIndex >= 0
+            ? withoutDefaultValue.substring(0, colonIndex)
+            : withoutDefaultValue;
+        return withoutTypeAnnotation.trim();
+    }
+}
+//# sourceMappingURL=TypeIntrospector.js.map

package/dist/types/TypeIntrospector.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { DecoratorType } from './DecoratorType';
+export { TypeDiscoverer } from './TypeDiscoverer';
+export { TypeIntrospector } from './TypeIntrospector';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

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

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/index.ts

@@ -0,0 +1,24 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export { ChronicleClient } from './ChronicleClient';
+export type { IChronicleClient } from './IChronicleClient';
+export { ChronicleOptions } from './ChronicleOptions';
+export { EventStore } from './EventStore';
+export type { IEventStore } from './IEventStore';
+export { EventStoreName } from './EventStoreName';
+export { EventStoreNamespaceName } from './EventStoreNamespaceName';
+export { Guid } from '@cratis/fundamentals';
+export { ChronicleInstrumentationName, ChronicleTracer } from './Tracing';
+export { ChronicleMeter, ChronicleMeterName, ChronicleMetrics } from './Metrics';
+
+export * from './Events';
+export * from './EventSequences';
+export * from './Reactors';
+export * from './Reducers';
+export * from './ReadModels';
+export * from './Projections';
+export * from './Observation';
+export * from './Schemas';
+export * from './types';
+export * from './artifacts';

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@cratis/chronicle",
+    "version": "0.0.1",
+    "description": "TypeScript idiomatic client for Cratis Chronicle",
+    "author": "Cratis",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Cratis/Chronicle.TypeScript.git"
+    },
+    "files": [
+        "dist",
+        "**/*.ts"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": false
+    },
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "compile": "tsc -b",
+        "build": "tsc -b",
+        "clean": "rm -rf dist"
+    },
+    "dependencies": {
+        "@bufbuild/protobuf": "^2.12.0",
+        "@cratis/chronicle.contracts": "^15.25.2",
+        "@cratis/fundamentals": "^7.9.0",
+        "@opentelemetry/api": "^1.9.1",
+        "reflect-metadata": "^0.2.2"
+    },
+    "devDependencies": {
+        "@types/node": "^25.6.1",
+        "typescript": "^6.0.3"
+    }
+}

package/types/DecoratorType.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Represents the supported decorator categories for discoverable artifact types.
+ */
+export enum DecoratorType {
+    /** Event type artifacts discovered through the eventType decorator. */
+    EventType = 'eventType',
+
+    /** Read model artifacts discovered through the readModel decorator. */
+    ReadModel = 'readModel',
+
+    /** Reactor artifacts discovered through the reactor decorator. */
+    Reactor = 'reactor',
+
+    /** Reducer artifacts discovered through the reducer decorator. */
+    Reducer = 'reducer',
+
+    /** Constraint artifacts discovered through the constraint decorator. */
+    Constraint = 'constraint',
+
+    /** Declarative projection artifacts discovered through the projection decorator. */
+    Projection = 'projection',
+
+    /** Model-bound projection artifacts discovered through the modelBound decorator. */
+    ModelBoundProjection = 'modelBoundProjection'
+}

package/types/TypeDiscoverer.ts

@@ -0,0 +1,109 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import path from 'path';
+import { DecoratorType } from './DecoratorType';
+import { Constructor } from '@cratis/fundamentals';
+
+type GlobFunction = (pattern: string | string[]) => Promise<string[]>;
+type FileImporter = (filePath: string) => Promise<unknown>;
+
+/**
+ * Encapsulates discovery and registry operations for decorator-based artifacts.
+ */
+export class TypeDiscoverer {
+    /** Shared default discoverer instance. */
+    static readonly default = new TypeDiscoverer();
+
+    private static readonly _registeredTypes: Map<DecoratorType, Map<string, Constructor>> = new Map();
+
+    private readonly _glob: GlobFunction;
+    private readonly _importFile: FileImporter;
+
+    /**
+     * Initializes a new instance of the {@link TypeDiscoverer} class.
+     * @param glob - Optional glob function used to resolve file paths.
+     * @param importFile - Optional importer used to load discovered files.
+     */
+    constructor(glob?: GlobFunction, importFile?: FileImporter) {
+        this._glob = glob ?? TypeDiscoverer.resolveWithGlobPackage;
+        this._importFile = importFile ?? TypeDiscoverer.importDiscoveredFile;
+    }
+
+    /**
+     * Discovers and imports all files matching one or more glob patterns.
+     * @param pattern - One or more file glob patterns.
+     */
+    async discover(pattern: string | string[]): Promise<void> {
+        const patterns = Array.isArray(pattern) ? pattern : [pattern];
+        const files = await this._glob(patterns);
+        for (const file of files) {
+            await this._importFile(path.resolve(file));
+        }
+    }
+
+    /**
+     * Registers a discoverable type for a decorator category.
+     * @param decoratorType - The decorator category to register for.
+     * @param type - The type constructor to register.
+     * @param name - Optional explicit discovery name for the type.
+     */
+    register(decoratorType: DecoratorType, type: Constructor, name?: string): void {
+        const discoveredName = name ?? type.name;
+        const typesForDecorator = TypeDiscoverer._registeredTypes.get(decoratorType) ?? new Map<string, Constructor>();
+        typesForDecorator.set(discoveredName, type);
+        TypeDiscoverer._registeredTypes.set(decoratorType, typesForDecorator);
+    }
+
+    /**
+     * Gets all registered types for a decorator category.
+     * @param decoratorType - The decorator category to retrieve types for.
+     * @returns The registered types.
+     */
+    getTypesByDecoratorType(decoratorType: DecoratorType): Constructor[] {
+        return Array.from((TypeDiscoverer._registeredTypes.get(decoratorType) ?? new Map()).values());
+    }
+
+    /**
+     * Gets a registered type by decorator category and name.
+     * @param decoratorType - The decorator category to resolve.
+     * @param name - The registered name of the type.
+     * @returns The matching type, if any.
+     */
+    getTypeByDecoratorTypeAndName(decoratorType: DecoratorType, name: string): Constructor | undefined {
+        return TypeDiscoverer._registeredTypes.get(decoratorType)?.get(name);
+    }
+
+    /**
+     * Clears all registered types.
+     * Primarily intended for test isolation.
+     */
+    clear(): void {
+        TypeDiscoverer._registeredTypes.clear();
+    }
+
+    private static async resolveWithGlobPackage(pattern: string | string[]): Promise<string[]> {
+        let globFunction: unknown;
+        try {
+            const globModule = await import('glob') as { glob?: unknown };
+            globFunction = globModule.glob;
+        } catch {
+            throw new Error('Could not load a compatible "glob" function for type discovery.');
+        }
+
+        if (typeof globFunction !== 'function') {
+            throw new Error('The "glob" module was loaded but does not export a function named "glob".');
+        }
+
+        const files = await globFunction(pattern);
+        if (!Array.isArray(files) || files.some(file => typeof file !== 'string')) {
+            throw new Error('Type discovery glob resolution did not return an array of file paths.');
+        }
+
+        return files;
+    }
+
+    private static async importDiscoveredFile(filePath: string): Promise<unknown> {
+        return await import(filePath);
+    }
+}