@cratis/chronicle 3.1.0 → 4.0.0

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../ChronicleClient.ts","../ChronicleOptions.ts","../EventStore.ts","../EventStoreName.ts","../EventStoreNamespaceName.ts","../IChronicleClient.ts","../IEventStore.ts","../Metrics.ts","../Tracing.ts","../index.ts","../artifacts/DefaultClientArtifactsProvider.ts","../artifacts/IClientArtifactsProvider.ts","../artifacts/index.ts","../auditing/Causation.ts","../auditing/CausationManager.ts","../auditing/CausationType.ts","../auditing/ICausationManager.ts","../auditing/index.ts","../compliance/ComplianceContracts.ts","../compliance/ComplianceMetadata.ts","../compliance/ComplianceMetadataResolver.ts","../compliance/ComplianceMetadataType.ts","../compliance/IPIIManager.ts","../compliance/PIIManager.ts","../compliance/index.ts","../compliance/pii.ts","../connection/ChronicleConnection.ts","../connection/ChronicleConnectionString.ts","../connection/ChronicleServerAddressResolver.ts","../connection/ChronicleServices.ts","../connection/ChronicleSrvResolutionError.ts","../connection/ChronicleSrvResolver.ts","../connection/ConnectionLifecycle.ts","../connection/DateTimeOffset.ts","../connection/Guid.ts","../connection/ILoadBalancerStrategy.ts","../connection/KernelKeepAlive.ts","../connection/LeastConnectionsLoadBalancerStrategy.ts","../connection/LoadBalancerMode.ts","../connection/LoadBalancerStrategyFactory.ts","../connection/RandomLoadBalancerStrategy.ts","../connection/RoundRobinLoadBalancerStrategy.ts","../connection/TokenProvider.ts","../connection/fetchOAuthAccessToken.ts","../connection/formatServerAddress.ts","../connection/index.ts","../correlation/CorrelationId.ts","../correlation/CorrelationIdManager.ts","../correlation/ICorrelationIdAccessor.ts","../correlation/ICorrelationIdSetter.ts","../correlation/index.ts","../eventSequences/AppendError.ts","../eventSequences/AppendOperationsBroadcaster.ts","../eventSequences/AppendOptions.ts","../eventSequences/AppendResult.ts","../eventSequences/AppendedEventWithResult.ts","../eventSequences/CompleteStreamError.ts","../eventSequences/CompleteStreamResult.ts","../eventSequences/ConcurrencyScope.ts","../eventSequences/ConcurrencyViolation.ts","../eventSequences/ConstraintViolation.ts","../eventSequences/EventForEventSourceId.ts","../eventSequences/EventLog.ts","../eventSequences/EventSequence.ts","../eventSequences/EventSequenceId.ts","../eventSequences/EventSequenceNumber.ts","../eventSequences/IEventLog.ts","../eventSequences/IEventSequence.ts","../eventSequences/ITransactionalEventSequence.ts","../eventSequences/TransactionalEventSequence.ts","../eventSequences/WaitForCompletionResult.ts","../eventSequences/index.ts","../eventStoreSubscriptions/EventStoreSubscriptionBuilder.ts","../eventStoreSubscriptions/EventStoreSubscriptionDefinition.ts","../eventStoreSubscriptions/EventStoreSubscriptionId.ts","../eventStoreSubscriptions/EventStoreSubscriptions.ts","../eventStoreSubscriptions/IEventStoreSubscriptionBuilder.ts","../eventStoreSubscriptions/IEventStoreSubscriptions.ts","../eventStoreSubscriptions/contracts.ts","../eventStoreSubscriptions/index.ts","../events/AppendedEvent.ts","../events/CausationEntry.ts","../events/EventContext.ts","../events/EventType.ts","../events/EventTypeGeneration.ts","../events/EventTypeId.ts","../events/EventTypes.ts","../events/IEventTypes.ts","../events/eventTypeDecorator.ts","../events/index.ts","../events/constraints/ConstraintBuilder.ts","../events/constraints/ConstraintId.ts","../events/constraints/Constraints.ts","../events/constraints/IConstraint.ts","../events/constraints/IConstraintBuilder.ts","../events/constraints/IConstraints.ts","../events/constraints/IUniqueConstraintBuilder.ts","../events/constraints/UniqueConstraintBuilder.ts","../events/constraints/constraint.ts","../events/constraints/index.ts","../events/migrations/EventMigrationBuilder.ts","../events/migrations/EventMigrationPropertyBuilder.ts","../events/migrations/EventTypeMigrators.ts","../events/migrations/IEventMigrationBuilder.ts","../events/migrations/IEventMigrationPropertyBuilder.ts","../events/migrations/IEventTypeMigration.ts","../events/migrations/IEventTypeMigrators.ts","../events/migrations/InvalidMigrationGenerationGap.ts","../events/migrations/eventTypeMigration.ts","../events/migrations/index.ts","../externalServices/ExternalServiceBuilder.ts","../externalServices/ExternalServices.ts","../externalServices/ExternalServicesContracts.ts","../externalServices/IExternalServiceBuilder.ts","../externalServices/IExternalServices.ts","../externalServices/index.ts","../identities/IIdentityManager.ts","../identities/IdentityManager.ts","../identities/index.ts","../identity/IIdentityProvider.ts","../identity/Identity.ts","../identity/IdentityProvider.ts","../identity/index.ts","../jobs/IJobs.ts","../jobs/JobId.ts","../jobs/Jobs.ts","../jobs/index.ts","../observation/FailedPartition.ts","../observation/FailedPartitionAttempt.ts","../observation/FailedPartitions.ts","../observation/ICanBeNotifiedWhenPartitionReplayed.ts","../observation/ICanBeNotifiedWhenReplay.ts","../observation/IFailedPartitions.ts","../observation/ObserverId.ts","../observation/ObserverRunningState.ts","../observation/index.ts","../observation/notifyReplayLifecycle.ts","../observation/toClientFailedPartition.ts","../projections/IProjections.ts","../projections/ProjectionId.ts","../projections/Projections.ts","../projections/index.ts","../projections/declarative/AddBuilder.ts","../projections/declarative/AddChildBuilder.ts","../projections/declarative/AllSetBuilder.ts","../projections/declarative/ChildrenBuilder.ts","../projections/declarative/CompositeKeyBuilder.ts","../projections/declarative/FromBuilder.ts","../projections/declarative/FromEveryBuilder.ts","../projections/declarative/IAddBuilder.ts","../projections/declarative/IAddChildBuilder.ts","../projections/declarative/IAllSetBuilder.ts","../projections/declarative/IChildrenBuilder.ts","../projections/declarative/ICompositeKeyBuilder.ts","../projections/declarative/IFromBuilder.ts","../projections/declarative/IFromEveryBuilder.ts","../projections/declarative/IJoinBuilder.ts","../projections/declarative/INestedBuilder.ts","../projections/declarative/IProjectionBuilder.ts","../projections/declarative/IProjectionBuilderFor.ts","../projections/declarative/IProjectionFor.ts","../projections/declarative/IReadModelPropertiesBuilder.ts","../projections/declarative/IRemovedWithBuilder.ts","../projections/declarative/IRemovedWithJoinBuilder.ts","../projections/declarative/ISetBuilder.ts","../projections/declarative/ISubtractBuilder.ts","../projections/declarative/JoinBuilder.ts","../projections/declarative/NestedBuilder.ts","../projections/declarative/ProjectionBuilderCore.ts","../projections/declarative/ProjectionBuilderFor.ts","../projections/declarative/RemovedWithBuilder.ts","../projections/declarative/RemovedWithJoinBuilder.ts","../projections/declarative/SetBuilder.ts","../projections/declarative/SubtractBuilder.ts","../projections/declarative/index.ts","../projections/declarative/projection.ts","../projections/modelBound/FromEventMetadata.ts","../projections/modelBound/FromEventOptions.ts","../projections/modelBound/addFrom.ts","../projections/modelBound/childrenAndNestedBuilder.ts","../projections/modelBound/childrenFrom.ts","../projections/modelBound/clearWith.ts","../projections/modelBound/count.ts","../projections/modelBound/decrement.ts","../projections/modelBound/fromEvent.ts","../projections/modelBound/fromEvery.ts","../projections/modelBound/increment.ts","../projections/modelBound/index.ts","../projections/modelBound/join.ts","../projections/modelBound/nested.ts","../projections/modelBound/notRewindable.ts","../projections/modelBound/passive.ts","../projections/modelBound/removedWith.ts","../projections/modelBound/removedWithJoin.ts","../projections/modelBound/setFrom.ts","../projections/modelBound/setFromContext.ts","../projections/modelBound/setValue.ts","../projections/modelBound/subtractFrom.ts","../reactors/IReactors.ts","../reactors/ReactorId.ts","../reactors/ReactorSideEffects.ts","../reactors/Reactors.ts","../reactors/index.ts","../reactors/reactor.ts","../readModels/IMaterializedReadModels.ts","../readModels/IReadModels.ts","../readModels/MaterializedReadModels.ts","../readModels/ReadModelChangeset.ts","../readModels/ReadModelId.ts","../readModels/ReadModelSnapshot.ts","../readModels/ReadModels.ts","../readModels/index.ts","../readModels/readModel.ts","../reducers/IReducers.ts","../reducers/ReducerId.ts","../reducers/Reducers.ts","../reducers/index.ts","../reducers/reducer.ts","../schemas/JsonSchema.ts","../schemas/JsonSchemaGenerator.ts","../schemas/index.ts","../schemas/jsonSchemaProperty.ts","../seeding/EventSeeding.ts","../seeding/ICanSeedEvents.ts","../seeding/IEventSeeding.ts","../seeding/IEventSeedingBuilder.ts","../seeding/IEventSeedingScopeBuilder.ts","../seeding/index.ts","../seeding/seeder.ts","../sinks/WellKnownSinks.ts","../sinks/index.ts","../transactions/IUnitOfWork.ts","../transactions/IUnitOfWorkManager.ts","../transactions/NoUnitOfWorkHasBeenStarted.ts","../transactions/UnitOfWork.ts","../transactions/UnitOfWorkManager.ts","../transactions/index.ts","../types/DecoratorType.ts","../types/TypeDiscoverer.ts","../types/TypeIntrospector.ts","../types/index.ts","../webhooks/IWebhook.ts","../webhooks/IWebhookDefinitionBuilder.ts","../webhooks/IWebhooks.ts","../webhooks/WebhookDefinitionBuilder.ts","../webhooks/WebhookId.ts","../webhooks/WebhookTargetUrl.ts","../webhooks/Webhooks.ts","../webhooks/index.ts","../webhooks/webhook.ts"],"version":"6.0.3"}
+{"root":["../ChronicleClient.ts","../ChronicleOptions.ts","../EventStore.ts","../EventStoreName.ts","../EventStoreNamespaceName.ts","../IChronicleClient.ts","../IEventStore.ts","../Metrics.ts","../Tracing.ts","../index.ts","../artifacts/DefaultClientArtifactsProvider.ts","../artifacts/IClientArtifactsProvider.ts","../artifacts/index.ts","../auditing/Causation.ts","../auditing/CausationManager.ts","../auditing/CausationType.ts","../auditing/ICausationManager.ts","../auditing/index.ts","../compliance/ComplianceContracts.ts","../compliance/ComplianceMetadata.ts","../compliance/ComplianceMetadataResolver.ts","../compliance/ComplianceMetadataType.ts","../compliance/IPIIManager.ts","../compliance/PIIManager.ts","../compliance/PIINotSupportedOnEventSourceId.ts","../compliance/index.ts","../compliance/pii.ts","../compliance/subject.ts","../connection/ChronicleConnection.ts","../connection/ChronicleConnectionString.ts","../connection/ChronicleServerAddressResolver.ts","../connection/ChronicleServices.ts","../connection/ChronicleSrvResolutionError.ts","../connection/ChronicleSrvResolver.ts","../connection/ConnectionLifecycle.ts","../connection/DateTimeOffset.ts","../connection/Guid.ts","../connection/ILoadBalancerStrategy.ts","../connection/KernelKeepAlive.ts","../connection/LeastConnectionsLoadBalancerStrategy.ts","../connection/LoadBalancerMode.ts","../connection/LoadBalancerStrategyFactory.ts","../connection/RandomLoadBalancerStrategy.ts","../connection/RoundRobinLoadBalancerStrategy.ts","../connection/TokenProvider.ts","../connection/callResults.ts","../connection/fetchOAuthAccessToken.ts","../connection/formatServerAddress.ts","../connection/index.ts","../correlation/CorrelationId.ts","../correlation/CorrelationIdManager.ts","../correlation/ICorrelationIdAccessor.ts","../correlation/ICorrelationIdSetter.ts","../correlation/index.ts","../eventSequences/AppendError.ts","../eventSequences/AppendOperationsBroadcaster.ts","../eventSequences/AppendOptions.ts","../eventSequences/AppendResult.ts","../eventSequences/AppendedEventWithResult.ts","../eventSequences/CompleteStreamError.ts","../eventSequences/CompleteStreamResult.ts","../eventSequences/ConcurrencyScope.ts","../eventSequences/ConcurrencyViolation.ts","../eventSequences/ConstraintViolation.ts","../eventSequences/EventForEventSourceId.ts","../eventSequences/EventLog.ts","../eventSequences/EventSequence.ts","../eventSequences/EventSequenceId.ts","../eventSequences/EventSequenceNumber.ts","../eventSequences/IEventLog.ts","../eventSequences/IEventSequence.ts","../eventSequences/ITransactionalEventSequence.ts","../eventSequences/TransactionalEventSequence.ts","../eventSequences/WaitForCompletionResult.ts","../eventSequences/index.ts","../eventStoreSubscriptions/EventStoreSubscriptionBuilder.ts","../eventStoreSubscriptions/EventStoreSubscriptionDefinition.ts","../eventStoreSubscriptions/EventStoreSubscriptionId.ts","../eventStoreSubscriptions/EventStoreSubscriptions.ts","../eventStoreSubscriptions/IEventStoreSubscriptionBuilder.ts","../eventStoreSubscriptions/IEventStoreSubscriptions.ts","../eventStoreSubscriptions/contracts.ts","../eventStoreSubscriptions/index.ts","../events/AppendedEvent.ts","../events/CausationEntry.ts","../events/EventContext.ts","../events/EventType.ts","../events/EventTypeGeneration.ts","../events/EventTypeId.ts","../events/EventTypes.ts","../events/IEventTypes.ts","../events/Tag.ts","../events/eventTypeDecorator.ts","../events/filterEventsByTagDecorator.ts","../events/index.ts","../events/mergeTags.ts","../events/tagDecorator.ts","../events/constraints/ConstraintBuilder.ts","../events/constraints/ConstraintId.ts","../events/constraints/Constraints.ts","../events/constraints/IConstraint.ts","../events/constraints/IConstraintBuilder.ts","../events/constraints/IConstraints.ts","../events/constraints/IUniqueConstraintBuilder.ts","../events/constraints/UniqueConstraintBuilder.ts","../events/constraints/constraint.ts","../events/constraints/index.ts","../events/migrations/EventMigrationBuilder.ts","../events/migrations/EventMigrationPropertyBuilder.ts","../events/migrations/EventTypeMigrators.ts","../events/migrations/IEventMigrationBuilder.ts","../events/migrations/IEventMigrationPropertyBuilder.ts","../events/migrations/IEventTypeMigration.ts","../events/migrations/IEventTypeMigrators.ts","../events/migrations/InvalidMigrationGenerationGap.ts","../events/migrations/eventTypeMigration.ts","../events/migrations/index.ts","../externalServices/ExternalServiceBuilder.ts","../externalServices/ExternalServices.ts","../externalServices/ExternalServicesContracts.ts","../externalServices/IExternalServiceBuilder.ts","../externalServices/IExternalServices.ts","../externalServices/index.ts","../identities/IIdentityManager.ts","../identities/IdentityManager.ts","../identities/index.ts","../identity/IIdentityProvider.ts","../identity/Identity.ts","../identity/IdentityProvider.ts","../identity/index.ts","../jobs/IJobs.ts","../jobs/JobId.ts","../jobs/Jobs.ts","../jobs/index.ts","../observation/FailedPartition.ts","../observation/FailedPartitionAttempt.ts","../observation/FailedPartitions.ts","../observation/ICanBeNotifiedWhenPartitionReplayed.ts","../observation/ICanBeNotifiedWhenReplay.ts","../observation/IFailedPartitions.ts","../observation/ObserverId.ts","../observation/ObserverRunningState.ts","../observation/index.ts","../observation/notifyReplayLifecycle.ts","../observation/toClientFailedPartition.ts","../observation/toObserverRunningState.ts","../projections/IProjections.ts","../projections/ProjectionId.ts","../projections/ProjectionQueryResult.ts","../projections/ProjectionState.ts","../projections/Projections.ts","../projections/UnableToQueryProjection.ts","../projections/index.ts","../projections/declarative/AddBuilder.ts","../projections/declarative/AddChildBuilder.ts","../projections/declarative/AllSetBuilder.ts","../projections/declarative/ChildrenBuilder.ts","../projections/declarative/CompositeKeyBuilder.ts","../projections/declarative/FromBuilder.ts","../projections/declarative/FromEveryBuilder.ts","../projections/declarative/IAddBuilder.ts","../projections/declarative/IAddChildBuilder.ts","../projections/declarative/IAllSetBuilder.ts","../projections/declarative/IChildrenBuilder.ts","../projections/declarative/ICompositeKeyBuilder.ts","../projections/declarative/IFromBuilder.ts","../projections/declarative/IFromEveryBuilder.ts","../projections/declarative/IJoinBuilder.ts","../projections/declarative/INestedBuilder.ts","../projections/declarative/IProjectionBuilder.ts","../projections/declarative/IProjectionBuilderFor.ts","../projections/declarative/IProjectionFor.ts","../projections/declarative/IReadModelPropertiesBuilder.ts","../projections/declarative/IRemovedWithBuilder.ts","../projections/declarative/IRemovedWithJoinBuilder.ts","../projections/declarative/ISetBuilder.ts","../projections/declarative/ISubtractBuilder.ts","../projections/declarative/JoinBuilder.ts","../projections/declarative/NestedBuilder.ts","../projections/declarative/ProjectionBuilderCore.ts","../projections/declarative/ProjectionBuilderFor.ts","../projections/declarative/RemovedWithBuilder.ts","../projections/declarative/RemovedWithJoinBuilder.ts","../projections/declarative/SetBuilder.ts","../projections/declarative/SubtractBuilder.ts","../projections/declarative/index.ts","../projections/declarative/projection.ts","../projections/modelBound/FromEventMetadata.ts","../projections/modelBound/FromEventOptions.ts","../projections/modelBound/addFrom.ts","../projections/modelBound/childrenAndNestedBuilder.ts","../projections/modelBound/childrenFrom.ts","../projections/modelBound/clearWith.ts","../projections/modelBound/count.ts","../projections/modelBound/decrement.ts","../projections/modelBound/eventSequence.ts","../projections/modelBound/fromAll.ts","../projections/modelBound/fromEvent.ts","../projections/modelBound/fromEvery.ts","../projections/modelBound/increment.ts","../projections/modelBound/index.ts","../projections/modelBound/join.ts","../projections/modelBound/nested.ts","../projections/modelBound/noAutoMap.ts","../projections/modelBound/notRewindable.ts","../projections/modelBound/passive.ts","../projections/modelBound/removedWith.ts","../projections/modelBound/removedWithJoin.ts","../projections/modelBound/setFrom.ts","../projections/modelBound/setFromContext.ts","../projections/modelBound/setValue.ts","../projections/modelBound/subtractFrom.ts","../reactors/IReactors.ts","../reactors/ReactorId.ts","../reactors/ReactorSideEffects.ts","../reactors/Reactors.ts","../reactors/index.ts","../reactors/reactor.ts","../readModels/IMaterializedReadModels.ts","../readModels/IReadModels.ts","../readModels/MaterializedReadModels.ts","../readModels/ReadModelChangeset.ts","../readModels/ReadModelId.ts","../readModels/ReadModelSnapshot.ts","../readModels/ReadModelSubjectResolver.ts","../readModels/ReadModels.ts","../readModels/index.ts","../readModels/readModel.ts","../reducers/IReducers.ts","../reducers/ReducerId.ts","../reducers/Reducers.ts","../reducers/index.ts","../reducers/reducer.ts","../schemas/JsonSchema.ts","../schemas/JsonSchemaGenerator.ts","../schemas/index.ts","../schemas/jsonSchemaProperty.ts","../seeding/EventSeeding.ts","../seeding/ICanSeedEvents.ts","../seeding/IEventSeeding.ts","../seeding/IEventSeedingBuilder.ts","../seeding/IEventSeedingScopeBuilder.ts","../seeding/index.ts","../seeding/seeder.ts","../sinks/WellKnownSinks.ts","../sinks/index.ts","../transactions/IUnitOfWork.ts","../transactions/IUnitOfWorkManager.ts","../transactions/NoUnitOfWorkHasBeenStarted.ts","../transactions/UnitOfWork.ts","../transactions/UnitOfWorkManager.ts","../transactions/index.ts","../types/DecoratorType.ts","../types/TypeDiscoverer.ts","../types/TypeIntrospector.ts","../types/index.ts","../webhooks/IWebhook.ts","../webhooks/IWebhookDefinitionBuilder.ts","../webhooks/IWebhooks.ts","../webhooks/WebhookDefinitionBuilder.ts","../webhooks/WebhookId.ts","../webhooks/WebhookTargetUrl.ts","../webhooks/Webhooks.ts","../webhooks/index.ts","../webhooks/webhook.ts"],"version":"6.0.3"}

