@design-edito/tools 0.4.22 → 0.5.0

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

@@ -6,11 +6,11 @@ export type ListOptions = Omit<ListObjectsV2CommandInput, 'Bucket' | 'Prefix' |
  * Lists all direct‑child object keys under a given directory prefix in an S3
  * bucket (AWS SDK v3). The listing is **non‑recursive**.
  *
- * @param {S3Client} client         - The v3 S3 client used to list objects.
- * @param {string}   bucketName     - The name of the S3 bucket.
- * @param {string}   directoryPath  - The directory prefix to list.
- * @param {ListOptions} [options]   - Additional parameters for `ListObjectsV2`.
- * @returns {Promise<Outcome.Either<string[], string>>}
+ * @param client         - The v3 S3 client used to list objects.
+ * @param   bucketName     - The name of the S3 bucket.
+ * @param   directoryPath  - The directory prefix to list.
+ * @param [options]   - Additional parameters for `ListObjectsV2`.
+ * @returns
  * - Success: `Outcome.makeSuccess(keys)` where `keys` is an array of object keys.
  * - Failure: `Outcome.makeFailure(errStr)` if the list operation fails.
  */

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

@@ -5,11 +5,11 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  * Lists all direct‑child object keys under a given directory prefix in an S3
  * bucket (AWS SDK v3). The listing is **non‑recursive**.
  *
- * @param {S3Client} client         - The v3 S3 client used to list objects.
- * @param {string}   bucketName     - The name of the S3 bucket.
- * @param {string}   directoryPath  - The directory prefix to list.
- * @param {ListOptions} [options]   - Additional parameters for `ListObjectsV2`.
- * @returns {Promise<Outcome.Either<string[], string>>}
+ * @param client         - The v3 S3 client used to list objects.
+ * @param   bucketName     - The name of the S3 bucket.
+ * @param   directoryPath  - The directory prefix to list.
+ * @param [options]   - Additional parameters for `ListObjectsV2`.
+ * @returns
  * - Success: `Outcome.makeSuccess(keys)` where `keys` is an array of object keys.
  * - Failure: `Outcome.makeFailure(errStr)` if the list operation fails.
  */

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

@@ -21,12 +21,12 @@ export type MoveDirOptions = {
  * Behaviour when `overwrite` is **false** (default): abort if *any* destination
  * key already exists.
  *
- * @param {S3Client} client      - The v3 S3 client instance.
- * @param {string}   bucketName  - The name of the S3 bucket.
- * @param {string}   sourceDir   - The source directory prefix to move from.
- * @param {string}   targetDir   - The target directory prefix to move to.
- * @param {MoveDirOptions} [options] - Optional configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param client      - The v3 S3 client instance.
+ * @param   bucketName  - The name of the S3 bucket.
+ * @param   sourceDir   - The source directory prefix to move from.
+ * @param   targetDir   - The target directory prefix to move to.
+ * @param [options] - Optional configuration.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)`.
  * - On failure: `Outcome.makeFailure(errStr)`.
  */

package/node/@aws-s3/storage/directory/move-dir/index.js

@@ -1,6 +1,7 @@
 import { ListObjectsV2Command, CopyObjectCommand, DeleteObjectCommand, HeadObjectCommand } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Recursively moves every object under `sourceDir` to the corresponding path
  * under `targetDir` within the same S3 bucket (AWS SDK v3).
@@ -8,12 +9,12 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  * Behaviour when `overwrite` is **false** (default): abort if *any* destination
  * key already exists.
  *
- * @param {S3Client} client      - The v3 S3 client instance.
- * @param {string}   bucketName  - The name of the S3 bucket.
- * @param {string}   sourceDir   - The source directory prefix to move from.
- * @param {string}   targetDir   - The target directory prefix to move to.
- * @param {MoveDirOptions} [options] - Optional configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param client      - The v3 S3 client instance.
+ * @param   bucketName  - The name of the S3 bucket.
+ * @param   sourceDir   - The source directory prefix to move from.
+ * @param   targetDir   - The target directory prefix to move to.
+ * @param [options] - Optional configuration.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)`.
  * - On failure: `Outcome.makeFailure(errStr)`.
  */
