@empire-builder-kit/runtime 1.0.0-beta.9 → 1.0.0-rc.11

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

@@ -0,0 +1,103 @@
+export declare const ASYNC_BOUNDED_REDRIVE_REPORT_VERSION: 1;
+export interface BoundedRedriveScopeV1 {
+    maximumMessages: number;
+    maximumRatePerSecond: number;
+    maximumScannedMessages: number;
+    sentAfter: string;
+    sentBefore: string;
+    tenantReferenceDigests: readonly string[];
+    workTypes: readonly string[];
+}
+export interface BoundedRedriveReportV1 {
+    accountReferenceDigest: string;
+    destinationReferenceDigest: string;
+    expiresAt: string;
+    preparedAt: string;
+    region: string;
+    reportDigest: string;
+    scope: BoundedRedriveScopeV1;
+    slice: string;
+    sourceReferenceDigest: string;
+    stage: string;
+    version: typeof ASYNC_BOUNDED_REDRIVE_REPORT_VERSION;
+}
+export interface BoundedRedriveItem<TValue> {
+    messageReference: string;
+    sentAt: string;
+    tenantReference: string;
+    value: TValue;
+    workType: string;
+}
+export interface BoundedRedriveConvergence {
+    acknowledged: number;
+    completedLineageDigests: readonly string[];
+    failed: number;
+    lineageDigests: readonly string[];
+    operationHandle: string;
+    reportDigest: string;
+    scanned: number;
+    selected: number;
+    status: 'completed' | 'failed' | 'started';
+}
+export declare function validateRecoveryQueueContext(input: {
+    accountId: string;
+    allowedStages: readonly string[];
+    callerStage?: string;
+    expectedBinding: 'destination' | 'source';
+    expectedKind: string;
+    queueArn: string;
+    region: string;
+    slice: string;
+    tags: Readonly<Record<string, string | undefined>>;
+}): {
+    kind: string;
+    stage: string;
+};
+export interface BoundedRedriveAdapter<TValue> {
+    acknowledge(item: BoundedRedriveItem<TValue>): Promise<boolean>;
+    converge(convergence: BoundedRedriveConvergence): Promise<BoundedRedriveConvergence>;
+    forward(item: BoundedRedriveItem<TValue>): Promise<boolean>;
+    read(reportDigest: string): Promise<BoundedRedriveConvergence | undefined>;
+    receive(limit: number): Promise<readonly BoundedRedriveItem<TValue>[]>;
+    reserve(input: {
+        reportDigest: string;
+    }): Promise<{
+        operationHandle: string;
+        outcome: 'reserved';
+    } | {
+        convergence: BoundedRedriveConvergence;
+        outcome: 'existing';
+    }>;
+}
+export declare function classifyRecoveryLease(input: {
+    leaseExpiresAt: string;
+    now: string;
+    status: 'completed' | 'failed' | 'started';
+}): 'active' | 'stale-takeover' | 'terminal';
+export type RecoveryReservationOutcome = 'reserved' | 'stale-resumed' | 'terminal-completed' | 'terminal-failed';
+export declare function recoveryReservationAction(outcome: RecoveryReservationOutcome): 'duplicate' | 'execute';
+export declare function boundedRedriveTenantDigest(tenantReference: string): string;
+export declare function createBoundedRedriveReport(input: {
+    accountReferenceDigest: string;
+    destinationReferenceDigest: string;
+    expiresAt: string;
+    preparedAt: string;
+    region: string;
+    scope: BoundedRedriveScopeV1;
+    slice: string;
+    sourceReferenceDigest: string;
+    stage: string;
+}): BoundedRedriveReportV1;
+export declare function runBoundedRedrive<TValue>(input: {
+    adapter: BoundedRedriveAdapter<TValue>;
+    now: string;
+    sleep?: (milliseconds: number) => Promise<void>;
+    report: BoundedRedriveReportV1;
+}): Promise<BoundedRedriveConvergence & {
+    outcome: 'applied' | 'duplicate';
+}>;
+export declare function readBoundedRedriveStatus<TValue>(input: {
+    adapter: BoundedRedriveAdapter<TValue>;
+    operationHandle: string;
+    reportDigest: string;
+}): Promise<BoundedRedriveConvergence | undefined>;

