@cratis/chronicle 6.3.1 → 6.4.0

package/projections/modelBound/fromEvent.ts

@@ -2,8 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { FromEventMetadata } from './FromEventMetadata';
-import { FromEventOptions } from './FromEventOptions';
+import { FromEventMetadata } from './FromEventMetadata.js';
+import { FromEventOptions } from './FromEventOptions.js';
 
 const METADATA_KEY = 'chronicle:projection:fromEvent';
 

package/projections/modelBound/fromEvery.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the fromEvery property decorator. */
 export interface FromEveryMetadata {
@@ -20,12 +21,12 @@ const METADATA_KEY = 'chronicle:projection:fromEvery';
  * @param contextProperty - Optional event context property name.
  * @returns A property decorator.
  */
-export function fromEvery(property?: string, contextProperty?: string): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+export function fromEvery(property?: string, contextProperty?: string): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, propertyKey.toString());
         const metadata: FromEveryMetadata = { property, contextProperty };
         Reflect.defineMetadata(METADATA_KEY, metadata, target, propertyKey.toString());
-    };
+    });
 }
 
 /**
@@ -35,5 +36,5 @@ export function fromEvery(property?: string, contextProperty?: string): Property
  * @returns The fromEvery metadata, or undefined if not decorated.
  */
 export function getFromEveryMetadata(target: object, propertyKey: string): FromEveryMetadata | undefined {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey);
+    return getPropertyMetadata<FromEveryMetadata>(METADATA_KEY, target, propertyKey);
 }

package/projections/modelBound/globalFor.ts

@@ -3,7 +3,7 @@
 
 import 'reflect-metadata';
 import { Constructor } from '@cratis/fundamentals';
