@ddd-ts-kit/kernel 0.0.0-stage → 0.1.1

package/dist/application/execution/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/application/execution/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,+BAA+B,CAAC;CACtD;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,UAAU,CAAC,GAClF,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC;AAE7D,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAQ7E"}

package/dist/application/execution/execution-context.js

@@ -0,0 +1,10 @@
+/** Fills what can be derived: the tenant of the actor, no extension. */
+export function executionContext(init) {
+    const tenantId = init.tenantId ?? init.actor.tenantId;
+    return Object.freeze({
+        ...init,
+        ...(tenantId === undefined ? {} : { tenantId }),
+        extensions: init.extensions ?? Object.freeze({}),
+    });
+}
+//# sourceMappingURL=execution-context.js.map

package/dist/application/execution/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../../src/application/execution/execution-context.ts"],"names":[],"mappings":"AA6BA,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,IAA0B;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAEtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,IAAI;QACP,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;KACjD,CAAC,CAAC;AACL,CAAC"}

package/dist/application/execution/execution-origin.d.ts

@@ -0,0 +1,3 @@
+/** The standard origins come first; any other string names an origin of the project. */
+export type ExecutionOrigin = 'http' | 'event' | 'schedule' | 'cli' | (string & Record<never, never>);
+//# sourceMappingURL=execution-origin.d.ts.map

package/dist/application/execution/execution-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-origin.d.ts","sourceRoot":"","sources":["../../../src/application/execution/execution-origin.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC"}

package/dist/application/execution/execution-origin.js

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

package/dist/application/execution/execution-origin.js.map

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

package/dist/application/execution/is-past-deadline.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutionContext } from './execution-context.js';
+export declare function isPastDeadline(context: ExecutionContext, now: Date): boolean;
+//# sourceMappingURL=is-past-deadline.d.ts.map

package/dist/application/execution/is-past-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-past-deadline.d.ts","sourceRoot":"","sources":["../../../src/application/execution/is-past-deadline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAE5E"}

package/dist/application/execution/is-past-deadline.js

@@ -0,0 +1,4 @@
+export function isPastDeadline(context, now) {
+    return context.deadline !== undefined && context.deadline.getTime() <= now.getTime();
+}
+//# sourceMappingURL=is-past-deadline.js.map

package/dist/application/execution/is-past-deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-past-deadline.js","sourceRoot":"","sources":["../../../src/application/execution/is-past-deadline.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,OAAyB,EAAE,GAAS;IACjE,OAAO,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;AACvF,CAAC"}

package/dist/application/execution/log-fields-of.d.ts

@@ -0,0 +1,5 @@
+import type { LogFields } from '../logging/log-fields.js';
+import type { ExecutionContext } from './execution-context.js';
+/** The identifiers a log line needs to be found again, impersonation included. Never content. */
+export declare function logFieldsOf(context: ExecutionContext): LogFields;
+//# sourceMappingURL=log-fields-of.d.ts.map

package/dist/application/execution/log-fields-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-fields-of.d.ts","sourceRoot":"","sources":["../../../src/application/execution/log-fields-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAShE"}

package/dist/application/execution/log-fields-of.js

@@ -0,0 +1,12 @@
+/** The identifiers a log line needs to be found again, impersonation included. Never content. */
+export function logFieldsOf(context) {
+    return {
+        correlationId: context.correlationId,
+        origin: context.origin,
+        actorId: context.actor.id,
+        ...(context.causationId === undefined ? {} : { causationId: context.causationId }),
+        ...(context.tenantId === undefined ? {} : { tenantId: context.tenantId }),
+        ...(context.session?.impersonatedBy === undefined ? {} : { impersonatedBy: context.session.impersonatedBy }),
+    };
+}
+//# sourceMappingURL=log-fields-of.js.map

package/dist/application/execution/log-fields-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-fields-of.js","sourceRoot":"","sources":["../../../src/application/execution/log-fields-of.ts"],"names":[],"mappings":"AAGA,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,OAAyB;IACnD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;QACzB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;KAC7G,CAAC;AACJ,CAAC"}

package/dist/application/execution/no-execution-context-error.d.ts

@@ -0,0 +1,5 @@
+/** A boundary forgot `ExecutionScope.run`: a wiring mistake, never a business failure. */
+export declare class NoExecutionContextError extends Error {
+    constructor();
+}
+//# sourceMappingURL=no-execution-context-error.d.ts.map

