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

package/dist/engine/execution-api.d.mts

@@ -1,29 +0,0 @@
-import { RunId } from "../types/run-id.mjs";
-import { WorkflowImplementation } from "../types/definition.mjs";
-import { ExecutionResult, WorkflowHandle } from "../types/result.mjs";
-import { WorkflowRunRecord } from "../types/run.mjs";
-import { WorkflowExecutionOptions, WorkflowResumeOptions } from "../types/run-options.mjs";
-import { WorkflowConditionalEventAppender, WorkflowEventReader, WorkflowLockConditionalWriterRepository, WorkflowLockListerRepository, WorkflowRunReaderRepository, WorkflowRunWriterRepository, WorkflowStepAttemptLookup } from "../types/store.mjs";
-import { WorkflowRunStarter } from "../types/engine.mjs";
-import { WorkflowExecutionServiceOptions } from "./execution-service.mjs";
-//#region src/engine/execution-api.d.ts
-interface WorkflowEngineExecutionApi {
-  runWorkflow<TInput, TOutput, TRawInput = TInput>(implementation: WorkflowImplementation<TInput, TOutput, TRawInput>, input: TRawInput, options?: WorkflowExecutionOptions): Promise<WorkflowHandle<TOutput>>;
-  runWorkflowNow<TInput, TOutput, TRawInput = TInput>(implementation: WorkflowImplementation<TInput, TOutput, TRawInput>, input: TRawInput, options?: WorkflowExecutionOptions): Promise<ExecutionResult<TOutput>>;
-  resumeWorkflow<TInput, TOutput, TRawInput = TInput>(implementation: WorkflowImplementation<TInput, TOutput, TRawInput>, runId: RunId, options?: WorkflowResumeOptions): Promise<ExecutionResult<TOutput>>;
-}
-type WorkflowEngineExecutionApiStore = WorkflowRunReaderRepository & WorkflowRunWriterRepository & WorkflowConditionalEventAppender & WorkflowEventReader & WorkflowStepAttemptLookup & WorkflowLockListerRepository & WorkflowLockConditionalWriterRepository;
-interface WorkflowEngineExecutionResumer {
-  resumeWorkflow<TInput, TOutput, TRawInput = TInput>(implementation: WorkflowImplementation<TInput, TOutput, TRawInput>, runId: RunId, options?: WorkflowResumeOptions): Promise<ExecutionResult<TOutput>>;
-}
-interface WorkflowEngineExecutionApiOptions {
-  readonly store: WorkflowEngineExecutionApiStore;
-  readonly now: () => Temporal.Instant;
-  readonly executionService: WorkflowExecutionServiceOptions;
-  readonly emitResultLifecycleEvent: <TOutput>(result: ExecutionResult<TOutput>, previous?: WorkflowRunRecord) => Promise<ExecutionResult<TOutput>>;
-  readonly starter: WorkflowRunStarter;
-  readonly resumer: WorkflowEngineExecutionResumer;
-}
-declare function createWorkflowEngineExecutionApi(service: WorkflowEngineExecutionApiOptions): WorkflowEngineExecutionApi;
-//#endregion
-export { WorkflowEngineExecutionApi, createWorkflowEngineExecutionApi };

package/dist/engine/execution-api.mjs

@@ -1,33 +0,0 @@
-import { getRequiredRun } from "../utility.mjs";
-import { makeCanceledRunResult, makeCompletedRunResult } from "./run-utils.mjs";
-import { failRunForDeadline, requireDefinitionMatchesRun } from "./state.mjs";
-import { executeWorkflowRun } from "./execution-service.mjs";
-//#region src/engine/execution-api.ts
-function createWorkflowEngineExecutionApi(service) {
-	return {
-		async runWorkflow(implementation, input, executionOptions) {
-			return await service.starter.startWorkflow(implementation.definition, input, executionOptions?.start);
-		},
-		async runWorkflowNow(implementation, input, executionOptions) {
-			const handle = await service.starter.startWorkflow(implementation.definition, input, executionOptions?.start);
-			return await service.resumer.resumeWorkflow(implementation, handle.runId, { signal: executionOptions?.signal });
-		},
-		async resumeWorkflow(implementation, runId, resumeOptions) {
-			const run = await getRequiredRun(service.store, runId);
-			requireDefinitionMatchesRun(implementation.definition, run);
-			if (run.status === "completed") return makeCompletedRunResult(run);
-			if (run.status === "canceled") return makeCanceledRunResult(run);
-			const timestamp = service.now();
-			if (run.deadlineAt !== void 0 && Temporal.Instant.compare(run.deadlineAt, timestamp) <= 0) return await service.emitResultLifecycleEvent(await failRunForDeadline(service.store, run, run.deadlineAt, timestamp), run);
-			const availableAt = run.availableAt;
-			if (availableAt !== void 0 && Temporal.Instant.compare(availableAt, timestamp) > 0) return {
-				kind: "waiting",
-				run,
-				availableAt
-			};
-			return await executeWorkflowRun(service.executionService, implementation, run, resumeOptions);
-		}
-	};
-}
-//#endregion
-export { createWorkflowEngineExecutionApi };

