@tiangong-lca/cli 0.1.0 → 0.1.2

package/dist/src/lib/batch/engine.js

@@ -0,0 +1,294 @@
+import { executeClaim } from './attempt-recovery.js';
+import { assertUniqueItemIds, batchItemContractsMatch, parseBatchContract, parseItemIdentity, } from './canonical-contracts.js';
+import { identityDriftFailure, itemIdentityMatches, projectBatchItemContract, projectExclusiveKey, projectionDriftFailure, resourceDriftFailure, resumeContractFailure, validateBatchOptions, validateResume, } from './item-projection.js';
+import { MinReadyIndexHeap, createAsyncLock, createEventEmitter, defaultBatchSleep, freezeResult, inputOrderedResults, readClock, } from './scheduler-runtime.js';
+export async function runBoundedBatch(options) {
+    const contract = parseBatchContract(options.contract);
+    validateBatchOptions(options);
+    const itemIds = options.items.map((item, index) => parseItemIdentity(options.getItemIdentity(item, index), index));
+    assertUniqueItemIds(itemIds);
+    const preflightItemContracts = options.items.map((item, index) => projectBatchItemContract(options, item, index, itemIds[index]));
+    const preflightExclusiveKeys = options.items.map((item, index) => projectExclusiveKey(options, item, index, preflightItemContracts[index]));
+    const resumeItems = validateResume(options.resume, contract, itemIds);
+    const clock = options.clock ?? { now: Date.now };
+    const sleep = options.sleep ?? defaultBatchSleep;
+    const emitter = createEventEmitter(clock, options.eventSink);
+    const resultsByIndex = new Map();
+    const completionResults = [];
+    const claimOrder = [];
+    const pendingIndexes = [];
+    let paused = false;
+    let stopped = false;
+    let hasInfrastructureFailure = false;
+    let firstInfrastructureFailure;
+    const recordInfrastructureFailure = (error) => {
+        if (!hasInfrastructureFailure) {
+            hasInfrastructureFailure = true;
+            firstInfrastructureFailure = error;
+        }
+        stopped = true;
+    };
+    const schedulerLock = createAsyncLock(recordInfrastructureFailure);
+    await emitter.emit('batch_started');
+    const recordPreclaimResult = async (result, eventType) => {
+        resultsByIndex.set(result.input_index, result);
+        completionResults.push(result);
+        await emitter.emit(eventType, {
+            item_id: result.item_id,
+            input_index: result.input_index,
+            status: result.status,
+        });
+        if (!stopped &&
+            (await shouldStopAfter(options, result, claimOrder, resultsByIndex, completionResults))) {
+            stopped = true;
+            await emitter.emit('batch_stopped', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                status: 'stopped',
+            });
+        }
+    };
+    for (const [index, item] of options.items.entries()) {
+        const resumeItem = resumeItems.get(itemIds[index]);
+        if (resumeItem?.state === 'completed') {
+            const itemContract = preflightItemContracts[index];
+            const exclusiveKey = preflightExclusiveKeys[index];
+            if (!itemIdentityMatches(options, item, index, itemContract.item_id)) {
+                const result = identityDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock);
+                await recordPreclaimResult(result, 'item_identity_drift');
+                continue;
+            }
+            const currentItemContract = projectBatchItemContract(options, item, index, itemIds[index]);
+            if (!batchItemContractsMatch(itemContract, currentItemContract)) {
+                const result = projectionDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock);
+                await recordPreclaimResult(result, 'item_projection_drift');
+                continue;
+            }
+            const currentExclusiveKey = projectExclusiveKey(options, item, index, currentItemContract);
+            if (exclusiveKey !== currentExclusiveKey) {
+                const result = resourceDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock);
+                await recordPreclaimResult(result, 'item_resource_drift');
+                continue;
+            }
+            if (!batchItemContractsMatch(itemContract, resumeItem)) {
+                const result = resumeContractFailure(item, itemContract, exclusiveKey, index, resumeItem.attempts, clock);
+                await recordPreclaimResult(result, 'item_resume_rejected');
+                continue;
+            }
+            const resumedResult = freezeResult({
+                item,
+                item_id: itemContract.item_id,
+                item_contract: itemContract,
+                exclusive_key: exclusiveKey,
+                input_index: index,
+                attempts: resumeItem.attempts,
+                attempt_consumed: true,
+                resumed: true,
+                completed_at_ms: readClock(clock),
+                status: resumeItem.outcome,
+                value: resumeItem.value,
+            });
+            await recordPreclaimResult(resumedResult, 'item_resumed');
+        }
+        else {
+            pendingIndexes.push(index);
+        }
+    }
+    const unclaimedIndexes = new Set(pendingIndexes);
+    const resourceKeysByIndex = new Map();
+    const resourceQueues = new Map();
+    for (const index of pendingIndexes) {
+        const exclusiveKey = preflightExclusiveKeys[index];
+        const resourceKey = exclusiveKey ?? index;
+        resourceKeysByIndex.set(index, resourceKey);
+        const queue = resourceQueues.get(resourceKey) ?? { indexes: [], cursor: 0 };
+        queue.indexes.push(index);
+        resourceQueues.set(resourceKey, queue);
+    }
+    const readyIndexes = new MinReadyIndexHeap();
+    for (const queue of resourceQueues.values())
+        readyIndexes.push(queue.indexes[0]);
+    const claimNext = async () => schedulerLock(async () => {
+        if (paused || stopped || unclaimedIndexes.size === 0)
+            return null;
+        const index = readyIndexes.pop();
+        if (index === undefined)
+            return null;
+        const resourceKey = resourceKeysByIndex.get(index);
+        const item = options.items[index];
+        const itemId = itemIds[index];
+        const itemContract = preflightItemContracts[index];
+        const exclusiveKey = preflightExclusiveKeys[index];
+        if (!itemIdentityMatches(options, item, index, itemId)) {
+            unclaimedIndexes.delete(index);
+            const result = identityDriftFailure(item, itemContract, exclusiveKey, index, resumeItems.get(itemId), clock);
+            await emitter.emit('item_identity_drift', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                status: result.status,
+            });
+            return { kind: 'rejected', resourceKey, result };
+        }
+        const currentItemContract = projectBatchItemContract(options, item, index, itemId);
+        const resumeItem = resumeItems.get(itemId);
+        if (!batchItemContractsMatch(itemContract, currentItemContract)) {
+            unclaimedIndexes.delete(index);
+            const result = projectionDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock);
+            await emitter.emit('item_projection_drift', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                status: result.status,
+            });
+            return { kind: 'rejected', resourceKey, result };
+        }
+        const currentExclusiveKey = projectExclusiveKey(options, item, index, currentItemContract);
+        if (exclusiveKey !== currentExclusiveKey) {
+            unclaimedIndexes.delete(index);
+            const result = resourceDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock);
+            await emitter.emit('item_resource_drift', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                status: result.status,
+            });
+            return { kind: 'rejected', resourceKey, result };
+        }
+        if (resumeItem && !batchItemContractsMatch(itemContract, resumeItem)) {
+            unclaimedIndexes.delete(index);
+            const result = resumeContractFailure(item, itemContract, exclusiveKey, index, resumeItem.attempts, clock);
+            await emitter.emit('item_resume_rejected', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                status: result.status,
+            });
+            return { kind: 'rejected', resourceKey, result };
+        }
+        if (options.shouldPauseBeforeClaim &&
+            (await options.shouldPauseBeforeClaim({
+                item,
+                item_id: itemId,
+                item_contract: itemContract,
+                exclusive_key: exclusiveKey,
+                input_index: index,
+                claimed_count: claimOrder.length,
+                results_input_order: inputOrderedResults(resultsByIndex),
+            }))) {
+            paused = true;
+            await emitter.emit('batch_paused', {
+                item_id: itemId,
+                input_index: index,
+                status: 'paused',
+            });
+            readyIndexes.push(index);
+            return null;
+        }
+        unclaimedIndexes.delete(index);
+        claimOrder.push(itemId);
+        await emitter.emit('item_claimed', { item_id: itemId, input_index: index });
+        if (exclusiveKey !== null) {
+            await emitter.emit('item_resource_queued', {
+                item_id: itemId,
+                input_index: index,
+                exclusive_key: exclusiveKey,
+            });
+            await emitter.emit('item_resource_acquired', {
+                item_id: itemId,
+                input_index: index,
+                exclusive_key: exclusiveKey,
+            });
+        }
+        return { kind: 'claimed', index, itemContract, exclusiveKey, resourceKey, resumeItem };
+    });
+    const complete = async (result, exclusiveKey, resourceKey) => schedulerLock(async () => {
+        if (exclusiveKey !== null) {
+            await emitter.emit('item_resource_released', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                exclusive_key: exclusiveKey,
+            });
+        }
+        resultsByIndex.set(result.input_index, result);
+        completionResults.push(result);
+        await emitter.emit('item_completed', {
+            item_id: result.item_id,
+            input_index: result.input_index,
+            status: result.status,
+        });
+        if (!stopped &&
+            (await shouldStopAfter(options, result, claimOrder, resultsByIndex, completionResults))) {
+            stopped = true;
+            await emitter.emit('batch_stopped', {
+                item_id: result.item_id,
+                input_index: result.input_index,
+                status: 'stopped',
+            });
+        }
+        const resourceQueue = resourceQueues.get(resourceKey);
+        resourceQueue.cursor += 1;
+        const nextIndex = resourceQueue.indexes[resourceQueue.cursor];
+        if (nextIndex !== undefined && !paused && !stopped)
+            readyIndexes.push(nextIndex);
+    });
+    const worker = async () => {
+        try {
+            while (true) {
+                const claim = await claimNext();
+                if (!claim)
+                    return;
+                if (claim.kind === 'rejected') {
+                    await complete(claim.result, null, claim.resourceKey);
+                    continue;
+                }
+                const execute = () => executeClaim({
+                    options,
+                    index: claim.index,
+                    itemContract: claim.itemContract,
+                    exclusiveKey: claim.exclusiveKey,
+                    resumeItem: claim.resumeItem,
+                    clock,
+                    sleep,
+                    emitter,
+                });
+                const result = await execute();
+                await complete(result, claim.exclusiveKey, claim.resourceKey);
+            }
+        }
+        catch (error) {
+            recordInfrastructureFailure(error);
+            throw error;
+        }
+    };
+    if (!stopped) {
+        const workerCount = Math.min(options.maxConcurrency, pendingIndexes.length);
+        await Promise.allSettled(Array.from({ length: workerCount }, worker));
+    }
+    if (hasInfrastructureFailure)
+        throw firstInfrastructureFailure;
+    const status = paused ? 'paused' : stopped ? 'stopped' : 'completed';
+    await emitter.emit('batch_completed', { status });
+    await emitter.settled();
+    const resultsInputOrder = inputOrderedResults(resultsByIndex);
+    const unclaimedItemIds = pendingIndexes
+        .filter((index) => unclaimedIndexes.has(index))
+        .map((index) => itemIds[index]);
+    return Object.freeze({
+        contract,
+        status,
+        claim_order: Object.freeze([...claimOrder]),
+        completion_order: Object.freeze(completionResults.map((result) => result.item_id)),
+        results_input_order: Object.freeze(resultsInputOrder),
+        results_completion_order: Object.freeze([...completionResults]),
+        unclaimed_item_ids: Object.freeze(unclaimedItemIds),
+        events: Object.freeze([...emitter.events]),
+    });
+}
+async function shouldStopAfter(options, lastResult, claimOrder, resultsByIndex, completionResults) {
+    if (!options.shouldStop)
+        return false;
+    return options.shouldStop({
+        last_result: lastResult,
+        claimed_count: claimOrder.length,
+        results_input_order: inputOrderedResults(resultsByIndex),
+        results_completion_order: [...completionResults],
+    });
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/lib/batch/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../src/lib/batch/engine.ts"],"names":[],"mappings":"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","sourcesContent":["import { executeClaim } from './attempt-recovery.js';\nimport {\n  assertUniqueItemIds,\n  batchItemContractsMatch,\n  parseBatchContract,\n  parseItemIdentity,\n} from './canonical-contracts.js';\nimport {\n  identityDriftFailure,\n  itemIdentityMatches,\n  projectBatchItemContract,\n  projectExclusiveKey,\n  projectionDriftFailure,\n  resourceDriftFailure,\n  resumeContractFailure,\n  validateBatchOptions,\n  validateResume,\n} from './item-projection.js';\nimport {\n  MinReadyIndexHeap,\n  createAsyncLock,\n  createEventEmitter,\n  defaultBatchSleep,\n  freezeResult,\n  inputOrderedResults,\n  readClock,\n} from './scheduler-runtime.js';\nimport type {\n  BatchItemContract,\n  BatchItemFailedResult,\n  BatchItemResult,\n  BatchJsonValue,\n  BatchResumeItem,\n  BatchRunResult,\n  BatchStatus,\n  RunBoundedBatchOptions,\n} from './types.js';\n\nexport async function runBoundedBatch<\n  TInput,\n  TOutput,\n  TIdentity extends BatchJsonValue,\n  TExclusiveKey extends string = string,\n>(\n  options: RunBoundedBatchOptions<TInput, TOutput, TIdentity, TExclusiveKey>,\n): Promise<BatchRunResult<TInput, TOutput, TIdentity>> {\n  const contract = parseBatchContract<TIdentity>(options.contract);\n  validateBatchOptions(options);\n  const itemIds = options.items.map((item, index) =>\n    parseItemIdentity(options.getItemIdentity(item, index), index),\n  );\n  assertUniqueItemIds(itemIds);\n  const preflightItemContracts = options.items.map((item, index) =>\n    projectBatchItemContract(options, item, index, itemIds[index]!),\n  );\n  const preflightExclusiveKeys = options.items.map((item, index) =>\n    projectExclusiveKey(options, item, index, preflightItemContracts[index]!),\n  );\n  const resumeItems = validateResume(options.resume, contract, itemIds);\n  const clock = options.clock ?? { now: Date.now };\n  const sleep = options.sleep ?? defaultBatchSleep;\n  const emitter = createEventEmitter(clock, options.eventSink);\n  const resultsByIndex = new Map<number, BatchItemResult<TInput, TOutput>>();\n  const completionResults: BatchItemResult<TInput, TOutput>[] = [];\n  const claimOrder: string[] = [];\n  const pendingIndexes: number[] = [];\n  let paused = false;\n  let stopped = false;\n  let hasInfrastructureFailure = false;\n  let firstInfrastructureFailure: unknown;\n  const recordInfrastructureFailure = (error: unknown): void => {\n    if (!hasInfrastructureFailure) {\n      hasInfrastructureFailure = true;\n      firstInfrastructureFailure = error;\n    }\n    stopped = true;\n  };\n  const schedulerLock = createAsyncLock(recordInfrastructureFailure);\n\n  await emitter.emit('batch_started');\n\n  const recordPreclaimResult = async (\n    result: BatchItemResult<TInput, TOutput>,\n    eventType:\n      | 'item_identity_drift'\n      | 'item_projection_drift'\n      | 'item_resource_drift'\n      | 'item_resume_rejected'\n      | 'item_resumed',\n  ): Promise<void> => {\n    resultsByIndex.set(result.input_index, result);\n    completionResults.push(result);\n    await emitter.emit(eventType, {\n      item_id: result.item_id,\n      input_index: result.input_index,\n      status: result.status,\n    });\n    if (\n      !stopped &&\n      (await shouldStopAfter(options, result, claimOrder, resultsByIndex, completionResults))\n    ) {\n      stopped = true;\n      await emitter.emit('batch_stopped', {\n        item_id: result.item_id,\n        input_index: result.input_index,\n        status: 'stopped',\n      });\n    }\n  };\n\n  for (const [index, item] of options.items.entries()) {\n    const resumeItem = resumeItems.get(itemIds[index]!);\n    if (resumeItem?.state === 'completed') {\n      const itemContract = preflightItemContracts[index]!;\n      const exclusiveKey = preflightExclusiveKeys[index]!;\n      if (!itemIdentityMatches(options, item, index, itemContract.item_id)) {\n        const result = identityDriftFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem,\n          clock,\n        );\n        await recordPreclaimResult(result, 'item_identity_drift');\n        continue;\n      }\n      const currentItemContract = projectBatchItemContract(options, item, index, itemIds[index]!);\n      if (!batchItemContractsMatch(itemContract, currentItemContract)) {\n        const result = projectionDriftFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem,\n          clock,\n        );\n        await recordPreclaimResult(result, 'item_projection_drift');\n        continue;\n      }\n      const currentExclusiveKey = projectExclusiveKey(options, item, index, currentItemContract);\n      if (exclusiveKey !== currentExclusiveKey) {\n        const result = resourceDriftFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem,\n          clock,\n        );\n        await recordPreclaimResult(result, 'item_resource_drift');\n        continue;\n      }\n      if (!batchItemContractsMatch(itemContract, resumeItem)) {\n        const result = resumeContractFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem.attempts,\n          clock,\n        );\n        await recordPreclaimResult(result, 'item_resume_rejected');\n        continue;\n      }\n      const resumedResult = freezeResult({\n        item,\n        item_id: itemContract.item_id,\n        item_contract: itemContract,\n        exclusive_key: exclusiveKey,\n        input_index: index,\n        attempts: resumeItem.attempts,\n        attempt_consumed: true,\n        resumed: true,\n        completed_at_ms: readClock(clock),\n        status: resumeItem.outcome,\n        value: resumeItem.value,\n      });\n      await recordPreclaimResult(resumedResult, 'item_resumed');\n    } else {\n      pendingIndexes.push(index);\n    }\n  }\n  const unclaimedIndexes = new Set(pendingIndexes);\n  type PendingResourceKey = number | string;\n  type PendingResourceQueue = { indexes: number[]; cursor: number };\n  const resourceKeysByIndex = new Map<number, PendingResourceKey>();\n  const resourceQueues = new Map<PendingResourceKey, PendingResourceQueue>();\n  for (const index of pendingIndexes) {\n    const exclusiveKey = preflightExclusiveKeys[index]!;\n    const resourceKey: PendingResourceKey = exclusiveKey ?? index;\n    resourceKeysByIndex.set(index, resourceKey);\n    const queue = resourceQueues.get(resourceKey) ?? { indexes: [], cursor: 0 };\n    queue.indexes.push(index);\n    resourceQueues.set(resourceKey, queue);\n  }\n  const readyIndexes = new MinReadyIndexHeap();\n  for (const queue of resourceQueues.values()) readyIndexes.push(queue.indexes[0]!);\n\n  type Claim =\n    | {\n        kind: 'claimed';\n        index: number;\n        itemContract: BatchItemContract;\n        exclusiveKey: TExclusiveKey | null;\n        resourceKey: PendingResourceKey;\n        resumeItem: BatchResumeItem<TOutput> | undefined;\n      }\n    | {\n        kind: 'rejected';\n        resourceKey: PendingResourceKey;\n        result: BatchItemFailedResult<TInput>;\n      };\n\n  const claimNext = async (): Promise<Claim | null> =>\n    schedulerLock(async () => {\n      if (paused || stopped || unclaimedIndexes.size === 0) return null;\n      const index = readyIndexes.pop();\n      if (index === undefined) return null;\n      const resourceKey = resourceKeysByIndex.get(index)!;\n      const item = options.items[index]!;\n      const itemId = itemIds[index]!;\n      const itemContract = preflightItemContracts[index]!;\n      const exclusiveKey = preflightExclusiveKeys[index]!;\n      if (!itemIdentityMatches(options, item, index, itemId)) {\n        unclaimedIndexes.delete(index);\n        const result = identityDriftFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItems.get(itemId),\n          clock,\n        );\n        await emitter.emit('item_identity_drift', {\n          item_id: result.item_id,\n          input_index: result.input_index,\n          status: result.status,\n        });\n        return { kind: 'rejected', resourceKey, result };\n      }\n      const currentItemContract = projectBatchItemContract(options, item, index, itemId);\n      const resumeItem = resumeItems.get(itemId);\n      if (!batchItemContractsMatch(itemContract, currentItemContract)) {\n        unclaimedIndexes.delete(index);\n        const result = projectionDriftFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem,\n          clock,\n        );\n        await emitter.emit('item_projection_drift', {\n          item_id: result.item_id,\n          input_index: result.input_index,\n          status: result.status,\n        });\n        return { kind: 'rejected', resourceKey, result };\n      }\n      const currentExclusiveKey = projectExclusiveKey(options, item, index, currentItemContract);\n      if (exclusiveKey !== currentExclusiveKey) {\n        unclaimedIndexes.delete(index);\n        const result = resourceDriftFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem,\n          clock,\n        );\n        await emitter.emit('item_resource_drift', {\n          item_id: result.item_id,\n          input_index: result.input_index,\n          status: result.status,\n        });\n        return { kind: 'rejected', resourceKey, result };\n      }\n      if (resumeItem && !batchItemContractsMatch(itemContract, resumeItem)) {\n        unclaimedIndexes.delete(index);\n        const result = resumeContractFailure(\n          item,\n          itemContract,\n          exclusiveKey,\n          index,\n          resumeItem.attempts,\n          clock,\n        );\n        await emitter.emit('item_resume_rejected', {\n          item_id: result.item_id,\n          input_index: result.input_index,\n          status: result.status,\n        });\n        return { kind: 'rejected', resourceKey, result };\n      }\n      if (\n        options.shouldPauseBeforeClaim &&\n        (await options.shouldPauseBeforeClaim({\n          item,\n          item_id: itemId,\n          item_contract: itemContract,\n          exclusive_key: exclusiveKey,\n          input_index: index,\n          claimed_count: claimOrder.length,\n          results_input_order: inputOrderedResults(resultsByIndex),\n        }))\n      ) {\n        paused = true;\n        await emitter.emit('batch_paused', {\n          item_id: itemId,\n          input_index: index,\n          status: 'paused',\n        });\n        readyIndexes.push(index);\n        return null;\n      }\n      unclaimedIndexes.delete(index);\n      claimOrder.push(itemId);\n      await emitter.emit('item_claimed', { item_id: itemId, input_index: index });\n      if (exclusiveKey !== null) {\n        await emitter.emit('item_resource_queued', {\n          item_id: itemId,\n          input_index: index,\n          exclusive_key: exclusiveKey,\n        });\n        await emitter.emit('item_resource_acquired', {\n          item_id: itemId,\n          input_index: index,\n          exclusive_key: exclusiveKey,\n        });\n      }\n      return { kind: 'claimed', index, itemContract, exclusiveKey, resourceKey, resumeItem };\n    });\n\n  const complete = async (\n    result: BatchItemResult<TInput, TOutput>,\n    exclusiveKey: string | null,\n    resourceKey: PendingResourceKey,\n  ): Promise<void> =>\n    schedulerLock(async () => {\n      if (exclusiveKey !== null) {\n        await emitter.emit('item_resource_released', {\n          item_id: result.item_id,\n          input_index: result.input_index,\n          exclusive_key: exclusiveKey,\n        });\n      }\n      resultsByIndex.set(result.input_index, result);\n      completionResults.push(result);\n      await emitter.emit('item_completed', {\n        item_id: result.item_id,\n        input_index: result.input_index,\n        status: result.status,\n      });\n      if (\n        !stopped &&\n        (await shouldStopAfter(options, result, claimOrder, resultsByIndex, completionResults))\n      ) {\n        stopped = true;\n        await emitter.emit('batch_stopped', {\n          item_id: result.item_id,\n          input_index: result.input_index,\n          status: 'stopped',\n        });\n      }\n      const resourceQueue = resourceQueues.get(resourceKey)!;\n      resourceQueue.cursor += 1;\n      const nextIndex = resourceQueue.indexes[resourceQueue.cursor];\n      if (nextIndex !== undefined && !paused && !stopped) readyIndexes.push(nextIndex);\n    });\n\n  const worker = async () => {\n    try {\n      while (true) {\n        const claim = await claimNext();\n        if (!claim) return;\n        if (claim.kind === 'rejected') {\n          await complete(claim.result, null, claim.resourceKey);\n          continue;\n        }\n        const execute = () =>\n          executeClaim({\n            options,\n            index: claim.index,\n            itemContract: claim.itemContract,\n            exclusiveKey: claim.exclusiveKey,\n            resumeItem: claim.resumeItem,\n            clock,\n            sleep,\n            emitter,\n          });\n        const result = await execute();\n        await complete(result, claim.exclusiveKey, claim.resourceKey);\n      }\n    } catch (error) {\n      recordInfrastructureFailure(error);\n      throw error;\n    }\n  };\n\n  if (!stopped) {\n    const workerCount = Math.min(options.maxConcurrency, pendingIndexes.length);\n    await Promise.allSettled(Array.from({ length: workerCount }, worker));\n  }\n  if (hasInfrastructureFailure) throw firstInfrastructureFailure;\n\n  const status: BatchStatus = paused ? 'paused' : stopped ? 'stopped' : 'completed';\n  await emitter.emit('batch_completed', { status });\n  await emitter.settled();\n  const resultsInputOrder = inputOrderedResults(resultsByIndex);\n  const unclaimedItemIds = pendingIndexes\n    .filter((index) => unclaimedIndexes.has(index))\n    .map((index) => itemIds[index]!);\n  return Object.freeze({\n    contract,\n    status,\n    claim_order: Object.freeze([...claimOrder]),\n    completion_order: Object.freeze(completionResults.map((result) => result.item_id)),\n    results_input_order: Object.freeze(resultsInputOrder),\n    results_completion_order: Object.freeze([...completionResults]),\n    unclaimed_item_ids: Object.freeze(unclaimedItemIds),\n    events: Object.freeze([...emitter.events]),\n  });\n}\n\nasync function shouldStopAfter<\n  TInput,\n  TOutput,\n  TIdentity extends BatchJsonValue,\n  TExclusiveKey extends string,\n>(\n  options: RunBoundedBatchOptions<TInput, TOutput, TIdentity, TExclusiveKey>,\n  lastResult: BatchItemResult<TInput, TOutput>,\n  claimOrder: readonly string[],\n  resultsByIndex: Map<number, BatchItemResult<TInput, TOutput>>,\n  completionResults: readonly BatchItemResult<TInput, TOutput>[],\n): Promise<boolean> {\n  if (!options.shouldStop) return false;\n  return options.shouldStop({\n    last_result: lastResult,\n    claimed_count: claimOrder.length,\n    results_input_order: inputOrderedResults(resultsByIndex),\n    results_completion_order: [...completionResults],\n  });\n}\n"]}

