@effectionx/jsonl-store 0.2.0 → 0.3.0

package/script/deps/jsr.io/@std/fs/1.0.20/ensure_symlink.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Asynchronously ensures that the link exists, and points to a valid file.
+ *
+ * If the parent directories for the link do not exist, they are created. If the
+ * link already exists, and it is not modified, this function does nothing. If
+ * the link already exists, and it does not point to the given target, an error
+ * is thrown.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param target The source file path as a string or URL. If it is a relative path string, it have to be relative to the link path.
+ * @param linkName The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the link exists.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./targetFile.link.dat` exists and points to `./targetFile.dat`
+ * await ensureSymlink("./targetFile.dat", "./targetFile.link.dat");
+ * ```
+ *
+ * @example Ensuring a link in a folder
+ * ```ts ignore
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./folder/targetFile.link.dat` exists and points to `./folder/targetFile.dat`
+ * await ensureSymlink("./targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export declare function ensureSymlink(target: string | URL, linkName: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that the link exists, and points to a valid file.
+ *
+ * If the parent directories for the link do not exist, they are created. If the
+ * link already exists, and it is not modified, this function does nothing. If
+ * the link already exists, and it does not point to the given target, an error
+ * is thrown.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param target The source file path as a string or URL. If it is a relative path string, it have to be relative to the link path.
+ * @param linkName The destination link path as a string or URL.
+ * @returns A void value that returns once the link exists.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./targetFile.link.dat` exists and points to `./targetFile.dat`
+ * ensureSymlinkSync("./targetFile.dat", "./targetFile.link.dat");
+ * ```
+ *
+ * @example Ensuring a link in a folder
+ * ```ts ignore
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./folder/targetFile.link.dat` exists and points to `./folder/targetFile.dat`
+ * ensureSymlinkSync("./targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export declare function ensureSymlinkSync(target: string | URL, linkName: string | URL): void;
+//# sourceMappingURL=ensure_symlink.d.ts.map

package/script/deps/jsr.io/@std/fs/1.0.20/ensure_symlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_symlink.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/ensure_symlink.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,GAAG,GAAG,EACpB,QAAQ,EAAE,MAAM,GAAG,GAAG,iBAyCvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,GAAG,EACpB,QAAQ,EAAE,MAAM,GAAG,GAAG,QAyCvB"}

package/script/deps/jsr.io/@std/fs/1.0.20/ensure_symlink.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSymlink = ensureSymlink;
+exports.ensureSymlinkSync = ensureSymlinkSync;
+// Copyright 2018-2025 the Deno authors. MIT license.
+const dirname_js_1 = require("../../path/1.1.3/dirname.js");
+const resolve_js_1 = require("../../path/1.1.3/resolve.js");
+const ensure_dir_js_1 = require("./ensure_dir.js");
+const _get_file_info_type_js_1 = require("./_get_file_info_type.js");
+const _to_path_string_js_1 = require("./_to_path_string.js");
+const os_js_1 = require("../../internal/1.0.12/os.js");
+function resolveSymlinkTarget(target, linkName) {
+    if (typeof target !== "string")
+        return target; // URL is always absolute path
+    if (typeof linkName === "string") {
+        return (0, resolve_js_1.resolve)((0, dirname_js_1.dirname)(linkName), target);
+    }
+    else {
+        return new URL(target, linkName);
+    }
+}
+function getSymlinkOption(type) {
+    return os_js_1.isWindows ? { type: type === "dir" ? "dir" : "file" } : undefined;
+}
+/**
+ * Asynchronously ensures that the link exists, and points to a valid file.
+ *
+ * If the parent directories for the link do not exist, they are created. If the
+ * link already exists, and it is not modified, this function does nothing. If
+ * the link already exists, and it does not point to the given target, an error
+ * is thrown.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param target The source file path as a string or URL. If it is a relative path string, it have to be relative to the link path.
+ * @param linkName The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the link exists.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./targetFile.link.dat` exists and points to `./targetFile.dat`
+ * await ensureSymlink("./targetFile.dat", "./targetFile.link.dat");
+ * ```
+ *
+ * @example Ensuring a link in a folder
+ * ```ts ignore
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./folder/targetFile.link.dat` exists and points to `./folder/targetFile.dat`
+ * await ensureSymlink("./targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+async function ensureSymlink(target, linkName) {
+    const targetRealPath = resolveSymlinkTarget(target, linkName);
+    let srcStatInfo;
+    try {
+        srcStatInfo = await Deno.lstat(targetRealPath);
+    }
+    catch (error) {
+        if (error instanceof Deno.errors.NotFound) {
+            throw new Deno.errors.NotFound(`Cannot ensure symlink as the target path does not exist: ${targetRealPath}`);
+        }
+        throw error;
+    }
+    const srcFilePathType = (0, _get_file_info_type_js_1.getFileInfoType)(srcStatInfo);
+    await (0, ensure_dir_js_1.ensureDir)((0, dirname_js_1.dirname)((0, _to_path_string_js_1.toPathString)(linkName)));
+    const options = getSymlinkOption(srcFilePathType);
+    try {
+        await Deno.symlink(target, linkName, options);
+    }
+    catch (error) {
+        if (!(error instanceof Deno.errors.AlreadyExists)) {
+            throw error;
+        }
+        const linkStatInfo = await Deno.lstat(linkName);
+        if (!linkStatInfo.isSymlink) {
+            const type = (0, _get_file_info_type_js_1.getFileInfoType)(linkStatInfo);
+            throw new Deno.errors.AlreadyExists(`A '${type}' already exists at the path: ${linkName}`);
+        }
+        const linkPath = await Deno.readLink(linkName);
+        const linkRealPath = (0, resolve_js_1.resolve)(linkPath);
+        if (linkRealPath !== targetRealPath) {
+            throw new Deno.errors.AlreadyExists(`A symlink targeting to an undesired path already exists: ${linkName} -> ${linkRealPath}`);
+        }
+    }
+}
+/**
+ * Synchronously ensures that the link exists, and points to a valid file.
+ *
+ * If the parent directories for the link do not exist, they are created. If the
+ * link already exists, and it is not modified, this function does nothing. If
+ * the link already exists, and it does not point to the given target, an error
+ * is thrown.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param target The source file path as a string or URL. If it is a relative path string, it have to be relative to the link path.
+ * @param linkName The destination link path as a string or URL.
+ * @returns A void value that returns once the link exists.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./targetFile.link.dat` exists and points to `./targetFile.dat`
+ * ensureSymlinkSync("./targetFile.dat", "./targetFile.link.dat");
+ * ```
+ *
+ * @example Ensuring a link in a folder
+ * ```ts ignore
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * // Ensures the link `./folder/targetFile.link.dat` exists and points to `./folder/targetFile.dat`
+ * ensureSymlinkSync("./targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+function ensureSymlinkSync(target, linkName) {
+    const targetRealPath = resolveSymlinkTarget(target, linkName);
+    let srcStatInfo;
+    try {
+        srcStatInfo = Deno.lstatSync(targetRealPath);
+    }
+    catch (error) {
+        if (error instanceof Deno.errors.NotFound) {
+            throw new Deno.errors.NotFound(`Cannot ensure symlink as the target path does not exist: ${targetRealPath}`);
+        }
+        throw error;
+    }
+    const srcFilePathType = (0, _get_file_info_type_js_1.getFileInfoType)(srcStatInfo);
+    (0, ensure_dir_js_1.ensureDirSync)((0, dirname_js_1.dirname)((0, _to_path_string_js_1.toPathString)(linkName)));
+    const options = getSymlinkOption(srcFilePathType);
+    try {
+        Deno.symlinkSync(target, linkName, options);
+    }
+    catch (error) {
+        if (!(error instanceof Deno.errors.AlreadyExists)) {
+            throw error;
+        }
+        const linkStatInfo = Deno.lstatSync(linkName);
+        if (!linkStatInfo.isSymlink) {
+            const type = (0, _get_file_info_type_js_1.getFileInfoType)(linkStatInfo);
+            throw new Deno.errors.AlreadyExists(`A '${type}' already exists at the path: ${linkName}`);
+        }
+        const linkPath = Deno.readLinkSync(linkName);
+        const linkRealPath = (0, resolve_js_1.resolve)(linkPath);
+        if (linkRealPath !== targetRealPath) {
+            throw new Deno.errors.AlreadyExists(`A symlink targeting to an undesired path already exists: ${linkName} -> ${linkRealPath}`);
+        }
+    }
+}

package/script/deps/jsr.io/@std/fs/1.0.20/eol.d.ts

@@ -0,0 +1,52 @@
+export declare const LF: "\n";
+/** End-of-line character for Windows platforms. */
+export declare const CRLF: "\r\n";
+/**
+ * End-of-line character evaluated for the current platform.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { EOL } from "@std/fs/eol";
+ *
+ * EOL; // "\n" on POSIX platforms and "\r\n" on Windows
+ * ```
+ */
+export declare const EOL: "\n" | "\r\n";
+/**
+ * Returns the detected EOL character(s) detected in the input string. If no EOL
+ * character is detected, `null` is returned.
+ *
+ * @param content The input string to detect EOL characters.
+ *
+ * @returns The detected EOL character(s) or `null` if no EOL character is detected.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { detect } from "@std/fs/eol";
+ *
+ * detect("deno\r\nis not\r\nnode"); // "\r\n"
+ * detect("deno\nis not\r\nnode"); // "\r\n"
+ * detect("deno\nis not\nnode"); // "\n"
+ * detect("deno is not node"); // null
+ * ```
+ */
+export declare function detect(content: string): typeof EOL | null;
+/**
+ * Normalize the input string to the targeted EOL.
+ *
+ * @param content The input string to normalize.
+ * @param eol The EOL character(s) to normalize the input string to.
+ *
+ * @returns The input string normalized to the targeted EOL.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { LF, format } from "@std/fs/eol";
+ *
+ * const CRLFinput = "deno\r\nis not\r\nnode";
+ *
+ * format(CRLFinput, LF); // "deno\nis not\nnode"
+ * ```
+ */
+export declare function format(content: string, eol: typeof EOL): string;
+//# sourceMappingURL=eol.d.ts.map

package/script/deps/jsr.io/@std/fs/1.0.20/eol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eol.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/eol.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,EAAE,EAAG,IAAa,CAAC;AAEhC,mDAAmD;AACnD,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AAEpC;;;;;;;;;GASG;AACH,eAAO,MAAM,GAAG,EAAE,IAAI,GAAG,MAEgD,CAAC;AAI1E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,GAAG,IAAI,CAQzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,GAAG,MAAM,CAE/D"}

package/script/deps/jsr.io/@std/fs/1.0.20/eol.js

@@ -0,0 +1,105 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EOL = exports.CRLF = exports.LF = void 0;
+exports.detect = detect;
+exports.format = format;
+/** End-of-line character for POSIX platforms such as macOS and Linux. */
+const dntShim = __importStar(require("../../../../../_dnt.shims.js"));
+exports.LF = "\n";
+/** End-of-line character for Windows platforms. */
+exports.CRLF = "\r\n";
+/**
+ * End-of-line character evaluated for the current platform.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { EOL } from "@std/fs/eol";
+ *
+ * EOL; // "\n" on POSIX platforms and "\r\n" on Windows
+ * ```
+ */
+exports.EOL = 
+// deno-lint-ignore no-explicit-any
+dntShim.dntGlobalThis.Deno?.build.os === "windows" ? exports.CRLF : exports.LF;
+const regDetect = /(?:\r?\n)/g;
+/**
+ * Returns the detected EOL character(s) detected in the input string. If no EOL
+ * character is detected, `null` is returned.
+ *
+ * @param content The input string to detect EOL characters.
+ *
+ * @returns The detected EOL character(s) or `null` if no EOL character is detected.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { detect } from "@std/fs/eol";
+ *
+ * detect("deno\r\nis not\r\nnode"); // "\r\n"
+ * detect("deno\nis not\r\nnode"); // "\r\n"
+ * detect("deno\nis not\nnode"); // "\n"
+ * detect("deno is not node"); // null
+ * ```
+ */
+function detect(content) {
+    const d = content.match(regDetect);
+    if (!d || d.length === 0) {
+        return null;
+    }
+    const hasCRLF = d.some((x) => x === exports.CRLF);
+    return hasCRLF ? exports.CRLF : exports.LF;
+}
+/**
+ * Normalize the input string to the targeted EOL.
+ *
+ * @param content The input string to normalize.
+ * @param eol The EOL character(s) to normalize the input string to.
+ *
+ * @returns The input string normalized to the targeted EOL.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { LF, format } from "@std/fs/eol";
+ *
+ * const CRLFinput = "deno\r\nis not\r\nnode";
+ *
+ * format(CRLFinput, LF); // "deno\nis not\nnode"
+ * ```
+ */
+function format(content, eol) {
+    return content.replace(regDetect, eol);
+}

package/script/deps/jsr.io/@std/fs/1.0.20/exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/exists.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+FG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAqCT"}

package/script/deps/jsr.io/@std/fs/1.0.20/exists.js

@@ -0,0 +1,273 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exists = exists;
+exports.existsSync = existsSync;
+/**
+ * Asynchronously test whether or not the given path exists by checking with
+ * the file system.
+ *
+ * Note: Do not use this function if performing a check before another operation
+ * on that file. Doing so creates a race condition. Instead, perform the actual
+ * file operation directly. This function is not recommended for this use case.
+ * See the recommended method below.
+ *
+ * @see {@link https://en.wikipedia.org/wiki/Time-of-check_to_time-of-use} for
+ * more information on the time-of-check to time-of-use bug.
+ *
+ * Requires `--allow-read` permissions, and in some cases, `--allow-sys`
+ * permissions if `options.isReadable` is `true`.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param path The path to the file or directory, as a string or URL.
+ * @param options Additional options for the check.
+ *
+ * @returns A promise that resolves with `true` if the path exists, `false`
+ * otherwise.
+ *
+ * @example Recommended method
+ * ```ts ignore
+ * // Notice no use of exists
+ * try {
+ *   await Deno.remove("./foo", { recursive: true });
+ * } catch (error) {
+ *   if (!(error instanceof Deno.errors.NotFound)) {
+ *     throw error;
+ *   }
+ *   // Do nothing...
+ * }
+ * ```
+ *
+ * Notice that `exists()` is not used in the above example. Doing so avoids a
+ * possible race condition. See the above note for details.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./exists"); // true
+ * await exists("./does_not_exist"); // false
+ * ```
+ *
+ * @example Check if a path is readable
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./readable", { isReadable: true }); // true
+ * await exists("./not_readable", { isReadable: true }); // false
+ * ```
+ *
+ * @example Check if a path is a directory
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./directory", { isDirectory: true }); // true
+ * await exists("./file", { isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a file
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./file", { isFile: true }); // true
+ * await exists("./directory", { isFile: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable directory
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./readable_directory", { isReadable: true, isDirectory: true }); // true
+ * await exists("./not_readable_directory", { isReadable: true, isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable file
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./readable_file", { isReadable: true, isFile: true }); // true
+ * await exists("./not_readable_file", { isReadable: true, isFile: true }); // false
+ * ```
+ */
+async function exists(path, options) {
+    try {
+        const stat = await Deno.stat(path);
+        if (options &&
+            (options.isReadable || options.isDirectory || options.isFile)) {
+            if (options.isDirectory && options.isFile) {
+                throw new TypeError("ExistsOptions.options.isDirectory and ExistsOptions.options.isFile must not be true together");
+            }
+            if ((options.isDirectory && !stat.isDirectory) ||
+                (options.isFile && !stat.isFile)) {
+                return false;
+            }
+            if (options.isReadable) {
+                return fileIsReadable(stat);
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Deno.errors.NotFound) {
+            return false;
+        }
+        if (error instanceof Deno.errors.PermissionDenied) {
+            if ((await Deno.permissions.query({ name: "read", path })).state ===
+                "granted") {
+                // --allow-read not missing
+                return !options?.isReadable; // PermissionDenied was raised by file system, so the item exists, but can't be read
+            }
+        }
+        throw error;
+    }
+}
+/**
+ * Synchronously test whether or not the given path exists by checking with
+ * the file system.
+ *
+ * Note: Do not use this function if performing a check before another operation
+ * on that file. Doing so creates a race condition. Instead, perform the actual
+ * file operation directly. This function is not recommended for this use case.
+ * See the recommended method below.
+ *
+ * @see {@link https://en.wikipedia.org/wiki/Time-of-check_to_time-of-use} for
+ * more information on the time-of-check to time-of-use bug.
+ *
+ * Requires `--allow-read` permissions, and in some cases, `--allow-sys`
+ * permissions if `options.isReadable` is `true`.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param path The path to the file or directory, as a string or URL.
+ * @param options Additional options for the check.
+ *
+ * @returns `true` if the path exists, `false` otherwise.
+ *
+ * @example Recommended method
+ * ```ts ignore
+ * // Notice no use of exists
+ * try {
+ *   Deno.removeSync("./foo", { recursive: true });
+ * } catch (error) {
+ *   if (!(error instanceof Deno.errors.NotFound)) {
+ *     throw error;
+ *   }
+ *   // Do nothing...
+ * }
+ * ```
+ *
+ * Notice that `existsSync()` is not used in the above example. Doing so avoids
+ * a possible race condition. See the above note for details.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./exists"); // true
+ * existsSync("./does_not_exist"); // false
+ * ```
+ *
+ * @example Check if a path is readable
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./readable", { isReadable: true }); // true
+ * existsSync("./not_readable", { isReadable: true }); // false
+ * ```
+ *
+ * @example Check if a path is a directory
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./directory", { isDirectory: true }); // true
+ * existsSync("./file", { isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a file
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./file", { isFile: true }); // true
+ * existsSync("./directory", { isFile: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable directory
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./readable_directory", { isReadable: true, isDirectory: true }); // true
+ * existsSync("./not_readable_directory", { isReadable: true, isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable file
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./readable_file", { isReadable: true, isFile: true }); // true
+ * existsSync("./not_readable_file", { isReadable: true, isFile: true }); // false
+ * ```
+ */
+function existsSync(path, options) {
+    try {
+        const stat = Deno.statSync(path);
+        if (options &&
+            (options.isReadable || options.isDirectory || options.isFile)) {
+            if (options.isDirectory && options.isFile) {
+                throw new TypeError("ExistsOptions.options.isDirectory and ExistsOptions.options.isFile must not be true together");
+            }
+            if ((options.isDirectory && !stat.isDirectory) ||
+                (options.isFile && !stat.isFile)) {
+                return false;
+            }
+            if (options.isReadable) {
+                return fileIsReadable(stat);
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Deno.errors.NotFound) {
+            return false;
+        }
+        if (error instanceof Deno.errors.PermissionDenied) {
+            if (Deno.permissions.querySync({ name: "read", path }).state === "granted") {
+                // --allow-read not missing
+                return !options?.isReadable; // PermissionDenied was raised by file system, so the item exists, but can't be read
+            }
+        }
+        throw error;
+    }
+}
+function fileIsReadable(stat) {
+    if (stat.mode === null) {
+        return true; // Exclusive on Non-POSIX systems
+    }
+    else if (Deno.uid() === stat.uid) {
+        return (stat.mode & 0o400) === 0o400; // User is owner and can read?
+    }
+    else if (Deno.gid() === stat.gid) {
+        return (stat.mode & 0o040) === 0o040; // User group is owner and can read?
+    }
+    return (stat.mode & 0o004) === 0o004; // Others can read?
+}