package/dist/engine/inspection-api.d.mts

@@ -1,34 +0,0 @@
-import { RunId } from "../types/run-id.mjs";
-import { PageOptions, WorkflowPage } from "../types/pagination.mjs";
-import { WorkflowListRunsOptions, WorkflowListRunsPageOptions, WorkflowListStepAttemptsPageOptions } from "../types/run-list.mjs";
-import { WorkflowRecoverySummary, WorkflowRecoverySummaryOptions, WorkflowRunSummary, WorkflowRunSummaryOptions } from "../types/summary.mjs";
-import { WorkflowListStepAttemptsOptions, WorkflowStepAttemptRecord, WorkflowStepAttemptSummary } from "../types/step-attempts.mjs";
-import { Timeline } from "../types/timeline.mjs";
-import { WorkflowRunRecord } from "../types/run.mjs";
-import { EventRecord } from "../types/events.mjs";
-import { WorkflowEventReader, WorkflowLockListerRepository, WorkflowMessageIdempotencyIndex, WorkflowRunQueryRepository, WorkflowScheduleListerRepository, WorkflowStepAttemptReadModel } from "../types/store.mjs";
-//#region src/engine/inspection-api.d.ts
-interface WorkflowEngineInspectionApi {
-  getRun(runId: RunId): Promise<WorkflowRunRecord | undefined>;
-  getEvents(runId: RunId): Promise<readonly EventRecord[]>;
-  listEventsPage(runId: RunId, options?: PageOptions): Promise<WorkflowPage<EventRecord>>;
-  listRuns(options?: WorkflowListRunsOptions): Promise<readonly WorkflowRunRecord[]>;
-  listRunsPage(options?: WorkflowListRunsPageOptions): Promise<WorkflowPage<WorkflowRunRecord>>;
-  countRuns(options?: WorkflowListRunsOptions): Promise<number>;
-  getRunSummary(options?: WorkflowRunSummaryOptions): Promise<WorkflowRunSummary>;
-  getRecoverySummary(options?: WorkflowRecoverySummaryOptions): Promise<WorkflowRecoverySummary>;
-  getTimeline(runId: RunId): Promise<Timeline>;
-  listStepAttempts(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<readonly WorkflowStepAttemptRecord[]>;
-  listStepAttemptsPage(runId: RunId, options?: WorkflowListStepAttemptsPageOptions): Promise<WorkflowPage<WorkflowStepAttemptRecord>>;
-  countStepAttempts(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<number>;
-  repairStepAttempts(runId: RunId): Promise<readonly WorkflowStepAttemptRecord[]>;
-  repairMessageIdempotencyIndexes(runId: RunId): Promise<readonly WorkflowMessageIdempotencyIndex[]>;
-  getStepAttemptSummary(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<WorkflowStepAttemptSummary>;
-}
-interface WorkflowInspectionRepairStore {
-  repairMessageIdempotencyIndexes(runId: RunId): Promise<readonly WorkflowMessageIdempotencyIndex[]>;
-}
-type WorkflowEngineInspectionStore = WorkflowRunQueryRepository & WorkflowEventReader & WorkflowInspectionRepairStore & WorkflowStepAttemptReadModel & WorkflowLockListerRepository & WorkflowScheduleListerRepository;
-declare function createWorkflowEngineInspectionApi(store: WorkflowEngineInspectionStore, now: () => Temporal.Instant): WorkflowEngineInspectionApi;
-//#endregion
-export { WorkflowEngineInspectionApi, createWorkflowEngineInspectionApi };

package/dist/engine/inspection-api.mjs

@@ -1,78 +0,0 @@
-import { getRequiredRun } from "../utility.mjs";
-import { createTimeline } from "../history/timeline.mjs";
-import "../history/mod.mjs";
-import "./state.mjs";
-import { makeWorkflowEventCursorKey, pageItems } from "../pagination.mjs";
-import { getChildRunsForAttempts } from "./summary/child-workflow-runs.mjs";
-import { getWorkflowRecoverySummary, getWorkflowRunSummary } from "./inspection.mjs";
-import { createWorkflowStepAttemptSummaryReducer } from "./summary/step-attempts.mjs";
-//#region src/engine/inspection-api.ts
-function createWorkflowEngineInspectionApi(store, now) {
-	return {
-		async getRun(runId) {
-			return await store.getRun(runId);
-		},
-		async getEvents(runId) {
-			return await store.getEvents(runId);
-		},
-		async listEventsPage(runId, options) {
-			return pageItems(await store.getEvents(runId), options, "Workflow event page", makeWorkflowEventCursorKey);
-		},
-		async listRuns(options) {
-			return await store.listRuns(options);
-		},
-		async listRunsPage(options) {
-			return await store.listRunsPage(options);
-		},
-		async countRuns(options) {
-			return await store.countRuns(options);
-		},
-		async getRunSummary(options) {
-			return await getWorkflowRunSummary({
-				store,
-				now: now(),
-				filters: options
-			});
-		},
-		async getRecoverySummary(options) {
-			return await getWorkflowRecoverySummary({
-				store,
-				now: now(),
-				filters: options
-			});
-		},
-		async getTimeline(runId) {
-			const run = await getRequiredRun(store, runId);
-			return createTimeline(run, await store.getEvents(runId));
-		},
-		async listStepAttempts(runId, options) {
-			await getRequiredRun(store, runId);
-			return await store.listStepAttempts(runId, options);
-		},
-		async listStepAttemptsPage(runId, options) {
-			await getRequiredRun(store, runId);
-			return await store.listStepAttemptsPage(runId, options);
-		},
-		async countStepAttempts(runId, options) {
-			await getRequiredRun(store, runId);
-			return await store.countStepAttempts(runId, options);
-		},
-		async repairStepAttempts(runId) {
-			await getRequiredRun(store, runId);
-			return await store.repairStepAttempts(runId);
-		},
-		async repairMessageIdempotencyIndexes(runId) {
-			await getRequiredRun(store, runId);
-			return await store.repairMessageIdempotencyIndexes(runId);
-		},
-		async getStepAttemptSummary(runId, options) {
-			await getRequiredRun(store, runId);
-			const attempts = await store.listStepAttempts(runId, options);
-			const reducer = createWorkflowStepAttemptSummaryReducer(await getChildRunsForAttempts(store, runId, attempts));
-			for (const attempt of attempts) reducer.addAttempt(attempt);
-			return reducer.finish();
-		}
-	};
-}
-//#endregion
-export { createWorkflowEngineInspectionApi };

package/dist/engine/mod.d.mts

@@ -1,4 +0,0 @@
-import { CreateWorkflowEngineOptions, WorkflowDeterministicBytesContext, WorkflowDeterministicValueContext, WorkflowEngineSerializationLimits, WorkflowExecutionLimits, WorkflowRecordedIdContext } from "../types/engine-options.mjs";
-import { LockManager, WorkflowAdmin, WorkflowCleanupAdmin, WorkflowClientEngine, WorkflowEngineLike, WorkflowExecutionEnvironment, WorkflowExecutionEnvironmentStore, WorkflowExecutor, WorkflowHookManager, WorkflowMessageIdempotencyMaintenance, WorkflowMessageSender, WorkflowRunCanceler, WorkflowRunHandleReader, WorkflowRunMaintenance, WorkflowRunReader, WorkflowRunRerunner, WorkflowRunStarter, WorkflowScheduleRunObserver, WorkflowScheduler, WorkflowStarter, WorkflowStepAttemptLookupReader, WorkflowStepAttemptMaintenance, WorkflowStepAttemptReader, WorkflowStreamReader, WorkflowWorkerEngine, WorkflowWorkerEngineStore, WorkflowWorkerOperationObserver } from "../types/engine.mjs";
-import { WorkflowEngine, createWorkflowEngine } from "./create.mjs";
-export { type CreateWorkflowEngineOptions, type LockManager, type WorkflowAdmin, type WorkflowCleanupAdmin, type WorkflowClientEngine, type WorkflowDeterministicBytesContext, type WorkflowDeterministicValueContext, WorkflowEngine, type WorkflowEngineLike, type WorkflowEngineSerializationLimits, type WorkflowExecutionEnvironment, type WorkflowExecutionEnvironmentStore, type WorkflowExecutionLimits, type WorkflowExecutor, type WorkflowHookManager, type WorkflowMessageIdempotencyMaintenance, type WorkflowMessageSender, type WorkflowRecordedIdContext, type WorkflowRunCanceler, type WorkflowRunHandleReader, type WorkflowRunMaintenance, type WorkflowRunReader, type WorkflowRunRerunner, type WorkflowRunStarter, type WorkflowScheduleRunObserver, type WorkflowScheduler, type WorkflowStarter, type WorkflowStepAttemptLookupReader, type WorkflowStepAttemptMaintenance, type WorkflowStepAttemptReader, type WorkflowStreamReader, type WorkflowWorkerEngine, type WorkflowWorkerEngineStore, type WorkflowWorkerOperationObserver, createWorkflowEngine };

package/dist/engine/mod.mjs

@@ -1,2 +0,0 @@
-import { WorkflowEngine, createWorkflowEngine } from "./create.mjs";
-export { WorkflowEngine, createWorkflowEngine };

package/dist/engine/recovery.d.mts

@@ -1,26 +0,0 @@
-import { ScheduleRecord } from "../types/schedule.mjs";
-import { LockRecord } from "../types/lock.mjs";
-import { WorkflowRecoverySummary } from "../types/summary.mjs";
-import { WorkflowStepAttemptRecord } from "../types/step-attempts.mjs";
-import { WorkflowRunRecord } from "../types/run.mjs";
-import { WorkflowRecoveryWaitInputs } from "./summary/recovery-waits.mjs";
-//#region src/engine/recovery.d.ts
-interface WorkflowRecoverySummaryInputs extends WorkflowRecoveryWaitInputs {
-  readonly lockWaitAttempts?: readonly WorkflowStepAttemptRecord[];
-  readonly locks?: readonly LockRecord[];
-  readonly schedules?: readonly ScheduleRecord[];
-}
-interface WorkflowRecoverySummaryOptions {
-  readonly runs: readonly WorkflowRunRecord[];
-  readonly now: Temporal.Instant;
-  readonly inputs?: WorkflowRecoverySummaryInputs;
-}
-interface WorkflowRecoveryDeadline {
-  readonly timestamp: Temporal.Instant;
-}
-declare function summarizeWorkflowRecovery(options: WorkflowRecoverySummaryOptions): WorkflowRecoverySummary;
-declare function mergeWorkflowRecoveryRunIds(runIdGroups: readonly (readonly string[])[]): readonly string[];
-declare function workflowRecoveryDeadline(ownerId: string | undefined, timestamp: Temporal.Instant | undefined): WorkflowRecoveryDeadline | undefined;
-declare function earliestWorkflowRecoveryDeadline(candidates: readonly (WorkflowRecoveryDeadline | undefined)[]): WorkflowRecoveryDeadline | undefined;
-//#endregion
-export { WorkflowRecoveryDeadline, WorkflowRecoverySummaryInputs, WorkflowRecoverySummaryOptions, earliestWorkflowRecoveryDeadline, mergeWorkflowRecoveryRunIds, summarizeWorkflowRecovery, workflowRecoveryDeadline };

package/dist/engine/recovery.mjs

@@ -1,92 +0,0 @@
-import { createWorkflowRecoveryLockSummaryReducer } from "./summary/recovery-locks.mjs";
-import { createWorkflowRecoveryRunSummaryReducer } from "./summary/recovery-runs.mjs";
-import { createWorkflowRecoveryScheduleSummaryReducer } from "./summary/recovery-schedules.mjs";
-import { createWorkflowRecoveryWaitSummaryReducer } from "./summary/recovery-waits.mjs";
-//#region src/engine/recovery.ts
-function recoveryWaitInputs(inputs) {
-	return {
-		sleepAttempts: inputs.sleepAttempts,
-		messageWaitAttempts: inputs.messageWaitAttempts,
-		childWorkflowAttempts: inputs.childWorkflowAttempts,
-		childRuns: inputs.childRuns,
-		eventsByRunId: inputs.eventsByRunId
-	};
-}
-function recoveryResourceInputs(inputs) {
-	return {
-		lockWaitAttempts: inputs.lockWaitAttempts,
-		locks: inputs.locks,
-		schedules: inputs.schedules
-	};
-}
-function summarizeWorkflowRecovery(options) {
-	const { runs, now, inputs = {} } = options;
-	const waitInputs = recoveryWaitInputs(inputs);
-	const resources = recoveryResourceInputs(inputs);
-	const runReducer = createWorkflowRecoveryRunSummaryReducer(now);
-	for (const run of runs) runReducer.addRun(run);
-	const runSummary = runReducer.finish();
-	const waitReducer = createWorkflowRecoveryWaitSummaryReducer(waitInputs, now);
-	waitReducer.addSleepAttempts(waitInputs.sleepAttempts ?? []);
-	waitReducer.addMessageWaitAttempts(waitInputs.messageWaitAttempts ?? []);
-	waitReducer.addChildWorkflowAttempts(waitInputs.childWorkflowAttempts ?? []);
-	const wait = waitReducer.finish();
-	const lockReducer = createWorkflowRecoveryLockSummaryReducer(runs, now);
-	for (const lockRecord of resources.locks ?? []) lockReducer.addLock(lockRecord);
-	for (const attempt of resources.lockWaitAttempts ?? []) lockReducer.addLockWaitAttempt(attempt);
-	const lock = lockReducer.finish();
-	const scheduleReducer = createWorkflowRecoveryScheduleSummaryReducer(now);
-	for (const scheduleRecord of resources.schedules ?? []) scheduleReducer.addSchedule(scheduleRecord);
-	const schedule = scheduleReducer.finish();
-	const recoverableRunIds = mergeWorkflowRecoveryRunIds([
-		runSummary.recoverableRunIds,
-		wait.sleep.dueRunIds,
-		wait.message.readyRunIds,
-		wait.message.timedOutRunIds,
-		wait.childWorkflow.terminalRunIds,
-		wait.childWorkflow.missingRunIds,
-		wait.childWorkflow.timedOutRunIds
-	]);
-	const summary = {
-		total: runSummary.total,
-		recoverableRunIds,
-		due: runSummary.due,
-		lease: runSummary.lease,
-		retry: runSummary.retry,
-		missingImplementation: runSummary.missingImplementation,
-		failed: runSummary.failed,
-		schedule,
-		lock,
-		wait
-	};
-	const nextRecovery = earliestWorkflowRecoveryDeadline([
-		runSummary.nextAvailable,
-		runSummary.nextLeaseExpires,
-		runSummary.nextRetry,
-		workflowRecoveryDeadline(schedule.nextFireScheduleId, schedule.nextFireAt),
-		workflowRecoveryDeadline(lock.nextExpiringKey, lock.nextExpiresAt),
-		workflowRecoveryDeadline(lock.nextWaitDeadlineRunId, lock.nextWaitDeadlineAt),
-		workflowRecoveryDeadline(wait.sleep.nextWakeRunId, wait.sleep.nextWakeAt),
-		workflowRecoveryDeadline(wait.message.nextTimeoutRunId, wait.message.nextTimeoutAt),
-		workflowRecoveryDeadline(wait.childWorkflow.nextTimeoutRunId, wait.childWorkflow.nextTimeoutAt)
-	]);
-	return {
-		...summary,
-		...nextRecovery === void 0 ? {} : { nextRecoveryAt: nextRecovery.timestamp }
-	};
-}
-function mergeWorkflowRecoveryRunIds(runIdGroups) {
-	return [...new Set(runIdGroups.flat())].sort();
-}
-function workflowRecoveryDeadline(ownerId, timestamp) {
-	return ownerId === void 0 || timestamp === void 0 ? void 0 : { timestamp };
-}
-function earliestWorkflowRecoveryDeadline(candidates) {
-	return candidates.reduce((current, candidate) => {
-		if (candidate === void 0) return current;
-		if (current === void 0) return candidate;
-		return Temporal.Instant.compare(candidate.timestamp, current.timestamp) < 0 ? candidate : current;
-	}, void 0);
-}
-//#endregion
-export { earliestWorkflowRecoveryDeadline, mergeWorkflowRecoveryRunIds, summarizeWorkflowRecovery, workflowRecoveryDeadline };

package/dist/engine/retry-policy.d.mts

@@ -1,4 +0,0 @@
-//#region src/engine/retry-policy.d.ts
-declare const MAX_CONCURRENT_RUN_UPDATE_ATTEMPTS = 16;
-//#endregion
-export { MAX_CONCURRENT_RUN_UPDATE_ATTEMPTS };

package/dist/engine/retry-policy.mjs

@@ -1,4 +0,0 @@
-//#region src/engine/retry-policy.ts
-const MAX_CONCURRENT_RUN_UPDATE_ATTEMPTS = 16;
-//#endregion
-export { MAX_CONCURRENT_RUN_UPDATE_ATTEMPTS };

package/dist/engine/start-api.d.mts

@@ -1,30 +0,0 @@
-import { WorkflowStartTarget } from "../types/definition.mjs";
-import { HandleOperations, WorkflowHandle } from "../types/result.mjs";
-import { Telemetry } from "../types/telemetry.mjs";
-import { WorkflowRunRecord } from "../types/run.mjs";
-import { ResolvedScheduleNextOptions, ScheduleNextOptions, WorkflowBatchStartItem, WorkflowStartOptions } from "../types/run-options.mjs";
-import { WorkflowEventReader, WorkflowIdempotencyIndex, WorkflowRunCreationRepository, WorkflowRunReaderRepository, WorkflowStoreNamespace } from "../types/store.mjs";
-import { WorkflowExecutionLimits } from "../types/engine-options.mjs";
-import { WorkflowRunStarter } from "../types/engine.mjs";
-//#region src/engine/start-api.d.ts
-interface WorkflowEngineStartApi {
-  startWorkflow<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options?: WorkflowStartOptions): Promise<WorkflowHandle<TOutput>>;
-  startWorkflows<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, items: readonly WorkflowBatchStartItem<TRawInput>[]): Promise<readonly WorkflowHandle<TOutput>[]>;
-  scheduleNextWorkflow<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options: ScheduleNextOptions): Promise<WorkflowHandle<TOutput>>;
-}
-/** Resolves schedule-next options and derives the start time for the next run. */
-declare function resolveScheduleNextOptions(options: ScheduleNextOptions, now: () => Temporal.Instant): ResolvedScheduleNextOptions;
-type WorkflowEngineStartStore = WorkflowStoreNamespace & WorkflowRunCreationRepository & WorkflowRunReaderRepository & WorkflowIdempotencyIndex & WorkflowEventReader;
-interface WorkflowEngineStartApiOptions {
-  readonly store: WorkflowEngineStartStore;
-  readonly now: () => Temporal.Instant;
-  readonly limits: WorkflowExecutionLimits;
-  readonly createRunId: () => string;
-  readonly telemetry?: Telemetry;
-  readonly emitRunEvent: (run: WorkflowRunRecord) => void;
-  readonly starter: WorkflowRunStarter;
-  readonly handleOperations: HandleOperations;
-}
-declare function createWorkflowEngineStartApi(service: WorkflowEngineStartApiOptions): WorkflowEngineStartApi;
-//#endregion
-export { WorkflowEngineStartApi, createWorkflowEngineStartApi, resolveScheduleNextOptions };

