@temelj/workflow 0.0.0-alpha.2 → 0.0.0-alpha.4

package/dist/errors/step.mjs

@@ -1,14 +1,13 @@
-import { WorkflowErrorCode } from "../types/error-code.mjs";
+import { WorkflowErrorCode } from "./codes.mjs";
 import { WorkflowStepError } from "./base.mjs";
 //#region src/errors/step.ts
-/** Error thrown for step timeout failures. */
-var WorkflowStepTimeoutError = class WorkflowStepTimeoutError extends WorkflowStepError {
+var WorkflowStepTimeoutError = class extends WorkflowStepError {
 	runId;
 	stepId;
 	stepName;
 	attempt;
 	timeoutAt;
-	constructor(options, context) {
+	constructor(options) {
 		super(`Workflow step timed out: ${options.stepName} for run ${options.runId} attempt ${options.attempt} at ${options.timeoutAt.toString()}`, {
 			code: WorkflowErrorCode.STEP_TIMEOUT,
 			details: {
@@ -18,7 +17,7 @@ var WorkflowStepTimeoutError = class WorkflowStepTimeoutError extends WorkflowSt
 				attempt: options.attempt,
 				timeoutAt: options.timeoutAt.toString()
 			}
-		}, context);
+		});
 		this.name = "WorkflowStepTimeoutError";
 		this.runId = options.runId;
 		this.stepId = options.stepId;
@@ -26,19 +25,12 @@ var WorkflowStepTimeoutError = class WorkflowStepTimeoutError extends WorkflowSt
 		this.attempt = options.attempt;
 		this.timeoutAt = options.timeoutAt;
 	}
-	static timedOut(options) {
-		throw new WorkflowStepTimeoutError(options, WorkflowStepTimeoutError.timedOut);
-	}
-	static create(options) {
-		return new WorkflowStepTimeoutError(options, WorkflowStepTimeoutError.create);
-	}
 };
-/** Error thrown for step execution failures. */
 var WorkflowStepExecutionError = class WorkflowStepExecutionError extends WorkflowStepError {
 	stepId;
 	stepName;
 	attempt;
-	constructor(options, context) {
+	constructor(options) {
 		super(`Workflow step failed: ${options.stepName}`, {
 			code: WorkflowErrorCode.STEP_EXECUTION_FAILED,
 			cause: options.cause,
@@ -47,25 +39,22 @@ var WorkflowStepExecutionError = class WorkflowStepExecutionError extends Workfl
 				stepName: options.stepName,
 				attempt: options.attempt
 			}
-		}, context);
+		});
 		this.name = "WorkflowStepExecutionError";
 		this.stepId = options.stepId;
 		this.stepName = options.stepName;
 		this.attempt = options.attempt;
 	}
 	static failed(options) {
-		throw new WorkflowStepExecutionError(options, WorkflowStepExecutionError.failed);
-	}
-	static create(options) {
-		return new WorkflowStepExecutionError(options, WorkflowStepExecutionError.create);
+		throw new WorkflowStepExecutionError(options);
 	}
 };
 /** Error thrown when a step exhausts its retry policy. */
-var WorkflowStepRetryLimitError = class WorkflowStepRetryLimitError extends WorkflowStepError {
+var WorkflowStepRetryLimitError = class extends WorkflowStepError {
 	stepId;
 	stepName;
 	attempt;
-	constructor(options, context) {
+	constructor(options) {
 		super(`Workflow step retry limit exceeded: ${options.stepName}`, {
 			code: WorkflowErrorCode.STEP_RETRY_LIMIT_EXCEEDED,
 			details: {
@@ -73,40 +62,30 @@ var WorkflowStepRetryLimitError = class WorkflowStepRetryLimitError extends Work
 				stepName: options.stepName,
 				attempt: options.attempt
 			}
-		}, context);
+		});
 		this.name = "WorkflowStepRetryLimitError";
 		this.stepId = options.stepId;
 		this.stepName = options.stepName;
 		this.attempt = options.attempt;
 	}
-	static exceeded(options) {
-		throw new WorkflowStepRetryLimitError(options, WorkflowStepRetryLimitError.exceeded);
-	}
-	static create(options) {
-		return new WorkflowStepRetryLimitError(options, WorkflowStepRetryLimitError.create);
-	}
 };
