@design-edito/tools 0.3.3 → 0.3.5

package/node/@aws-s3/storage/file/stat/index.js

@@ -1,9 +1,31 @@
+// src/node/@aws-s3/storage/file/stat/index.ts
 import {
-  stat
-} from "../../../../../chunks/chunk-AXMAF3J2.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+  HeadObjectCommand
+} from "@aws-sdk/client-s3";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function stat(client, bucket, key, options) {
+  const { headObjectOptions } = options ?? {};
+  try {
+    const res = await client.send(
+      new HeadObjectCommand({ Bucket: bucket, Key: key, ...headObjectOptions })
+    );
+    const stat2 = {
+      size: res.ContentLength,
+      modifiedAt: res.LastModified,
+      checksum: res.ETag?.replace(/"/g, ""),
+      contentType: res.ContentType,
+      metadata: res.Metadata,
+      storageClass: res.StorageClass,
+      raw: res
+    };
+    return Outcome.makeSuccess(stat2);
+  } catch (err) {
+    const notFound = err.$metadata?.httpStatusCode === 404 || err.name === "NotFound";
+    if (notFound) return Outcome.makeFailure(`Object not found: ${key}`);
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   stat
 };

package/node/@aws-s3/storage/file/upload/index.js

@@ -1,9 +1,49 @@
+// src/node/@aws-s3/storage/file/upload/index.ts
 import {
-  upload
-} from "../../../../../chunks/chunk-FM3HGCFL.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+  HeadObjectCommand
+} from "@aws-sdk/client-s3";
+import { Upload } from "@aws-sdk/lib-storage";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function upload(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 Outcome.makeFailure(`File already exists at ${targetPath}.`);
+    } catch (err) {
+      const code = err?.name ?? err?.$metadata?.httpStatusCode;
+      if (code !== "NotFound" && code !== 404) {
+        return Outcome.makeFailure(unknownToString(err));
+      }
+    }
+  }
+  const params = {
+    ...fileMetadata,
+    Bucket: bucketName,
+    Key: targetPath,
+    Body: fileStream
+  };
+  try {
+    const upload2 = new Upload({
+      client: s3,
+      params,
+      ...uploadSettings
+    });
+    await upload2.done();
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   upload
 };

package/node/@aws-s3/storage/index.js

@@ -0,0 +1,2 @@
+export * as directory from './directory/index.js'
+export * as file from './file/index.js'

package/node/@express/@multer/index.js

@@ -1,14 +1,7 @@
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../chunks/chunk-QEKI6WGQ.js";
-import {
-  unknownToString
-} from "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/@express/@multer/index.ts
 import multer from "multer";
