@ddd-ts-kit/kernel 0.8.0 → 0.10.0

package/dist/application/files/signature-of.js

@@ -0,0 +1,28 @@
+/** The leading bytes of the binary formats the kit recognises, written as latin1 strings. */
+const SIGNATURES = [
+    { mediaType: 'application/pdf', parts: [[0, '%PDF-']] },
+    { mediaType: 'image/png', parts: [[0, '\x89PNG\r\n\x1a\n']] },
+    { mediaType: 'image/jpeg', parts: [[0, '\xff\xd8\xff']] },
+    { mediaType: 'image/gif', parts: [[0, 'GIF8']] },
+    {
+        mediaType: 'image/webp',
+        parts: [
+            [0, 'RIFF'],
+            [8, 'WEBP'],
+        ],
+    },
+    { mediaType: 'application/zip', parts: [[0, 'PK\x03\x04']] },
+    { mediaType: 'application/gzip', parts: [[0, '\x1f\x8b']] },
+];
+/** The binary format the first bytes of a content announce, or `undefined` when none is recognised. */
+export function signatureOf(head) {
+    return SIGNATURES.find((signature) => signature.parts.every(([offset, bytes]) => startsWith(head, offset, bytes)))
+        ?.mediaType;
+}
+function startsWith(head, offset, bytes) {
+    if (head.length < offset + bytes.length) {
+        return false;
+    }
+    return Array.from({ length: bytes.length }, (_, index) => index).every((index) => head[offset + index] === bytes.charCodeAt(index));
+}
+//# sourceMappingURL=signature-of.js.map

package/dist/application/files/signature-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-of.js","sourceRoot":"","sources":["../../../src/application/files/signature-of.ts"],"names":[],"mappings":"AAMA,6FAA6F;AAC7F,MAAM,UAAU,GAAyB;IACvC,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE;IACvD,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE;IAC7D,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE;IACzD,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE;IAChD;QACE,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE;YACL,CAAC,CAAC,EAAE,MAAM,CAAC;YACX,CAAC,CAAC,EAAE,MAAM,CAAC;SACZ;KACF;IACD,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE;IAC5D,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE;CAC5D,CAAC;AAEF,uGAAuG;AACvG,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAChH,EAAE,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,IAAgB,EAAE,MAAc,EAAE,KAAa;IACjE,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CACpE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAC5D,CAAC;AACJ,CAAC"}

package/dist/application/files/signed-download.d.ts

@@ -0,0 +1,6 @@
+import type { FileContent } from './file-content.js';
+/** A download a signed link granted: the file, and the name to offer the browser when one was signed. */
+export interface SignedDownload extends FileContent {
+    readonly fileName?: string;
+}
+//# sourceMappingURL=signed-download.d.ts.map

package/dist/application/files/signed-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-download.d.ts","sourceRoot":"","sources":["../../../src/application/files/signed-download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,yGAAyG;AACzG,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/application/files/signed-download.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signed-download.js.map

package/dist/application/files/signed-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-download.js","sourceRoot":"","sources":["../../../src/application/files/signed-download.ts"],"names":[],"mappings":""}

package/dist/application/files/signed-upload.d.ts

@@ -0,0 +1,9 @@
+/** What a client needs to send a file straight to the storage: the request to make, and until when. */
+export interface SignedUpload {
+    readonly url: string;
+    readonly method: 'PUT';
+    /** To send as they are: the signature covers them. */
+    readonly headers: Readonly<Record<string, string>>;
+    readonly expiresAt: Date;
+}
+//# sourceMappingURL=signed-upload.d.ts.map

package/dist/application/files/signed-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-upload.d.ts","sourceRoot":"","sources":["../../../src/application/files/signed-upload.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B"}

package/dist/application/files/signed-upload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signed-upload.js.map

package/dist/application/files/signed-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-upload.js","sourceRoot":"","sources":["../../../src/application/files/signed-upload.ts"],"names":[],"mappings":""}

package/dist/application/files/signed-url.d.ts