package/dist/src/lib/batch/errors.d.ts

@@ -0,0 +1,51 @@
+export declare class BatchContractError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class BatchMutationRetryError extends BatchContractError {
+    constructor();
+}
+export declare class BatchMutationReplayError extends Error {
+    constructor(itemId: string);
+}
+export declare class BatchItemResumeContractError extends BatchContractError {
+    readonly itemId: string;
+    constructor(itemId: string);
+}
+export declare class BatchItemProjectionDriftError extends BatchContractError {
+    readonly itemId: string;
+    constructor(itemId: string);
+}
+export declare class BatchItemIdentityDriftError extends BatchContractError {
+    readonly itemId: string;
+    constructor(itemId: string);
+}
+export declare class BatchItemResourceDriftError extends BatchContractError {
+    readonly itemId: string;
+    constructor(itemId: string);
+}
+export declare class BatchRunLockTimeoutError extends Error {
+    readonly code: 'BATCH_RUN_LOCK_TIMEOUT';
+    readonly runPath: string;
+    readonly lockPath: string;
+    readonly identitySha256: string;
+    readonly waitedMs: number;
+    readonly owner: Readonly<Record<string, unknown>> | null;
+    constructor(options: {
+        runPath: string;
+        lockPath: string;
+        identitySha256: string;
+        waitedMs: number;
+        owner: Readonly<Record<string, unknown>> | null;
+    });
+}
+export declare class BatchRunLockIdentityConflictError extends Error {
+    readonly code: 'BATCH_RUN_LOCK_IDENTITY_CONFLICT';
+    readonly runPath: string;
+    readonly activeIdentitySha256: string;
+    readonly requestedIdentitySha256: string;
+    constructor(options: {
+        runPath: string;
+        activeIdentitySha256: string;
+        requestedIdentitySha256: string;
+    });
+}

