@cratis/chronicle 6.3.1 → 6.4.0

package/ChronicleClient.ts

@@ -4,20 +4,20 @@
 import * as os from 'os';
 import { diag } from '@opentelemetry/api';
 import { SpanStatusCode } from '@opentelemetry/api';
-import { ChronicleOptions } from './ChronicleOptions';
-import { ChronicleConnection } from './connection';
-import { IncompatibleChronicleServer } from './connection/IncompatibleChronicleServer';
-import { ensureCommandSuccess, ensureQuerySuccess } from './connection/callResults';
-import { ConnectionLifecycle } from './connection/ConnectionLifecycle';
-import { KernelKeepAlive } from './connection/KernelKeepAlive';
-import { EventStore } from './EventStore';
-import { EventStoreName } from './EventStoreName';
-import { EventStoreNamespaceName } from './EventStoreNamespaceName';
-import { IChronicleClient } from './IChronicleClient';
-import { IEventStore } from './IEventStore';
-import { ChronicleMetrics } from './Metrics';
-import { ChronicleTracer } from './Tracing';
-import { TypeDiscoverer } from './types';
+import { ChronicleOptions } from './ChronicleOptions.js';
+import { ChronicleConnection } from './connection/index.js';
+import { IncompatibleChronicleServer } from './connection/IncompatibleChronicleServer.js';
+import { ensureCommandSuccess, ensureQuerySuccess } from './connection/callResults.js';
+import { ConnectionLifecycle } from './connection/ConnectionLifecycle.js';
+import { KernelKeepAlive } from './connection/KernelKeepAlive.js';
+import { EventStore } from './EventStore.js';
+import { EventStoreName } from './EventStoreName.js';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName.js';
+import { IChronicleClient } from './IChronicleClient.js';
+import { IEventStore } from './IEventStore.js';
+import { ChronicleMetrics } from './Metrics.js';
+import { ChronicleTracer } from './Tracing.js';
+import { TypeDiscoverer } from './types/index.js';
 
 /**
  * Implements {@link IChronicleClient} by managing a gRPC connection to the

package/ChronicleOptions.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 { DefaultClientArtifactsProvider, IClientArtifactsProvider } from './artifacts';
-import { ChronicleConnectionString } from './connection';
-import { WellKnownSinks } from './sinks';
+import { DefaultClientArtifactsProvider, IClientArtifactsProvider } from './artifacts/index.js';
+import { ChronicleConnectionString } from './connection/index.js';
+import { WellKnownSinks } from './sinks/index.js';
 
 type ChronicleOptionsConstructorParams = {
     connectionString: ChronicleConnectionString;

package/EventStore.ts

@@ -3,49 +3,50 @@
 
 import { diag } from '@opentelemetry/api';
 import { SpanStatusCode } from '@opentelemetry/api';
-import { ChronicleConnection } from './connection';
-import { ConnectionLifecycle } from './connection/ConnectionLifecycle';
-import { ensureQuerySuccess } from './connection/callResults';
-import { EventLog } from './eventSequences/EventLog';
-import { EventSequence } from './eventSequences/EventSequence';
-import { EventSequenceId } from './eventSequences/EventSequenceId';
-import { IEventLog } from './eventSequences/IEventLog';
-import { IEventSequence } from './eventSequences/IEventSequence';
-import { EventStoreName } from './EventStoreName';
-import { EventStoreNamespaceName } from './EventStoreNamespaceName';
-import { IEventStore } from './IEventStore';
-import { EventTypes } from './events/EventTypes';
-import { IEventTypes } from './events/IEventTypes';
-import { Constraints } from './events/constraints/Constraints';
-import { IConstraints } from './events/constraints/IConstraints';
-import { Projections } from './projections/Projections';
-import { IProjections } from './projections/IProjections';
-import { Reactors } from './reactors/Reactors';
-import { IReactors } from './reactors/IReactors';
-import { Reducers } from './reducers/Reducers';
-import { IReducers } from './reducers/IReducers';
-import { IReadModels } from './readModels/IReadModels';
-import { ReadModels } from './readModels/ReadModels';
-import { EventSeeding } from './seeding/EventSeeding';
-import { IEventSeeding } from './seeding/IEventSeeding';
-import { ChronicleTracer } from './Tracing';
-import { DefaultClientArtifactsProvider } from './artifacts/DefaultClientArtifactsProvider';
-import { IUnitOfWorkManager } from './transactions/IUnitOfWorkManager';
-import { UnitOfWorkManager } from './transactions/UnitOfWorkManager';
-import { IJobs } from './jobs/IJobs';
-import { Jobs } from './jobs/Jobs';
-import { IWebhooks } from './webhooks/IWebhooks';
-import { Webhooks } from './webhooks/Webhooks';
-import { EventStoreSubscriptions } from './eventStoreSubscriptions/EventStoreSubscriptions';
-import { IEventStoreSubscriptions } from './eventStoreSubscriptions/IEventStoreSubscriptions';
-import { ExternalServices } from './externalServices/ExternalServices';
-import { IExternalServices } from './externalServices/IExternalServices';
-import { IdentityManager } from './identities/IdentityManager';
-import { IIdentityManager } from './identities/IIdentityManager';
-import { PIIManager } from './compliance/PIIManager';
-import { IPIIManager } from './compliance/IPIIManager';
-import { FailedPartitions } from './observation/FailedPartitions';
-import { IFailedPartitions } from './observation/IFailedPartitions';
+import { ChronicleConnection } from './connection/index.js';
+import { ConnectionLifecycle } from './connection/ConnectionLifecycle.js';
+import { ensureQuerySuccess } from './connection/callResults.js';
+import { EventLog } from './eventSequences/EventLog.js';
+import { EventSequence } from './eventSequences/EventSequence.js';
+import { EventSequenceId } from './eventSequences/EventSequenceId.js';
+import { IEventLog } from './eventSequences/IEventLog.js';
+import { IEventSequence } from './eventSequences/IEventSequence.js';
+import { EventStoreName } from './EventStoreName.js';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName.js';
+import { IEventStore } from './IEventStore.js';
+import { EventTypes } from './events/EventTypes.js';
+import { IEventTypes } from './events/IEventTypes.js';
+import { Constraints } from './events/constraints/Constraints.js';
+import { IConstraints } from './events/constraints/IConstraints.js';
+import { Projections } from './projections/Projections.js';
+import { IProjections } from './projections/IProjections.js';
+import { Reactors } from './reactors/Reactors.js';
+import { IReactors } from './reactors/IReactors.js';
+import { Reducers } from './reducers/Reducers.js';
+import { IReducers } from './reducers/IReducers.js';
+import { IReadModels } from './readModels/IReadModels.js';
+import { ReadModels } from './readModels/ReadModels.js';
+import { EventSeeding } from './seeding/EventSeeding.js';
+import { IEventSeeding } from './seeding/IEventSeeding.js';
+import { ChronicleTracer } from './Tracing.js';
+import { DefaultClientArtifactsProvider } from './artifacts/DefaultClientArtifactsProvider.js';
+import { validateArtifactSchemas } from './artifacts/validateArtifactSchemas.js';
+import { IUnitOfWorkManager } from './transactions/IUnitOfWorkManager.js';
+import { UnitOfWorkManager } from './transactions/UnitOfWorkManager.js';
+import { IJobs } from './jobs/IJobs.js';
+import { Jobs } from './jobs/Jobs.js';
+import { IWebhooks } from './webhooks/IWebhooks.js';
+import { Webhooks } from './webhooks/Webhooks.js';
+import { EventStoreSubscriptions } from './eventStoreSubscriptions/EventStoreSubscriptions.js';
+import { IEventStoreSubscriptions } from './eventStoreSubscriptions/IEventStoreSubscriptions.js';
+import { ExternalServices } from './externalServices/ExternalServices.js';
+import { IExternalServices } from './externalServices/IExternalServices.js';
+import { IdentityManager } from './identities/IdentityManager.js';
+import { IIdentityManager } from './identities/IIdentityManager.js';
+import { PIIManager } from './compliance/PIIManager.js';
+import { IPIIManager } from './compliance/IPIIManager.js';
+import { FailedPartitions } from './observation/FailedPartitions.js';
+import { IFailedPartitions } from './observation/IFailedPartitions.js';
 
 /**
  * Implements {@link IEventStore} by communicating with the Chronicle Kernel
@@ -125,6 +126,8 @@ export class EventStore implements IEventStore {
             this.seeding.discover()
         ]);
 
+        validateArtifactSchemas(DefaultClientArtifactsProvider.default);
+
         this._logger.debug('Registering discovered artifacts', {
             eventStore: this.name.value,
             namespace: this.namespace.value

package/IChronicleClient.ts

@@ -1,10 +1,10 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { ChronicleOptions } from './ChronicleOptions';
-import { EventStoreName } from './EventStoreName';
-import { EventStoreNamespaceName } from './EventStoreNamespaceName';
-import { IEventStore } from './IEventStore';
+import { ChronicleOptions } from './ChronicleOptions.js';
+import { EventStoreName } from './EventStoreName.js';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName.js';
+import { IEventStore } from './IEventStore.js';
 
 /**
  * Defines the Cratis Chronicle client API surface.

package/IEventStore.ts

@@ -1,26 +1,26 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-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';
-import { IUnitOfWorkManager } from './transactions/IUnitOfWorkManager';
-import { IJobs } from './jobs/IJobs';
-import { IWebhooks } from './webhooks/IWebhooks';
-import { IEventSeeding } from './seeding/IEventSeeding';
-import { IEventStoreSubscriptions } from './eventStoreSubscriptions/IEventStoreSubscriptions';
-import { IReadModels } from './readModels/IReadModels';
-import { IExternalServices } from './externalServices/IExternalServices';
-import { IIdentityManager } from './identities/IIdentityManager';
-import { IPIIManager } from './compliance/IPIIManager';
-import { IFailedPartitions } from './observation/IFailedPartitions';
+import { IEventLog } from './eventSequences/IEventLog.js';
+import { IEventSequence } from './eventSequences/IEventSequence.js';
+import { EventSequenceId } from './eventSequences/EventSequenceId.js';
+import { EventStoreName } from './EventStoreName.js';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName.js';
+import { IEventTypes } from './events/IEventTypes.js';
+import { IConstraints } from './events/constraints/IConstraints.js';
+import { IProjections } from './projections/IProjections.js';
+import { IReactors } from './reactors/IReactors.js';
+import { IReducers } from './reducers/IReducers.js';
+import { IUnitOfWorkManager } from './transactions/IUnitOfWorkManager.js';
+import { IJobs } from './jobs/IJobs.js';
+import { IWebhooks } from './webhooks/IWebhooks.js';
+import { IEventSeeding } from './seeding/IEventSeeding.js';
+import { IEventStoreSubscriptions } from './eventStoreSubscriptions/IEventStoreSubscriptions.js';
+import { IReadModels } from './readModels/IReadModels.js';
+import { IExternalServices } from './externalServices/IExternalServices.js';
+import { IIdentityManager } from './identities/IIdentityManager.js';
+import { IPIIManager } from './compliance/IPIIManager.js';
+import { IFailedPartitions } from './observation/IFailedPartitions.js';
 
 /**
  * Defines the API surface for an event store.

package/README.md

@@ -28,7 +28,7 @@ Beyond appending and observing events, the client covers the full Chronicle surf
 ## Installation
 
 ```bash
-npm install @cratis/chronicle reflect-metadata
+npm install @cratis/chronicle @cratis/fundamentals reflect-metadata
 ```
 
 You need a Chronicle Kernel available. The easiest local setup is the development Docker image:
@@ -41,11 +41,18 @@ docker run -p 35000:35000 cratis/chronicle:latest-development
 
 ```typescript
 import 'reflect-metadata';
+import { field } from '@cratis/fundamentals';
 import { ChronicleClient, ChronicleOptions, eventType } from '@cratis/chronicle';
 
 @eventType()
 class EmployeeHired {
-    constructor(readonly firstName: string, readonly lastName: string) {}
+    @field(String) firstName!: string;
+    @field(String) lastName!: string;
+
+    constructor(firstName: string, lastName: string) {
+        this.firstName = firstName;
+        this.lastName = lastName;
+    }
 }
 
 const client = new ChronicleClient(ChronicleOptions.development());
@@ -55,6 +62,10 @@ console.log(`Appended at sequence number ${result.sequenceNumber.value}`);
 client.dispose();
 ```
 
+## Decorators and TypeScript configuration
+
+Chronicle decorators work with both TC39 standard decorators (TypeScript 5.2+; do not enable `experimentalDecorators`) and legacy decorators (`experimentalDecorators: true`). Keep `reflect-metadata` imported at your entry point for Chronicle's runtime metadata storage. In standard mode, TypeScript does not emit `design:type` or `design:paramtypes`; declare event and read-model fields with `@field(Type)` from `@cratis/fundamentals` so Chronicle can generate their schemas. For arrays, provide an element type with `@field(Array, { genericArguments: [ItemType] })`. For a `ConceptAs<string>` or `ConceptAs<number>`, declare `static readonly valueType = String`, `Number`, `Boolean`, `Guid`, or `Date` on the concept class. Member-less event types and read models are valid. Unresolved standard-mode types fail on first schema read or during connection before Kernel registration; property decorators support public instance fields, not standard accessors or getters.
+
 ## Documentation
 
 See the [getting started guide](https://github.com/Cratis/Chronicle.TypeScript/blob/main/Documentation/getting-started.md) and the rest of the [documentation](https://github.com/Cratis/Chronicle.TypeScript/tree/main/Documentation) for installation and usage instructions, or visit [cratis.io](https://www.cratis.io/chronicle/).

package/artifacts/DefaultClientArtifactsProvider.ts

@@ -2,9 +2,9 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { Constructor } from '@cratis/fundamentals';
-import { IClientArtifactsProvider } from './IClientArtifactsProvider';
-import { DecoratorType } from '../types/DecoratorType';
-import { TypeDiscoverer } from '../types/TypeDiscoverer';
+import { IClientArtifactsProvider } from './IClientArtifactsProvider.js';
+import { DecoratorType } from '../types/DecoratorType.js';
+import { TypeDiscoverer } from '../types/TypeDiscoverer.js';
 
 /**
  * Represents the default provider for discovered client artifacts.

package/artifacts/index.ts

@@ -1,5 +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 type { IClientArtifactsProvider } from './IClientArtifactsProvider';
-export { DefaultClientArtifactsProvider } from './DefaultClientArtifactsProvider';
+export type { IClientArtifactsProvider } from './IClientArtifactsProvider.js';
+export { DefaultClientArtifactsProvider } from './DefaultClientArtifactsProvider.js';

package/artifacts/validateArtifactSchemas.spec.ts

@@ -0,0 +1,61 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { field } from '@cratis/fundamentals';
+import { describe, expect, it, vi } from 'vitest';
+import { eventType } from '../events/eventTypeDecorator.js';
+import { readModel } from '../readModels/readModel.js';
+import { IClientArtifactsProvider } from './IClientArtifactsProvider.js';
+import { validateArtifactSchemas } from './validateArtifactSchemas.js';
+import { EventStore } from '../EventStore.js';
+import { EventStoreName } from '../EventStoreName.js';
+import { EventStoreNamespaceName } from '../EventStoreNamespaceName.js';
+import { ChronicleConnection } from '../connection/ChronicleConnection.js';
+import { ConnectionLifecycle } from '../connection/ConnectionLifecycle.js';
+
+@eventType('bad-event')
+class BadEvent {
+    @field(Array) items!: string[];
+}
+
+@readModel('bad-read-model')
+class BadReadModel {
+    constructor(readonly name: string) {}
+}
+
+@eventType('good-event')
+class GoodEvent {}
+
+const artifacts = {
+    eventTypes: [BadEvent, GoodEvent],
+    readModels: [BadReadModel]
+} as unknown as IClientArtifactsProvider;
+
+describe('artifact schema preflight', () => {
+    it('blocks every Kernel registration when preflight fails', async () => {
+        const register = vi.fn();
+        const connection = new Proxy({}, {
+            get: () => new Proxy({}, { get: () => register })
+        }) as ChronicleConnection;
+        const lifecycle = { onDisconnected: vi.fn(), onConnected: vi.fn() } as unknown as ConnectionLifecycle;
+        const store = new EventStore(new EventStoreName('Test'), EventStoreNamespaceName.default, connection, lifecycle, 'sink');
+
+        await expect(store.registerArtifacts()).rejects.toBeInstanceOf(AggregateError);
+        expect(register).not.toHaveBeenCalled();
+    });
+
+    it('collects all schema failures before registration', () => {
+        try {
+            validateArtifactSchemas(artifacts);
+            throw new Error('Expected schema validation to fail');
+        } catch (error) {
+            expect(error).toBeInstanceOf(AggregateError);
+            const aggregate = error as AggregateError;
+            expect(aggregate.errors).toHaveLength(2);
+            expect(aggregate.errors.map((failure: Error) => failure.message)).toEqual([
+                expect.stringContaining('Event type BadEvent:'),
+                expect.stringContaining('Read model BadReadModel:')
+            ]);
+        }
+    });
+});

package/artifacts/validateArtifactSchemas.ts

@@ -0,0 +1,39 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { IClientArtifactsProvider } from './IClientArtifactsProvider.js';
+import { getEventTypeMetadata } from '../events/eventTypeDecorator.js';
+import { getReadModelMetadata } from '../readModels/readModel.js';
+import { JsonSchemaGenerator } from '../schemas/JsonSchemaGenerator.js';
+
+/** Resolves every discovered schema before any registration can reach the Kernel. */
+export function validateArtifactSchemas(artifacts: IClientArtifactsProvider): void {
+    const failures: Error[] = [];
+
+    for (const type of artifacts.eventTypes) {
+        try {
+            const metadata = getEventTypeMetadata(type);
+            if (!metadata) throw new TypeError(`Missing event type metadata for ${type.name}.`);
+            void metadata.schema;
+        } catch (error) {
+            failures.push(new Error(`Event type ${type.name}: ${String(error)}`, { cause: error }));
+        }
+    }
+
+    for (const type of artifacts.readModels) {
+        try {
+            const metadata = getReadModelMetadata(type);
+            if (metadata) {
+                void metadata.schema;
+            } else {
+                JsonSchemaGenerator.generate(type);
+            }
+        } catch (error) {
+            failures.push(new Error(`Read model ${type.name}: ${String(error)}`, { cause: error }));
+        }
+    }
+
+    if (failures.length) {
+        throw new AggregateError(failures, `Cannot register artifacts: ${failures.length} schema error(s).`);
+    }
+}

