@cratis/chronicle 3.0.0 → 3.1.1

package/dist/eventSequences/CompleteStreamError.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Represents the errors that can occur when completing a stream on an {@link IEventSequence}.
+ */
+export declare enum CompleteStreamError {
+    /**
+     * The stream was already completed previously. Completing a stream is idempotent at the storage
+     * level, but the caller is informed via this error so it can distinguish a freshly completed
+     * stream from one that was already in the completed state.
+     */
+    AlreadyCompleted = "AlreadyCompleted",
+    /**
+     * The default stream (the default event stream type paired with the default event stream identifier)
+     * cannot be completed, since doing so would block all future appends to the event sequence.
+     */
+    DefaultStreamCannotBeCompleted = "DefaultStreamCannotBeCompleted"
+}
+//# sourceMappingURL=CompleteStreamError.d.ts.map

package/dist/eventSequences/CompleteStreamError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompleteStreamError.d.ts","sourceRoot":"","sources":["../../eventSequences/CompleteStreamError.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,oBAAY,mBAAmB;IAC3B;;;;OAIG;IACH,gBAAgB,qBAAqB;IAErC;;;OAGG;IACH,8BAA8B,mCAAmC;CACpE"}

package/dist/eventSequences/CompleteStreamError.js

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the errors that can occur when completing a stream on an {@link IEventSequence}.
+ */
+export var CompleteStreamError;
+(function (CompleteStreamError) {
+    /**
+     * The stream was already completed previously. Completing a stream is idempotent at the storage
+     * level, but the caller is informed via this error so it can distinguish a freshly completed
+     * stream from one that was already in the completed state.
+     */
+    CompleteStreamError["AlreadyCompleted"] = "AlreadyCompleted";
+    /**
+     * The default stream (the default event stream type paired with the default event stream identifier)
+     * cannot be completed, since doing so would block all future appends to the event sequence.
+     */
+    CompleteStreamError["DefaultStreamCannotBeCompleted"] = "DefaultStreamCannotBeCompleted";
+})(CompleteStreamError || (CompleteStreamError = {}));
+//# sourceMappingURL=CompleteStreamError.js.map

package/dist/eventSequences/CompleteStreamError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompleteStreamError.js","sourceRoot":"","sources":["../../eventSequences/CompleteStreamError.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,CAAN,IAAY,mBAaX;AAbD,WAAY,mBAAmB;IAC3B;;;;OAIG;IACH,4DAAqC,CAAA;IAErC;;;OAGG;IACH,wFAAiE,CAAA;AACrE,CAAC,EAbW,mBAAmB,KAAnB,mBAAmB,QAa9B"}

package/dist/eventSequences/CompleteStreamResult.d.ts

@@ -0,0 +1,14 @@
+import { CompleteStreamError } from './CompleteStreamError';
+import { EventSequenceNumber } from './EventSequenceNumber';
+/**
+ * Represents the outcome of completing a stream on an {@link IEventSequence}: either the tail
+ * sequence number at the moment of completion, or a typed error describing why it was rejected.
+ */
+export type CompleteStreamResult = {
+    readonly isSuccess: true;
+    readonly sequenceNumber: EventSequenceNumber;
+} | {
+    readonly isSuccess: false;
+    readonly error: CompleteStreamError;
+};
+//# sourceMappingURL=CompleteStreamResult.d.ts.map

package/dist/eventSequences/CompleteStreamResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompleteStreamResult.d.ts","sourceRoot":"","sources":["../../eventSequences/CompleteStreamResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC1B;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC"}

package/dist/eventSequences/CompleteStreamResult.js

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

package/dist/eventSequences/CompleteStreamResult.js.map

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

package/dist/eventSequences/ConcurrencyViolation.d.ts

@@ -0,0 +1,13 @@
+import { EventSequenceNumber } from './EventSequenceNumber';
+/**
+ * Represents a concurrency violation that occurred during an append operation.
+ */
+export interface ConcurrencyViolation {
+    /** The event source identifier where the violation occurred. */
+    readonly eventSourceId: string;
+    /** The expected sequence number. */
+    readonly expectedSequenceNumber: EventSequenceNumber;
+    /** The actual sequence number. */
+    readonly actualSequenceNumber: EventSequenceNumber;
+}
+//# sourceMappingURL=ConcurrencyViolation.d.ts.map

package/dist/eventSequences/ConcurrencyViolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyViolation.d.ts","sourceRoot":"","sources":["../../eventSequences/ConcurrencyViolation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,oCAAoC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;IAErD,kCAAkC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;CACtD"}

package/dist/eventSequences/ConcurrencyViolation.js

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

package/dist/eventSequences/ConcurrencyViolation.js.map

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

package/dist/eventSequences/EventForEventSourceId.d.ts

@@ -6,5 +6,13 @@ export interface EventForEventSourceId {
     readonly eventSourceId: string;
     /** The event payload to append. */
     readonly event: object;
+    /** Optional event stream type to append to. Defaults to the default stream type. */
+    readonly eventStreamType?: string;
+    /** Optional event stream identifier to append to. Defaults to the event source id. */
+    readonly eventStreamId?: string;
+    /** Optional event source type to append to. Defaults to the default source type. */
+    readonly eventSourceType?: string;
+    /** Optional subject identifying the target the event is about. Defaults to the event source id. */
+    readonly subject?: string;
 }
 //# sourceMappingURL=EventForEventSourceId.d.ts.map

