@design-edito/tools 0.2.39 → 0.2.41

package/node/cloud-storage/operations/move-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 { MoveDirOptions as FtpsMoveDirOptions } from '../../../ftps/directory/move-dir/index.js';
 import { MoveDirOptions as SftpMoveDirOptions } from '../../../sftp/directory/move-dir/index.js';
 import { MoveDirOptions as S3MoveDirOptions } from '../../../@aws-s3/storage/directory/move-dir/index.js';
 import { MoveDirOptions as GcsMoveDirOptions } from '../../../@google-cloud/storage/directory/move-dir/index.js';
+/** Return type for move directory operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target directory path to move to.
+ * @param {GcsMoveDirOptions} [options]    - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveDir(client: GCSBucket, sourcePath: string, targetPath: string, options?: GcsMoveDirOptions): Promise<Returned>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target directory path to move to.
+ * @param {S3MoveDirOptions} [options]     - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveDir(client: S3ClientWithBucket, sourcePath: string, targetPath: string, options?: S3MoveDirOptions): Promise<Returned>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target directory path to move to.
+ * @param {FtpsMoveDirOptions} [options]   - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveDir(client: FtpClient, sourcePath: string, targetPath: string, options?: FtpsMoveDirOptions): Promise<Returned>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target directory path to move to.
+ * @param {SftpMoveDirOptions} [options]   - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveDir(client: SftpClient, sourcePath: string, targetPath: string, options?: SftpMoveDirOptions): Promise<Returned>;
 export {};

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

@@ -1,14 +1,35 @@
+import {
+  moveDir as moveDir4
+} from "../../../../chunks/chunk-NIIAUOBO.js";
+import {
+  moveDir as moveDir3
+} from "../../../../chunks/chunk-2WSVYQ5Q.js";
+import {
+  moveDir as moveDir2
+} from "../../../../chunks/chunk-JN2UETL4.js";
 import {
   moveDir
-} from "../../../../chunks/chunk-MVYH3CSJ.js";
-import "../../../../chunks/chunk-BWYH445G.js";
-import "../../../../chunks/chunk-ON6LC3HE.js";
-import "../../../../chunks/chunk-RWO53U4X.js";
-import "../../../../chunks/chunk-BE7OXZRK.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+} from "../../../../chunks/chunk-PTN2V757.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/move-dir/index.ts
+async function moveDir5(client, sourcePath, targetPath, options) {
+  if (isGcsBucket(client)) return moveDir4(client, sourcePath, targetPath, options);
+  if (isS3ClientWithBucket(client)) return moveDir3(client.client, client.bucketName, sourcePath, targetPath, options);
+  if (isFtpClient(client)) return moveDir(client, sourcePath, targetPath, options);
+  if (isSftpClient(client)) return moveDir2(client, sourcePath, targetPath, options);
+  return makeFailure("Invalid client type");
+}
 export {
-  moveDir
+  moveDir5 as moveDir
 };

package/node/cloud-storage/operations/move-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 { MoveOptions as FtpsMoveOptions } from '../../../ftps/file/move/index.js';
 import { MoveOptions as SftpMoveOptions } from '../../../sftp/file/move/index.js';
 import { MoveOptions as S3MoveOptions } from '../../../@aws-s3/storage/file/move/index.js';
 import { MoveOptions as GcsMoveOptions } from '../../../@google-cloud/storage/file/move/index.js';
+/** Return type for move file operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target file path to move to.
+ * @param {GcsMoveOptions} [options]       - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveFile(client: GCSBucket, sourcePath: string, targetPath: string, options?: GcsMoveOptions): Promise<Returned>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target file path to move to.
+ * @param {S3MoveOptions} [options]        - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveFile(client: S3ClientWithBucket, sourcePath: string, targetPath: string, options?: S3MoveOptions): Promise<Returned>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target file path to move to.
+ * @param {FtpsMoveOptions} [options]      - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveFile(client: FtpClient, sourcePath: string, targetPath: string, options?: FtpsMoveOptions): Promise<Returned>;
+/**
+ * Moves 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 move from.
+ * @param {string}   targetPath           - The target file path to move to.
+ * @param {SftpMoveOptions} [options]      - Optional move configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function moveFile(client: SftpClient, sourcePath: string, targetPath: string, options?: SftpMoveOptions): Promise<Returned>;
 export {};

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

@@ -1,14 +1,35 @@
 import {
-  moveFile
-} from "../../../../chunks/chunk-OC4VIF3N.js";
-import "../../../../chunks/chunk-6IYUA43Q.js";
-import "../../../../chunks/chunk-QWZ4ZNFA.js";
-import "../../../../chunks/chunk-FE4DECBU.js";
-import "../../../../chunks/chunk-HRNDUTZE.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  move as move4
+} from "../../../../chunks/chunk-SBBIQ5UH.js";
+import {
+  move as move3
+} from "../../../../chunks/chunk-AV373PHY.js";
+import {
+  move as move2
+} from "../../../../chunks/chunk-VYDUHDXW.js";
+import {
+  move
+} from "../../../../chunks/chunk-DBZAJJUF.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/move-file/index.ts
+async function moveFile(client, sourcePath, targetPath, options) {
+  if (isGcsBucket(client)) return move4(client, sourcePath, targetPath, options);
+  if (isS3ClientWithBucket(client)) return move3(client.client, client.bucketName, sourcePath, targetPath, options);
+  if (isFtpClient(client)) return move(client, sourcePath, targetPath);
+  if (isSftpClient(client)) return move2(client, sourcePath, targetPath);
+  return makeFailure("Invalid client type");
+}
 export {
   moveFile
 };

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

@@ -1,15 +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 { RemoveDirOptions as FtpsRemoveDirOptions } from '../../../ftps/directory/remove-dir/index.js';
 import { RemoveDirOptions as SftpRemoveDirOptions } from '../../../sftp/directory/remove-dir/index.js';
 import { RemoveDirOptions as S3RemoveDirOptions } from '../../../@aws-s3/storage/directory/remove-dir/index.js';
 import { RemoveDirOptions as GcsRemoveDirOptions } from '../../../@google-cloud/storage/directory/remove-dir/index.js';
+/** Return type for remove directory operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Removes a directory from a Google Cloud Storage bucket.
+ *
+ * @param {GCSBucket} client               - The Google Cloud Storage bucket instance.
+ * @param {string}   sourcePath           - The directory path to remove.
+ * @param {GcsRemoveDirOptions} [options] - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeDir(client: GCSBucket, sourcePath: string, options?: GcsRemoveDirOptions): Promise<Returned>;
+/**
+ * Removes a directory from an S3 bucket.
+ *
+ * @param {S3ClientWithBucket} client      - The S3 client with bucket configuration.
+ * @param {string}   sourcePath           - The directory path to remove.
+ * @param {S3RemoveDirOptions} [options]   - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeDir(client: S3ClientWithBucket, sourcePath: string, options?: S3RemoveDirOptions): Promise<Returned>;
+/**
+ * Removes a directory from an FTP server.
+ *
+ * @param {FtpClient} client               - The FTP client instance.
+ * @param {string}   sourcePath           - The directory path to remove.
+ * @param {FtpsRemoveDirOptions} [options] - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeDir(client: FtpClient, sourcePath: string, options?: FtpsRemoveDirOptions): Promise<Returned>;
+/**
+ * Removes a directory from an SFTP server.
+ *
+ * @param {SftpClient} client              - The SFTP client instance.
+ * @param {string}   sourcePath           - The directory path to remove.
+ * @param {SftpRemoveDirOptions} [options] - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeDir(client: SftpClient, sourcePath: string, options?: SftpRemoveDirOptions): Promise<Returned>;
 export {};

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

@@ -1,14 +1,35 @@
+import {
+  removeDir as removeDir4
+} from "../../../../chunks/chunk-ZTPRFEPV.js";
+import {
+  removeDir as removeDir3
+} from "../../../../chunks/chunk-5X76KDYN.js";
+import {
+  removeDir as removeDir2
+} from "../../../../chunks/chunk-6YVXSCRH.js";
 import {
   removeDir
-} from "../../../../chunks/chunk-GL42Q643.js";
-import "../../../../chunks/chunk-QLDN574K.js";
-import "../../../../chunks/chunk-4XSDRT23.js";
-import "../../../../chunks/chunk-5ZJ3KJPK.js";
-import "../../../../chunks/chunk-BSUQNHAM.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+} from "../../../../chunks/chunk-W5VY535B.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/remove-dir/index.ts
+async function removeDir5(client, sourcePath, options) {
+  if (isGcsBucket(client)) return removeDir4(client, sourcePath, options);
+  if (isS3ClientWithBucket(client)) return removeDir3(client.client, client.bucketName, sourcePath, options);
+  if (isFtpClient(client)) return removeDir(client, sourcePath, options);
+  if (isSftpClient(client)) return removeDir2(client, sourcePath, options);
+  return makeFailure("Invalid client type");
+}
 export {
-  removeDir
+  removeDir5 as removeDir
 };

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

@@ -1,15 +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 { RemoveOptions as FtpRemoveOptions } from '../../../ftps/file/remove/index.js';
 import { RemoveOptions as SftpRemoveOptions } from '../../../sftp/file/remove/index.js';
 import { RemoveOptions as S3RemoveOptions } from '../../../@aws-s3/storage/file/remove/index.js';
 import { RemoveOptions as GcsRemoveOptions } from '../../../@google-cloud/storage/file/remove/index.js';
+/** Return type for remove file operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Removes a file from a Google Cloud Storage bucket.
+ *
+ * @param {GCSBucket} client               - The Google Cloud Storage bucket instance.
+ * @param {string}   path                 - The file path to remove.
+ * @param {GcsRemoveOptions} [options]     - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeFile(client: GCSBucket, path: string, options?: GcsRemoveOptions): Promise<Returned>;
+/**
+ * Removes a file from an S3 bucket.
+ *
+ * @param {S3ClientWithBucket} client      - The S3 client with bucket configuration.
+ * @param {string}   path                 - The file path to remove.
+ * @param {S3RemoveOptions} [options]      - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeFile(client: S3ClientWithBucket, path: string, options?: S3RemoveOptions): Promise<Returned>;
+/**
+ * Removes a file from an FTP server.
+ *
+ * @param {FtpClient} client               - The FTP client instance.
+ * @param {string}   path                 - The file path to remove.
+ * @param {FtpRemoveOptions} [options]     - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeFile(client: FtpClient, path: string, options?: FtpRemoveOptions): Promise<Returned>;
+/**
+ * Removes a file from an SFTP server.
+ *
+ * @param {SftpClient} client              - The SFTP client instance.
+ * @param {string}   path                 - The file path to remove.
+ * @param {SftpRemoveOptions} [options]    - Optional remove configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function removeFile(client: SftpClient, path: string, options?: SftpRemoveOptions): Promise<Returned>;
 export {};

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

@@ -1,14 +1,35 @@
 import {
-  removeFile
-} from "../../../../chunks/chunk-ALAGBHFV.js";
-import "../../../../chunks/chunk-7J7CYOXU.js";
-import "../../../../chunks/chunk-WV5N7ESL.js";
-import "../../../../chunks/chunk-ANPXBD2G.js";
-import "../../../../chunks/chunk-KJAEVOIW.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  remove as remove4
+} from "../../../../chunks/chunk-66BURDRK.js";
+import {
+  remove as remove3
+} from "../../../../chunks/chunk-BQXTV2GG.js";
+import {
+  remove as remove2
+} from "../../../../chunks/chunk-BHGRXDTS.js";
+import {
+  remove
+} from "../../../../chunks/chunk-S2I77NEE.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/remove-file/index.ts
+async function removeFile(client, path, options) {
+  if (isGcsBucket(client)) return remove4(client, path, options);
+  if (isS3ClientWithBucket(client)) return remove3(client.client, path, client.bucketName, options);
+  if (isFtpClient(client)) return remove(client, path, options);
+  if (isSftpClient(client)) return remove2(client, path, options);
+  return makeFailure("Invalid client type");
+}
 export {
   removeFile
 };

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

@@ -1,15 +1,54 @@
 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 { Stat as FtpStat } from '../../../ftps/file/stat/index.js';
 import { Stat as SftpStat } from '../../../sftp/file/stat/index.js';
 import { Stat as S3Stat, StatOptions as S3StatOptions } from '../../../@aws-s3/storage/file/stat/index.js';
 import { Stat as GcsStat, StatOptions as GcsStatOptions } from '../../../@google-cloud/storage/file/stat/index.js';
+/** Return type for stat file operations. */
 type Returned<K extends FtpStat | SftpStat | S3Stat | GcsStat> = Outcome.Either<K, string>;