package/dist/engine/start-api.mjs

@@ -1,99 +0,0 @@
-import { defineWorkflowFromTarget, parseWorkflowInput } from "../definition.mjs";
-import { captureTelemetryContext } from "../telemetry.mjs";
-import { toOptionalPersistedValue, toPersistedValue } from "./serialization.mjs";
-import { workflowHandle } from "./run-utils.mjs";
-import { resolveWorkflowStartSpec } from "./run-service.mjs";
-//#region src/engine/start-api.ts
-/** Resolves schedule-next options and derives the start time for the next run. */
-function resolveScheduleNextOptions(options, now) {
-	const from = options.from ?? now();
-	const start = {
-		...options.id === void 0 ? {} : { id: options.id },
-		idempotencyKey: options.idempotencyKey,
-		...options.workflowVersion === void 0 ? {} : { workflowVersion: options.workflowVersion },
-		...options.workflowVersionResolver === void 0 ? {} : { workflowVersionResolver: options.workflowVersionResolver },
-		...options.context === void 0 ? {} : { context: options.context },
-		...options.parent === void 0 ? {} : { parent: options.parent },
-		availableAt: from.toZonedDateTimeISO("UTC").add(options.every).toInstant(),
-		...options.deadlineAt === void 0 ? {} : { deadlineAt: options.deadlineAt }
-	};
-	return {
-		schedule: {
-			...options,
-			from
-		},
-		start
-	};
-}
-function createWorkflowEngineStartApi(service) {
-	return {
-		async startWorkflow(workflow, input, startOptions) {
-			const definition = defineWorkflowFromTarget(workflow);
-			const resolvedDefinition = await resolveWorkflowStartSpec(definition, startOptions);
-			const parsedInput = await parseWorkflowInput(resolvedDefinition, input);
-			const idempotencyKey = startOptions?.idempotencyKey;
-			const explicitRunId = startOptions?.id;
-			const existingRun = idempotencyKey === void 0 ? void 0 : await service.store.getRunByIdempotencyKey({
-				workflowName: resolvedDefinition.name,
-				...resolvedDefinition.version === void 0 ? {} : { workflowVersion: resolvedDefinition.version },
-				idempotencyKey
-			});
-			if (existingRun !== void 0) return workflowStartHandle(service, resolvedDefinition, existingRun.id);
-			const runId = explicitRunId ?? service.createRunId();
-			const timestamp = service.now();
-			const availableAt = startOptions?.availableAt;
-			const deadlineAt = startOptions?.deadlineAt;
-			const parent = startOptions?.parent === void 0 ? void 0 : startOptions.parent;
-			const persistedInput = toOptionalPersistedValue(parsedInput, "workflow input", service.limits);
-			const run = {
-				id: runId,
-				namespace: service.store.namespace,
-				workflowName: resolvedDefinition.name,
-				...resolvedDefinition.version === void 0 ? {} : { workflowVersion: resolvedDefinition.version },
-				status: "pending",
-				...persistedInput === void 0 ? {} : { input: persistedInput },
-				...startOptions?.context === void 0 ? {} : { context: toPersistedValue(startOptions.context, "workflow context", service.limits) },
-				...(() => {
-					const telemetryContext = captureTelemetryContext(service.telemetry);
-					return telemetryContext === void 0 ? {} : { telemetryContext };
-				})(),
-				attempts: 0,
-				...idempotencyKey === void 0 ? {} : { idempotencyKey },
-				...parent === void 0 ? {} : {
-					parentRunId: parent.runId,
-					...parent.stepId === void 0 ? {} : { parentStepId: parent.stepId },
-					...parent.stepName === void 0 ? {} : { parentStepName: parent.stepName },
-					...parent.stepAttempt === void 0 ? {} : { parentStepAttempt: parent.stepAttempt }
-				},
-				createdAt: timestamp,
-				updatedAt: timestamp,
-				lastTransitionAt: timestamp,
-				lastTransitionReason: "created",
-				...availableAt === void 0 ? {} : { availableAt },
-				...deadlineAt === void 0 ? {} : { deadlineAt }
-			};
-			const createdRun = await service.store.createRun(run);
-			service.emitRunEvent(createdRun);
-			return workflowStartHandle(service, resolvedDefinition, createdRun.id);
-		},
-		async startWorkflows(workflow, items) {
-			const handles = [];
-			for (const item of items) handles.push(await service.starter.startWorkflow(workflow, item.input, item.options));
-			return handles;
-		},
-		async scheduleNextWorkflow(workflow, input, scheduleOptions) {
-			const options = resolveScheduleNextOptions(scheduleOptions, service.now).start;
-			return await service.starter.startWorkflow(workflow, input, options);
-		}
-	};
-}
-function workflowStartHandle(service, definition, runId) {
-	return workflowHandle(service.store, definition, runId, service.now, {
-		getTimeline: async (currentRunId) => await service.handleOperations.getTimeline(currentRunId),
-		setMetadata: async (currentRunId, metadata) => await service.handleOperations.setMetadata(currentRunId, metadata),
-		setAttributes: async (currentRunId, attributes) => await service.handleOperations.setAttributes(currentRunId, attributes),
-		cancel: async (currentRunId) => await service.handleOperations.cancel(currentRunId)
-	});
-}
-//#endregion
-export { createWorkflowEngineStartApi, resolveScheduleNextOptions };