package/auditing/Causation.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { CausationType } from './CausationType';
+import { CausationType } from './CausationType.js';
 
 /**
  * Represents a causation instance.

package/auditing/CausationManager.ts

@@ -2,9 +2,9 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { AsyncLocalStorage } from 'async_hooks';
-import { Causation } from './Causation';
-import { CausationType } from './CausationType';
-import { ICausationManager } from './ICausationManager';
+import { Causation } from './Causation.js';
+import { CausationType } from './CausationType.js';
+import { ICausationManager } from './ICausationManager.js';
 
 /**
  * Implements {@link ICausationManager} using {@link AsyncLocalStorage} to scope the causation chain to the active async call context.

package/auditing/ICausationManager.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.
 
-import { Causation } from './Causation';
-import { CausationType } from './CausationType';
+import { Causation } from './Causation.js';
+import { CausationType } from './CausationType.js';
 
 /**
  * Defines a system that manages causation for the active call context.

package/auditing/index.ts

@@ -1,12 +1,12 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-export { Causation } from './Causation';
-export { CausationType } from './CausationType';
-export type { ICausationManager } from './ICausationManager';
-export { CausationManager } from './CausationManager';
+export { Causation } from './Causation.js';
+export { CausationType } from './CausationType.js';
+export type { ICausationManager } from './ICausationManager.js';
+export { CausationManager } from './CausationManager.js';
 
-import { CausationManager } from './CausationManager';
+import { CausationManager } from './CausationManager.js';
 
 /**
  * The default singleton {@link CausationManager} for the process.

package/compliance/ComplianceMetadata.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import type { ComplianceMetadataType } from './ComplianceMetadataType';
+import type { ComplianceMetadataType } from './ComplianceMetadataType.js';
 
 /**
  * Represents metadata related to compliance.

package/compliance/ComplianceMetadataResolver.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.
 
-import type { ComplianceMetadata } from './ComplianceMetadata';
-import { getPIIMetadata, getTypePIIMetadata } from './pii';
+import type { ComplianceMetadata } from './ComplianceMetadata.js';
+import { getPIIMetadata, getTypePIIMetadata } from './pii.js';
 
 /**
  * Resolves compliance metadata for properties and types.

package/compliance/PIIManager.spec.ts

@@ -2,8 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { describe, expect, it, vi } from 'vitest';
-import { ChronicleConnection } from '../connection';
-import { PIIManager } from './PIIManager';
+import { ChronicleConnection } from '../connection/index.js';
+import { PIIManager } from './PIIManager.js';
 
 function createPIIManager() {
     const deleteEncryptionKeyMock = vi.fn().mockResolvedValue(undefined);

package/compliance/PIIManager.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.
 
-import { ChronicleConnection } from '../connection';
-import { IPIIManager } from './IPIIManager';
+import { ChronicleConnection } from '../connection/index.js';
+import { IPIIManager } from './IPIIManager.js';
 
 /**
  * Implements {@link IPIIManager} by proxying to the Chronicle Kernel over the client connection.

package/compliance/index.ts

@@ -1,11 +1,11 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-export { ComplianceMetadataType } from './ComplianceMetadataType';
-export type { ComplianceMetadata } from './ComplianceMetadata';
-export { pii, getPIIMetadata, hasPIIMetadata, getTypePIIMetadata, isPII } from './pii';
-export { subject, hasSubjectMetadata, getSubjectPropertyName } from './subject';
-export { PIINotSupportedOnEventSourceId } from './PIINotSupportedOnEventSourceId';
-export { ComplianceMetadataResolver } from './ComplianceMetadataResolver';
-export type { IPIIManager } from './IPIIManager';
-export { PIIManager } from './PIIManager';
+export { ComplianceMetadataType } from './ComplianceMetadataType.js';
+export type { ComplianceMetadata } from './ComplianceMetadata.js';
+export { pii, getPIIMetadata, hasPIIMetadata, getTypePIIMetadata, isPII } from './pii.js';
+export { subject, hasSubjectMetadata, getSubjectPropertyName } from './subject.js';
+export { PIINotSupportedOnEventSourceId } from './PIINotSupportedOnEventSourceId.js';
+export { ComplianceMetadataResolver } from './ComplianceMetadataResolver.js';
+export type { IPIIManager } from './IPIIManager.js';
+export { PIIManager } from './PIIManager.js';

package/compliance/pii.spec.ts

@@ -3,8 +3,8 @@
 
 import 'reflect-metadata';
 import { describe, expect, it } from 'vitest';
-import { pii } from './pii';
-import { PIINotSupportedOnEventSourceId } from './PIINotSupportedOnEventSourceId';
+import { pii } from './pii.js';
+import { PIINotSupportedOnEventSourceId } from './PIINotSupportedOnEventSourceId.js';
 
 // Decorators are applied as plain function calls (rather than `@decorator` syntax) so these
 // fixtures don't depend on the test runner's decorator-syntax support.

package/compliance/pii.ts

@@ -2,10 +2,11 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import 'reflect-metadata';
-import type { ComplianceMetadata } from './ComplianceMetadata';
-import { ComplianceMetadataType } from './ComplianceMetadataType';
-import { PIINotSupportedOnEventSourceId } from './PIINotSupportedOnEventSourceId';
-import { TypeIntrospector } from '../types';
+import type { ComplianceMetadata } from './ComplianceMetadata.js';
+import { ComplianceMetadataType } from './ComplianceMetadataType.js';
+import { PIINotSupportedOnEventSourceId } from './PIINotSupportedOnEventSourceId.js';
+import { TypeIntrospector } from '../types/index.js';
+import { ChronicleClassOrPropertyDecorator, decorateClassOrProperty, getPropertyMetadata, hasPropertyMetadata } from '../types/propertyDecoratorMetadata.js';
 
 /** The property name this client uses everywhere for the event source identifier. */
 const EVENT_SOURCE_ID_PROPERTY = 'eventSourceId';
