@design-edito/tools 0.4.22 → 0.5.0

package/node/@express/@multer/index.d.ts

@@ -1,4 +1,4 @@
-import { type Request, type Response } from 'express';
+import type { Request, Response } from 'express';
 import multer from 'multer';
 import * as Outcome from '../../../agnostic/misc/outcome/index.js';
 export type WithMulterModeOptions = {
@@ -39,17 +39,17 @@ export type WithMulterError = {
  * applies the appropriate middleware based on the upload mode. Errors are
  * captured and returned as a structured `WithMulterError` object.
  *
- * @param {Request} req                    - The Express request object.
- * @param {Response} res                   - The Express response object.
- * @param {WithMulterOptions} options      - Multer configuration and upload mode.
- * @param {multer.StorageEngine} [options.storage] - Storage engine (defaults to memory).
- * @param {multer.Options['limits']} [options.limits] - File size and count limits.
- * @param {multer.Options['fileFilter']} [options.fileFilter] - File filter function.
- * @param {'none'|'any'|'single'|'array'|'fields'} options.mode - Upload mode.
- * @param {string} [options.fieldName]     - Field name (required for 'single' and 'array' modes).
- * @param {number} [options.maxCount]      - Max file count (for 'array' mode).
- * @param {multer.Field[]} [options.fields] - Field configurations (for 'fields' mode).
- * @returns {Promise<Outcome.Either<true, WithMulterError>>}
+ * @param req                    - The Express request object.
+ * @param res                   - The Express response object.
+ * @param options      - Multer configuration and upload mode.
+ * @param [options.storage] - Storage engine (defaults to memory).
+ * @param [options.limits] - File size and count limits.
+ * @param [options.fileFilter] - File filter function.
+ * @param options.mode - Upload mode.
+ * @param [options.fieldName]     - Field name (required for 'single' and 'array' modes).
+ * @param [options.maxCount]      - Max file count (for 'array' mode).
+ * @param [options.fields] - Field configurations (for 'fields' mode).
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(error)` with structured error details.
  */

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

@@ -8,17 +8,17 @@ import { unknownToString } from '../../../agnostic/errors/unknown-to-string/inde
  * applies the appropriate middleware based on the upload mode. Errors are
  * captured and returned as a structured `WithMulterError` object.
  *
- * @param {Request} req                    - The Express request object.
- * @param {Response} res                   - The Express response object.
- * @param {WithMulterOptions} options      - Multer configuration and upload mode.
- * @param {multer.StorageEngine} [options.storage] - Storage engine (defaults to memory).
- * @param {multer.Options['limits']} [options.limits] - File size and count limits.
- * @param {multer.Options['fileFilter']} [options.fileFilter] - File filter function.
- * @param {'none'|'any'|'single'|'array'|'fields'} options.mode - Upload mode.
- * @param {string} [options.fieldName]     - Field name (required for 'single' and 'array' modes).
- * @param {number} [options.maxCount]      - Max file count (for 'array' mode).
- * @param {multer.Field[]} [options.fields] - Field configurations (for 'fields' mode).
- * @returns {Promise<Outcome.Either<true, WithMulterError>>}
+ * @param req                    - The Express request object.
+ * @param res                   - The Express response object.
+ * @param options      - Multer configuration and upload mode.
+ * @param [options.storage] - Storage engine (defaults to memory).
+ * @param [options.limits] - File size and count limits.
+ * @param [options.fileFilter] - File filter function.
+ * @param options.mode - Upload mode.
+ * @param [options.fieldName]     - Field name (required for 'single' and 'array' modes).
+ * @param [options.maxCount]      - Max file count (for 'array' mode).
+ * @param [options.fields] - Field configurations (for 'fields' mode).
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(error)` with structured error details.
  */
@@ -46,18 +46,20 @@ export async function useMulterMiddleware(req, res, options) {
     else {
         middleware = uploader.any();
     }
-    return await new Promise(resolve => middleware(req, res, (err) => {
-        if (err instanceof multer.MulterError)
-            return resolve(Outcome.makeFailure({
-                code: err.code,
-                message: err.message,
-                field: err.field
-            }));
-        return resolve(err !== undefined
-            ? Outcome.makeFailure({
-                code: 'UNKNOWN',
-                message: unknownToString(err)
-            })
-            : Outcome.makeSuccess(true));
-    }));
+    return await new Promise(resolve => {
+        middleware(req, res, (err) => {
+            if (err instanceof multer.MulterError)
+                return resolve(Outcome.makeFailure({
+                    code: err.code,
+                    message: err.message,
+                    field: err.field
+                }));
+            return resolve(err !== undefined
+                ? Outcome.makeFailure({
+                    code: 'UNKNOWN',
+                    message: unknownToString(err)
+                })
+                : Outcome.makeSuccess(true));
+        });
+    });
 }

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

@@ -1,4 +1,4 @@
-import { type Bucket, type BucketMetadata, type GetBucketMetadataOptions as GCSGetBucketMetadataOptions } from '@google-cloud/storage';
+import type { Bucket, BucketMetadata, GetBucketMetadataOptions as GCSGetBucketMetadataOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type GetBucketMetadataOptions = GCSGetBucketMetadataOptions;
 /**
@@ -7,9 +7,9 @@ export type GetBucketMetadataOptions = GCSGetBucketMetadataOptions;
  * This function calls the Google Cloud Storage API to get information about the bucket,
  * such as its location, storage class, and other configuration details.
  *
- * @param {Bucket} bucket - The Google Cloud Storage bucket object.
- * @param {GetBucketMetadataOptions} [options] - Optional configuration options to pass to the `getMetadata` method.
- * @returns {Promise<Outcome.Either<BucketMetadata, string>>} A promise that resolves to an `Outcome.Either`.
+ * @param bucket - The Google Cloud Storage bucket object.
+ * @param [options] - Optional configuration options to pass to the `getMetadata` method.
+ * @returns A promise that resolves to an `Outcome.Either`.
  * - On success: `Outcome.makeSuccess(metadata)` with the bucket metadata.
  * - On failure: `Outcome.makeFailure(errStr)` with an error message.
  *

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

@@ -6,9 +6,9 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
  * This function calls the Google Cloud Storage API to get information about the bucket,
  * such as its location, storage class, and other configuration details.
  *
- * @param {Bucket} bucket - The Google Cloud Storage bucket object.
- * @param {GetBucketMetadataOptions} [options] - Optional configuration options to pass to the `getMetadata` method.
- * @returns {Promise<Outcome.Either<BucketMetadata, string>>} A promise that resolves to an `Outcome.Either`.
+ * @param bucket - The Google Cloud Storage bucket object.
+ * @param [options] - Optional configuration options to pass to the `getMetadata` method.
+ * @returns A promise that resolves to an `Outcome.Either`.
  * - On success: `Outcome.makeSuccess(metadata)` with the bucket metadata.
  * - On failure: `Outcome.makeFailure(errStr)` with an error message.
  *

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

@@ -1,4 +1,4 @@
-import { type Bucket, type GetFileOptions, type CopyOptions as GCSCopyOptions } from '@google-cloud/storage';
+import type { Bucket, GetFileOptions, CopyOptions as GCSCopyOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type CopyDirOptions = {
     getFileOptions?: GetFileOptions;
@@ -10,12 +10,12 @@ export type CopyDirOptions = {
 };
 /** 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`:
+ * @param bucket - The GCS bucket instance.
+ * @param sourceDir - The source directory path (prefix) to copy from.
+ * @param targetDir - The target directory path (prefix) to copy to.
+ * @param [options] - Optional parameters for the operation.
+ * @param [options.overwrite=false] - Whether to overwrite existing files at target.
+ * @returns 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.
  * */

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

@@ -2,12 +2,12 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
 /** 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`:
+ * @param bucket - The GCS bucket instance.
+ * @param sourceDir - The source directory path (prefix) to copy from.
+ * @param targetDir - The target directory path (prefix) to copy to.
+ * @param [options] - Optional parameters for the operation.
+ * @param [options.overwrite=false] - Whether to overwrite existing files at target.
+ * @returns 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.
  * */

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

@@ -1,4 +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'
+export * as moveDir from './move-dir/index.js'

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

@@ -1,4 +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'
+export * as moveDir from './move-dir/index.js'

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions } from '@google-cloud/storage';
+import type { Bucket, FileOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type ListOptions = {
     fileOptions?: FileOptions;
@@ -8,10 +8,10 @@ export type ListOptions = {
  *
  * 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.
+ * @param bucket - The GCS bucket to list files from.
+ * @param directoryPath - The directory prefix to list files under.
+ * @param [options] - Optional configuration for the listing.
+ * @param [options.fileOptions] - Additional options for file retrieval.
+ * @returns 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

@@ -5,11 +5,11 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  *
  * 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.
+ * @param bucket - The GCS bucket to list files from.
+ * @param directoryPath - The directory prefix to list files under.
+ * @param [options] - Optional configuration for the listing.
+ * @param [options.fileOptions] - Additional options for file retrieval.
+ * @returns Returns either a success with an array of file paths, or a failure with an error message.
  */
 export async function list(bucket, directoryPath, options) {
     const { fileOptions } = options ?? {};

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions, type CopyOptions as GCSCopyOptions, type DeleteFileOptions as GCSDeleteOptions } from '@google-cloud/storage';
+import type { Bucket, FileOptions, CopyOptions as GCSCopyOptions, DeleteFileOptions as GCSDeleteOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type MoveDirOptions = {
     fileOptions?: FileOptions;
@@ -20,11 +20,11 @@ export type MoveDirOptions = {
  * 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>>}
+ * @param bucket - The GCS bucket instance.
+ * @param sourceDir - The source directory prefix to move from.
+ * @param targetDir - The target directory prefix to move to.
+ * @param [options] - Optional parameters for the operation.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)`.
  * - On failure: `Outcome.makeFailure(errStr)`.
  */

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

@@ -10,11 +10,11 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  * 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>>}
+ * @param bucket - The GCS bucket instance.
+ * @param sourceDir - The source directory prefix to move from.
+ * @param targetDir - The target directory prefix to move to.
+ * @param [options] - Optional parameters for the operation.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)`.
  * - On failure: `Outcome.makeFailure(errStr)`.
  */

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

@@ -1,4 +1,4 @@
-import { type Bucket, type DeleteFileOptions as GCSDeleteFileOptions } from '@google-cloud/storage';
+import type { Bucket, DeleteFileOptions as GCSDeleteFileOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type RemoveDirOptions = {
     /** Extra parameters forwarded to `bucket.deleteFiles`. */
@@ -17,12 +17,12 @@ export type RemoveDirOptions = {
  * 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>>}
+ * @param bucket - The GCS bucket instance.
+ * @param directoryPath - The “directory” prefix to delete.
+ * @param [options] - Optional configuration.
+ * @param [options.deleteOptions] - Extra delete parameters.
+ * @param [options.ignoreMissing=true] - Whether to ignore an empty/missing prefix.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)` if deletion succeeds
  *   (or prefix absent and `ignoreMissing` is true).
  * - On failure: `Outcome.makeFailure(errStr)` if deletion fails

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

@@ -4,12 +4,12 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  * 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>>}
+ * @param bucket - The GCS bucket instance.
+ * @param directoryPath - The “directory” prefix to delete.
+ * @param [options] - Optional configuration.
+ * @param [options.deleteOptions] - Extra delete parameters.
+ * @param [options.ignoreMissing=true] - Whether to ignore an empty/missing prefix.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)` if deletion succeeds
  *   (or prefix absent and `ignoreMissing` is true).
  * - On failure: `Outcome.makeFailure(errStr)` if deletion fails

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions, type CopyOptions as GCSFileCopyOptions } from '@google-cloud/storage';
+import type { Bucket, FileOptions, CopyOptions as GCSFileCopyOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type CopyOptions = {
     /** Additional options for constructing the `File` handles. */
@@ -18,14 +18,14 @@ export type CopyOptions = {
  * 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>>}
+ * @param bucket - The Google Cloud Storage bucket containing the file.
+ * @param sourcePath - The path of the source object to copy.
+ * @param targetPath - The destination path for the copied object.
+ * @param [options] - Optional copy configuration.
+ * @param [options.fileOptions] - Extra options for `bucket.file`.
+ * @param [options.copyOptions] - Extra options for `file.copy`.
+ * @param [options.overwrite=false] - Whether to overwrite an existing destination object.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -6,14 +6,14 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
  * 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>>}
+ * @param bucket - The Google Cloud Storage bucket containing the file.
+ * @param sourcePath - The path of the source object to copy.
+ * @param targetPath - The destination path for the copied object.
+ * @param [options] - Optional copy configuration.
+ * @param [options.fileOptions] - Extra options for `bucket.file`.
+ * @param [options.copyOptions] - Extra options for `file.copy`.
+ * @param [options.overwrite=false] - Whether to overwrite an existing destination object.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -1,5 +1,5 @@
-import { type Readable } from 'node:stream';
-import { type Bucket, type FileOptions, type DownloadOptions as GCSFileDownloadOptions } from '@google-cloud/storage';
+import type { Readable } from 'node:stream';
+import type { Bucket, FileOptions, DownloadOptions as GCSFileDownloadOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type DownloadOptions = {
     fileOptions?: FileOptions;
@@ -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 {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`.
+ * @param bucket - The Google Cloud Storage bucket object from which to download the file.
+ * @param sourcePath - The path of the file to be downloaded in the bucket.
+ * @param [options] - Optional configuration options for the download.
+ * @returns 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(bucket: Bucket, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;
+export declare function download(bucket: Bucket, sourcePath: string, options?: DownloadOptions): Outcome.Either<Readable, string>;

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

@@ -6,14 +6,14 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
  * 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`.
+ * @param bucket - The Google Cloud Storage bucket object from which to download the file.
+ * @param sourcePath - The path of the file to be downloaded in the bucket.
+ * @param [options] - Optional configuration options for the download.
+ * @returns 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) {
+export function download(bucket, sourcePath, options) {
     const { fileOptions, downloadOptions } = options ?? {};
     try {
         const file = bucket.file(sourcePath, fileOptions);

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions, type FileExistsOptions as GCSFileExistsOptions } from '@google-cloud/storage';
+import type { Bucket, FileOptions, FileExistsOptions as GCSFileExistsOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type ExistsOptions = {
     fileOptions?: FileOptions;
@@ -9,11 +9,11 @@ export type ExistsOptions = {
  *
  * 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.
+ * @param bucket - The GCS bucket to check for the file existence.
+ * @param sourcePath - The path of the file to check within the bucket.
+ * @param [options] - Optional configuration for the file existence check.
+ * @param [options.fileOptions] - Additional options for the file, such as custom metadata or ACL settings.
+ * @param [options.existsOptions] - Options for controlling the `exists` method (if any).
+ * @returns - Returns either a success with `true` or `false` indicating whether the file exists, or a failure with an error message.
  */
 export declare function exists(bucket: Bucket, sourcePath: string, options?: ExistsOptions): Promise<Outcome.Either<boolean, string>>;

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

@@ -5,12 +5,12 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  *
  * 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.
+ * @param bucket - The GCS bucket to check for the file existence.
+ * @param sourcePath - The path of the file to check within the bucket.
+ * @param [options] - Optional configuration for the file existence check.
+ * @param [options.fileOptions] - Additional options for the file, such as custom metadata or ACL settings.
+ * @param [options.existsOptions] - Options for controlling the `exists` method (if any).
+ * @returns - 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 ?? {};

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions, type GetSignedUrlConfig } from '@google-cloud/storage';
+import type { Bucket, FileOptions, GetSignedUrlConfig } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type GenerateSignedUrlOptions = {
     fileOptions?: FileOptions;
@@ -11,12 +11,12 @@ 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 {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`.
+ * @param bucket - The Google Cloud Storage bucket object containing the file.
+ * @param sourcePath - The path of the file for which the signed URL is being generated.
+ * @param action - The action allowed by the signed URL (e.g., 'read', 'write', 'delete').
+ * @param expiresOn - The expiration time of the signed URL, after which it is no longer valid.
+ * @param [options] - Optional configuration options for generating the signed URL.
+ * @returns 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.
  */

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

@@ -7,12 +7,12 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
  * 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`.
+ * @param bucket - The Google Cloud Storage bucket object containing the file.
+ * @param sourcePath - The path of the file for which the signed URL is being generated.
+ * @param action - The action allowed by the signed URL (e.g., 'read', 'write', 'delete').
+ * @param expiresOn - The expiration time of the signed URL, after which it is no longer valid.
+ * @param [options] - Optional configuration options for generating the signed URL.
+ * @returns 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.
  */

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions, type GetFileMetadataOptions as GCSGetFileMetadataOptions, type FileMetadata } from '@google-cloud/storage';
+import type { Bucket, FileOptions, GetFileMetadataOptions as GCSGetFileMetadataOptions, FileMetadata } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type GetMetadataOptions = {
     fileOptions?: FileOptions;
@@ -10,10 +10,10 @@ 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 {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`.
+ * @param bucket - The Google Cloud Storage bucket object containing the file whose metadata is being retrieved.
+ * @param sourcePath - The path of the file whose metadata is to be fetched.
+ * @param [options] - Optional configuration options for the file metadata retrieval.
+ * @returns 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.
  *

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

@@ -6,10 +6,10 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
  * 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`.
+ * @param bucket - The Google Cloud Storage bucket object containing the file whose metadata is being retrieved.
+ * @param sourcePath - The path of the file whose metadata is to be fetched.
+ * @param [options] - Optional configuration options for the file metadata retrieval.
+ * @returns 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.
  *

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

@@ -1,4 +1,4 @@
-import { type Bucket, type FileOptions, type GetAclOptions } from '@google-cloud/storage';
+import type { Bucket, FileOptions, GetAclOptions } from '@google-cloud/storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type GetPermissionsOptions = {
     fileOptions?: FileOptions;
@@ -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 {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`.
+ * @param bucket - The Google Cloud Storage bucket containing the file.
+ * @param sourcePath - The path of the file whose permissions need to be retrieved.
+ * @param [options] - Optional configuration options for the file and ACL retrieval.
+ * @returns 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(bucket: Bucket, sourcePath: string, options?: GetPermissionsOptions): Promise<Outcome.Either<any, string>>;
+export declare function getPermissions(bucket: Bucket, sourcePath: string, options?: GetPermissionsOptions): Promise<Outcome.Either<unknown, string>>;

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

@@ -5,10 +5,10 @@ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
  *
  * 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`.
+ * @param bucket - The Google Cloud Storage bucket containing the file.
+ * @param sourcePath - The path of the file whose permissions need to be retrieved.
+ * @param [options] - Optional configuration options for the file and ACL retrieval.
+ * @returns 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.
  */

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

@@ -1,6 +1,6 @@
+export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
-export * as copy from './copy/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'