@design-edito/tools 0.2.37 → 0.2.40

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

@@ -1,5 +1,5 @@
 import { Bucket, FileOptions, DeleteFileOptions as GCSDeleteFileOptions } from '@google-cloud/storage';
-import { Outcome } from '../../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type RemoveOptions = {
     fileOptions?: FileOptions;
     deleteOptions?: GCSDeleteFileOptions;

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

@@ -1,9 +1,9 @@
 import {
   remove
-} from "../../../../../chunks/chunk-7J7CYOXU.js";
-import "../../../../../chunks/chunk-JMU5PDBD.js";
+} from "../../../../../chunks/chunk-66BURDRK.js";
+import "../../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../../chunks/chunk-XCBH6NLF.js";
 export {
   remove
 };

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

@@ -1,5 +1,5 @@
 import { Bucket } from '@google-cloud/storage';
-import { Outcome } from '../../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { DownloadOptions } from '../download/index.js';
 import { RemoveOptions } from '../remove/index.js';
 import { UploadOptions } from '../upload/index.js';

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

@@ -1,12 +1,30 @@
 import {
-  revokeSignedUrls
-} from "../../../../../chunks/chunk-S4VO4PFZ.js";
-import "../../../../../chunks/chunk-FB3GNE2B.js";
-import "../../../../../chunks/chunk-7J7CYOXU.js";
-import "../../../../../chunks/chunk-2JH4TCT2.js";
-import "../../../../../chunks/chunk-JMU5PDBD.js";
+  remove
+} from "../../../../../chunks/chunk-66BURDRK.js";
+import {
+  upload
+} from "../../../../../chunks/chunk-UZ4SWSOZ.js";
+import {
+  download
+} from "../../../../../chunks/chunk-O66PEU62.js";
+import {
+  makeSuccess
+} from "../../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../../chunks/chunk-XCBH6NLF.js";
+
+// src/node/@google-cloud/storage/file/revoke-signed-urls/index.ts
+async function revokeSignedUrls(bucket, targetPath, options) {
+  const { downloadOptions, removeOptions, uploadOptions } = options ?? {};
+  const downloadAttempt = await download(bucket, targetPath, downloadOptions);
+  if (!downloadAttempt.success) return downloadAttempt;
+  const deletionAttempt = await remove(bucket, targetPath, removeOptions);
+  if (!deletionAttempt.success) return deletionAttempt;
+  const downloaded = downloadAttempt.payload;
+  const reuploadAttempt = await upload(bucket, targetPath, downloaded, uploadOptions);
+  if (!reuploadAttempt.success) return reuploadAttempt;
+  return makeSuccess(true);
+}
 export {
   revokeSignedUrls
 };

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

@@ -1,5 +1,5 @@
 import { Bucket, FileOptions, GetFileMetadataOptions, FileMetadata } from '@google-cloud/storage';
-import { Outcome } from '../../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 /** Provider‑agnostic view + strongly‑typed raw metadata */
 export interface Stat {
     size?: number;

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

@@ -1,9 +1,9 @@
 import {
   stat
-} from "../../../../../chunks/chunk-W3RXHN5I.js";
-import "../../../../../chunks/chunk-JMU5PDBD.js";
+} from "../../../../../chunks/chunk-FSI422YG.js";
+import "../../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../../chunks/chunk-XCBH6NLF.js";
 export {
   stat
 };

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

@@ -1,5 +1,5 @@
 import { Bucket, FileOptions, SetFileMetadataOptions } from '@google-cloud/storage';
-import { Outcome } from '../../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type UpdateFileMetadataOptions = {
     fileOptions?: FileOptions;
     metadataOptions?: SetFileMetadataOptions;

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

@@ -1,9 +1,24 @@
 import {
-  updateFileMetadata
-} from "../../../../../chunks/chunk-HWVEI3RH.js";
-import "../../../../../chunks/chunk-JMU5PDBD.js";
-import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-WSFCRVEQ.js";
+  makeFailure,
+  makeSuccess
+} from "../../../../../chunks/chunk-QEKI6WGQ.js";
+import {
+  unknownToString
+} from "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-XCBH6NLF.js";
+
+// src/node/@google-cloud/storage/file/update-metadata/index.ts
+async function updateFileMetadata(bucket, targetPath, metadata, options) {
+  const { fileOptions, metadataOptions } = options ?? {};
+  try {
+    const file = bucket.file(targetPath, fileOptions);
+    await file.setMetadata(metadata, metadataOptions);
+    return makeSuccess(true);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return makeFailure(errStr);
+  }
+}
 export {
   updateFileMetadata
 };

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

