@design-edito/tools 0.4.5 → 0.4.11

package/node/cloud-storage/operations/copy-dir/index.js

@@ -1,204 +1,31 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { isFtpClient, isGcsBucket, isS3ClientWithBucket, isSftpClient } from '../../clients/index.js';
+import { copyDir as ftpCopyDir } from '../../../ftps/directory/copy-dir/index.js';
+import { copyDir as sftpCopyDir } from '../../../sftp/directory/copy-dir/index.js';
+import { copyDir as s3CopyDir } from '../../../@aws-s3/storage/directory/copy-dir/index.js';
+import { copyDir as gcsCopyDir } from '../../../@google-cloud/storage/directory/copy-dir/index.js';
+/**
+ * Recursively copies a directory from one path to another.
+ *
+ * The function automatically dispatches to the appropriate implementation based on
+ * the client type (Google Cloud Storage, S3, FTP, or SFTP).
+ *
+ * @param {AnyClient} client              - The cloud storage client instance.
+ * @param {string}   sourcePath           - The source directory path to copy from.
+ * @param {string}   targetPath           - The target directory path to copy to.
+ * @param {GcsCopyDirOptions | S3CopyDirOptions | FtpsCopyDirOptions | SftpCopyDirOptions} [options] - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function copyDir(client, sourcePath, targetPath, options) {
+    if (isGcsBucket(client))
+        return await gcsCopyDir(client, sourcePath, targetPath, options);
+    if (isS3ClientWithBucket(client))
+        return await s3CopyDir(client.client, client.bucketName, sourcePath, targetPath, options);
+    if (isFtpClient(client))
+        return await ftpCopyDir(client, sourcePath, targetPath);
+    if (isSftpClient(client))
+        return await sftpCopyDir(client, sourcePath, targetPath);
+    return Outcome.makeFailure('Invalid client type');
 }
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/cloud-storage/clients/index.ts
-import { Bucket as GCSBucket } from "@google-cloud/storage";
-import { S3Client } from "@aws-sdk/client-s3";
-import { Client as FtpClient } from "basic-ftp";
-import SftpClient from "ssh2-sftp-client";
-var isGcsBucket = (client) => client instanceof GCSBucket;
-var isS3ClientWithBucket = (client) => "bucketName" in client && typeof client.bucketName === "string" && "client" in client && client.client instanceof S3Client;
-var isFtpClient = (client) => client instanceof FtpClient;
-var isSftpClient = (client) => client instanceof SftpClient;
-
-// src/node/ftps/directory/copy-dir/index.ts
-import { PassThrough } from "node:stream";
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/ftps/directory/copy-dir/index.ts
-async function copyDir(ftpClient, sourceDir, targetDir, options) {
-  const {
-    overwrite = false,
-    ensureDir = true
-  } = options ?? {};
-  async function recurse(dir) {
-    const list = await ftpClient.list(dir);
-    for (const entry of list) {
-      const src = dir.endsWith("/") ? dir + entry.name : dir + "/" + entry.name;
-      const rel = src.substring(sourceDir.length + (sourceDir.endsWith("/") ? 0 : 1));
-      const dst = targetDir.endsWith("/") ? targetDir + rel : `${targetDir}/${rel}`;
-      if (entry.isDirectory) {
-        if (ensureDir) await ftpClient.ensureDir(dst);
-        await recurse(src);
-      } else if (entry.isFile) {
-        if (!overwrite) {
-          try {
-            await ftpClient.size(dst);
-            throw new Error(`File already exists at ${dst}.`);
-          } catch {
-          }
-        }
-        if (ensureDir) {
-          const dirPath = dst.substring(0, dst.lastIndexOf("/"));
-          await ftpClient.ensureDir(dirPath);
-        }
-        const pass = new PassThrough();
-        const upload = ftpClient.uploadFrom(pass, dst);
-        await ftpClient.downloadTo(pass, src);
-        await upload;
-      }
-    }
-  }
-  try {
-    if (ensureDir) await ftpClient.ensureDir(targetDir);
-    await recurse(sourceDir);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/sftp/directory/copy-dir/index.ts
-import { PassThrough as PassThrough2 } from "node:stream";
-async function copyDir2(sftp, sourceDir, targetDir, options) {
-  const {
-    overwrite = false,
-    ensureDir = true,
-    ...transferOptions
-  } = options ?? {};
-  async function recurse(dir) {
-    const list = await sftp.list(dir);
-    for (const entry of list) {
-      const src = dir.endsWith("/") ? dir + entry.name : dir + "/" + entry.name;
-      const rel = src.substring(sourceDir.length + (sourceDir.endsWith("/") ? 0 : 1));
-      const dst = targetDir.endsWith("/") ? targetDir + rel : `${targetDir}/${rel}`;
-      if (entry.type === "d") {
-        if (ensureDir) await sftp.mkdir(dst, true);
-        await recurse(src);
-      } else if (entry.type === "-") {
-        if (!overwrite) {
-          const exists = await sftp.exists(dst);
-          if (exists !== false) throw new Error(`File already exists at ${dst}.`);
-        }
-        if (ensureDir) {
-          const dirPath = dst.substring(0, dst.lastIndexOf("/"));
-          await sftp.mkdir(dirPath, true);
-        }
-        const pass = new PassThrough2();
-        const upload = sftp.put(pass, dst, transferOptions);
-        await sftp.get(src, pass, transferOptions);
-        await upload;
-      }
-    }
-  }
-  try {
-    if (ensureDir) await sftp.mkdir(targetDir, true);
-    await recurse(sourceDir);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@aws-s3/storage/directory/copy-dir/index.ts
-import {
-  ListObjectsV2Command,
-  CopyObjectCommand,
-  HeadObjectCommand
-} from "@aws-sdk/client-s3";
-async function copyDir3(client, bucketName, sourceDir, targetDir, options) {
-  const { listObjectsOptions, copyOptions, overwrite = false } = options ?? {};
-  const from = sourceDir.endsWith("/") ? sourceDir : `${sourceDir}/`;
-  const to = targetDir.endsWith("/") ? targetDir : `${targetDir}/`;
-  try {
-    let token;
-    do {
-      const listResp = await client.send(
-        new ListObjectsV2Command({
-          Bucket: bucketName,
-          Prefix: from,
-          ContinuationToken: token,
-          ...listObjectsOptions
-        })
-      );
-      for (const obj of listResp.Contents ?? []) {
-        if (obj.Key === void 0) continue;
-        const rel = obj.Key.substring(from.length);
-        const dest = `${to}${rel}`;
-        if (!overwrite) {
-          try {
-            await client.send(new HeadObjectCommand({ Bucket: bucketName, Key: dest }));
-            continue;
-          } catch (err) {
-            const code = err?.name ?? err?.$metadata?.httpStatusCode;
-            if (code !== "NotFound" && code !== 404) {
-              return makeFailure(unknownToString(err));
-            }
-          }
-        }
-        await client.send(
-          new CopyObjectCommand({
-            Bucket: bucketName,
-            Key: dest,
-            CopySource: `${bucketName}/${obj.Key}`,
-            ...copyOptions
-          })
-        );
-      }
-      token = listResp.IsTruncated === true ? listResp.NextContinuationToken : void 0;
-    } while (token !== void 0);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/directory/copy-dir/index.ts
-async function copyDir4(bucket, sourceDir, targetDir, options) {
-  const { getFileOptions, copyOptions, overwrite = false } = options ?? {};
-  const from = sourceDir.endsWith("/") ? sourceDir : `${sourceDir}/`;
-  const to = targetDir.endsWith("/") ? targetDir : `${targetDir}/`;
-  try {
-    const [files] = await bucket.getFiles({ ...getFileOptions, prefix: from });
-    for (const f of files) {
-      const rel = f.name.substring(from.length);
-      const dest = `${to}${rel}`;
-      if (!overwrite) {
-        const destFile = bucket.file(dest);
-        const [exists] = await destFile.exists();
-        if (exists) {
-          continue;
-        }
-      }
-      await f.copy(dest, copyOptions);
-    }
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/cloud-storage/operations/copy-dir/index.ts
-async function copyDir5(client, sourcePath, targetPath, options) {
-  if (isGcsBucket(client)) return await copyDir4(client, sourcePath, targetPath, options);
-  if (isS3ClientWithBucket(client)) return await copyDir3(client.client, client.bucketName, sourcePath, targetPath, options);
-  if (isFtpClient(client)) return await copyDir(client, sourcePath, targetPath);
-  if (isSftpClient(client)) return await copyDir2(client, sourcePath, targetPath);
-  return makeFailure("Invalid client type");
-}
-export {
-  copyDir5 as copyDir
-};

package/node/cloud-storage/operations/copy-file/index.js

@@ -1,153 +1,31 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { isFtpClient, isGcsBucket, isS3ClientWithBucket, isSftpClient } from '../../clients/index.js';
+import { copy as ftpCopy } from '../../../ftps/file/copy/index.js';
+import { copy as sftpCopy } from '../../../sftp/file/copy/index.js';
+import { copy as s3Copy } from '../../../@aws-s3/storage/file/copy/index.js';
+import { copy as gcsCopy } from '../../../@google-cloud/storage/file/copy/index.js';
+/**
+ * Copies a file from one path to another.
+ *
+ * The function automatically dispatches to the appropriate implementation based on
+ * the client type (Google Cloud Storage, S3, FTP, or SFTP).
+ *
+ * @param {AnyClient} client              - The cloud storage client instance.
+ * @param {string}   sourcePath           - The source file path to copy from.
+ * @param {string}   targetPath           - The target file path to copy to.
+ * @param {GcsCopyOptions | S3CopyOptions | FtpsCopyOptions | SftpCopyOptions} [options] - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function copyFile(client, sourcePath, targetPath, options) {
+    if (isGcsBucket(client))
+        return await gcsCopy(client, sourcePath, targetPath, options);
+    if (isS3ClientWithBucket(client))
+        return await s3Copy(client.client, client.bucketName, sourcePath, targetPath, options);
+    if (isFtpClient(client))
+        return await ftpCopy(client, sourcePath, targetPath, options);
+    if (isSftpClient(client))
+        return await sftpCopy(client, sourcePath, targetPath, options);
+    return Outcome.makeFailure('Invalid client type');
 }
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/cloud-storage/clients/index.ts
-import { Bucket as GCSBucket } from "@google-cloud/storage";
-import { S3Client } from "@aws-sdk/client-s3";
-import { Client as FtpClient } from "basic-ftp";
-import SftpClient from "ssh2-sftp-client";
-var isGcsBucket = (client) => client instanceof GCSBucket;
-var isS3ClientWithBucket = (client) => "bucketName" in client && typeof client.bucketName === "string" && "client" in client && client.client instanceof S3Client;
-var isFtpClient = (client) => client instanceof FtpClient;
-var isSftpClient = (client) => client instanceof SftpClient;
-
-// src/node/ftps/file/copy/index.ts
-import { PassThrough } from "node:stream";
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/ftps/file/copy/index.ts
-async function copy(ftpClient, sourcePath, targetPath, options) {
-  const {
-    overwrite = false,
-    ensureDir = true
-  } = options ?? {};
-  try {
-    if (!overwrite) {
-      try {
-        await ftpClient.size(targetPath);
-        return makeFailure(`File already exists at ${targetPath}.`);
-      } catch {
-      }
-    }
-    if (ensureDir) {
-      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      await ftpClient.ensureDir(dirPath);
-    }
-    const pass = new PassThrough();
-    const uploadPromise = ftpClient.uploadFrom(pass, targetPath);
-    await ftpClient.downloadTo(pass, sourcePath);
-    await uploadPromise;
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/sftp/file/copy/index.ts
-import { PassThrough as PassThrough2 } from "node:stream";
-async function copy2(sftp, sourcePath, targetPath, options) {
-  const {
-    overwrite = false,
-    ensureDir = true,
-    ...transferOptions
-  } = options ?? {};
-  try {
-    if (!overwrite) {
-      const exists = await sftp.exists(targetPath);
-      if (exists !== false) return makeFailure(`File already exists at ${targetPath}.`);
-    }
-    if (ensureDir) {
-      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      await sftp.mkdir(dirPath, true);
-    }
-    const pass = new PassThrough2();
-    const uploadPromise = sftp.put(pass, targetPath, transferOptions);
-    await sftp.get(sourcePath, pass, transferOptions);
-    await uploadPromise;
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@aws-s3/storage/file/copy/index.ts
-import {
-  CopyObjectCommand,
-  HeadObjectCommand
-} from "@aws-sdk/client-s3";
-async function copy3(client, bucketName, sourcePath, targetPath, options) {
-  const {
-    copyOptions,
-    overwrite = false
-  } = options ?? {};
-  try {
-    if (!overwrite) {
-      try {
-        await client.send(new HeadObjectCommand({ Bucket: bucketName, Key: targetPath }));
-        return makeFailure(`Object already exists at ${targetPath}.`);
-      } catch (err) {
-        const notFound = err.$metadata?.httpStatusCode === 404 || err.name === "NotFound";
-        if (!notFound) throw err;
-      }
-    }
-    await client.send(
-      new CopyObjectCommand({
-        Bucket: bucketName,
-        Key: targetPath,
-        CopySource: `${bucketName}/${sourcePath}`,
-        ...copyOptions
-      })
-    );
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/file/copy/index.ts
-async function copy4(bucket, sourcePath, targetPath, options) {
-  const {
-    fileOptions,
-    copyOptions,
-    overwrite = false
-  } = options ?? {};
-  try {
-    const srcFile = bucket.file(sourcePath, fileOptions);
-    const destFile = bucket.file(targetPath, fileOptions);
-    if (!overwrite) {
-      const [destExists] = await destFile.exists();
-      if (destExists) {
-        return makeFailure(`Object already exists at ${targetPath}.`);
-      }
-    }
-    await srcFile.copy(destFile, copyOptions);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/cloud-storage/operations/copy-file/index.ts
-async function copyFile(client, sourcePath, targetPath, options) {
-  if (isGcsBucket(client)) return await copy4(client, sourcePath, targetPath, options);
-  if (isS3ClientWithBucket(client)) return await copy3(client.client, client.bucketName, sourcePath, targetPath, options);
-  if (isFtpClient(client)) return await copy(client, sourcePath, targetPath, options);
-  if (isSftpClient(client)) return await copy2(client, sourcePath, targetPath, options);
-  return makeFailure("Invalid client type");
-}
-export {
-  copyFile
-};

package/node/cloud-storage/operations/download-file/index.js

@@ -1,104 +1,31 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { isFtpClient, isGcsBucket, isS3ClientWithBucket, isSftpClient } from '../../clients/index.js';
+import { download as ftpDownload } from '../../../ftps/file/download/index.js';
+import { download as sftpDownload } from '../../../sftp/file/download/index.js';
+import { download as s3Download } from '../../../@aws-s3/storage/file/download/index.js';
+import { download as gcsDownload } from '../../../@google-cloud/storage/file/download/index.js';
+/**
+ * Downloads a file from cloud storage.
+ *
+ * The function automatically dispatches to the appropriate implementation based on
+ * the client type (Google Cloud Storage, S3, FTP, or SFTP) and streams the file's
+ * content back as a Node `Readable`.
+ *
+ * @param {AnyClient} client               - The cloud storage client instance.
+ * @param {string}   path                  - The path of the file to download.
+ * @param {GcsDownloadOptions | S3DownloadOptions | FtpDownloadOptions | SftpDownloadOptions} [options] - Optional download configuration.
+ * @returns {Promise<Outcome.Either<Readable, string>>}
+ * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function downloadFile(client, path, options) {
+    if (isGcsBucket(client))
+        return await gcsDownload(client, path, options);
+    if (isS3ClientWithBucket(client))
+        return await s3Download(client.client, client.bucketName, path, options);
+    if (isFtpClient(client))
+        return await ftpDownload(client, path, options);
+    if (isSftpClient(client))
+        return await sftpDownload(client, path, options);
+    return Outcome.makeFailure('Invalid client type');
 }
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/cloud-storage/clients/index.ts
-import { Bucket as GCSBucket } from "@google-cloud/storage";
-import { S3Client } from "@aws-sdk/client-s3";
-import { Client as FtpClient } from "basic-ftp";
-import SftpClient from "ssh2-sftp-client";
-var isGcsBucket = (client) => client instanceof GCSBucket;
-var isS3ClientWithBucket = (client) => "bucketName" in client && typeof client.bucketName === "string" && "client" in client && client.client instanceof S3Client;
-var isFtpClient = (client) => client instanceof FtpClient;
-var isSftpClient = (client) => client instanceof SftpClient;
-
-// src/node/ftps/file/download/index.ts
-import { PassThrough } from "node:stream";
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/ftps/file/download/index.ts
-async function download(ftpClient, sourcePath, options) {
-  const { startAt } = options ?? {};
-  const stream = new PassThrough();
-  try {
-    await ftpClient.downloadTo(stream, sourcePath, startAt);
-    return makeSuccess(stream);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/sftp/file/download/index.ts
-async function download2(sftp, sourcePath, options) {
-  try {
-    const stream = sftp.createReadStream(sourcePath, options);
-    stream.on("error", (err) => {
-      throw err;
-    });
-    return makeSuccess(stream);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/@aws-s3/storage/file/download/index.ts
-import {
-  GetObjectCommand
-} from "@aws-sdk/client-s3";
-async function download3(client, bucketName, sourcePath, options) {
-  try {
-    const response = await client.send(
-      new GetObjectCommand({
-        Bucket: bucketName,
-        Key: sourcePath,
-        ...options
-      })
-    );
-    const stream = response.Body;
-    return makeSuccess(stream);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/file/download/index.ts
-async function download4(bucket, sourcePath, options) {
-  const { fileOptions, downloadOptions } = options ?? {};
-  try {
-    const file = bucket.file(sourcePath, fileOptions);
-    const stream = file.createReadStream(downloadOptions);
-    stream.on("error", (err) => {
-      throw err;
-    });
-    return makeSuccess(stream);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/cloud-storage/operations/download-file/index.ts
-async function downloadFile(client, path, options) {
-  if (isGcsBucket(client)) return await download4(client, path, options);
-  if (isS3ClientWithBucket(client)) return await download3(client.client, client.bucketName, path, options);
-  if (isFtpClient(client)) return await download(client, path, options);
-  if (isSftpClient(client)) return await download2(client, path, options);
-  return makeFailure("Invalid client type");
-}
-export {
-  downloadFile
-};

package/node/cloud-storage/operations/exists-file/index.js

@@ -1,104 +1,31 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { isFtpClient, isGcsBucket, isS3ClientWithBucket, isSftpClient } from '../../clients/index.js';
+import { exists as ftpExists } from '../../../ftps/file/exists/index.js';
+import { exists as sftpExists } from '../../../sftp/file/exists/index.js';
+import { exists as s3Exists } from '../../../@aws-s3/storage/file/exists/index.js';
+import { exists as gcsExists } from '../../../@google-cloud/storage/file/exists/index.js';
+/**
+ * Checks whether a file exists in cloud storage.
+ *
+ * The function automatically dispatches to the appropriate implementation based on
+ * the client type (Google Cloud Storage, S3, FTP, or SFTP).
+ *
+ * @param {AnyClient} client              - The cloud storage client instance.
+ * @param {string}   path                 - The path of the file to check.
+ * @param {GcsExistsOptions | S3ExistsOptions} [options] - Optional configuration.
+ * @returns {Promise<Outcome.Either<boolean, string>>}
+ * - On success:  `Outcome.makeSuccess(true)` if the file exists,
+ *                `Outcome.makeSuccess(false)` if it does not.
+ * - On failure:  `Outcome.makeFailure(errStr)` for unexpected errors.
+ */
+export async function existsFile(client, path, options) {
+    if (isGcsBucket(client))
+        return await gcsExists(client, path, options);
+    if (isS3ClientWithBucket(client))
+        return await s3Exists(client.client, client.bucketName, path, options);
+    if (isFtpClient(client))
+        return await ftpExists(client, path);
+    if (isSftpClient(client))
+        return await sftpExists(client, path);
+    return Outcome.makeFailure('Invalid client type');
 }
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/cloud-storage/clients/index.ts
-import { Bucket as GCSBucket } from "@google-cloud/storage";
-import { S3Client } from "@aws-sdk/client-s3";
-import { Client as FtpClient } from "basic-ftp";
-import SftpClient from "ssh2-sftp-client";
-var isGcsBucket = (client) => client instanceof GCSBucket;
-var isS3ClientWithBucket = (client) => "bucketName" in client && typeof client.bucketName === "string" && "client" in client && client.client instanceof S3Client;
-var isFtpClient = (client) => client instanceof FtpClient;
-var isSftpClient = (client) => client instanceof SftpClient;
-
-// src/node/ftps/file/exists/index.ts
-import { FileType } from "basic-ftp";
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/ftps/file/exists/index.ts
-async function exists(ftpClient, sourcePath) {
-  try {
-    const lastSlash = sourcePath.lastIndexOf("/");
-    const parentDir = lastSlash === -1 ? "." : sourcePath.slice(0, lastSlash) || "/";
-    const baseName = lastSlash === -1 ? sourcePath : sourcePath.slice(lastSlash + 1);
-    const list = await ftpClient.list(parentDir);
-    const entry = list.find((e) => e.name === baseName);
-    const isFile = entry !== void 0 ? entry.type === FileType.File || entry.type === FileType.SymbolicLink : false;
-    return makeSuccess(isFile);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/sftp/file/exists/index.ts
-async function exists2(sftp, sourcePath) {
-  try {
-    const res = await sftp.exists(sourcePath);
-    const isFile = res === "-" || res === "l";
-    return makeSuccess(isFile);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@aws-s3/storage/file/exists/index.ts
-import {
-  HeadObjectCommand
-} from "@aws-sdk/client-s3";
-async function exists3(client, bucketName, sourcePath, options) {
-  const { headObjectOptions } = options ?? {};
-  try {
-    await client.send(
-      new HeadObjectCommand({
-        Bucket: bucketName,
-        Key: sourcePath,
-        ...headObjectOptions
-      })
-    );
-    return makeSuccess(true);
-  } catch (err) {
-    const notFound = err.$metadata?.httpStatusCode === 404 || err.name === "NotFound" || err.Code === "NotFound" || err.Code === "NoSuchKey";
-    if (notFound) {
-      return makeSuccess(false);
-    }
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/file/exists/index.ts
-async function exists4(bucket, sourcePath, options) {
-  const { fileOptions, existsOptions } = options ?? {};
-  try {
-    const file = bucket.file(sourcePath, fileOptions);
-    const [exists5] = await file.exists(existsOptions);
-    return makeSuccess(exists5);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/cloud-storage/operations/exists-file/index.ts
-async function existsFile(client, path, options) {
-  if (isGcsBucket(client)) return await exists4(client, path, options);
-  if (isS3ClientWithBucket(client)) return await exists3(client.client, client.bucketName, path, options);
-  if (isFtpClient(client)) return await exists(client, path);
-  if (isSftpClient(client)) return await exists2(client, path);
-  return makeFailure("Invalid client type");
-}
-export {
-  existsFile
-};