windmill-cli 0.0.1

package/esm/deps/jsr.io/@std/fs/1.0.3/empty_dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty_dir.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.3/empty_dir.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,iBAkB/C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,QAmB7C"}

package/esm/deps/jsr.io/@std/fs/1.0.3/empty_dir.js

@@ -0,0 +1,87 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { join } from "../../path/1.0.4/join.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Asynchronously ensures that a directory is empty.
+ *
+ * If the directory does not exist, it is created. The directory itself is not
+ * deleted.
+ *
+ * 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 dir The path of the directory to empty, as a string or URL.
+ *
+ * @returns A void promise that resolves once the directory is empty.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { emptyDir } from "@std/fs/empty-dir";
+ *
+ * await emptyDir("./foo");
+ * ```
+ */
+export async function emptyDir(dir) {
+    try {
+        const items = await Array.fromAsync(dntShim.Deno.readDir(dir));
+        await Promise.all(items.map((item) => {
+            if (item && item.name) {
+                const filepath = join(toPathString(dir), item.name);
+                return dntShim.Deno.remove(filepath, { recursive: true });
+            }
+        }));
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+        // if not exist. then create it
+        await dntShim.Deno.mkdir(dir, { recursive: true });
+    }
+}
+/**
+ * Synchronously ensures that a directory is empty deletes the directory
+ * contents it is not empty.
+ *
+ * If the directory does not exist, it is created. The directory itself is not
+ * deleted.
+ *
+ * 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 dir The path of the directory to empty, as a string or URL.
+ *
+ * @returns A void value that returns once the directory is empty.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { emptyDirSync } from "@std/fs/empty-dir";
+ *
+ * emptyDirSync("./foo");
+ * ```
+ */
+export function emptyDirSync(dir) {
+    try {
+        const items = [...dntShim.Deno.readDirSync(dir)];
+        // If the directory exists, remove all entries inside it.
+        while (items.length) {
+            const item = items.shift();
+            if (item && item.name) {
+                const filepath = join(toPathString(dir), item.name);
+                dntShim.Deno.removeSync(filepath, { recursive: true });
+            }
+        }
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+        // if not exist. then create it
+        dntShim.Deno.mkdirSync(dir, { recursive: true });
+    }
+}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_dir.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Asynchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is created.
+ *
+ * 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A promise that resolves once the directory exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureDir } from "@std/fs/ensure-dir";
+ *
+ * await ensureDir("./bar");
+ * ```
+ */
+export declare function ensureDir(dir: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is created.
+ *
+ * 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the directory exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureDirSync } from "@std/fs/ensure-dir";
+ *
+ * ensureDirSync("./bar");
+ * ```
+ */
+export declare function ensureDirSync(dir: string | URL): void;
+//# sourceMappingURL=ensure_dir.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_dir.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.3/ensure_dir.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,iBAuBhD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,QAuB9C"}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_dir.js

@@ -0,0 +1,102 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { getFileInfoType } from "./_get_file_info_type.js";
+/**
+ * Asynchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is created.
+ *
+ * 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A promise that resolves once the directory exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureDir } from "@std/fs/ensure-dir";
+ *
+ * await ensureDir("./bar");
+ * ```
+ */
+export async function ensureDir(dir) {
+    try {
+        const fileInfo = await dntShim.Deno.stat(dir);
+        throwIfNotDirectory(fileInfo);
+        return;
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+    }
+    // The dir doesn't exist. Create it.
+    // This can be racy. So we catch AlreadyExists and check stat again.
+    try {
+        await dntShim.Deno.mkdir(dir, { recursive: true });
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw err;
+        }
+        const fileInfo = await dntShim.Deno.stat(dir);
+        throwIfNotDirectory(fileInfo);
+    }
+}
+/**
+ * Synchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is created.
+ *
+ * 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the directory exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureDirSync } from "@std/fs/ensure-dir";
+ *
+ * ensureDirSync("./bar");
+ * ```
+ */
+export function ensureDirSync(dir) {
+    try {
+        const fileInfo = dntShim.Deno.statSync(dir);
+        throwIfNotDirectory(fileInfo);
+        return;
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+    }
+    // The dir doesn't exist. Create it.
+    // This can be racy. So we catch AlreadyExists and check stat again.
+    try {
+        dntShim.Deno.mkdirSync(dir, { recursive: true });
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw err;
+        }
+        const fileInfo = dntShim.Deno.statSync(dir);
+        throwIfNotDirectory(fileInfo);
+    }
+}
+function throwIfNotDirectory(fileInfo) {
+    if (!fileInfo.isDirectory) {
+        throw new Error(`Failed to ensure directory exists: expected 'dir', got '${getFileInfoType(fileInfo)}'`);
+    }
+}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_file.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Asynchronously ensures that the file exists.
+ *
+ * If the file already exists, this function does nothing. If the parent
+ * directories for the file do not exist, they are created.
+ *
+ * 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 filePath The path of the file to ensure, as a string or URL.
+ *
+ * @returns A void promise that resolves once the file exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureFile } from "@std/fs/ensure-file";
+ *
+ * await ensureFile("./folder/targetFile.dat");
+ * ```
+ */
+export declare function ensureFile(filePath: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that the file exists.
+ *
+ * If the file already exists, this function does nothing. If the parent
+ * directories for the file do not exist, they are created.
+ *
+ * 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 filePath The path of the file to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the file exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureFileSync } from "@std/fs/ensure-file";
+ *
+ * ensureFileSync("./folder/targetFile.dat");
+ * ```
+ */
+export declare function ensureFileSync(filePath: string | URL): void;
+//# sourceMappingURL=ensure_file.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_file.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.3/ensure_file.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBtE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAsB3D"}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_file.js