package/dist/src/lib/batch/errors.js

@@ -0,0 +1,81 @@
+export class BatchContractError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'BatchContractError';
+    }
+}
+export class BatchMutationRetryError extends BatchContractError {
+    constructor() {
+        super('Mutation batches reject automatic retry; use explicit readback recovery instead.');
+        this.name = 'BatchMutationRetryError';
+    }
+}
+export class BatchMutationReplayError extends Error {
+    constructor(itemId) {
+        super(`Mutation item ${itemId} has a consumed incomplete attempt and cannot be replayed without explicit readback recovery.`);
+        this.name = 'BatchMutationReplayError';
+    }
+}
+export class BatchItemResumeContractError extends BatchContractError {
+    itemId;
+    constructor(itemId) {
+        super(`Batch resume item ${itemId} does not match the current item identity, content SHA-256, and policy SHA-256 triple.`);
+        this.name = 'BatchItemResumeContractError';
+        this.itemId = itemId;
+    }
+}
+export class BatchItemProjectionDriftError extends BatchContractError {
+    itemId;
+    constructor(itemId) {
+        super(`Batch item ${itemId} content or policy projection drifted before claim.`);
+        this.name = 'BatchItemProjectionDriftError';
+        this.itemId = itemId;
+    }
+}
+export class BatchItemIdentityDriftError extends BatchContractError {
+    itemId;
+    constructor(itemId) {
+        super(`Batch item ${itemId} identity drifted before claim.`);
+        this.name = 'BatchItemIdentityDriftError';
+        this.itemId = itemId;
+    }
+}
+export class BatchItemResourceDriftError extends BatchContractError {
+    itemId;
+    constructor(itemId) {
+        super(`Batch item ${itemId} exclusive resource key drifted before claim.`);
+        this.name = 'BatchItemResourceDriftError';
+        this.itemId = itemId;
+    }
+}
+export class BatchRunLockTimeoutError extends Error {
+    code = 'BATCH_RUN_LOCK_TIMEOUT';
+    runPath;
+    lockPath;
+    identitySha256;
+    waitedMs;
+    owner;
+    constructor(options) {
+        super(`Timed out after ${options.waitedMs}ms acquiring batch run lock: ${options.lockPath}`);
+        this.name = 'BatchRunLockTimeoutError';
+        this.runPath = options.runPath;
+        this.lockPath = options.lockPath;
+        this.identitySha256 = options.identitySha256;
+        this.waitedMs = options.waitedMs;
+        this.owner = options.owner;
+    }
+}
+export class BatchRunLockIdentityConflictError extends Error {
+    code = 'BATCH_RUN_LOCK_IDENTITY_CONFLICT';
+    runPath;
+    activeIdentitySha256;
+    requestedIdentitySha256;
+    constructor(options) {
+        super(`Batch run path is already locked by another identity in this process: ${options.runPath}`);
+        this.name = 'BatchRunLockIdentityConflictError';
+        this.runPath = options.runPath;
+        this.activeIdentitySha256 = options.activeIdentitySha256;
+        this.requestedIdentitySha256 = options.requestedIdentitySha256;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/lib/batch/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/lib/batch/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,kBAAkB;IAC7D;QACE,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,MAAc;QACxB,KAAK,CACH,iBAAiB,MAAM,+FAA+F,CACvH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,kBAAkB;IACzD,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CACH,qBAAqB,MAAM,wFAAwF,CACpH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,kBAAkB;IAC1D,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CAAC,cAAc,MAAM,qDAAqD,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,kBAAkB;IACxD,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CAAC,cAAc,MAAM,iCAAiC,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,kBAAkB;IACxD,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CAAC,cAAc,MAAM,+CAA+C,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,wBAAiC,CAAC;IACzC,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,cAAc,CAAS;IACvB,QAAQ,CAAS;IACjB,KAAK,CAA2C;IAEzD,YAAY,OAMX;QACC,KAAK,CAAC,mBAAmB,OAAO,CAAC,QAAQ,gCAAgC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACjD,IAAI,GAAG,kCAA2C,CAAC;IACnD,OAAO,CAAS;IAChB,oBAAoB,CAAS;IAC7B,uBAAuB,CAAS;IAEzC,YAAY,OAIX;QACC,KAAK,CACH,yEAAyE,OAAO,CAAC,OAAO,EAAE,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;QACzD,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IACjE,CAAC;CACF","sourcesContent":["export class BatchContractError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'BatchContractError';\n  }\n}\n\nexport class BatchMutationRetryError extends BatchContractError {\n  constructor() {\n    super('Mutation batches reject automatic retry; use explicit readback recovery instead.');\n    this.name = 'BatchMutationRetryError';\n  }\n}\n\nexport class BatchMutationReplayError extends Error {\n  constructor(itemId: string) {\n    super(\n      `Mutation item ${itemId} has a consumed incomplete attempt and cannot be replayed without explicit readback recovery.`,\n    );\n    this.name = 'BatchMutationReplayError';\n  }\n}\n\nexport class BatchItemResumeContractError extends BatchContractError {\n  readonly itemId: string;\n\n  constructor(itemId: string) {\n    super(\n      `Batch resume item ${itemId} does not match the current item identity, content SHA-256, and policy SHA-256 triple.`,\n    );\n    this.name = 'BatchItemResumeContractError';\n    this.itemId = itemId;\n  }\n}\n\nexport class BatchItemProjectionDriftError extends BatchContractError {\n  readonly itemId: string;\n\n  constructor(itemId: string) {\n    super(`Batch item ${itemId} content or policy projection drifted before claim.`);\n    this.name = 'BatchItemProjectionDriftError';\n    this.itemId = itemId;\n  }\n}\n\nexport class BatchItemIdentityDriftError extends BatchContractError {\n  readonly itemId: string;\n\n  constructor(itemId: string) {\n    super(`Batch item ${itemId} identity drifted before claim.`);\n    this.name = 'BatchItemIdentityDriftError';\n    this.itemId = itemId;\n  }\n}\n\nexport class BatchItemResourceDriftError extends BatchContractError {\n  readonly itemId: string;\n\n  constructor(itemId: string) {\n    super(`Batch item ${itemId} exclusive resource key drifted before claim.`);\n    this.name = 'BatchItemResourceDriftError';\n    this.itemId = itemId;\n  }\n}\n\nexport class BatchRunLockTimeoutError extends Error {\n  readonly code = 'BATCH_RUN_LOCK_TIMEOUT' as const;\n  readonly runPath: string;\n  readonly lockPath: string;\n  readonly identitySha256: string;\n  readonly waitedMs: number;\n  readonly owner: Readonly<Record<string, unknown>> | null;\n\n  constructor(options: {\n    runPath: string;\n    lockPath: string;\n    identitySha256: string;\n    waitedMs: number;\n    owner: Readonly<Record<string, unknown>> | null;\n  }) {\n    super(`Timed out after ${options.waitedMs}ms acquiring batch run lock: ${options.lockPath}`);\n    this.name = 'BatchRunLockTimeoutError';\n    this.runPath = options.runPath;\n    this.lockPath = options.lockPath;\n    this.identitySha256 = options.identitySha256;\n    this.waitedMs = options.waitedMs;\n    this.owner = options.owner;\n  }\n}\n\nexport class BatchRunLockIdentityConflictError extends Error {\n  readonly code = 'BATCH_RUN_LOCK_IDENTITY_CONFLICT' as const;\n  readonly runPath: string;\n  readonly activeIdentitySha256: string;\n  readonly requestedIdentitySha256: string;\n\n  constructor(options: {\n    runPath: string;\n    activeIdentitySha256: string;\n    requestedIdentitySha256: string;\n  }) {\n    super(\n      `Batch run path is already locked by another identity in this process: ${options.runPath}`,\n    );\n    this.name = 'BatchRunLockIdentityConflictError';\n    this.runPath = options.runPath;\n    this.activeIdentitySha256 = options.activeIdentitySha256;\n    this.requestedIdentitySha256 = options.requestedIdentitySha256;\n  }\n}\n"]}