@@ -1,6 +1,6 @@
 import { Readable } from 'node:stream';
 import { Bucket, FileOptions, SaveOptions } from '@google-cloud/storage';
-import { Outcome } from '../../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 export type UploadOptions = {
     fileOptions?: FileOptions;
     saveOptions?: SaveOptions;

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

@@ -1,9 +1,9 @@
 import {
   upload
-} from "../../../../../chunks/chunk-FB3GNE2B.js";
-import "../../../../../chunks/chunk-JMU5PDBD.js";
+} from "../../../../../chunks/chunk-UZ4SWSOZ.js";
+import "../../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../../chunks/chunk-XCBH6NLF.js";
 export {
   upload
 };

package/node/cloud-storage/clients/index.d.ts

@@ -3,11 +3,38 @@ import { S3Client } from '@aws-sdk/client-s3';
 import { Client as FtpClient } from 'basic-ftp';
 import SftpClient from 'ssh2-sftp-client';
 export type S3ClientWithBucket = {
+    /** The name of the S3 bucket. */
     bucketName: string;
+    /** The AWS S3 client instance. */
     client: S3Client;
 };
+/** Union type representing any supported cloud storage client. */
 export type AnyClient = GCSBucket | S3ClientWithBucket | FtpClient | SftpClient;
+/**
+ * Type guard to check if a client is a Google Cloud Storage bucket.
+ *
+ * @param {AnyClient} client - The client to check.
+ * @returns {boolean} `true` if the client is a `GCSBucket`, `false` otherwise.
+ */
 export declare const isGcsBucket: (client: AnyClient) => client is GCSBucket;
+/**
+ * Type guard to check if a client is an S3 client with bucket configuration.
+ *
+ * @param {AnyClient} client - The client to check.
+ * @returns {boolean} `true` if the client is an `S3ClientWithBucket`, `false` otherwise.
+ */
 export declare const isS3ClientWithBucket: (client: AnyClient) => client is S3ClientWithBucket;
+/**
+ * Type guard to check if a client is an FTP client.
+ *
+ * @param {AnyClient} client - The client to check.
+ * @returns {boolean} `true` if the client is an `FtpClient`, `false` otherwise.
+ */
 export declare const isFtpClient: (client: AnyClient) => client is FtpClient;
+/**
+ * Type guard to check if a client is an SFTP client.
+ *
+ * @param {AnyClient} client - The client to check.
+ * @returns {boolean} `true` if the client is an `SftpClient`, `false` otherwise.
+ */
 export declare const isSftpClient: (client: AnyClient) => client is SftpClient;

package/node/cloud-storage/clients/index.js