package/dist/application/execution/no-execution-context-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-execution-context-error.d.ts","sourceRoot":"","sources":["../../../src/application/execution/no-execution-context-error.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,cAGC;CACF"}

package/dist/application/execution/no-execution-context-error.js

@@ -0,0 +1,8 @@
+/** A boundary forgot `ExecutionScope.run`: a wiring mistake, never a business failure. */
+export class NoExecutionContextError extends Error {
+    constructor() {
+        super('No execution context: the boundary (route, consumer, job) must call ExecutionScope.run');
+        this.name = 'NoExecutionContextError';
+    }
+}
+//# sourceMappingURL=no-execution-context-error.js.map

package/dist/application/execution/no-execution-context-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-execution-context-error.js","sourceRoot":"","sources":["../../../src/application/execution/no-execution-context-error.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD;QACE,KAAK,CAAC,wFAAwF,CAAC,CAAC;QAChG,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/application/execution/with-actor.d.ts

@@ -0,0 +1,8 @@
+import type { Actor } from '../actor/actor.js';
+import type { ExecutionContext } from './execution-context.js';
+/**
+ * The same unit of work seen as another actor. The session goes: it was the previous actor's.
+ * The tenant follows the new actor when it has one.
+ */
+export declare function withActor(context: ExecutionContext, actor: Actor): ExecutionContext;
+//# sourceMappingURL=with-actor.d.ts.map

package/dist/application/execution/with-actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-actor.d.ts","sourceRoot":"","sources":["../../../src/application/execution/with-actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,gBAAgB,CASnF"}

package/dist/application/execution/with-actor.js

@@ -0,0 +1,13 @@
+/**
+ * The same unit of work seen as another actor. The session goes: it was the previous actor's.
+ * The tenant follows the new actor when it has one.
+ */
+export function withActor(context, actor) {
+    if (context.actor === actor) {
+        return context;
+    }
+    const { session: _session, tenantId: _tenantId, ...rest } = context;
+    const tenantId = actor.tenantId ?? context.tenantId;
+    return Object.freeze({ ...rest, actor, ...(tenantId === undefined ? {} : { tenantId }) });
+}
+//# sourceMappingURL=with-actor.js.map

package/dist/application/execution/with-actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-actor.js","sourceRoot":"","sources":["../../../src/application/execution/with-actor.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB,EAAE,KAAY;IAC/D,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACpE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAEpD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/application/hydration/hydrate.d.ts

@@ -0,0 +1,10 @@
+import type { Page } from '../pagination/page.js';
+import { Hydration } from './hydration.js';
+/**
+ * Completes the rows of a read with data of other bounded contexts, one call per relation for
+ * the whole page and never one per row:
+ * `await hydrate(page).with('practitioner', (row) => row.practitionerId, practitioners.byIds)`.
+ * A list of rows is hydrated as a page of them.
+ */
+export declare function hydrate<Row extends object>(source: Page<Row> | readonly Row[]): Hydration<Row>;
+//# sourceMappingURL=hydrate.d.ts.map

package/dist/application/hydration/hydrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAE9F"}

package/dist/application/hydration/hydrate.js

@@ -0,0 +1,11 @@
+import { Hydration } from './hydration.js';
+/**
+ * Completes the rows of a read with data of other bounded contexts, one call per relation for
+ * the whole page and never one per row:
+ * `await hydrate(page).with('practitioner', (row) => row.practitionerId, practitioners.byIds)`.
+ * A list of rows is hydrated as a page of them.
+ */
+export function hydrate(source) {
+    return Hydration.of('items' in source ? source : { items: source });
+}
+//# sourceMappingURL=hydrate.js.map

package/dist/application/hydration/hydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../../../src/application/hydration/hydrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAqB,MAAkC;IAC5E,OAAO,SAAS,CAAC,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/application/hydration/hydrated-page.d.ts

@@ -0,0 +1,7 @@
+import type { Page } from '../pagination/page.js';
+import type { HydrationWarning } from './hydration-warning.js';
+/** The page that was hydrated, with the same paging, and what had to be answered by a fallback. */
+export interface HydratedPage<T> extends Page<T> {
+    readonly warnings: readonly HydrationWarning[];
+}
+//# sourceMappingURL=hydrated-page.d.ts.map

package/dist/application/hydration/hydrated-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrated-page.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydrated-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,mGAAmG;AACnG,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD"}

package/dist/application/hydration/hydrated-page.js

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