package/src/async-work/recovery.js

@@ -0,0 +1,291 @@
+import { __awaiter } from "tslib";
+import { asyncWorkDigest, failAsyncWork, requireAsyncIdentifier, requireAsyncInteger, requireCanonicalAsyncTimestamp, } from './contract.js';
+export const ASYNC_BOUNDED_REDRIVE_REPORT_VERSION = 1;
+export function validateRecoveryQueueContext(input) {
+    const accountId = requireAsyncIdentifier(input.accountId, '/accountId');
+    const region = requireAsyncIdentifier(input.region, '/region');
+    const slice = requireAsyncIdentifier(input.slice, '/slice');
+    const queueArn = requireAsyncIdentifier(input.queueArn, '/queueArn');
+    const match = queueArn.match(/^arn:(?:aws|aws-cn|aws-us-gov):sqs:([a-z0-9-]+):(\d{12}):[^:]+$/);
+    const bindingTag = input.expectedBinding === 'source'
+        ? 'ebk:async-recovery-source'
+        : 'ebk:async-recovery-destination';
+    const stage = input.tags['ebk:stage'];
+    if (!match ||
+        match[1] !== region ||
+        match[2] !== accountId ||
+        input.tags['ebk:slice'] !== slice ||
+        input.tags[bindingTag] !== input.expectedKind ||
+        typeof stage !== 'string' ||
+        !input.allowedStages.includes(stage) ||
+        (input.callerStage !== undefined && input.callerStage !== stage)) {
+        failAsyncWork('async-input-invalid', '/queueContext', 'queue ARN and generated account, region, Slice, stage, and recovery tags must match');
+    }
+    return { kind: input.expectedKind, stage };
+}
+export function classifyRecoveryLease(input) {
+    const now = requireCanonicalAsyncTimestamp(input.now, '/lease/now');
+    const leaseExpiresAt = requireCanonicalAsyncTimestamp(input.leaseExpiresAt, '/lease/expiresAt');
+    if (!['completed', 'failed', 'started'].includes(input.status)) {
+        failAsyncWork('async-input-invalid', '/lease/status', 'must be completed, failed, or started');
+    }
+    if (input.status !== 'started')
+        return 'terminal';
+    return Date.parse(now) < Date.parse(leaseExpiresAt)
+        ? 'active'
+        : 'stale-takeover';
+}
+export function recoveryReservationAction(outcome) {
+    if (outcome === 'terminal-completed')
+        return 'duplicate';
+    if (outcome === 'terminal-failed') {
+        throw new Error('async-recovery-terminal-failed');
+    }
+    if (outcome === 'reserved' || outcome === 'stale-resumed')
+        return 'execute';
+    failAsyncWork('async-input-invalid', '/reservation/outcome', 'must be reserved, stale-resumed, terminal-completed, or terminal-failed');
+}
+function requireDigest(value, path) {
+    if (!/^sha256:[a-f0-9]{64}$/.test(value)) {
+        failAsyncWork('async-input-invalid', path, 'must be one sha256 digest');
+    }
+    return value;
+}
+function normalizeScope(scope) {
+    const sentAfter = requireCanonicalAsyncTimestamp(scope.sentAfter, '/scope/sentAfter');
+    const sentBefore = requireCanonicalAsyncTimestamp(scope.sentBefore, '/scope/sentBefore');
+    if (Date.parse(sentAfter) >= Date.parse(sentBefore)) {
+        failAsyncWork('async-input-invalid', '/scope', 'sentAfter must precede sentBefore');
+    }
+    const maximumMessages = requireAsyncInteger(scope.maximumMessages, '/scope/maximumMessages', 1, 1000);
+    const maximumRatePerSecond = requireAsyncInteger(scope.maximumRatePerSecond, '/scope/maximumRatePerSecond', 1, 10);
+    const maximumScannedMessages = requireAsyncInteger(scope.maximumScannedMessages, '/scope/maximumScannedMessages', maximumMessages, 10000);
+    if (!Array.isArray(scope.tenantReferenceDigests) ||
+        scope.tenantReferenceDigests.length < 1 ||
+        scope.tenantReferenceDigests.length > 1000) {
+        failAsyncWork('async-input-invalid', '/scope/tenantReferenceDigests', 'must select one through 1000 tenant digests');
+    }
+    const tenantReferenceDigests = [
+        ...new Set(scope.tenantReferenceDigests.map((value, index) => requireDigest(value, `/scope/tenantReferenceDigests/${index}`))),
+    ].sort();
+    if (tenantReferenceDigests.length !== scope.tenantReferenceDigests.length) {
+        failAsyncWork('async-input-invalid', '/scope/tenantReferenceDigests', 'must not contain duplicates');
+    }
+    if (!Array.isArray(scope.workTypes) ||
+        scope.workTypes.length < 1 ||
+        scope.workTypes.length > 100) {
+        failAsyncWork('async-input-invalid', '/scope/workTypes', 'must select one through 100 work types');
+    }
+    const workTypes = [
+        ...new Set(scope.workTypes.map((value, index) => requireAsyncIdentifier(value, `/scope/workTypes/${index}`))),
+    ].sort();
+    if (workTypes.length !== scope.workTypes.length) {
+        failAsyncWork('async-input-invalid', '/scope/workTypes', 'must not contain duplicates');
+    }
+    return {
+        maximumMessages,
+        maximumRatePerSecond,
+        maximumScannedMessages,
+        sentAfter,
+        sentBefore,
+        tenantReferenceDigests,
+        workTypes,
+    };
+}
+export function boundedRedriveTenantDigest(tenantReference) {
+    return asyncWorkDigest({
+        kind: 'bounded-redrive-tenant-v1',
+        value: requireAsyncIdentifier(tenantReference, '/tenantReference'),
+    });
+}
+export function createBoundedRedriveReport(input) {
+    const preparedAt = requireCanonicalAsyncTimestamp(input.preparedAt, '/preparedAt');
+    const expiresAt = requireCanonicalAsyncTimestamp(input.expiresAt, '/expiresAt');
+    if (Date.parse(expiresAt) <= Date.parse(preparedAt) ||
+        Date.parse(expiresAt) - Date.parse(preparedAt) > 30 * 60000) {
+        failAsyncWork('async-input-invalid', '/expiresAt', 'must be after preparedAt by no more than 30 minutes');
+    }
+    const material = {
+        accountReferenceDigest: requireDigest(input.accountReferenceDigest, '/accountReferenceDigest'),
+        destinationReferenceDigest: requireDigest(input.destinationReferenceDigest, '/destinationReferenceDigest'),
+        expiresAt,
+        preparedAt,
+        region: requireAsyncIdentifier(input.region, '/region'),
+        scope: normalizeScope(input.scope),
+        slice: requireAsyncIdentifier(input.slice, '/slice'),
+        sourceReferenceDigest: requireDigest(input.sourceReferenceDigest, '/sourceReferenceDigest'),
+        stage: requireAsyncIdentifier(input.stage, '/stage'),
+        version: ASYNC_BOUNDED_REDRIVE_REPORT_VERSION,
+    };
+    return Object.assign(Object.assign({}, material), { reportDigest: asyncWorkDigest(material) });
+}
+function validateReport(report, checkExpiry, now) {
+    const normalized = createBoundedRedriveReport(report);
+    if (report.version !== ASYNC_BOUNDED_REDRIVE_REPORT_VERSION ||
+        normalized.reportDigest !== report.reportDigest) {
+        failAsyncWork('async-report-invalid', '/report', 'digest must bind the exact bounded redrive report');
+    }
+    if (checkExpiry && Date.parse(now) >= Date.parse(normalized.expiresAt)) {
+        failAsyncWork('async-report-expired', '/report/expiresAt', 'report expired');
+    }
+    return normalized;
+}
+function selected(item, scope) {
+    const sentAt = requireCanonicalAsyncTimestamp(item.sentAt, '/item/sentAt');
+    return (Date.parse(sentAt) >= Date.parse(scope.sentAfter) &&
+        Date.parse(sentAt) < Date.parse(scope.sentBefore) &&
+        scope.workTypes.includes(requireAsyncIdentifier(item.workType, '/item/workType')) &&
+        scope.tenantReferenceDigests.includes(boundedRedriveTenantDigest(item.tenantReference)));
+}
+function validatePriorConvergence(convergence, report) {
+    const lineageDigests = convergence.lineageDigests.map((value, index) => requireDigest(value, `/convergence/lineageDigests/${index}`));
+    const completedLineageDigests = convergence.completedLineageDigests.map((value, index) => requireDigest(value, `/convergence/completedLineageDigests/${index}`));
+    const lineage = new Set(lineageDigests);
+    const completed = new Set(completedLineageDigests);
+    const acknowledged = requireAsyncInteger(convergence.acknowledged, '/convergence/acknowledged', 0, report.scope.maximumMessages);
+    const failed = requireAsyncInteger(convergence.failed, '/convergence/failed', 0, report.scope.maximumScannedMessages);
+    const scanned = requireAsyncInteger(convergence.scanned, '/convergence/scanned', 0, report.scope.maximumScannedMessages);
+    const selectedCount = requireAsyncInteger(convergence.selected, '/convergence/selected', 0, report.scope.maximumMessages);
+    if (convergence.reportDigest !== report.reportDigest ||
+        !['completed', 'failed', 'started'].includes(convergence.status) ||
+        lineage.size !== lineageDigests.length ||
+        completed.size !== completedLineageDigests.length ||
+        completedLineageDigests.some((digest) => !lineage.has(digest)) ||
+        selectedCount !== lineageDigests.length ||
+        acknowledged !== completedLineageDigests.length ||
+        selectedCount > scanned ||
+        failed > scanned) {
+        failAsyncWork('async-report-invalid', '/convergence', 'retained convergence exceeds the report or has inconsistent counters and lineage');
+    }
+    requireAsyncIdentifier(convergence.operationHandle, '/convergence/operationHandle');
+    return Object.assign(Object.assign({}, convergence), { acknowledged,
+        completedLineageDigests,
+        failed,
+        lineageDigests,
+        scanned, selected: selectedCount });
+}
+export function runBoundedRedrive(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const now = requireCanonicalAsyncTimestamp(input.now, '/now');
+        const report = validateReport(input.report, true, now);
+        const reservation = yield input.adapter.reserve({
+            reportDigest: report.reportDigest,
+        });
+        const existingConvergence = reservation.outcome === 'existing'
+            ? validatePriorConvergence(reservation.convergence, report)
+            : undefined;
+        if ((existingConvergence === null || existingConvergence === void 0 ? void 0 : existingConvergence.status) === 'failed') {
+            throw new Error('async-recovery-terminal-failed');
+        }
+        if ((existingConvergence === null || existingConvergence === void 0 ? void 0 : existingConvergence.status) === 'completed') {
+            return Object.assign(Object.assign({}, existingConvergence), { outcome: 'duplicate' });
+        }
+        const previous = existingConvergence;
+        const operationHandle = reservation.outcome === 'existing'
+            ? reservation.convergence.operationHandle
+            : reservation.operationHandle;
+        const lineageDigests = [...((_a = previous === null || previous === void 0 ? void 0 : previous.lineageDigests) !== null && _a !== void 0 ? _a : [])];
+        const completedLineageDigests = [
+            ...((_b = previous === null || previous === void 0 ? void 0 : previous.completedLineageDigests) !== null && _b !== void 0 ? _b : []),
+        ];
+        let acknowledged = (_c = previous === null || previous === void 0 ? void 0 : previous.acknowledged) !== null && _c !== void 0 ? _c : 0;
+        let failed = 0;
+        let scanned = (_d = previous === null || previous === void 0 ? void 0 : previous.scanned) !== null && _d !== void 0 ? _d : 0;
+        let selectedCount = lineageDigests.length;
+        const seen = new Set();
+        const sleep = (_e = input.sleep) !== null && _e !== void 0 ? _e : ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+        const minimumIntervalMilliseconds = Math.ceil(1000 / report.scope.maximumRatePerSecond);
+        let forwarded = 0;
+        const checkpoint = (status) => __awaiter(this, void 0, void 0, function* () {
+            return input.adapter.converge({
+                acknowledged,
+                completedLineageDigests,
+                failed,
+                lineageDigests,
+                operationHandle,
+                reportDigest: report.reportDigest,
+                scanned,
+                selected: selectedCount,
+                status,
+            });
+        });
+        try {
+            while (scanned < report.scope.maximumScannedMessages &&
+                (selectedCount < report.scope.maximumMessages ||
+                    completedLineageDigests.length < lineageDigests.length)) {
+                const limit = Math.min(10, report.scope.maximumScannedMessages - scanned);
+                const items = yield input.adapter.receive(limit);
+                if (items.length === 0)
+                    break;
+                for (const item of items) {
+                    if (scanned >= report.scope.maximumScannedMessages)
+                        break;
+                    scanned += 1;
+                    const messageReference = requireAsyncIdentifier(item.messageReference, '/item/messageReference');
+                    if (seen.has(messageReference))
+                        continue;
+                    seen.add(messageReference);
+                    const lineageDigest = asyncWorkDigest({
+                        kind: 'bounded-redrive-message-v1',
+                        value: messageReference,
+                    });
+                    if (completedLineageDigests.includes(lineageDigest))
+                        continue;
+                    if (!selected(item, report.scope)) {
+                        continue;
+                    }
+                    if (!lineageDigests.includes(lineageDigest)) {
+                        if (selectedCount >= report.scope.maximumMessages)
+                            continue;
+                        selectedCount += 1;
+                        lineageDigests.push(lineageDigest);
+                    }
+                    if (forwarded > 0)
+                        yield sleep(minimumIntervalMilliseconds);
+                    forwarded += 1;
+                    if (!(yield input.adapter.forward(item))) {
+                        failed += 1;
+                        yield checkpoint('started');
+                        continue;
+                    }
+                    if (yield input.adapter.acknowledge(item)) {
+                        acknowledged += 1;
+                        completedLineageDigests.push(lineageDigest);
+                    }
+                    else {
+                        failed += 1;
+                    }
+                    yield checkpoint('started');
+                }
+            }
+            const pendingLineage = lineageDigests.length - completedLineageDigests.length;
+            const convergence = yield checkpoint(failed === 0 && pendingLineage === 0 ? 'completed' : 'started');
+            if (failed > 0) {
+                throw new Error('async-bounded-redrive-retry-required');
+            }
+            if (pendingLineage > 0) {
+                throw new Error('async-bounded-redrive-reconciliation-required');
+            }
+            return Object.assign(Object.assign({}, convergence), { outcome: 'applied' });
+        }
+        catch (error) {
+            yield checkpoint('started');
+            throw error;
+        }
+    });
+}
+export function readBoundedRedriveStatus(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const operationHandle = requireAsyncIdentifier(input.operationHandle, '/operationHandle');
+        requireDigest(input.reportDigest, '/reportDigest');
+        const convergence = yield input.adapter.read(input.reportDigest);
+        if (convergence &&
+            (convergence.reportDigest !== input.reportDigest ||
+                convergence.operationHandle !== operationHandle)) {
+            failAsyncWork('async-report-invalid', '/operationHandle', 'status must belong to the exact report and operation handle');
+        }
+        return convergence;
+    });
+}
+//# sourceMappingURL=recovery.js.map

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

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

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

