@empire-builder-kit/runtime 1.0.0-beta.8 → 1.0.0-rc.1

package/src/async-work/idempotency.d.ts

@@ -0,0 +1,123 @@
+export declare const ASYNC_INBOX_RECORD_VERSION: 1;
+export declare const ASYNC_OUTBOX_RECORD_VERSION: 1;
+export type InboxRecordState = 'claimed' | 'failed' | 'succeeded';
+export interface InboxClaimV1 {
+    attempts: number;
+    consumer: string;
+    effect: string;
+    expiresAt: string;
+    firstAttemptAt: string;
+    handlerVersion: string;
+    idempotencyKey: string;
+    lastAttemptAt: string;
+    payloadDigest: string;
+    resultReference?: string;
+    state: InboxRecordState;
+    version: typeof ASYNC_INBOX_RECORD_VERSION;
+}
+export type InboxClaimOutcomeV1 = {
+    outcome: 'claimed';
+    record: InboxClaimV1;
+} | {
+    outcome: 'duplicate';
+    record: InboxClaimV1;
+} | {
+    outcome: 'conflict';
+    record: InboxClaimV1;
+};
+export interface AsyncInboxAdapter<TTransaction> {
+    claim(transaction: TTransaction, requested: InboxClaimV1): Promise<InboxClaimOutcomeV1>;
+    finish(transaction: TTransaction, input: {
+        claim: InboxClaimV1;
+        finishedAt: string;
+        resultReference?: string;
+        state: 'failed' | 'succeeded';
+    }): Promise<InboxClaimV1>;
+}
+export interface AsyncTransactionAdapter<TTransaction> {
+    transaction<TResult>(work: (transaction: TTransaction) => Promise<TResult>): Promise<TResult>;
+}
+export interface IdempotentWorkInput<TPayload, TResult, TTransaction> {
+    adapter: AsyncInboxAdapter<TTransaction>;
+    consumer: string;
+    effect: string;
+    expiresAt: string;
+    handlerVersion: string;
+    idempotencyKey: string;
+    now: string;
+    payload: TPayload;
+    replayWindowEndsAt: string;
+    resultReference?: (result: TResult) => string | undefined;
+    transaction: AsyncTransactionAdapter<TTransaction>;
+    work: (transaction: TTransaction) => Promise<TResult>;
+}
+export type IdempotentWorkResult<TResult> = {
+    attempts: number;
+    outcome: 'completed';
+    result: TResult;
+} | {
+    attempts: number;
+    outcome: 'duplicate';
+    resultReference?: string;
+    state: 'claimed' | 'failed' | 'succeeded';
+};
+/**
+ * Claims the inbox row and executes the domain mutation inside the exact same
+ * caller-provided transaction. The adapter is responsible for the durable,
+ * unique `(consumer, effect, idempotencyKey)` constraint.
+ */
+export declare function runIdempotentWork<TPayload, TResult, TTransaction>(input: IdempotentWorkInput<TPayload, TResult, TTransaction>): Promise<IdempotentWorkResult<TResult>>;
+export interface OutboxRecordV1<TPayload = unknown> {
+    aggregateId: string;
+    aggregateSequence: number;
+    contract: string;
+    createdAt: string;
+    messageId: string;
+    payload: TPayload;
+    payloadDigest: string;
+    publishAttempts: number;
+    state: 'pending' | 'published';
+    version: typeof ASYNC_OUTBOX_RECORD_VERSION;
+}
+export declare function createOutboxRecord<TPayload>(input: {
+    aggregateId: string;
+    aggregateSequence: number;
+    contract: string;
+    createdAt: string;
+    messageId: string;
+    payload: TPayload;
+}): OutboxRecordV1<TPayload>;
+export interface AsyncOutboxAdapter<TTransaction, TPayload> {
+    append(transaction: TTransaction, record: OutboxRecordV1<TPayload>): Promise<void>;
+}
+export declare function appendOutboxInTransaction<TTransaction, TPayload>(adapter: AsyncOutboxAdapter<TTransaction, TPayload>, transaction: TTransaction, record: OutboxRecordV1<TPayload>): Promise<void>;
+export interface OutboxRelayAdapter<TPayload> {
+    markPublished(input: {
+        messageId: string;
+        publishedAt: string;
+        receiptReference: string;
+    }): Promise<void>;
+    publish(input: {
+        idempotencyKey: string;
+        messageId: string;
+        payload: TPayload;
+        payloadDigest: string;
+    }): Promise<{
+        receiptReference: string;
+    }>;
+}
+export interface OutboxRelayResultV1 {
+    messageId: string;
+    outcome: 'published' | 'publish-failed' | 'published-unconfirmed';
+    reconciliationId: string;
+}
+/**
+ * A publish that succeeds before `markPublished` fails is deliberately
+ * reported as unconfirmed. Retrying may publish a duplicate, so consumers
+ * still require inbox idempotency.
+ */
+export declare function relayOutboxRecord<TPayload>(input: {
+    adapter: OutboxRelayAdapter<TPayload>;
+    now: string;
+    record: OutboxRecordV1<TPayload>;
+}): Promise<OutboxRelayResultV1>;