package/dist/application/hydration/hydrated-page.js.map

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

package/dist/application/hydration/hydration-policy.d.ts

@@ -0,0 +1,8 @@
+/** What a relation does when its lookup rejects or takes too long. */
+export interface HydrationPolicy {
+    /** `fail` (default) rejects the whole hydration; `fallback` answers the fallback and a warning. */
+    readonly onFailure?: 'fail' | 'fallback';
+    /** The lookup is given up after this long, and counts as failed. No limit by default. */
+    readonly timeoutMs?: number;
+}
+//# sourceMappingURL=hydration-policy.d.ts.map

package/dist/application/hydration/hydration-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-policy.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydration-policy.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,mGAAmG;IACnG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/application/hydration/hydration-policy.js

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

package/dist/application/hydration/hydration-policy.js.map

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

package/dist/application/hydration/hydration-run.d.ts

@@ -0,0 +1,10 @@
+import type { HydrationPolicy } from './hydration-policy.js';
+import type { HydrationWarning } from './hydration-warning.js';
+/** One execution of a hydration: what its relations share while they load. */
+export interface HydrationRun {
+    readonly policies: ReadonlyMap<string, HydrationPolicy>;
+    /** The lookups that failed and that no fallback has answered for yet. */
+    readonly failures: Map<string, unknown>;
+    readonly warnings: HydrationWarning[];
+}
+//# sourceMappingURL=hydration-run.d.ts.map

package/dist/application/hydration/hydration-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-run.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydration-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CACvC"}

package/dist/application/hydration/hydration-run.js

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

package/dist/application/hydration/hydration-run.js.map

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

package/dist/application/hydration/hydration-timeout-error.d.ts

@@ -0,0 +1,8 @@
+/** The lookup of a relation did not answer within the time its policy gives it. */
+export declare class HydrationTimeoutError extends Error {
+    readonly relation: string;
+    readonly timeoutMs: number;
+    readonly code = "HYDRATION_TIMEOUT";
+    constructor(relation: string, timeoutMs: number);
+}
+//# sourceMappingURL=hydration-timeout-error.d.ts.map

package/dist/application/hydration/hydration-timeout-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-timeout-error.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydration-timeout-error.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,qBAAa,qBAAsB,SAAQ,KAAK;IAI5C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAJ5B,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,YACW,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAI3B;CACF"}

package/dist/application/hydration/hydration-timeout-error.js

@@ -0,0 +1,13 @@
+/** The lookup of a relation did not answer within the time its policy gives it. */
+export class HydrationTimeoutError extends Error {
+    relation;
+    timeoutMs;
+    code = 'HYDRATION_TIMEOUT';
+    constructor(relation, timeoutMs) {
+        super(`The lookup of "${relation}" did not answer within ${String(timeoutMs)} ms`);
+        this.relation = relation;
+        this.timeoutMs = timeoutMs;
+        this.name = 'HydrationTimeoutError';
+    }
+}
+//# sourceMappingURL=hydration-timeout-error.js.map

package/dist/application/hydration/hydration-timeout-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-timeout-error.js","sourceRoot":"","sources":["../../../src/application/hydration/hydration-timeout-error.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAInC,QAAQ;IACR,SAAS;IAJX,IAAI,GAAG,mBAAmB,CAAC;IAEpC,YACW,QAAgB,EAChB,SAAiB;QAE1B,KAAK,CAAC,kBAAkB,QAAQ,2BAA2B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;wBAH1E,QAAQ;yBACR,SAAS;QAGlB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/application/hydration/hydration-warning.d.ts

@@ -0,0 +1,6 @@
+/** A relation answered with its fallback because its lookup failed: said, never silent. */
+export interface HydrationWarning {
+    readonly relation: string;
+    readonly code: 'lookup_failed' | 'lookup_timed_out';
+}
+//# sourceMappingURL=hydration-warning.d.ts.map

package/dist/application/hydration/hydration-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-warning.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydration-warning.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAAC;CACrD"}

package/dist/application/hydration/hydration-warning.js

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

package/dist/application/hydration/hydration-warning.js.map

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

package/dist/application/hydration/hydration.d.ts