-/** Error thrown for step attempt limit failures. */
 var WorkflowStepAttemptLimitError = class WorkflowStepAttemptLimitError extends WorkflowStepError {
 	runId;
 	maximumAttempts;
-	constructor(runId, maximumAttempts, context) {
+	constructor(runId, maximumAttempts) {
 		super(`Workflow run exceeded total step attempt limit: ${runId} (${maximumAttempts})`, {
 			code: WorkflowErrorCode.STEP_ATTEMPT_LIMIT_EXCEEDED,
 			details: {
 				runId,
 				maximumAttempts
 			}
-		}, context);
+		});
 		this.name = "WorkflowStepAttemptLimitError";
 		this.runId = runId;
 		this.maximumAttempts = maximumAttempts;
 	}
 	static exceeded(runId, maximumAttempts) {
-		throw new WorkflowStepAttemptLimitError(runId, maximumAttempts, WorkflowStepAttemptLimitError.exceeded);
-	}
-	static create(runId, maximumAttempts) {
-		return new WorkflowStepAttemptLimitError(runId, maximumAttempts, WorkflowStepAttemptLimitError.create);
+		throw new WorkflowStepAttemptLimitError(runId, maximumAttempts);
 	}
 };
 //#endregion

package/dist/errors/stream.d.mts

@@ -1,24 +1,16 @@
-import { WorkflowErrorCode } from "../types/error-code.mjs";
-import { StreamIdOrName } from "../types/stream-id.mjs";
-import { WorkflowErrorDetails } from "../types/error.mjs";
+import { WorkflowErrorCode } from "./codes.mjs";
+import { StreamIdOrName } from "../types/ids.mjs";
+import { ErrorDetails } from "../types/error.mjs";
 import { WorkflowOptionsError } from "./base.mjs";
 //#region src/errors/stream.d.ts
 /** Errors caused by invalid stream operations or stream history. */
