@openclaw/fs-safe 0.8.2 → 0.8.4

package/dist/json-durable-queue-retirement.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-durable-queue-retirement.d.ts","sourceRoot":"","sources":["../src/json-durable-queue-retirement.ts"],"names":[],"mappings":"AAgFA,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}

package/dist/json-durable-queue-retirement.js

@@ -1,126 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { syncDirectory } from "./directory-durability.js";
-import { FsSafeError } from "./errors.js";
-import { sameFileIdentityForCleanup } from "./file-identity.js";
-const RETIREMENT_ROOT_NAME = ".fs-safe-retirements";
-const RETIREMENT_ENTRY_NAME = "entry";
-function getErrorCode(error) {
-    return error && typeof error === "object" && "code" in error
-        ? String(error.code)
-        : null;
-}
-async function lstatOrNull(filePath) {
-    try {
-        return await fs.lstat(filePath, { bigint: true });
-    }
-    catch (error) {
-        if (getErrorCode(error) === "ENOENT")
-            return null;
-        throw error;
-    }
-}
-function assertDirectory(identity, label) {
-    if (identity.isSymbolicLink() || !identity.isDirectory()) {
-        throw new FsSafeError("path-mismatch", `${label} is not an owned directory`);
-    }
-}
-async function regularFileIdentity(filePath) {
-    const identity = await lstatOrNull(filePath);
-    if (!identity)
-        return null;
-    if (identity.isSymbolicLink() || !identity.isFile()) {
-        throw new FsSafeError("path-mismatch", "queue retirement path is not a regular file");
-    }
-    return identity;
-}
-function retirementPaths(jsonPath) {
-    const rootPath = path.join(path.dirname(jsonPath), RETIREMENT_ROOT_NAME);
-    const dirPath = path.join(rootPath, path.basename(jsonPath));
-    return { dirPath, entryPath: path.join(dirPath, RETIREMENT_ENTRY_NAME), rootPath };
-}
-async function inspectRetirementRoot(jsonPath) {
-    const rootPath = retirementPaths(jsonPath).rootPath;
-    const root = await lstatOrNull(rootPath);
-    if (!root)
-        return null;
-    assertDirectory(root, "queue retirement root");
-    return rootPath;
-}
-async function ensureRetirementRoot(jsonPath) {
-    const parentPath = path.dirname(jsonPath);
-    const rootPath = retirementPaths(jsonPath).rootPath;
-    await fs.mkdir(rootPath, { mode: 0o700 }).catch((error) => {
-        if (getErrorCode(error) !== "EEXIST")
-            throw error;
-    });
-    const root = await fs.lstat(rootPath, { bigint: true });
-    assertDirectory(root, "queue retirement root");
-    await syncDirectory(parentPath);
-    return rootPath;
-}
-async function removeRetirementRecord(params) {
-    await fs.rmdir(params.dirPath).catch((error) => {
-        if (getErrorCode(error) !== "ENOENT")
-            throw error;
-    });
-    await syncDirectory(params.rootPath);
-}
-export async function recoverDurableQueueRetirement(params) {
-    const rootPath = await inspectRetirementRoot(params.jsonPath);
-    if (!rootPath)
-        return;
-    const { dirPath, entryPath } = retirementPaths(params.jsonPath);
-    const dir = await lstatOrNull(dirPath);
-    if (!dir)
-        return;
-    assertDirectory(dir, "queue retirement record");
-    const names = await fs.readdir(dirPath);
-    if (names.length === 0) {
-        await removeRetirementRecord({ dirPath, rootPath });
-        return;
-    }
-    if (names.length !== 1 || names[0] !== RETIREMENT_ENTRY_NAME) {
-        throw new FsSafeError("path-mismatch", "queue retirement record is ambiguous");
-    }
-    const entry = await regularFileIdentity(entryPath);
-    const processing = await regularFileIdentity(params.processingPath);
-    if (!entry || !processing) {
-        throw new FsSafeError("path-mismatch", "queue retirement ownership is incomplete");
-    }
-    if (!sameFileIdentityForCleanup(entry, processing)) {
-        const pending = await regularFileIdentity(params.jsonPath);
-        if (!pending) {
-            await fs.link(entryPath, params.jsonPath);
-            await syncDirectory(path.dirname(params.jsonPath));
-        }
-        else if (sameFileIdentityForCleanup(pending, entry)) {
-            await syncDirectory(path.dirname(params.jsonPath));
-        }
-        else if (pending.nlink > 1n) {
-            throw new FsSafeError("path-mismatch", "queue replacement identity is ambiguous");
-        }
-    }
-    await fs.unlink(entryPath);
-    await syncDirectory(dirPath);
-    await removeRetirementRecord({ dirPath, rootPath });
-}
-export async function retireDurableQueueSource(params) {
-    await recoverDurableQueueRetirement(params);
-    const rootPath = await ensureRetirementRoot(params.jsonPath);
-    const { dirPath, entryPath } = retirementPaths(params.jsonPath);
-    await fs.mkdir(dirPath, { mode: 0o700 });
-    await syncDirectory(rootPath);
-    try {
-        await fs.rename(params.jsonPath, entryPath);
-    }
-    catch (error) {
-        if (getErrorCode(error) !== "ENOENT")
-            throw error;
-        await removeRetirementRecord({ dirPath, rootPath });
-        return;
-    }
-    await syncDirectory(dirPath);
-    await syncDirectory(path.dirname(params.jsonPath));
-    await recoverDurableQueueRetirement(params);
-}