package/dist/engine/summary/active-events.d.mts

@@ -1,34 +0,0 @@
-import { MessageId } from "../../types/message-id.mjs";
-import { StepId } from "../../types/step-id.mjs";
-import { StreamId } from "../../types/stream-id.mjs";
-import "../../types/step.mjs";
-import { EventRecord } from "../../types/events.mjs";
-//#region src/engine/summary/active-events.d.ts
-interface ActiveWorkflowStreamSummary {
-  readonly stepId: StepId;
-  readonly stepName: string;
-  readonly streamId: StreamId;
-  readonly startedAt: Temporal.Instant;
-  readonly chunkCount: number;
-}
-interface ActiveWorkflowHookSummary {
-  readonly stepId: StepId;
-  readonly name: string;
-  readonly messageId: MessageId;
-  readonly source: "hook" | "webhook";
-  readonly startedAt: Temporal.Instant;
-  readonly timeoutAt?: Temporal.Instant;
-}
-interface ActiveWorkflowEventSummary {
-  readonly streams: readonly ActiveWorkflowStreamSummary[];
-  readonly hooks: readonly ActiveWorkflowHookSummary[];
-}
-interface ActiveWorkflowEventSummaryReducer {
-  addEvent(event: EventRecord): void;
-  finish(): ActiveWorkflowEventSummary;
-}
-/** Creates a reducer for active stream and hook events within a single workflow run. */
-declare function createActiveWorkflowEventSummaryReducer(): ActiveWorkflowEventSummaryReducer;
-declare function activeWorkflowEvents(events: readonly EventRecord[]): ActiveWorkflowEventSummary;
-//#endregion
-export { ActiveWorkflowEventSummary, ActiveWorkflowEventSummaryReducer, ActiveWorkflowHookSummary, ActiveWorkflowStreamSummary, activeWorkflowEvents, createActiveWorkflowEventSummaryReducer };