package/dist/src/lib/batch/item-projection.d.ts

@@ -0,0 +1,10 @@
+import type { BatchClock, BatchContract, BatchItemContract, BatchItemFailedResult, BatchJsonValue, BatchResumeItem, BatchResumeState, RunBoundedBatchOptions } from './types.js';
+export declare function validateBatchOptions<TInput, TOutput, TIdentity extends BatchJsonValue, TExclusiveKey extends string>(options: RunBoundedBatchOptions<TInput, TOutput, TIdentity, TExclusiveKey>): void;
+export declare function validateResume<TOutput, TIdentity extends BatchJsonValue>(resume: BatchResumeState<TOutput, TIdentity> | undefined, contract: BatchContract<TIdentity>, itemIds: readonly string[]): Map<string, BatchResumeItem<TOutput>>;
+export declare function projectBatchItemContract<TInput, TOutput, TIdentity extends BatchJsonValue, TExclusiveKey extends string>(options: RunBoundedBatchOptions<TInput, TOutput, TIdentity, TExclusiveKey>, item: TInput, index: number, itemId: string): BatchItemContract;
+export declare function itemIdentityMatches<TInput, TOutput, TIdentity extends BatchJsonValue, TExclusiveKey extends string>(options: RunBoundedBatchOptions<TInput, TOutput, TIdentity, TExclusiveKey>, item: TInput, index: number, expectedItemId: string): boolean;
+export declare function identityDriftFailure<TInput, TOutput>(item: TInput, itemContract: BatchItemContract, exclusiveKey: string | null, index: number, resumeItem: BatchResumeItem<TOutput> | undefined, clock: BatchClock): BatchItemFailedResult<TInput>;
+export declare function projectExclusiveKey<TInput, TOutput, TIdentity extends BatchJsonValue, TExclusiveKey extends string>(options: RunBoundedBatchOptions<TInput, TOutput, TIdentity, TExclusiveKey>, item: TInput, index: number, itemContract: BatchItemContract): TExclusiveKey | null;
+export declare function projectionDriftFailure<TInput, TOutput>(item: TInput, itemContract: BatchItemContract, exclusiveKey: string | null, index: number, resumeItem: BatchResumeItem<TOutput> | undefined, clock: BatchClock): BatchItemFailedResult<TInput>;
+export declare function resourceDriftFailure<TInput, TOutput>(item: TInput, itemContract: BatchItemContract, exclusiveKey: string | null, index: number, resumeItem: BatchResumeItem<TOutput> | undefined, clock: BatchClock): BatchItemFailedResult<TInput>;
+export declare function resumeContractFailure<TInput>(item: TInput, itemContract: BatchItemContract, exclusiveKey: string | null, index: number, attempts: number, clock: BatchClock): BatchItemFailedResult<TInput>;