+import * as Outcome from "../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../agnostic/errors/unknown-to-string/index.js";
 async function useMulterMiddleware(req, res, options) {
   const { storage, limits, fileFilter } = options;
   const uploader = multer({
@@ -29,16 +22,16 @@ async function useMulterMiddleware(req, res, options) {
     middleware = uploader.any();
   }
   return await new Promise((resolve) => middleware(req, res, (err) => {
-    if (err instanceof multer.MulterError) return resolve(makeFailure({
+    if (err instanceof multer.MulterError) return resolve(Outcome.makeFailure({
       code: err.code,
       message: err.message,
       field: err.field
     }));
     return resolve(
-      err !== void 0 ? makeFailure({
+      err !== void 0 ? Outcome.makeFailure({
         code: "UNKNOWN",
         message: unknownToString(err)
-      }) : makeSuccess(true)
+      }) : Outcome.makeSuccess(true)
     );
   }));
 }

package/node/@express/index.js

@@ -0,0 +1 @@
+export * as multer from './@multer/index.js'

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

@@ -0,0 +1 @@
+export * as storage from './storage/index.js'

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

@@ -1,20 +1,13 @@
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../../../chunks/chunk-QEKI6WGQ.js";
-import {
-  unknownToString
-} from "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/@google-cloud/storage/bucket/get-metadata/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
 async function getMetadata(bucket, options) {
   try {
     const [metadata] = await bucket.getMetadata(options);
-    return makeSuccess(metadata);
+    return Outcome.makeSuccess(metadata);
   } catch (err) {
     const errStr = unknownToString(err);
-    return makeFailure(errStr);
+    return Outcome.makeFailure(errStr);
   }
 }
 export {

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

@@ -0,0 +1 @@
+export * as getMetadata from './get-metadata/index.js'

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

@@ -1,9 +1,29 @@
-import {
-  copyDir
-} from "../../../../../chunks/chunk-IBQQCUYV.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/directory/copy-dir/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function copyDir(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 Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   copyDir
 };

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

@@ -0,0 +1,4 @@
+export * as copyDir from './copy-dir/index.js'
+export * as moveDir from './move-dir/index.js'
+export * as list from './list/index.js'
+export * as removeDir from './remove-dir/index.js'

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

@@ -1,9 +1,21 @@
-import {
-  list
-} from "../../../../../chunks/chunk-BXFRBV67.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/directory/list/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function list(bucket, directoryPath, options) {
+  const { fileOptions } = options ?? {};
+  try {
+    const prefix = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
+    const [files] = await bucket.getFiles({
+      prefix,
+      delimiter: "/",
+      ...fileOptions
+    });
+    const paths = files.map((file) => file.name);
+    return Outcome.makeSuccess(paths);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   list
 };

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

@@ -1,9 +1,29 @@
-import {
-  moveDir
-} from "../../../../../chunks/chunk-NIIAUOBO.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/directory/move-dir/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function moveDir(bucket, sourceDir, targetDir, options) {
+  const { fileOptions, copyOptions, deleteOptions, overwrite = false } = options ?? {};
+  const from = sourceDir.endsWith("/") ? sourceDir : `${sourceDir}/`;
+  const to = targetDir.endsWith("/") ? targetDir : `${targetDir}/`;
+  try {
+    const [files] = await bucket.getFiles({ prefix: from });
+    for (const f of files) {
+      const rel = f.name.substring(from.length);
+      const dest = `${to}${rel}`;
+      const srcFile = bucket.file(f.name, fileOptions);
+      const destFile = bucket.file(dest, fileOptions);
+      if (!overwrite) {
+        const [exists] = await destFile.exists();
+        if (exists) throw new Error(`File already exists at ${dest}.`);
+      }
+      await srcFile.copy(dest, copyOptions);
+      await srcFile.delete(deleteOptions);
+    }
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   moveDir
 };

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

@@ -1,9 +1,25 @@
-import {
-  removeDir
-} from "../../../../../chunks/chunk-ZTPRFEPV.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/directory/remove-dir/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+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 Outcome.makeFailure(`No objects found for prefix "${prefix}".`);
+      }
+    }
+    await bucket.deleteFiles({ prefix, ...deleteOptions });
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   removeDir
 };

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

@@ -1,9 +1,27 @@
-import {
-  copy
-} from "../../../../../chunks/chunk-S6ZFFGWH.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/file/copy/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+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));
+  }
+}
 export {
   copy
 };

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

@@ -1,9 +1,20 @@
-import {
-  download
-} from "../../../../../chunks/chunk-O66PEU62.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/file/download/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+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);
+  }
+}
 export {
   download
 };

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

@@ -1,9 +1,17 @@
-import {
-  exists
-} from "../../../../../chunks/chunk-NEMHJSNM.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/file/exists/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function exists(bucket, sourcePath, options) {
+  const { fileOptions, existsOptions } = options ?? {};
+  try {
+    const file = bucket.file(sourcePath, fileOptions);
+    const [exists2] = await file.exists(existsOptions);
+    return Outcome.makeSuccess(exists2);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
 export {
   exists
 };

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

@@ -1,13 +1,6 @@
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../../../chunks/chunk-QEKI6WGQ.js";
-import {
-  unknownToString
-} from "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/@google-cloud/storage/file/generate-signed-url/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
 async function generateSignedUrl(bucket, sourcePath, action, expiresOn, options) {
   const { fileOptions, getSignedUrlOptions } = options ?? {};
   try {
@@ -17,10 +10,10 @@ async function generateSignedUrl(bucket, sourcePath, action, expiresOn, options)
       expires: expiresOn,
       ...getSignedUrlOptions
     });
-    return makeSuccess(url);
+    return Outcome.makeSuccess(url);
   } catch (err) {
     const errStr = unknownToString(err);
-    return makeFailure(errStr);
+    return Outcome.makeFailure(errStr);
   }
 }
 export {

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

@@ -1,22 +1,15 @@
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../../../chunks/chunk-QEKI6WGQ.js";
-import {
-  unknownToString
-} from "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/@google-cloud/storage/file/get-metadata/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
 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);