+/**
+ * Retrieves metadata for a file in a Google Cloud Storage bucket.
+ *
+ * @param {GCSBucket} client              - The Google Cloud Storage bucket instance.
+ * @param {string}   path                 - The file path to stat.
+ * @param {GcsStatOptions} [options]       - Optional stat configuration.
+ * @returns {Promise<Outcome.Either<GcsStat, string>>}
+ * - On success:  `Outcome.makeSuccess(stat)` containing file metadata.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function statFile(client: GCSBucket, path: string, options?: GcsStatOptions): Promise<Returned<GcsStat>>;
+/**
+ * Retrieves metadata for a file in an S3 bucket.
+ *
+ * @param {S3ClientWithBucket} client      - The S3 client with bucket configuration.
+ * @param {string}   path                 - The file path to stat.
+ * @param {S3StatOptions} [options]        - Optional stat configuration.
+ * @returns {Promise<Outcome.Either<S3Stat, string>>}
+ * - On success:  `Outcome.makeSuccess(stat)` containing file metadata.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function statFile(client: S3ClientWithBucket, path: string, options?: S3StatOptions): Promise<Returned<S3Stat>>;
+/**
+ * Retrieves metadata for a file on an FTP server.
+ *
+ * @param {FtpClient} client              - The FTP client instance.
+ * @param {string}   path                 - The file path to stat.
+ * @returns {Promise<Outcome.Either<FtpStat, string>>}
+ * - On success:  `Outcome.makeSuccess(stat)` containing file metadata.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function statFile(client: FtpClient, path: string): Promise<Returned<FtpStat>>;
+/**
+ * Retrieves metadata for a file on an SFTP server.
+ *
+ * @param {SftpClient} client             - The SFTP client instance.
+ * @param {string}   path                 - The file path to stat.
+ * @returns {Promise<Outcome.Either<SftpStat, string>>}
+ * - On success:  `Outcome.makeSuccess(stat)` containing file metadata.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function statFile(client: SftpClient, path: string): Promise<Returned<SftpStat>>;
 export {};

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

@@ -1,14 +1,35 @@
 import {
-  statFile
-} from "../../../../chunks/chunk-XR2LNUGW.js";
-import "../../../../chunks/chunk-W3RXHN5I.js";
-import "../../../../chunks/chunk-VROZGPC5.js";
-import "../../../../chunks/chunk-TGVYEQIA.js";
-import "../../../../chunks/chunk-CNYSX2L2.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  stat as stat4
+} from "../../../../chunks/chunk-FSI422YG.js";
+import {
+  stat as stat3
+} from "../../../../chunks/chunk-AXMAF3J2.js";
+import {
+  stat as stat2
+} from "../../../../chunks/chunk-EEPLTO3E.js";
+import {
+  stat
+} from "../../../../chunks/chunk-BQABPH3I.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/stat-file/index.ts
+async function statFile(client, path, options) {
+  if (isGcsBucket(client)) return stat4(client, path, options);
+  if (isS3ClientWithBucket(client)) return stat3(client.client, path, client.bucketName, options);
+  if (isFtpClient(client)) return stat(client, path);
+  if (isSftpClient(client)) return stat2(client, path);
+  return makeFailure("Invalid client type");
+}
 export {
   statFile
 };

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

@@ -2,15 +2,60 @@ 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 { UploadOptions as FtpUploadOptions } from '../../../ftps/file/upload/index.js';
 import { UploadOptions as SftpUploadOptions } from '../../../sftp/file/upload/index.js';
 import { UploadOptions as S3UploadOptions } from '../../../@aws-s3/storage/file/upload/index.js';
 import { UploadOptions as GcsUploadOptions } from '../../../@google-cloud/storage/file/upload/index.js';
+/** Return type for upload file operations. */
 type Returned = Outcome.Either<true, string>;
