@design-edito/tools 0.1.70 → 0.1.72

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-4XS5UIQF.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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-MPYCQ5IF.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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-BTJ2JXDV.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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-6NZOSESD.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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-6STIUASQ.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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-NXV33ZSC.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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 };

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

@@ -1,50 +1,54 @@
-import "../../../../chunks/chunk-MDVYILPB.js";
+import "../../../../chunks/chunk-AOWLA5T2.js";
 import {
   update_metadata_exports
-} from "../../../../chunks/chunk-YW5ASSIQ.js";
+} from "../../../../chunks/chunk-G2XDDBWE.js";
+import {
+  get_metadata_exports
+} from "../../../../chunks/chunk-6STIUASQ.js";
 import {
   generate_signed_url_exports
-} from "../../../../chunks/chunk-OPU4CANL.js";
+} from "../../../../chunks/chunk-6NZOSESD.js";
 import {
   get_permissions_exports
-} from "../../../../chunks/chunk-GXICX4F6.js";
-import {
-  exists_exports
-} from "../../../../chunks/chunk-TXGV4KJD.js";
+} from "../../../../chunks/chunk-NXV33ZSC.js";
 import {
-  get_metadata_exports
-} from "../../../../chunks/chunk-KFMYB672.js";
+  revoke_signed_urls_exports
+} from "../../../../chunks/chunk-UBJACMOZ.js";
 import {
   move_exports
-} from "../../../../chunks/chunk-T55QIYYV.js";
+} from "../../../../chunks/chunk-XIMUZN5X.js";
 import {
-  revoke_signed_urls_exports
-} from "../../../../chunks/chunk-UUSZJMJB.js";
+  remove_exports
+} from "../../../../chunks/chunk-2RFYHF6F.js";
 import {
-  erase_exports
-} from "../../../../chunks/chunk-7BCQCDGQ.js";
+  upload_exports
+} from "../../../../chunks/chunk-MP6CL7F7.js";
 import {
-  copy_exports
-} from "../../../../chunks/chunk-SZQHLC4K.js";
+  stat_exports
+} from "../../../../chunks/chunk-JKAHSFJD.js";
 import {
   download_exports
-} from "../../../../chunks/chunk-IARWH6LC.js";
+} from "../../../../chunks/chunk-MPYCQ5IF.js";
 import {
-  upload_exports
-} from "../../../../chunks/chunk-7FJKDVBE.js";
+  copy_exports
+} from "../../../../chunks/chunk-4XS5UIQF.js";
+import {
+  exists_exports
+} from "../../../../chunks/chunk-BTJ2JXDV.js";
 import "../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   copy_exports as Copy,
   download_exports as Download,
-  erase_exports as Erase,
   exists_exports as Exists,
   generate_signed_url_exports as GenerateSignedUrl,
   get_metadata_exports as GetMetaData,
   get_permissions_exports as GetPermissions,
   move_exports as Move,
+  remove_exports as Remove,
   revoke_signed_urls_exports as RevokeSignedUrls,
+  stat_exports as Stat,
   update_metadata_exports as UpdateMetadata,
   upload_exports as Upload
 };

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

