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

package/src/data-lifecycle/restore.js

@@ -0,0 +1,336 @@
+import { __awaiter } from "tslib";
+import { failDataLifecycleRuntime, lifecycleIdempotencyKey, requireBoundedInteger, requireCanonicalTimestamp, requireCursor, requireDataLifecycleId, requirePolicyVersion, requireSafeReference, } from './contract.js';
+export const DATA_LIFECYCLE_LEDGER_ENTRY_VERSION = 1;
+export const DATA_LIFECYCLE_RESTORE_CHECKPOINT_VERSION = 1;
+export const DATA_LIFECYCLE_RESTORE_MAX_ITEMS = 100;
+function ledgerIdentity(input) {
+    return lifecycleIdempotencyKey('restore-ledger-entry-v1', [
+        input.action,
+        input.categoryId,
+        input.pseudonymousKey,
+        input.policyVersion,
+        input.effectiveAt,
+        input.expiresAt,
+    ]);
+}
+/**
+ * The ledger deliberately stores no source record, correction value, subject
+ * profile, or human identifier—only a pseudonymous lookup key and action.
+ */
+export function createDataLifecycleLedgerEntry(options) {
+    if (options.action !== 'correction' && options.action !== 'deletion') {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/action', 'ledger action must be correction or deletion');
+    }
+    const categoryId = requireDataLifecycleId(options.categoryId, '/categoryId');
+    const pseudonymousKey = requireSafeReference(options.pseudonymousKey, '/pseudonymousKey');
+    const policyVersion = requirePolicyVersion(options.policyVersion, '/policyVersion');
+    const effectiveAt = requireCanonicalTimestamp(options.effectiveAt, '/effectiveAt');
+    const expiresAt = requireCanonicalTimestamp(options.expiresAt, '/expiresAt');
+    if (Date.parse(expiresAt) <= Date.parse(effectiveAt)) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/expiresAt', 'ledger expiry must follow the lifecycle action');
+    }
+    const identity = {
+        action: options.action,
+        categoryId,
+        effectiveAt,
+        expiresAt,
+        policyVersion,
+        pseudonymousKey,
+    };
+    return Object.assign(Object.assign({}, identity), { entryId: ledgerIdentity(identity), version: DATA_LIFECYCLE_LEDGER_ENTRY_VERSION });
+}
+function normalizeLedgerEntry(value, index, now) {
+    const pointer = `/page/entries/${index}`;
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', pointer, 'ledger entry must be an object');
+    }
+    if (value.version !== DATA_LIFECYCLE_LEDGER_ENTRY_VERSION) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', `${pointer}/version`, 'must be a v1 ledger entry');
+    }
+    const entry = createDataLifecycleLedgerEntry({
+        action: value.action,
+        categoryId: value.categoryId,
+        effectiveAt: value.effectiveAt,
+        expiresAt: value.expiresAt,
+        policyVersion: value.policyVersion,
+        pseudonymousKey: value.pseudonymousKey,
+    });
+    if (requireSafeReference(value.entryId, `${pointer}/entryId`) !== entry.entryId) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', `${pointer}/entryId`, 'does not bind the exact ledger action metadata');
+    }
+    if (Date.parse(entry.effectiveAt) > Date.parse(now)) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', `${pointer}/effectiveAt`, 'future lifecycle actions cannot be replayed');
+    }
+    if (Date.parse(entry.expiresAt) <= Date.parse(now)) {
+        failDataLifecycleRuntime('data-lifecycle-restore-reconciliation-failed', `${pointer}/expiresAt`, 'expired ledger action cannot authorize restored service cutover');
+    }
+    return entry;
+}
+export function createDataLifecycleRestoreCheckpoint(policyVersion) {
+    return {
+        complete: false,
+        policyVersion: requirePolicyVersion(policyVersion, '/policyVersion'),
+        version: DATA_LIFECYCLE_RESTORE_CHECKPOINT_VERSION,
+    };
+}
+function normalizeCheckpoint(value, policyVersion) {
+    if (!value)
+        return createDataLifecycleRestoreCheckpoint(policyVersion);
+    if (value.version !== DATA_LIFECYCLE_RESTORE_CHECKPOINT_VERSION ||
+        typeof value.complete !== 'boolean' ||
+        requirePolicyVersion(value.policyVersion, '/checkpoint/policyVersion') !==
+            policyVersion) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/checkpoint', 'must be a v1 restore checkpoint for the exact policy version');
+    }
+    const checkpoint = {
+        complete: value.complete,
+        policyVersion,
+        version: DATA_LIFECYCLE_RESTORE_CHECKPOINT_VERSION,
+    };
+    if (value.cursor !== undefined) {
+        checkpoint.cursor = requireCursor(value.cursor, '/checkpoint/cursor');
+    }
+    if (checkpoint.complete && checkpoint.cursor !== undefined) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/checkpoint', 'complete restore checkpoint cannot retain a cursor');
+    }
+    return checkpoint;
+}
+function requireRestoreControls(value) {
+    const fields = [
+        'authorizationVerified',
+        'integrityVerified',
+        'isolatedTarget',
+        'retentionJobsReady',
+        'serviceTrafficBlocked',
+    ];
+    for (const field of fields) {
+        if ((value === null || value === void 0 ? void 0 : value[field]) !== true) {
+            failDataLifecycleRuntime('data-lifecycle-restore-controls-incomplete', `/controls/${field}`, 'must be proven before ledger replay');
+        }
+    }
+    return {
+        authorizationVerified: true,
+        integrityVerified: true,
+        isolatedTarget: true,
+        retentionJobsReady: true,
+        serviceTrafficBlocked: true,
+    };
+}
+function validatePage(value, options) {
+    if (!value || typeof value !== 'object' || !Array.isArray(value.entries)) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/page', 'ledger adapter must return an entry page');
+    }
+    if (value.entries.length > options.limit) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/page/entries', 'ledger adapter exceeded the requested page bound');
+    }
+    const entries = value.entries.map((entry, index) => normalizeLedgerEntry(entry, index, options.now));
+    const ids = new Set();
+    entries.forEach((entry, index) => {
+        if (ids.has(entry.entryId)) {
+            failDataLifecycleRuntime('data-lifecycle-input-invalid', `/page/entries/${index}/entryId`, 'ledger page contains a duplicate entry');
+        }
+        ids.add(entry.entryId);
+    });
+    const page = {
+        entries,
+    };
+    if (value.nextCursor !== undefined) {
+        page.nextCursor = requireCursor(value.nextCursor, '/page/nextCursor');
+        if (page.nextCursor === options.currentCursor ||
+            page.entries.length === 0) {
+            failDataLifecycleRuntime('data-lifecycle-input-invalid', '/page/nextCursor', 'must advance a non-empty ledger page');
+        }
+    }
+    return page;
+}
+function baseResult(options) {
+    return {
+        alreadyApplied: 0,
+        applied: 0,
+        checkpoint: options.checkpoint,
+        downstreamAlreadyReconciled: 0,
+        downstreamReconciled: 0,
+        notPresent: 0,
+        policyVersion: options.policyVersion,
+        processed: 0,
+        readyForCutover: options.checkpoint.complete,
+        status: options.checkpoint.complete ? 'complete' : 'more',
+        targetRef: options.targetRef,
+    };
+}
+/**
+ * Replays one bounded ledger page while traffic remains blocked. A failed
+ * primary/downstream page keeps its incoming checkpoint, so stable
+ * idempotency keys safely repeat all earlier actions on retry.
+ */
+export function runDataLifecycleRestoreReconciliation(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        requireRestoreControls(options.controls);
+        const now = requireCanonicalTimestamp(options.now, '/now');
+        const policyVersion = requirePolicyVersion(options.policyVersion, '/policyVersion');
+        const targetRef = requireSafeReference(options.targetRef, '/targetRef');
+        const limit = requireBoundedInteger(options.limit, '/limit', 1, DATA_LIFECYCLE_RESTORE_MAX_ITEMS);
+        const checkpoint = normalizeCheckpoint(options.checkpoint, policyVersion);
+        if (checkpoint.complete) {
+            return baseResult({ checkpoint, policyVersion, targetRef });
+        }
+        let rawPage;
+        try {
+            rawPage = yield options.adapter.scanLedger({
+                cursor: checkpoint.cursor,
+                limit,
+                now,
+                policyVersion,
+            });
+        }
+        catch (_a) {
+            return Object.assign(Object.assign({}, baseResult({ checkpoint, policyVersion, targetRef })), { errorCode: 'ledger-scan-failed', status: 'retry-required' });
+        }
+        const page = validatePage(rawPage, {
+            currentCursor: checkpoint.cursor,
+            limit,
+            now,
+        });
+        let applied = 0;
+        let alreadyApplied = 0;
+        let notPresent = 0;
+        let downstreamReconciled = 0;
+        let downstreamAlreadyReconciled = 0;
+        let processed = 0;
+        for (const entry of page.entries) {
+            const primaryKey = lifecycleIdempotencyKey('restore-primary-v1', [
+                policyVersion,
+                targetRef,
+                entry.entryId,
+            ]);
+            let primaryOutcome;
+            try {
+                primaryOutcome = yield options.adapter.applyPrimary({
+                    entry,
+                    idempotencyKey: primaryKey,
+                    targetRef,
+                });
+            }
+            catch (_b) {
+                return {
+                    alreadyApplied,
+                    applied,
+                    checkpoint,
+                    downstreamAlreadyReconciled,
+                    downstreamReconciled,
+                    errorCode: 'primary-reconciliation-failed',
+                    notPresent,
+                    policyVersion,
+                    processed,
+                    readyForCutover: false,
+                    status: 'retry-required',
+                    targetRef,
+                };
+            }
+            if (primaryOutcome === 'applied')
+                applied += 1;
+            else if (primaryOutcome === 'already-applied')
+                alreadyApplied += 1;
+            else if (primaryOutcome === 'not-present')
+                notPresent += 1;
+            else {
+                return {
+                    alreadyApplied,
+                    applied,
+                    checkpoint,
+                    downstreamAlreadyReconciled,
+                    downstreamReconciled,
+                    errorCode: 'invalid-adapter-outcome',
+                    notPresent,
+                    policyVersion,
+                    processed,
+                    readyForCutover: false,
+                    status: 'retry-required',
+                    targetRef,
+                };
+            }
+            let downstreamOutcome;
+            try {
+                downstreamOutcome = yield options.adapter.reconcileDownstream({
+                    entry,
+                    idempotencyKey: lifecycleIdempotencyKey('restore-downstream-v1', [
+                        policyVersion,
+                        entry.entryId,
+                    ]),
+                });
+            }
+            catch (_c) {
+                return {
+                    alreadyApplied,
+                    applied,
+                    checkpoint,
+                    downstreamAlreadyReconciled,
+                    downstreamReconciled,
+                    errorCode: 'downstream-reconciliation-failed',
+                    notPresent,
+                    policyVersion,
+                    processed,
+                    readyForCutover: false,
+                    status: 'retry-required',
+                    targetRef,
+                };
+            }
+            if (downstreamOutcome === 'reconciled')
+                downstreamReconciled += 1;
+            else if (downstreamOutcome === 'already-reconciled') {
+                downstreamAlreadyReconciled += 1;
+            }
+            else {
+                return {
+                    alreadyApplied,
+                    applied,
+                    checkpoint,
+                    downstreamAlreadyReconciled,
+                    downstreamReconciled,
+                    errorCode: 'invalid-adapter-outcome',
+                    notPresent,
+                    policyVersion,
+                    processed,
+                    readyForCutover: false,
+                    status: 'retry-required',
+                    targetRef,
+                };
+            }
+            processed += 1;
+        }
+        const nextCheckpoint = page.nextCursor
+            ? {
+                complete: false,
+                cursor: page.nextCursor,
+                policyVersion,
+                version: DATA_LIFECYCLE_RESTORE_CHECKPOINT_VERSION,
+            }
+            : {
+                complete: true,
+                policyVersion,
+                version: DATA_LIFECYCLE_RESTORE_CHECKPOINT_VERSION,
+            };
+        return {
+            alreadyApplied,
+            applied,
+            checkpoint: nextCheckpoint,
+            downstreamAlreadyReconciled,
+            downstreamReconciled,
+            notPresent,
+            policyVersion,
+            processed,
+            readyForCutover: nextCheckpoint.complete,
+            status: page.nextCursor ? 'more' : 'complete',
+            targetRef,
+        };
+    });
+}
+export function requireDataLifecycleRestoreCutover(result) {
+    if (result.status !== 'complete' ||
+        !result.readyForCutover ||
+        !result.checkpoint.complete) {
+        failDataLifecycleRuntime('data-lifecycle-restore-controls-incomplete', '/restoreResult', 'service cannot resume before all restore reconciliation completes');
+    }
+    return result;
+}
+//# sourceMappingURL=restore.js.map