@@ -41,7 +42,10 @@ export async function moveDir(client, bucketName, sourceDir, targetDir, options)
                         throw new Error(`Object already exists at ${dest}.`);
                     }
                     catch (err) {
-                        if (err.$metadata?.httpStatusCode !== 404 && err.name !== 'NotFound')
+                        const name = deepGetProperty(err, 'name');
+                        const httpStatusCode = deepGetProperty(err, '$metadata.httpStatusCode');
+                        // eslint-disable-next-line max-depth
+                        if (httpStatusCode !== 404 && name !== 'NotFound')
                             throw err;
                     }
                 }

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

@@ -18,11 +18,11 @@ export type RemoveDirOptions = {
  * using the AWS SDK v3 client. Handles pagination and the 1 000‑key limit of
  * `DeleteObjects`.
  *
- * @param {S3Client}  client           - The v3 S3 client instance.
- * @param {string}    bucketName       - The name of the S3 bucket.
- * @param {string}    directoryPath    - The “directory” prefix to delete.
- * @param {RemoveDirOptions} [options] - Optional listing/deletion configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param  client           - The v3 S3 client instance.
+ * @param    bucketName       - The name of the S3 bucket.
+ * @param    directoryPath    - The “directory” prefix to delete.
+ * @param [options] - Optional listing/deletion configuration.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)` – deletion succeeded, or prefix
  *   absent and `ignoreMissing` is true.
  * - On failure: `Outcome.makeFailure(errStr)` if deletion fails, or prefix

package/node/@aws-s3/storage/directory/remove-dir/index.js

@@ -6,11 +6,11 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  * using the AWS SDK v3 client. Handles pagination and the 1 000‑key limit of
  * `DeleteObjects`.
  *
- * @param {S3Client}  client           - The v3 S3 client instance.
- * @param {string}    bucketName       - The name of the S3 bucket.
- * @param {string}    directoryPath    - The “directory” prefix to delete.
- * @param {RemoveDirOptions} [options] - Optional listing/deletion configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param  client           - The v3 S3 client instance.
+ * @param    bucketName       - The name of the S3 bucket.
+ * @param    directoryPath    - The “directory” prefix to delete.
+ * @param [options] - Optional listing/deletion configuration.
+ * @returns
  * - On success: `Outcome.makeSuccess(true)` – deletion succeeded, or prefix
  *   absent and `ignoreMissing` is true.
  * - On failure: `Outcome.makeFailure(errStr)` if deletion fails, or prefix

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

@@ -16,14 +16,14 @@ export type CopyOptions = {
 /**
  * Copies an object from one key to another within the same S3 bucket.
  *
- * @param {S3Client} client            - The v3 S3 client instance.
- * @param {string}   bucketName        - The name of the S3 bucket.
- * @param {string}   sourcePath        - The key of the source object.
- * @param {string}   targetPath        - The key where the object will be copied.
- * @param {CopyOptions} [options]      - Optional copy configuration.
- * @param {Omit<CopyObjectCommandInput,'Bucket'|'Key'|'CopySource'>} [options.copyOptions] - Extra copy params.
- * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing object.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param client            - The v3 S3 client instance.
+ * @param   bucketName        - The name of the S3 bucket.
+ * @param   sourcePath        - The key of the source object.
+ * @param   targetPath        - The key where the object will be copied.
+ * @param [options]      - Optional copy configuration.
+ * @param [options.copyOptions] - Extra copy params.
+ * @param [options.overwrite=false] - Whether to overwrite an existing object.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -1,17 +1,18 @@
 import { CopyObjectCommand, HeadObjectCommand } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Copies an object from one key to another within the same S3 bucket.
  *
- * @param {S3Client} client            - The v3 S3 client instance.
- * @param {string}   bucketName        - The name of the S3 bucket.
- * @param {string}   sourcePath        - The key of the source object.
- * @param {string}   targetPath        - The key where the object will be copied.
- * @param {CopyOptions} [options]      - Optional copy configuration.
- * @param {Omit<CopyObjectCommandInput,'Bucket'|'Key'|'CopySource'>} [options.copyOptions] - Extra copy params.
- * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing object.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param client            - The v3 S3 client instance.
+ * @param   bucketName        - The name of the S3 bucket.
+ * @param   sourcePath        - The key of the source object.
+ * @param   targetPath        - The key where the object will be copied.
+ * @param [options]      - Optional copy configuration.
+ * @param [options.copyOptions] - Extra copy params.
+ * @param [options.overwrite=false] - Whether to overwrite an existing object.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */
@@ -24,7 +25,9 @@ export async function copy(client, bucketName, sourcePath, targetPath, options)
                 return Outcome.makeFailure(`Object already exists at ${targetPath}.`);
             }
             catch (err) {
-                const notFound = err.$metadata?.httpStatusCode === 404 || err.name === 'NotFound';
+                const name = deepGetProperty(err, 'name');
+                const httpStatusCode = deepGetProperty(err, '$metadata.httpStatusCode');
+                const notFound = httpStatusCode === 404 || name === 'NotFound';
                 if (!notFound)
                     throw err; // propagate unexpected errors
             }

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

@@ -1,4 +1,4 @@
-import { type Readable } from 'node:stream';
+import type { Readable } from 'node:stream';
 import { type S3Client, type GetObjectCommandInput } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 /**
@@ -11,11 +11,11 @@ export type DownloadOptions = Omit<GetObjectCommandInput, 'Bucket' | 'Key'>;
  *
  * The function streams the object’s content back as a Node `Readable`.
  *
- * @param {S3Client} client       - The v3 S3 client instance.
- * @param {string}   bucketName   - The name of the S3 bucket.
- * @param {string}   sourcePath   - The key of the object to download.
- * @param {DownloadOptions} [options] - Extra parameters for the download.
- * @returns {Promise<Outcome.Either<Readable, string>>}
+ * @param client       - The v3 S3 client instance.
+ * @param   bucketName   - The name of the S3 bucket.
+ * @param   sourcePath   - The key of the object to download.
+ * @param [options] - Extra parameters for the download.
+ * @returns
  * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -6,11 +6,11 @@ import { unknownToString } from '../../../../../agnostic/errors/unknown-to-strin
  *
  * The function streams the object’s content back as a Node `Readable`.
  *
- * @param {S3Client} client       - The v3 S3 client instance.
- * @param {string}   bucketName   - The name of the S3 bucket.
- * @param {string}   sourcePath   - The key of the object to download.
- * @param {DownloadOptions} [options] - Extra parameters for the download.
- * @returns {Promise<Outcome.Either<Readable, string>>}
+ * @param client       - The v3 S3 client instance.
+ * @param   bucketName   - The name of the S3 bucket.
+ * @param   sourcePath   - The key of the object to download.
+ * @param [options] - Extra parameters for the download.
+ * @returns
  * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */
@@ -21,6 +21,7 @@ export async function download(client, bucketName, sourcePath, options) {
             Key: sourcePath,
             ...options
         }));
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- GetObjectCommand's response.Body is always a Readable stream in Node.js
         const stream = response.Body;
         return Outcome.makeSuccess(stream);
     }

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

@@ -10,12 +10,12 @@ export type ExistsOptions = {
 /**
  * Checks whether an object exists in a specified S3 bucket (AWS SDK v3).
  *
- * @param {S3Client} client          - The v3 S3 client instance.
- * @param {string}   bucketName      - The name of the S3 bucket.
- * @param {string}   sourcePath      - The key of the object to test.
- * @param {ExistsOptions} [options]  - Optional configuration.
- * @param {Omit<HeadObjectCommandInput,'Bucket'|'Key'>} [options.headObjectOptions] - Extra `HeadObject` params.
- * @returns {Promise<Outcome.Either<boolean, string>>}
+ * @param client          - The v3 S3 client instance.
+ * @param   bucketName      - The name of the S3 bucket.
+ * @param   sourcePath      - The key of the object to test.
+ * @param [options]  - Optional configuration.
+ * @param [options.headObjectOptions] - Extra `HeadObject` params.
+ * @returns
  * - Success: `Outcome.makeSuccess(true)` if the object exists,
  *            `Outcome.makeSuccess(false)` if it does not.
  * - Failure: `Outcome.makeFailure(errStr)` for unexpected errors.

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

@@ -1,15 +1,16 @@
 import { HeadObjectCommand } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Checks whether an object exists in a specified S3 bucket (AWS SDK v3).
  *
- * @param {S3Client} client          - The v3 S3 client instance.
- * @param {string}   bucketName      - The name of the S3 bucket.
- * @param {string}   sourcePath      - The key of the object to test.
- * @param {ExistsOptions} [options]  - Optional configuration.
- * @param {Omit<HeadObjectCommandInput,'Bucket'|'Key'>} [options.headObjectOptions] - Extra `HeadObject` params.
- * @returns {Promise<Outcome.Either<boolean, string>>}
+ * @param client          - The v3 S3 client instance.
+ * @param   bucketName      - The name of the S3 bucket.
+ * @param   sourcePath      - The key of the object to test.
+ * @param [options]  - Optional configuration.
+ * @param [options.headObjectOptions] - Extra `HeadObject` params.
+ * @returns
  * - Success: `Outcome.makeSuccess(true)` if the object exists,
  *            `Outcome.makeSuccess(false)` if it does not.
  * - Failure: `Outcome.makeFailure(errStr)` for unexpected errors.
@@ -25,13 +26,15 @@ export async function exists(client, bucketName, sourcePath, options) {
         return Outcome.makeSuccess(true);
     }
     catch (err) {
-        const notFound = err.$metadata?.httpStatusCode === 404
-            || err.name === 'NotFound'
-            || err.Code === 'NotFound' // some SDKs emit Code
-            || err.Code === 'NoSuchKey';
-        if (notFound) {
+        const name = deepGetProperty(err, 'name');
+        const Code = deepGetProperty(err, 'Code');
+        const httpStatusCode = deepGetProperty(err, '$metadata.httpStatusCode');
+        const notFound = httpStatusCode === 404
+            || name === 'NotFound'
+            || Code === 'NotFound' // some SDKs emit Code
+            || Code === 'NoSuchKey';
+        if (notFound)
             return Outcome.makeSuccess(false);
-        }
         return Outcome.makeFailure(unknownToString(err));
     }
 }

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

@@ -1,6 +1,6 @@
 export * as copy from './copy/index.js'
-export * as exists from './exists/index.js'
 export * as download from './download/index.js'
+export * as exists from './exists/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'

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

@@ -1,6 +1,6 @@
 export * as copy from './copy/index.js'
-export * as exists from './exists/index.js'
 export * as download from './download/index.js'
+export * as exists from './exists/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'

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

@@ -18,15 +18,15 @@ export type MoveOptions = {
  * The function copies the object from `sourcePath` to `targetPath` and, upon
  * successful copy, deletes the original object.
  *
- * @param {S3Client} client - The S3 client instance.
- * @param {string}   bucketName - The name of the bucket.
- * @param {string}   sourcePath - The source object's key.
- * @param {string}   targetPath - The destination object's key.
- * @param {MoveOptions} [options] - Optional copy/delete behaviour.
- * @param {Omit<CopyObjectCommandInput,'Bucket'|'Key'|'CopySource'>} [options.copyOptions]   - Extra copy params.
- * @param {Omit<DeleteObjectCommandInput,'Bucket'|'Key'>}            [options.deleteOptions] - Extra delete params.
- * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing `targetPath`.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param client - The S3 client instance.
+ * @param   bucketName - The name of the bucket.
+ * @param   sourcePath - The source object's key.
+ * @param   targetPath - The destination object's key.
+ * @param [options] - Optional copy/delete behaviour.
+ * @param [options.copyOptions]   - Extra copy params.
+ * @param            [options.deleteOptions] - Extra delete params.
+ * @param [options.overwrite=false] - Whether to overwrite an existing `targetPath`.
+ * @returns
  * - Success: `Outcome.makeSuccess(true)`
  * - Failure: `Outcome.makeFailure(errStr)`
  */

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

@@ -1,21 +1,22 @@
 import { HeadObjectCommand, CopyObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Moves an object from one key to another within the same S3 bucket (AWS SDK v3).
  *
  * The function copies the object from `sourcePath` to `targetPath` and, upon
  * successful copy, deletes the original object.
  *
- * @param {S3Client} client - The S3 client instance.
- * @param {string}   bucketName - The name of the bucket.
- * @param {string}   sourcePath - The source object's key.
- * @param {string}   targetPath - The destination object's key.
- * @param {MoveOptions} [options] - Optional copy/delete behaviour.
- * @param {Omit<CopyObjectCommandInput,'Bucket'|'Key'|'CopySource'>} [options.copyOptions]   - Extra copy params.
- * @param {Omit<DeleteObjectCommandInput,'Bucket'|'Key'>}            [options.deleteOptions] - Extra delete params.
- * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing `targetPath`.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param client - The S3 client instance.
+ * @param   bucketName - The name of the bucket.
+ * @param   sourcePath - The source object's key.
+ * @param   targetPath - The destination object's key.
+ * @param [options] - Optional copy/delete behaviour.
+ * @param [options.copyOptions]   - Extra copy params.
+ * @param            [options.deleteOptions] - Extra delete params.
+ * @param [options.overwrite=false] - Whether to overwrite an existing `targetPath`.
+ * @returns
  * - Success: `Outcome.makeSuccess(true)`
  * - Failure: `Outcome.makeFailure(errStr)`
  */
@@ -29,13 +30,15 @@ export async function move(client, bucketName, sourcePath, targetPath, options)
                 return Outcome.makeFailure(`Object already exists at ${targetPath}.`);
             }
             catch (err) {
-                const notFound = err.$metadata?.httpStatusCode === 404
-                    || err.name === 'NotFound'
-                    || err.Code === 'NotFound'
-                    || err.Code === 'NoSuchKey';
-                if (!notFound) {
+                const name = deepGetProperty(err, 'name');
+                const Code = deepGetProperty(err, 'Code');
+                const httpStatusCode = deepGetProperty(err, '$metadata.httpStatusCode');
+                const notFound = httpStatusCode === 404
+                    || name === 'NotFound'
+                    || Code === 'NotFound'
+                    || Code === 'NoSuchKey';
+                if (!notFound)
                     return Outcome.makeFailure(unknownToString(err));
-                }
                 // If not found, proceed with copy
             }
         }

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

@@ -8,10 +8,10 @@ export type RemoveOptions = {
  *
  * If `ignoreMissing` is true (default), a missing object is considered success.
  *
- * @param {S3Client} s3 - The AWS S3 client instance.
- * @param {string} bucketName - The name of the bucket.
- * @param {string} targetPath - The key of the object to delete.
- * @param {RemoveOptions} [options] - Optional settings.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param s3 - The AWS S3 client instance.
+ * @param bucketName - The name of the bucket.
+ * @param targetPath - The key of the object to delete.
+ * @param [options] - Optional settings.
+ * @returns
  */
 export declare function remove(s3: S3Client, bucketName: string, targetPath: string, options?: RemoveOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,16 +1,17 @@
 import { HeadObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Removes a file from a specified Amazon S3 bucket (AWS SDK v3).
  *
  * If `ignoreMissing` is true (default), a missing object is considered success.
  *
- * @param {S3Client} s3 - The AWS S3 client instance.
- * @param {string} bucketName - The name of the bucket.
- * @param {string} targetPath - The key of the object to delete.
- * @param {RemoveOptions} [options] - Optional settings.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param s3 - The AWS S3 client instance.
+ * @param bucketName - The name of the bucket.
+ * @param targetPath - The key of the object to delete.
+ * @param [options] - Optional settings.
+ * @returns
  */
 export async function remove(s3, bucketName, targetPath, options) {
     const { ignoreMissing = true } = options ?? {};
@@ -20,12 +21,16 @@ export async function remove(s3, bucketName, targetPath, options) {
             await s3.send(new HeadObjectCommand({ Bucket: bucketName, Key: targetPath }));
         }
         catch (err) {
-            const code = err?.name ?? err?.Code ?? err?.code;
-            if (code === 'NotFound' || code === 'NoSuchKey' || code === 'NotFoundException') {
-                if (ignoreMissing)
-                    return Outcome.makeSuccess(true);
-                return Outcome.makeFailure(`File not found at ${targetPath}.`);
-            }
+            const name = deepGetProperty(err, 'name');
+            const Code = deepGetProperty(err, 'Code');
+            const _code = deepGetProperty(err, 'code');
+            const code = name ?? Code ?? _code;
+            if (code === 'NotFound'
+                || code === 'NoSuchKey'
+                || code === 'NotFoundException')
+                return ignoreMissing
+                    ? Outcome.makeSuccess(true)
+                    : Outcome.makeFailure(`File not found at ${targetPath}.`);
             return Outcome.makeFailure(unknownToString(err));
         }
         // Delete the object

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

@@ -15,10 +15,10 @@ export type StatOptions = {
 /**
  * Retrieves metadata for a single S3 object.
  *
- * @param {S3Client} client – v3 S3 client.
- * @param {string}   bucket – Bucket name.
- * @param {string}   key    – Object key.
- * @param {StatOptions} [options] – Extra HeadObject params.
- * @returns {Promise<Outcome.Either<Stat, string>>}
+ * @param client – v3 S3 client.
+ * @param   bucket – Bucket name.
+ * @param   key    – Object key.
+ * @param [options] – Extra HeadObject params.
+ * @returns
  */
 export declare function stat(client: S3Client, bucket: string, key: string, options?: StatOptions): Promise<Outcome.Either<Stat, string>>;

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

@@ -1,14 +1,15 @@
 import { HeadObjectCommand } from '@aws-sdk/client-s3';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Retrieves metadata for a single S3 object.
  *
- * @param {S3Client} client – v3 S3 client.
- * @param {string}   bucket – Bucket name.
- * @param {string}   key    – Object key.
- * @param {StatOptions} [options] – Extra HeadObject params.
- * @returns {Promise<Outcome.Either<Stat, string>>}
+ * @param client – v3 S3 client.
+ * @param   bucket – Bucket name.
+ * @param   key    – Object key.
+ * @param [options] – Extra HeadObject params.
+ * @returns
  */
 export async function stat(client, bucket, key, options) {
     const { headObjectOptions } = options ?? {};
@@ -17,7 +18,7 @@ export async function stat(client, bucket, key, options) {
         const stat = {
             size: res.ContentLength,
             modifiedAt: res.LastModified,
-            checksum: res.ETag?.replace(/"/g, ''),
+            checksum: res.ETag?.replace(/"/gv, ''),
             contentType: res.ContentType,
             metadata: res.Metadata,
             storageClass: res.StorageClass,
@@ -26,7 +27,9 @@ export async function stat(client, bucket, key, options) {
         return Outcome.makeSuccess(stat);
     }
     catch (err) {
-        const notFound = err.$metadata?.httpStatusCode === 404 || err.name === 'NotFound';
+        const name = deepGetProperty(err, 'name');
+        const httpStatusCode = deepGetProperty(err, '$metadata.httpStatusCode');
+        const notFound = httpStatusCode === 404 || name === 'NotFound';
         if (notFound)
             return Outcome.makeFailure(`Object not found: ${key}`);
         return Outcome.makeFailure(unknownToString(err));

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

@@ -1,4 +1,4 @@
-import { type Readable } from 'node:stream';
+import type { Readable } from 'node:stream';
 import { type S3Client, type PutObjectCommandInput } from '@aws-sdk/client-s3';
 import { Upload } from '@aws-sdk/lib-storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
@@ -12,11 +12,11 @@ export type UploadOptions = {
  *
  * If `overwrite` is false and the target file exists, upload is aborted.
  *
- * @param {S3Client} s3 - The AWS S3 v3 client instance.
- * @param {string} bucketName - The S3 bucket name.
- * @param {string} targetPath - The key to upload the file to.
- * @param {Readable} fileStream - The file content as a stream.
- * @param {UploadOptions} [options] - Optional configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param s3 - The AWS S3 v3 client instance.
+ * @param bucketName - The S3 bucket name.
+ * @param targetPath - The key to upload the file to.
+ * @param fileStream - The file content as a stream.
+ * @param [options] - Optional configuration.
+ * @returns
  */
 export declare function upload(s3: S3Client, bucketName: string, targetPath: string, fileStream: Readable, options?: UploadOptions): Promise<Outcome.Either<true, string>>;

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

@@ -2,17 +2,18 @@ import { HeadObjectCommand } from '@aws-sdk/client-s3';
 import { Upload } from '@aws-sdk/lib-storage';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Uploads a file stream to a specified Amazon S3 bucket using AWS SDK v3.
  *
  * If `overwrite` is false and the target file exists, upload is aborted.
  *
- * @param {S3Client} s3 - The AWS S3 v3 client instance.
- * @param {string} bucketName - The S3 bucket name.
- * @param {string} targetPath - The key to upload the file to.
- * @param {Readable} fileStream - The file content as a stream.
- * @param {UploadOptions} [options] - Optional configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
+ * @param s3 - The AWS S3 v3 client instance.
+ * @param bucketName - The S3 bucket name.
+ * @param targetPath - The key to upload the file to.
+ * @param fileStream - The file content as a stream.
+ * @param [options] - Optional configuration.
+ * @returns
  */
 export async function upload(s3, bucketName, targetPath, fileStream, options) {
     const { uploadSettings, fileMetadata, overwrite = false } = options ?? {};
@@ -27,10 +28,11 @@ export async function upload(s3, bucketName, targetPath, fileStream, options) {
             return Outcome.makeFailure(`File already exists at ${targetPath}.`);
         }
         catch (err) {
-            const code = err?.name ?? err?.$metadata?.httpStatusCode;
-            if (code !== 'NotFound' && code !== 404) {
+            const name = deepGetProperty(err, 'name');
+            const httpStatusCode = deepGetProperty(err, '$metadata.httpStatusCode');
+            const code = name ?? httpStatusCode;
+            if (code !== 'NotFound' && code !== 404)
                 return Outcome.makeFailure(unknownToString(err));
-            }
             // Object not found, proceed with upload
         }
     }