@@ -1,24 +1,36 @@
 import { Bucket, FileOptions, CopyOptions, DeleteFileOptions as GCSDeleteFileOptions } from '@google-cloud/storage';
 import { Outcome } from '../../../../../agnostic/misc/outcome';
 export type MoveOptions = {
+    /** Options applied when obtaining `bucket.file(...)` handles. */
     fileOptions?: FileOptions;
+    /** Extra parameters forwarded to the internal `copy` call. */
     copyOptions?: CopyOptions;
+    /** Extra parameters forwarded to the internal `delete` call. */
     deleteOptions?: GCSDeleteFileOptions;
+    /**
+     * If **false** (default) and `targetPath` already exists, the move aborts
+     * with an error.
+     * @default false
+     */
+    overwrite?: boolean;
 };
 /**
  * Moves a file from one location to another within a Google Cloud Storage bucket.
  *
- * This function first copies the file located at `sourcePath` to `targetPath`, then deletes the source file
- * after the copy is successful. The process can be customized using optional `fileOptions`, `copyOptions`, and `deleteOptions`.
+ * 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 {string} sourcePath - The path of the source file to be moved.
- * @param {string} targetPath - The target path where the file will be moved to.
- * @param {Bucket} bucket - The Google Cloud Storage bucket object containing the file to be moved.
- * @param {MoveOptions} [options] - Optional configuration options for the file move 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 moved.
- * - On failure: `Outcome.makeFailure(errStr)` with an error message if the move operation fails.
- *
- * @throws {Error} Throws an error if the move operation fails (e.g., source file not found, insufficient permissions, etc.).
+ * @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 declare function move(sourcePath: string, targetPath: string, bucket: Bucket, options?: MoveOptions): Promise<Outcome.Either<true, string>>;
+export declare function move(bucket: Bucket, sourcePath: string, targetPath: string, options?: MoveOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +1,9 @@
 import {
   move
-} from "../../../../../chunks/chunk-T55QIYYV.js";
+} from "../../../../../chunks/chunk-XIMUZN5X.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.js";
 export {
   move
 };

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

@@ -0,0 +1,24 @@
+import { Bucket, FileOptions, DeleteFileOptions as GCSDeleteFileOptions } from '@google-cloud/storage';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type RemoveOptions = {
+    fileOptions?: FileOptions;
+    deleteOptions?: GCSDeleteFileOptions;
+    ignoreMissing?: boolean;
+};
+/**
+ * Removes a file from a specified Google Cloud Storage bucket.
+ *
+ * This function deletes the object located at `targetPath` in the given bucket.
+ * The operation can be customized using optional `fileOptions` (to reference the object)
+ * and `deleteOptions` (to influence GCS deletion behaviour).
+ * If the `ignoreMissing` option is **true**, the function treats a missing object as a
+ * successful outcome instead of returning an error.
+ *
+ * @param {Bucket} bucket - The Google Cloud Storage bucket instance.
+ * @param {string} targetPath - The path of the file to remove in the bucket.
+ * @param {RemoveOptions} [options] - Optional settings for configuring the removal process.
+ * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
+ * - On success: `Outcome.makeSuccess(true)` indicating the removal was successful.
+ * - On failure:  `Outcome.makeFailure(errStr)` with an error message if the removal fails.
+ */
+export declare function remove(bucket: Bucket, targetPath: string, options?: RemoveOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  remove
+} from "../../../../../chunks/chunk-2RFYHF6F.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-KH45J4DC.js";
+export {
+  remove
+};

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

@@ -1,26 +1,26 @@
 import { Bucket } from '@google-cloud/storage';
 import { Outcome } from '../../../../../agnostic/misc/outcome';
 import { DownloadOptions } from '../download';
-import { EraseOptions } from '../erase';
+import { RemoveOptions } from '../remove';
 import { UploadOptions } from '../upload';
 export type RevokeSignedUrlsOptions = {
     downloadOptions?: DownloadOptions;
-    eraseOptions?: EraseOptions;
+    removeOptions?: RemoveOptions;
     uploadOptions?: UploadOptions;
 };
 /**
  * Revokes the signed URLs for a file in Google Cloud Storage by downloading the file,
  * deleting it, and re-uploading it to effectively invalidate any previously generated signed URLs.
  *
- * This function first attempts to download the file from the bucket, then erases the file,
+ * This function first attempts to download the file from the bucket, then removes the file,
  * and finally re-uploads the file to the same path. The re-upload effectively revokes any signed URLs that
  * were generated for the file, as they are tied to the file's existence and content.
  *
- * @param {string} sourcePath - The path of the file for which the signed URLs are to be revoked.
  * @param {Bucket} bucket - The Google Cloud Storage bucket containing the file.
+ * @param {string} targetPath - The path of the file for which the signed URLs are to be revoked.
  * @param {RevokeSignedUrlsOptions} [options] - Optional configuration options for the file operations.
  * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an `Outcome.Either`.
  * - On success: `Outcome.makeSuccess(true)` if the file has been successfully re-uploaded after deletion.
- * - On failure: `Outcome.makeFailure(errStr)` with an error message if any of the steps (download, erase, or upload) fail.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if any of the steps (download, remove, or upload) fail.
  */