@@ -0,0 +1,31 @@
+import type { Page } from '../pagination/page.js';
+import type { HydratedPage } from './hydrated-page.js';
+import type { HydrationPolicy } from './hydration-policy.js';
+/**
+ * Rows being completed with what other bounded contexts know, relation by relation. Awaiting
+ * it runs the lookups, all at once, each called once for the page. Immutable: `with` and
+ * `orElse` answer a new hydration.
+ */
+export declare class Hydration<Row extends object, Extra extends object = object> implements PromiseLike<HydratedPage<Row & Extra>> {
+    private readonly parts;
+    static of<Row extends object>(page: Page<Row>): Hydration<Row>;
+    private constructor();
+    /**
+     * Adds the property `name` to every row whose key is known on the other side. `lookup`
+     * receives the keys of the page, each once: typically the `byIds` of a gateway port.
+     */
+    with<Name extends string, Related>(name: Name, keyOf: (row: Row) => string | null | undefined, lookup: (ids: readonly string[]) => Promise<ReadonlyMap<string, Related>>): Hydration<Row, Extra & {
+        readonly [Key in Name]?: Related;
+    }>;
+    /**
+     * Gives a relation the value of the rows it found nothing for, so the property is always
+     * there. With `onFailure: 'fallback'`, a lookup that rejects or times out answers the
+     * fallback too, and the result says so in `warnings`.
+     */
+    orElse<Name extends keyof Extra & string>(name: Name, fallback: NonNullable<Extra[Name]>, policy?: HydrationPolicy): Hydration<Row, Extra & {
+        readonly [Key in Name]: NonNullable<Extra[Name]>;
+    }>;
+    then<Fulfilled = HydratedPage<Row & Extra>, Rejected = never>(onFulfilled?: ((page: HydratedPage<Row & Extra>) => Fulfilled | PromiseLike<Fulfilled>) | null, onRejected?: ((reason: unknown) => Rejected | PromiseLike<Rejected>) | null): PromiseLike<Fulfilled | Rejected>;
+    private load;
+}
+//# sourceMappingURL=hydration.d.ts.map

package/dist/application/hydration/hydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/hydration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAc7D;;;;GAIG;AACH,qBAAa,SAAS,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM,CACtE,YAAW,WAAW,CAAC,YAAY,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAM7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJ1C,MAAM,CAAC,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAE7D;IAED,OAAO,eAA0D;IAEjE;;;OAGG;IACH,IAAI,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,EAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9C,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxE,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO;KAAE,CAAC,CAmB9D;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,SAAS,MAAM,KAAK,GAAG,MAAM,EACtC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAClC,MAAM,GAAE,eAAoB,GAC3B,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KAAE,CAAC,CAgB9E;IAED,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,GAAG,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,EAC1D,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,EAC9F,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC1E,WAAW,CAAC,SAAS,GAAG,QAAQ,CAAC,CAEnC;YAEa,IAAI;CAiBnB"}

package/dist/application/hydration/hydration.js

@@ -0,0 +1,82 @@
+import { HydrationTimeoutError } from './hydration-timeout-error.js';
+import { loadRelation } from './load-relation.js';
+import { property } from './property.js';
+/**
+ * Rows being completed with what other bounded contexts know, relation by relation. Awaiting
+ * it runs the lookups, all at once, each called once for the page. Immutable: `with` and
+ * `orElse` answer a new hydration.
+ */
+export class Hydration {
+    parts;
+    static of(page) {
+        return new Hydration({ page, complete: (rows) => Promise.resolve(rows.map(() => ({}))), policies: new Map() });
+    }
+    constructor(parts) {
+        this.parts = parts;
+    }
+    /**
+     * Adds the property `name` to every row whose key is known on the other side. `lookup`
+     * receives the keys of the page, each once: typically the `byIds` of a gateway port.
+     */
+    with(name, keyOf, lookup) {
+        const { page, complete, policies } = this.parts;
+        return new Hydration({
+            page,
+            policies,
+            complete: async (rows, run) => {
+                const [known, related] = await Promise.all([
+                    complete(rows, run),
+                    loadRelation({ name, keyOf, lookup }, rows, run),
+                ]);
+                return known.flatMap((extra, index) => {
+                    const more = related[index];
+                    return more === undefined ? [] : [{ ...extra, ...more }];
+                });
+            },
+        });
+    }
+    /**
+     * Gives a relation the value of the rows it found nothing for, so the property is always
+     * there. With `onFailure: 'fallback'`, a lookup that rejects or times out answers the
+     * fallback too, and the result says so in `warnings`.
+     */
+    orElse(name, fallback, policy = {}) {
+        const { page, complete, policies } = this.parts;
+        return new Hydration({
+            page,
+            policies: new Map([...policies, [name, policy]]),
+            complete: async (rows, run) => {
+                const known = await complete(rows, run);
+                if (policy.onFailure === 'fallback') {
+                    forgive(run, name);
+                }
+                return known.map((extra) => ({ ...extra, ...property(name, extra[name] ?? fallback) }));
+            },
+        });
+    }
+    then(onFulfilled, onRejected) {
+        return this.load().then(onFulfilled, onRejected);
+    }
+    async load() {
+        const { items, ...paging } = this.parts.page;
+        const run = { policies: this.parts.policies, failures: new Map(), warnings: [] };
+        const extras = await this.parts.complete(items, run);
+        for (const failure of run.failures.values()) {
+            throw failure;
+        }
+        const hydrated = extras.flatMap((extra, index) => {
+            const row = items[index];
+            return row === undefined ? [] : [{ ...row, ...extra }];
+        });
+        return { ...paging, items: hydrated, warnings: run.warnings };
+    }
+}
+function forgive(run, relation) {
+    if (!run.failures.has(relation)) {
+        return;
+    }
+    const code = run.failures.get(relation) instanceof HydrationTimeoutError ? 'lookup_timed_out' : 'lookup_failed';
+    run.failures.delete(relation);
+    run.warnings.push({ relation, code });
+}
+//# sourceMappingURL=hydration.js.map

