@neottia/repository-store 0.2.0

package/dist/transaction/apply.d.ts

@@ -0,0 +1,8 @@
+import type { ApplyCanonicalBatchOptions, CanonicalOperation } from './types.js';
+import { type ManagedRoot, type RepositoryLease } from '../internal/model.js';
+import { type ExpectedRegularFile } from '../internal/publication.js';
+export declare function applyCanonicalBatch(root: ManagedRoot, lease: RepositoryLease, operations: readonly CanonicalOperation[], options?: ApplyCanonicalBatchOptions): Promise<{
+    transactionId: string;
+}>;
+export declare function publishTransition(path: string, bytes: Uint8Array | null, token: string, expected?: ExpectedRegularFile): void;
+//# sourceMappingURL=apply.d.ts.map

package/dist/transaction/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/transaction/apply.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAiC,MAAM,YAAY,CAAC;AAGhH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAY/F,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CA+HpC;AAyJD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAAG,IAAI,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,IAAI,CAEN"}

package/dist/transaction/apply.js

@@ -0,0 +1,273 @@
+import { randomBytes } from 'node:crypto';
+import { lstatSync, readdirSync, renameSync, rmSync, rmdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { PathSafetyError, RecoveryError, ResourceLimitError, StaleRevisionError } from '../errors.js';
+import { assertPathAuthority, readManagedFileIfExists } from '../files.js';
+import { cleanupJournal, createTransactionDirectory, manifestDigest, transactionRoot, writeDurableFile, } from './journal.js';
+import { recoverActiveDirectory } from './recovery.js';
+import { emitTransactionFault } from '../internal/fault-injection.js';
+import { assertSafeRegular, hasCode, syncDirectory } from '../internal/filesystem.js';
+import { requirePathState, requireRootState, } from '../internal/model.js';
+import { publishExactRegularFile } from '../internal/publication.js';
+import { assertLiveLease, checkControl } from '../lease.js';
+import { compareCanonicalPaths, portablePathKey } from '../paths.js';
+import { computeByteRevision } from '../revision.js';
+export async function applyCanonicalBatch(root, lease, operations, options = {}) {
+    assertLiveLease(root, lease);
+    checkControl(options);
+    const ownedOperations = snapshotOperations(operations);
+    const state = requireRootState(root);
+    if (ownedOperations.length === 0)
+        return { transactionId: randomBytes(32).toString('hex') };
+    if (ownedOperations.length > state.limits.maxBatchPaths)
+        throw new ResourceLimitError('Canonical batch exceeds maxBatchPaths.');
+    const transitions = await normalizeOperations(root, lease, ownedOperations, options);
+    if (transitions.length > state.limits.maxBatchPaths)
+        throw new ResourceLimitError('Canonical batch exceeds maxBatchPaths after move normalization.');
+    await validateProposedInventory(root, transitions, options.inventory);
+    const transactionId = randomBytes(32).toString('hex');
+    const transactions = transactionRoot(state.authorityRoot, state.managedRootId);
+    const prepare = join(transactions, `${transactionId}.prepare`);
+    const active = join(transactions, `${transactionId}.active`);
+    const committed = join(transactions, `${transactionId}.committed`);
+    createTransactionDirectory(prepare);
+    syncDirectory(transactions);
+    emitTransactionFault('prepare-directory-created');
+    let stateDirectory = prepare;
+    try {
+        const entries = [];
+        let beforeBytes = 0;
+        let temporaryBytes = 0;
+        for (const [index, transition] of transitions.entries()) {
+            checkControl(options);
+            const beforeArtifact = transition.original === null ? null : `${index}-${transactionId}.before`;
+            const stagedArtifact = transition.intended === null ? null : `${index}-${transactionId}.stage`;
+            if (transition.original !== null) {
+                beforeBytes += transition.original.byteLength;
+                if (beforeBytes > state.limits.maxBeforeImageBytes)
+                    throw new ResourceLimitError('Canonical batch exceeds maxBeforeImageBytes.');
+                writeDurableFile(join(prepare, beforeArtifact), transition.original);
+                emitTransactionFault('before-image-written');
+            }
+            if (transition.intended !== null) {
+                temporaryBytes += transition.intended.byteLength;
+                if (temporaryBytes > state.limits.maxTemporaryBytes)
+                    throw new ResourceLimitError('Canonical batch exceeds maxTemporaryBytes.');
+                writeDurableFile(join(prepare, stagedArtifact), transition.intended);
+                emitTransactionFault('staged-artifact-written');
+            }
+            entries.push({
+                path: transition.path.relativePath,
+                originalRevision: transition.original === null ? null : computeByteRevision(transition.original),
+                intendedRevision: transition.intended === null ? null : computeByteRevision(transition.intended),
+                beforeArtifact,
+                stagedArtifact,
+                bytes: transition.intended?.byteLength ?? 0,
+            });
+        }
+        const unsigned = {
+            version: 1,
+            transactionId,
+            authorityId: state.authorityId,
+            managedRootId: state.managedRootId,
+            entries,
+            createdAt: new Date().toISOString(),
+        };
+        const manifest = { ...unsigned, digest: manifestDigest(unsigned) };
+        const manifestBytes = Buffer.from(`${JSON.stringify(manifest)}\n`);
+        if (manifestBytes.byteLength > state.limits.maxJournalBytes)
+            throw new ResourceLimitError('Canonical transaction manifest exceeds maxJournalBytes.');
+        writeDurableFile(join(prepare, 'manifest.json'), manifestBytes);
+        emitTransactionFault('manifest-written');
+        syncDirectory(prepare);
+        emitTransactionFault('prepare-directory-synced');
+        renameSync(prepare, active);
+        stateDirectory = active;
+        emitTransactionFault('active-state-renamed');
+        syncDirectory(transactions);
+        emitTransactionFault('active-state-synced');
+        for (const transition of transitions) {
+            checkControl(options);
+            const expected = await verifyCurrent(root, lease, transition.path, transition.original, options);
+            publishTransition(requirePathState(transition.path).absolutePath, transition.intended, transactionId, expected);
+            emitTransactionFault('canonical-path-published');
+        }
+        for (const transition of transitions)
+            await verifyCurrent(root, lease, transition.path, transition.intended, options, true);
+        renameSync(active, committed);
+        stateDirectory = committed;
+        emitTransactionFault('committed-state-renamed');
+        syncDirectory(transactions);
+        emitTransactionFault('committed-state-synced');
+        try {
+            const cleanup = join(transactions, `${transactionId}.cleanup`);
+            renameSync(committed, cleanup);
+            emitTransactionFault('cleanup-state-renamed');
+            syncDirectory(transactions);
+            emitTransactionFault('cleanup-state-synced');
+            cleanupJournal(cleanup, manifest);
+        }
+        catch {
+        }
+        return { transactionId };
+    }
+    catch (error) {
+        if (stateDirectory === active) {
+            try {
+                await recoverActiveDirectory(root, lease, active, {});
+            }
+            catch (rollbackError) {
+                throw new RecoveryError('Canonical publication failed and durable rollback could not complete.', 'RECOVERY_AMBIGUOUS', { transactionId }, { cause: rollbackError });
+            }
+        }
+        else if (stateDirectory === prepare) {
+            try {
+                removePreparationArtifacts(prepare, transactionId);
+            }
+            catch {
+            }
+        }
+        throw error;
+    }
+}
+function snapshotOperations(operations) {
+    return operations.map((operation) => operation.kind === 'write' ? { ...operation, bytes: Uint8Array.from(operation.bytes) } : operation);
+}
+async function normalizeOperations(root, lease, operations, options) {
+    const transitions = new Map();
+    const add = (transition) => {
+        assertPathAuthority(root, transition.path);
+        const key = portablePathKey(transition.path.relativePath);
+        if (transitions.has(key))
+            throw new PathSafetyError('Canonical batch contains duplicate/colliding paths.', 'PATH_COLLISION');
+        transitions.set(key, transition);
+    };
+    for (const operation of operations) {
+        checkControl(options);
+        if (operation.kind === 'write') {
+            const current = await readManagedFileIfExists(root, lease, operation.path, options);
+            assertExpected(operation.path, current?.revision, operation.expected);
+            if (operation.bytes.byteLength > requireRootState(root).limits.maxFileBytes)
+                throw new ResourceLimitError(`Canonical file exceeds maxFileBytes: ${operation.path.relativePath}`);
+            add({ path: operation.path, original: current?.bytes ?? null, intended: operation.bytes });
+        }
+        else if (operation.kind === 'remove') {
+            const current = await readManagedFileIfExists(root, lease, operation.path, options);
+            assertExpected(operation.path, current?.revision, operation.expected);
+            add({ path: operation.path, original: current?.bytes ?? null, intended: null });
+        }
+        else {
+            if (operation.from.relativePath === operation.to.relativePath)
+                throw new PathSafetyError('Canonical move source and destination must differ.');
+            const source = await readManagedFileIfExists(root, lease, operation.from, options);
+            const destination = await readManagedFileIfExists(root, lease, operation.to, options);
+            assertExpected(operation.from, source?.revision, operation.expectedSource);
+            assertExpected(operation.to, destination?.revision, operation.expectedDestination);
+            add({ path: operation.from, original: source?.bytes ?? null, intended: null });
+            add({ path: operation.to, original: destination?.bytes ?? null, intended: source?.bytes ?? null });
+        }
+    }
+    return [...transitions.values()].sort((left, right) => compareCanonicalPaths(left.path.relativePath, right.path.relativePath));
+}
+function assertExpected(path, actual, expected) {
+    if ((expected === 'absent' && actual === undefined) || expected === actual)
+        return;
+    throw new StaleRevisionError(`Canonical revision mismatch: ${path.relativePath}`, { expected, actual });
+}
+async function validateProposedInventory(root, transitions, inventoryRoots) {
+    const state = requireRootState(root);
+    const inventory = new Map();
+    if (inventoryRoots === undefined) {
+        inventoryWalk(state.managedRoot, state.managedRoot, inventory, state.authorityRoot === state.managedRoot);
+    }
+    else {
+        for (const inventoryRoot of inventoryRoots) {
+            assertPathAuthority(root, inventoryRoot);
+            inventoryWalk(requirePathState(inventoryRoot).absolutePath, state.managedRoot, inventory, false);
+        }
+    }
+    for (const transition of transitions) {
+        const key = portablePathKey(transition.path.relativePath);
+        const existing = inventory.get(key);
+        if (existing !== undefined && existing.path !== transition.path.relativePath)
+            throw new PathSafetyError(`Portable catalog collision: ${existing.path} and ${transition.path.relativePath}`, 'PATH_COLLISION');
+        inventory.delete(key);
+        if (transition.intended !== null)
+            inventory.set(key, { path: transition.path.relativePath, bytes: transition.intended.byteLength });
+    }
+    const values = [...inventory.values()];
+    const paths = new Set();
+    for (const item of values) {
+        const key = portablePathKey(item.path);
+        if (paths.has(key))
+            throw new PathSafetyError(`Portable catalog collision: ${item.path}`, 'PATH_COLLISION');
+        paths.add(key);
+    }
+    if (values.length > state.limits.maxFiles)
+        throw new ResourceLimitError('Resulting canonical file count exceeds limit.');
+    if (values.reduce((sum, item) => sum + item.bytes, 0) > state.limits.maxTotalBytes)
+        throw new ResourceLimitError('Resulting canonical byte count exceeds limit.');
+}
+function inventoryWalk(absolute, root, output, skipControl) {
+    let entries;
+    try {
+        entries = readdirSync(absolute, { withFileTypes: true });
+    }
+    catch (error) {
+        if (hasCode(error, 'ENOENT'))
+            return;
+        throw error;
+    }
+    for (const entry of entries) {
+        const path = join(absolute, entry.name);
+        const relativePath = relative(root, path).split('\\').join('/');
+        if (skipControl && relativePath === '.neottia/repository-store')
+            continue;
+        const stat = lstatSync(path);
+        if (stat.isSymbolicLink())
+            throw new PathSafetyError(`Symbolic link in managed catalog: ${path}`, 'UNSAFE_LINK');
+        if (stat.isDirectory()) {
+            inventoryWalk(path, root, output, skipControl);
+            continue;
+        }
+        assertSafeRegular(stat, path);
+        const key = portablePathKey(relativePath);
+        const previous = output.get(key);
+        if (previous !== undefined && previous.path !== relativePath)
+            throw new PathSafetyError(`Portable catalog collision: ${previous.path} and ${relativePath}`, 'PATH_COLLISION');
+        output.set(key, { path: relativePath, bytes: stat.size });
+    }
+}
+async function verifyCurrent(root, lease, path, expected, options, recoveryVerification = false) {
+    const current = await readManagedFileIfExists(root, lease, path, options);
+    const actualRevision = current?.revision;
+    const expectedRevision = expected === null ? undefined : computeByteRevision(expected);
+    if (actualRevision !== expectedRevision) {
+        if (recoveryVerification)
+            throw new RecoveryError('Published canonical revision does not match intended bytes.', 'RECOVERY_AMBIGUOUS', {
+                path: path.relativePath,
+            });
+        throw new StaleRevisionError(`Canonical path changed during publication: ${path.relativePath}`);
+    }
+    if (current === undefined)
+        return undefined;
+    const absolute = requirePathState(path).absolutePath;
+    const identity = lstatSync(absolute);
+    assertSafeRegular(identity, absolute);
+    return { identity, revision: current.revision, maxBytes: requireRootState(root).limits.maxFileBytes };
+}
+export function publishTransition(path, bytes, token, expected) {
+    publishExactRegularFile(path, bytes, expected, token);
+}
+function removePreparationArtifacts(directory, token) {
+    const entries = readdirSync(directory);
+    for (const entry of entries) {
+        if (entry !== 'manifest.json' && !new RegExp(`^[0-9]+-${token}\\.(?:before|stage)$`, 'u').test(entry))
+            return;
+        assertSafeRegular(lstatSync(join(directory, entry)), join(directory, entry));
+    }
+    for (const entry of entries)
+        rmSync(join(directory, entry));
+    rmdirSync(directory);
+}
+//# sourceMappingURL=apply.js.map

package/dist/transaction/apply.js.map

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

package/dist/transaction/journal.d.ts

@@ -0,0 +1,17 @@
+import type { JournalManifest } from './types.js';
+export declare function transactionRoot(authorityRoot: string, managedRootId: string): string;
+export declare function writeDurableFile(path: string, bytes: Uint8Array): void;
+export declare function manifestDigest(manifest: Omit<JournalManifest, 'digest'>): string;
+export declare function readManifest(directory: string, maxJournalBytes: number): JournalManifest;
+export declare function cleanupJournal(directory: string, manifest: JournalManifest): void;
+export declare function cleanupIncompleteJournal(directory: string, transactionId: string, limits: {
+    readonly maxJournalBytes: number;
+    readonly maxArtifactBytes: number;
+}): void;
+export declare function validateArtifacts(directory: string, manifest: JournalManifest, limits: {
+    readonly maxBeforeImageBytes: number;
+    readonly maxTemporaryBytes: number;
+}): void;
+export declare function readArtifact(directory: string, name: string, maxBytes: number): Uint8Array;
+export declare function createTransactionDirectory(path: string): void;
+//# sourceMappingURL=journal.d.ts.map

package/dist/transaction/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/transaction/journal.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,YAAY,CAAC;AAGhE,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKpF;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAStE;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEhF;AAGD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,eAAe,CAkBxF;AAGD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CA2BjF;AAGD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC9E,IAAI,CAuBN;AAGD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE;IAAE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACnF,IAAI,CAqBN;AAGD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAI1F;AAGD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7D"}

package/dist/transaction/journal.js

@@ -0,0 +1,207 @@
+import { createHash } from 'node:crypto';
+import { closeSync, constants as fsConstants, lstatSync, mkdirSync, openSync, readdirSync, rmSync, rmdirSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { RecoveryError, ResourceLimitError } from '../errors.js';
+import { emitTransactionFault } from '../internal/fault-injection.js';
+import { assertSafeRegular, ensurePrivateDirectory, readRegularFile, syncDirectory, syncFileDescriptor, } from '../internal/filesystem.js';
+import { compareCanonicalPaths } from '../paths.js';
+import { isByteRevision } from '../revision.js';
+export function transactionRoot(authorityRoot, managedRootId) {
+    if (!/^[0-9a-f]{64}$/u.test(managedRootId))
+        throw malformed('Managed-root transaction identity is invalid.');
+    const path = join(authorityRoot, '.neottia', 'repository-store', 'transactions', managedRootId);
+    ensurePrivateDirectory(path);
+    return path;
+}
+export function writeDurableFile(path, bytes) {
+    let descriptor;
+    try {
+        descriptor = openSync(path, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL, 0o600);
+        writeFileSync(descriptor, bytes);
+        syncFileDescriptor(descriptor, path);
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+    }
+}
+export function manifestDigest(manifest) {
+    return createHash('sha256').update(JSON.stringify(manifest)).digest('hex');
+}
+export function readManifest(directory, maxJournalBytes) {
+    const path = join(directory, 'manifest.json');
+    const stat = lstatSync(path);
+    assertSafeRegular(stat, path);
+    if (stat.size > maxJournalBytes)
+        throw malformed('Transaction manifest exceeds maxJournalBytes.');
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder().decode(readRegularFile(path, maxJournalBytes)));
+    }
+    catch (error) {
+        throw malformed('Transaction manifest is not valid JSON.', error);
+    }
+    if (!isManifest(value))
+        throw malformed('Transaction manifest has an invalid schema.');
+    const { digest, ...unsigned } = value;
+    if (manifestDigest(unsigned) !== digest)
+        throw malformed('Transaction manifest digest does not match.');
+    const sorted = [...value.entries].sort((left, right) => compareCanonicalPaths(left.path, right.path));
+    if (sorted.some((entry, index) => entry.path !== value.entries[index]?.path))
+        throw malformed('Transaction manifest entries are not canonically sorted.');
+    return value;
+}
+export function cleanupJournal(directory, manifest) {
+    const expected = new Set(['manifest.json']);
+    for (const entry of manifest.entries)
+        for (const artifact of [entry.beforeArtifact, entry.stagedArtifact])
+            if (artifact !== null)
+                expected.add(artifact);
+    const actual = readdirSync(directory);
+    if (actual.some((name) => !expected.has(name)))
+        throw malformed('Transaction directory contains unowned artifacts.');
+    for (const entry of manifest.entries) {
+        for (const artifact of [entry.beforeArtifact, entry.stagedArtifact]) {
+            if (artifact === null)
+                continue;
+            assertArtifactName(artifact, manifest.transactionId);
+            const path = join(directory, artifact);
+            try {
+                const stat = lstatSync(path);
+                assertSafeRegular(stat, path);
+                rmSync(path);
+                emitTransactionFault('cleanup-artifact-removed');
+            }
+            catch (error) {
+                if (!isMissing(error))
+                    throw error;
+            }
+        }
+    }
+    removeRegularIfPresent(join(directory, 'manifest.json'));
+    emitTransactionFault('cleanup-manifest-removed');
+    rmdirSync(directory);
+    emitTransactionFault('cleanup-directory-removed');
+    syncDirectory(join(directory, '..'));
+    emitTransactionFault('cleanup-root-synced');
+}
+export function cleanupIncompleteJournal(directory, transactionId, limits) {
+    const entries = readdirSync(directory);
+    for (const entry of entries) {
+        const path = join(directory, entry);
+        const stat = lstatSync(path);
+        assertSafeRegular(stat, path);
+        if (entry === 'manifest.json') {
+            if (stat.size > limits.maxJournalBytes)
+                throw malformed('Incomplete transaction manifest exceeds its bound.');
+        }
+        else {
+            assertArtifactName(entry, transactionId);
+            if (stat.size > limits.maxArtifactBytes)
+                throw malformed('Incomplete transaction artifact exceeds its bound.');
+        }
+    }
+    for (const entry of entries.filter((name) => name !== 'manifest.json')) {
+        rmSync(join(directory, entry));
+        emitTransactionFault('cleanup-artifact-removed');
+    }
+    removeRegularIfPresent(join(directory, 'manifest.json'));
+    emitTransactionFault('cleanup-manifest-removed');
+    rmdirSync(directory);
+    emitTransactionFault('cleanup-directory-removed');
+    syncDirectory(join(directory, '..'));
+    emitTransactionFault('cleanup-root-synced');
+}
+export function validateArtifacts(directory, manifest, limits) {
+    let beforeBytes = 0;
+    let stagedBytes = 0;
+    for (const entry of manifest.entries) {
+        if (entry.beforeArtifact !== null) {
+            assertArtifactName(entry.beforeArtifact, manifest.transactionId);
+            const bytes = readArtifact(directory, entry.beforeArtifact, limits.maxBeforeImageBytes);
+            beforeBytes += bytes.byteLength;
+            if (revision(bytes) !== entry.originalRevision)
+                throw malformed('Before-image revision does not match manifest.');
+        }
+        if (entry.stagedArtifact !== null) {
+            assertArtifactName(entry.stagedArtifact, manifest.transactionId);
+            const bytes = readArtifact(directory, entry.stagedArtifact, limits.maxTemporaryBytes);
+            stagedBytes += bytes.byteLength;
+            if (revision(bytes) !== entry.intendedRevision)
+                throw malformed('Staged revision does not match manifest.');
+        }
+    }
+    if (beforeBytes > limits.maxBeforeImageBytes)
+        throw new ResourceLimitError('Transaction before-images exceed configured bound.');
+    if (stagedBytes > limits.maxTemporaryBytes)
+        throw new ResourceLimitError('Transaction staged artifacts exceed configured bound.');
+}
+export function readArtifact(directory, name, maxBytes) {
+    assertArtifactName(name, directory.split(/[\\/]/u).at(-1)?.split('.')[0] ?? '');
+    const path = join(directory, name);
+    return readRegularFile(path, maxBytes);
+}
+export function createTransactionDirectory(path) {
+    mkdirSync(path, { mode: 0o700 });
+}
+function isManifest(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const candidate = value;
+    if (candidate.version !== 1 ||
+        typeof candidate.transactionId !== 'string' ||
+        !/^[0-9a-f]{64}$/u.test(candidate.transactionId) ||
+        typeof candidate.authorityId !== 'string' ||
+        !/^[0-9a-f]{64}$/u.test(candidate.authorityId) ||
+        typeof candidate.managedRootId !== 'string' ||
+        !/^[0-9a-f]{64}$/u.test(candidate.managedRootId) ||
+        typeof candidate.createdAt !== 'string' ||
+        typeof candidate.digest !== 'string' ||
+        !/^[0-9a-f]{64}$/u.test(candidate.digest) ||
+        !Array.isArray(candidate.entries))
+        return false;
+    const paths = new Set();
+    for (const entry of candidate.entries) {
+        if (!isEntry(entry) || paths.has(entry.path))
+            return false;
+        paths.add(entry.path);
+    }
+    return true;
+}
+function isEntry(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const entry = value;
+    return (typeof entry.path === 'string' &&
+        (entry.originalRevision === null || isByteRevision(entry.originalRevision)) &&
+        (entry.intendedRevision === null || isByteRevision(entry.intendedRevision)) &&
+        (entry.beforeArtifact === null || typeof entry.beforeArtifact === 'string') &&
+        (entry.stagedArtifact === null || typeof entry.stagedArtifact === 'string') &&
+        Number.isSafeInteger(entry.bytes) &&
+        (entry.bytes ?? -1) >= 0);
+}
+function assertArtifactName(name, token) {
+    if (!new RegExp(`^[0-9]+-${token}\\.(?:before|stage)$`, 'u').test(name))
+        throw malformed(`Unowned transaction artifact name: ${name}`);
+}
+function revision(bytes) {
+    return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
+}
+function malformed(message, cause) {
+    return new RecoveryError(message, 'RECOVERY_MALFORMED', undefined, cause === undefined ? undefined : { cause });
+}
+function removeRegularIfPresent(path) {
+    try {
+        const stat = lstatSync(path);
+        assertSafeRegular(stat, path);
+        rmSync(path);
+    }
+    catch (error) {
+        if (!isMissing(error))
+            throw error;
+    }
+}
+function isMissing(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=journal.js.map

package/dist/transaction/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/transaction/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,SAAS,EACT,SAAS,IAAI,WAAW,EACxB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,MAAM,EACN,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,MAAM,UAAU,eAAe,CAAC,aAAqB,EAAE,aAAqB;IAC1E,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC;QAAE,MAAM,SAAS,CAAC,+CAA+C,CAAC,CAAC;IAC7G,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAChG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAiB;IAC9D,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpG,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;YAAS,CAAC;QACT,IAAI,UAAU,KAAK,SAAS;YAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,QAAyC;IACtE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAGD,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,eAAuB;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,IAAI,GAAG,eAAe;QAAE,MAAM,SAAS,CAAC,+CAA+C,CAAC,CAAC;IAClG,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,SAAS,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,MAAM,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACvF,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;IACtC,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,MAAM;QAAE,MAAM,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACxG,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACtG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;QAC1E,MAAM,SAAS,CAAC,0DAA0D,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAyB;IACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO;QAClC,KAAK,MAAM,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC;YAAE,IAAI,QAAQ,KAAK,IAAI;gBAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrH,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,MAAM,SAAS,CAAC,mDAAmD,CAAC,CAAC;IACrH,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YACpE,IAAI,QAAQ,KAAK,IAAI;gBAAE,SAAS;YAChC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC7B,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,CAAC;gBACb,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IACD,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IACzD,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;IACjD,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;IAClD,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACrC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;AAC9C,CAAC;AAGD,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,aAAqB,EACrB,MAA+E;IAE/E,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,eAAe;gBAAE,MAAM,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAChH,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,gBAAgB;gBAAE,MAAM,SAAS,CAAC,oDAAoD,CAAC,CAAC;QACjH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/B,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;IACnD,CAAC;IACD,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IACzD,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;IACjD,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;IAClD,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACrC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;AAC9C,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,QAAyB,EACzB,MAAoF;IAEpF,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YAClC,kBAAkB,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxF,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC;YAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,gBAAgB;gBAAE,MAAM,SAAS,CAAC,gDAAgD,CAAC,CAAC;QACpH,CAAC;QACD,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YAClC,kBAAkB,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACtF,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC;YAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,gBAAgB;gBAAE,MAAM,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IACD,IAAI,WAAW,GAAG,MAAM,CAAC,mBAAmB;QAC1C,MAAM,IAAI,kBAAkB,CAAC,oDAAoD,CAAC,CAAC;IACrF,IAAI,WAAW,GAAG,MAAM,CAAC,iBAAiB;QACxC,MAAM,IAAI,kBAAkB,CAAC,uDAAuD,CAAC,CAAC;AAC1F,CAAC;AAGD,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,IAAY,EAAE,QAAgB;IAC5E,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAGD,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,SAAS,GAAG,KAAiC,CAAC;IACpD,IACE,SAAS,CAAC,OAAO,KAAK,CAAC;QACvB,OAAO,SAAS,CAAC,aAAa,KAAK,QAAQ;QAC3C,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;QAChD,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;QACzC,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QAC9C,OAAO,SAAS,CAAC,aAAa,KAAK,QAAQ;QAC3C,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;QAChD,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;QACvC,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ;QACpC,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACzC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;QAEjC,OAAO,KAAK,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3D,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,KAAK,GAAG,KAA8B,CAAC;IAC7C,OAAO,CACL,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,KAAK,CAAC,gBAAgB,KAAK,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC3E,CAAC,KAAK,CAAC,gBAAgB,KAAK,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC3E,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,CAAC;QAC3E,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,CAAC;QAC3E,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CACzB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAa;IACrD,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,KAAK,sBAAsB,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrE,MAAM,SAAS,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB;IACjC,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,KAAe;IACjD,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAClH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;AACzG,CAAC"}

package/dist/transaction/recovery.d.ts

@@ -0,0 +1,6 @@
+import type { RecoveryReport } from './types.js';
+import { type ManagedRoot, type RepositoryLease } from '../internal/model.js';
+import { type OperationControl } from '../lease.js';
+export declare function recoverCanonicalTransactions(root: ManagedRoot, lease: RepositoryLease, options?: OperationControl): Promise<RecoveryReport>;
+export declare function recoverActiveDirectory(root: ManagedRoot, lease: RepositoryLease, directory: string, options: OperationControl): Promise<void>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/transaction/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/transaction/recovery.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EAA8B,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE1G,OAAO,EAAiC,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMnF,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAqCzB;AAGD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAyDf"}