package/dist/src/lib/batch/item-projection.js

@@ -0,0 +1,118 @@
+import { MAX_NODE_TIMER_DELAY_MS, assertBatchContractMatches, createBatchItemContract, isRecord, parseBatchItemContract, parseItemIdentity, } from './canonical-contracts.js';
+import { BatchContractError, BatchItemIdentityDriftError, BatchItemProjectionDriftError, BatchItemResourceDriftError, BatchItemResumeContractError, BatchMutationRetryError, } from './errors.js';
+import { failedResult } from './scheduler-runtime.js';
+import { MAX_BATCH_CONCURRENCY } from './types.js';
+export function validateBatchOptions(options) {
+    if (!Number.isSafeInteger(options.maxConcurrency) ||
+        options.maxConcurrency < 1 ||
+        options.maxConcurrency > MAX_BATCH_CONCURRENCY) {
+        throw new BatchContractError(`Batch maxConcurrency must be a safe integer from 1 to ${MAX_BATCH_CONCURRENCY}.`);
+    }
+    if (options.mode !== 'read' && options.mode !== 'mutation') {
+        throw new BatchContractError('Batch mode must be read or mutation.');
+    }
+    if (options.mode === 'mutation' && options.retry) {
+        throw new BatchMutationRetryError();
+    }
+    if (options.retry &&
+        (!Number.isSafeInteger(options.retry.maxAttempts) ||
+            options.retry.maxAttempts < 1 ||
+            !Number.isSafeInteger(options.retry.maxDelayMs) ||
+            options.retry.maxDelayMs < 0 ||
+            options.retry.maxDelayMs > MAX_NODE_TIMER_DELAY_MS)) {
+        throw new BatchContractError(`Batch retry maxAttempts must be positive and maxDelayMs must be a non-negative safe integer no greater than the maximum supported timer delay (${MAX_NODE_TIMER_DELAY_MS} ms).`);
+    }
+}
+export function validateResume(resume, contract, itemIds) {
+    const result = new Map();
+    if (!resume)
+        return result;
+    assertBatchContractMatches(contract, resume.contract);
+    const currentIds = new Set(itemIds);
+    for (const item of resume.items) {
+        let itemContract;
+        try {
+            itemContract = parseBatchItemContract(item);
+        }
+        catch (error) {
+            throw new BatchContractError('Batch resume contains an invalid item contract.', {
+                cause: error,
+            });
+        }
+        if (!isRecord(item) ||
+            !currentIds.has(itemContract.item_id) ||
+            !Number.isSafeInteger(item.attempts) ||
+            Number(item.attempts) < 1 ||
+            !['attempted', 'completed'].includes(String(item.state))) {
+            throw new BatchContractError('Batch resume contains an invalid or foreign item.');
+        }
+        if (result.has(itemContract.item_id)) {
+            throw new BatchContractError('Batch resume item identities must be unique.');
+        }
+        if (item.state === 'completed') {
+            if (!['succeeded', 'recovered'].includes(String(item.outcome))) {
+                throw new BatchContractError('Completed batch resume items require a successful outcome.');
+            }
+            result.set(itemContract.item_id, Object.freeze({
+                ...itemContract,
+                state: 'completed',
+                outcome: item.outcome,
+                value: item.value,
+                attempts: Number(item.attempts),
+            }));
+        }
+        else {
+            result.set(itemContract.item_id, Object.freeze({
+                ...itemContract,
+                state: 'attempted',
+                attempts: Number(item.attempts),
+            }));
+        }
+    }
+    return result;
+}
+export function projectBatchItemContract(options, item, index, itemId) {
+    return createBatchItemContract({
+        item_id: itemId,
+        content: options.projectItemContent(item, index),
+        policy: options.projectItemPolicy(item, index),
+    });
+}
+export function itemIdentityMatches(options, item, index, expectedItemId) {
+    try {
+        const projected = options.getItemIdentity(item, index);
+        return parseItemIdentity(projected, index) === expectedItemId;
+    }
+    catch {
+        return false;
+    }
+}
+export function identityDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock) {
+    return failedResult(item, itemContract, index, resumeItem?.attempts ?? 0, resumeItem !== undefined, resumeItem !== undefined, clock, new BatchItemIdentityDriftError(itemContract.item_id), exclusiveKey);
+}
+export function projectExclusiveKey(options, item, index, itemContract) {
+    if (!options.getExclusiveKey)
+        return null;
+    const value = options.getExclusiveKey({
+        item,
+        item_id: itemContract.item_id,
+        item_contract: itemContract,
+        input_index: index,
+    });
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== 'string' || value.length === 0 || /[\0\r\n]/u.test(value)) {
+        throw new BatchContractError('Batch exclusive resource keys must be non-empty single-line strings.');
+    }
+    return value;
+}
+export function projectionDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock) {
+    return failedResult(item, itemContract, index, resumeItem?.attempts ?? 0, resumeItem !== undefined, resumeItem !== undefined, clock, new BatchItemProjectionDriftError(itemContract.item_id), exclusiveKey);
+}
+export function resourceDriftFailure(item, itemContract, exclusiveKey, index, resumeItem, clock) {
+    return failedResult(item, itemContract, index, resumeItem?.attempts ?? 0, resumeItem !== undefined, resumeItem !== undefined, clock, new BatchItemResourceDriftError(itemContract.item_id), exclusiveKey);
+}
+export function resumeContractFailure(item, itemContract, exclusiveKey, index, attempts, clock) {
+    return failedResult(item, itemContract, index, attempts, true, true, clock, new BatchItemResumeContractError(itemContract.item_id), exclusiveKey);
+}
+//# sourceMappingURL=item-projection.js.map