@design-edito/tools 0.1.71 → 0.1.73

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

@@ -1,28 +1,22 @@
 import { Readable } from 'node:stream';
-import { S3 } from 'aws-sdk';
+import { S3Client, PutObjectCommandInput } from '@aws-sdk/client-s3';
+import { Upload } from '@aws-sdk/lib-storage';
 import { Outcome } from '../../../../../agnostic/misc/outcome';
 export type UploadOptions = {
-    fileMetadata?: S3.Types.PutObjectRequest;
-    uploadSettings?: S3.ManagedUpload.ManagedUploadOptions;
+    fileMetadata?: Partial<PutObjectCommandInput>;
+    uploadSettings?: ConstructorParameters<typeof Upload>[0];
     overwrite?: boolean;
 };
 /**
- * Uploads a file stream to a specified Amazon S3 bucket.
+ * Uploads a file stream to a specified Amazon S3 bucket using AWS SDK v3.
  *
- * This function uploads the provided file stream to the specified bucket at the given target path.
- * The upload can be customized using optional `fileMetadata` and `uploadSettings`.
- * If the `overwrite` option is false and a file already exists at the target path, the upload is aborted.
+ * If `overwrite` is false and the target file exists, upload is aborted.
  *
- * @param {Readable} fileStream - The file content to be uploaded.
- * @param {string} targetPath - The target path where the file will be saved in the bucket.
- * @param {string} bucketName - The name of the S3 bucket.
- * @param {S3} s3 - The AWS S3 client instance.
- * @param {UploadOptions} [options] - Optional options to configure the upload process.
- * @param {S3.Types.PutObjectRequest} [options.fileMetadata] - Additional metadata for the file being uploaded.
- * @param {S3.ManagedUpload.ManagedUploadOptions} [options.uploadSettings] - Settings for the managed upload process.
- * @param {boolean} [options.overwrite] - If false and a file exists at the target path, the upload is aborted.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
- * - On success: Outcome.makeSuccess(true) indicating the upload was successful.
- * - On failure: Outcome.makeFailure(errStr) with an error message if the upload fails.
+ * @param {S3Client} s3 - The AWS S3 v3 client instance.
+ * @param {string} bucketName - The S3 bucket name.
+ * @param {string} targetPath - The key to upload the file to.
+ * @param {Readable} fileStream - The file content as a stream.
+ * @param {UploadOptions} [options] - Optional configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
  */
-export declare function upload(fileStream: Readable, targetPath: string, bucketName: string, s3: S3, options?: UploadOptions): Promise<Outcome.Either<true, string>>;
+export declare function upload(s3: S3Client, bucketName: string, targetPath: string, fileStream: Readable, options?: UploadOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +1,9 @@
 import {
   upload
-} from "../../../../../chunks/chunk-O7UEQQ6H.js";
+} from "../../../../../chunks/chunk-FD5WR2A5.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   upload
 };

package/node/@aws-s3/storage/index.d.ts

@@ -1,2 +1,3 @@
+import * as Directory from './directory';
 import * as File from './file';
-export { File };
+export { Directory, File };

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

@@ -1,12 +1,25 @@
-import "../../../chunks/chunk-2H5RIOJO.js";
+import "../../../chunks/chunk-MAOVZE34.js";
+import {
+  directory_exports
+} from "../../../chunks/chunk-H5O26IRG.js";
 import {
   file_exports
-} from "../../../chunks/chunk-BWXVJB4I.js";
-import "../../../chunks/chunk-26QQ56SS.js";
-import "../../../chunks/chunk-O7UEQQ6H.js";
+} from "../../../chunks/chunk-IWZAUQGO.js";
+import "../../../chunks/chunk-QWZ4ZNFA.js";
+import "../../../chunks/chunk-ON6LC3HE.js";
+import "../../../chunks/chunk-4XSDRT23.js";
+import "../../../chunks/chunk-3TKBCG7Y.js";
+import "../../../chunks/chunk-VROZGPC5.js";
+import "../../../chunks/chunk-FD5WR2A5.js";
+import "../../../chunks/chunk-4XBUJAQU.js";
+import "../../../chunks/chunk-C6QTHDDM.js";
+import "../../../chunks/chunk-IV75M3KE.js";
+import "../../../chunks/chunk-ZEZCYPLQ.js";
+import "../../../chunks/chunk-ZSUG52DO.js";
 import "../../../chunks/chunk-JMU5PDBD.js";
 import "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-NZLE2WMY.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
