@openclaw/fs-safe 0.13.1 → 0.15.0

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

@@ -0,0 +1,205 @@
+import fs from "node:fs";
+import { defaultSyncShouldReclaim, syncLockTimeout } from "./file-lock-sync-admission.js";
+import { parseSidecarLockSnapshot, readSidecarLockRawSnapshotSync, removeSidecarLockIfUnchangedSync, } from "./sidecar-lock-reclaim.js";
+/** Handle one exclusive-create conflict without surrendering canonical admission. */
+export function handleSyncStaleAdmission(params) {
+    const holderChanged = {};
+    const assertUnheld = () => {
+        if (!params.hasToken()) {
+            throw syncLockTimeout(params.lockPath, params.normalizedTargetPath);
+        }
+        if (params.currentHeld())
+            throw holderChanged;
+    };
+    const retryHolderChange = (error) => {
+        if (error !== holderChanged)
+            return false;
+        params.waitForRetry();
+        return true;
+    };
+    let rawSnapshot;
+    let lockFileOpenDenied = false;
+    try {
+        rawSnapshot = readSidecarLockRawSnapshotSync(params.lockPath, {
+            rejectNonFile: true,
+            onOpenFailure: (error) => {
+                lockFileOpenDenied = true;
+                assertUnheld();
+            },
+        });
+        assertUnheld();
+    }
+    catch (error) {
+        if (retryHolderChange(error))
+            return;
+        try {
+            assertUnheld();
+        }
+        catch (boundaryError) {
+            if (retryHolderChange(boundaryError))
+                return;
+            throw boundaryError;
+        }
+        if (lockFileOpenDenied && params.retryLockFileDenial(error))
+            return;
+        throw error;
+    }
+    const stale = params.staleOptions;
+    try {
+        if (!stale.shouldReclaimObserved) {
+            assertUnheld();
+            stale.shouldReclaim = params.options.shouldReclaim;
+            stale.shouldReclaimObserved = true;
+            assertUnheld();
+        }
+        if (!stale.shouldRemoveObserved) {
+            assertUnheld();
+            stale.shouldRemove = params.options.shouldRemoveStaleLock;
+            stale.shouldRemoveObserved = true;
+            assertUnheld();
+        }
+    }
+    catch (error) {
+        if (retryHolderChange(error))
+            return;
+        try {
+            assertUnheld();
+        }
+        catch (boundaryError) {
+            if (retryHolderChange(boundaryError))
+                return;
+            throw boundaryError;
+        }
+        throw error;
+    }
+    const guardedParser = params.parsePayload && ((raw) => {
+        assertUnheld();
+        try {
+            return Reflect.apply(params.parsePayload, undefined, [raw]);
+        }
+        finally {
+            assertUnheld();
+        }
+    });
+    let snapshot;
+    try {
+        snapshot = parseSidecarLockSnapshot(rawSnapshot, guardedParser);
+        assertUnheld();
+    }
+    catch (error) {
+        if (retryHolderChange(error))
+            return;
+        throw error;
+    }
+    if (!snapshot) {
+        params.waitForRetry();
+        return;
+    }
+    const nowMs = Date.now();
+    let reclaim;
+    try {
+        assertUnheld();
+        try {
+            reclaim = stale.shouldReclaim
+                ? Reflect.apply(stale.shouldReclaim, params.options, [{
+                        lockPath: params.lockPath,
+                        normalizedTargetPath: params.normalizedTargetPath,
+                        payload: snapshot.payload,
+                        staleMs: params.staleMs,
+                        nowMs,
+                        heldByThisProcess: false,
+                    }])
+                : defaultSyncShouldReclaim(snapshot, params.staleMs, nowMs);
+        }
+        finally {
+            assertUnheld();
+        }
+    }
+    catch (error) {
+        if (retryHolderChange(error))
+            return;
+        throw error;
+    }
+    if (!reclaim) {
+        params.waitForRetry();
+        return;
+    }
+    if (params.staleRecovery === "remove-if-unchanged" &&
+        snapshot.raw !== undefined &&
+        stale.shouldRemove !== undefined) {
+        let approved;
+        try {
+            assertUnheld();
+            try {
+                approved = Reflect.apply(stale.shouldRemove, params.options, [{
+                        lockPath: params.lockPath,
+                        normalizedTargetPath: params.normalizedTargetPath,
+                        raw: snapshot.raw,
+                        payload: snapshot.payload,
+                    }]);
+            }
+            finally {
+                assertUnheld();
+            }
+        }
+        catch (error) {
+            if (retryHolderChange(error))
+                return;
+            throw error;
+        }
+        if (!approved) {
+            throw Object.assign(new Error(`file lock stale for ${params.normalizedTargetPath}`), {
+                code: "file_lock_stale",
+                lockPath: params.lockPath,
+                normalizedTargetPath: params.normalizedTargetPath,
+            });
+        }
+        try {
+            fs.mkdirSync(params.reclaimGuardPath);
+        }
+        catch (error) {
+            try {
+                assertUnheld();
+            }
+            catch (boundaryError) {
+                if (retryHolderChange(boundaryError))
+                    return;
+                throw boundaryError;
+            }
+            if (error.code === "EEXIST") {
+                params.waitForRetry();
+                return;
+            }
+            throw error;
+        }
+        let holderInterrupted = false;
+        try {
+            assertUnheld();
+            if (removeSidecarLockIfUnchangedSync(params.lockPath, snapshot, assertUnheld))
+                return;
+        }
+        catch (error) {
+            if (error === holderChanged)
+                holderInterrupted = true;
+            else
+                throw error;
+        }
+        finally {
+            try {
+                fs.rmdirSync(params.reclaimGuardPath);
+            }
+            catch {
+                // A surviving reclaim guard fails closed.
+            }
+        }
+        if (holderInterrupted) {
+            params.waitForRetry();
+            return;
+        }
+    }
+    throw Object.assign(new Error(`file lock stale for ${params.normalizedTargetPath}`), {
+        code: "file_lock_stale",
+        lockPath: params.lockPath,
+        normalizedTargetPath: params.normalizedTargetPath,
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"file-lock-sync.d.ts","sourceRoot":"","sources":["../src/file-lock-sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EASL,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAWnC,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAQjC,MAAM,MAAM,0BAA0B,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,KAAK,CAAC;KAC1B,KAAK,OAAO,CAAC;IACd,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,OAAO,CAAC;IACxE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAC3D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,IAAI,OAAO,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;IAChB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AA8JF,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,GAC5C,kBAAkB,CA4NpB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,EAC7C,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAOH"}
+{"version":3,"file":"file-lock-sync.d.ts","sourceRoot":"","sources":["../src/file-lock-sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAML,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAqBjC,MAAM,MAAM,0BAA0B,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,KAAK,CAAC;KAC1B,KAAK,OAAO,CAAC;IACd,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,OAAO,CAAC;IACxE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAC3D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,IAAI,OAAO,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;IAChB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAyFF,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,GAC5C,kBAAkB,CAyRpB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,EAC7C,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAQH"}