@@ -55,8 +56,8 @@ const PII_TYPE_METADATA_KEY = 'chronicle:compliance:pii:type';
  * }
  * ```
  */
-export function pii(details?: string): PropertyDecorator & ClassDecorator {
-    return (target: object | Function, propertyKey?: string | symbol) => {
+export function pii(details?: string): ChronicleClassOrPropertyDecorator {
+    return decorateClassOrProperty((target: object | Function, propertyKey?: string | symbol) => {
         // Class decorator usage (for types like ConceptAs)
         if (typeof target === 'function' && propertyKey === undefined) {
             const metadata: ComplianceMetadata = {
@@ -78,7 +79,7 @@ export function pii(details?: string): PropertyDecorator & ClassDecorator {
             // PIINotSupportedOnEventSourceId guard, which throws for the same reason when
             // [PII] is applied to an EventSourceId/EventSourceId<T> type.
             if (key === EVENT_SOURCE_ID_PROPERTY) {
-                throw new PIINotSupportedOnEventSourceId(declaringType.name);
+                throw new PIINotSupportedOnEventSourceId(declaringType.name || 'the decorated class');
             }
 
             TypeIntrospector.trackProperty(declaringType, key);
@@ -88,7 +89,7 @@ export function pii(details?: string): PropertyDecorator & ClassDecorator {
             };
             Reflect.defineMetadata(PII_PROPERTY_METADATA_KEY, metadata, target, key);
         }
-    };
+    });
 }
 
 /**
@@ -98,7 +99,7 @@ export function pii(details?: string): PropertyDecorator & ClassDecorator {
  * @returns The compliance metadata, or undefined if not decorated with @pii.
  */
 export function getPIIMetadata(target: object, propertyKey: string): ComplianceMetadata | undefined {
-    return Reflect.getMetadata(PII_PROPERTY_METADATA_KEY, target, propertyKey);
+    return getPropertyMetadata<ComplianceMetadata>(PII_PROPERTY_METADATA_KEY, target, propertyKey);
 }
 
 /**
@@ -108,7 +109,7 @@ export function getPIIMetadata(target: object, propertyKey: string): ComplianceM
  * @returns True if the property has @pii decorator; false otherwise.
  */
 export function hasPIIMetadata(target: object, propertyKey: string): boolean {
-    return Reflect.hasMetadata(PII_PROPERTY_METADATA_KEY, target, propertyKey);
+    return hasPropertyMetadata(PII_PROPERTY_METADATA_KEY, target, propertyKey);
 }
 
 /**

package/compliance/subject.spec.ts

@@ -3,7 +3,7 @@
 
 import 'reflect-metadata';
 import { describe, expect, it } from 'vitest';
-import { getSubjectPropertyName, hasSubjectMetadata, subject } from './subject';
+import { getSubjectPropertyName, hasSubjectMetadata, subject } from './subject.js';
 
 // Decorators are applied as plain function calls (rather than `@decorator` syntax) so these
 // fixtures don't depend on the test runner's decorator-syntax support.