-export declare function revokeSignedUrls(sourcePath: string, bucket: Bucket, options?: RevokeSignedUrlsOptions): Promise<Outcome.Either<true, string>>;
+export declare function revokeSignedUrls(bucket: Bucket, targetPath: string, options?: RevokeSignedUrlsOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,12 +1,12 @@
 import {
   revokeSignedUrls
-} from "../../../../../chunks/chunk-UUSZJMJB.js";
-import "../../../../../chunks/chunk-7BCQCDGQ.js";
-import "../../../../../chunks/chunk-IARWH6LC.js";
-import "../../../../../chunks/chunk-7FJKDVBE.js";
+} from "../../../../../chunks/chunk-UBJACMOZ.js";
+import "../../../../../chunks/chunk-2RFYHF6F.js";
+import "../../../../../chunks/chunk-MP6CL7F7.js";
+import "../../../../../chunks/chunk-MPYCQ5IF.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.js";
 export {
   revokeSignedUrls
 };

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

@@ -0,0 +1,25 @@
+import { Bucket, FileOptions, GetFileMetadataOptions, FileMetadata } from '@google-cloud/storage';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+/** Provider‑agnostic view + strongly‑typed raw metadata */
+export interface Stat {
+    size?: number;
+    modifiedAt?: Date;
+    checksum?: string;
+    contentType?: string;
+    metadata?: Record<string, string | number | boolean | null>;
+    storageClass?: string;
+    raw: FileMetadata;
+}
+export type StatOptions = {
+    fileOptions?: FileOptions;
+    getMetadataOptions?: GetFileMetadataOptions;
+};
+/**
+ * Retrieves metadata for a single GCS object.
+ *
+ * @param {Bucket} bucket – GCS bucket.
+ * @param {string} path  – Object path.
+ * @param {StatOptions} [options] – Extra getMetadata options.
+ * @returns {Promise<Outcome.Either<Stat, string>>}
+ */
+export declare function stat(bucket: Bucket, path: string, options?: StatOptions): Promise<Outcome.Either<Stat, string>>;

package/node/@google-cloud/storage/file/{erase → stat}/index.js

@@ -1,9 +1,9 @@
 import {
-  erase
-} from "../../../../../chunks/chunk-7BCQCDGQ.js";
+  stat
+} from "../../../../../chunks/chunk-JKAHSFJD.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.js";
 export {
-  erase
+  stat
 };

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

