@design-edito/tools 0.4.5 → 0.4.6

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

@@ -1,160 +1,30 @@
-// 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 { removeDir as ftpRemoveDir } from '../../../ftps/directory/remove-dir/index.js';
+import { removeDir as sftpRemoveDir } from '../../../sftp/directory/remove-dir/index.js';
+import { removeDir as s3RemoveDir } from '../../../@aws-s3/storage/directory/remove-dir/index.js';
+import { removeDir as gcsRemoveDir } from '../../../@google-cloud/storage/directory/remove-dir/index.js';
+/**
+ * Removes a directory from 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}   sourcePath           - The directory path to remove.
+ * @param {GcsRemoveDirOptions | S3RemoveDirOptions | FtpsRemoveDirOptions | SftpRemoveDirOptions} [options] - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function removeDir(client, sourcePath, options) {
+    if (isGcsBucket(client))
+        return await gcsRemoveDir(client, sourcePath, options);
+    if (isS3ClientWithBucket(client))
+        return await s3RemoveDir(client.client, client.bucketName, sourcePath, options);
+    if (isFtpClient(client))
+        return await ftpRemoveDir(client, sourcePath, options);
+    if (isSftpClient(client))
+        return await sftpRemoveDir(client, sourcePath, 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/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/remove-dir/index.ts
-async function removeDir(ftpClient, directoryPath, options) {
-  const { ignoreMissing = true } = options ?? {};
-  async function recurse(dir) {
-    const list = await ftpClient.list(dir);
-    for (const entry of list) {
-      const full = dir.endsWith("/") ? dir + entry.name : `${dir}/${entry.name}`;
-      if (entry.isDirectory) {
-        await recurse(full);
-      } else if (entry.isFile) {
-        await ftpClient.remove(full);
-      }
-    }
-    await ftpClient.removeDir(dir);
-  }
-  try {
-    await recurse(directoryPath);
-    return makeSuccess(true);
-  } catch (err) {
-    if (ignoreMissing && err.code === 550) {
-      return makeSuccess(true);
-    }
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/sftp/directory/remove-dir/index.ts
-async function removeDir2(sftp, directoryPath, options) {
-  const { ignoreMissing = true } = options ?? {};
-  async function recurse(dir) {
-    const list = await sftp.list(dir);
-    for (const entry of list) {
-      const full = dir.endsWith("/") ? dir + entry.name : `${dir}/${entry.name}`;
-      if (entry.type === "d") {
-        await recurse(full);
-      } else if (entry.type === "-") {
-        await sftp.delete(full);
-      }
-    }
-    await sftp.rmdir(dir);
-  }
-  try {
-    await recurse(directoryPath);
-    return makeSuccess(true);
-  } catch (err) {
-    if (ignoreMissing && (err.code === 2 || err.code === "ENOENT")) {
-      return makeSuccess(true);
-    }
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@aws-s3/storage/directory/remove-dir/index.ts
-import {
-  ListObjectsV2Command,
-  DeleteObjectsCommand
-} from "@aws-sdk/client-s3";
-async function removeDir3(client, bucketName, directoryPath, options) {
-  const {
-    listObjectsOptions,
-    deleteObjectsOptions,
-    ignoreMissing = true
-  } = options ?? {};
-  const prefix = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
-  let continuationToken;
-  let anyFound = false;
-  try {
-    do {
-      const listResp = await client.send(
-        new ListObjectsV2Command({
-          Bucket: bucketName,
-          Prefix: prefix,
-          ContinuationToken: continuationToken,
-          ...listObjectsOptions
-        })
-      );
-      const keys = (listResp.Contents ?? []).map((o) => o.Key).filter((e) => e !== void 0);
-      if (keys.length > 0) {
-        anyFound = true;
-        for (let i = 0; i < keys.length; i += 1e3) {
-          const chunk = keys.slice(i, i + 1e3);
-          await client.send(
-            new DeleteObjectsCommand({
-              Bucket: bucketName,
-              Delete: { Objects: chunk.map((Key) => ({ Key })) },
-              ...deleteObjectsOptions
-            })
-          );
-        }
-      }
-      continuationToken = listResp.IsTruncated === true ? listResp.NextContinuationToken : void 0;
-    } while (continuationToken !== void 0);
-    if (!anyFound && !ignoreMissing) {
-      return makeFailure(`No objects found for prefix "${prefix}".`);
-    }
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/directory/remove-dir/index.ts
-async function removeDir4(bucket, directoryPath, options) {
-  const {
-    deleteOptions,
-    ignoreMissing = true
-  } = options ?? {};
-  const prefix = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
-  try {
-    if (!ignoreMissing) {
-      const [some] = await bucket.getFiles({ prefix, maxResults: 1 });
-      if (some.length === 0) {
-        return makeFailure(`No objects found for prefix "${prefix}".`);
-      }
-    }
-    await bucket.deleteFiles({ prefix, ...deleteOptions });
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/cloud-storage/operations/remove-dir/index.ts
-async function removeDir5(client, sourcePath, options) {
-  if (isGcsBucket(client)) return await removeDir4(client, sourcePath, options);
-  if (isS3ClientWithBucket(client)) return await removeDir3(client.client, client.bucketName, sourcePath, options);
-  if (isFtpClient(client)) return await removeDir(client, sourcePath, options);
-  if (isSftpClient(client)) return await removeDir2(client, sourcePath, options);
-  return makeFailure("Invalid client type");
-}
-export {
-  removeDir5 as removeDir
-};

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

@@ -1,122 +1,30 @@
-// 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 { remove as ftpRemove } from '../../../ftps/file/remove/index.js';
+import { remove as sftpRemove } from '../../../sftp/file/remove/index.js';
+import { remove as s3Remove } from '../../../@aws-s3/storage/file/remove/index.js';
+import { remove as gcsRemove } from '../../../@google-cloud/storage/file/remove/index.js';
+/**
+ * Removes 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).
+ *
+ * @param {AnyClient} client               - The cloud storage client instance.
+ * @param {string}   path                 - The file path to remove.
+ * @param {GcsRemoveOptions | S3RemoveOptions | FtpRemoveOptions | SftpRemoveOptions} [options] - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function removeFile(client, path, options) {
+    if (isGcsBucket(client))
+        return await gcsRemove(client, path, options);
+    if (isS3ClientWithBucket(client))
+        return await s3Remove(client.client, path, client.bucketName, options);
+    if (isFtpClient(client))
+        return await ftpRemove(client, path, options);
+    if (isSftpClient(client))
+        return await sftpRemove(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/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/remove/index.ts
-async function remove(ftpClient, targetPath, options) {
-  const { ignoreMissing = true } = options ?? {};
-  try {
-    let fileExists = true;
-    try {
-      await ftpClient.size(targetPath);
-    } catch {
-      fileExists = false;
-    }
-    if (!fileExists) {
-      if (ignoreMissing) {
-        return makeSuccess(true);
-      }
-      return makeFailure(`File not found at ${targetPath}.`);
-    }
-    await ftpClient.remove(targetPath);
-    return makeSuccess(true);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/sftp/file/remove/index.ts
-async function remove2(sftp, targetPath, options) {
-  const { ignoreMissing = true } = options ?? {};
-  try {
-    const exists = await sftp.exists(targetPath) !== false;
-    if (!exists) {
-      if (ignoreMissing) return makeSuccess(true);
-      return makeFailure(`File not found at ${targetPath}.`);
-    }
-    await sftp.delete(targetPath);
-    return makeSuccess(true);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/@aws-s3/storage/file/remove/index.ts
-import {
-  HeadObjectCommand,
-  DeleteObjectCommand
-} from "@aws-sdk/client-s3";
-async function remove3(s3, bucketName, targetPath, options) {
-  const { ignoreMissing = true } = options ?? {};
-  try {
-    try {
-      await s3.send(new HeadObjectCommand({ Bucket: bucketName, Key: targetPath }));
-    } catch (err) {
-      const code = err?.name ?? err?.Code ?? err?.code;
-      if (code === "NotFound" || code === "NoSuchKey" || code === "NotFoundException") {
-        if (ignoreMissing) return makeSuccess(true);
-        return makeFailure(`File not found at ${targetPath}.`);
-      }
-      return makeFailure(unknownToString(err));
-    }
-    await s3.send(new DeleteObjectCommand({ Bucket: bucketName, Key: targetPath }));
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/file/remove/index.ts
-async function remove4(bucket, targetPath, options) {
-  const { fileOptions, deleteOptions, ignoreMissing = true } = options ?? {};
-  try {
-    const file = bucket.file(targetPath, fileOptions);
-    const [exists] = await file.exists();
-    if (!exists) {
-      if (ignoreMissing) return makeSuccess(true);
-      return makeFailure(`File not found at ${targetPath}.`);
-    }
-    await file.delete(deleteOptions);
-    return makeSuccess(true);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/cloud-storage/operations/remove-file/index.ts
-async function removeFile(client, path, options) {
-  if (isGcsBucket(client)) return await remove4(client, path, options);
-  if (isS3ClientWithBucket(client)) return await remove3(client.client, path, client.bucketName, options);
-  if (isFtpClient(client)) return await remove(client, path, options);
-  if (isSftpClient(client)) return await remove2(client, path, options);
-  return makeFailure("Invalid client type");
-}
-export {
-  removeFile
-};

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

@@ -1,125 +1,30 @@
-// 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 { stat as ftpStat } from '../../../ftps/file/stat/index.js';
+import { stat as sftpStat } from '../../../sftp/file/stat/index.js';
+import { stat as s3Stat } from '../../../@aws-s3/storage/file/stat/index.js';
+import { stat as gcsStat } from '../../../@google-cloud/storage/file/stat/index.js';
+/**
+ * Retrieves metadata for a file 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 file path to stat.
+ * @param {GcsStatOptions | S3StatOptions} [options] - Optional stat configuration.
+ * @returns {Promise<Outcome.Either<GcsStat | S3Stat | FtpStat | SftpStat, string>>}
+ * - On success:  `Outcome.makeSuccess(stat)` containing file metadata.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function statFile(client, path, options) {
+    if (isGcsBucket(client))
+        return await gcsStat(client, path, options);
+    if (isS3ClientWithBucket(client))
+        return await s3Stat(client.client, path, client.bucketName, options);
+    if (isFtpClient(client))
+        return await ftpStat(client, path);
+    if (isSftpClient(client))
+        return await sftpStat(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/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/stat/index.ts
-async function stat(ftp, path) {
-  try {
-    const slash = path.lastIndexOf("/");
-    const dir = slash === -1 ? "." : path.slice(0, slash) || "/";
-    const name = slash === -1 ? path : path.slice(slash + 1);
-    const list = await ftp.list(dir);
-    const entry = list.find((e) => e.name === name && e.isFile);
-    if (entry === void 0) return makeFailure(`File not found: ${path}`);
-    return makeSuccess({
-      size: entry.size,
-      modifiedAt: entry.modifiedAt ?? void 0,
-      permissions: entry.rawModifiedAt.toString(),
-      raw: entry
-    });
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/sftp/file/stat/index.ts
-async function stat2(sftp, path) {
-  try {
-    const info = await sftp.stat(path);
-    return makeSuccess({
-      size: info.size,
-      modifiedAt: new Date(info.modifyTime * 1e3),
-      mode: info.mode,
-      uid: info.uid,
-      gid: info.gid,
-      raw: info
-    });
-  } catch (err) {
-    if (err.code === 2 || err.code === "ENOENT") {
-      return makeFailure(`File not found: ${path}`);
-    }
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@aws-s3/storage/file/stat/index.ts
-import {
-  HeadObjectCommand
-} from "@aws-sdk/client-s3";
-async function stat3(client, bucket, key, options) {
-  const { headObjectOptions } = options ?? {};
-  try {
-    const res = await client.send(
-      new HeadObjectCommand({ Bucket: bucket, Key: key, ...headObjectOptions })
-    );
-    const stat5 = {
-      size: res.ContentLength,
-      modifiedAt: res.LastModified,
-      checksum: res.ETag?.replace(/"/g, ""),
-      contentType: res.ContentType,
-      metadata: res.Metadata,
-      storageClass: res.StorageClass,
-      raw: res
-    };
-    return makeSuccess(stat5);
-  } catch (err) {
-    const notFound = err.$metadata?.httpStatusCode === 404 || err.name === "NotFound";
-    if (notFound) return makeFailure(`Object not found: ${key}`);
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/file/stat/index.ts
-async function stat4(bucket, path, options) {
-  const { fileOptions, getMetadataOptions } = options ?? {};
-  try {
-    const [meta] = await bucket.file(path, fileOptions).getMetadata(getMetadataOptions);
-    const res = {
-      size: meta.size !== void 0 ? Number(meta.size) : void 0,
-      modifiedAt: meta.updated !== void 0 ? new Date(meta.updated) : void 0,
-      checksum: meta.md5Hash ?? meta.crc32c,
-      contentType: meta.contentType,
-      metadata: meta.metadata,
-      storageClass: meta.storageClass,
-      raw: meta
-    };
-    return makeSuccess(res);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/cloud-storage/operations/stat-file/index.ts
-async function statFile(client, path, options) {
-  if (isGcsBucket(client)) return await stat4(client, path, options);
-  if (isS3ClientWithBucket(client)) return await stat3(client.client, path, client.bucketName, options);
-  if (isFtpClient(client)) return await stat(client, path);
-  if (isSftpClient(client)) return await stat2(client, path);
-  return makeFailure("Invalid client type");
-}
-export {
-  statFile
-};

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

@@ -1,163 +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 { upload as ftpUpload } from '../../../ftps/file/upload/index.js';
+import { upload as sftpUpload } from '../../../sftp/file/upload/index.js';
+import { upload as s3Upload } from '../../../@aws-s3/storage/file/upload/index.js';
+import { upload as gcsUpload } from '../../../@google-cloud/storage/file/upload/index.js';
+/**
+ * Uploads a file stream to cloud storage.
+ *
+ * The function automatically dispatches to the appropriate implementation based on
+ * the client type (Google Cloud Storage, S3, FTP, or SFTP).
+ *
+ * @param {Readable} fileStream           - The file content as a stream.
+ * @param {string}   path                 - The path to upload the file to.
+ * @param {AnyClient} client              - The cloud storage client instance.
+ * @param {GcsUploadOptions | S3UploadOptions | FtpUploadOptions | SftpUploadOptions} [options] - Optional upload configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function uploadFile(fileStream, path, client, options) {
+    if (isGcsBucket(client))
+        return await gcsUpload(client, path, fileStream, options);
+    if (isS3ClientWithBucket(client))
+        return await s3Upload(client.client, client.bucketName, path, fileStream, options);
+    if (isFtpClient(client))
+        return await ftpUpload(client, path, fileStream, options);
+    if (isSftpClient(client))
+        return await sftpUpload(client, path, fileStream, 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/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/upload/index.ts
-async function upload(ftpClient, targetPath, fileStream, options) {
-  const {
-    ensureDir = true,
-    overwrite = false
-  } = options ?? {};
-  try {
-    if (ensureDir) {
-      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      await ftpClient.ensureDir(dirPath);
-    }
-    let fileExists = false;
-    try {
-      await ftpClient.size(targetPath);
-      fileExists = true;
-    } catch {
-      fileExists = false;
-    }
-    if (fileExists && !overwrite) {
-      return makeFailure(`File already exists at ${targetPath}.`);
-    }
-    await ftpClient.uploadFrom(fileStream, targetPath, options);
-    return makeSuccess(true);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/sftp/file/upload/index.ts
-async function upload2(sftp, targetPath, fileStream, options) {
-  const {
-    ensureDir = true,
-    overwrite = false
-  } = options ?? {};
-  try {
-    const exists = await sftp.exists(targetPath) !== false;
-    if (exists && !overwrite) return makeFailure(`File already exists at ${targetPath}.`);
-    if (ensureDir) {
-      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      await sftp.mkdir(dirPath, true);
-    }
-    await sftp.put(fileStream, targetPath, options);
-    return makeSuccess(true);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/@aws-s3/storage/file/upload/index.ts
-import {
-  HeadObjectCommand
-} from "@aws-sdk/client-s3";
-import { Upload } from "@aws-sdk/lib-storage";
-async function upload3(s3, bucketName, targetPath, fileStream, options) {
-  const {
-    uploadSettings,
-    fileMetadata,
-    overwrite = false
-  } = options ?? {};
-  if (!overwrite) {
-    try {
-      const headCommand = new HeadObjectCommand({
-        Bucket: bucketName,
-        Key: targetPath
-      });
-      await s3.send(headCommand);
-      return makeFailure(`File already exists at ${targetPath}.`);
-    } catch (err) {
-      const code = err?.name ?? err?.$metadata?.httpStatusCode;
-      if (code !== "NotFound" && code !== 404) {
-        return makeFailure(unknownToString(err));
-      }
-    }
-  }
-  const params = {
-    ...fileMetadata,
-    Bucket: bucketName,
-    Key: targetPath,
-    Body: fileStream
-  };
-  try {
-    const upload5 = new Upload({
-      client: s3,
-      params,
-      ...uploadSettings
-    });
-    await upload5.done();
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-
-// src/node/@google-cloud/storage/file/upload/index.ts
-async function upload4(bucket, targetPath, fileStream, options) {
-  const { fileOptions, saveOptions, overwrite = false } = options ?? {};
-  const file = bucket.file(targetPath, fileOptions);
-  if (!overwrite) {
-    try {
-      const [exists] = await file.exists();
-      if (exists) {
-        return makeFailure(`File already exists at ${targetPath}.`);
-      }
-    } catch (err) {
-      const errStr = unknownToString(err);
-      return makeFailure(errStr);
-    }
-  }
-  try {
-    await new Promise((resolve, reject) => {
-      const writeStream = file.createWriteStream(saveOptions);
-      fileStream.pipe(writeStream);
-      fileStream.on("error", reject);
-      writeStream.on("finish", resolve);
-      writeStream.on("error", reject);
-    });
-    return makeSuccess(true);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-
-// src/node/cloud-storage/operations/upload-file/index.ts
-async function uploadFile(fileStream, path, client, options) {
-  if (isGcsBucket(client)) return await upload4(client, path, fileStream, options);
-  if (isS3ClientWithBucket(client)) return await upload3(client.client, client.bucketName, path, fileStream, options);
-  if (isFtpClient(client)) return await upload(client, path, fileStream, options);
-  if (isSftpClient(client)) return await upload2(client, path, fileStream, options);
-  return makeFailure("Invalid client type");
-}
-export {
-  uploadFile
-};