-import { DecoratorType, TypeDiscoverer } from '../../types';
+import { DecoratorType, TypeDiscoverer } from '../../types/index.js';
 
 /** Metadata stored by the globalFor class decorator. */
 export interface GlobalForMetadata {

package/projections/modelBound/increment.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the increment property decorator. */
 export interface IncrementMetadata {
@@ -20,14 +21,14 @@ const METADATA_KEY = 'chronicle:projection:increment';
  * @param constantKey - Optional constant key value.
  * @returns A property decorator.
  */
-export function increment(eventType: Function, constantKey?: string): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+export function increment(eventType: Function, constantKey?: string): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
         const existing: IncrementMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
         const metadata: IncrementMetadata = { eventType, constantKey };
         Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
-    };
+    });
 }
 
 /**
@@ -37,5 +38,5 @@ export function increment(eventType: Function, constantKey?: string): PropertyDe
  * @returns An array of increment metadata entries.
  */
 export function getIncrementMetadata(target: object, propertyKey: string): IncrementMetadata[] {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<IncrementMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/index.ts

@@ -1,47 +1,47 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-export { fromEvent, getFromEventMetadata, hasFromEventMetadata } from './fromEvent';
-export type { FromEventOptions } from './FromEventOptions';
-export type { FromEventMetadata } from './FromEventMetadata';
-export { setFrom, getSetFromMetadata } from './setFrom';
-export type { SetFromMetadata } from './setFrom';
-export { setFromContext, getSetFromContextMetadata } from './setFromContext';
-export type { SetFromContextMetadata } from './setFromContext';
-export { join, getJoinMetadata } from './join';
-export type { JoinMetadata } from './join';
-export { addFrom, getAddFromMetadata } from './addFrom';
-export type { AddFromMetadata } from './addFrom';
-export { subtractFrom, getSubtractFromMetadata } from './subtractFrom';
-export type { SubtractFromMetadata } from './subtractFrom';
-export { increment, getIncrementMetadata } from './increment';
-export type { IncrementMetadata } from './increment';
-export { decrement, getDecrementMetadata } from './decrement';
-export type { DecrementMetadata } from './decrement';
-export { count, getCountMetadata } from './count';
-export type { CountMetadata } from './count';
-export { childrenFrom, getChildrenFromMetadata } from './childrenFrom';
-export type { ChildrenFromMetadata } from './childrenFrom';
-export { nested, isNested } from './nested';
-export { clearWith, getClearWithClassMetadata, getClearWithPropertyMetadata } from './clearWith';
-export type { ClearWithMetadata } from './clearWith';
-export { removedWith, getRemovedWithClassMetadata, getRemovedWithPropertyMetadata } from './removedWith';
-export type { RemovedWithMetadata } from './removedWith';
-export { removedWithJoin, getRemovedWithJoinClassMetadata, getRemovedWithJoinPropertyMetadata } from './removedWithJoin';
-export type { RemovedWithJoinMetadata } from './removedWithJoin';
-export { notRewindable, isNotRewindable } from './notRewindable';
-export { passive, isPassive } from './passive';
-export { setValue, getSetValueMetadata } from './setValue';
-export type { SetValueMetadata } from './setValue';
-export { fromEvery, getFromEveryMetadata } from './fromEvery';
-export type { FromEveryMetadata } from './fromEvery';
-export { fromAll, getFromAllMetadata } from './fromAll';
-export type { FromAllMetadata } from './fromAll';
-export { noAutoMap, isNoAutoMap, isPropertyNoAutoMap } from './noAutoMap';
-export { eventSequence, eventLog, getEventSequenceMetadata } from './eventSequence';
-export { variantOf, getVariantOfMetadata } from './variantOf';
-export type { VariantOfMetadata } from './variantOf';
-export { entersOn, getEntersOnMetadata } from './entersOn';
-export type { EntersOnMetadata } from './entersOn';
-export { globalFor, getGlobalForMetadata } from './globalFor';
-export type { GlobalForMetadata } from './globalFor';
+export { fromEvent, getFromEventMetadata, hasFromEventMetadata } from './fromEvent.js';
+export type { FromEventOptions } from './FromEventOptions.js';
+export type { FromEventMetadata } from './FromEventMetadata.js';
+export { setFrom, getSetFromMetadata } from './setFrom.js';
+export type { SetFromMetadata } from './setFrom.js';
+export { setFromContext, getSetFromContextMetadata } from './setFromContext.js';
+export type { SetFromContextMetadata } from './setFromContext.js';
+export { join, getJoinMetadata } from './join.js';
+export type { JoinMetadata } from './join.js';
+export { addFrom, getAddFromMetadata } from './addFrom.js';
+export type { AddFromMetadata } from './addFrom.js';
+export { subtractFrom, getSubtractFromMetadata } from './subtractFrom.js';
+export type { SubtractFromMetadata } from './subtractFrom.js';
+export { increment, getIncrementMetadata } from './increment.js';
+export type { IncrementMetadata } from './increment.js';
+export { decrement, getDecrementMetadata } from './decrement.js';
+export type { DecrementMetadata } from './decrement.js';
+export { count, getCountMetadata } from './count.js';
+export type { CountMetadata } from './count.js';
+export { childrenFrom, getChildrenFromMetadata } from './childrenFrom.js';
+export type { ChildrenFromMetadata } from './childrenFrom.js';
+export { nested, isNested } from './nested.js';
+export { clearWith, getClearWithClassMetadata, getClearWithPropertyMetadata } from './clearWith.js';
+export type { ClearWithMetadata } from './clearWith.js';
+export { removedWith, getRemovedWithClassMetadata, getRemovedWithPropertyMetadata } from './removedWith.js';
+export type { RemovedWithMetadata } from './removedWith.js';
+export { removedWithJoin, getRemovedWithJoinClassMetadata, getRemovedWithJoinPropertyMetadata } from './removedWithJoin.js';
+export type { RemovedWithJoinMetadata } from './removedWithJoin.js';
+export { notRewindable, isNotRewindable } from './notRewindable.js';
+export { passive, isPassive } from './passive.js';
+export { setValue, getSetValueMetadata } from './setValue.js';
+export type { SetValueMetadata } from './setValue.js';
+export { fromEvery, getFromEveryMetadata } from './fromEvery.js';
+export type { FromEveryMetadata } from './fromEvery.js';
+export { fromAll, getFromAllMetadata } from './fromAll.js';
+export type { FromAllMetadata } from './fromAll.js';
+export { noAutoMap, isNoAutoMap, isPropertyNoAutoMap } from './noAutoMap.js';
+export { eventSequence, eventLog, getEventSequenceMetadata } from './eventSequence.js';
+export { variantOf, getVariantOfMetadata } from './variantOf.js';
+export type { VariantOfMetadata } from './variantOf.js';
+export { entersOn, getEntersOnMetadata } from './entersOn.js';
+export type { EntersOnMetadata } from './entersOn.js';
+export { globalFor, getGlobalForMetadata } from './globalFor.js';
+export type { GlobalForMetadata } from './globalFor.js';

package/projections/modelBound/join.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the join property decorator. */
 export interface JoinMetadata {
@@ -23,14 +24,14 @@ const METADATA_KEY = 'chronicle:projection:join';
  * @param eventPropertyName - Optional event property name. Defaults to the property name.
  * @returns A property decorator.
  */
-export function join(eventType: Function, on?: string, eventPropertyName?: string): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+export function join(eventType: Function, on?: string, eventPropertyName?: string): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
         const existing: JoinMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
         const metadata: JoinMetadata = { eventType, on, eventPropertyName };
         Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
-    };
+    });
 }
 
 /**
@@ -40,5 +41,5 @@ export function join(eventType: Function, on?: string, eventPropertyName?: strin
  * @returns An array of join metadata entries.
  */
 export function getJoinMetadata(target: object, propertyKey: string): JoinMetadata[] {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<JoinMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/nested.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { decorateProperty, hasPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 const METADATA_KEY = 'chronicle:projection:nested';
 
@@ -12,10 +13,16 @@ const METADATA_KEY = 'chronicle:projection:nested';
  * @param target - The class prototype.
  * @param propertyKey - The property name.
  */
-export function nested(target: object, propertyKey: string | symbol): void {
+const decorateNested = decorateProperty((target: object, propertyKey: string | symbol): void => {
     const key = propertyKey.toString();
     TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
     Reflect.defineMetadata(METADATA_KEY, true, target, key);
+});
+
+export function nested(target: object, propertyKey: string | symbol): void;
+export function nested(value: undefined, context: ClassFieldDecoratorContext): void;
+export function nested(target: object | undefined, propertyKeyOrContext: string | symbol | ClassFieldDecoratorContext): void {
+    decorateNested(target as undefined, propertyKeyOrContext as ClassFieldDecoratorContext);
 }
 
 /**
@@ -25,5 +32,5 @@ export function nested(target: object, propertyKey: string | symbol): void {
  * @returns True if the property is marked as nested; false otherwise.
  */
 export function isNested(target: object, propertyKey: string): boolean {
-    return Reflect.hasMetadata(METADATA_KEY, target, propertyKey);
+    return hasPropertyMetadata(METADATA_KEY, target, propertyKey);
 }

package/projections/modelBound/noAutoMap.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { decorateClassOrProperty, hasPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 const CLASS_METADATA_KEY = 'chronicle:projection:noAutoMap:class';
 const PROPERTY_METADATA_KEY = 'chronicle:projection:noAutoMap:property';
@@ -17,7 +18,7 @@ const PROPERTY_METADATA_KEY = 'chronicle:projection:noAutoMap:property';
  * @param target - The class constructor, or the class prototype when used on a property.
  * @param propertyKey - The property name, when used as a property decorator.
  */
-export function noAutoMap(target: object, propertyKey?: string | symbol): void {
+const decorateNoAutoMap = decorateClassOrProperty((target: object, propertyKey?: string | symbol): void => {
     if (propertyKey !== undefined) {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
@@ -25,6 +26,14 @@ export function noAutoMap(target: object, propertyKey?: string | symbol): void {
     } else {
         Reflect.defineMetadata(CLASS_METADATA_KEY, true, target as Function);
     }
+});
+
+export function noAutoMap(target: Function): void;
+export function noAutoMap(target: object, propertyKey: string | symbol): void;
+export function noAutoMap(value: Function, context: ClassDecoratorContext): void;
+export function noAutoMap(value: undefined, context: ClassFieldDecoratorContext): void;
+export function noAutoMap(target: object | undefined, propertyKeyOrContext?: string | symbol | ClassDecoratorContext | ClassFieldDecoratorContext): void {
+    decorateNoAutoMap(target as Function, propertyKeyOrContext as ClassDecoratorContext);
 }
 
 /**
@@ -43,5 +52,5 @@ export function isNoAutoMap(target: Function): boolean {
  * @returns True if the property is marked with {@link noAutoMap}; false otherwise.
  */
 export function isPropertyNoAutoMap(target: object, propertyKey: string): boolean {
-    return Reflect.hasMetadata(PROPERTY_METADATA_KEY, target, propertyKey);
+    return hasPropertyMetadata(PROPERTY_METADATA_KEY, target, propertyKey);
 }

package/projections/modelBound/removedWith.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChronicleClassOrPropertyDecorator, decorateClassOrProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the removedWith class or property decorator. */
 export interface RemovedWithMetadata {
@@ -26,8 +27,8 @@ const PROPERTY_METADATA_KEY = 'chronicle:projection:removedWith:property';
  * @param parentKey - Optional event property name used as the parent key (for children only).
  * @returns A class and property decorator.
  */
-export function removedWith(eventType: Function, key?: string, parentKey?: string): ClassDecorator & PropertyDecorator {
-    return (target: object, propertyKey?: string | symbol) => {
+export function removedWith(eventType: Function, key?: string, parentKey?: string): ChronicleClassOrPropertyDecorator {
+    return decorateClassOrProperty((target: object, propertyKey?: string | symbol) => {
         if (propertyKey !== undefined) {
             const propKey = propertyKey.toString();
             TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, propKey);
@@ -37,7 +38,7 @@ export function removedWith(eventType: Function, key?: string, parentKey?: strin
             const existing: RemovedWithMetadata[] = Reflect.getMetadata(CLASS_METADATA_KEY, target) ?? [];
             Reflect.defineMetadata(CLASS_METADATA_KEY, [...existing, { eventType, key, parentKey }], target);
         }
-    };
+    });
 }
 
 /**
@@ -56,5 +57,5 @@ export function getRemovedWithClassMetadata(target: Function): RemovedWithMetada
  * @returns An array of removedWith metadata entries.
  */
 export function getRemovedWithPropertyMetadata(target: object, propertyKey: string): RemovedWithMetadata[] {
-    return Reflect.getMetadata(PROPERTY_METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<RemovedWithMetadata[]>(PROPERTY_METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/removedWithJoin.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChronicleClassOrPropertyDecorator, decorateClassOrProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the removedWithJoin class or property decorator. */
 export interface RemovedWithJoinMetadata {
@@ -21,8 +22,8 @@ const PROPERTY_METADATA_KEY = 'chronicle:projection:removedWithJoin:property';
  * @param key - Optional event property name used as the key to identify the instance to remove.
  * @returns A class and property decorator.
  */
-export function removedWithJoin(eventType: Function, key?: string): ClassDecorator & PropertyDecorator {
-    return (target: object, propertyKey?: string | symbol) => {
+export function removedWithJoin(eventType: Function, key?: string): ChronicleClassOrPropertyDecorator {
+    return decorateClassOrProperty((target: object, propertyKey?: string | symbol) => {
         if (propertyKey !== undefined) {
             const propKey = propertyKey.toString();
             TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, propKey);
@@ -32,7 +33,7 @@ export function removedWithJoin(eventType: Function, key?: string): ClassDecorat
             const existing: RemovedWithJoinMetadata[] = Reflect.getMetadata(CLASS_METADATA_KEY, target) ?? [];
             Reflect.defineMetadata(CLASS_METADATA_KEY, [...existing, { eventType, key }], target);
         }
-    };
+    });
 }
 
 /**
@@ -51,5 +52,5 @@ export function getRemovedWithJoinClassMetadata(target: Function): RemovedWithJo
  * @returns An array of removedWithJoin metadata entries.
  */
 export function getRemovedWithJoinPropertyMetadata(target: object, propertyKey: string): RemovedWithJoinMetadata[] {
-    return Reflect.getMetadata(PROPERTY_METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<RemovedWithJoinMetadata[]>(PROPERTY_METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/setFrom.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the setFrom property decorator. */
 export interface SetFromMetadata {
@@ -20,14 +21,14 @@ const METADATA_KEY = 'chronicle:projection:setFrom';
  * @param eventPropertyName - Optional event property name. Defaults to the property name.
  * @returns A property decorator.
  */
-export function setFrom(eventType: Function, eventPropertyName?: string): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+export function setFrom(eventType: Function, eventPropertyName?: string): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
         const existing: SetFromMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
         const metadata: SetFromMetadata = { eventType, eventPropertyName };
         Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
-    };
+    });
 }
 
 /**
@@ -37,5 +38,5 @@ export function setFrom(eventType: Function, eventPropertyName?: string): Proper
  * @returns An array of setFrom metadata entries.
  */
 export function getSetFromMetadata(target: object, propertyKey: string): SetFromMetadata[] {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<SetFromMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/setFromContext.ts

@@ -3,8 +3,9 @@
 
 import 'reflect-metadata';
 import { PropertyAccessor, PropertyPathResolverProxyHandler } from '@cratis/fundamentals';
-import type { EventContext } from '../../events';
-import { TypeIntrospector } from '../../types';
+import type { EventContext } from '../../events/index.js';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the setFromContext property decorator. */
 export interface SetFromContextMetadata {
@@ -22,13 +23,13 @@ const METADATA_KEY = 'chronicle:projection:setFromContext';
  * @param contextPropertyOrAccessor - Optional event context property name or property accessor. Defaults to the property name.
  * @returns A property decorator.
  */
-export function setFromContext(eventType: Function, contextPropertyName?: string): PropertyDecorator;
-export function setFromContext(eventType: Function, contextPropertyAccessor?: PropertyAccessor<EventContext>): PropertyDecorator;
+export function setFromContext(eventType: Function, contextPropertyName?: string): ChroniclePropertyDecorator;
+export function setFromContext(eventType: Function, contextPropertyAccessor?: PropertyAccessor<EventContext>): ChroniclePropertyDecorator;
 export function setFromContext(
     eventType: Function,
     contextPropertyOrAccessor?: string | PropertyAccessor<EventContext>
-): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
         const existing: SetFromContextMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
@@ -45,7 +46,7 @@ export function setFromContext(
 
         const metadata: SetFromContextMetadata = { eventType, contextPropertyName };
         Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
-    };
+    });
 }
 
 /**
@@ -55,5 +56,5 @@ export function setFromContext(
  * @returns An array of setFromContext metadata entries.
  */
 export function getSetFromContextMetadata(target: object, propertyKey: string): SetFromContextMetadata[] {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<SetFromContextMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/setValue.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the setValue property decorator. */
 export interface SetValueMetadata {
@@ -20,14 +21,14 @@ const METADATA_KEY = 'chronicle:projection:setValue';
  * @param value - The constant value to assign.
  * @returns A property decorator.
  */
-export function setValue(eventType: Function, value: unknown): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+export function setValue(eventType: Function, value: unknown): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
         const existing: SetValueMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
         const metadata: SetValueMetadata = { eventType, value };
         Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
-    };
+    });
 }
 
 /**
@@ -37,5 +38,5 @@ export function setValue(eventType: Function, value: unknown): PropertyDecorator
  * @returns An array of setValue metadata entries.
  */
 export function getSetValueMetadata(target: object, propertyKey: string): SetValueMetadata[] {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<SetValueMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
 }

package/projections/modelBound/subtractFrom.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import { TypeIntrospector } from '../../types';
+import { TypeIntrospector } from '../../types/index.js';
+import { ChroniclePropertyDecorator, decorateProperty, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
 
 /** Metadata stored by the subtractFrom property decorator. */
 export interface SubtractFromMetadata {
@@ -20,14 +21,14 @@ const METADATA_KEY = 'chronicle:projection:subtractFrom';
  * @param eventPropertyName - Optional event property name. Defaults to the property name.
  * @returns A property decorator.
  */
-export function subtractFrom(eventType: Function, eventPropertyName?: string): PropertyDecorator {
-    return (target: object, propertyKey: string | symbol) => {
+export function subtractFrom(eventType: Function, eventPropertyName?: string): ChroniclePropertyDecorator {
+    return decorateProperty((target: object, propertyKey: string | symbol) => {
         const key = propertyKey.toString();
         TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
         const existing: SubtractFromMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
         const metadata: SubtractFromMetadata = { eventType, eventPropertyName };
         Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
-    };
+    });
 }
 
 /**
@@ -37,5 +38,5 @@ export function subtractFrom(eventType: Function, eventPropertyName?: string): P
  * @returns An array of subtractFrom metadata entries.
  */
 export function getSubtractFromMetadata(target: object, propertyKey: string): SubtractFromMetadata[] {
-    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+    return getPropertyMetadata<SubtractFromMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
 }

package/reactors/ReactorSideEffects.spec.ts

@@ -2,10 +2,10 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { describe, expect, it, vi } from 'vitest';
-import type { IEventLog } from '../eventSequences/IEventLog';
-import { EventSequenceNumber } from '../eventSequences/EventSequenceNumber';
-import { eventType } from '../events/eventTypeDecorator';
-import { appendReactorSideEffects } from './ReactorSideEffects';
+import type { IEventLog } from '../eventSequences/IEventLog.js';
+import { EventSequenceNumber } from '../eventSequences/EventSequenceNumber.js';
+import { eventType } from '../events/eventTypeDecorator.js';
+import { appendReactorSideEffects } from './ReactorSideEffects.js';
 
 class SomethingHappened {
     constructor(readonly value: string = '') {}

package/reactors/ReactorSideEffects.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { hasEventType } from '../events/eventTypeDecorator';
-import type { EventForEventSourceId } from '../eventSequences/EventForEventSourceId';
-import type { IEventLog } from '../eventSequences/IEventLog';
+import { hasEventType } from '../events/eventTypeDecorator.js';
+import type { EventForEventSourceId } from '../eventSequences/EventForEventSourceId.js';
+import type { IEventLog } from '../eventSequences/IEventLog.js';
 
 /**
  * Represents the outcome of appending a reactor handler's returned side-effect events.

package/reactors/Reactors.ts

@@ -5,19 +5,19 @@ import 'reflect-metadata';
 import { diag } from '@opentelemetry/api';
 import { Constructor } from '@cratis/fundamentals';
 import { ObservationState, ReactorMessage } from '@cratis/chronicle.contracts';
-import { IClientArtifactsProvider } from '../artifacts';
-import { ChronicleConnection } from '../connection';
-import { ConnectionLifecycle } from '../connection/ConnectionLifecycle';
-import { getEventTypeMetadata } from '../events/eventTypeDecorator';
-import { toClientEventContext } from '../events/toClientEventContext';
-import { getTagsFor } from '../events/tagDecorator';
-import { getFilterTagsFor } from '../events/filterEventsByTagDecorator';
-import { EventSequenceId } from '../eventSequences/EventSequenceId';
-import type { IEventLog } from '../eventSequences/IEventLog';
-import { notifyReplayLifecycle } from '../observation/notifyReplayLifecycle';
-import { IReactors } from './IReactors';
-import { appendReactorSideEffects } from './ReactorSideEffects';
-import { getReactorMetadata } from './reactor';
+import { IClientArtifactsProvider } from '../artifacts/index.js';
+import { ChronicleConnection } from '../connection/index.js';
+import { ConnectionLifecycle } from '../connection/ConnectionLifecycle.js';
+import { getEventTypeMetadata } from '../events/eventTypeDecorator.js';
+import { toClientEventContext } from '../events/toClientEventContext.js';
+import { getTagsFor } from '../events/tagDecorator.js';
+import { getFilterTagsFor } from '../events/filterEventsByTagDecorator.js';
+import { EventSequenceId } from '../eventSequences/EventSequenceId.js';
+import type { IEventLog } from '../eventSequences/IEventLog.js';
+import { notifyReplayLifecycle } from '../observation/notifyReplayLifecycle.js';
+import { IReactors } from './IReactors.js';
+import { appendReactorSideEffects } from './ReactorSideEffects.js';
+import { getReactorMetadata } from './reactor.js';
 
 /** Expression used to partition reactor observations by event source ID. */
 const EVENT_SOURCE_ID_KEY = '$eventSourceId';

package/reactors/index.ts

@@ -1,8 +1,8 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-export { ReactorId } from './ReactorId';
-export { reactor, getReactorMetadata, isReactor } from './reactor';
-export type { ReactorMetadata } from './reactor';
-export type { IReactors } from './IReactors';
-export { Reactors } from './Reactors';
+export { ReactorId } from './ReactorId.js';
+export { reactor, getReactorMetadata, isReactor } from './reactor.js';
+export type { ReactorMetadata } from './reactor.js';
+export type { IReactors } from './IReactors.js';
+export { Reactors } from './Reactors.js';

package/reactors/reactor.ts

@@ -3,8 +3,8 @@
 
 import 'reflect-metadata';
 import { Constructor } from '@cratis/fundamentals';
-import { ReactorId } from './ReactorId';
-import { DecoratorType, TypeDiscoverer } from '../types';
+import { ReactorId } from './ReactorId.js';
+import { DecoratorType, TypeDiscoverer } from '../types/index.js';
 
 /** Metadata key used to store reactor information on a class. */
 const REACTOR_METADATA_KEY = 'chronicle:reactor';

package/readModels/IReadModels.ts

@@ -2,9 +2,9 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import type { Constructor } from '@cratis/fundamentals';
-import type { IMaterializedReadModels } from './IMaterializedReadModels';
-import type { ReadModelChangeset } from './ReadModelChangeset';
-import type { ReadModelSnapshot } from './ReadModelSnapshot';
+import type { IMaterializedReadModels } from './IMaterializedReadModels.js';
+import type { ReadModelChangeset } from './ReadModelChangeset.js';
+import type { ReadModelSnapshot } from './ReadModelSnapshot.js';
 
 /**
  * Defines a system that works with read models in the event store.