package/src/async-work/idempotency.js

@@ -0,0 +1,167 @@
+import { __awaiter } from "tslib";
+import { asyncWorkDigest, asyncWorkIdentity, failAsyncWork, requireAsyncDigest, requireAsyncIdentifier, requireAsyncInteger, requireCanonicalAsyncTimestamp, } from './contract.js';
+export const ASYNC_INBOX_RECORD_VERSION = 1;
+export const ASYNC_OUTBOX_RECORD_VERSION = 1;
+function createInboxClaim(input) {
+    const now = requireCanonicalAsyncTimestamp(input.now, '/now');
+    const expiresAt = requireCanonicalAsyncTimestamp(input.expiresAt, '/expiresAt');
+    const replayWindowEndsAt = requireCanonicalAsyncTimestamp(input.replayWindowEndsAt, '/replayWindowEndsAt');
+    if (Date.parse(expiresAt) <= Date.parse(replayWindowEndsAt)) {
+        failAsyncWork('async-idempotency-window-invalid', '/expiresAt', 'must be later than the final legitimate replay or redelivery time');
+    }
+    return {
+        attempts: 1,
+        consumer: requireAsyncIdentifier(input.consumer, '/consumer'),
+        effect: requireAsyncIdentifier(input.effect, '/effect'),
+        expiresAt,
+        firstAttemptAt: now,
+        handlerVersion: requireAsyncIdentifier(input.handlerVersion, '/handlerVersion'),
+        idempotencyKey: requireAsyncIdentifier(input.idempotencyKey, '/idempotencyKey'),
+        lastAttemptAt: now,
+        payloadDigest: asyncWorkDigest(input.payload),
+        state: 'claimed',
+        version: ASYNC_INBOX_RECORD_VERSION,
+    };
+}
+function validateReturnedClaim(value, requested, pointer) {
+    if ((value === null || value === void 0 ? void 0 : value.version) !== ASYNC_INBOX_RECORD_VERSION ||
+        value.consumer !== requested.consumer ||
+        value.effect !== requested.effect ||
+        value.idempotencyKey !== requested.idempotencyKey ||
+        !['claimed', 'failed', 'succeeded'].includes(value.state)) {
+        failAsyncWork('async-adapter-outcome-invalid', pointer, 'adapter returned a claim for a different identity or unsupported state');
+    }
+    requireAsyncDigest(value.payloadDigest, `${pointer}/payloadDigest`);
+    requireAsyncInteger(value.attempts, `${pointer}/attempts`, 1, 1000000);
+    requireCanonicalAsyncTimestamp(value.firstAttemptAt, `${pointer}/firstAttemptAt`);
+    requireCanonicalAsyncTimestamp(value.lastAttemptAt, `${pointer}/lastAttemptAt`);
+    requireCanonicalAsyncTimestamp(value.expiresAt, `${pointer}/expiresAt`);
+    if (value.resultReference !== undefined) {
+        requireAsyncIdentifier(value.resultReference, `${pointer}/resultReference`);
+    }
+    return value;
+}
+/**
+ * Claims the inbox row and executes the domain mutation inside the exact same
+ * caller-provided transaction. The adapter is responsible for the durable,
+ * unique `(consumer, effect, idempotencyKey)` constraint.
+ */
+export function runIdempotentWork(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const requested = createInboxClaim(input);
+        return input.transaction.transaction((transaction) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const claim = yield input.adapter.claim(transaction, requested);
+            const record = validateReturnedClaim(claim === null || claim === void 0 ? void 0 : claim.record, requested, '/adapter/claim');
+            if (claim.outcome === 'conflict' ||
+                record.payloadDigest !== requested.payloadDigest) {
+                failAsyncWork('async-idempotency-conflict', '/payload', 'the idempotency key was already used for a different payload');
+            }
+            if (claim.outcome === 'duplicate') {
+                return Object.assign(Object.assign({ attempts: record.attempts, outcome: 'duplicate' }, (record.resultReference
+                    ? { resultReference: record.resultReference }
+                    : {})), { state: record.state });
+            }
+            if (claim.outcome !== 'claimed') {
+                failAsyncWork('async-adapter-outcome-invalid', '/adapter/claim/outcome', 'must be claimed, duplicate, or conflict');
+            }
+            const result = yield input.work(transaction);
+            const resultReference = (_a = input.resultReference) === null || _a === void 0 ? void 0 : _a.call(input, result);
+            if (resultReference !== undefined) {
+                requireAsyncIdentifier(resultReference, '/resultReference');
+            }
+            const finished = yield input.adapter.finish(transaction, Object.assign(Object.assign({ claim: record, finishedAt: requested.lastAttemptAt }, (resultReference ? { resultReference } : {})), { state: 'succeeded' }));
+            const finalRecord = validateReturnedClaim(finished, requested, '/adapter/finish');
+            if (finalRecord.state !== 'succeeded') {
+                failAsyncWork('async-adapter-outcome-invalid', '/adapter/finish/state', 'successful work must finish the claim as succeeded');
+            }
+            return {
+                attempts: finalRecord.attempts,
+                outcome: 'completed',
+                result,
+            };
+        }));
+    });
+}
+export function createOutboxRecord(input) {
+    return {
+        aggregateId: requireAsyncIdentifier(input.aggregateId, '/aggregateId'),
+        aggregateSequence: requireAsyncInteger(input.aggregateSequence, '/aggregateSequence', 1, Number.MAX_SAFE_INTEGER),
+        contract: requireAsyncIdentifier(input.contract, '/contract'),
+        createdAt: requireCanonicalAsyncTimestamp(input.createdAt, '/createdAt'),
+        messageId: requireAsyncIdentifier(input.messageId, '/messageId'),
+        payload: input.payload,
+        payloadDigest: asyncWorkDigest(input.payload),
+        publishAttempts: 0,
+        state: 'pending',
+        version: ASYNC_OUTBOX_RECORD_VERSION,
+    };
+}
+export function appendOutboxInTransaction(adapter, transaction, record) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (record.version !== ASYNC_OUTBOX_RECORD_VERSION ||
+            record.state !== 'pending' ||
+            record.publishAttempts !== 0 ||
+            asyncWorkDigest(record.payload) !== record.payloadDigest) {
+            failAsyncWork('async-input-invalid', '/record', 'must be a new, internally consistent v1 outbox record');
+        }
+        yield adapter.append(transaction, record);
+    });
+}
+/**
+ * A publish that succeeds before `markPublished` fails is deliberately
+ * reported as unconfirmed. Retrying may publish a duplicate, so consumers
+ * still require inbox idempotency.
+ */
+export function relayOutboxRecord(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const publishedAt = requireCanonicalAsyncTimestamp(input.now, '/now');
+        const record = input.record;
+        if (record.version !== ASYNC_OUTBOX_RECORD_VERSION ||
+            record.state !== 'pending' ||
+            asyncWorkDigest(record.payload) !== record.payloadDigest) {
+            failAsyncWork('async-input-invalid', '/record', 'must be a consistent pending v1 outbox record');
+        }
+        const reconciliationId = asyncWorkIdentity('outbox-reconcile-v1', [
+            record.messageId,
+            record.payloadDigest,
+        ]);
+        let receipt;
+        try {
+            receipt = yield input.adapter.publish({
+                idempotencyKey: record.messageId,
+                messageId: record.messageId,
+                payload: record.payload,
+                payloadDigest: record.payloadDigest,
+            });
+        }
+        catch (_a) {
+            return {
+                messageId: record.messageId,
+                outcome: 'publish-failed',
+                reconciliationId,
+            };
+        }
+        const receiptReference = requireAsyncIdentifier(receipt.receiptReference, '/adapter/publish/receiptReference');
+        try {
+            yield input.adapter.markPublished({
+                messageId: record.messageId,
+                publishedAt,
+                receiptReference,
+            });
+        }
+        catch (_b) {
+            return {
+                messageId: record.messageId,
+                outcome: 'published-unconfirmed',
+                reconciliationId,
+            };
+        }
+        return {
+            messageId: record.messageId,
+            outcome: 'published',
+            reconciliationId,
+        };
+    });
+}
+//# sourceMappingURL=idempotency.js.map