+/**
+ * Uploads a file stream to a Google Cloud Storage bucket.
+ *
+ * @param {Readable} fileStream           - The file content as a stream.
+ * @param {string}   path                 - The path to upload the file to.
+ * @param {GCSBucket} client              - The Google Cloud Storage bucket instance.
+ * @param {GcsUploadOptions} [options]     - Optional upload configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function uploadFile(fileStream: Readable, path: string, client: GCSBucket, options?: GcsUploadOptions): Promise<Returned>;
+/**
+ * Uploads a file stream to an S3 bucket.
+ *
+ * @param {Readable} fileStream           - The file content as a stream.
+ * @param {string}   path                 - The path to upload the file to.
+ * @param {S3ClientWithBucket} client     - The S3 client with bucket configuration.
+ * @param {S3UploadOptions} [options]      - Optional upload configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function uploadFile(fileStream: Readable, path: string, client: S3ClientWithBucket, options?: S3UploadOptions): Promise<Returned>;
+/**
+ * Uploads a file stream to an FTP server.
+ *
+ * @param {Readable} fileStream           - The file content as a stream.
+ * @param {string}   path                 - The path to upload the file to.
+ * @param {FtpClient} client              - The FTP client instance.
+ * @param {FtpUploadOptions} [options]     - Optional upload configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function uploadFile(fileStream: Readable, path: string, client: FtpClient, options?: FtpUploadOptions): Promise<Returned>;
+/**
+ * Uploads a file stream to an SFTP server.
+ *
+ * @param {Readable} fileStream           - The file content as a stream.
+ * @param {string}   path                 - The path to upload the file to.
+ * @param {SftpClient} client             - The SFTP client instance.
+ * @param {SftpUploadOptions} [options]   - Optional upload configuration.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
 export declare function uploadFile(fileStream: Readable, path: string, client: SftpClient, options?: SftpUploadOptions): Promise<Returned>;
 export {};

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

@@ -1,14 +1,35 @@
 import {
-  uploadFile
-} from "../../../../chunks/chunk-XBA26Z7E.js";
-import "../../../../chunks/chunk-FB3GNE2B.js";
-import "../../../../chunks/chunk-FD5WR2A5.js";
-import "../../../../chunks/chunk-QDVDHFMZ.js";
-import "../../../../chunks/chunk-CVDCTI7F.js";
-import "../../../../chunks/chunk-V3GX7SIJ.js";
-import "../../../../chunks/chunk-JMU5PDBD.js";
+  upload as upload4
+} from "../../../../chunks/chunk-UZ4SWSOZ.js";
+import {
+  upload as upload3
+} from "../../../../chunks/chunk-FM3HGCFL.js";
+import {
+  upload as upload2
+} from "../../../../chunks/chunk-Y6FD4ASO.js";
+import {
+  upload
+} from "../../../../chunks/chunk-AOEOW5XW.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/upload-file/index.ts
+async function uploadFile(fileStream, path, client, options) {
+  if (isGcsBucket(client)) return upload4(client, path, fileStream, options);
+  if (isS3ClientWithBucket(client)) return upload3(client.client, client.bucketName, path, fileStream, options);
+  if (isFtpClient(client)) return upload(client, path, fileStream, options);
+  if (isSftpClient(client)) return upload2(client, path, fileStream, options);
+  return makeFailure("Invalid client type");
+}
 export {
   uploadFile
 };

package/node/encryption/@aes-256-gcm/buffer/index.d.ts

@@ -1,5 +1,5 @@
 import { Buffer } from 'node:buffer';
-import { Outcome } from '../../../../agnostic/misc/outcome/index.js';
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 /**
  * Encrypts a `Buffer` by converting it to a `Uint8Array`, performing encryption, and then returning the result as a `Buffer`.
  *