@@ -3,8 +3,8 @@ import {
   isGcsBucket,
   isS3ClientWithBucket,
   isSftpClient
-} from "../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
+} from "../../../chunks/chunk-ISJONMNA.js";
+import "../../../chunks/chunk-XCBH6NLF.js";
 export {
   isFtpClient,
   isGcsBucket,

package/node/cloud-storage/operations/copy-dir/index.d.ts

@@ -1,15 +1,60 @@
 import { Bucket as GCSBucket } from '@google-cloud/storage';
 import { Client as FtpClient } from 'basic-ftp';
 import SftpClient from 'ssh2-sftp-client';
-import { Outcome } from '../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 import { S3ClientWithBucket } from '../../clients/index.js';
 import { CopyDirOptions as FtpsCopyDirOptions } from '../../../ftps/directory/copy-dir/index.js';
 import { CopyDirOptions as SftpCopyDirOptions } from '../../../sftp/directory/copy-dir/index.js';
 import { CopyDirOptions as S3CopyDirOptions } from '../../../@aws-s3/storage/directory/copy-dir/index.js';
 import { CopyDirOptions as GcsCopyDirOptions } from '../../../@google-cloud/storage/directory/copy-dir/index.js';
+/** Return type for copy directory operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Recursively copies a directory from one path to another using a Google Cloud Storage bucket.
+ *
+ * @param {GCSBucket} client              - The Google Cloud Storage bucket instance.
+ * @param {string}   sourcePath           - The source directory path to copy from.
+ * @param {string}   targetPath           - The target directory path to copy to.
+ * @param {GcsCopyDirOptions} [options]  - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyDir(client: GCSBucket, sourcePath: string, targetPath: string, options?: GcsCopyDirOptions): Promise<Returned>;
+/**
+ * Recursively copies a directory from one path to another using an S3 client.
+ *
+ * @param {S3ClientWithBucket} client    - The S3 client with bucket configuration.
+ * @param {string}   sourcePath           - The source directory path to copy from.
+ * @param {string}   targetPath           - The target directory path to copy to.
+ * @param {S3CopyDirOptions} [options]    - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyDir(client: S3ClientWithBucket, sourcePath: string, targetPath: string, options?: S3CopyDirOptions): Promise<Returned>;
+/**
+ * Recursively copies a directory from one path to another using an FTP client.
+ *
+ * @param {FtpClient} client              - The FTP client instance.
+ * @param {string}   sourcePath           - The source directory path to copy from.
+ * @param {string}   targetPath           - The target directory path to copy to.
+ * @param {FtpsCopyDirOptions} [options]  - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyDir(client: FtpClient, sourcePath: string, targetPath: string, options?: FtpsCopyDirOptions): Promise<Returned>;
+/**
+ * Recursively copies a directory from one path to another using an SFTP client.
+ *
+ * @param {SftpClient} client             - The SFTP client instance.
+ * @param {string}   sourcePath           - The source directory path to copy from.
+ * @param {string}   targetPath           - The target directory path to copy to.
+ * @param {SftpCopyDirOptions} [options]  - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyDir(client: SftpClient, sourcePath: string, targetPath: string, options?: SftpCopyDirOptions): Promise<Returned>;
 export {};

package/node/cloud-storage/operations/copy-dir/index.js

@@ -1,14 +1,35 @@
+import {
+  copyDir as copyDir3
+} from "../../../../chunks/chunk-VU6JYR3W.js";
+import {
+  copyDir as copyDir4
+} from "../../../../chunks/chunk-IBQQCUYV.js";
+import {
+  copyDir as copyDir2
+} from "../../../../chunks/chunk-OF2W4ZRG.js";
 import {
   copyDir
-} from "../../../../chunks/chunk-R4DZKWSR.js";
-import "../../../../chunks/chunk-V3L55I2S.js";
-import "../../../../chunks/chunk-4XBUJAQU.js";
-import "../../../../chunks/chunk-WAHPAZQS.js";
-import "../../../../chunks/chunk-N2T672IG.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+} from "../../../../chunks/chunk-RGQNRTBI.js";
+import {
+  isFtpClient,
+  isGcsBucket,
+  isS3ClientWithBucket,
+  isSftpClient
+} from "../../../../chunks/chunk-ISJONMNA.js";
+import {
+  makeFailure
+} from "../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../chunks/chunk-XCBH6NLF.js";
+
+// src/node/cloud-storage/operations/copy-dir/index.ts
+async function copyDir5(client, sourcePath, targetPath, options) {
+  if (isGcsBucket(client)) return copyDir4(client, sourcePath, targetPath, options);
+  if (isS3ClientWithBucket(client)) return copyDir3(client.client, client.bucketName, sourcePath, targetPath, options);
+  if (isFtpClient(client)) return copyDir(client, sourcePath, targetPath);
+  if (isSftpClient(client)) return copyDir2(client, sourcePath, targetPath);
+  return makeFailure("Invalid client type");
+}
 export {
-  copyDir
+  copyDir5 as copyDir
 };

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

@@ -1,15 +1,60 @@
 import { Bucket as GCSBucket } from '@google-cloud/storage';
 import { Client as FtpClient } from 'basic-ftp';
 import SftpClient from 'ssh2-sftp-client';
-import { Outcome } from '../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 import { S3ClientWithBucket } from '../../clients/index.js';
 import { CopyOptions as FtpsCopyOptions } from '../../../ftps/file/copy/index.js';
 import { CopyOptions as SftpCopyOptions } from '../../../sftp/file/copy/index.js';
 import { CopyOptions as S3CopyOptions } from '../../../@aws-s3/storage/file/copy/index.js';
 import { CopyOptions as GcsCopyOptions } from '../../../@google-cloud/storage/file/copy/index.js';
+/** Return type for copy file operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Copies a file from one path to another using a Google Cloud Storage bucket.
+ *
+ * @param {GCSBucket} client              - The Google Cloud Storage bucket instance.
+ * @param {string}   sourcePath           - The source file path to copy from.
+ * @param {string}   targetPath           - The target file path to copy to.
+ * @param {GcsCopyOptions} [options]      - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyFile(client: GCSBucket, sourcePath: string, targetPath: string, options?: GcsCopyOptions): Promise<Returned>;
+/**
+ * Copies a file from one path to another using an S3 client.
+ *
+ * @param {S3ClientWithBucket} client     - The S3 client with bucket configuration.
+ * @param {string}   sourcePath           - The source file path to copy from.
+ * @param {string}   targetPath           - The target file path to copy to.
+ * @param {S3CopyOptions} [options]       - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyFile(client: S3ClientWithBucket, sourcePath: string, targetPath: string, options?: S3CopyOptions): Promise<Returned>;
+/**
+ * Copies a file from one path to another using an FTP client.
+ *
+ * @param {FtpClient} client              - The FTP client instance.
+ * @param {string}   sourcePath           - The source file path to copy from.
+ * @param {string}   targetPath           - The target file path to copy to.
+ * @param {FtpsCopyOptions} [options]      - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyFile(client: FtpClient, sourcePath: string, targetPath: string, options?: FtpsCopyOptions): Promise<Returned>;
+/**
+ * Copies a file from one path to another using an SFTP client.
+ *
+ * @param {SftpClient} client             - The SFTP client instance.
+ * @param {string}   sourcePath           - The source file path to copy from.
+ * @param {string}   targetPath           - The target file path to copy to.
+ * @param {SftpCopyOptions} [options]     - Optional copy configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function copyFile(client: SftpClient, sourcePath: string, targetPath: string, options?: SftpCopyOptions): Promise<Returned>;
 export {};

package/node/cloud-storage/operations/copy-file/index.js

@@ -1,14 +1,35 @@
 import {
-  copyFile
-} from "../../../../chunks/chunk-BDGFY3GP.js";
-import "../../../../chunks/chunk-CWZFRUBS.js";
-import "../../../../chunks/chunk-C6QTHDDM.js";
-import "../../../../chunks/chunk-QH64MYGA.js";
-import "../../../../chunks/chunk-NMYVJJXV.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  copy as copy4
+} from "../../../../chunks/chunk-S6ZFFGWH.js";
+import {
+  copy as copy3
+} from "../../../../chunks/chunk-YOP6WVCF.js";
+import {
+  copy as copy2
+} from "../../../../chunks/chunk-O7UCJNVF.js";
+import {
+  copy
+} from "../../../../chunks/chunk-7B2E2NGH.js";
+import {
+  isFtpClient,
+  isGcsBucket,
+  isS3ClientWithBucket,
+  isSftpClient
+} from "../../../../chunks/chunk-ISJONMNA.js";
+import {
+  makeFailure
+} from "../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../chunks/chunk-XCBH6NLF.js";
+
+// src/node/cloud-storage/operations/copy-file/index.ts
+async function copyFile(client, sourcePath, targetPath, options) {
+  if (isGcsBucket(client)) return copy4(client, sourcePath, targetPath, options);
+  if (isS3ClientWithBucket(client)) return copy3(client.client, client.bucketName, sourcePath, targetPath, options);
+  if (isFtpClient(client)) return copy(client, sourcePath, targetPath, options);
+  if (isSftpClient(client)) return copy2(client, sourcePath, targetPath, options);
+  return makeFailure("Invalid client type");
+}
 export {
   copyFile
 };

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

@@ -2,15 +2,64 @@ import { Readable } from 'node:stream';
 import { Bucket as GCSBucket } from '@google-cloud/storage';
 import { Client as FtpClient } from 'basic-ftp';
 import SftpClient from 'ssh2-sftp-client';
-import { Outcome } from '../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 import { S3ClientWithBucket } from '../../clients/index.js';
 import { DownloadOptions as FtpDownloadOptions } from '../../../ftps/file/download/index.js';
 import { DownloadOptions as SftpDownloadOptions } from '../../../sftp/file/download/index.js';
 import { DownloadOptions as S3DownloadOptions } from '../../../@aws-s3/storage/file/download/index.js';
 import { DownloadOptions as GcsDownloadOptions } from '../../../@google-cloud/storage/file/download/index.js';
+/** Return type for download file operations. */
 type Returned = Outcome.Either<Readable, string>;
+/**
+ * Downloads a file from a Google Cloud Storage bucket.
+ *
+ * The function streams the file's content back as a Node `Readable`.
+ *
+ * @param {GCSBucket} client              - The Google Cloud Storage bucket instance.
+ * @param {string}   path                 - The path of the file to download.
+ * @param {GcsDownloadOptions} [options] - Optional download configuration.
+ * @returns {Promise<Outcome.Either<Readable, string>>}
+ * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function downloadFile(client: GCSBucket, path: string, options?: GcsDownloadOptions): Promise<Returned>;
+/**
+ * Downloads a file from an S3 bucket.
+ *
+ * The function streams the file's content back as a Node `Readable`.
+ *
+ * @param {S3ClientWithBucket} client     - The S3 client with bucket configuration.
+ * @param {string}   path                 - The path of the file to download.
+ * @param {S3DownloadOptions} [options]   - Optional download configuration.
+ * @returns {Promise<Outcome.Either<Readable, string>>}
+ * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function downloadFile(client: S3ClientWithBucket, path: string, options?: S3DownloadOptions): Promise<Returned>;
+/**
+ * Downloads a file from an FTP server.
+ *
+ * The function streams the file's content back as a Node `Readable`.
+ *
+ * @param {FtpClient} client              - The FTP client instance.
+ * @param {string}   path                 - The path of the file to download.
+ * @param {FtpDownloadOptions} [options]  - Optional download configuration.
+ * @returns {Promise<Outcome.Either<Readable, string>>}
+ * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function downloadFile(client: FtpClient, path: string, options?: FtpDownloadOptions): Promise<Returned>;
+/**
+ * Downloads a file from an SFTP server.
+ *
+ * The function streams the file's content back as a Node `Readable`.
+ *
+ * @param {SftpClient} client              - The SFTP client instance.
+ * @param {string}   path                  - The path of the file to download.
+ * @param {SftpDownloadOptions} [options] - Optional download configuration.
+ * @returns {Promise<Outcome.Either<Readable, string>>}
+ * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function downloadFile(client: SftpClient, path: string, options?: SftpDownloadOptions): Promise<Returned>;
 export {};

package/node/cloud-storage/operations/download-file/index.js

@@ -1,14 +1,35 @@
 import {
-  downloadFile
-} from "../../../../chunks/chunk-X53BGT33.js";
-import "../../../../chunks/chunk-2JH4TCT2.js";
-import "../../../../chunks/chunk-IV75M3KE.js";
-import "../../../../chunks/chunk-HWEGQVBQ.js";
-import "../../../../chunks/chunk-FF5NURFO.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  download as download4
+} from "../../../../chunks/chunk-O66PEU62.js";
+import {
+  download as download3
+} from "../../../../chunks/chunk-5O52VUI6.js";
+import {
+  download as download2
+} from "../../../../chunks/chunk-ULYGDEW2.js";
+import {
+  download
+} from "../../../../chunks/chunk-54KPQCVI.js";
+import {
+  isFtpClient,
+  isGcsBucket,
+  isS3ClientWithBucket,
+  isSftpClient
+} from "../../../../chunks/chunk-ISJONMNA.js";
+import {
+  makeFailure
+} from "../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../chunks/chunk-XCBH6NLF.js";
+
+// src/node/cloud-storage/operations/download-file/index.ts
+async function downloadFile(client, path, options) {
+  if (isGcsBucket(client)) return download4(client, path, options);
+  if (isS3ClientWithBucket(client)) return download3(client.client, client.bucketName, path, options);
+  if (isFtpClient(client)) return download(client, path, options);
+  if (isSftpClient(client)) return download2(client, path, options);
+  return makeFailure("Invalid client type");
+}
 export {
   downloadFile
 };

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

@@ -1,13 +1,56 @@
 import { Bucket as GCSBucket } from '@google-cloud/storage';
 import { Client as FtpClient } from 'basic-ftp';
 import SftpClient from 'ssh2-sftp-client';
-import { Outcome } from '../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 import { S3ClientWithBucket } from '../../clients/index.js';
 import { ExistsOptions as S3ExistsOptions } from '../../../@aws-s3/storage/file/exists/index.js';
 import { ExistsOptions as GcsExistsOptions } from '../../../@google-cloud/storage/file/exists/index.js';
+/** Return type for file existence checks. */
 type Returned = Outcome.Either<boolean, string>;
+/**
+ * Checks whether a file exists in a Google Cloud Storage bucket.
+ *
+ * @param {GCSBucket} client              - The Google Cloud Storage bucket instance.
+ * @param {string}   path                 - The path of the file to check.
+ * @param {GcsExistsOptions} [options]    - Optional configuration.
+ * @returns {Promise<Outcome.Either<boolean, string>>}
+ * - On success:  `Outcome.makeSuccess(true)` if the file exists,
+ *                `Outcome.makeSuccess(false)` if it does not.
+ * - On failure:  `Outcome.makeFailure(errStr)` for unexpected errors.
+ */
 export declare function existsFile(client: GCSBucket, path: string, options?: GcsExistsOptions): Promise<Returned>;
+/**
+ * Checks whether a file exists in an S3 bucket.
+ *
+ * @param {S3ClientWithBucket} client     - The S3 client with bucket configuration.
+ * @param {string}   path                 - The path of the file to check.
+ * @param {S3ExistsOptions} [options]    - Optional configuration.
+ * @returns {Promise<Outcome.Either<boolean, string>>}
+ * - On success:  `Outcome.makeSuccess(true)` if the file exists,
+ *                `Outcome.makeSuccess(false)` if it does not.
+ * - On failure:  `Outcome.makeFailure(errStr)` for unexpected errors.
+ */
 export declare function existsFile(client: S3ClientWithBucket, path: string, options?: S3ExistsOptions): Promise<Returned>;
+/**
+ * Checks whether a file exists on an FTP server.
+ *
+ * @param {FtpClient} client              - The FTP client instance.
+ * @param {string}   path                 - The path of the file to check.
+ * @returns {Promise<Outcome.Either<boolean, string>>}
+ * - On success:  `Outcome.makeSuccess(true)` if the file exists,
+ *                `Outcome.makeSuccess(false)` if it does not.
+ * - On failure:  `Outcome.makeFailure(errStr)` for unexpected errors.
+ */
 export declare function existsFile(client: FtpClient, path: string): Promise<Returned>;
+/**
+ * Checks whether a file exists on an SFTP server.
+ *
+ * @param {SftpClient} client             - The SFTP client instance.
+ * @param {string}   path                 - The path of the file to check.
+ * @returns {Promise<Outcome.Either<boolean, string>>}
+ * - On success:  `Outcome.makeSuccess(true)` if the file exists,
+ *                `Outcome.makeSuccess(false)` if it does not.
+ * - On failure:  `Outcome.makeFailure(errStr)` for unexpected errors.
+ */
 export declare function existsFile(client: SftpClient, path: string): Promise<Returned>;
 export {};

package/node/cloud-storage/operations/exists-file/index.js

@@ -1,14 +1,35 @@
 import {
-  existsFile
-} from "../../../../chunks/chunk-AL7ESVX4.js";
-import "../../../../chunks/chunk-5VHFXWFM.js";
-import "../../../../chunks/chunk-ZEZCYPLQ.js";
-import "../../../../chunks/chunk-QVPS2BCJ.js";
-import "../../../../chunks/chunk-ZJTWDCNZ.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  exists as exists4
+} from "../../../../chunks/chunk-NEMHJSNM.js";
+import {
+  exists as exists3
+} from "../../../../chunks/chunk-6BGIDRU5.js";
+import {
+  exists as exists2
+} from "../../../../chunks/chunk-JU23NBY2.js";
+import {
+  exists
+} from "../../../../chunks/chunk-J5D4OQ5U.js";
+import {
+  isFtpClient,
+  isGcsBucket,
+  isS3ClientWithBucket,
+  isSftpClient
+} from "../../../../chunks/chunk-ISJONMNA.js";
+import {
+  makeFailure
+} from "../../../../chunks/chunk-QEKI6WGQ.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+import "../../../../chunks/chunk-XCBH6NLF.js";
+
+// src/node/cloud-storage/operations/exists-file/index.ts
+async function existsFile(client, path, options) {
+  if (isGcsBucket(client)) return exists4(client, path, options);
+  if (isS3ClientWithBucket(client)) return exists3(client.client, client.bucketName, path, options);
+  if (isFtpClient(client)) return exists(client, path);
+  if (isSftpClient(client)) return exists2(client, path);
+  return makeFailure("Invalid client type");
+}
 export {
   existsFile
 };