package/eventSequences/AppendOptions.ts

@@ -2,6 +2,7 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { Guid } from '@cratis/fundamentals';
+import type { Tag } from '../events/Tag';
 import type { ConcurrencyScope } from './ConcurrencyScope';
 
 /**
@@ -17,6 +18,14 @@ export interface AppendOptions {
     /** Optional concurrency scope to use for append operations. */
     concurrencyScope?: ConcurrencyScope;
 
+    /**
+     * Optional tags to associate with the event(s) being appended. These are combined with any
+     * static tags declared on the event type(s) via `@tag()`/`@tags()`, and - for the
+     * `appendMany(events: EventForEventSourceId[], options?)` overload - with any tags carried
+     * by the individual {@link EventForEventSourceId} entries.
+     */
+    tags?: ReadonlyArray<string | Tag>;
+
     /**
      * Optional per-event-source-id concurrency scopes, keyed by event source id.
      * Only meaningful for the `appendMany(events: EventForEventSourceId[], options?)` overload, which

package/eventSequences/EventForEventSourceId.ts

@@ -1,6 +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 { Tag } from '../events/Tag';
+
 /**
  * Represents an event paired with the event source identifier it belongs to.
  */
@@ -22,4 +24,11 @@ export interface EventForEventSourceId {
 
     /** Optional subject identifying the target the event is about. Defaults to the event source id. */
     readonly subject?: string;
+
+    /**
+     * Optional tags to associate with the event. These are combined with any static tags
+     * declared on the event type via `@tag()`/`@tags()`, and with any tags supplied at
+     * append time.
+     */
+    readonly tags?: ReadonlyArray<string | Tag>;
 }

