@openclaw/fs-safe 0.16.0 → 0.18.0

package/dist/file-lock-sync-stale-admission.js

@@ -1,26 +1,25 @@
 import fs from "node:fs";
-import { defaultSyncShouldReclaim, syncLockTimeout } from "./file-lock-sync-admission.js";
+import { defaultSyncShouldReclaim } from "./file-lock-sync-admission.js";
 import { parseSidecarLockSnapshot, readSidecarLockRawSnapshotSync, removeSidecarLockIfUnchangedSync, } from "./sidecar-lock-reclaim.js";
+import { assertSynchronousCallbackResult } from "./mutation-authority.js";
 /** Handle one exclusive-create conflict without surrendering canonical admission. */
-export function handleSyncStaleAdmission(params) {
+export function handleSyncStaleAdmission(acquisition, params) {
     const holderChanged = {};
     const assertUnheld = () => {
-        if (!params.hasToken()) {
-            throw syncLockTimeout(params.lockPath, params.normalizedTargetPath);
-        }
+        acquisition.assert();
         if (params.currentHeld())
             throw holderChanged;
     };
     const retryHolderChange = (error) => {
         if (error !== holderChanged)
             return false;
-        params.waitForRetry();
+        acquisition.waitForRetry();
         return true;
     };
     let rawSnapshot;
     let lockFileOpenDenied = false;
     try {
-        rawSnapshot = readSidecarLockRawSnapshotSync(params.lockPath, {
+        rawSnapshot = readSidecarLockRawSnapshotSync(acquisition.lockPath, {
             rejectNonFile: true,
             onOpenFailure: (error) => {
                 lockFileOpenDenied = true;
@@ -40,7 +39,7 @@ export function handleSyncStaleAdmission(params) {
                 return;
             throw boundaryError;
         }
-        if (lockFileOpenDenied && params.retryLockFileDenial(error))
+        if (lockFileOpenDenied && acquisition.retryDenial(error))
             return;
         throw error;
     }
@@ -92,7 +91,7 @@ export function handleSyncStaleAdmission(params) {
         throw error;
     }
     if (!snapshot) {
-        params.waitForRetry();
+        acquisition.waitForRetry();
         return;
     }
     const nowMs = Date.now();
@@ -102,14 +101,15 @@ export function handleSyncStaleAdmission(params) {
         try {
             reclaim = stale.shouldReclaim
                 ? Reflect.apply(stale.shouldReclaim, params.options, [{
-                        lockPath: params.lockPath,
-                        normalizedTargetPath: params.normalizedTargetPath,
+                        lockPath: acquisition.lockPath,
+                        normalizedTargetPath: acquisition.normalizedTargetPath,
                         payload: snapshot.payload,
                         staleMs: params.staleMs,
                         nowMs,
                         heldByThisProcess: false,
                     }])
                 : defaultSyncShouldReclaim(snapshot, params.staleMs, nowMs);
+            assertSynchronousCallbackResult(reclaim, "shouldReclaim");
         }
         finally {
             assertUnheld();
@@ -121,7 +121,7 @@ export function handleSyncStaleAdmission(params) {
         throw error;
     }
     if (!reclaim) {
-        params.waitForRetry();
+        acquisition.waitForRetry();
         return;
     }
     if (params.staleRecovery === "remove-if-unchanged" &&
@@ -132,11 +132,12 @@ export function handleSyncStaleAdmission(params) {
             assertUnheld();
             try {
                 approved = Reflect.apply(stale.shouldRemove, params.options, [{
-                        lockPath: params.lockPath,
-                        normalizedTargetPath: params.normalizedTargetPath,
+                        lockPath: acquisition.lockPath,
+                        normalizedTargetPath: acquisition.normalizedTargetPath,
                         raw: snapshot.raw,
                         payload: snapshot.payload,
                     }]);
+                assertSynchronousCallbackResult(approved, "shouldRemoveStaleLock");
             }
             finally {
                 assertUnheld();
@@ -148,10 +149,10 @@ export function handleSyncStaleAdmission(params) {
             throw error;
         }
         if (!approved) {
-            throw Object.assign(new Error(`file lock stale for ${params.normalizedTargetPath}`), {
+            throw Object.assign(new Error(`file lock stale for ${acquisition.normalizedTargetPath}`), {
                 code: "file_lock_stale",
-                lockPath: params.lockPath,
-                normalizedTargetPath: params.normalizedTargetPath,
+                lockPath: acquisition.lockPath,
+                normalizedTargetPath: acquisition.normalizedTargetPath,
             });
         }
         try {
@@ -167,7 +168,7 @@ export function handleSyncStaleAdmission(params) {
                 throw boundaryError;
             }
             if (error.code === "EEXIST") {
-                params.waitForRetry();
+                acquisition.waitForRetry();
                 return;
             }
             throw error;
@@ -175,7 +176,7 @@ export function handleSyncStaleAdmission(params) {
         let holderInterrupted = false;
         try {
             assertUnheld();
-            if (removeSidecarLockIfUnchangedSync(params.lockPath, snapshot, assertUnheld))
+            if (removeSidecarLockIfUnchangedSync(acquisition.lockPath, snapshot, assertUnheld))
                 return;
         }
         catch (error) {
@@ -193,13 +194,13 @@ export function handleSyncStaleAdmission(params) {
             }
         }
         if (holderInterrupted) {
-            params.waitForRetry();
+            acquisition.waitForRetry();
             return;
         }
     }
-    throw Object.assign(new Error(`file lock stale for ${params.normalizedTargetPath}`), {
+    throw Object.assign(new Error(`file lock stale for ${acquisition.normalizedTargetPath}`), {
         code: "file_lock_stale",
-        lockPath: params.lockPath,
-        normalizedTargetPath: params.normalizedTargetPath,
+        lockPath: acquisition.lockPath,
+        normalizedTargetPath: acquisition.normalizedTargetPath,
     });
 }

package/dist/file-lock-sync.d.ts

@@ -32,4 +32,3 @@ export type FileLockSyncHandle = {
 };
 export declare function acquireFileLockSync<TPayload extends Record<string, unknown>>(targetPath: string, options: FileLockSyncAcquireOptions<TPayload>): FileLockSyncHandle;
 export declare function withFileLockSync<T, TPayload extends Record<string, unknown>>(targetPath: string, options: FileLockSyncAcquireOptions<TPayload>, fn: () => T): T;
-//# sourceMappingURL=file-lock-sync.d.ts.map

package/dist/file-lock-sync.js

@@ -1,16 +1,16 @@
 import fs from "node:fs";
 import { acquireFileLockSyncWithRoot } from "./file-lock-sync-root-acquire.js";
-import { isRootSyncHeldLockHandle, withRootSyncHeldLockHandle } from "./file-lock-sync-root-held.js";
+import { withSyncHeldLockHandle } from "./file-lock-sync-root-held.js";
 import path from "node:path";
-import { readSidecarLockSnapshotSync, removeSidecarLockIfUnchangedSync, serializeSidecarLockPayload, sidecarLockSnapshotMatches, } from "./sidecar-lock-reclaim.js";
-import { computeSidecarLockDelayMs, isTransientLockFileDenial, maxTransientLockDenials, validateSidecarLockStaleMs, validateSidecarLockCompromiseCheckIntervalMs, validateSidecarLockRetryOptions, validateSidecarLockTimeoutMs, } from "./sidecar-lock-policy.js";
+import { readSidecarLockRawSnapshotSync, readSidecarLockSnapshotSync, removeSidecarLockIfUnchangedSync, serializeSidecarLockPayload, sidecarLockSnapshotMatches, } from "./sidecar-lock-reclaim.js";
+import { sidecarLockTimeout, isTransientLockFileDenial, validateSidecarLockStaleMs, validateSidecarLockCompromiseCheckIntervalMs, validateSidecarLockRetryOptions, validateSidecarLockTimeoutMs, } from "./sidecar-lock-policy.js";
 import { getFsSafeLockConfig } from "./lock-config.js";
-import { sleepSync } from "./timing.js";
+import { SyncLockAcquisition } from "./file-lock-sync-acquisition.js";
 import { assertNoWindowsPathAlias } from "./windows-path-alias.js";
 import { realpathSync } from "./realpath.js";
 import { recursiveMkdirPath } from "./recursive-mkdir-path.js";
 import { createSuppressedError } from "./suppressed-error.js";
-import { ensureSyncLockExitCleanupRegistered, getSyncHeldLocks, foreignSyncHeldLock, getSyncLockAdmissions, syncReclaimGuardExists, syncLockTimeout, } from "./file-lock-sync-admission.js";
+import { ensureSyncLockExitCleanupRegistered, getSyncHeldLocks, foreignSyncHeldLock, getSyncLockAdmissions, syncReclaimGuardExists, } from "./file-lock-sync-admission.js";
 import { handleSyncStaleAdmission, } from "./file-lock-sync-stale-admission.js";
 function releaseAllSyncHeldLocks() {
     const heldLocks = getSyncHeldLocks();
@@ -37,7 +37,11 @@ function releaseAllSyncHeldLocks() {
     getSyncLockAdmissions().clear();
 }
 function verifySyncHeldLock(held) {
-    const current = readSidecarLockSnapshotSync(held.lockPath, held.parsePayload);
+    const lockPath = held.lockPath;
+    const parsePayload = held.parsePayload;
+    const current = parsePayload
+        ? readSidecarLockSnapshotSync(lockPath, parsePayload)
+        : readSidecarLockRawSnapshotSync(lockPath);
     return !!current && sidecarLockSnapshotMatches(current, held.snapshot);
 }
 function releaseSyncHeldLock(held) {
@@ -131,15 +135,7 @@ export function acquireFileLockSync(targetPath, options) {
         initiallyHeld.refCount += 1;
         return createSyncHeldLockHandle(initiallyHeld);
     }
-    const admissions = getSyncLockAdmissions();
-    const admissionToken = {};
-    let ownsAdmission = false;
-    const hasAdmissionToken = () => admissions.get(normalizedTargetPath) === admissionToken;
-    const releaseAdmission = () => {
-        if (ownsAdmission && hasAdmissionToken())
-            admissions.delete(normalizedTargetPath);
-        ownsAdmission = false;
-    };
+    const acquisition = new SyncLockAcquisition(lockPath, normalizedTargetPath, retry, timeoutMs);
     let payloadCallback;
     let onCompromised = undefined;
     let onCompromisedObserved = false;
@@ -148,54 +144,10 @@ export function acquireFileLockSync(targetPath, options) {
     let staleRecovery = undefined;
     let staleRecoveryObserved = false;
     const staleOptions = {};
-    const startedAt = Date.now();
-    let attempt = 0;
-    let transientDenials = 0;
     const reclaimGuardPath = `${lockPath}.reclaim`;
-    const waitForRetry = () => {
-        releaseAdmission();
-        const elapsed = Date.now() - startedAt;
-        const timedOut = timeoutMs !== undefined && elapsed >= timeoutMs;
-        if (timedOut || (retry.retries !== undefined && attempt >= retry.retries)) {
-            throw syncLockTimeout(lockPath, normalizedTargetPath);
-        }
-        const remaining = timeoutMs === undefined || timeoutMs === Number.POSITIVE_INFINITY
-            ? Number.POSITIVE_INFINITY
-            : Math.max(0, timeoutMs - elapsed);
-        sleepSync(Math.min(computeSidecarLockDelayMs(retry, attempt), remaining));
-        attempt += 1;
-    };
-    const retryLockFileDenial = (error) => {
-        if (!isTransientLockFileDenial(error, lockPath) ||
-            ++transientDenials > maxTransientLockDenials)
-            return false;
-        try {
-            waitForRetry();
-        }
-        catch (waitError) {
-            // Preserve the filesystem diagnosis when the caller's budget runs out.
-            if (waitError.code === "file_lock_timeout")
-                throw error;
-            throw waitError;
-        }
-        return true;
-    };
-    const assertAdmissionToken = () => {
-        if (!hasAdmissionToken())
-            throw syncLockTimeout(lockPath, normalizedTargetPath);
-    };
-    const runAdmissionBoundary = (callback) => {
-        assertAdmissionToken();
-        try {
-            return callback();
-        }
-        finally {
-            assertAdmissionToken();
-        }
-    };
     try {
         while (true) {
-            if (!ownsAdmission) {
+            if (!acquisition.owns) {
                 const held = heldLocks.get(normalizedTargetPath);
                 if (held && !foreignSyncHeldLock("raw", normalizedTargetPath) &&
                     requestedReentrantOwner !== undefined &&
@@ -204,12 +156,7 @@ export function acquireFileLockSync(targetPath, options) {
                     held.refCount += 1;
                     return createSyncHeldLockHandle(held);
                 }
-                if (admissions.has(normalizedTargetPath)) {
-                    // The owner can only finish after this synchronous callback unwinds.
-                    throw syncLockTimeout(lockPath, normalizedTargetPath);
-                }
-                admissions.set(normalizedTargetPath, admissionToken);
-                ownsAdmission = true;
+                acquisition.reserve();
             }
             const attemptHeld = currentTargetHolder();
             const holderWasReplaced = () => {
@@ -217,60 +164,60 @@ export function acquireFileLockSync(targetPath, options) {
                 return current !== undefined && current !== attemptHeld;
             };
             if (!staleRecoveryObserved) {
-                staleRecovery = runAdmissionBoundary(() => options.staleRecovery ?? defaults.staleRecovery);
+                staleRecovery = acquisition.run(() => options.staleRecovery ?? defaults.staleRecovery);
                 staleRecoveryObserved = true;
                 if (holderWasReplaced()) {
-                    waitForRetry();
+                    acquisition.waitForRetry();
                     continue;
                 }
             }
             const reclaimGuardExists = syncReclaimGuardExists(reclaimGuardPath);
-            if (!hasAdmissionToken())
-                throw syncLockTimeout(lockPath, normalizedTargetPath);
+            if (!acquisition.hasToken())
+                throw sidecarLockTimeout(lockPath, normalizedTargetPath);
             if (holderWasReplaced()) {
-                waitForRetry();
+                acquisition.waitForRetry();
                 continue;
             }
             if (reclaimGuardExists) {
-                waitForRetry();
+                acquisition.waitForRetry();
                 continue;
             }
             let fd;
             let createdHeld;
             let createdSnapshot;
             if (!payloadCallback)
-                payloadCallback = runAdmissionBoundary(() => options.payload);
+                payloadCallback = acquisition.run(() => options.payload);
             if (holderWasReplaced()) {
-                waitForRetry();
+                acquisition.waitForRetry();
                 continue;
             }
-            const payload = runAdmissionBoundary(() => Reflect.apply(payloadCallback, options, []));
+            const payload = acquisition.run(() => Reflect.apply(payloadCallback, options, []));
             if (holderWasReplaced()) {
-                waitForRetry();
+                acquisition.waitForRetry();
                 continue;
             }
-            const { raw, ownershipToken } = runAdmissionBoundary(() => serializeSidecarLockPayload(payload));
+            const { raw, ownershipToken } = acquisition.run(() => serializeSidecarLockPayload(payload));
             if (holderWasReplaced()) {
-                waitForRetry();
+                acquisition.waitForRetry();
                 continue;
             }
             if (currentTargetHolder() !== undefined) {
-                waitForRetry();
+                acquisition.waitForRetry();
                 continue;
             }
             if (!onCompromisedObserved) {
-                onCompromised = runAdmissionBoundary(() => options.onCompromised);
+                onCompromised = acquisition.run(() => options.onCompromised);
                 onCompromisedObserved = true;
                 if (currentTargetHolder() !== undefined) {
-                    waitForRetry();
+                    acquisition.waitForRetry();
                     continue;
                 }
             }
             if (!parsePayloadObserved) {
-                parsePayload = runAdmissionBoundary(() => options.parsePayload);
+                parsePayload = acquisition.run(() => options.parsePayload);
                 parsePayloadObserved = true;
                 if (currentTargetHolder() !== undefined) {
-                    waitForRetry();
+                    acquisition.waitForRetry();
                     continue;
                 }
             }
@@ -307,34 +254,17 @@ export function acquireFileLockSync(targetPath, options) {
                 };
                 const candidateHeld = createdHeld;
                 ensureSyncLockExitCleanupRegistered(releaseAllSyncHeldLocks, lockPath, normalizedTargetPath);
-                if (!hasAdmissionToken() || currentTargetHolder() !== undefined) {
-                    throw syncLockTimeout(lockPath, normalizedTargetPath);
+                if (!acquisition.hasToken() || currentTargetHolder() !== undefined) {
+                    throw sidecarLockTimeout(lockPath, normalizedTargetPath);
                 }
                 const returnedHandle = createSyncHeldLockHandle(candidateHeld);
-                if (onCompromised && (compromiseCheckIntervalMs ?? 0) > 0) {
-                    const compromisedCallback = onCompromised;
-                    candidateHeld.timer = setInterval(() => {
-                        let stillHeld;
-                        try {
-                            stillHeld = returnedHandle.verifyStillHeld();
-                        }
-                        catch {
-                            stillHeld = false;
-                        }
-                        if (!stillHeld && candidateHeld.timer) {
-                            clearInterval(candidateHeld.timer);
-                            candidateHeld.timer = undefined;
-                            Reflect.apply(compromisedCallback, options, [{ lockPath, normalizedTargetPath }]);
-                        }
-                    }, compromiseCheckIntervalMs);
-                    candidateHeld.timer.unref();
-                }
-                if (!hasAdmissionToken() ||
+                acquisition.monitor(candidateHeld, returnedHandle, onCompromised, compromiseCheckIntervalMs, options);
+                if (!acquisition.hasToken() ||
                     currentTargetHolder() !== undefined) {
-                    throw syncLockTimeout(lockPath, normalizedTargetPath);
+                    throw sidecarLockTimeout(lockPath, normalizedTargetPath);
                 }
                 heldLocks.set(normalizedTargetPath, candidateHeld);
-                releaseAdmission();
+                acquisition.release();
                 fd = undefined;
                 return returnedHandle;
             }
@@ -370,54 +300,42 @@ export function acquireFileLockSync(targetPath, options) {
                     }
                 }
                 if (lockFileCreateDenied) {
-                    if (!hasAdmissionToken())
-                        throw syncLockTimeout(lockPath, normalizedTargetPath);
+                    if (!acquisition.hasToken())
+                        throw sidecarLockTimeout(lockPath, normalizedTargetPath);
                     if (currentTargetHolder() !== undefined) {
-                        waitForRetry();
+                        acquisition.waitForRetry();
                         continue;
                     }
-                    if (retryLockFileDenial(error))
+                    if (acquisition.retryDenial(error))
                         continue;
                     throw error;
                 }
                 if (!exclusiveCreateConflict)
                     throw error;
-                if (!hasAdmissionToken())
-                    throw syncLockTimeout(lockPath, normalizedTargetPath);
+                if (!acquisition.hasToken())
+                    throw sidecarLockTimeout(lockPath, normalizedTargetPath);
                 if (currentTargetHolder() !== undefined) {
-                    waitForRetry();
+                    acquisition.waitForRetry();
                     continue;
                 }
-                handleSyncStaleAdmission({
-                    hasToken: hasAdmissionToken,
+                handleSyncStaleAdmission(acquisition, {
                     currentHeld: currentTargetHolder,
-                    lockPath,
-                    normalizedTargetPath,
                     options,
                     parsePayload,
                     reclaimGuardPath,
-                    retryLockFileDenial,
                     staleMs,
                     staleOptions,
                     staleRecovery,
-                    waitForRetry,
                 });
                 continue;
             }
         }
     }
     finally {
-        releaseAdmission();
+        acquisition.release();
     }
 }
 export function withFileLockSync(targetPath, options, fn) {
     const lock = acquireFileLockSync(targetPath, options);
-    if (isRootSyncHeldLockHandle(lock))
-        return withRootSyncHeldLockHandle(lock, fn);
-    try {
-        return fn();
-    }
-    finally {
-        lock.release();
-    }
+    return withSyncHeldLockHandle(lock, fn);
 }

package/dist/file-lock.d.ts

@@ -21,4 +21,3 @@ export declare function withFileLock<T, TPayload extends Record<string, unknown>
 export declare function createFileLockManager(key: string): FileLockManager;
 export declare function drainFileLockManagerForTest(targetPath: string, managerKey?: string): Promise<void>;
 export declare function resetFileLockManagerForTest(targetPath: string, managerKey?: string): void;
-//# sourceMappingURL=file-lock.d.ts.map

package/dist/file-observation.d.ts

@@ -6,4 +6,3 @@ export declare function fileObservation(): {
     has(error: unknown, kind: FailureKind): boolean;
 };
 export {};
-//# sourceMappingURL=file-observation.d.ts.map

package/dist/file-store-boundary.d.ts

@@ -18,7 +18,6 @@ export declare function writeStreamToTempSource(params: {
     path: string;
     cleanup: () => Promise<void>;
 }>;
-export declare function assertSyncDirectoryGuard(guard: SyncParentGuard): void;
 export declare function ensureParentSync(params: {
     rootDir: string;
     filePath: string;
@@ -30,4 +29,3 @@ export declare function ensureStoreDirectorySync(params: {
     mode: number;
     messagePrefix: "private store" | "store";
 }): SyncParentGuard;
-//# sourceMappingURL=file-store-boundary.d.ts.map

package/dist/file-store-boundary.js

@@ -2,7 +2,6 @@ import syncFs from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createByteLimitTransform } from "./bounded-read-stream.js";
-import { normalizeMaxBytes } from "./byte-budget.js";
 import { pipeline } from "node:stream/promises";
 import { FsSafeError } from "./errors.js";
 import { assertSyncStoreDirectoryReceipt, ensureSyncStoreDirectory, } from "./file-store-sync-directory.js";
@@ -14,13 +13,9 @@ import { prepareSecretFileWrite } from "./secret-file.js";
 import { resolveSecureTempRoot } from "./secure-temp-dir.js";
 import { recursiveMkdirPath } from "./recursive-mkdir-path.js";
 import { assertNoWindowsPathAlias } from "./windows-path-alias.js";
-function parentRelativePath(relativePath) {
-    const parent = path.posix.dirname(relativePath);
-    return parent === "." ? "" : parent;
-}
 export async function ensureParentInRoot(scopedRoot, relativePath, mode) {
-    const parent = parentRelativePath(relativePath);
-    if (!parent) {
+    const parent = path.posix.dirname(relativePath);
+    if (parent === ".") {
         return;
     }
     await scopedRoot.mkdir(parent);
@@ -28,10 +23,9 @@ export async function ensureParentInRoot(scopedRoot, relativePath, mode) {
 }
 export async function openWritableStoreRoot(params) {
     assertNoWindowsPathAlias(params.rootDir, "filesystem", "store root uses a Windows filesystem namespace alias");
-    const maxBytes = normalizeMaxBytes(params.maxBytes);
     await fs.mkdir(recursiveMkdirPath(params.rootDir), { recursive: true, mode: params.dirMode });
     await fs.chmod(params.rootDir, params.dirMode).catch(() => undefined);
-    return await root(params.rootDir, { hardlinks: "reject", maxBytes });
+    return await root(params.rootDir, { hardlinks: "reject", maxBytes: params.maxBytes });
 }
 export async function openPrivateStoreLockRoot(params) {
     const { parentGuard } = await prepareSecretFileWrite(params);
@@ -66,15 +60,8 @@ async function chmodDirectoryInRootBestEffort(scopedRoot, relativePath, mode) {
         await handle.close().catch(() => undefined);
     }
 }
-function createMaxBytesTransform(maxBytes) {
-    const limit = normalizeMaxBytes(maxBytes);
-    if (limit === undefined) {
-        return undefined;
-    }
-    return createByteLimitTransform(limit, () => new FsSafeError("too-large", `file exceeds maximum size of ${limit} bytes`));
-}
 export async function writeStreamToTempSource(params) {
-    const maxBytes = normalizeMaxBytes(params.maxBytes);
+    const maxBytes = params.maxBytes;
     const tempRoot = resolveSecureTempRoot({
         fallbackPrefix: "fs-safe-file-store",
         unsafeFallbackLabel: "file store temp dir",
@@ -90,7 +77,7 @@ export async function writeStreamToTempSource(params) {
         writable.once("close", () => {
             handleClosedByStream = true;
         });
-        const limiter = createMaxBytesTransform(maxBytes);
+        const limiter = maxBytes === undefined ? undefined : createByteLimitTransform(maxBytes, () => new FsSafeError("too-large", `file exceeds maximum size of ${maxBytes} bytes`));
         if (limiter) {
             await pipeline(params.stream, limiter, writable);
         }
@@ -116,13 +103,6 @@ export async function writeStreamToTempSource(params) {
         throw err;
     }
 }
-export function assertSyncDirectoryGuard(guard) {
-    assertSyncStoreDirectoryReceipt({
-        dir: guard.dir,
-        realPath: guard.realPath,
-        exactStat: guard.exactStat,
-    });
-}
 export function ensureParentSync(params) {
     assertNoWindowsPathAlias(params.rootDir, "filesystem", "store root uses a Windows filesystem namespace alias");
     assertNoWindowsPathAlias(params.filePath, "filesystem", "store path uses a Windows filesystem namespace alias");
@@ -135,6 +115,6 @@ export function ensureParentSync(params) {
 }
 export function ensureStoreDirectorySync(params) {
     const guard = ensureSyncStoreDirectory(params);
-    assertSyncDirectoryGuard(guard);
+    assertSyncStoreDirectoryReceipt(guard);
     return guard;
 }

package/dist/file-store-copy-source.d.ts

@@ -1,5 +1,4 @@
 export declare function readFileStoreCopySource(params: {
     sourcePath: string;
-    maxBytes?: number;
+    maxBytes: number;
 }): Promise<Buffer>;
-//# sourceMappingURL=file-store-copy-source.d.ts.map

package/dist/file-store-copy-source.js

@@ -21,7 +21,7 @@ export async function readFileStoreCopySource(params) {
                 cause: error instanceof Error ? error : undefined,
             });
         }
-        if (params.maxBytes !== undefined && message.includes(`exceeds ${params.maxBytes} bytes`)) {
+        if (message.includes(`exceeds ${params.maxBytes} bytes`)) {
             throw new FsSafeError("too-large", `file exceeds maximum size of ${params.maxBytes} bytes`, {
                 cause: error instanceof Error ? error : undefined,
             });

package/dist/file-store-limit.d.ts

@@ -1,2 +1 @@
-export declare function assertFileStoreMaxBytes(size: number, maxBytes?: number): void;
-//# sourceMappingURL=file-store-limit.d.ts.map
+export declare function assertFileStoreMaxBytes(size: number, limit: number | undefined): void;

package/dist/file-store-limit.js

@@ -1,7 +1,6 @@
-import { normalizeMaxBytes } from "./byte-budget.js";
 import { FsSafeError } from "./errors.js";
-export function assertFileStoreMaxBytes(size, maxBytes) {
-    const limit = normalizeMaxBytes(maxBytes);
+// Store operation boundaries admit the primitive limit before reaching this helper.
+export function assertFileStoreMaxBytes(size, limit) {
     if (limit !== undefined && size > limit) {
         throw new FsSafeError("too-large", `file exceeds maximum size of ${limit} bytes`);
     }

package/dist/file-store-path.d.ts

@@ -1,3 +1,2 @@
 export declare function assertRelativePath(relativePath: string): string;
 export declare function resolveStorePath(rootDir: string, relativePath: string): string;
-//# sourceMappingURL=file-store-path.d.ts.map

package/dist/file-store-prune.d.ts

@@ -9,4 +9,3 @@ export declare function pruneExpiredStoreEntries(params: {
     dirMode: number;
     options: FileStorePruneOptions;
 }): Promise<void>;
-//# sourceMappingURL=file-store-prune.d.ts.map

package/dist/file-store-sync-directory.d.ts

@@ -13,4 +13,3 @@ export declare function ensureSyncStoreDirectory(params: {
 }): SyncStoreDirectoryReceipt;
 export declare function assertSyncStoreDirectoryReceipt(receipt: SyncStoreDirectoryReceipt): void;
 export {};
-//# sourceMappingURL=file-store-sync-directory.d.ts.map