@@ -0,0 +1,117 @@
+export declare const ASYNC_SCHEDULE_VERSION: 1;
+export declare const ASYNC_BACKFILL_REPORT_VERSION: 1;
+export declare const ASYNC_BACKFILL_CHECKPOINT_VERSION: 1;
+export type MissedRunBehavior = 'backfill-every-interval' | 'catch-up-once' | 'skip';
+export type ScheduleCadenceV1 = {
+    at: string;
+    kind: 'one-time';
+} | {
+    intervalSeconds: number;
+    kind: 'interval';
+};
+export interface ScheduleDefinitionV1 {
+    cadence: ScheduleCadenceV1;
+    dlq: string;
+    enabled: boolean;
+    maximumCatchUpRuns: number;
+    missedRunBehavior: MissedRunBehavior;
+    owner: string;
+    retryAttempts: number;
+    scheduleId: string;
+    targetCommand: string;
+    targetVersion: number;
+    timeZone: string;
+    version: typeof ASYNC_SCHEDULE_VERSION;
+}
+export declare function createScheduleDefinition(input: Omit<ScheduleDefinitionV1, 'version'>): ScheduleDefinitionV1;
+export interface PlannedScheduleRunsV1 {
+    latestMissedAt?: string;
+    outcome: 'caught-up' | 'disabled' | 'none' | 'skipped';
+    runAt: readonly string[];
+    scheduleId: string;
+    skippedCount: number;
+}
+/**
+ * Computes bounded catch-up intent. The generated AWS adapter owns the
+ * Scheduler expression; handlers receive stable scheduled timestamps and
+ * remain idempotent if Scheduler invokes them more than once.
+ */
+export declare function planMissedScheduleRuns(input: {
+    lastCompletedAt?: string;
+    now: string;
+    schedule: ScheduleDefinitionV1;
+}): PlannedScheduleRunsV1;
+export interface BackfillScopeV1 {
+    from: string;
+    partitions: readonly string[];
+    to: string;
+}
+export interface BackfillReportV1 {
+    approvalClass: 'ordinary' | 'protected';
+    concurrency: number;
+    estimatedCostUsd: number;
+    expiresAt: string;
+    job: string;
+    maximumItems: number;
+    preparedAt: string;
+    reportDigest: string;
+    reportId: string;
+    scope: {
+        from: string;
+        partitions: readonly string[];
+        to: string;
+    };
+    version: typeof ASYNC_BACKFILL_REPORT_VERSION;
+}
+export declare function createBackfillReport(input: {
+    approvalClass: 'ordinary' | 'protected';
+    concurrency: number;
+    estimatedCostUsd: number;
+    expiresAt: string;
+    job: string;
+    maximumItems: number;
+    preparedAt: string;
+    scope: BackfillScopeV1;
+}): BackfillReportV1;
+export interface BackfillCheckpointV1 {
+    complete: boolean;
+    cursor?: string;
+    processed: number;
+    reportDigest: string;
+    version: typeof ASYNC_BACKFILL_CHECKPOINT_VERSION;
+}
+export interface BackfillItem<TValue> {
+    itemId: string;
+    value: TValue;
+}
+export interface BackfillAdapter<TValue> {
+    process(input: {
+        idempotencyKey: string;
+        item: BackfillItem<TValue>;
+        reportId: string;
+    }): Promise<'already-applied' | 'failed' | 'succeeded'>;
+    scan(input: {
+        cursor?: string;
+        limit: number;
+        scope: BackfillReportV1['scope'];
+    }): Promise<{
+        items: readonly BackfillItem<TValue>[];
+        nextCursor?: string;
+    }>;
+}
+export declare function runBackfillPage<TValue>(input: {
+    adapter: BackfillAdapter<TValue>;
+    approvalId?: string;
+    cancelled?: boolean;
+    checkpoint?: BackfillCheckpointV1;
+    limit: number;
+    now: string;
+    report: BackfillReportV1;
+}): Promise<{
+    alreadyApplied: number;
+    checkpoint: BackfillCheckpointV1;
+    failed: number;
+    outcome: 'cancelled' | 'complete' | 'more' | 'retry-required';
+    processed: number;
+    succeeded: number;
+}>;