@@ -0,0 +1,90 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { dirname } from "../../path/1.0.4/dirname.js";
+import { ensureDir, ensureDirSync } from "./ensure_dir.js";
+import { getFileInfoType } from "./_get_file_info_type.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Asynchronously ensures that the file exists.
+ *
+ * If the file already exists, this function does nothing. If the parent
+ * directories for the file do not exist, they are created.
+ *
+ * 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 filePath The path of the file to ensure, as a string or URL.
+ *
+ * @returns A void promise that resolves once the file exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureFile } from "@std/fs/ensure-file";
+ *
+ * await ensureFile("./folder/targetFile.dat");
+ * ```
+ */
+export async function ensureFile(filePath) {
+    try {
+        // if file exists
+        const stat = await dntShim.Deno.lstat(filePath);
+        if (!stat.isFile) {
+            throw new Error(`Failed to ensure file exists: expected 'file', got '${getFileInfoType(stat)}'`);
+        }
+    }
+    catch (err) {
+        // if file not exists
+        if (err instanceof dntShim.Deno.errors.NotFound) {
+            // ensure dir exists
+            await ensureDir(dirname(toPathString(filePath)));
+            // create file
+            await dntShim.Deno.writeFile(filePath, new Uint8Array());
+            return;
+        }
+        throw err;
+    }
+}
+/**
+ * Synchronously ensures that the file exists.
+ *
+ * If the file already exists, this function does nothing. If the parent
+ * directories for the file do not exist, they are created.
+ *
+ * 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 filePath The path of the file to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the file exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureFileSync } from "@std/fs/ensure-file";
+ *
+ * ensureFileSync("./folder/targetFile.dat");
+ * ```
+ */
+export function ensureFileSync(filePath) {
+    try {
+        // if file exists
+        const stat = dntShim.Deno.lstatSync(filePath);
+        if (!stat.isFile) {
+            throw new Error(`Failed to ensure file exists: expected 'file', got '${getFileInfoType(stat)}'`);
+        }
+    }
+    catch (err) {
+        // if file not exists
+        if (err instanceof dntShim.Deno.errors.NotFound) {
+            // ensure dir exists
+            ensureDirSync(dirname(toPathString(filePath)));
+            // create file
+            dntShim.Deno.writeFileSync(filePath, new Uint8Array());
+            return;
+        }
+        throw err;
+    }
+}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_link.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Asynchronously ensures that the hard link exists.
+ *
+ * If the parent directories for the hard link do not exist, they are created.
+ *
+ * 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 src The source file path as a string or URL. Directory hard links are
+ * not allowed.
+ * @param dest The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the hard link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureLink } from "@std/fs/ensure-link";
+ *
+ * await ensureLink("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export declare function ensureLink(src: string | URL, dest: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that the hard link exists.
+ *
+ * If the parent directories for the hard link do not exist, they are created.
+ *
+ * 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 src The source file path as a string or URL. Directory hard links are
+ * not allowed.
+ * @param dest The destination link path as a string or URL.
+ *
+ * @returns A void value that returns once the hard link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureLinkSync } from "@std/fs/ensure-link";
+ *
+ * ensureLinkSync("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export declare function ensureLinkSync(src: string | URL, dest: string | URL): void;
+//# sourceMappingURL=ensure_link.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_link.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.3/ensure_link.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,iBAKrE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,QAKnE"}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_link.js

@@ -0,0 +1,61 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { dirname } from "../../path/1.0.4/dirname.js";
+import { ensureDir, ensureDirSync } from "./ensure_dir.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Asynchronously ensures that the hard link exists.
+ *
+ * If the parent directories for the hard link do not exist, they are created.
+ *
+ * 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 src The source file path as a string or URL. Directory hard links are
+ * not allowed.
+ * @param dest The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the hard link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureLink } from "@std/fs/ensure-link";
+ *
+ * await ensureLink("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export async function ensureLink(src, dest) {
+    dest = toPathString(dest);
+    await ensureDir(dirname(dest));
+    await dntShim.Deno.link(toPathString(src), dest);
+}
+/**
+ * Synchronously ensures that the hard link exists.
+ *
+ * If the parent directories for the hard link do not exist, they are created.
+ *
+ * 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 src The source file path as a string or URL. Directory hard links are
+ * not allowed.
+ * @param dest The destination link path as a string or URL.
+ *
+ * @returns A void value that returns once the hard link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureLinkSync } from "@std/fs/ensure-link";
+ *
+ * ensureLinkSync("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export function ensureLinkSync(src, dest) {
+    dest = toPathString(dest);
+    ensureDirSync(dirname(dest));
+    dntShim.Deno.linkSync(toPathString(src), dest);
+}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_symlink.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ * @param linkName The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * await ensureSymlink("./folder/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.
+ * @param linkName The destination link path as a string or URL.
+ * @returns A void value that returns once the link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * ensureSymlinkSync("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export declare function ensureSymlinkSync(target: string | URL, linkName: string | URL): void;
+//# sourceMappingURL=ensure_symlink.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.3/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.3/ensure_symlink.ts"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,GAAG,GAAG,EACpB,QAAQ,EAAE,MAAM,GAAG,GAAG,iBA+BvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,GAAG,EACpB,QAAQ,EAAE,MAAM,GAAG,GAAG,QA+BvB"}

package/esm/deps/jsr.io/@std/fs/1.0.3/ensure_symlink.js

@@ -0,0 +1,120 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { dirname } from "../../path/1.0.4/dirname.js";
+import { resolve } from "../../path/1.0.4/resolve.js";
+import { ensureDir, ensureDirSync } from "./ensure_dir.js";
+import { getFileInfoType } from "./_get_file_info_type.js";
+import { toPathString } from "./_to_path_string.js";
+const isWindows = dntShim.Deno.build.os === "windows";
+function resolveSymlinkTarget(target, linkName) {
+    if (typeof target !== "string")
+        return target; // URL is always absolute path
+    if (typeof linkName === "string") {
+        return resolve(dirname(linkName), target);
+    }
+    else {
+        return new URL(target, linkName);
+    }
+}
+function getSymlinkOption(type) {
+    return 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.
+ * @param linkName The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * await ensureSymlink("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export async function ensureSymlink(target, linkName) {
+    const targetRealPath = resolveSymlinkTarget(target, linkName);
+    const srcStatInfo = await dntShim.Deno.lstat(targetRealPath);
+    const srcFilePathType = getFileInfoType(srcStatInfo);
+    await ensureDir(dirname(toPathString(linkName)));
+    const options = getSymlinkOption(srcFilePathType);
+    try {
+        await dntShim.Deno.symlink(target, linkName, options);
+    }
+    catch (error) {
+        if (!(error instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw error;
+        }
+        const linkStatInfo = await dntShim.Deno.lstat(linkName);
+        if (!linkStatInfo.isSymlink) {
+            const type = getFileInfoType(linkStatInfo);
+            throw new dntShim.Deno.errors.AlreadyExists(`A '${type}' already exists at the path: ${linkName}`);
+        }
+        const linkPath = await dntShim.Deno.readLink(linkName);
+        const linkRealPath = resolve(linkPath);
+        if (linkRealPath !== targetRealPath) {
+            throw new dntShim.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.
+ * @param linkName The destination link path as a string or URL.
+ * @returns A void value that returns once the link exists.
+ *
+ * @example Usage
+ * ```ts no-eval
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * ensureSymlinkSync("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export function ensureSymlinkSync(target, linkName) {
+    const targetRealPath = resolveSymlinkTarget(target, linkName);
+    const srcStatInfo = dntShim.Deno.lstatSync(targetRealPath);
+    const srcFilePathType = getFileInfoType(srcStatInfo);
+    ensureDirSync(dirname(toPathString(linkName)));
+    const options = getSymlinkOption(srcFilePathType);
+    try {
+        dntShim.Deno.symlinkSync(target, linkName, options);
+    }
+    catch (error) {
+        if (!(error instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw error;
+        }
+        const linkStatInfo = dntShim.Deno.lstatSync(linkName);
+        if (!linkStatInfo.isSymlink) {
+            const type = getFileInfoType(linkStatInfo);
+            throw new dntShim.Deno.errors.AlreadyExists(`A '${type}' already exists at the path: ${linkName}`);
+        }
+        const linkPath = dntShim.Deno.readLinkSync(linkName);
+        const linkRealPath = resolve(linkPath);
+        if (linkRealPath !== targetRealPath) {
+            throw new dntShim.Deno.errors.AlreadyExists(`A symlink targeting to an undesired path already exists: ${linkName} -> ${linkRealPath}`);
+        }
+    }
+}