package/dist/engine/summary/active-events.mjs

@@ -1,69 +0,0 @@
-//#region src/engine/summary/active-events.ts
-/** Creates a reducer for active stream and hook events within a single workflow run. */
-function createActiveWorkflowEventSummaryReducer() {
-	const streams = /* @__PURE__ */ new Map();
-	const terminalStreamStepIds = /* @__PURE__ */ new Set();
-	const hooks = /* @__PURE__ */ new Map();
-	const terminalHookStepIds = /* @__PURE__ */ new Set();
-	return {
-		addEvent(event) {
-			addActiveStreamEvent(streams, terminalStreamStepIds, event);
-			addActiveHookEvent(hooks, terminalHookStepIds, event);
-		},
-		finish() {
-			return {
-				streams: [...streams.values()].filter((stream) => isActiveStream(stream, terminalStreamStepIds)),
-				hooks: [...hooks.values()].filter((hook) => isActiveHook(hook, terminalHookStepIds))
-			};
-		}
-	};
-}
-function activeWorkflowEvents(events) {
-	const reducer = createActiveWorkflowEventSummaryReducer();
-	for (const event of events) reducer.addEvent(event);
-	return reducer.finish();
-}
-function addActiveStreamEvent(streams, terminalStreamStepIds, event) {
-	if (event.kind === "stream_started") {
-		streams.set(event.stepId, {
-			stepId: event.stepId,
-			stepName: event.stepName,
-			streamId: event.streamId,
-			startedAt: event.timestamp,
-			chunkCount: 0
-		});
-		return;
-	}
-	if (event.kind === "stream_chunk") {
-		const stream = streams.get(event.stepId);
-		if (stream !== void 0) streams.set(event.stepId, {
-			...stream,
-			chunkCount: stream.chunkCount + 1
-		});
-		return;
-	}
-	if (event.kind === "stream_closed" || event.kind === "stream_failed") terminalStreamStepIds.add(event.stepId);
-}
-function isActiveStream(stream, terminalStreamStepIds) {
-	return !terminalStreamStepIds.has(stream.stepId);
-}
-function addActiveHookEvent(hooks, terminalHookStepIds, event) {
-	if (event.kind === "message_wait_started") {
-		if (event.source !== "hook" && event.source !== "webhook") return;
-		hooks.set(event.stepId, {
-			stepId: event.stepId,
-			name: event.stepName,
-			messageId: event.messageId,
-			source: event.source,
-			startedAt: event.timestamp,
-			...event.timeoutAt === void 0 ? {} : { timeoutAt: event.timeoutAt }
-		});
-		return;
-	}
-	if (event.kind === "message_wait_completed" || event.kind === "message_wait_failed") terminalHookStepIds.add(event.stepId);
-}
-function isActiveHook(hook, terminalHookStepIds) {
-	return !terminalHookStepIds.has(hook.stepId);
-}
-//#endregion
-export { activeWorkflowEvents, createActiveWorkflowEventSummaryReducer };