package/eventSequences/EventSequence.ts

@@ -10,6 +10,9 @@ import type { AppendedEvent } from '../events/AppendedEvent';
 import { EventType } from '../events/EventType';
 import { EventTypeId } from '../events/EventTypeId';
 import { EventTypeGeneration } from '../events/EventTypeGeneration';
+import { Tag } from '../events/Tag';
+import { getTagsFor } from '../events/tagDecorator';
+import { mergeTags } from '../events/mergeTags';
 import { DecoratorType } from '../types/DecoratorType';
 import { TypeDiscoverer } from '../types/TypeDiscoverer';
 import { toClientFailedPartition } from '../observation/toClientFailedPartition';
@@ -66,6 +69,9 @@ export class EventSequence implements IEventSequence {
             : Guid.as(options.correlationId);
         const content = JsonSerializer.serialize(event);
 
+        // Merge static tags declared on the event type with tags supplied at append time.
+        const tags = mergeTags(getTagsFor(event.constructor as Function), options?.tags);
+
         causationManager.add(CausationType.appendEvent, { eventType: eventType.id.value });
         const causationChain = causationManager.getCurrentChain();
         const identity = identityProvider.getCurrent();
@@ -108,7 +114,7 @@ export class EventSequence implements IEventSequence {
                     })),
                     CausedBy: toContractsCausedBy(identity),
                     ConcurrencyScope: this.toContractConcurrencyScope(options?.concurrencyScope),
