@cratis/chronicle 6.16.1 → 6.18.0

package/artifacts/ActivatedArtifact.ts

@@ -1,6 +1,8 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import type { ArtifactInvocationContext } from './ArtifactInvocationContext.js';
+
 /** A leased artifact instance. The activator owns its lifetime; the SDK releases only this lease. */
 export interface ActivatedArtifact<T> {
     /** The instance used for every event in this delivery batch. */
@@ -8,5 +10,7 @@ export interface ActivatedArtifact<T> {
     /** Releases the lease after handling, even on failure. Cleanup errors are logged, not acknowledged as failures. */
     dispose?(): void | Promise<void>;
     /** Runs an individual handler (and any returned effects) inside the activator's execution boundary. */
-    run?<R>(callback: () => R | Promise<R>): Promise<R>;
+    run?<R>(callback: () => R | Promise<R>, invocation?: ArtifactInvocationContext): Promise<R>;
+    /** Completes the lease before acknowledgement, even after processing fails. A rejection fails delivery. */
+    complete?(): void | Promise<void>;
 }

package/artifacts/ArtifactCompletionFailed.ts

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** A lease completion failure that prevents acknowledgement, including when processing also failed. */
+export class ArtifactCompletionFailed extends Error {
+    /** The original completion rejection. */
+    readonly completionError: unknown;
+    /** The original processing rejection, if processing also failed. */
+    readonly processingError: unknown;
+
+    constructor(completionError: unknown, processingError?: unknown) {
+        super(`Artifact completion failed: ${String(completionError)}`, { cause: completionError });
+        this.name = 'ArtifactCompletionFailed';
+        this.completionError = completionError;
+        this.processingError = processingError;
+        if (processingError instanceof Error) {
+            this.stack += `\nProcessing failure:\n${processingError.stack ?? String(processingError)}`;
+        }
+    }
+}

package/artifacts/ArtifactInvocationContext.ts

@@ -0,0 +1,21 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { ReplayState } from '@cratis/chronicle.contracts';
+import type { EventContext } from '../events/EventContext.js';
+import { ArtifactDelivery } from './ArtifactDelivery.js';
+
+/** Metadata for a single invocation within an activated artifact's delivery lease. */
+export type ArtifactInvocationContext = {
+    /** An event handler invocation; each event has its own context, even within a shared batch lease. */
+    readonly delivery: ArtifactDelivery.Events;
+    /** The context of the event currently being handled. */
+    readonly eventContext: EventContext;
+    /** The handler method invoked for this event. */
+    readonly methodName: string;
+} | {
+    /** A replay lifecycle notification, activated separately from event batches. */
+    readonly delivery: ArtifactDelivery.ReplayNotification;
+    /** The replay transition being notified. */
+    readonly replayState: ReplayState;
+};

package/artifacts/for_withActivatedArtifact/when_completing/after_processing_failure.spec.ts

@@ -0,0 +1,34 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { chai, describe, it } from 'vitest';
+import type { ArtifactActivationContext } from '../../ArtifactActivationContext.js';
+import { ArtifactCompletionFailed } from '../../ArtifactCompletionFailed.js';
+import { withActivatedArtifact } from '../../withActivatedArtifact.js';
+
+chai.should();
+
+describe('when completing a lease after a processing failure', () => {
+    it('should retain both original errors and dispose after completion', async () => {
+        const processingError = new Error('processing');
+        const completionError = new Error('completion');
+        const steps: string[] = [];
+        const activator = () => ({ instance: {}, complete: () => { steps.push('complete'); throw completionError; },
+            dispose: () => { steps.push('dispose'); } });
+        let failure: unknown;
+        try {
+            await withActivatedArtifact(Object, {} as ArtifactActivationContext, activator, async () => {
+                steps.push('process');
+                throw processingError;
+            });
+        } catch (error) {
+            failure = error;
+        }
+        failure.should.be.instanceOf(ArtifactCompletionFailed);
+        const completionFailure = failure as ArtifactCompletionFailed;
+        completionFailure.processingError.should.equal(processingError);
+        completionFailure.completionError.should.equal(completionError);
+        completionFailure.cause.should.equal(completionError);
+        steps.should.deep.equal(['process', 'complete', 'dispose']);
+    });
+});

package/artifacts/index.ts

@@ -4,6 +4,8 @@
 export { ArtifactKind } from './ArtifactKind.js';
 export { ArtifactDelivery } from './ArtifactDelivery.js';
 export type { ArtifactActivationContext } from './ArtifactActivationContext.js';
+export type { ArtifactInvocationContext } from './ArtifactInvocationContext.js';
+export { ArtifactCompletionFailed } from './ArtifactCompletionFailed.js';
 export type { ActivatedArtifact } from './ActivatedArtifact.js';
 export type { ClientArtifactsActivator } from './ClientArtifactsActivator.js';
 

package/artifacts/withActivatedArtifact.ts

@@ -5,6 +5,8 @@ import { diag } from '@opentelemetry/api';
 import type { Constructor } from '@cratis/fundamentals';
 import type { ActivatedArtifact } from './ActivatedArtifact.js';
 import type { ArtifactActivationContext } from './ArtifactActivationContext.js';
+import type { ArtifactInvocationContext } from './ArtifactInvocationContext.js';
+import { ArtifactCompletionFailed } from './ArtifactCompletionFailed.js';
 import type { ClientArtifactsActivator } from './ClientArtifactsActivator.js';
 
 const logger = diag.createComponentLogger({ namespace: '@cratis/chronicle/artifacts' });
@@ -16,7 +18,22 @@ export async function withActivatedArtifact<T, R>(
 ): Promise<R> {
     const artifact = await activator(type, context);
     try {
-        return await callback(artifact);
+        let result!: R;
+        let processingFailed = false;
+        let processingError: unknown;
+        try {
+            result = await callback(artifact);
+        } catch (error) {
+            processingFailed = true;
+            processingError = error;
+        }
+        try {
+            await artifact.complete?.();
+        } catch (error) {
+            throw new ArtifactCompletionFailed(error, processingFailed ? processingError : undefined);
+        }
+        if (processingFailed) throw processingError;
+        return result;
     } finally {
         try {
             await artifact.dispose?.();
@@ -27,6 +44,6 @@ export async function withActivatedArtifact<T, R>(
 }
 
 /** Enters an optional execution boundary for one handler and all of its returned effects. */
-export async function runActivated<R>(artifact: ActivatedArtifact<unknown>, callback: () => R | Promise<R>): Promise<R> {
-    return artifact.run ? artifact.run(callback) : callback();
+export async function runActivated<R>(artifact: ActivatedArtifact<unknown>, callback: () => R | Promise<R>, invocation: ArtifactInvocationContext): Promise<R> {
+    return artifact.run ? artifact.run(callback, invocation) : callback();
 }

package/dist/artifacts/ActivatedArtifact.d.ts

@@ -1,3 +1,4 @@
+import type { ArtifactInvocationContext } from './ArtifactInvocationContext.js';
 /** A leased artifact instance. The activator owns its lifetime; the SDK releases only this lease. */
 export interface ActivatedArtifact<T> {
     /** The instance used for every event in this delivery batch. */
@@ -5,6 +6,8 @@ export interface ActivatedArtifact<T> {
     /** Releases the lease after handling, even on failure. Cleanup errors are logged, not acknowledged as failures. */
     dispose?(): void | Promise<void>;
     /** Runs an individual handler (and any returned effects) inside the activator's execution boundary. */
-    run?<R>(callback: () => R | Promise<R>): Promise<R>;
+    run?<R>(callback: () => R | Promise<R>, invocation?: ArtifactInvocationContext): Promise<R>;
+    /** Completes the lease before acknowledgement, even after processing fails. A rejection fails delivery. */
+    complete?(): void | Promise<void>;
 }
 //# sourceMappingURL=ActivatedArtifact.d.ts.map

package/dist/artifacts/ActivatedArtifact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActivatedArtifact.d.ts","sourceRoot":"","sources":["../../artifacts/ActivatedArtifact.ts"],"names":[],"mappings":"AAGA,qGAAqG;AACrG,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,mHAAmH;IACnH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,uGAAuG;IACvG,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvD"}
+{"version":3,"file":"ActivatedArtifact.d.ts","sourceRoot":"","sources":["../../artifacts/ActivatedArtifact.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF,qGAAqG;AACrG,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,mHAAmH;IACnH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,uGAAuG;IACvG,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5F,2GAA2G;IAC3G,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/artifacts/ArtifactCompletionFailed.d.ts

@@ -0,0 +1,9 @@
+/** A lease completion failure that prevents acknowledgement, including when processing also failed. */
+export declare class ArtifactCompletionFailed extends Error {
+    /** The original completion rejection. */
+    readonly completionError: unknown;
+    /** The original processing rejection, if processing also failed. */
+    readonly processingError: unknown;
+    constructor(completionError: unknown, processingError?: unknown);
+}
+//# sourceMappingURL=ArtifactCompletionFailed.d.ts.map

package/dist/artifacts/ArtifactCompletionFailed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactCompletionFailed.d.ts","sourceRoot":"","sources":["../../artifacts/ArtifactCompletionFailed.ts"],"names":[],"mappings":"AAGA,uGAAuG;AACvG,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,YAAY,eAAe,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,EAQ9D;CACJ"}

package/dist/artifacts/ArtifactCompletionFailed.js

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** A lease completion failure that prevents acknowledgement, including when processing also failed. */
+export class ArtifactCompletionFailed extends Error {
+    /** The original completion rejection. */
+    completionError;
+    /** The original processing rejection, if processing also failed. */
+    processingError;
+    constructor(completionError, processingError) {
+        super(`Artifact completion failed: ${String(completionError)}`, { cause: completionError });
+        this.name = 'ArtifactCompletionFailed';
+        this.completionError = completionError;
+        this.processingError = processingError;
+        if (processingError instanceof Error) {
+            this.stack += `\nProcessing failure:\n${processingError.stack ?? String(processingError)}`;
+        }
+    }
+}
+//# sourceMappingURL=ArtifactCompletionFailed.js.map

package/dist/artifacts/ArtifactCompletionFailed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactCompletionFailed.js","sourceRoot":"","sources":["../../artifacts/ArtifactCompletionFailed.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,uGAAuG;AACvG,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC/C,yCAAyC;IAChC,eAAe,CAAU;IAClC,oEAAoE;IAC3D,eAAe,CAAU;IAElC,YAAY,eAAwB,EAAE,eAAyB;QAC3D,KAAK,CAAC,+BAA+B,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,eAAe,YAAY,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,IAAI,0BAA0B,eAAe,CAAC,KAAK,IAAI,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/F,CAAC;IACL,CAAC;CACJ"}

package/dist/artifacts/ArtifactInvocationContext.d.ts

@@ -0,0 +1,18 @@
+import type { ReplayState } from '@cratis/chronicle.contracts';
+import type { EventContext } from '../events/EventContext.js';
+import { ArtifactDelivery } from './ArtifactDelivery.js';
+/** Metadata for a single invocation within an activated artifact's delivery lease. */
+export type ArtifactInvocationContext = {
+    /** An event handler invocation; each event has its own context, even within a shared batch lease. */
+    readonly delivery: ArtifactDelivery.Events;
+    /** The context of the event currently being handled. */
+    readonly eventContext: EventContext;
+    /** The handler method invoked for this event. */
+    readonly methodName: string;
+} | {
+    /** A replay lifecycle notification, activated separately from event batches. */
+    readonly delivery: ArtifactDelivery.ReplayNotification;
+    /** The replay transition being notified. */
+    readonly replayState: ReplayState;
+};
+//# sourceMappingURL=ArtifactInvocationContext.d.ts.map

package/dist/artifacts/ArtifactInvocationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactInvocationContext.d.ts","sourceRoot":"","sources":["../../artifacts/ArtifactInvocationContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,sFAAsF;AACtF,MAAM,MAAM,yBAAyB,GAAG;IACpC,qGAAqG;IACrG,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC;IAC3C,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B,GAAG;IACA,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,kBAAkB,CAAC;IACvD,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC"}

package/dist/artifacts/ArtifactInvocationContext.js

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

package/dist/artifacts/ArtifactInvocationContext.js.map

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

package/dist/artifacts/index.d.ts

@@ -1,6 +1,8 @@
 export { ArtifactKind } from './ArtifactKind.js';
 export { ArtifactDelivery } from './ArtifactDelivery.js';
 export type { ArtifactActivationContext } from './ArtifactActivationContext.js';
+export type { ArtifactInvocationContext } from './ArtifactInvocationContext.js';
+export { ArtifactCompletionFailed } from './ArtifactCompletionFailed.js';
 export type { ActivatedArtifact } from './ActivatedArtifact.js';
 export type { ClientArtifactsActivator } from './ClientArtifactsActivator.js';
 export type { IClientArtifactsProvider } from './IClientArtifactsProvider.js';

package/dist/artifacts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../artifacts/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../artifacts/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/artifacts/index.js

@@ -2,5 +2,6 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 export { ArtifactKind } from './ArtifactKind.js';
 export { ArtifactDelivery } from './ArtifactDelivery.js';
+export { ArtifactCompletionFailed } from './ArtifactCompletionFailed.js';
 export { DefaultClientArtifactsProvider } from './DefaultClientArtifactsProvider.js';
 //# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../artifacts/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../artifacts/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/artifacts/withActivatedArtifact.d.ts

@@ -1,9 +1,10 @@
 import type { Constructor } from '@cratis/fundamentals';
 import type { ActivatedArtifact } from './ActivatedArtifact.js';
 import type { ArtifactActivationContext } from './ArtifactActivationContext.js';
+import type { ArtifactInvocationContext } from './ArtifactInvocationContext.js';
 import type { ClientArtifactsActivator } from './ClientArtifactsActivator.js';
 /** Activates once per delivery and always releases the lease before acknowledgement. */
 export declare function withActivatedArtifact<T, R>(type: Constructor<T>, context: ArtifactActivationContext, activator: ClientArtifactsActivator, callback: (artifact: ActivatedArtifact<T>) => Promise<R>): Promise<R>;
 /** Enters an optional execution boundary for one handler and all of its returned effects. */
-export declare function runActivated<R>(artifact: ActivatedArtifact<unknown>, callback: () => R | Promise<R>): Promise<R>;
+export declare function runActivated<R>(artifact: ActivatedArtifact<unknown>, callback: () => R | Promise<R>, invocation: ArtifactInvocationContext): Promise<R>;
 //# sourceMappingURL=withActivatedArtifact.d.ts.map

package/dist/artifacts/withActivatedArtifact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withActivatedArtifact.d.ts","sourceRoot":"","sources":["../../artifacts/withActivatedArtifact.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAI9E,wFAAwF;AACxF,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAC5C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,SAAS,EAAE,wBAAwB,EAC7F,QAAQ,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,6FAA6F;AAC7F,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEtH"}
+{"version":3,"file":"withActivatedArtifact.d.ts","sourceRoot":"","sources":["../../artifacts/withActivatedArtifact.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAI9E,wFAAwF;AACxF,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAC5C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,SAAS,EAAE,wBAAwB,EAC7F,QAAQ,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CA0BZ;AAED,6FAA6F;AAC7F,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,yBAAyB,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7J"}

package/dist/artifacts/withActivatedArtifact.js

@@ -1,12 +1,31 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 import { diag } from '@opentelemetry/api';
+import { ArtifactCompletionFailed } from './ArtifactCompletionFailed.js';
 const logger = diag.createComponentLogger({ namespace: '@cratis/chronicle/artifacts' });
 /** Activates once per delivery and always releases the lease before acknowledgement. */
 export async function withActivatedArtifact(type, context, activator, callback) {
     const artifact = await activator(type, context);
     try {
-        return await callback(artifact);
+        let result;
+        let processingFailed = false;
+        let processingError;
+        try {
+            result = await callback(artifact);
+        }
+        catch (error) {
+            processingFailed = true;
+            processingError = error;
+        }
+        try {
+            await artifact.complete?.();
+        }
+        catch (error) {
+            throw new ArtifactCompletionFailed(error, processingFailed ? processingError : undefined);
+        }
+        if (processingFailed)
+            throw processingError;
+        return result;
     }
     finally {
         try {
@@ -18,7 +37,7 @@ export async function withActivatedArtifact(type, context, activator, callback)
     }
 }
 /** Enters an optional execution boundary for one handler and all of its returned effects. */
-export async function runActivated(artifact, callback) {
-    return artifact.run ? artifact.run(callback) : callback();
+export async function runActivated(artifact, callback, invocation) {
+    return artifact.run ? artifact.run(callback, invocation) : callback();
 }
 //# sourceMappingURL=withActivatedArtifact.js.map

package/dist/artifacts/withActivatedArtifact.js.map

@@ -1 +1 @@
-{"version":3,"file":"withActivatedArtifact.js","sourceRoot":"","sources":["../../artifacts/withActivatedArtifact.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAM1C,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,6BAA6B,EAAE,CAAC,CAAC;AAExF,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,IAAoB,EAAE,OAAkC,EAAE,SAAmC,EAC7F,QAAwD;IAExD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACP,IAAI,CAAC;YACD,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrI,CAAC;IACL,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAoC,EAAE,QAA8B;IACtG,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"withActivatedArtifact.js","sourceRoot":"","sources":["../../artifacts/withActivatedArtifact.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,6BAA6B,EAAE,CAAC,CAAC;AAExF,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,IAAoB,EAAE,OAAkC,EAAE,SAAmC,EAC7F,QAAwD;IAExD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC;QACD,IAAI,MAAU,CAAC;QACf,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,eAAwB,CAAC;QAC7B,IAAI,CAAC;YACD,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,gBAAgB,GAAG,IAAI,CAAC;YACxB,eAAe,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC;YACD,MAAM,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,gBAAgB;YAAE,MAAM,eAAe,CAAC;QAC5C,OAAO,MAAM,CAAC;IAClB,CAAC;YAAS,CAAC;QACP,IAAI,CAAC;YACD,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrI,CAAC;IACL,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAoC,EAAE,QAA8B,EAAE,UAAqC;IAC7I,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC1E,CAAC"}

package/dist/projections/CompiledProjectionDefinitions.d.ts

@@ -1,10 +1,16 @@
 import type { ProjectionDefinition } from '@cratis/chronicle.contracts';
 import type { buildReadModelDefinition } from '../readModels/buildReadModelDefinition.js';
+import type { ProjectionCapabilityProvenance } from './ProjectionCapabilityProvenance.js';
+import type { ProjectionEventSchema } from './ProjectionEventSchema.js';
 /** Connection-independent contracts produced for projection registration. */
 export interface CompiledProjectionDefinitions {
     /** The final wire definitions, including variant cross-wiring and LastUpdated hashes. */
     readonly definitions: ProjectionDefinition[];
     /** Read models registered before the projections. */
     readonly readModels: ReturnType<typeof buildReadModelDefinition>[];
+    /** Pre-lowering declaration-to-contract paths, keyed by final definition identity. */
+    readonly provenance: ReadonlyMap<ProjectionDefinition, readonly ProjectionCapabilityProvenance[]>;
+    /** Isolated schemas for every event referenced by each definition, keyed by id:generation:tombstone. */
+    readonly eventSchemas: ReadonlyMap<ProjectionDefinition, ReadonlyMap<string, ProjectionEventSchema>>;
 }
 //# sourceMappingURL=CompiledProjectionDefinitions.d.ts.map

package/dist/projections/CompiledProjectionDefinitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompiledProjectionDefinitions.d.ts","sourceRoot":"","sources":["../../projections/CompiledProjectionDefinitions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAE1F,6EAA6E;AAC7E,MAAM,WAAW,6BAA6B;IAC1C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,EAAE,CAAC;CACtE"}
+{"version":3,"file":"CompiledProjectionDefinitions.d.ts","sourceRoot":"","sources":["../../projections/CompiledProjectionDefinitions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,6EAA6E;AAC7E,MAAM,WAAW,6BAA6B;IAC1C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,EAAE,CAAC;IACnE,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,oBAAoB,EAAE,SAAS,8BAA8B,EAAE,CAAC,CAAC;IAClG,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;CACxG"}

package/dist/projections/ProjectionCapabilityProvenance.d.ts

@@ -0,0 +1,8 @@
+/** A declaration and the contract path it produced, captured before variant lowering. */
+export interface ProjectionCapabilityProvenance {
+    /** Stable path into the compiled projection contract. */
+    readonly contractPath: string;
+    /** Source declaration responsible for the contract entry. */
+    readonly declaration: string;
+}
+//# sourceMappingURL=ProjectionCapabilityProvenance.d.ts.map

package/dist/projections/ProjectionCapabilityProvenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionCapabilityProvenance.d.ts","sourceRoot":"","sources":["../../projections/ProjectionCapabilityProvenance.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,WAAW,8BAA8B;IAC3C,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC"}

package/dist/projections/ProjectionCapabilityProvenance.js

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

package/dist/projections/ProjectionCapabilityProvenance.js.map

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

package/dist/projections/ProjectionDefinitionCompiler.d.ts

@@ -17,6 +17,7 @@ export declare class ProjectionDefinitionCompiler {
      * @returns Projection definitions and read-model registrations ready for the wire.
      */
     compile(declarative: Iterable<Constructor>, modelBound: Iterable<Constructor>): CompiledProjectionDefinitions;
+    private buildEventSchemaCatalog;
     private buildWithContextValidation;
     private buildReadModelDefinitions;
     private getReadModelType;

package/dist/projections/ProjectionDefinitionCompiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectionDefinitionCompiler.d.ts","sourceRoot":"","sources":["../../projections/ProjectionDefinitionCompiler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAUjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAgCnF,wGAAwG;AACxG,qBAAa,4BAA4B;IAMjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IANvC;;;OAGG;IACH,YACqB,gBAAgB,EAAE,wBAAwB,EAC1C,kBAAkB,EAAE,MAAM,EAC3C;IAEJ;;;;;OAKG;IACH,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,6BAA6B,CAqB5G;IAED,OAAO,CAAC,0BAA0B;IAYlC,OAAO,CAAC,yBAAyB;IAgCjC,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,0BAA0B;IAoClC,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,yBAAyB;IA0JjC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,eAAe;IAevB,yFAAyF;IACzF,OAAO,CAAC,wBAAwB;CASnC"}
+{"version":3,"file":"ProjectionDefinitionCompiler.d.ts","sourceRoot":"","sources":["../../projections/ProjectionDefinitionCompiler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAWjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AA6CnF,wGAAwG;AACxG,qBAAa,4BAA4B;IAMjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IANvC;;;OAGG;IACH,YACqB,gBAAgB,EAAE,wBAAwB,EAC1C,kBAAkB,EAAE,MAAM,EAC3C;IAEJ;;;;;OAKG;IACH,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,6BAA6B,CAiC5G;IAED,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,0BAA0B;IAYlC,OAAO,CAAC,yBAAyB;IAgCjC,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,0BAA0B;IA6ClC,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,yBAAyB;IAqNjC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,eAAe;IAevB,yFAAyF;IACzF,OAAO,CAAC,wBAAwB;CASnC"}