+  directory_exports as Directory,
   file_exports as File
 };

package/node/@design-edito/index.js

@@ -1,7 +1,7 @@
 import {
   thumbnails_exports
 } from "../../chunks/chunk-JBSS64SA.js";
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 export {
   thumbnails_exports as Thumbnails
 };

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

@@ -1,9 +1,9 @@
 import {
   useMulterMiddleware
-} from "../../../chunks/chunk-7JUKBN7P.js";
+} from "../../../chunks/chunk-QCOO4PV5.js";
 import "../../../chunks/chunk-JMU5PDBD.js";
 import "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-NZLE2WMY.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   useMulterMiddleware
 };

package/node/@express/index.js

@@ -1,9 +1,9 @@
 import {
   multer_exports
-} from "../../chunks/chunk-7JUKBN7P.js";
+} from "../../chunks/chunk-QCOO4PV5.js";
 import "../../chunks/chunk-JMU5PDBD.js";
 import "../../chunks/chunk-FENXVJYO.js";
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 export {
   multer_exports as Multer
 };

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

@@ -1,24 +1,29 @@
 import {
   storage_exports
-} from "../../chunks/chunk-NSM7QLE4.js";
-import "../../chunks/chunk-H73SGDQI.js";
-import "../../chunks/chunk-XZ7II65Z.js";
-import "../../chunks/chunk-FTT6ZCCS.js";
-import "../../chunks/chunk-TU3UWOAE.js";
-import "../../chunks/chunk-YW5ASSIQ.js";
-import "../../chunks/chunk-SZQHLC4K.js";
-import "../../chunks/chunk-TXGV4KJD.js";
-import "../../chunks/chunk-OPU4CANL.js";
-import "../../chunks/chunk-GXICX4F6.js";
-import "../../chunks/chunk-KFMYB672.js";
-import "../../chunks/chunk-UUSZJMJB.js";
-import "../../chunks/chunk-T55QIYYV.js";
-import "../../chunks/chunk-7BCQCDGQ.js";
-import "../../chunks/chunk-IARWH6LC.js";
-import "../../chunks/chunk-7FJKDVBE.js";
+} from "../../chunks/chunk-DABLUUMY.js";
+import "../../chunks/chunk-BD56ZAYF.js";
+import "../../chunks/chunk-ZNA7SWFK.js";
+import "../../chunks/chunk-WJ3XV35I.js";
+import "../../chunks/chunk-3G7KHSKB.js";
+import "../../chunks/chunk-HWVEI3RH.js";
+import "../../chunks/chunk-PAIUCLVK.js";
+import "../../chunks/chunk-42K3MQQ5.js";
+import "../../chunks/chunk-YKPA3MQL.js";
+import "../../chunks/chunk-G5RRNREY.js";
+import "../../chunks/chunk-6IYUA43Q.js";
+import "../../chunks/chunk-BWYH445G.js";
+import "../../chunks/chunk-QLDN574K.js";
+import "../../chunks/chunk-7J7CYOXU.js";
+import "../../chunks/chunk-W3RXHN5I.js";
+import "../../chunks/chunk-FB3GNE2B.js";
+import "../../chunks/chunk-V3L55I2S.js";
+import "../../chunks/chunk-CWZFRUBS.js";
+import "../../chunks/chunk-2JH4TCT2.js";
+import "../../chunks/chunk-5VHFXWFM.js";
+import "../../chunks/chunk-37TRFYZT.js";
 import "../../chunks/chunk-JMU5PDBD.js";
 import "../../chunks/chunk-FENXVJYO.js";
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 export {
   storage_exports as Storage
 };

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

@@ -1,9 +1,9 @@
 import {
   getMetadata
-} from "../../../../../chunks/chunk-FTT6ZCCS.js";
+} from "../../../../../chunks/chunk-ZNA7SWFK.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   getMetadata
 };

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

@@ -1,3 +1,5 @@
 import * as GetMetadata from './get-metadata';
-import * as List from './list';
-export { GetMetadata, List };
+import * as List from '../directory/list';
+import * as MoveDir from '../directory/move-dir';
+import * as RemoveDir from '../directory/remove-dir';
+export { GetMetadata, List, MoveDir, RemoveDir };

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