@@ -0,0 +1,6 @@
+/** A link that grants one action on one file until it expires, without any other credential. */
+export interface SignedUrl {
+    readonly url: string;
+    readonly expiresAt: Date;
+}
+//# sourceMappingURL=signed-url.d.ts.map

package/dist/application/files/signed-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-url.d.ts","sourceRoot":"","sources":["../../../src/application/files/signed-url.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B"}

package/dist/application/files/signed-url.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signed-url.js.map

package/dist/application/files/signed-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-url.js","sourceRoot":"","sources":["../../../src/application/files/signed-url.ts"],"names":[],"mappings":""}

package/dist/application/files/staged-key-of.d.ts

@@ -0,0 +1,5 @@
+/** Where a file waits until the transaction that references it commits: nothing reads there, and no final key starts with it. */
+export declare const STAGING_PREFIX = "staging/";
+/** The staged key of a final key. */
+export declare function stagedKeyOf(key: string): string;
+//# sourceMappingURL=staged-key-of.d.ts.map

package/dist/application/files/staged-key-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-key-of.d.ts","sourceRoot":"","sources":["../../../src/application/files/staged-key-of.ts"],"names":[],"mappings":"AAAA,iIAAiI;AACjI,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/application/files/staged-key-of.js

@@ -0,0 +1,7 @@
+/** Where a file waits until the transaction that references it commits: nothing reads there, and no final key starts with it. */
+export const STAGING_PREFIX = 'staging/';
+/** The staged key of a final key. */
+export function stagedKeyOf(key) {
+    return `${STAGING_PREFIX}${key}`;
+}
+//# sourceMappingURL=staged-key-of.js.map

package/dist/application/files/staged-key-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-key-of.js","sourceRoot":"","sources":["../../../src/application/files/staged-key-of.ts"],"names":[],"mappings":"AAAA,iIAAiI;AACjI,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,cAAc,GAAG,GAAG,EAAE,CAAC;AACnC,CAAC"}

package/dist/application/files/stored-file.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The reference to a file that an aggregate keeps, and all it keeps: the content lives in a
+ * `FileStorage`, never in the database. It names no provider, no bucket and no URL, so the
+ * connector can change without touching a row.
+ */
+export interface StoredFile {
+    /** Generated by the server (`FileKeys`), never taken from the user. */
+    readonly key: string;
+    /** In bytes. */
+    readonly size: number;
+    /** Verified on the content, not only on the name the client gave. */
+    readonly mediaType: string;
+    /** `sha256:<hex>` of the content, computed while it streamed. */
+    readonly checksum: string;
+}
+//# sourceMappingURL=stored-file.d.ts.map

package/dist/application/files/stored-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-file.d.ts","sourceRoot":"","sources":["../../../src/application/files/stored-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/application/files/stored-file.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stored-file.js.map

package/dist/application/files/stored-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-file.js","sourceRoot":"","sources":["../../../src/application/files/stored-file.ts"],"names":[],"mappings":""}

package/dist/application/files/upload-url-options.d.ts

@@ -0,0 +1,12 @@
+export interface UploadUrlOptions {
+    /** Short: at most `MAX_SIGNED_URL_SECONDS`. */
+    readonly expiresInSeconds: number;
+    /** The media type the client must send, as the `content-type` the signature covers. */
+    readonly mediaType: string;
+    /**
+     * In bytes. The storages the application serves refuse a larger upload; a presigned link of
+     * an object store cannot cap it, so `FileStaging.confirm` checks it again in every case.
+     */
+    readonly maxBytes: number;
+}
+//# sourceMappingURL=upload-url-options.d.ts.map

package/dist/application/files/upload-url-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-url-options.d.ts","sourceRoot":"","sources":["../../../src/application/files/upload-url-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/application/files/upload-url-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upload-url-options.js.map

package/dist/application/files/upload-url-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-url-options.js","sourceRoot":"","sources":["../../../src/application/files/upload-url-options.ts"],"names":[],"mappings":""}

package/dist/application/persistence/append-changes.d.ts