package/dist/json-durable-queue-transfer-lock.d.ts

@@ -1,2 +0,0 @@
-export declare function withQueueTransferLock<T>(filePath: string, run: () => Promise<T>): Promise<T>;
-//# sourceMappingURL=json-durable-queue-transfer-lock.d.ts.map

package/dist/json-durable-queue-transfer-lock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-durable-queue-transfer-lock.d.ts","sourceRoot":"","sources":["../src/json-durable-queue-transfer-lock.ts"],"names":[],"mappings":"AAKA,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAqBZ"}

package/dist/json-durable-queue-transfer-lock.js

@@ -1,19 +0,0 @@
-import { randomUUID } from "node:crypto";
-import path from "node:path";
-import { sha256Hex } from "./file-identity.js";
-import { withSidecarLock } from "./sidecar-lock.js";
-export async function withQueueTransferLock(filePath, run) {
-    const lockPath = path.join(path.dirname(filePath), `.fs-safe-transfer-${sha256Hex(path.basename(filePath)).slice(0, 32)}.lock`);
-    return await withSidecarLock(filePath, {
-        managerKey: "fs-safe.queue-transfer",
-        lockPath,
-        staleMs: 30_000,
-        staleRecovery: "fail-closed",
-        timeoutMs: 45_000,
-        payload: () => ({
-            ownerToken: randomUUID(),
-            createdAt: new Date().toISOString(),
-        }),
-        retry: { retries: 180, minTimeout: 25, maxTimeout: 250, factor: 1.1 },
-    }, run);
-}

package/dist/mode.d.ts

@@ -1,2 +0,0 @@
-export declare function formatPosixMode(mode: number): string;
-//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/mode.js

@@ -1,3 +0,0 @@
-export function formatPosixMode(mode) {
-    return (mode & 0o777).toString(8).padStart(3, "0");
-}

package/dist/output-sibling.d.ts

@@ -1,8 +0,0 @@
-export declare function writeExternalFileViaSibling<T>(params: {
-    finalPath: string;
-    write: (filePath: string) => Promise<T>;
-    fallbackFileName?: string;
-    maxBytes?: number;
-    mode?: number;
-}): Promise<T>;
-//# sourceMappingURL=output-sibling.d.ts.map

package/dist/output-sibling.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-sibling.d.ts","sourceRoot":"","sources":["../src/output-sibling.ts"],"names":[],"mappings":"AAuBA,wBAAsB,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,CAAC,CAAC,CAYb"}

package/dist/output-sibling.js