@@ -7,12 +7,12 @@ export type UpdateFileMetadataOptions = {
 /**
  * Updates the metadata of a file in a Google Cloud Storage bucket.
  *
- * This function allows updating the metadata of a file located at `sourcePath` in the given bucket.
+ * This function allows updating the metadata of a file located at `targetPath` in the given bucket.
  * The metadata is updated according to the provided `metadata` object, which contains the new metadata key-value pairs.
  * It can be customized using optional `fileOptions` and `metadataOptions` to control the update behavior.
  *
- * @param {string} sourcePath - The path of the file whose metadata is to be updated.
  * @param {Bucket} bucket - The Google Cloud Storage bucket object containing the file whose metadata is being updated.
+ * @param {string} targetPath - The path of the file whose metadata is to be updated.
  * @param {Record<string, any>} metadata - The metadata object containing key-value pairs to be set on the file.
  * @param {UpdateFileMetadataOptions} [options] - Optional configuration options for the metadata update operation.
  * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an `Outcome.Either`.
@@ -21,4 +21,4 @@ export type UpdateFileMetadataOptions = {
  *
  * @throws {Error} Throws an error if the metadata update operation fails (e.g., file not found, insufficient permissions, etc.).
  */
-export declare function updateFileMetadata(sourcePath: string, bucket: Bucket, metadata: Record<string, any>, options?: UpdateFileMetadataOptions): Promise<Outcome.Either<true, string>>;
+export declare function updateFileMetadata(bucket: Bucket, targetPath: string, metadata: Record<string, any>, options?: UpdateFileMetadataOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +1,9 @@
 import {
   updateFileMetadata
-} from "../../../../../chunks/chunk-YW5ASSIQ.js";
+} from "../../../../../chunks/chunk-G2XDDBWE.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.js";
 export {
   updateFileMetadata
 };

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

@@ -3,9 +3,8 @@ import { Bucket, FileOptions, SaveOptions } from '@google-cloud/storage';
 import { Outcome } from '../../../../../agnostic/misc/outcome';
 export type UploadOptions = {
     fileOptions?: FileOptions;
-    saveOptions?: SaveOptions & {
-        overwrite?: boolean;
-    };
+    saveOptions?: SaveOptions;
+    overwrite?: boolean;
 };
 /**
  * Uploads a file stream to a specified Google Cloud Storage bucket.
@@ -14,12 +13,12 @@ export type UploadOptions = {
  * The upload can be customized using optional `fileOptions` and `saveOptions`.
  * If the `overwrite` option is false and a file already exists at the target path, the 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 {Bucket} bucket - The Google Cloud Storage bucket object.
+ * @param {string} targetPath - The target path where the file will be saved in the bucket.
+ * @param {Readable} fileStream - The file content to be uploaded.
  * @param {UploadOptions} [options] - Optional options to configure the upload process.
  * @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.
  */
-export declare function upload(fileStream: Readable, targetPath: string, bucket: Bucket, options?: UploadOptions): Promise<Outcome.Either<true, string>>;
+export declare function upload(bucket: Bucket, targetPath: string, fileStream: Readable, options?: UploadOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +1,9 @@
 import {
   upload
-} from "../../../../../chunks/chunk-7FJKDVBE.js";
+} from "../../../../../chunks/chunk-MP6CL7F7.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.js";
 export {
   upload
 };

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

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

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

@@ -1,27 +1,35 @@
-import "../../../chunks/chunk-HBKSSDSX.js";
+import "../../../chunks/chunk-SCOY7PVB.js";
 import {
   bucket_exports
-} from "../../../chunks/chunk-XSVBWVVC.js";
-import "../../../chunks/chunk-FTT6ZCCS.js";
-import "../../../chunks/chunk-XZ7II65Z.js";
+} from "../../../chunks/chunk-IQUEVQBN.js";
+import "../../../chunks/chunk-Z566RJUU.js";
+import {
+  directory_exports
+} from "../../../chunks/chunk-J5TWVAJJ.js";
 import {
   file_exports
-} from "../../../chunks/chunk-MDVYILPB.js";
-import "../../../chunks/chunk-YW5ASSIQ.js";
-import "../../../chunks/chunk-OPU4CANL.js";
-import "../../../chunks/chunk-GXICX4F6.js";
-import "../../../chunks/chunk-TXGV4KJD.js";
-import "../../../chunks/chunk-KFMYB672.js";
-import "../../../chunks/chunk-T55QIYYV.js";
-import "../../../chunks/chunk-UUSZJMJB.js";
-import "../../../chunks/chunk-7BCQCDGQ.js";
-import "../../../chunks/chunk-SZQHLC4K.js";
-import "../../../chunks/chunk-IARWH6LC.js";
-import "../../../chunks/chunk-7FJKDVBE.js";
+} from "../../../chunks/chunk-AOWLA5T2.js";
+import "../../../chunks/chunk-G2XDDBWE.js";
+import "../../../chunks/chunk-6STIUASQ.js";
+import "../../../chunks/chunk-6NZOSESD.js";
+import "../../../chunks/chunk-NXV33ZSC.js";
+import "../../../chunks/chunk-UBJACMOZ.js";
+import "../../../chunks/chunk-XIMUZN5X.js";
+import "../../../chunks/chunk-2RFYHF6F.js";
+import "../../../chunks/chunk-CEY7OIFX.js";
+import "../../../chunks/chunk-6SSGHEQX.js";
+import "../../../chunks/chunk-MP6CL7F7.js";
+import "../../../chunks/chunk-JKAHSFJD.js";
+import "../../../chunks/chunk-YCNUTWOG.js";
+import "../../../chunks/chunk-MPYCQ5IF.js";
+import "../../../chunks/chunk-4XS5UIQF.js";
+import "../../../chunks/chunk-TQZ46CBX.js";
+import "../../../chunks/chunk-BTJ2JXDV.js";
 import "../../../chunks/chunk-JMU5PDBD.js";
 import "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-NZLE2WMY.js";
+import "../../../chunks/chunk-KH45J4DC.js";
 export {
   bucket_exports as Bucket,
+  directory_exports as Directory,
   file_exports as File
 };