effect-cqrs 0.1.0 → 0.2.0

package/README.md

@@ -89,6 +89,19 @@ event, several, or `[]` to record nothing. It can use services, fail with typed
 errors, and may run more than once, so it should only decide. Projections and
 handlers must not mutate the state, which is kept between commands.
 
+When an event's schema changes, the stored events keep their old shape. The aggregate
+declares the older shapes and how each becomes the next, and they are upcast as they
+are read:
+
+```ts
+const Todo = Aggregate.make<TodoState>()({
+  // ...
+  versions: {
+    TodoCreated: EventVersions.from(TodoCreatedV1).next(TodoEvent.cases.TodoCreated, (v1) => ({ ...v1, dueDate: null }))
+  }
+})
+```
+
 ## Run commands
 
 ```ts
@@ -116,7 +129,18 @@ state and decides again, up to `maxRetries` times (5 by default), then fails wit
 `ConcurrencyConflict`.
 
 The service remembers the state of recent aggregates (`stateCacheSize`, 10,000 by
-default), so a command only reads the events it hasn't seen.
+default), so a command only reads the events it hasn't seen. With
+`snapshots: { every, schema, version }` it also saves states through a `KeyValueStore`
+from `effect/persistence`, so a restart replays only what came after the last one.
+
+Every event records a `correlationId` and a `causationId`. A command a view model runs
+gets the handled event as its cause, so a chain of reactions can be traced back to the
+request that started it. `Causation.withCausation` sets the ids from outside.
+
+Commands can also carry metadata, a JSON object for what the domain doesn't decide on,
+such as the software version or the user who sent them. It is recorded on every event they
+write. `Metadata.layer({ appVersion })` sets it for the whole application and
+`Metadata.withMetadata` adds to it per request.
 
 ## Project into view models
 
@@ -203,6 +227,10 @@ it.effect("rejects deleting twice", () =>
   library works.
 - Yielding the chain gives `{ events, state, version, fixture }` for the last
   command, if you prefer plain assertions.
+- `givenEvents` also takes events in an older schema version, built with
+  `Aggregate.historical(Todo, "TodoCreated", 1, { ... })`, to test upcasting.
+- `checkInvariants({ invariant })` runs random command sequences generated from the
+  payload schemas and reports the shortest one that breaks the predicate.
 
 `it.effect` runs on a test clock stopped at zero, so timestamps need no mocking: an
 event created by `DateTime.now` has `DateTime.makeUnsafe(0)` until
@@ -292,8 +320,8 @@ store, so `replay` is for rebuilding, not for recovery.
   point to wire into your own HTTP or RPC layer.
 - **SQLite, PostgreSQL and memory only.** There are no adapters for MongoDB or MySQL.
 - **No code generator.** There is no equivalent of `cqrs generate`.
-- **No persistent snapshots.** Recent state is only kept in memory, so after a restart
-  each stream is replayed the first time it is used, at a cost that grows with its
-  length.
-- **No schema migration.** A stored event that no longer decodes fails with
-  `EventDecodeError`, so evolve event schemas compatibly.
+- **Snapshots are opt-in.** Without `snapshots`, recent state is only kept in memory, so
+  after a restart each stream is replayed the first time it is used. A changed state
+  needs a new snapshot `version` by hand.
+- **Event upcasts are pure.** Older event shapes declared with `EventVersions` are
+  upcast on read, but an upcast can't read a service or fail with its own error.

package/dist/Aggregate.d.ts

@@ -5,7 +5,8 @@
  * An aggregate is plain data. {@link AggregateService} gives it a store to run
  * against, and `Fixture` runs it in tests.
  */
-import type { DateTime, Effect, Schema } from "effect";
+import { type DateTime, type Effect, Schema } from "effect";
+import * as EventVersions from "./EventVersions.ts";
 export interface Tagged {
     readonly _tag: string;
 }
@@ -25,6 +26,12 @@ export interface EventMeta {
     readonly version: number;
     readonly position: number;
     readonly timestamp: DateTime.Utc;
+    /** Shared by everything that follows from one original request, see `Causation`. */
+    readonly correlationId: string | null;
+    /** What directly caused the command that recorded the event. */
+    readonly causationId: string | null;
+    /** What the command carried beside its payload, such as the software version, see `Metadata`. */
+    readonly metadata: Schema.JsonObject;
 }
 export interface CommandContext {
     readonly aggregateId: string;
@@ -50,19 +57,29 @@ export interface AnyCommand {
     readonly payload: PayloadSchema;
     readonly handler: CommandHandler<any, any, any, any, any>;
 }
-export interface Aggregate<Name extends string, State, Events extends EventSchema<any>, Commands extends Record<string, AnyCommand>> {
+/**
+ * The older shapes of some events, keyed by tag. Each history has to end in the
+ * event's current shape.
+ */
+export type Versions<Event extends Tagged> = {
+    readonly [Tag in Event["_tag"]]?: EventVersions.Any<Extract<Event, {
+        readonly _tag: Tag;
+    }>>;
+};
+export interface Aggregate<Name extends string, State, Events extends EventSchema<any>, Commands extends Record<string, AnyCommand>, V extends Versions<Events["Type"]> = {}> {
     readonly name: Name;
     readonly events: Events;
     readonly initial: State;
     readonly projection: Projection<State, Events["Type"]>;
     readonly commands: Commands;
+    readonly versions: V;
     /** Returns a new aggregate that also accepts this command. */
     command<const CommandName extends string, Payload extends PayloadSchema, E = never, R = never>(name: CommandName, options: {
         readonly payload: Payload;
         readonly handler: CommandHandler<State, Payload["Type"], Events["Type"], E, R>;
-    }): Aggregate<Name, State, Events, Commands & Record<CommandName, Command<Payload, State, Events["Type"], E, R>>>;
+    }): Aggregate<Name, State, Events, Commands & Record<CommandName, Command<Payload, State, Events["Type"], E, R>>, V>;
 }
-export type Any = Aggregate<string, any, EventSchema<any>, Record<string, AnyCommand>>;
+export type Any = Aggregate<string, any, EventSchema<any>, Record<string, AnyCommand>, any>;
 export type Name<A extends Any> = A["name"];
 export type State<A extends Any> = A["initial"];
 export type Event<A extends Any> = A["events"]["Type"];
@@ -75,12 +92,36 @@ export type Context<A extends Any> = A["commands"][CommandName<A>] extends Comma
  * The state is given explicitly, `Aggregate.make<State>()({ ... })`, so that the
  * projection's return values are checked against it rather than widened.
  */
-export declare const make: <State>() => <const Name extends string, Events extends EventSchema<any>>(options: {
+export declare const make: <State>() => <const Name extends string, Events extends EventSchema<any>, const V extends Versions<Events["Type"]> = {}>(options: {
     readonly name: Name;
     readonly events: Events;
     readonly initial: State;
     readonly projection: Projection<State, Events["Type"]>;
-}) => Aggregate<Name, State, Events, {}>;
+    /** Older shapes of events already in the store, see `EventVersions`. */
+    readonly versions?: V | undefined;
+}) => Aggregate<Name, State, Events, {}, V>;
 /** Folds one event into the state. */
 export declare const evolve: <A extends Any>(aggregate: A, state: State<A>, event: Event<A>, meta: EventMeta) => State<A>;
+/** The schema version new events with this tag are written with. */
+export declare const schemaVersion: (aggregate: Any, tag: string) => number;
+/**
+ * An event as it was stored in the past, in an older version of its schema.
+ * Construct one directly to replay JSON taken from a database.
+ */
+export declare class Historical {
+    readonly type: string;
+    readonly schemaVersion: number;
+    readonly payload: Schema.Json;
+    constructor(options: {
+        readonly type: string;
+        readonly schemaVersion: number;
+        readonly payload: Schema.Json;
+    });
+}
+/**
+ * Encodes an event in an older version of its schema, as code from that time
+ * would have stored it. The value is checked against that version, so a test
+ * can't seed a shape that never existed.
+ */
+export declare const historical: <A extends Any, const Tag extends keyof A["versions"] & string, const Version extends number>(aggregate: A, tag: Tag, version: Version, value: EventVersions.SchemaAt<NonNullable<A["versions"][Tag]>, Version>["Type"]) => Historical;
 //# sourceMappingURL=Aggregate.d.ts.map

package/dist/Aggregate.d.ts.map

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

package/dist/Aggregate.js

@@ -1,3 +1,12 @@
+/**
+ * The write side of the domain: a schema of events, a projection that folds them
+ * into state, and commands that inspect that state and decide on new events.
+ *
+ * An aggregate is plain data. {@link AggregateService} gives it a store to run
+ * against, and `Fixture` runs it in tests.
+ */
+import { Predicate, Schema } from "effect";
+import * as EventVersions from "./EventVersions.js";
 const build = (definition) => ({
     ...definition,
     command: (name, options) => build({
@@ -9,7 +18,42 @@ const build = (definition) => ({
  * The state is given explicitly, `Aggregate.make<State>()({ ... })`, so that the
  * projection's return values are checked against it rather than widened.
  */
-export const make = () => (options) => build({ ...options, commands: {} });
+export const make = () => (options) => build({ ...options, versions: options.versions ?? {}, commands: {} });
 /** Folds one event into the state. */
 export const evolve = (aggregate, state, event, meta) => aggregate.projection[event._tag](state, event, meta);
+/** The schema version new events with this tag are written with. */
+export const schemaVersion = (aggregate, tag) => EventVersions.current(aggregate.versions[tag]);
+/**
+ * An event as it was stored in the past, in an older version of its schema.
+ * Construct one directly to replay JSON taken from a database.
+ */
+export class Historical {
+    type;
+    schemaVersion;
+    payload;
+    constructor(options) {
+        this.type = options.type;
+        this.schemaVersion = options.schemaVersion;
+        this.payload = options.payload;
+    }
+}
+/**
+ * Encodes an event in an older version of its schema, as code from that time
+ * would have stored it. The value is checked against that version, so a test
+ * can't seed a shape that never existed.
+ */
+export const historical = (aggregate, tag, version, value) => {
+    const versions = aggregate.versions[tag];
+    const schema = versions?.schemas[version - 1];
+    if (schema === undefined) {
+        throw new Error(`${aggregate.name} has no version ${version} of ${tag}`);
+    }
+    const payload = Schema.encodeSync(Schema.toCodecJson(schema))(value);
+    return new Historical({
+        type: tag,
+        schemaVersion: version,
+        // Events were always stored with their tag, whatever the schema of the time said.
+        payload: Predicate.isObject(payload) ? { ...payload, _tag: tag } : payload
+    });
+};
 //# sourceMappingURL=Aggregate.js.map

package/dist/Aggregate.js.map

@@ -1 +1 @@
-{"version":3,"file":"Aggregate.js","sourceRoot":"","sources":["../src/Aggregate.ts"],"names":[],"mappings":"AAkGA,MAAM,KAAK,GAAG,CAMZ,UAAqH,EAC3E,EAAE,CAAC,CAAC;IAC9C,GAAG,UAAU;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACzB,KAAK,CAAC;QACJ,GAAG,UAAU;QACb,QAAQ,EAAE,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAS;KAC7D,CAAC;CACL,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAU,EAAE,CAChC,CAA6D,OAK5D,EAAsC,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;AAE7E,sCAAsC;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAgB,SAAY,EAAE,KAAe,EAAE,KAAe,EAAE,IAAe,EAAY,EAAE,CAChH,SAAS,CAAC,UAA8F,CAAC,KAAK,CAAC,IAAI,CAAE,CACpH,KAAK,EACL,KAAK,EACL,IAAI,CACL,CAAA"}
+{"version":3,"file":"Aggregate.js","sourceRoot":"","sources":["../src/Aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAA8B,SAAS,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AA2GnD,MAAM,KAAK,GAAG,CAOZ,UAGC,EAC4C,EAAE,CAAC,CAAC;IACjD,GAAG,UAAU;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACzB,KAAK,CAAC;QACJ,GAAG,UAAU;QACb,QAAQ,EAAE,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAS;KAC7D,CAAC;CACL,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAU,EAAE,CAChC,CAA4G,OAO3G,EAAyC,EAAE,CAC1C,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAK,EAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;AAE9E,sCAAsC;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAgB,SAAY,EAAE,KAAe,EAAE,KAAe,EAAE,IAAe,EAAY,EAAE,CAChH,SAAS,CAAC,UAA8F,CAAC,KAAK,CAAC,IAAI,CAAE,CACpH,KAAK,EACL,KAAK,EACL,IAAI,CACL,CAAA;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAc,EAAE,GAAW,EAAU,EAAE,CACnE,aAAa,CAAC,OAAO,CAAE,SAAS,CAAC,QAA0D,CAAC,GAAG,CAAC,CAAC,CAAA;AAEnG;;;GAGG;AACH,MAAM,OAAO,UAAU;IACZ,IAAI,CAAQ;IACZ,aAAa,CAAQ;IACrB,OAAO,CAAa;IAC7B,YAAY,OAAiG;QAC3G,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACxB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAChC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAKxB,SAAY,EACZ,GAAQ,EACR,OAAgB,EAChB,KAA+E,EACnE,EAAE;IACd,MAAM,QAAQ,GAAI,SAAS,CAAC,QAA0D,CAAC,GAAG,CAAC,CAAA;IAC3F,MAAM,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;IAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,CAAC,IAAI,mBAAmB,OAAO,OAAO,GAAG,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAgB,CAAA;IACnF,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,OAAO;QACtB,kFAAkF;QAClF,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAI,OAAkB,EAAE,IAAI,EAAE,GAAG,EAAiB,CAAC,CAAC,CAAC,OAAO;KACtG,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/AggregateService.d.ts

@@ -2,20 +2,22 @@
  * Runs an aggregate against the {@link EventStore}: the `command`, `read-model`
  * and `history` actions of moleculer-cqrs, as a typed service.
  */
-import { type DateTime, Effect, Schema } from "effect";
+import { Cause, type DateTime, Effect, Schema, type Scope } from "effect";
+import { KeyValueStore } from "effect/persistence";
 import * as Aggregate from "./Aggregate.ts";
 import { ConcurrencyConflict, EventStore, type EventStoreError, type StoredEvent } from "./EventStore.ts";
+import { Metadata } from "./Metadata.ts";
 declare const UnknownCommand_base: Schema.Class<UnknownCommand, Schema.TaggedStruct<"UnknownCommand", {
     readonly aggregateName: Schema.String;
     readonly type: Schema.String;
-}>, import("effect/Cause").YieldableError>;
+}>, Cause.YieldableError>;
 export declare class UnknownCommand extends UnknownCommand_base {
 }
 declare const InvalidCommand_base: Schema.Class<InvalidCommand, Schema.TaggedStruct<"InvalidCommand", {
     readonly aggregateName: Schema.String;
     readonly type: Schema.String;
     readonly message: Schema.String;
-}>, import("effect/Cause").YieldableError>;
+}>, Cause.YieldableError>;
 export declare class InvalidCommand extends InvalidCommand_base {
 }
 declare const EventDecodeError_base: Schema.Class<EventDecodeError, Schema.TaggedStruct<"EventDecodeError", {
@@ -23,9 +25,13 @@ declare const EventDecodeError_base: Schema.Class<EventDecodeError, Schema.Tagge
     readonly aggregateId: Schema.String;
     readonly version: Schema.Int;
     readonly type: Schema.String;
+    readonly schemaVersion: Schema.Int;
     readonly message: Schema.String;
-}>, import("effect/Cause").YieldableError>;
-/** A stored event no longer matches the schema, which means the data needs a migration. */
+}>, Cause.YieldableError>;
+/**
+ * A stored event doesn't match the schema of its version, or was written in a
+ * version the aggregate doesn't declare. Old shapes are declared with `EventVersions`.
+ */
 export declare class EventDecodeError extends EventDecodeError_base {
 }
 export type ReadError = EventStoreError | EventDecodeError;
@@ -39,11 +45,16 @@ export interface CommandResult<Event> {
     /** The store position of the last event, to pass to `ViewModels.caughtUp`. */
     readonly position: number;
     readonly events: ReadonlyArray<Event>;
+    /** Recorded on the events, see `Causation`. */
+    readonly correlationId: string;
 }
 export interface HistoryEntry<Event> {
     readonly version: number;
     readonly timestamp: DateTime.Utc;
     readonly type: string;
+    readonly correlationId: string | null;
+    readonly causationId: string | null;
+    readonly metadata: Metadata;
     readonly payload?: Event;
 }
 export interface AggregateService<A extends Aggregate.Any> {
@@ -65,18 +76,79 @@ export interface AggregateService<A extends Aggregate.Any> {
         readonly finishTime?: DateTime.Utc | undefined;
     }) => Effect.Effect<ReadonlyArray<HistoryEntry<Aggregate.Event<A>>>, ReadError>;
 }
-/** Decodes a stored event with the schema of the aggregate it belongs to. */
+/**
+ * Decodes a stored event with the schema of the aggregate it belongs to. An
+ * event stored in an older version is upcast to the current one on the way.
+ */
 export declare const makeEventDecoder: <A extends Aggregate.Any>(aggregate: A) => (stored: StoredEvent) => Effect.Effect<Aggregate.Event<A>, EventDecodeError>;
-/** Encodes events into the JSON form the store keeps. */
+/** Encodes events into the JSON form the store keeps, in the current version of their schema. */
 export declare const makeEventEncoder: <A extends Aggregate.Any>(aggregate: A) => (event: Aggregate.Event<A>) => Effect.Effect<{
     type: any;
     payload: Schema.Json;
+    schemaVersion: number;
 }, never, never>;
-export declare const make: <A extends Aggregate.Any>(aggregate: A, options?: {
+/** Saves the state of each aggregate every so often, so a cold start replays only what came after. */
+export interface SnapshotOptions<State> {
+    /** How many events to fold after a snapshot before saving the next one. */
+    readonly every: number;
+    /** How the state is stored. It is encoded as JSON. */
+    readonly schema: Schema.Codec<State, any, never, never>;
+    /**
+     * Part of every key. Change it whenever the state or the projection changes,
+     * so that snapshots of the old state are ignored and rebuilt from the log.
+     * Defaults to `1`.
+     */
+    readonly version?: string | number | undefined;
+}
+export interface Options {
     /** How many times a command is re-decided after losing a race. Defaults to 5. */
-    readonly maxRetries?: number;
+    readonly maxRetries?: number | undefined;
     /** How many aggregates keep their state in memory between commands. Defaults to 10,000. */
-    readonly stateCacheSize?: number;
-} | undefined) => Effect.Effect<AggregateService<A>, never, EventStore | Aggregate.Context<A>>;
+    readonly stateCacheSize?: number | undefined;
+}
+/**
+ * The names of the metrics every aggregate service records through Effect's
+ * `Metric` module. Each series carries an `aggregate` attribute with the
+ * aggregate's name. Read them with `Metric.snapshot`, or send them on with an
+ * exporter such as `OtlpMetrics` from `effect/observability`.
+ */
+export declare const MetricNames: {
+    /**
+     * Timer: how long a command took, including its wait for an earlier command on
+     * the same stream, by `command` and `outcome`. The outcome is `success`, the tag
+     * of the error, `defect` or `interrupted`. A payload that doesn't decode, or a
+     * type the aggregate doesn't know, fails before this point and isn't recorded.
+     */
+    readonly commandDuration: "cqrs_command_duration";
+    /**
+     * Counter: where loading the current state found a state to start from, by
+     * `source`: `memory`, `snapshot`, or `replay` when it starts from the first event.
+     */
+    readonly stateLoads: "cqrs_state_loads_total";
+    /** Histogram: how many events a load read from the store on top of that state. */
+    readonly eventsReplayed: "cqrs_events_replayed";
+    /** Gauge: how many states are remembered in memory. */
+    readonly stateCacheSize: "cqrs_state_cache_size";
+    /** Counter: states dropped from memory to make room for others, see `stateCacheSize`. */
+    readonly stateCacheEvictions: "cqrs_state_cache_evictions_total";
+    /** Counter: snapshots saved, by `result`: `success` or `failure`. */
+    readonly snapshotSaves: "cqrs_snapshot_saves_total";
+    /** Counter: snapshots that couldn't be read, so the stream was replayed instead. */
+    readonly snapshotReadFailures: "cqrs_snapshot_read_failures_total";
+    /** Counter: appends that lost a race with a writer in another process. Each is retried until `maxRetries` runs out. */
+    readonly concurrencyConflicts: "cqrs_concurrency_conflicts_total";
+};
+/**
+ * Builds the service for one aggregate. With `snapshots` it saves states through
+ * a `KeyValueStore` from `effect/persistence`, which has layers for memory, files,
+ * SQL and the browser's `localStorage`. Saves run in the background, and closing
+ * the scope waits for the ones still running.
+ */
+export declare const make: {
+    <A extends Aggregate.Any>(aggregate: A, options: Options & {
+        readonly snapshots: SnapshotOptions<Aggregate.State<A>>;
+    }): Effect.Effect<AggregateService<A>, never, EventStore | KeyValueStore.KeyValueStore | Scope.Scope | Aggregate.Context<A>>;
+    <A extends Aggregate.Any>(aggregate: A, options?: Options): Effect.Effect<AggregateService<A>, never, EventStore | Aggregate.Context<A>>;
+};
 export {};
 //# sourceMappingURL=AggregateService.d.ts.map

package/dist/AggregateService.d.ts.map

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