@@ -0,0 +1,18 @@
+import type { DomainEvent } from '../../domain/domain-event.js';
+import type { EventSourcedAggregate } from '../../domain/event-sourcing/event-sourced-aggregate.js';
+export interface StreamChanges {
+    /** The version the stream must still have. */
+    readonly expected: number;
+    /** What the aggregate recorded since it was loaded, in order. */
+    readonly events: readonly DomainEvent[];
+}
+/**
+ * Optimistic concurrency for an event-sourced aggregate: hands what it recorded since it was
+ * loaded to `append`, with the version its stream must still have. Once `append` resolves, the
+ * aggregate is at the new version with nothing left to store, and can be saved again; when it
+ * rejects (a ConcurrencyError: somebody else appended first), the aggregate is left as it was.
+ * An aggregate that recorded nothing still hands its version over, with no event: the store
+ * refuses it when the stream moved meanwhile, so a stale copy is never taken for a current one.
+ */
+export declare function appendChanges<E extends DomainEvent, S>(aggregate: EventSourcedAggregate<E, S>, append: (changes: StreamChanges) => Promise<void>): Promise<void>;
+//# sourceMappingURL=append-changes.d.ts.map

package/dist/application/persistence/append-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-changes.d.ts","sourceRoot":"","sources":["../../../src/application/persistence/append-changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAGpG,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,EAC1D,SAAS,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,EACtC,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/application/persistence/append-changes.js

@@ -0,0 +1,17 @@
+import { unstoredEvents } from '../../domain/event-sourcing/unstored-events.js';
+/**
+ * Optimistic concurrency for an event-sourced aggregate: hands what it recorded since it was
+ * loaded to `append`, with the version its stream must still have. Once `append` resolves, the
+ * aggregate is at the new version with nothing left to store, and can be saved again; when it
+ * rejects (a ConcurrencyError: somebody else appended first), the aggregate is left as it was.
+ * An aggregate that recorded nothing still hands its version over, with no event: the store
+ * refuses it when the stream moved meanwhile, so a stale copy is never taken for a current one.
+ */
+export async function appendChanges(aggregate, append) {
+    const unstored = unstoredEvents.get(aggregate) ?? [];
+    const events = [...unstored];
+    await append({ expected: aggregate.version, events });
+    unstored.splice(0, events.length);
+    aggregate.version += events.length;
+}
+//# sourceMappingURL=append-changes.js.map

package/dist/application/persistence/append-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-changes.js","sourceRoot":"","sources":["../../../src/application/persistence/append-changes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAShF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAsC,EACtC,MAAiD;IAEjD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAE7B,MAAM,MAAM,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;AACrC,CAAC"}

package/dist/application/ports/checkpoint-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * How far each subscription to an event store has applied the store. Kept in the database of what
+ * the subscription writes, a checkpoint commits with what it applied.
+ */
+export declare abstract class CheckpointStore {
+    /** The last position the subscriber applied, 0 when it applied nothing yet. */
+    abstract position(subscriber: string): Promise<number>;
+    /**
+     * Moves the checkpoint from `from` to `to`, and refuses with a ConcurrencyError when it is no
+     * longer at `from`: another run of the same subscriber applied the same events first.
+     */
+    abstract advance(subscriber: string, from: number, to: number): Promise<void>;
+}
+//# sourceMappingURL=checkpoint-store.d.ts.map

package/dist/application/ports/checkpoint-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-store.d.ts","sourceRoot":"","sources":["../../../src/application/ports/checkpoint-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,eAAe;IAKnC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E"}

package/dist/application/ports/checkpoint-store.js

@@ -0,0 +1,10 @@
+/**
+ * How far each subscription to an event store has applied the store. Kept in the database of what
+ * the subscription writes, a checkpoint commits with what it applied.
+ */
+export class CheckpointStore {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.CheckpointStore' });
+    }
+}
+//# sourceMappingURL=checkpoint-store.js.map

package/dist/application/ports/checkpoint-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-store.js","sourceRoot":"","sources":["../../../src/application/ports/checkpoint-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAgB,eAAe;IACnC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAC/E,CAAC;CAUF"}

package/dist/application/ports/event-store.d.ts