package/dist/application/hydration/hydration.js.map

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

package/dist/application/hydration/load-relation.d.ts

@@ -0,0 +1,17 @@
+import type { HydrationRun } from './hydration-run.js';
+export interface Relation<Row, Name extends string, Related> {
+    readonly name: Name;
+    readonly keyOf: (row: Row) => string | null | undefined;
+    readonly lookup: (ids: readonly string[]) => Promise<ReadonlyMap<string, Related>>;
+}
+type Found<Name extends string, Related> = {
+    readonly [Key in Name]?: Related;
+};
+/**
+ * What one relation adds to each row, in the order of the rows: one lookup for the page, with
+ * each identifier once, and none when no row has a key. A lookup that fails is recorded in
+ * the run and adds nothing.
+ */
+export declare function loadRelation<Row, Name extends string, Related>(relation: Relation<Row, Name, Related>, rows: readonly Row[], run: HydrationRun): Promise<readonly Found<Name, Related>[]>;
+export {};
+//# sourceMappingURL=load-relation.d.ts.map

package/dist/application/hydration/load-relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-relation.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/load-relation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,QAAQ,CAAC,GAAG,EAAE,IAAI,SAAS,MAAM,EAAE,OAAO;IACzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpF;AAED,KAAK,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,IAAI;IAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO;CAAE,CAAC;AAEhF;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,IAAI,SAAS,MAAM,EAAE,OAAO,EAClE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EACtC,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAU1C"}

package/dist/application/hydration/load-relation.js

@@ -0,0 +1,39 @@
+import { HydrationTimeoutError } from './hydration-timeout-error.js';
+import { property } from './property.js';
+/**
+ * What one relation adds to each row, in the order of the rows: one lookup for the page, with
+ * each identifier once, and none when no row has a key. A lookup that fails is recorded in
+ * the run and adds nothing.
+ */
+export async function loadRelation(relation, rows, run) {
+    const keys = rows.map((row) => relation.keyOf(row) ?? undefined);
+    const ids = [...new Set(keys.filter((key) => key !== undefined))];
+    const found = ids.length === 0 ? new Map() : await looked(relation, ids, run);
+    return keys.map((key) => {
+        const related = key === undefined ? undefined : found.get(key);
+        return related === undefined ? {} : property(relation.name, related);
+    });
+}
+async function looked({ name, lookup }, ids, run) {
+    try {
+        return await within(lookup(ids), name, run.policies.get(name)?.timeoutMs);
+    }
+    catch (error) {
+        run.failures.set(name, error);
+        return new Map();
+    }
+}
+function within(answer, relation, timeoutMs) {
+    if (timeoutMs === undefined) {
+        return answer;
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new HydrationTimeoutError(relation, timeoutMs));
+        }, timeoutMs);
+        answer.then(resolve, reject).finally(() => {
+            clearTimeout(timer);
+        });
+    });
+}
+//# sourceMappingURL=load-relation.js.map