package/src/async-work/idempotency.js.map

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

package/src/async-work/index.d.ts

@@ -0,0 +1,8 @@
+export * from './contract.js';
+export * from './idempotency.js';
+export * from './provider.js';
+export * from './recovery.js';
+export * from './schedule.js';
+export * from './sqs.js';
+export * from './webhook.js';
+export * from './workflow.js';

package/src/async-work/index.js

@@ -0,0 +1,9 @@
+export * from './contract.js';
+export * from './idempotency.js';
+export * from './provider.js';
+export * from './recovery.js';
+export * from './schedule.js';
+export * from './sqs.js';
+export * from './webhook.js';
+export * from './workflow.js';
+//# sourceMappingURL=index.js.map

package/src/async-work/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/async-work/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/src/async-work/provider.d.ts

@@ -0,0 +1,90 @@
+import { type RetryPolicyV1 } from './sqs.js';
+export declare const ASYNC_PROVIDER_DELIVERY_VERSION: 1;
+export interface ProviderContractV1 {
+    account: string;
+    apiVersion: string;
+    dataClassification: string;
+    idempotencyRepeatSafety: 'provider-guaranteed' | 'unproven';
+    operation: string;
+    provider: string;
+    retry: RetryPolicyV1;
+    timeoutMs: number;
+    version: 1;
+}
+export interface ProviderDeliveryV1<TRequest = unknown> {
+    contract: ProviderContractV1;
+    createdAt: string;
+    deliveryId: string;
+    idempotencyKey: string;
+    request: TRequest;
+    requestDigest: string;
+    version: typeof ASYNC_PROVIDER_DELIVERY_VERSION;
+}
+export declare function createProviderDelivery<TRequest>(input: {
+    contract: ProviderContractV1;
+    createdAt: string;
+    operationId: string;
+    request: TRequest;
+}): ProviderDeliveryV1<TRequest>;
+export type ProviderAttemptOutcome = {
+    outcome: 'confirmed';
+    providerReference: string;
+    statusCode: number;
+} | {
+    errorCode: string;
+    outcome: 'permanent' | 'retryable' | 'unknown';
+};
+export interface ProviderDeliveryAdapter<TRequest> {
+    deliver(input: {
+        account: string;
+        apiVersion: string;
+        idempotencyKey: string;
+        operation: string;
+        provider: string;
+        request: TRequest;
+        signal: AbortSignal;
+        timeoutMs: number;
+    }): Promise<ProviderAttemptOutcome>;
+}
+export type ProviderDeliveryResultV1 = {
+    attempts: number;
+    deliveryId: string;
+    outcome: 'confirmed';
+    providerReference: string;
+    statusCode: number;
+} | {
+    attempts: number;
+    deliveryId: string;
+    errorCode: string;
+    outcome: 'permanent-failure' | 'reconciliation-required';
+    reconciliationId: string;
+};
+export declare function runProviderDelivery<TRequest>(input: {
+    adapter: ProviderDeliveryAdapter<TRequest>;
+    delivery: ProviderDeliveryV1<TRequest>;
+    now?: () => number;
+    random?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+}): Promise<ProviderDeliveryResultV1>;
+export interface ProviderReconciliationAdapter {
+    lookup(input: {
+        account: string;
+        idempotencyKey: string;
+        operation: string;
+        provider: string;
+    }): Promise<{
+        outcome: 'confirmed';
+        providerReference: string;
+    } | {
+        outcome: 'missing' | 'unknown';
+    }>;
+}
+export declare function reconcileProviderDelivery<TRequest>(input: {
+    adapter: ProviderReconciliationAdapter;
+    delivery: ProviderDeliveryV1<TRequest>;
+}): Promise<{
+    deliveryId: string;
+    outcome: 'confirmed' | 'missing' | 'unknown';
+    providerReference?: string;
+    reconciliationId: string;
+}>;