@@ -0,0 +1,24 @@
+import type { Appended } from '../event-sourcing/appended.js';
+import type { EventToAppend } from '../event-sourcing/event-to-append.js';
+import type { StoredEvent } from '../event-sourcing/stored-event.js';
+/**
+ * Where event-sourced aggregates keep their streams: one stream per aggregate, read in order,
+ * and the whole store read in the order the appends committed, for the subscriptions. Stored
+ * events are never changed. Only repository adapters and subscriptions use it: the domain and the
+ * use cases never read a stream.
+ */
+export declare abstract class EventStore {
+    /**
+     * Appends the events to the stream if it still has `expectedVersion` events (0: the stream does
+     * not exist yet), and refuses with a ConcurrencyError otherwise: somebody else appended since it
+     * was read. Joins the transaction of the current unit of work when the store is transactional.
+     */
+    abstract append(stream: string, expectedVersion: number, events: readonly EventToAppend[]): Promise<Appended>;
+    /** The events of the stream after version `after` (default 0: all of them), in their order. */
+    abstract readStream(stream: string, after?: number): Promise<readonly StoredEvent[]>;
+    /** Up to `limit` events of the whole store after position `after`, in the order of their positions. */
+    abstract readAll(after: number, limit: number): Promise<readonly StoredEvent[]>;
+    /** The position of the last event stored, 0 when there is none. */
+    abstract head(): Promise<number>;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/application/ports/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../../src/application/ports/event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAErE;;;;;GAKG;AACH,8BAAsB,UAAU;IAK9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9G,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAErF,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAEhF,mEAAmE;IACnE,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC"}

package/dist/application/ports/event-store.js

@@ -0,0 +1,12 @@
+/**
+ * Where event-sourced aggregates keep their streams: one stream per aggregate, read in order,
+ * and the whole store read in the order the appends committed, for the subscriptions. Stored
+ * events are never changed. Only repository adapters and subscriptions use it: the domain and the
+ * use cases never read a stream.
+ */
+export class EventStore {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.EventStore' });
+    }
+}
+//# sourceMappingURL=event-store.js.map

package/dist/application/ports/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../../src/application/ports/event-store.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,OAAgB,UAAU;IAC9B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC1E,CAAC;CAiBF"}

package/dist/application/ports/file-keys.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Names the files: a key is always generated on the server, never built from what a user sent
+ * (a file name, a path), so a request can neither choose where it writes nor guess another key.
+ */
+export declare abstract class FileKeys {
+    /** A new key under `area`, a key prefix of the project such as `appointment-documents`. */
+    abstract next(area: string): string;
+}
+//# sourceMappingURL=file-keys.d.ts.map

package/dist/application/ports/file-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-keys.d.ts","sourceRoot":"","sources":["../../../src/application/ports/file-keys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,QAAQ;IAK5B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC"}

package/dist/application/ports/file-keys.js

@@ -0,0 +1,10 @@
+/**
+ * Names the files: a key is always generated on the server, never built from what a user sent
+ * (a file name, a path), so a request can neither choose where it writes nor guess another key.
+ */
+export class FileKeys {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.FileKeys' });
+    }
+}
+//# sourceMappingURL=file-keys.js.map

package/dist/application/ports/file-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-keys.js","sourceRoot":"","sources":["../../../src/application/ports/file-keys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAgB,QAAQ;IAC5B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACxE,CAAC;CAIF"}

package/dist/application/ports/file-scanner.d.ts

@@ -0,0 +1,13 @@
+import type { Readable } from 'node:stream';
+import type { ScanVerdict } from '../files/scan-verdict.js';
+import type { StoredFile } from '../files/stored-file.js';
+/**
+ * The check a file passes before it is accepted: an antivirus (ClamAV over its socket, a cloud
+ * scanning service), a parser that refuses a malformed document, a policy on archives. Called on
+ * the staged file, so a refused file is never visible. `open` reads the content again; a scanner
+ * that needs none of it does not call it.
+ */
+export declare abstract class FileScanner {
+    abstract scan(file: StoredFile, open: () => Promise<Readable>): Promise<ScanVerdict>;
+}
+//# sourceMappingURL=file-scanner.d.ts.map