-                    Tags: [],
+                    Tags: tags,
                     Occurred: undefined,
                     Subject: eventSourceId
                 });
@@ -149,7 +155,8 @@ export class EventSequence implements IEventSequence {
                                 eventType,
                                 occurred: new Date(),
                                 correlationId: correlationId.toString(),
-                                causation: causationChain.map(c => ({ type: c.type.name, properties: { ...c.properties } }))
+                                causation: causationChain.map(c => ({ type: c.type.name, properties: { ...c.properties } })),
+                                tags: tags.map(value => new Tag(value))
                             },
                             eventType,
                             content: event as Record<string, unknown>
@@ -223,8 +230,13 @@ export class EventSequence implements IEventSequence {
         const resolveConcurrencyScope = (eventSourceId: string) =>
             this.toContractConcurrencyScope(concurrencyScopesByEventSourceId?.[eventSourceId] ?? defaultConcurrencyScope);
 
-        const eventsToAppend = eventsForEventSourceIds.map(({ eventSourceId, event, eventStreamType, eventStreamId, eventSourceType, subject }) => {
+        const eventsToAppend = eventsForEventSourceIds.map(({ eventSourceId, event, eventStreamType, eventStreamId, eventSourceType, subject, tags: instanceTags }) => {
             const eventType = getEventTypeFor(event.constructor as Function);
+
+            // Merge static tags declared on the event type, tags carried by this specific
+            // EventForEventSourceId entry, and tags supplied at call time for the whole batch.
+            const tags = mergeTags(getTagsFor(event.constructor as Function), instanceTags, appendOptions?.tags);
+
             return {
                 EventSourceType: eventSourceType ?? 'Default',
                 EventSourceId: eventSourceId,
@@ -242,7 +254,7 @@ export class EventSequence implements IEventSequence {
                     Properties: { ...c.properties }
                 })),
                 CausedBy: toContractsCausedBy(identity),
-                Tags: [],
+                Tags: tags,
                 Occurred: undefined,
                 Subject: subject ?? eventSourceId
             };
@@ -334,7 +346,8 @@ export class EventSequence implements IEventSequence {
                                     eventType,
                                     occurred: occurredAt,
                                     correlationId: correlationId.toString(),
-                                    causation: causationEntries
+                                    causation: causationEntries,
+                                    tags: eventsToAppend[index].Tags.map(value => new Tag(value))
                                 },
                                 eventType,
                                 content: event as Record<string, unknown>
@@ -687,7 +700,8 @@ export class EventSequence implements IEventSequence {
                 causation: (context.Causation ?? []).map(c => ({
                     type: c.Type,
                     properties: { ...c.Properties }
-                }))
+                })),
+                tags: (context.Tags ?? []).map(value => new Tag(value))
             },
             eventType,
             content: JSON.parse(wireEvent.Content) as Record<string, unknown>