package/dist/engine/summary/child-workflow-runs.d.mts

@@ -1,24 +0,0 @@
-import { RunId } from "../../types/run-id.mjs";
-import { WorkflowRunFailureSummary, WorkflowRunRetrySummary } from "../../types/summary.mjs";
-import { WorkflowStepAttemptRecord } from "../../types/step-attempts.mjs";
-import { WorkflowRunRecord, WorkflowRunStatus } from "../../types/run.mjs";
-import { WorkflowRunReaderRepository } from "../../types/store.mjs";
-//#region src/engine/summary/child-workflow-runs.d.ts
-interface WorkflowChildWorkflowRunSummaryFields {
-  readonly childStatus: Record<WorkflowRunStatus, number>;
-  readonly retryChildRunIds?: readonly string[];
-  readonly failedChildRunIds?: readonly string[];
-  readonly canceledChildRunIds?: readonly string[];
-  readonly childRetry?: WorkflowRunRetrySummary;
-  readonly childFailure?: WorkflowRunFailureSummary;
-}
-interface WorkflowChildWorkflowRunSummaryReducer {
-  addRun(run: WorkflowRunRecord): void;
-  finish(): WorkflowChildWorkflowRunSummaryFields;
-}
-declare function getChildRunsForAttempts(store: WorkflowRunReaderRepository, parentRunId: RunId, attempts: readonly WorkflowStepAttemptRecord[]): Promise<readonly WorkflowRunRecord[]>;
-/** Creates a reducer for child workflow run state embedded in active child workflow waits. */
-declare function createWorkflowChildWorkflowRunSummaryReducer(): WorkflowChildWorkflowRunSummaryReducer;
-declare function summarizeChildWorkflowRuns(runs: readonly WorkflowRunRecord[]): WorkflowChildWorkflowRunSummaryFields;
-//#endregion
-export { WorkflowChildWorkflowRunSummaryFields, WorkflowChildWorkflowRunSummaryReducer, createWorkflowChildWorkflowRunSummaryReducer, getChildRunsForAttempts, summarizeChildWorkflowRuns };