package/dist/application/ports/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../../src/application/ports/file-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;GAKG;AACH,8BAAsB,WAAW;IAK/B,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACtF"}

package/dist/application/ports/file-scanner.js

@@ -0,0 +1,12 @@
+/**
+ * The check a file passes before it is accepted: an antivirus (ClamAV over its socket, a cloud
+ * scanning service), a parser that refuses a malformed document, a policy on archives. Called on
+ * the staged file, so a refused file is never visible. `open` reads the content again; a scanner
+ * that needs none of it does not call it.
+ */
+export class FileScanner {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.FileScanner' });
+    }
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/application/ports/file-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../../../src/application/ports/file-scanner.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,OAAgB,WAAW;IAC/B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC3E,CAAC;CAGF"}

package/dist/application/ports/file-storage.d.ts

@@ -0,0 +1,40 @@
+import type { DownloadUrlOptions } from '../files/download-url-options.js';
+import type { FileContent } from '../files/file-content.js';
+import type { FileMetadata } from '../files/file-metadata.js';
+import type { FileSource } from '../files/file-source.js';
+import type { ListedFile } from '../files/listed-file.js';
+import type { PutOptions } from '../files/put-options.js';
+import type { SignedUpload } from '../files/signed-upload.js';
+import type { SignedUrl } from '../files/signed-url.js';
+import type { StoredFile } from '../files/stored-file.js';
+import type { UploadUrlOptions } from '../files/upload-url-options.js';
+/**
+ * Where the content of files lives: an object store, a directory, the memory of a test. Never
+ * the database, whose backups, replicas and memory are sized for rows. Content always streams in
+ * and out: no method takes or returns a whole file. A key that `isFileKey` refuses is refused
+ * with `INVALID_FILE_KEY` before anything is touched.
+ *
+ * A write is not part of a transaction: see `FileStaging` for the order that keeps the database
+ * and the storage consistent.
+ */
+export declare abstract class FileStorage {
+    /** Writes the content under the key, replacing what was there; rejects with `FILE_TOO_LARGE` beyond `maxBytes`, leaving nothing. */
+    abstract put(key: string, content: FileSource, options: PutOptions): Promise<StoredFile>;
+    /** The content as a stream, or `undefined` when nothing is stored under the key. */
+    abstract get(key: string): Promise<FileContent | undefined>;
+    /** What is known of the file without reading it, or `undefined`: how a caller asks whether it exists. */
+    abstract stat(key: string): Promise<FileMetadata | undefined>;
+    /** Removes the file; removing a file that is not there is not an error. */
+    abstract delete(key: string): Promise<void>;
+    /** Rejects with `FILE_NOT_FOUND` when nothing is stored under `from`. */
+    abstract copy(from: string, to: string): Promise<void>;
+    /** Rejects with `FILE_NOT_FOUND` when nothing is stored under `from`. */
+    abstract move(from: string, to: string): Promise<void>;
+    /** Every file whose key starts with the prefix, in no promised order. */
+    abstract list(prefix: string): AsyncIterable<ListedFile>;
+    /** A link that downloads the file until it expires. Signing does not check that the file exists. */
+    abstract signedDownloadUrl(key: string, options: DownloadUrlOptions): Promise<SignedUrl>;
+    /** A request that uploads one file under the key, straight to the storage, until it expires. */
+    abstract signedUploadUrl(key: string, options: UploadUrlOptions): Promise<SignedUpload>;
+}
+//# sourceMappingURL=file-storage.d.ts.map

package/dist/application/ports/file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../../src/application/ports/file-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;;;;;;;GAQG;AACH,8BAAsB,WAAW;IAK/B,oIAAoI;IACpI,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzF,oFAAoF;IACpF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAE5D,yGAAyG;IACzG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAE9D,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAEzD,oGAAoG;IACpG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEzF,gGAAgG;IAChG,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACzF"}

package/dist/application/ports/file-storage.js