@@ -1,14 +1,22 @@
-import "../../../../chunks/chunk-H73SGDQI.js";
-import {
-  list_exports
-} from "../../../../chunks/chunk-XZ7II65Z.js";
+import "../../../../chunks/chunk-BD56ZAYF.js";
 import {
   get_metadata_exports
-} from "../../../../chunks/chunk-FTT6ZCCS.js";
+} from "../../../../chunks/chunk-ZNA7SWFK.js";
+import {
+  move_dir_exports
+} from "../../../../chunks/chunk-BWYH445G.js";
+import {
+  remove_dir_exports
+} from "../../../../chunks/chunk-QLDN574K.js";
+import {
+  list_exports
+} from "../../../../chunks/chunk-37TRFYZT.js";
 import "../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   get_metadata_exports as GetMetadata,
-  list_exports as List
+  list_exports as List,
+  move_dir_exports as MoveDir,
+  remove_dir_exports as RemoveDir
 };

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

@@ -0,0 +1,22 @@
+import { Bucket, GetFileOptions, CopyOptions as GCSCopyOptions } from '@google-cloud/storage';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type CopyDirOptions = {
+    getFileOptions?: GetFileOptions;
+    copyOptions?: GCSCopyOptions;
+    /**
+     * If false (default), existing target files will be skipped (not overwritten).
+     */
+    overwrite?: boolean;
+};
+/** Recursively copies every object under `sourceDir` to the same relative path
+ *  beneath `targetDir` within a single GCS bucket.
+ * @param {Bucket} bucket - The GCS bucket instance.
+ * @param {string} sourceDir - The source directory path (prefix) to copy from.
+ * @param {string} targetDir - The target directory path (prefix) to copy to.
+ * @param {CopyDirOptions} [options] - Optional parameters for the operation.
+ * @param {boolean} [options.overwrite=false] - Whether to overwrite existing files at target.
+ * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an `Outcome.Either`:
+ * - On success: `Outcome.makeSuccess(true)` indicating the copy was successful.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the copy fails.
+ * */
+export declare function copyDir(bucket: Bucket, sourceDir: string, targetDir: string, options?: CopyDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  copyDir
+} from "../../../../../chunks/chunk-V3L55I2S.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  copyDir
+};

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

@@ -0,0 +1,5 @@
+import * as CopyDir from './copy-dir';
+import * as List from './list';
+import * as MoveDir from './move-dir';
+import * as RemoveDir from './remove-dir';
+export { CopyDir, List, MoveDir, RemoveDir };

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

@@ -0,0 +1,22 @@
+import "../../../../chunks/chunk-WJ3XV35I.js";
+import {
+  move_dir_exports
+} from "../../../../chunks/chunk-BWYH445G.js";
+import {
+  remove_dir_exports
+} from "../../../../chunks/chunk-QLDN574K.js";
+import {
+  copy_dir_exports
+} from "../../../../chunks/chunk-V3L55I2S.js";
+import {
+  list_exports
+} from "../../../../chunks/chunk-37TRFYZT.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  copy_dir_exports as CopyDir,
+  list_exports as List,
+  move_dir_exports as MoveDir,
+  remove_dir_exports as RemoveDir
+};

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

@@ -0,0 +1,17 @@
+import { Bucket, FileOptions } from '@google-cloud/storage';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type ListOptions = {
+    fileOptions?: FileOptions;
+};
+/**
+ * Lists all direct children file paths under a given directory prefix in a GCS bucket.
+ *
+ * This function returns only the immediate files (not recursive) under the specified directory prefix.
+ *
+ * @param {Bucket} bucket - The GCS bucket to list files from.
+ * @param {string} directoryPath - The directory prefix to list files under.
+ * @param {ListOptions} [options] - Optional configuration for the listing.
+ * @param {FileOptions} [options.fileOptions] - Additional options for file retrieval.
+ * @returns {Promise<Outcome.Either<string[], string>>} Returns either a success with an array of file paths, or a failure with an error message.
+ */
+export declare function list(bucket: Bucket, directoryPath: string, options?: ListOptions): Promise<Outcome.Either<string[], string>>;

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

@@ -0,0 +1,9 @@
+import {
+  list
+} from "../../../../../chunks/chunk-37TRFYZT.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  list
+};

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