package/dist/eventSequences/EventForEventSourceId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventForEventSourceId.d.ts","sourceRoot":"","sources":["../../eventSequences/EventForEventSourceId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"EventForEventSourceId.d.ts","sourceRoot":"","sources":["../../eventSequences/EventForEventSourceId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,oFAAoF;IACpF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,sFAAsF;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,oFAAoF;IACpF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,mGAAmG;IACnG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/eventSequences/EventSequence.d.ts

@@ -1,6 +1,11 @@
 import { ChronicleConnection } from '../connection';
+import { Constructor } from '@cratis/fundamentals';
+import type { AppendedEvent } from '../events/AppendedEvent';
+import { AppendedEventWithResult } from './AppendedEventWithResult';
+import { AppendOperationsBroadcaster } from './AppendOperationsBroadcaster';
 import { AppendOptions } from './AppendOptions';
 import { AppendResult } from './AppendResult';
+import { CompleteStreamResult } from './CompleteStreamResult';
 import { EventForEventSourceId } from './EventForEventSourceId';
 import { IEventSequence } from './IEventSequence';
 import { ITransactionalEventSequence } from './ITransactionalEventSequence';
@@ -18,6 +23,7 @@ export declare class EventSequence implements IEventSequence {
     private readonly _connection;
     private readonly _unitOfWorkManager;
     readonly transactional: ITransactionalEventSequence;
+    readonly appendOperations: AppendOperationsBroadcaster<AppendedEventWithResult[]>;
     constructor(id: EventSequenceId, _eventStoreName: string, _namespace: string, _connection: ChronicleConnection, _unitOfWorkManager: IUnitOfWorkManager);
     /** @inheritdoc */
     append(eventSourceId: string, event: object, options?: AppendOptions): Promise<AppendResult>;
@@ -25,10 +31,38 @@ export declare class EventSequence implements IEventSequence {
     appendMany(eventSourceId: string, events: object[], options?: AppendOptions): Promise<AppendResult[]>;
     appendMany(events: EventForEventSourceId[], options?: AppendOptions): Promise<AppendResult[]>;
     /** @inheritdoc */
-    getTailSequenceNumber(eventSourceId?: string): Promise<EventSequenceNumber>;
+    getNextSequenceNumber(): Promise<EventSequenceNumber>;
+    /** @inheritdoc */
+    getTailSequenceNumber(eventSourceId?: string, eventSourceType?: string, eventStreamType?: string, eventStreamId?: string, filterEventTypes?: Constructor[]): Promise<EventSequenceNumber>;
+    /** @inheritdoc */
+    getTailSequenceNumberForObserver(observerType: Constructor): Promise<EventSequenceNumber>;
     /** @inheritdoc */
     hasEventsFor(eventSourceId: string): Promise<boolean>;
+    /** @inheritdoc */
+    getForEventSourceIdAndEventTypes(eventSourceId: string, eventTypes: Constructor[], eventStreamType?: string, eventStreamId?: string, eventSourceType?: string): Promise<AppendedEvent[]>;
+    /** @inheritdoc */
+    getFromSequenceNumber(sequenceNumber: EventSequenceNumber, eventSourceId?: string, filterEventTypes?: Constructor[]): Promise<AppendedEvent[]>;
+    /** @inheritdoc */
+    redact(sequenceNumber: EventSequenceNumber, reason: string): Promise<void>;
+    /** @inheritdoc */
+    redactForEventSource(eventSourceId: string, reason: string, eventTypes?: Constructor[]): Promise<void>;
+    /**
+     * Resolves which registered event type classes a given observer (reactor/reducer) type handles,
+     * using the same naming convention the observation runtimes use to dispatch events to handler
+     * methods: an event type named `SomethingHappened` dispatches to a method named `somethingHappened`.
+     */
+    private getEventTypesHandledBy;
+    /** @inheritdoc */
+    completeStream(eventStreamType: string, eventStreamId: string): Promise<CompleteStreamResult>;
+    private toClientCompleteStreamError;
+    private toContractEventTypes;
+    private toClientAppendedEvent;
     private mapAppendResponse;
+    /**
+     * Waits for all observers affected by an append to either process up to the given tail sequence
+     * number or fail. Backs {@link AppendResult.waitForCompletion}.
+     */
+    private waitForObserverCompletion;
     private toContractConcurrencyScope;
 }
 //# sourceMappingURL=EventSequence.d.ts.map

package/dist/eventSequences/EventSequence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventSequence.d.ts","sourceRoot":"","sources":["../../eventSequences/EventSequence.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAIpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAS5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE;;;GAGG;AACH,qBAAa,aAAc,YAAW,cAAc;IAI5C,QAAQ,CAAC,EAAE,EAAE,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAPvC,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;gBAGvC,EAAE,EAAE,eAAe,EACX,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,mBAAmB,EAChC,kBAAkB,EAAE,kBAAkB;IAK3D,kBAAkB;IACZ,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA+FlG,kBAAkB;IACZ,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACrG,UAAU,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmJnG,kBAAkB;IACZ,qBAAqB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkCjF,kBAAkB;IACZ,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B3D,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,0BAA0B;CAcrC"}
+{"version":3,"file":"EventSequence.d.ts","sourceRoot":"","sources":["../../eventSequences/EventSequence.ts"],"names":[],"mappings":"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"}