package/events/EventContext.ts

@@ -3,6 +3,7 @@
 
 import { EventType } from './EventType';
 import { CausationEntry } from './CausationEntry';
+import { Tag } from './Tag';
 
 /**
  * Represents contextual information about an appended event.
@@ -25,4 +26,7 @@ export interface EventContext {
 
     /** The causation chain for the event. */
     readonly causation: ReadonlyArray<CausationEntry>;
+
+    /** The tags the event carries. */
+    readonly tags: ReadonlyArray<Tag>;
 }

package/events/Tag.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Represents a tag associated with an event, observer, or read model.
+ */
+export class Tag {
+    constructor(readonly value: string) {}
+
+    /** @inheritdoc */
+    toString(): string {
+        return this.value;
+    }
+}

package/events/constraints/Constraints.ts

@@ -60,7 +60,7 @@ export class Constraints implements IConstraints {
                 return {
                     Name: capture.name,
                     Type: ConstraintType.Unique,
-                    RemovedWith: uc.removedWithEventTypeId ?? '',
+                    RemovedWith: uc.removedWithEventTypeId ? [uc.removedWithEventTypeId] : [],
                     Definition: {
                         Value0: {
                             EventDefinitions: uc.eventDefinitions.map(ed => ({
@@ -80,7 +80,7 @@ export class Constraints implements IConstraints {
                 return {
                     Name: uet.name ?? capture.name,
                     Type: ConstraintType.UniqueEventType,
-                    RemovedWith: '',
+                    RemovedWith: [],
                     Definition: {
                         Value0: undefined,
                         Value1: {
@@ -94,7 +94,7 @@ export class Constraints implements IConstraints {
             return {
                 Name: capture.name,
                 Type: ConstraintType.Unknown,
-                RemovedWith: '',
+                RemovedWith: [],
                 Definition: undefined,
                 Scope: scope
             };

package/events/filterEventsByTagDecorator.ts

@@ -0,0 +1,51 @@
+// 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 { Tag } from './Tag';
+import { mergeTags } from './mergeTags';
+
+/** Metadata key used to store the tags a reactor or reducer filters events by. */
+const FILTER_TAGS_METADATA_KEY = 'chronicle:filterEventsByTag';
+
+/**
+ * TypeScript decorator that restricts a reactor or reducer so that it only handles events
+ * that carry a specific tag. This is the TypeScript equivalent of the C# `[FilterEventsByTag]`
+ * attribute.
+ *
+ * Apply this decorator to a `@reactor()` or `@reducer()`-decorated class to filter the observed
+ * event stream to events tagged with the given value. Use {@link tag}/{@link tags} when the
+ * intent is to *label* an observer for discoverability; use this decorator when the intent is
+ * to *filter* which events reach it. Applying the decorator more than once accumulates filter
+ * tags - a class handles events carrying any of the applied tags.
+ *
+ * @param value - The tag value that an event must carry in order to be dispatched to the observer.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @reactor()
+ * @filterEventsByTag('vip')
+ * class VipWelcomeReactor {
+ *     async customerRegistered(event: CustomerRegistered): Promise<void> {
+ *         console.log(`Welcome VIP customer ${event.emailAddress}`);
+ *     }
+ * }
+ * ```
+ */
+export function filterEventsByTag(value: string): ClassDecorator {
+    return (target: object) => {
+        const existing = (Reflect.getMetadata(FILTER_TAGS_METADATA_KEY, target) as Tag[] | undefined) ?? [];
+        const merged = mergeTags(existing, [value]).map(tagValue => new Tag(tagValue));
+        Reflect.defineMetadata(FILTER_TAGS_METADATA_KEY, merged, target);
+    };
+}
+
+/**
+ * Gets all filter tags applied to a class via {@link filterEventsByTag}.
+ * @param target - The class constructor to retrieve filter tags for.
+ * @returns The filter tags applied to the class, or an empty array if none are.
+ */
+export function getFilterTagsFor(target: Function): Tag[] {
+    return (Reflect.getMetadata(FILTER_TAGS_METADATA_KEY, target) as Tag[] | undefined) ?? [];
+}

package/events/index.ts

@@ -11,5 +11,9 @@ export type { CausationEntry } from './CausationEntry';
 export type { AppendedEvent } from './AppendedEvent';
 export type { IEventTypes } from './IEventTypes';
 export { EventTypes } from './EventTypes';
+export { Tag } from './Tag';
+export { tag, tags, getTagsFor } from './tagDecorator';
+export { filterEventsByTag, getFilterTagsFor } from './filterEventsByTagDecorator';
+export { mergeTags } from './mergeTags';
 export * from './constraints';
 export * from './migrations';

package/events/mergeTags.spec.ts

@@ -0,0 +1,50 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, expect, it } from 'vitest';
+import { Tag } from './Tag';
+import { mergeTags } from './mergeTags';
+
+describe('mergeTags', () => {
+    describe('when merging a single source of strings', () => {
+        it('should return the values unchanged', () => {
+            expect(mergeTags(['a', 'b'])).toEqual(['a', 'b']);
+        });
+    });
+
+    describe('when merging several sources', () => {
+        it('should combine them in order', () => {
+            expect(mergeTags(['a'], ['b'], ['c'])).toEqual(['a', 'b', 'c']);
+        });
+    });
+
+    describe('when the same value appears in more than one source', () => {
+        it('should keep only the first occurrence', () => {
+            expect(mergeTags(['a', 'b'], ['b', 'c'])).toEqual(['a', 'b', 'c']);
+        });
+    });
+
+    describe('when a source holds Tag instances', () => {
+        it('should unwrap them to their values', () => {
+            expect(mergeTags([new Tag('a')], ['b'])).toEqual(['a', 'b']);
+        });
+    });
+
+    describe('when a source is undefined', () => {
+        it('should skip it', () => {
+            expect(mergeTags(['a'], undefined, ['b'])).toEqual(['a', 'b']);
+        });
+    });
+
+    describe('when a value is blank', () => {
+        it('should drop it, so an empty tag never reaches the wire', () => {
+            expect(mergeTags(['a', '', '   '])).toEqual(['a']);
+        });
+    });
+
+    describe('when there are no sources at all', () => {
+        it('should return an empty list', () => {
+            expect(mergeTags()).toEqual([]);
+        });
+    });
+});

package/events/mergeTags.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Tag } from './Tag';
+
+/**
+ * Merges one or more sources of tags - static tags declared on a type, tags carried by an
+ * individual event instance, and tags supplied at call time - into a single, distinct list of
+ * tag values. Mirrors the .NET client, which merges static, instance, and dynamic tags the
+ * same way before sending an append request.
+ * @param sources - The tag sources to merge. Each may be a mix of strings and {@link Tag} instances,
+ * or undefined when that source contributed no tags.
+ * @returns The distinct, merged tag values.
+ */
+export function mergeTags(...sources: ReadonlyArray<Iterable<string | Tag> | undefined>): string[] {
+    const values = new Set<string>();
+    for (const source of sources) {
+        if (!source) continue;
+        for (const entry of source) {
+            const value = typeof entry === 'string' ? entry : entry.value;
+            if (value.trim().length > 0) {
+                values.add(value);
+            }
+        }
+    }
+    return [...values];
+}

package/events/tagDecorator.spec.ts

@@ -0,0 +1,115 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, expect, it } from 'vitest';
+import { getTagsFor, tag, tags } from './tagDecorator';
+import { filterEventsByTag, getFilterTagsFor } from './filterEventsByTagDecorator';
+
+describe('tag', () => {
+    describe('when a class carries no tags', () => {
+        class Untagged {}
+
+        it('should report no tags', () => {
+            expect(getTagsFor(Untagged)).toEqual([]);
+        });
+    });
+
+    describe('when decorating a class with a single tag', () => {
+        class SingleTagged {}
+        tag('analytics')(SingleTagged);
+
+        it('should carry that tag', () => {
+            expect(getTagsFor(SingleTagged).map(_ => _.value)).toEqual(['analytics']);
+        });
+    });
+
+    describe('when decorating a class with several tags at once', () => {
+        class MultiTagged {}
+        tag('analytics', 'user-action')(MultiTagged);
+
+        it('should carry every tag', () => {
+            expect(getTagsFor(MultiTagged).map(_ => _.value)).toEqual(['analytics', 'user-action']);
+        });
+    });
+
+    describe('when applying the decorator more than once', () => {
+        class Accumulated {}
+        tag('first')(Accumulated);
+        tag('second')(Accumulated);
+
+        it('should accumulate rather than replace', () => {
+            expect(getTagsFor(Accumulated).map(_ => _.value)).toEqual(['first', 'second']);
+        });
+    });
+
+    describe('when the same tag is applied twice', () => {
+        class Duplicated {}
+        tag('same')(Duplicated);
+        tag('same')(Duplicated);
+
+        it('should keep it once', () => {
+            expect(getTagsFor(Duplicated).map(_ => _.value)).toEqual(['same']);
+        });
+    });
+
+    describe('when using the plural tags decorator', () => {
+        class PluralTagged {}
+        tags('a', 'b')(PluralTagged);
+
+        it('should behave identically to tag', () => {
+            expect(getTagsFor(PluralTagged).map(_ => _.value)).toEqual(['a', 'b']);
+        });
+    });
+
+    describe('when two classes are tagged separately', () => {
+        class FirstTagged {}
+        class SecondTagged {}
+        tag('one')(FirstTagged);
+        tag('two')(SecondTagged);
+
+        it('should not leak tags between them', () => {
+            expect(getTagsFor(FirstTagged).map(_ => _.value)).toEqual(['one']);
+            expect(getTagsFor(SecondTagged).map(_ => _.value)).toEqual(['two']);
+        });
+    });
+});
+
+describe('filterEventsByTag', () => {
+    describe('when a class carries no filter', () => {
+        class Unfiltered {}
+
+        it('should report no filter tags', () => {
+            expect(getFilterTagsFor(Unfiltered)).toEqual([]);
+        });
+    });
+
+    describe('when decorating a class with a filter tag', () => {
+        class Filtered {}
+        filterEventsByTag('vip')(Filtered);
+
+        it('should carry that filter tag', () => {
+            expect(getFilterTagsFor(Filtered).map(_ => _.value)).toEqual(['vip']);
+        });
+    });
+
+    describe('when applying the decorator more than once', () => {
+        class MultiFiltered {}
+        filterEventsByTag('vip')(MultiFiltered);
+        filterEventsByTag('premium')(MultiFiltered);
+
+        it('should accumulate, so the observer handles events carrying any of them', () => {
+            expect(getFilterTagsFor(MultiFiltered).map(_ => _.value)).toEqual(['vip', 'premium']);
+        });
+    });
+
+    describe('when a class is both labeled and filtered', () => {
+        class LabeledAndFiltered {}
+        tag('reporting')(LabeledAndFiltered);
+        filterEventsByTag('vip')(LabeledAndFiltered);
+
+        it('should keep labeling and filtering separate', () => {
+            expect(getTagsFor(LabeledAndFiltered).map(_ => _.value)).toEqual(['reporting']);
+            expect(getFilterTagsFor(LabeledAndFiltered).map(_ => _.value)).toEqual(['vip']);
+        });
+    });
+});

package/events/tagDecorator.ts

@@ -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 { Tag } from './Tag';
+import { mergeTags } from './mergeTags';
+
+/** Metadata key used to store the tags labeling a class. */
+const TAGS_METADATA_KEY = 'chronicle:tags';
+
+/**
+ * TypeScript decorator that labels an event type, reactor, or reducer with one or more tags.
+ * This is the TypeScript equivalent of the C# `[Tag]` attribute.
+ *
+ * Applying the decorator more than once accumulates tags rather than replacing them, so
+ * `@tag('a')` followed by `@tag('b')` on the same class results in both `'a'` and `'b'`.
+ *
+ * @param values - The tags to apply.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @eventType()
+ * @tag('analytics', 'user-action')
+ * class UserLoggedIn {
+ *     constructor(readonly userId: string) {}
+ * }
+ * ```
+ */
+export function tag(...values: string[]): ClassDecorator {
+    return (target: object) => addTags(target, values);
+}
+
+/**
+ * TypeScript decorator that labels an event type, reactor, or reducer with one or more tags.
+ * This is the TypeScript equivalent of the C# `[Tags]` attribute, and behaves identically to
+ * {@link tag} - use whichever reads more naturally at the call site.
+ *
+ * @param values - The tags to apply.
+ * @returns A class decorator.
+ */
+export function tags(...values: string[]): ClassDecorator {
+    return (target: object) => addTags(target, values);
+}
+
+function addTags(target: object, values: string[]): void {
+    const existing = (Reflect.getMetadata(TAGS_METADATA_KEY, target) as Tag[] | undefined) ?? [];
+    const merged = mergeTags(existing, values).map(value => new Tag(value));
+    Reflect.defineMetadata(TAGS_METADATA_KEY, merged, target);
+}
+
+/**
+ * Gets all tags applied to a class via {@link tag} or {@link tags}.
+ * @param target - The class constructor to retrieve tags for.
+ * @returns The tags applied to the class, or an empty array if none are.
+ */
+export function getTagsFor(target: Function): Tag[] {
+    return (Reflect.getMetadata(TAGS_METADATA_KEY, target) as Tag[] | undefined) ?? [];
+}

package/jobs/IJobs.ts

@@ -2,7 +2,7 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { Guid } from '@cratis/fundamentals';
-import type { Job, JobStep } from '@cratis/chronicle.contracts';
+import type { JobSummaryResponse, JobStepSummaryResponse } from '@cratis/chronicle.contracts';
 import { JobId } from './JobId';
 
 /**
@@ -32,18 +32,18 @@ export interface IJobs {
      * @param jobId - The job identifier.
      * @returns The job, or undefined when not found.
      */
-    getJob(jobId: JobId | Guid | string): Promise<Job | undefined>;
+    getJob(jobId: JobId | Guid | string): Promise<JobSummaryResponse | undefined>;
 
     /**
      * Gets all jobs for the event store namespace.
      * @returns All jobs.
      */
-    getJobs(): Promise<Job[]>;
+    getJobs(): Promise<JobSummaryResponse[]>;
 
     /**
      * Gets all steps for a specific job.
      * @param jobId - The job identifier.
      * @returns The job steps.
      */
-    getJobSteps(jobId: JobId | Guid | string): Promise<JobStep[]>;
+    getJobSteps(jobId: JobId | Guid | string): Promise<JobStepSummaryResponse[]>;
 }