@@ -0,0 +1,31 @@
+import { Bucket, FileOptions, CopyOptions as GCSCopyOptions, DeleteFileOptions as GCSDeleteOptions } from '@google-cloud/storage';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type MoveDirOptions = {
+    fileOptions?: FileOptions;
+    copyOptions?: GCSCopyOptions;
+    deleteOptions?: GCSDeleteOptions;
+    /**
+     * If false and any destination file exists, the operation aborts with an error.
+     * Defaults to false.
+     */
+    overwrite?: boolean;
+};
+/**
+ * Recursively moves every object under `sourceDir` to the corresponding path
+ * under `targetDir` within the same bucket.
+ *
+ * Example: moving `a/b/` to `x/y/` copies
+ * `a/b/file.txt` → `x/y/file.txt` and then deletes the original.
+ *
+ * If `overwrite` is false (default), the operation aborts if any destination file
+ * already exists.
+ *
+ * @param {Bucket} bucket - The GCS bucket instance.
+ * @param {string} sourceDir - The source directory prefix to move from.
+ * @param {string} targetDir - The target directory prefix to move to.
+ * @param {MoveDirOptions} [options] - Optional parameters for the operation.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success: `Outcome.makeSuccess(true)`.
+ * - On failure: `Outcome.makeFailure(errStr)`.
+ */
+export declare function moveDir(bucket: Bucket, sourceDir: string, targetDir: string, options?: MoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  moveDir
+} from "../../../../../chunks/chunk-BWYH445G.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  moveDir
+};

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

@@ -0,0 +1,31 @@
+import { Bucket, DeleteFileOptions as GCSDeleteFileOptions } from '@google-cloud/storage';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type RemoveDirOptions = {
+    /** Extra parameters forwarded to `bucket.deleteFiles`. */
+    deleteOptions?: GCSDeleteFileOptions & {
+        force?: boolean;
+    };
+    /**
+     * If **true** (default) the function ignores the case where the prefix is
+     * already empty / does not exist and simply returns success.
+     * If **false** and no objects are found, the function returns a failure.
+     * @default true
+     */
+    ignoreMissing?: boolean;
+};
+/**
+ * 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 declare function removeDir(bucket: Bucket, directoryPath: string, options?: RemoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  removeDir
+} from "../../../../../chunks/chunk-QLDN574K.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  removeDir
+};

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

@@ -1,21 +1,32 @@
 import { Bucket, FileOptions, CopyOptions as GCSFileCopyOptions } from '@google-cloud/storage';
 import { Outcome } from '../../../../../agnostic/misc/outcome';
 export type CopyOptions = {
+    /** Additional options for constructing the `File` handles. */
     fileOptions?: FileOptions;
+    /** Additional parameters forwarded to the underlying `copy` call. */
     copyOptions?: GCSFileCopyOptions;