@@ -0,0 +1,15 @@
+/**
+ * Where the content of files lives: an object store, a directory, the memory of a test. Never
+ * the database, whose backups, replicas and memory are sized for rows. Content always streams in
+ * and out: no method takes or returns a whole file. A key that `isFileKey` refuses is refused
+ * with `INVALID_FILE_KEY` before anything is touched.
+ *
+ * A write is not part of a transaction: see `FileStaging` for the order that keeps the database
+ * and the storage consistent.
+ */
+export class FileStorage {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.FileStorage' });
+    }
+}
+//# sourceMappingURL=file-storage.js.map

package/dist/application/ports/file-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.js","sourceRoot":"","sources":["../../../src/application/ports/file-storage.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,OAAgB,WAAW;IAC/B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC3E,CAAC;CA4BF"}

package/dist/application/ports/served-file-storage.d.ts

@@ -0,0 +1,16 @@
+import type { FileSource } from '../files/file-source.js';
+import type { SignedDownload } from '../files/signed-download.js';
+import type { StoredFile } from '../files/stored-file.js';
+import { FileStorage } from './file-storage.js';
+/**
+ * A storage whose signed links point at the application itself, which must then answer them:
+ * the local directory of development and the memory of the tests. `signedFileRoutes` of
+ * `@ddd-ts-kit/http` mounts that answer. An object store answers its own links and is not one.
+ */
+export declare abstract class ServedFileStorage extends FileStorage {
+    /** The file a download link grants, or `undefined` for a link that is forged, expired or for another action. */
+    abstract openSigned(token: string): Promise<SignedDownload | undefined>;
+    /** Stores what an upload link grants, sent with the media type it was signed for; `undefined` when the link does not grant it. */
+    abstract acceptSigned(token: string, content: FileSource, mediaType: string): Promise<StoredFile | undefined>;
+}
+//# sourceMappingURL=served-file-storage.d.ts.map

package/dist/application/ports/served-file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"served-file-storage.d.ts","sourceRoot":"","sources":["../../../src/application/ports/served-file-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,8BAAsB,iBAAkB,SAAQ,WAAW;IAKzD,gHAAgH;IAChH,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAExE,kIAAkI;IAClI,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CAC/G"}

package/dist/application/ports/served-file-storage.js

@@ -0,0 +1,12 @@
+import { FileStorage } from './file-storage.js';
+/**
+ * A storage whose signed links point at the application itself, which must then answer them:
+ * the local directory of development and the memory of the tests. `signedFileRoutes` of
+ * `@ddd-ts-kit/http` mounts that answer. An object store answers its own links and is not one.
+ */
+export class ServedFileStorage extends FileStorage {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.ServedFileStorage' });
+    }
+}
+//# sourceMappingURL=served-file-storage.js.map

package/dist/application/ports/served-file-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"served-file-storage.js","sourceRoot":"","sources":["../../../src/application/ports/served-file-storage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,WAAW;IACzD;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACjF,CAAC;CAOF"}

package/dist/application/ports/snapshot-store.d.ts

@@ -0,0 +1,8 @@
+import type { StoredSnapshot } from '../event-sourcing/stored-snapshot.js';
+/** The last snapshot of each stream. Only the event-sourced repository uses it. */
+export declare abstract class SnapshotStore {
+    abstract find(stream: string): Promise<StoredSnapshot | undefined>;
+    /** Keeps the snapshot unless the stream already has one of a later version. */
+    abstract save(snapshot: StoredSnapshot): Promise<void>;
+}
+//# sourceMappingURL=snapshot-store.d.ts.map

package/dist/application/ports/snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.d.ts","sourceRoot":"","sources":["../../../src/application/ports/snapshot-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAE3E,mFAAmF;AACnF,8BAAsB,aAAa;IAKjC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAEnE,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/application/ports/snapshot-store.js

@@ -0,0 +1,7 @@
+/** The last snapshot of each stream. Only the event-sourced repository uses it. */
+export class SnapshotStore {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.SnapshotStore' });
+    }
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/application/ports/snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../../../src/application/ports/snapshot-store.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,OAAgB,aAAa;IACjC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC7E,CAAC;CAMF"}