package/dist/application/hydration/load-relation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-relation.js","sourceRoot":"","sources":["../../../src/application/hydration/load-relation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAUzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsC,EACtC,IAAoB,EACpB,GAAiB;IAEjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAmB,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE/F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE/D,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,MAAM,CACnB,EAAE,IAAI,EAAE,MAAM,EAAgC,EAC9C,GAAsB,EACtB,GAAiB;IAEjB,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE9B,OAAO,IAAI,GAAG,EAAmB,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAI,MAAkB,EAAE,QAAgB,EAAE,SAA6B;IACpF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,qBAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QACzD,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACxC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/application/hydration/property.d.ts

@@ -0,0 +1,5 @@
+/** `{ [name]: value }`, typed by the literal name. */
+export declare function property<Name extends string, Value>(name: Name, value: Value): {
+    readonly [Key in Name]: Value;
+};
+//# sourceMappingURL=property.d.ts.map

package/dist/application/hydration/property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../../src/application/hydration/property.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG;IAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,GAAG,KAAK;CAAE,CAAC"}

package/dist/application/hydration/property.js

@@ -0,0 +1,4 @@
+export function property(name, value) {
+    return { [name]: value };
+}
+//# sourceMappingURL=property.js.map

package/dist/application/hydration/property.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.js","sourceRoot":"","sources":["../../../src/application/hydration/property.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAc;IACnD,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/application/lock/acquiring.d.ts

@@ -0,0 +1,10 @@
+import type { LockHandle } from './lock-handle.js';
+export interface WaitingOptions {
+    /** Pause between two attempts while waiting. Default 25. */
+    readonly retryDelayMs?: number;
+    /** Default: a timer. */
+    readonly sleep?: (ms: number) => Promise<void>;
+}
+/** For an adapter of `Lock`: tries, and tries again every `retryDelayMs` until `waitMs` have been waited. */
+export declare function acquiring(attempt: () => Promise<LockHandle | undefined>, waitMs: number, waiting: WaitingOptions): Promise<LockHandle | undefined>;
+//# sourceMappingURL=acquiring.d.ts.map

package/dist/application/lock/acquiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquiring.d.ts","sourceRoot":"","sources":["../../../src/application/lock/acquiring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,6GAA6G;AAC7G,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAajC"}

package/dist/application/lock/acquiring.js

@@ -0,0 +1,18 @@
+/** For an adapter of `Lock`: tries, and tries again every `retryDelayMs` until `waitMs` have been waited. */
+export async function acquiring(attempt, waitMs, waiting) {
+    const pause = Math.max(1, waiting.retryDelayMs ?? 25);
+    const sleep = waiting.sleep ?? timer;
+    for (let waited = 0;; waited += pause) {
+        const handle = await attempt();
+        if (handle !== undefined || waited >= waitMs) {
+            return handle;
+        }
+        await sleep(Math.min(pause, waitMs - waited));
+    }
+}
+function timer(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=acquiring.js.map

package/dist/application/lock/acquiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquiring.js","sourceRoot":"","sources":["../../../src/application/lock/acquiring.ts"],"names":[],"mappings":"AASA,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA8C,EAC9C,MAAc,EACd,OAAuB;IAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAErC,KAAK,IAAI,MAAM,GAAG,CAAC,GAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAE/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/application/lock/lock-handle.d.ts

@@ -0,0 +1,11 @@
+export interface LockHandle {
+    readonly key: string;
+    /**
+     * Grows with each acquisition of the key. A resource that remembers the highest token it
+     * has seen can refuse a holder whose lock expired while it was paused.
+     */
+    readonly fencingToken: number;
+    /** Frees the lock if it is still this holder's. Releasing twice, or too late, does nothing. */
+    release(): Promise<void>;
+}
+//# sourceMappingURL=lock-handle.d.ts.map

package/dist/application/lock/lock-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-handle.d.ts","sourceRoot":"","sources":["../../../src/application/lock/lock-handle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+FAA+F;IAC/F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/application/lock/lock-handle.js

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

package/dist/application/lock/lock-handle.js.map

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

package/dist/application/logging/credential-keys.d.ts

@@ -0,0 +1,3 @@
+/** The field names whose value a redacting logger never writes, at the top of an entry and one level below. */
+export declare const CREDENTIAL_KEYS: readonly string[];
+//# sourceMappingURL=credential-keys.d.ts.map

package/dist/application/logging/credential-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-keys.d.ts","sourceRoot":"","sources":["../../../src/application/logging/credential-keys.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAc5C,CAAC"}