@design-edito/tools 0.4.5 → 0.4.11

package/node/@google-cloud/storage/directory/remove-dir/index.js

@@ -1,40 +1,36 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// 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/@google-cloud/storage/directory/remove-dir/index.ts
-async function removeDir(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}".`);
-      }
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+/**
+ * Recursively deletes all objects under a directory prefix in a GCS bucket
+ * (including the directory placeholder itself, if present).
+ *
+ * @param {Bucket} bucket - The GCS bucket instance.
+ * @param {string} directoryPath - The “directory” prefix to delete.
+ * @param {RemoveDirOptions} [options] - Optional configuration.
+ * @param {GCSDeleteFileOptions & {force?: boolean}} [options.deleteOptions] - Extra delete parameters.
+ * @param {boolean} [options.ignoreMissing=true] - Whether to ignore an empty/missing prefix.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success: `Outcome.makeSuccess(true)` if deletion succeeds
+ *   (or prefix absent and `ignoreMissing` is true).
+ * - On failure: `Outcome.makeFailure(errStr)` if deletion fails
+ *   or prefix absent and `ignoreMissing` is false.
+ */
+export async function removeDir(bucket, directoryPath, options) {
+    const { deleteOptions, ignoreMissing = true } = options ?? {};
+    const prefix = directoryPath.endsWith('/') ? directoryPath : `${directoryPath}/`;
+    try {
+        // First check if anything exists when ignoreMissing is disabled.
+        if (!ignoreMissing) {
+            const [some] = await bucket.getFiles({ prefix, maxResults: 1 });
+            if (some.length === 0) {
+                return Outcome.makeFailure(`No objects found for prefix "${prefix}".`);
+            }
+        }
+        // deleteFiles removes all matching objects in a single call.
+        await bucket.deleteFiles({ prefix, ...deleteOptions });
+        return Outcome.makeSuccess(true);
+    }
+    catch (err) {
+        return Outcome.makeFailure(unknownToString(err));
     }
-    await bucket.deleteFiles({ prefix, ...deleteOptions });
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
 }
-export {
-  removeDir
-};

package/node/@google-cloud/storage/file/copy/index.js

@@ -1,42 +1,37 @@
-// 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/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/@google-cloud/storage/file/copy/index.ts
-async function copy(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}.`);
-      }
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+/**
+ * Copies a file from one location to another within a Google Cloud Storage bucket.
+ *
+ * If `overwrite` is **false** (default) and the destination object already
+ * exists, the operation aborts.
+ *
+ * @param {Bucket} bucket - The Google Cloud Storage bucket containing the file.
+ * @param {string} sourcePath - The path of the source object to copy.
+ * @param {string} targetPath - The destination path for the copied object.
+ * @param {CopyOptions} [options] - Optional copy configuration.
+ * @param {FileOptions} [options.fileOptions] - Extra options for `bucket.file`.
+ * @param {GCSFileCopyOptions} [options.copyOptions] - Extra options for `file.copy`.
+ * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing destination object.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function copy(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 Outcome.makeFailure(`Object already exists at ${targetPath}.`);
+            }
+        }
+        await srcFile.copy(destFile, copyOptions);
+        return Outcome.makeSuccess(true);
+    }
+    catch (err) {
+        return Outcome.makeFailure(unknownToString(err));
     }
-    await srcFile.copy(destFile, copyOptions);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
 }
-export {
-  copy
-};

package/node/@google-cloud/storage/file/download/index.js

@@ -1,35 +1,28 @@
-// 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}`;
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+/**
+ * Downloads a file from a specified Google Cloud Storage bucket.
+ *
+ * This function downloads a file from the given bucket and path, returning the file content as a `Readable`.
+ * The download process can be customized using optional `fileOptions` and `downloadOptions`.
+ *
+ * @param {Bucket} bucket - The Google Cloud Storage bucket object from which to download the file.
+ * @param {string} sourcePath - The path of the file to be downloaded in the bucket.
+ * @param {DownloadOptions} [options] - Optional configuration options for the download.
+ * @returns {Promise<Outcome.Either<Readable, string>>} A promise that resolves to an `Outcome.Either`.
+ * - On success: `Outcome.makeSuccess(stream)` containing the downloaded file's content as a `Readable`.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the download fails.
+ */
+export async function download(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 Outcome.makeSuccess(stream);
+    }
+    catch (err) {
+        const errStr = unknownToString(err);
+        return Outcome.makeFailure(errStr);
+    }
 }
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/@google-cloud/storage/file/download/index.ts
-async function download(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);
-  }
-}
-export {
-  download
-};