+    return Outcome.makeSuccess(metadata);
   } catch (err) {
     const errStr = unknownToString(err);
-    return makeFailure(errStr);
+    return Outcome.makeFailure(errStr);
   }
 }
 export {

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

@@ -1,22 +1,15 @@
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../../../chunks/chunk-QEKI6WGQ.js";
-import {
-  unknownToString
-} from "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/@google-cloud/storage/file/get-permissions/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
 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);
+    return Outcome.makeSuccess(acl);
   } catch (err) {
     const errStr = unknownToString(err);
-    return makeFailure(errStr);
+    return Outcome.makeFailure(errStr);
   }
 }
 export {

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

@@ -0,0 +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 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'

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

@@ -1,9 +1,29 @@
-import {
-  move
-} from "../../../../../chunks/chunk-SBBIQ5UH.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/file/move/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+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));
+  }
+}
 export {
   move
 };

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

@@ -1,9 +1,22 @@
-import {
-  remove
-} from "../../../../../chunks/chunk-66BURDRK.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/file/remove/index.ts
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+async function remove(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 Outcome.makeSuccess(true);
+      return Outcome.makeFailure(`File not found at ${targetPath}.`);
+    }
+    await file.delete(deleteOptions);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
 export {
   remove
 };

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

@@ -1,19 +1,8 @@
-import {
-  download
-} from "../../../../../chunks/chunk-O66PEU62.js";
-import {
-  upload
-} from "../../../../../chunks/chunk-UZ4SWSOZ.js";
-import {
-  remove
-} from "../../../../../chunks/chunk-66BURDRK.js";
-import {
-  makeSuccess
-} from "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/@google-cloud/storage/file/revoke-signed-urls/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { download } from "../download/index.js";
+import { remove } from "../remove/index.js";
+import { upload } from "../upload/index.js";
 async function revokeSignedUrls(bucket, targetPath, options) {
   const { downloadOptions, removeOptions, uploadOptions } = options ?? {};
   const downloadAttempt = await download(bucket, targetPath, downloadOptions);
@@ -23,7 +12,7 @@ async function revokeSignedUrls(bucket, targetPath, options) {
   const downloaded = downloadAttempt.payload;
   const reuploadAttempt = await upload(bucket, targetPath, downloaded, uploadOptions);
   if (!reuploadAttempt.success) return reuploadAttempt;
-  return makeSuccess(true);
+  return Outcome.makeSuccess(true);
 }
 export {
   revokeSignedUrls

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

@@ -1,9 +1,24 @@
-import {
-  stat
-} from "../../../../../chunks/chunk-FSI422YG.js";
-import "../../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/@google-cloud/storage/file/stat/index.ts
+import * as Outcome from "../../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../../agnostic/errors/unknown-to-string/index.js";
+async function stat(bucket, path, options) {
+  const { fileOptions, getMetadataOptions } = options ?? {};
+  try {
+    const [meta] = await bucket.file(path, fileOptions).getMetadata(getMetadataOptions);
+    const res = {
+      size: meta.size ? Number(meta.size) : void 0,
+      modifiedAt: meta.updated ? new Date(meta.updated) : void 0,
+      checksum: meta.md5Hash ?? meta.crc32c,
+      contentType: meta.contentType,
+      metadata: meta.metadata,
+      storageClass: meta.storageClass,
+      raw: meta
+    };
+    return Outcome.makeSuccess(res);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   stat
 };