package/src/async-work/provider.js

@@ -0,0 +1,155 @@
+import { __awaiter } from "tslib";
+import { asyncWorkDigest, asyncWorkIdentity, failAsyncWork, requireAsyncIdentifier, requireAsyncInteger, requireCanonicalAsyncTimestamp, } from './contract.js';
+import { executeWithRetry, } from './sqs.js';
+export const ASYNC_PROVIDER_DELIVERY_VERSION = 1;
+function normalizeProviderContract(contract) {
+    if ((contract === null || contract === void 0 ? void 0 : contract.version) !== 1) {
+        failAsyncWork('async-input-invalid', '/contract/version', 'must be one');
+    }
+    const normalized = {
+        account: requireAsyncIdentifier(contract.account, '/contract/account'),
+        apiVersion: requireAsyncIdentifier(contract.apiVersion, '/contract/apiVersion'),
+        dataClassification: requireAsyncIdentifier(contract.dataClassification, '/contract/dataClassification'),
+        idempotencyRepeatSafety: contract.idempotencyRepeatSafety,
+        operation: requireAsyncIdentifier(contract.operation, '/contract/operation'),
+        provider: requireAsyncIdentifier(contract.provider, '/contract/provider'),
+        retry: contract.retry,
+        timeoutMs: requireAsyncInteger(contract.timeoutMs, '/contract/timeoutMs', 1, 900000),
+        version: 1,
+    };
+    if (!['provider-guaranteed', 'unproven'].includes(normalized.idempotencyRepeatSafety)) {
+        failAsyncWork('async-input-invalid', '/contract/idempotencyRepeatSafety', 'must explicitly be provider-guaranteed or unproven');
+    }
+    if (normalized.timeoutMs >= normalized.retry.attemptTimeoutMs) {
+        failAsyncWork('async-input-invalid', '/contract/timeoutMs', 'provider timeout must be shorter than the retry attempt timeout');
+    }
+    return normalized;
+}
+export function createProviderDelivery(input) {
+    const contract = normalizeProviderContract(input.contract);
+    const createdAt = requireCanonicalAsyncTimestamp(input.createdAt, '/createdAt');
+    const operationId = requireAsyncIdentifier(input.operationId, '/operationId');
+    const requestDigest = asyncWorkDigest(input.request);
+    return {
+        contract,
+        createdAt,
+        deliveryId: asyncWorkIdentity('provider-delivery-v1', [
+            contract.provider,
+            contract.account,
+            contract.operation,
+            operationId,
+        ]),
+        idempotencyKey: operationId,
+        request: input.request,
+        requestDigest,
+        version: ASYNC_PROVIDER_DELIVERY_VERSION,
+    };
+}
+export function runProviderDelivery(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const delivery = input.delivery;
+        if ((delivery === null || delivery === void 0 ? void 0 : delivery.version) !== ASYNC_PROVIDER_DELIVERY_VERSION ||
+            asyncWorkDigest(delivery.request) !== delivery.requestDigest) {
+            failAsyncWork('async-input-invalid', '/delivery', 'must be a consistent v1 provider delivery');
+        }
+        const contract = normalizeProviderContract(delivery.contract);
+        let lastProviderOutcome;
+        let unknownOutcome = false;
+        const result = yield executeWithRetry(Object.assign(Object.assign(Object.assign(Object.assign({ attempt: (_a) => __awaiter(this, [_a], void 0, function* ({ signal }) {
+                const attempt = yield input.adapter.deliver({
+                    account: contract.account,
+                    apiVersion: contract.apiVersion,
+                    idempotencyKey: delivery.idempotencyKey,
+                    operation: contract.operation,
+                    provider: contract.provider,
+                    request: delivery.request,
+                    signal,
+                    timeoutMs: contract.timeoutMs,
+                });
+                if (attempt.outcome === 'confirmed') {
+                    lastProviderOutcome = attempt;
+                    return { outcome: 'succeeded', value: true };
+                }
+                const errorCode = requireAsyncIdentifier(attempt.errorCode, '/adapter/deliver/errorCode');
+                if (attempt.outcome === 'permanent') {
+                    return { errorCode, outcome: 'terminal' };
+                }
+                if (attempt.outcome === 'unknown') {
+                    unknownOutcome = true;
+                    if (contract.idempotencyRepeatSafety === 'unproven') {
+                        return { errorCode, outcome: 'terminal' };
+                    }
+                }
+                return { errorCode, outcome: 'retryable' };
+            }) }, (input.now ? { now: input.now } : {})), { policy: contract.retry }), (input.random ? { random: input.random } : {})), (input.sleep ? { sleep: input.sleep } : {})));
+        if (result.outcome === 'succeeded' && lastProviderOutcome) {
+            return {
+                attempts: result.attempts,
+                deliveryId: delivery.deliveryId,
+                outcome: 'confirmed',
+                providerReference: requireAsyncIdentifier(lastProviderOutcome.providerReference, '/adapter/deliver/providerReference'),
+                statusCode: requireAsyncInteger(lastProviderOutcome.statusCode, '/adapter/deliver/statusCode', 100, 599),
+            };
+        }
+        if (result.outcome === 'succeeded') {
+            failAsyncWork('async-adapter-outcome-invalid', '/adapter/deliver', 'reported success without a confirmed provider outcome');
+        }
+        const reconciliationId = asyncWorkIdentity('provider-reconcile-v1', [
+            delivery.deliveryId,
+            delivery.requestDigest,
+        ]);
+        if (result.outcome === 'terminal' && !unknownOutcome) {
+            return {
+                attempts: result.attempts,
+                deliveryId: delivery.deliveryId,
+                errorCode: result.errorCode,
+                outcome: 'permanent-failure',
+                reconciliationId,
+            };
+        }
+        return {
+            attempts: result.attempts,
+            deliveryId: delivery.deliveryId,
+            errorCode: result.errorCode,
+            outcome: 'reconciliation-required',
+            reconciliationId,
+        };
+    });
+}
+export function reconcileProviderDelivery(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (((_a = input.delivery) === null || _a === void 0 ? void 0 : _a.version) !== ASYNC_PROVIDER_DELIVERY_VERSION ||
+            asyncWorkDigest(input.delivery.request) !== input.delivery.requestDigest) {
+            failAsyncWork('async-input-invalid', '/delivery', 'must be a consistent v1 provider delivery');
+        }
+        const contract = normalizeProviderContract(input.delivery.contract);
+        const reconciliationId = asyncWorkIdentity('provider-reconcile-v1', [
+            input.delivery.deliveryId,
+            input.delivery.requestDigest,
+        ]);
+        const outcome = yield input.adapter.lookup({
+            account: contract.account,
+            idempotencyKey: input.delivery.idempotencyKey,
+            operation: contract.operation,
+            provider: contract.provider,
+        });
+        if (outcome.outcome === 'confirmed') {
+            return {
+                deliveryId: input.delivery.deliveryId,
+                outcome: 'confirmed',
+                providerReference: requireAsyncIdentifier(outcome.providerReference, '/adapter/lookup/providerReference'),
+                reconciliationId,
+            };
+        }
+        if (!['missing', 'unknown'].includes(outcome.outcome)) {
+            failAsyncWork('async-adapter-outcome-invalid', '/adapter/lookup/outcome', 'must be confirmed, missing, or unknown');
+        }
+        return {
+            deliveryId: input.delivery.deliveryId,
+            outcome: outcome.outcome,
+            reconciliationId,
+        };
+    });
+}
+//# sourceMappingURL=provider.js.map

package/src/async-work/provider.js.map

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