@@ -1,30 +0,0 @@
-import { randomUUID } from "node:crypto";
-import path from "node:path";
-import { fitFileNameToPortableComponent, sanitizeUntrustedFileName } from "./filename.js";
-import { writeCallbackSibling } from "./sibling-staged-file.js";
-function safeFallbackFileName(fallbackFileName) {
-    return sanitizeUntrustedFileName(fallbackFileName ?? "output.bin", "output.bin");
-}
-function buildSiblingTempPath(targetPath, fallbackFileName) {
-    const prefix = `.fs-safe-output-${process.pid}-${randomUUID()}-`;
-    const suffix = ".part";
-    const safeTail = fitFileNameToPortableComponent({
-        prefix,
-        fileName: sanitizeUntrustedFileName(path.basename(targetPath), safeFallbackFileName(fallbackFileName)),
-        suffix,
-    });
-    return path.join(path.dirname(targetPath), `${prefix}${safeTail}${suffix}`);
-}
-export async function writeExternalFileViaSibling(params) {
-    const finalPath = path.resolve(params.finalPath);
-    const { result } = await writeCallbackSibling({
-        tempPath: buildSiblingTempPath(finalPath, params.fallbackFileName),
-        write: params.write,
-        resolveFinalPath: () => finalPath,
-        mode: params.mode,
-        maxBytes: params.maxBytes,
-        syncTempFile: true,
-        syncParentDir: true,
-    });
-    return result;
-}

package/dist/read-error.d.ts

@@ -1,2 +0,0 @@
-export declare function throwFsSafeReadError(error: unknown, label: string): never;
-//# sourceMappingURL=read-error.d.ts.map

package/dist/read-error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"read-error.d.ts","sourceRoot":"","sources":["../src/read-error.ts"],"names":[],"mappings":"AAGA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAQzE"}

package/dist/read-error.js

@@ -1,11 +0,0 @@
-import { FsSafeError } from "./errors.js";
-import { isNodeError } from "./path.js";
-export function throwFsSafeReadError(error, label) {
-    if (error instanceof FsSafeError) {
-        throw error;
-    }
-    if (isNodeError(error)) {
-        throw new FsSafeError("read-failed", `${label} target could not be read`, { cause: error });
-    }
-    throw error;
-}

package/dist/short-path.d.ts

@@ -1,2 +0,0 @@
-export declare function shortPath(value: string): string;
-//# sourceMappingURL=short-path.d.ts.map

package/dist/short-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"short-path.d.ts","sourceRoot":"","sources":["../src/short-path.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/C"}

package/dist/short-path.js

@@ -1,7 +0,0 @@
-import os from "node:os";
-import { formatErrorDetail } from "./error-detail.js";
-export function shortPath(value) {
-    const home = os.homedir();
-    const shortened = value.startsWith(home) ? `~${value.slice(home.length)}` : value;
-    return formatErrorDetail(shortened);
-}

package/dist/staged-file.d.ts

@@ -1,10 +0,0 @@
-import type { DirectoryReceipt } from "./directory-durability.js";
-import type { StagedFile } from "./staged-file-types.js";
-export type { PublishedFileReceipt, StagedFile, StagedFileCleanupReceipt, StagedFileFailureDetails, StagedFilePublication, StagedFileReceipt, } from "./staged-file-types.js";
-export declare function stageFileInDirectory(options: {
-    directory: string | DirectoryReceipt;
-    content: string | Uint8Array;
-    /** Published mode; the unpublished stage stays at 0600. Defaults to 0600. */
-    mode?: number;
-}): Promise<StagedFile>;
-//# sourceMappingURL=staged-file.d.ts.map

package/dist/staged-file.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"staged-file.d.ts","sourceRoot":"","sources":["../src/staged-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,YAAY,EACV,oBAAoB,EAAE,UAAU,EAAE,wBAAwB,EAAE,wBAAwB,EACpF,qBAAqB,EAAE,iBAAiB,GACzC,MAAM,wBAAwB,CAAC;AAEhC,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACrC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,UAAU,CAAC,CAUtB"}

package/dist/staged-file.js

@@ -1,15 +0,0 @@
-import { FsSafeError } from "./errors.js";
-import { assertNativeStaging, createNativeStage } from "./native-staged-file.js";
-import { requireNativeBinding } from "./native.js";
-import { openStagedDirectory } from "./staged-directory.js";
-export async function stageFileInDirectory(options) {
-    if (process.platform !== "linux" && process.platform !== "darwin") {
-        throw new FsSafeError("unsupported-platform", "retained-directory staging requires Linux or macOS");
-    }
-    const binding = requireNativeBinding();
-    assertNativeStaging(binding);
-    const input = { kind: "buffer", data: Buffer.from(options.content) };
-    const mode = options.mode ?? 0o600;
-    const parent = openStagedDirectory(options.directory);
-    return await createNativeStage(binding, parent.fd, parent.receipt, input, mode);
-}