-declare class WorkflowStreamError extends WorkflowOptionsError {
-  constructor(message: string, code: WorkflowErrorCode, details?: WorkflowErrorDetails, context?: Function);
-  static chunkLimitExceeded(this: void, streamId: string, maximumChunks: number): never;
+export declare class WorkflowStreamError extends WorkflowOptionsError {
+  constructor(message: string, code: WorkflowErrorCode, details?: ErrorDetails);
   static readOffsetConflict(this: void): never;
-  static nonContiguousChunkIndex(this: void, streamId: string, actualIndex: number, expectedIndex: number): never;
-  static chunkAfterTerminal(this: void, streamId: string, chunkIndex: number, terminalKind: string): never;
-  static alreadyClosed(this: void, streamId: string): never;
 }
 /** Error thrown when a requested workflow stream cannot be found. */
-declare class WorkflowStreamNotFoundError extends WorkflowOptionsError {
+export declare class WorkflowStreamNotFoundError extends WorkflowOptionsError {
   readonly streamIdOrName: StreamIdOrName;
-  constructor(streamIdOrName: StreamIdOrName, context?: Function);
-  static notFound(this: void, streamIdOrName: StreamIdOrName): never;
-  static create(this: void, streamIdOrName: StreamIdOrName): WorkflowStreamNotFoundError;
-  static isNotFound(error: unknown, streamIdOrName?: StreamIdOrName): boolean;
+  constructor(streamIdOrName: StreamIdOrName);
 }
-//#endregion
-export { WorkflowStreamError, WorkflowStreamNotFoundError };
+//#endregion

package/dist/errors/stream.mjs

@@ -1,64 +1,30 @@
-import { WorkflowErrorCode } from "../types/error-code.mjs";
+import { WorkflowErrorCode } from "./codes.mjs";
 import { WorkflowOptionsError } from "./base.mjs";
-import { workflowErrorRecordView } from "./record-view.mjs";
 //#region src/errors/stream.ts
 /** Errors caused by invalid stream operations or stream history. */
 var WorkflowStreamError = class WorkflowStreamError extends WorkflowOptionsError {
-	constructor(message, code, details, context) {
-		super(message, context, {
+	constructor(message, code, details) {
+		super(message, {
 			code,
 			details
 		});
 		this.name = "WorkflowStreamError";
 	}
-	static chunkLimitExceeded(streamId, maximumChunks) {
-		throw new WorkflowStreamError(`Workflow stream ${streamId} chunk count would exceed maximumStreamChunks ${maximumChunks}`, WorkflowErrorCode.STREAM_CHUNK_LIMIT_EXCEEDED, {
-			streamId,
-			maximumChunks
-		}, WorkflowStreamError.chunkLimitExceeded);
-	}
 	static readOffsetConflict() {
-		throw new WorkflowStreamError("Cannot include both fromIndex and fromTail", WorkflowErrorCode.STREAM_READ_OFFSET_CONFLICT, void 0, WorkflowStreamError.readOffsetConflict);
-	}
-	static nonContiguousChunkIndex(streamId, actualIndex, expectedIndex) {
-		throw new WorkflowStreamError(`Workflow stream ${streamId} has non-contiguous chunk index ${actualIndex}; expected ${expectedIndex}`, WorkflowErrorCode.STREAM_CHUNK_INDEX_NON_CONTIGUOUS, {
-			streamId,
-			actualIndex,
-			expectedIndex
-		}, WorkflowStreamError.nonContiguousChunkIndex);
-	}
-	static chunkAfterTerminal(streamId, chunkIndex, terminalKind) {
-		throw new WorkflowStreamError(`Workflow stream ${streamId} has chunk ${chunkIndex} after terminal event ${terminalKind}`, WorkflowErrorCode.STREAM_CHUNK_AFTER_TERMINAL, {
-			streamId,
-			chunkIndex,
-			terminalKind
-		}, WorkflowStreamError.chunkAfterTerminal);
-	}
-	static alreadyClosed(streamId) {
-		throw new WorkflowStreamError(`Workflow stream is already closed: ${streamId}`, WorkflowErrorCode.STREAM_ALREADY_CLOSED, { streamId }, WorkflowStreamError.alreadyClosed);
+		throw new WorkflowStreamError("Cannot include both fromIndex and fromTail", WorkflowErrorCode.STREAM_READ_OFFSET_CONFLICT, void 0);
 	}
 };
 /** Error thrown when a requested workflow stream cannot be found. */
-var WorkflowStreamNotFoundError = class WorkflowStreamNotFoundError extends WorkflowOptionsError {
+var WorkflowStreamNotFoundError = class extends WorkflowOptionsError {
 	streamIdOrName;
-	constructor(streamIdOrName, context) {
-		super(`Workflow stream was not found: ${streamIdOrName}`, context, {
+	constructor(streamIdOrName) {
+		super(`Workflow stream was not found: ${streamIdOrName}`, {
 			code: WorkflowErrorCode.STREAM_NOT_FOUND,
 			details: { streamIdOrName }
 		});
 		this.name = "WorkflowStreamNotFoundError";
 		this.streamIdOrName = streamIdOrName;
 	}
-	static notFound(streamIdOrName) {
-		throw new WorkflowStreamNotFoundError(streamIdOrName, WorkflowStreamNotFoundError.notFound);
-	}
-	static create(streamIdOrName) {
-		return new WorkflowStreamNotFoundError(streamIdOrName, WorkflowStreamNotFoundError.create);
-	}
-	static isNotFound(error, streamIdOrName) {
-		const record = workflowErrorRecordView(error);
-		return record?.code === WorkflowErrorCode.STREAM_NOT_FOUND && (streamIdOrName === void 0 || record.details?.streamIdOrName === streamIdOrName);
-	}
 };
 //#endregion
 export { WorkflowStreamError, WorkflowStreamNotFoundError };

package/dist/esbuild.d.mts

@@ -1,7 +1,9 @@
-import { WorkflowPluginOptions } from "./types/vite.mjs";
-import { workflowPlugin } from "./vite/plugin.mjs";
+import { PluginOptions } from "./types/compiler.mjs";
+import { workflowPlugin } from "./compiler/plugin.mjs";
+import "./esbuild.mjs";
+import "temporal-polyfill/global";
 //#region src/esbuild.d.ts
 /** Creates the esbuild plugin that compiles workflow and step directives. */
-declare const workflow: (options?: WorkflowPluginOptions | undefined) => import("esbuild").Plugin;
+export declare const workflow: (options?: PluginOptions | undefined) => import("esbuild").Plugin;
 //#endregion
-export { type WorkflowPluginOptions, workflow, workflowPlugin };
+export { type PluginOptions, workflowPlugin };

package/dist/esbuild.mjs

@@ -1,4 +1,5 @@
-import { workflowPlugin } from "./vite/plugin.mjs";
+import { workflowPlugin } from "./compiler/plugin.mjs";
+import "temporal-polyfill/global";
 //#region src/esbuild.ts
 /** Creates the esbuild plugin that compiles workflow and step directives. */
 const workflow = workflowPlugin.esbuild;

package/dist/events/descriptors.d.mts

@@ -1,245 +1,16 @@
-import { StepId } from "../types/step-id.mjs";
-import "../types/step.mjs";
-import { EventDescriptor, EventKind, EventRecord } from "../types/events.mjs";
+import { StepId } from "../types/ids.mjs";
+import { EventDescriptor, EventFieldName, EventFieldValue, EventKind, EventRecord } from "../types/events.mjs";
 //#region src/events/descriptors.d.ts
-declare const WORKFLOW_EVENT_DESCRIPTORS: {
-  readonly workflow_started: {
-    readonly kind: "workflow_started";
-    readonly category: "workflow";
-    readonly cleanup: true;
-    readonly identityFields: readonly [];
-  };
-  readonly workflow_completed: {
-    readonly kind: "workflow_completed";
-    readonly category: "workflow";
-    readonly cleanup: true;
-    readonly identityFields: readonly [];
-  };
-  readonly workflow_failed: {
-    readonly kind: "workflow_failed";
-    readonly category: "workflow";
-    readonly cleanup: true;
-    readonly identityFields: readonly [];
-  };
-  readonly step_started: {
-    readonly kind: "step_started";
-    readonly category: "step";
-    readonly cleanup: true;
-    readonly stepType: "run";
-    readonly stepAttempt: "event";
-    readonly identityFields: readonly ["stepId", "stepName", "count", "attempt"];
-  };
-  readonly step_completed: {
-    readonly kind: "step_completed";
-    readonly category: "step";
-    readonly cleanup: true;
-    readonly stepType: "run";
-    readonly stepAttempt: "event";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "step_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "attempt"];
-    readonly identityFields: readonly ["stepId", "stepName", "attempt"];
-  };
-  readonly step_failed: {
-    readonly kind: "step_failed";
-    readonly category: "step";
-    readonly cleanup: true;
-    readonly stepType: "run";
-    readonly stepAttempt: "event";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "step_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "attempt"];
-    readonly identityFields: readonly ["stepId", "stepName", "attempt"];
-  };
-  readonly sleep_started: {
-    readonly kind: "sleep_started";
-    readonly category: "sleep";
-    readonly cleanup: true;
-    readonly stepType: "sleep";
-    readonly stepAttempt: "single";
-    readonly identityFields: readonly ["stepId", "stepName", "count", "until"];
-  };
-  readonly sleep_completed: {
-    readonly kind: "sleep_completed";
-    readonly category: "sleep";
-    readonly cleanup: true;
-    readonly stepType: "sleep";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "sleep_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName"];
-    readonly identityFields: readonly ["stepId", "stepName"];
-  };
-  readonly child_workflow_started: {
-    readonly kind: "child_workflow_started";
-    readonly category: "child_workflow";
-    readonly cleanup: true;
-    readonly stepType: "workflow";
-    readonly stepAttempt: "event";
-    readonly identityFields: readonly ["stepId", "stepName", "count", "attempt", "childRunId", "cancellation"];
-  };
-  readonly child_workflow_completed: {
-    readonly kind: "child_workflow_completed";
-    readonly category: "child_workflow";
-    readonly cleanup: true;
-    readonly stepType: "workflow";
-    readonly stepAttempt: "event";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "child_workflow_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "attempt", "childRunId"];
-    readonly identityFields: readonly ["stepId", "stepName", "attempt", "childRunId"];
-  };
-  readonly child_workflow_failed: {
-    readonly kind: "child_workflow_failed";
-    readonly category: "child_workflow";
-    readonly cleanup: true;
-    readonly stepType: "workflow";
-    readonly stepAttempt: "event";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "child_workflow_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "attempt", "childRunId"];
-    readonly identityFields: readonly ["stepId", "stepName", "attempt", "childRunId"];
-  };
-  readonly message_sent: {
-    readonly kind: "message_sent";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly identityFields: readonly ["messageId", "idempotencyKey"];
-    readonly valueIdentityFields: readonly ["payload"];
-    readonly stringListIdentityFields: readonly ["waiterStepIds"];
-  };
-  readonly message_send_started: {
-    readonly kind: "message_send_started";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly stepType: "message-send";
-    readonly stepAttempt: "single";
-    readonly identityFields: readonly ["stepId", "stepName", "count", "targetRunId", "messageId"];
-  };
-  readonly message_send_completed: {
-    readonly kind: "message_send_completed";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly stepType: "message-send";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "message_send_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "targetRunId", "messageId"];
-    readonly identityFields: readonly ["stepId", "stepName", "targetRunId", "messageId"];
-  };
-  readonly message_send_failed: {
-    readonly kind: "message_send_failed";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly stepType: "message-send";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "message_send_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "targetRunId", "messageId"];
-    readonly identityFields: readonly ["stepId", "stepName", "targetRunId", "messageId"];
-  };
-  readonly message_wait_started: {
-    readonly kind: "message_wait_started";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly stepType: "message-wait";
-    readonly stepAttempt: "single";
-    readonly identityFields: readonly ["stepId", "stepName", "count", "messageId"];
-  };
-  readonly message_wait_completed: {
-    readonly kind: "message_wait_completed";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly stepType: "message-wait";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "message_wait_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "messageId"];
-    readonly identityFields: readonly ["stepId", "stepName", "messageId", "messageTimestamp"];
-  };
-  readonly message_wait_failed: {
-    readonly kind: "message_wait_failed";
-    readonly category: "message";
-    readonly cleanup: true;
-    readonly stepType: "message-wait";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "message_wait_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "messageId"];
-    readonly identityFields: readonly ["stepId", "stepName", "messageId"];
-  };
-  readonly stream_started: {
-    readonly kind: "stream_started";
-    readonly category: "stream";
-    readonly cleanup: true;
-    readonly stepType: "stream";
-    readonly stepAttempt: "single";
-    readonly identityFields: readonly ["stepId", "stepName", "count", "streamId", "contentType"];
-    readonly valueIdentityFields: readonly ["metadata"];
-  };
-  readonly stream_chunk: {
-    readonly kind: "stream_chunk";
-    readonly category: "stream";
-    readonly cleanup: true;
-    readonly identityFields: readonly ["stepId", "stepName", "streamId", "index"];
-    readonly valueIdentityFields: readonly ["chunk"];
-  };
-  readonly stream_closed: {
-    readonly kind: "stream_closed";
-    readonly category: "stream";
-    readonly cleanup: true;
-    readonly stepType: "stream";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "stream_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "streamId"];
-    readonly identityFields: readonly ["stepId", "stepName", "streamId"];
-  };
-  readonly stream_failed: {
-    readonly kind: "stream_failed";
-    readonly category: "stream";
-    readonly cleanup: true;
-    readonly stepType: "stream";
-    readonly stepAttempt: "single";
-    readonly terminalStepAttempt: true;
-    readonly startedEventType: "stream_started";
-    readonly startedEventMatchFields: readonly ["stepId", "stepName", "streamId"];
-    readonly identityFields: readonly ["stepId", "stepName", "streamId"];
-  };
-  readonly deterministic_value_recorded: {
-    readonly kind: "deterministic_value_recorded";
-    readonly category: "deterministic";
-    readonly cleanup: true;
-    readonly stepType: "deterministic";
-    readonly stepAttempt: "single";
-    readonly identityFields: readonly ["stepId", "stepName", "count"];
-    readonly valueIdentityFields: readonly ["value"];
-  };
-  readonly metadata_set: {
-    readonly kind: "metadata_set";
-    readonly category: "metadata";
-    readonly cleanup: false;
-    readonly stepType: "metadata";
-    readonly identityFields: readonly ["stepId", "stepName", "count"];
-    readonly valueIdentityFields: readonly ["metadata"];
-  };
-  readonly attributes_set: {
-    readonly kind: "attributes_set";
-    readonly category: "metadata";
-    readonly cleanup: false;
-    readonly stepType: "attributes";
-    readonly identityFields: readonly ["stepId", "stepName", "count"];
-    readonly valueIdentityFields: readonly ["attributes"];
-  };
-};
-declare function isEventKindForCleanup(kind: string): kind is EventKind;
-declare function isCleanupEventRecord(event: EventRecord): boolean;
-declare function isWorkflowRecordedStepEventKind(kind: string): kind is EventKind;
-declare function isWorkflowTerminalStepAttemptEvent(event: EventRecord): event is EventRecord & {
+export declare function isCleanupEventRecord(event: EventRecord): boolean;
+export declare function isWorkflowRecordedStepEventKind(kind: string): kind is EventKind;
+export declare function isWorkflowTerminalStepAttemptEvent(event: EventRecord): event is EventRecord & {
   readonly stepId: StepId;
 };
-declare function getWorkflowEventStepAttempt(event: EventRecord): number | undefined;
-declare function getWorkflowEventStepAttemptKey(event: EventRecord): string | undefined;
-declare function getEventDescriptor(kind: EventKind): EventDescriptor;
+export declare function getWorkflowEventStepAttempt(event: EventRecord): number | undefined;
+export declare function getWorkflowEventStepAttemptKey(event: EventRecord): string | undefined;
+export declare function getEventDescriptor(kind: EventKind): EventDescriptor;
+/** Reads a descriptor-selected field from a durable event variant. */
+export declare function getEventField(event: EventRecord, field: EventFieldName): EventFieldValue | undefined;
+export declare function eventFieldsMatch(left: EventRecord, right: EventRecord, fields?: readonly EventFieldName[]): boolean;
 //#endregion
-export { type EventDescriptor, WORKFLOW_EVENT_DESCRIPTORS, getEventDescriptor, getWorkflowEventStepAttempt, getWorkflowEventStepAttemptKey, isCleanupEventRecord, isEventKindForCleanup, isWorkflowRecordedStepEventKind, isWorkflowTerminalStepAttemptEvent };
+export type { EventDescriptor };

package/dist/events/descriptors.mjs

@@ -1,4 +1,4 @@
-import { makeWorkflowStepAttemptKey } from "../history/attempt-key.mjs";
+import { stepAttemptKey } from "../store-keys.mjs";
 //#region src/events/descriptors.ts
 function defineEventDescriptors(descriptors) {
 	return descriptors;
@@ -374,8 +374,8 @@ const WORKFLOW_EVENT_DESCRIPTORS = defineEventDescriptors({
 	}
 });
 const WORKFLOW_EVENT_KINDS_FOR_CLEANUP = new Set(Object.values(WORKFLOW_EVENT_DESCRIPTORS).filter((descriptor) => descriptor.cleanup).map((descriptor) => descriptor.kind));
-const WORKFLOW_RECORDED_STEP_EVENT_KINDS = new Set(Object.values(WORKFLOW_EVENT_DESCRIPTORS).filter((descriptor) => descriptor.stepType !== void 0).map((descriptor) => descriptor.kind));
-const WORKFLOW_TERMINAL_STEP_EVENT_KINDS = new Set(Object.values(WORKFLOW_EVENT_DESCRIPTORS).filter((descriptor) => descriptor.terminalStepAttempt === true).map((descriptor) => descriptor.kind));
+const WORKFLOW_RECORDED_STEP_EVENT_KINDS = new Set(Object.values(WORKFLOW_EVENT_DESCRIPTORS).filter((descriptor) => "stepType" in descriptor).map((descriptor) => descriptor.kind));
+const WORKFLOW_TERMINAL_STEP_EVENT_KINDS = new Set(Object.values(WORKFLOW_EVENT_DESCRIPTORS).filter((descriptor) => "terminalStepAttempt" in descriptor && descriptor.terminalStepAttempt === true).map((descriptor) => descriptor.kind));
 function isEventKindForCleanup(kind) {
 	return WORKFLOW_EVENT_KINDS_FOR_CLEANUP.has(kind);
 }
@@ -396,10 +396,17 @@ function getWorkflowEventStepAttempt(event) {
 function getWorkflowEventStepAttemptKey(event) {
 	if (!("stepId" in event)) return;
 	const attempt = getWorkflowEventStepAttempt(event);
-	return attempt === void 0 ? void 0 : makeWorkflowStepAttemptKey(event.stepId, attempt);
+	return attempt === void 0 ? void 0 : stepAttemptKey(event.stepId, attempt);
 }
 function getEventDescriptor(kind) {
 	return WORKFLOW_EVENT_DESCRIPTORS[kind];
 }
+/** Reads a descriptor-selected field from a durable event variant. */
+function getEventField(event, field) {
+	return event[field];
+}
+function eventFieldsMatch(left, right, fields = []) {
+	return fields.every((field) => getEventField(left, field) === getEventField(right, field));
+}
 //#endregion
-export { WORKFLOW_EVENT_DESCRIPTORS, getEventDescriptor, getWorkflowEventStepAttempt, getWorkflowEventStepAttemptKey, isCleanupEventRecord, isEventKindForCleanup, isWorkflowRecordedStepEventKind, isWorkflowTerminalStepAttemptEvent };
+export { eventFieldsMatch, getEventDescriptor, getEventField, getWorkflowEventStepAttempt, getWorkflowEventStepAttemptKey, isCleanupEventRecord, isWorkflowRecordedStepEventKind, isWorkflowTerminalStepAttemptEvent };

package/dist/history/projection.d.mts

@@ -1,8 +1,6 @@
-import { RunId } from "../types/run-id.mjs";
-import { WorkflowStepAttemptRecord } from "../types/step-attempts.mjs";
-import "../types/run.mjs";
+import { RunId } from "../types/ids.mjs";
+import { StepAttemptRecord } from "../types/step-attempts.mjs";
 import { EventRecord } from "../types/events.mjs";
 //#region src/history/projection.d.ts
-declare function applyWorkflowStepAttemptEvent(runId: RunId, event: EventRecord, current: WorkflowStepAttemptRecord | undefined): WorkflowStepAttemptRecord | undefined;
-//#endregion
-export { applyWorkflowStepAttemptEvent };
+export declare function applyStepAttemptEvent(runId: RunId, event: EventRecord, current: StepAttemptRecord | undefined): StepAttemptRecord | undefined;
+//#endregion