package/src/data-lifecycle/restore.js.map

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

package/src/data-lifecycle/retention.d.ts

@@ -0,0 +1,57 @@
+export declare const DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION: 1;
+export declare const DATA_LIFECYCLE_RETENTION_MAX_ITEMS = 100;
+export type DataLifecycleRetentionMode = 'report' | 'apply';
+export interface DataLifecycleRetentionCandidateV1 {
+    categoryId: string;
+    dueAt: string;
+    locationId: string;
+    recordRef: string;
+}
+export interface DataLifecycleRetentionPageV1 {
+    items: readonly DataLifecycleRetentionCandidateV1[];
+    nextCursor?: string;
+}
+export interface DataLifecycleRetentionCheckpointV1 {
+    complete: boolean;
+    cursor?: string;
+    policyVersion: string;
+    version: typeof DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION;
+}
+export interface DataLifecycleRetentionAdapter {
+    apply(input: {
+        candidate: DataLifecycleRetentionCandidateV1;
+        idempotencyKey: string;
+    }): Promise<'applied' | 'already-applied'>;
+    scan(input: {
+        asOf: string;
+        cursor?: string;
+        limit: number;
+        policyVersion: string;
+    }): Promise<DataLifecycleRetentionPageV1>;
+}
+export interface DataLifecycleRetentionRunResultV1 {
+    alreadyApplied: number;
+    applied: number;
+    asOf: string;
+    attemptedLocationIds: readonly string[];
+    checkpoint: DataLifecycleRetentionCheckpointV1;
+    due: number;
+    errorCode?: 'adapter-failure' | 'invalid-adapter-outcome';
+    mode: DataLifecycleRetentionMode;
+    policyVersion: string;
+    scanned: number;
+    status: 'complete' | 'more' | 'retry-required';
+}
+export declare function createDataLifecycleRetentionCheckpoint(policyVersion: string): DataLifecycleRetentionCheckpointV1;
+/**
+ * Runs one bounded page. Failed apply pages retain their incoming checkpoint;
+ * retrying repeats stable idempotency keys and cannot skip the failed item.
+ */
+export declare function runDataLifecycleRetention(options: {
+    adapter: DataLifecycleRetentionAdapter;
+    asOf: string;
+    checkpoint?: DataLifecycleRetentionCheckpointV1;
+    limit: number;
+    mode: DataLifecycleRetentionMode;
+    policyVersion: string;
+}): Promise<DataLifecycleRetentionRunResultV1>;