package/node/@google-cloud/storage/file/exists/index.js

@@ -1,32 +1,26 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+/**
+ * Checks if a file exists in the specified bucket.
+ *
+ * This function verifies whether a file at the given `sourcePath` exists in the bucket. It can be configured with options to customize the behavior of the check.
+ *
+ * @param {Bucket} bucket - The GCS bucket to check for the file existence.
+ * @param {string} sourcePath - The path of the file to check within the bucket.
+ * @param {ExistsOptions} [options] - Optional configuration for the file existence check.
+ * @param {FileOptions} [options.fileOptions] - Additional options for the file, such as custom metadata or ACL settings.
+ * @param {ExistsOptions} [options.existsOptions] - Options for controlling the `exists` method (if any).
+ * @returns {Promise<Outcome.Either<boolean, string>>} - Returns either a success with `true` or `false` indicating whether the file exists, or a failure with an error message.
+ */
+export async function exists(bucket, sourcePath, options) {
+    const { fileOptions, existsOptions } = options ?? {};
+    try {
+        const file = bucket.file(sourcePath, fileOptions);
+        const [exists] = await file.exists(existsOptions);
+        return Outcome.makeSuccess(exists);
+    }
+    catch (err) {
+        const errStr = unknownToString(err);
+        return Outcome.makeFailure(errStr);
+    }
 }
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// 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/@google-cloud/storage/file/exists/index.ts
-async function exists(bucket, sourcePath, options) {
-  const { fileOptions, existsOptions } = options ?? {};
-  try {
-    const file = bucket.file(sourcePath, fileOptions);
-    const [exists2] = await file.exists(existsOptions);
-    return makeSuccess(exists2);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-export {
-  exists
-};

package/node/@google-cloud/storage/file/generate-signed-url/index.js

@@ -1,36 +1,34 @@
-// 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}`;
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+/**
+ * Generates a signed URL that provides temporary access to a file in Google Cloud Storage.
+ *
+ * This function generates a signed URL for the file located at `sourcePath` in the given bucket. The signed URL
+ * allows users to perform an action on the file (e.g., `read`, `write`) for a limited time as defined by the `expiresOn` parameter.
+ * The behavior can be customized using optional `fileOptions` and `getSignedUrlOptions`.
+ *
+ * @param {Bucket} bucket - The Google Cloud Storage bucket object containing the file.
+ * @param {string} sourcePath - The path of the file for which the signed URL is being generated.
+ * @param {GetSignedUrlConfig['action']} action - The action allowed by the signed URL (e.g., 'read', 'write', 'delete').
+ * @param {GetSignedUrlConfig['expires']} expiresOn - The expiration time of the signed URL, after which it is no longer valid.
+ * @param {GenerateSignedUrlOptions} [options] - Optional configuration options for generating the signed URL.
+ * @returns {Promise<Outcome.Either<string, string>>} A promise that resolves to an `Outcome.Either`.
+ * - On success: `Outcome.makeSuccess(url)` containing the generated signed URL.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the signed URL generation fails.
+ */
+export async function generateSignedUrl(bucket, sourcePath, action, expiresOn, options) {
+    const { fileOptions, getSignedUrlOptions } = options ?? {};
+    try {
+        const file = bucket.file(sourcePath, fileOptions);
+        const [url] = await file.getSignedUrl({
+            action,
+            expires: expiresOn,
+            ...getSignedUrlOptions
+        });
+        return Outcome.makeSuccess(url);
+    }
+    catch (err) {
+        const errStr = unknownToString(err);
+        return Outcome.makeFailure(errStr);
+    }
 }
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/@google-cloud/storage/file/generate-signed-url/index.ts
-async function generateSignedUrl(bucket, sourcePath, action, expiresOn, options) {
-  const { fileOptions, getSignedUrlOptions } = options ?? {};
-  try {
-    const file = bucket.file(sourcePath, fileOptions);
-    const [url] = await file.getSignedUrl({
-      action,
-      expires: expiresOn,
-      ...getSignedUrlOptions
-    });
-    return makeSuccess(url);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-export {
-  generateSignedUrl
-};

package/node/@google-cloud/storage/file/get-metadata/index.js

@@ -1,32 +1,29 @@
-// 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}`;
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+/**
+ * Retrieves the metadata of a file from a specified Google Cloud Storage bucket.
+ *
+ * This function fetches the metadata for a file located at `sourcePath` in the given bucket.
+ * It can be customized using optional `fileOptions` and `getFileMetadataOptions` to control the retrieval behavior.
+ *
+ * @param {Bucket} bucket - The Google Cloud Storage bucket object containing the file whose metadata is being retrieved.
+ * @param {string} sourcePath - The path of the file whose metadata is to be fetched.
+ * @param {GetMetadataOptions} [options] - Optional configuration options for the file metadata retrieval.
+ * @returns {Promise<Outcome.Either<FileMetadata, string>>} A promise that resolves to an `Outcome.Either`.
+ * - On success: `Outcome.makeSuccess(metadata)` containing the file's metadata.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the metadata retrieval fails.
+ *
+ * @throws {Error} Throws an error if the metadata retrieval operation fails (e.g., file not found, insufficient permissions, etc.).
+ */
+export async function getMetadata(bucket, sourcePath, options) {
+    const { fileOptions, getFileMetadataOptions } = options ?? {};
+    try {
+        const file = bucket.file(sourcePath, fileOptions);
+        const [metadata] = await file.getMetadata(getFileMetadataOptions);
+        return Outcome.makeSuccess(metadata);
+    }
+    catch (err) {
+        const errStr = unknownToString(err);
+        return Outcome.makeFailure(errStr);
+    }
 }
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/@google-cloud/storage/file/get-metadata/index.ts
-async function getMetadata(bucket, sourcePath, options) {
-  const { fileOptions, getFileMetadataOptions } = options ?? {};
-  try {
-    const file = bucket.file(sourcePath, fileOptions);
-    const [metadata] = await file.getMetadata(getFileMetadataOptions);
-    return makeSuccess(metadata);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-export {
-  getMetadata
-};

package/node/@google-cloud/storage/file/get-permissions/index.js

@@ -1,32 +1,26 @@
-// 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}`;
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+/**
+ * Retrieves the access control list (ACL) for a file in Google Cloud Storage.
+ *
+ * This function fetches the ACL settings of a given file to determine the permissions assigned to different users or roles.
+ *
+ * @param {Bucket} bucket - The Google Cloud Storage bucket containing the file.
+ * @param {string} sourcePath - The path of the file whose permissions need to be retrieved.
+ * @param {GetPermissionsOptions} [options] - Optional configuration options for the file and ACL retrieval.
+ * @returns {Promise<Outcome.Either<any, string>>} A promise that resolves to an `Outcome.Either`.
+ * - On success: `Outcome.makeSuccess(acl)` containing the file's ACL settings.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the ACL retrieval fails.
+ */
+export async function getPermissions(bucket, sourcePath, options) {
+    const { fileOptions, getAclOptions } = options ?? {};
+    try {
+        const file = bucket.file(sourcePath, fileOptions);
+        const [acl] = await file.acl.get(getAclOptions);
+        return Outcome.makeSuccess(acl);
+    }
+    catch (err) {
+        const errStr = unknownToString(err);
+        return Outcome.makeFailure(errStr);
+    }
 }
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/@google-cloud/storage/file/get-permissions/index.ts
-async function getPermissions(bucket, sourcePath, options) {
-  const { fileOptions, getAclOptions } = options ?? {};
-  try {
-    const file = bucket.file(sourcePath, fileOptions);
-    const [acl] = await file.acl.get(getAclOptions);
-    return makeSuccess(acl);
-  } catch (err) {
-    const errStr = unknownToString(err);
-    return makeFailure(errStr);
-  }
-}
-export {
-  getPermissions
-};

package/node/@google-cloud/storage/file/index.d.ts

@@ -1,12 +1,12 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
-export * as generateSignedUrl from './generate-signed-url/index.js'
 export * as getMetadata from './get-metadata/index.js'
+export * as generateSignedUrl from './generate-signed-url/index.js'
+export * as getPermissions from './get-permissions/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as revokeSignedUrls from './revoke-signed-urls/index.js'
+export * as stat from './stat/index.js'
 export * as updateMetadata from './update-metadata/index.js'
 export * as upload from './upload/index.js'
-export * as stat from './stat/index.js'
-export * as getPermissions from './get-permissions/index.js'

package/node/@google-cloud/storage/file/index.js

@@ -1,12 +1,12 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
-export * as generateSignedUrl from './generate-signed-url/index.js'
 export * as getMetadata from './get-metadata/index.js'
+export * as generateSignedUrl from './generate-signed-url/index.js'
+export * as getPermissions from './get-permissions/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as revokeSignedUrls from './revoke-signed-urls/index.js'
+export * as stat from './stat/index.js'
 export * as updateMetadata from './update-metadata/index.js'
 export * as upload from './upload/index.js'
-export * as stat from './stat/index.js'
-export * as getPermissions from './get-permissions/index.js'

package/node/@google-cloud/storage/file/move/index.js

@@ -1,44 +1,40 @@
-// 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/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/node/@google-cloud/storage/file/move/index.ts
-async function move(bucket, sourcePath, targetPath, options) {
-  const {
-    fileOptions,
-    copyOptions,
-    deleteOptions,
-    overwrite = false
-  } = options ?? {};
-  try {
-    const srcFile = bucket.file(sourcePath, fileOptions);
-    const destFile = bucket.file(targetPath, fileOptions);
-    if (!overwrite) {
-      const [exists] = await destFile.exists();
-      if (exists) {
-        return makeFailure(`Object already exists at ${targetPath}.`);
-      }
+import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
+/**
+ * Moves a file from one location to another within a Google Cloud Storage bucket.
+ *
+ * The function copies the object at `sourcePath` to `targetPath` and, on
+ * successful copy, deletes the original. If `overwrite` is **false** and the
+ * destination already exists, the operation aborts.
+ *
+ * @param {Bucket}   bucket      - The Google Cloud Storage bucket.
+ * @param {string}   sourcePath  - The path of the source object.
+ * @param {string}   targetPath  - The destination path.
+ * @param {MoveOptions} [options] - Optional configuration.
+ * @param {FileOptions}   [options.fileOptions]   - Options for file handles.
+ * @param {CopyOptions}   [options.copyOptions]   - Extra options for `copy`.
+ * @param {GCSDeleteFileOptions} [options.deleteOptions] - Extra options for `delete`.
+ * @param {boolean}      [options.overwrite=false] - Whether to overwrite an existing destination.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - Success: `Outcome.makeSuccess(true)` if the move succeeds.
+ * - Failure: `Outcome.makeFailure(errStr)` if the move fails.
+ */
+export async function move(bucket, sourcePath, targetPath, options) {
+    const { fileOptions, copyOptions, deleteOptions, overwrite = false } = options ?? {};
+    try {
+        const srcFile = bucket.file(sourcePath, fileOptions);
+        const destFile = bucket.file(targetPath, fileOptions);
+        if (!overwrite) {
+            const [exists] = await destFile.exists();
+            if (exists) {
+                return Outcome.makeFailure(`Object already exists at ${targetPath}.`);
+            }
+        }
+        await srcFile.copy(destFile, copyOptions);
+        await srcFile.delete(deleteOptions);
+        return Outcome.makeSuccess(true);
+    }
+    catch (err) {
+        return Outcome.makeFailure(unknownToString(err));
     }
-    await srcFile.copy(destFile, copyOptions);
-    await srcFile.delete(deleteOptions);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
 }
-export {
-  move
-};