+    /**
+     * If `false` (default) and `targetPath` already exists, the copy aborts with
+     * an error.
+     * @default false
+     */
+    overwrite?: boolean;
 };
 /**
  * Copies a file from one location to another within a Google Cloud Storage bucket.
  *
- * This function copies the file located at `sourcePath` to `targetPath` in the same or a different Google Cloud Storage bucket.
- * It can be customized using optional `fileOptions` and `copyOptions` to control the copying behavior.
+ * If `overwrite` is **false** (default) and the destination object already
+ * exists, the operation aborts.
  *
- * @param {string} sourcePath - The path of the source file to be copied.
- * @param {string} targetPath - The target path where the file will be copied to.
- * @param {Bucket} bucket - The Google Cloud Storage bucket object containing the file to be copied.
- * @param {CopyOptions} [options] - Optional configuration options for the file copy operation.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an `Outcome.Either`.
- * - On success: `Outcome.makeSuccess(true)` indicating the file was successfully copied.
- * - On failure: `Outcome.makeFailure(errStr)` with an error message if the copy operation fails.
+ * @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 declare function copy(sourcePath: string, targetPath: string, bucket: Bucket, options?: CopyOptions): Promise<Outcome.Either<true, string>>;
+export declare function copy(bucket: Bucket, sourcePath: string, targetPath: string, options?: CopyOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +1,9 @@
 import {
   copy
-} from "../../../../../chunks/chunk-SZQHLC4K.js";
+} from "../../../../../chunks/chunk-CWZFRUBS.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   copy
 };

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

@@ -11,11 +11,11 @@ export type DownloadOptions = {
  * 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 {string} sourcePath - The path of the file to be downloaded in the bucket.
  * @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 declare function download(sourcePath: string, bucket: Bucket, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;
+export declare function download(bucket: Bucket, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;

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

@@ -1,9 +1,9 @@
 import {
   download
-} from "../../../../../chunks/chunk-IARWH6LC.js";
+} from "../../../../../chunks/chunk-2JH4TCT2.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   download
 };

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

@@ -1,9 +1,9 @@
 import {
   exists
-} from "../../../../../chunks/chunk-TXGV4KJD.js";
+} from "../../../../../chunks/chunk-5VHFXWFM.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   exists
 };

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

@@ -11,8 +11,8 @@ export type GenerateSignedUrlOptions = {
  * 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 {string} sourcePath - The path of the file for which the signed URL is being generated.
  * @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.
@@ -20,4 +20,4 @@ export type GenerateSignedUrlOptions = {
  * - 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 declare function generateSignedUrl(sourcePath: string, bucket: Bucket, action: GetSignedUrlConfig['action'], expiresOn: GetSignedUrlConfig['expires'], options?: GenerateSignedUrlOptions): Promise<Outcome.Either<string, string>>;
+export declare function generateSignedUrl(bucket: Bucket, sourcePath: string, action: GetSignedUrlConfig['action'], expiresOn: GetSignedUrlConfig['expires'], options?: GenerateSignedUrlOptions): Promise<Outcome.Either<string, string>>;

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

@@ -1,9 +1,9 @@
 import {
   generateSignedUrl
-} from "../../../../../chunks/chunk-OPU4CANL.js";
+} from "../../../../../chunks/chunk-PAIUCLVK.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   generateSignedUrl
 };

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

@@ -10,8 +10,8 @@ export type GetMetadataOptions = {
  * 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 {string} sourcePath - The path of the file whose metadata is to be fetched.
  * @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.
@@ -19,4 +19,4 @@ export type GetMetadataOptions = {
  *
  * @throws {Error} Throws an error if the metadata retrieval operation fails (e.g., file not found, insufficient permissions, etc.).
  */
-export declare function getMetadata(sourcePath: string, bucket: Bucket, options?: GetMetadataOptions): Promise<Outcome.Either<FileMetadata, string>>;
+export declare function getMetadata(bucket: Bucket, sourcePath: string, options?: GetMetadataOptions): Promise<Outcome.Either<FileMetadata, string>>;

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

@@ -1,9 +1,9 @@
 import {
   getMetadata
-} from "../../../../../chunks/chunk-KFMYB672.js";
+} from "../../../../../chunks/chunk-42K3MQQ5.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   getMetadata
 };

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

@@ -9,11 +9,11 @@ export type GetPermissionsOptions = {
  *
  * This function fetches the ACL settings of a given file to determine the permissions assigned to different users or roles.
  *
- * @param {string} sourcePath - The path of the file whose permissions need to be retrieved.
  * @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 declare function getPermissions(sourcePath: string, bucket: Bucket, options?: GetPermissionsOptions): Promise<Outcome.Either<any, string>>;
+export declare function getPermissions(bucket: Bucket, sourcePath: string, options?: GetPermissionsOptions): Promise<Outcome.Either<any, string>>;

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

@@ -1,9 +1,9 @@
 import {
   getPermissions
-} from "../../../../../chunks/chunk-GXICX4F6.js";
+} from "../../../../../chunks/chunk-YKPA3MQL.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   getPermissions
 };

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

@@ -1,12 +1,13 @@
 import * as Copy from './copy';
 import * as Download from './download';
-import * as Erase from './erase';
 import * as Exists from './exists';
 import * as GenerateSignedUrl from './generate-signed-url';
 import * as GetMetaData from './get-metadata';
 import * as GetPermissions from './get-permissions';
 import * as Move from './move';
+import * as Remove from './remove';
 import * as RevokeSignedUrls from './revoke-signed-urls';
+import * as Stat from './stat';
 import * as UpdateMetadata from './update-metadata';
 import * as Upload from './upload';
-export { Copy, Download, Erase, Exists, GenerateSignedUrl, GetMetaData, GetPermissions, Move, RevokeSignedUrls, UpdateMetadata, Upload };
+export { Copy, Download, Exists, GenerateSignedUrl, GetMetaData, GetPermissions, Move, Remove, RevokeSignedUrls, Stat, UpdateMetadata, Upload };