package/src/data-lifecycle/retention.js

@@ -0,0 +1,232 @@
+import { __awaiter } from "tslib";
+import { DataLifecycleRuntimeError, failDataLifecycleRuntime, lifecycleIdempotencyKey, requireBoundedInteger, requireCanonicalTimestamp, requireCursor, requireDataLifecycleId, requirePolicyVersion, requireSafeReference, } from './contract.js';
+export const DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION = 1;
+export const DATA_LIFECYCLE_RETENTION_MAX_ITEMS = 100;
+export function createDataLifecycleRetentionCheckpoint(policyVersion) {
+    return {
+        complete: false,
+        policyVersion: requirePolicyVersion(policyVersion, '/policyVersion'),
+        version: DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION,
+    };
+}
+function normalizeCheckpoint(value, policyVersion) {
+    if (!value)
+        return createDataLifecycleRetentionCheckpoint(policyVersion);
+    if (value.version !== DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION ||
+        typeof value.complete !== 'boolean' ||
+        requirePolicyVersion(value.policyVersion, '/checkpoint/policyVersion') !==
+            policyVersion) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/checkpoint', 'must be a v1 checkpoint for the exact policy version');
+    }
+    const checkpoint = {
+        complete: value.complete,
+        policyVersion,
+        version: DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION,
+    };
+    if (value.cursor !== undefined) {
+        checkpoint.cursor = requireCursor(value.cursor, '/checkpoint/cursor');
+    }
+    if (checkpoint.complete && checkpoint.cursor !== undefined) {
+        failDataLifecycleRuntime('data-lifecycle-input-invalid', '/checkpoint', 'a complete checkpoint cannot retain a cursor');
+    }
+    return checkpoint;
+}
+function normalizeCandidate(value, index, asOf) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        failDataLifecycleRuntime('data-lifecycle-retention-page-invalid', `/page/items/${index}`, 'retention candidate must be an object');
+    }
+    const candidate = {
+        categoryId: requireDataLifecycleId(value.categoryId, `/page/items/${index}/categoryId`),
+        dueAt: requireCanonicalTimestamp(value.dueAt, `/page/items/${index}/dueAt`),
+        locationId: requireDataLifecycleId(value.locationId, `/page/items/${index}/locationId`),
+        recordRef: requireSafeReference(value.recordRef, `/page/items/${index}/recordRef`),
+    };
+    if (Date.parse(candidate.dueAt) > Date.parse(asOf)) {
+        failDataLifecycleRuntime('data-lifecycle-retention-page-invalid', `/page/items/${index}/dueAt`, 'retention adapters may return only records due as of the requested time');
+    }
+    return candidate;
+}
+function validatePage(value, options) {
+    if (!value || typeof value !== 'object' || !Array.isArray(value.items)) {
+        failDataLifecycleRuntime('data-lifecycle-retention-page-invalid', '/page', 'retention adapter must return an item page');
+    }
+    if (value.items.length > options.limit) {
+        failDataLifecycleRuntime('data-lifecycle-retention-page-invalid', '/page/items', 'adapter exceeded the requested page bound');
+    }
+    const items = value.items.map((item, index) => normalizeCandidate(item, index, options.asOf));
+    const seen = new Set();
+    for (const [index, item] of items.entries()) {
+        const identity = `${item.locationId}\0${item.recordRef}`;
+        if (seen.has(identity)) {
+            failDataLifecycleRuntime('data-lifecycle-retention-page-invalid', `/page/items/${index}`, 'page contains a duplicate retention candidate');
+        }
+        seen.add(identity);
+    }
+    const page = { items };
+    if (value.nextCursor !== undefined) {
+        page.nextCursor = requireCursor(value.nextCursor, '/page/nextCursor');
+        if (page.nextCursor === options.currentCursor || page.items.length === 0) {
+            failDataLifecycleRuntime('data-lifecycle-retention-page-invalid', '/page/nextCursor', 'must advance a non-empty page');
+        }
+    }
+    return page;
+}
+function resultForCompleteCheckpoint(options) {
+    return {
+        alreadyApplied: 0,
+        applied: 0,
+        asOf: options.asOf,
+        attemptedLocationIds: [],
+        checkpoint: options.checkpoint,
+        due: 0,
+        mode: options.mode,
+        policyVersion: options.policyVersion,
+        scanned: 0,
+        status: 'complete',
+    };
+}
+/**
+ * Runs one bounded page. Failed apply pages retain their incoming checkpoint;
+ * retrying repeats stable idempotency keys and cannot skip the failed item.
+ */
+export function runDataLifecycleRetention(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const asOf = requireCanonicalTimestamp(options.asOf, '/asOf');
+        const policyVersion = requirePolicyVersion(options.policyVersion, '/policyVersion');
+        const limit = requireBoundedInteger(options.limit, '/limit', 1, DATA_LIFECYCLE_RETENTION_MAX_ITEMS);
+        if (options.mode !== 'report' && options.mode !== 'apply') {
+            failDataLifecycleRuntime('data-lifecycle-input-invalid', '/mode', 'must be report or apply');
+        }
+        const checkpoint = normalizeCheckpoint(options.checkpoint, policyVersion);
+        if (checkpoint.complete) {
+            return resultForCompleteCheckpoint({
+                asOf,
+                checkpoint,
+                mode: options.mode,
+                policyVersion,
+            });
+        }
+        let rawPage;
+        try {
+            rawPage = yield options.adapter.scan({
+                asOf,
+                cursor: checkpoint.cursor,
+                limit,
+                policyVersion,
+            });
+        }
+        catch (_a) {
+            throw new DataLifecycleRuntimeError('data-lifecycle-retention-scan-failed', '/adapter/scan', 'retention scan failed without exposing adapter output');
+        }
+        const page = validatePage(rawPage, {
+            asOf,
+            currentCursor: checkpoint.cursor,
+            limit,
+        });
+        const attemptedLocationIds = [
+            ...new Set(page.items.map(({ locationId }) => locationId)),
+        ].sort();
+        if (options.mode === 'report') {
+            return {
+                alreadyApplied: 0,
+                applied: 0,
+                asOf,
+                attemptedLocationIds,
+                checkpoint: page.nextCursor
+                    ? {
+                        complete: false,
+                        cursor: page.nextCursor,
+                        policyVersion,
+                        version: DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION,
+                    }
+                    : {
+                        complete: true,
+                        policyVersion,
+                        version: DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION,
+                    },
+                due: page.items.length,
+                mode: options.mode,
+                policyVersion,
+                scanned: page.items.length,
+                status: page.nextCursor ? 'more' : 'complete',
+            };
+        }
+        let applied = 0;
+        let alreadyApplied = 0;
+        for (const candidate of page.items) {
+            let outcome;
+            try {
+                outcome = yield options.adapter.apply({
+                    candidate,
+                    idempotencyKey: lifecycleIdempotencyKey('retention-v1', [
+                        policyVersion,
+                        candidate.categoryId,
+                        candidate.locationId,
+                        candidate.recordRef,
+                        candidate.dueAt,
+                    ]),
+                });
+            }
+            catch (_b) {
+                return {
+                    alreadyApplied,
+                    applied,
+                    asOf,
+                    attemptedLocationIds,
+                    checkpoint,
+                    due: page.items.length,
+                    errorCode: 'adapter-failure',
+                    mode: options.mode,
+                    policyVersion,
+                    scanned: page.items.length,
+                    status: 'retry-required',
+                };
+            }
+            if (outcome === 'applied') {
+                applied += 1;
+            }
+            else if (outcome === 'already-applied') {
+                alreadyApplied += 1;
+            }
+            else {
+                return {
+                    alreadyApplied,
+                    applied,
+                    asOf,
+                    attemptedLocationIds,
+                    checkpoint,
+                    due: page.items.length,
+                    errorCode: 'invalid-adapter-outcome',
+                    mode: options.mode,
+                    policyVersion,
+                    scanned: page.items.length,
+                    status: 'retry-required',
+                };
+            }
+        }
+        return {
+            alreadyApplied,
+            applied,
+            asOf,
+            attemptedLocationIds,
+            checkpoint: page.nextCursor
+                ? {
+                    complete: false,
+                    cursor: page.nextCursor,
+                    policyVersion,
+                    version: DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION,
+                }
+                : {
+                    complete: true,
+                    policyVersion,
+                    version: DATA_LIFECYCLE_RETENTION_CHECKPOINT_VERSION,
+                },
+            due: page.items.length,
+            mode: options.mode,
+            policyVersion,
+            scanned: page.items.length,
+            status: page.nextCursor ? 'more' : 'complete',
+        };
+    });
+}
+//# sourceMappingURL=retention.js.map

package/src/data-lifecycle/retention.js.map

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