package/dist/application/ports/subject-key-store.d.ts

@@ -0,0 +1,17 @@
+import type { SubjectKey } from '../event-sourcing/subject-key.js';
+/**
+ * The keys personal data is sealed with, one per data subject (crypto-shredding). Erasing a
+ * subject destroys its key: every value sealed with it can no longer be read from the live
+ * events and snapshots, nor from a backup of them that does not hold the key. A backup that
+ * holds the events and the keys together still opens them until it expires, so keep the keys
+ * apart from the events in production, with a shorter backup retention.
+ */
+export declare abstract class SubjectKeyStore {
+    /** The current key of the subject, created when it has none, a first time or after an erasure. */
+    abstract keyFor(subject: string): Promise<SubjectKey>;
+    /** The key of this id, `undefined` once its subject was erased. */
+    abstract find(keyId: string): Promise<SubjectKey | undefined>;
+    /** Destroys the keys of the subject. Answers whether there was one. */
+    abstract erase(subject: string): Promise<boolean>;
+}
+//# sourceMappingURL=subject-key-store.d.ts.map

package/dist/application/ports/subject-key-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-key-store.d.ts","sourceRoot":"","sources":["../../../src/application/ports/subject-key-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE;;;;;;GAMG;AACH,8BAAsB,eAAe;IAKnC,kGAAkG;IAClG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtD,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAE9D,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD"}

package/dist/application/ports/subject-key-store.js

@@ -0,0 +1,13 @@
+/**
+ * The keys personal data is sealed with, one per data subject (crypto-shredding). Erasing a
+ * subject destroys its key: every value sealed with it can no longer be read from the live
+ * events and snapshots, nor from a backup of them that does not hold the key. A backup that
+ * holds the events and the keys together still opens them until it expires, so keep the keys
+ * apart from the events in production, with a shorter backup retention.
+ */
+export class SubjectKeyStore {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.SubjectKeyStore' });
+    }
+}
+//# sourceMappingURL=subject-key-store.js.map

package/dist/application/ports/subject-key-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-key-store.js","sourceRoot":"","sources":["../../../src/application/ports/subject-key-store.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAgB,eAAe;IACnC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAC/E,CAAC;CAUF"}

package/dist/declarations/decorators/projection-options.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectionFeed } from '../model/projection-feed.js';
+export interface ProjectionOptions {
+    readonly feed: ProjectionFeed;
+}
+//# sourceMappingURL=projection-options.d.ts.map

package/dist/declarations/decorators/projection-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-options.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/projection-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B"}

package/dist/declarations/decorators/projection-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projection-options.js.map

package/dist/declarations/decorators/projection-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-options.js","sourceRoot":"","sources":["../../../src/declarations/decorators/projection-options.ts"],"names":[],"mappings":""}

package/dist/declarations/decorators/projection.d.ts

@@ -1,11 +1,15 @@
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
 import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
 import type { DependenciesFromSignature } from '../dependencies/dependencies-from-signature.js';
+import type { ProjectionOptions } from './projection-options.js';
 /**
  * A projector: the class that keeps one read model up to date, each of its `@On` methods
  * applying one event through a port of its own read model:
  * `@Projection('scheduling.appointment-list')`. The name is the consumer
  * it is subscribed as: stable, `<context>.<name>`, unique in the application.
+ * `@Projection('scheduling.attendance-history', { feed: 'event-store' })` is fed from the event
+ * store by a catch-up subscription instead of where the domain events are dispatched.
  */
 export declare function Projection<const D extends DeclaredDependencies = DependenciesFromSignature>(name: `${string}.${string}`, dependencies?: D): ClassDeclarator<object, D>;
+export declare function Projection<const D extends DeclaredDependencies = DependenciesFromSignature>(name: `${string}.${string}`, options: ProjectionOptions, dependencies?: D): ClassDeclarator<object, D>;
 //# sourceMappingURL=projection.d.ts.map

package/dist/declarations/decorators/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAOhG;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,EAC3B,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAgB5B"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAOhG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,EAC3B,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC9B,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC"}