@design-edito/tools 0.1.71 → 0.1.73

package/chunks/chunk-ZJTWDCNZ.js

@@ -0,0 +1,34 @@
+import {
+  Outcome
+} from "./chunk-JMU5PDBD.js";
+import {
+  unknownToString
+} from "./chunk-FENXVJYO.js";
+import {
+  __export
+} from "./chunk-WSFCRVEQ.js";
+
+// src/node/ftps/file/exists/index.ts
+var exists_exports = {};
+__export(exists_exports, {
+  exists: () => exists
+});
+import { FileType } from "basic-ftp";
+async function exists(ftpClient, sourcePath) {
+  try {
+    const lastSlash = sourcePath.lastIndexOf("/");
+    const parentDir = lastSlash === -1 ? "." : sourcePath.slice(0, lastSlash) || "/";
+    const baseName = lastSlash === -1 ? sourcePath : sourcePath.slice(lastSlash + 1);
+    const list = await ftpClient.list(parentDir);
+    const entry = list.find((e) => e.name === baseName);
+    const isFile = entry ? entry.type === FileType.File || entry.type === FileType.SymbolicLink : false;
+    return Outcome.makeSuccess(isFile);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
+
+export {
+  exists,
+  exists_exports
+};

package/chunks/chunk-ZSUG52DO.js

@@ -0,0 +1,40 @@
+import {
+  Outcome
+} from "./chunk-JMU5PDBD.js";
+import {
+  unknownToString
+} from "./chunk-FENXVJYO.js";
+import {
+  __export
+} from "./chunk-WSFCRVEQ.js";
+
+// src/node/@aws-s3/storage/directory/list/index.ts
+var list_exports = {};
+__export(list_exports, {
+  list: () => list
+});
+import {
+  ListObjectsV2Command
+} from "@aws-sdk/client-s3";
+async function list(client, bucketName, directoryPath, options) {
+  const prefix = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
+  try {
+    const response = await client.send(
+      new ListObjectsV2Command({
+        Bucket: bucketName,
+        Prefix: prefix,
+        Delimiter: "/",
+        ...options
+      })
+    );
+    const keys = (response.Contents ?? []).map((obj) => obj.Key).filter(Boolean);
+    return Outcome.makeSuccess(keys);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
+
+export {
+  list,
+  list_exports
+};

package/components/Comp/index.js

@@ -1,4 +1,4 @@
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 
 // src/components/Comp/index.tsx
 import { Fragment, jsx } from "react/jsx-runtime";

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

@@ -1,12 +1,22 @@
 import {
   storage_exports
-} from "../../chunks/chunk-2H5RIOJO.js";
-import "../../chunks/chunk-BWXVJB4I.js";
-import "../../chunks/chunk-26QQ56SS.js";
-import "../../chunks/chunk-O7UEQQ6H.js";
+} from "../../chunks/chunk-MAOVZE34.js";
+import "../../chunks/chunk-H5O26IRG.js";
+import "../../chunks/chunk-IWZAUQGO.js";
+import "../../chunks/chunk-QWZ4ZNFA.js";
+import "../../chunks/chunk-ON6LC3HE.js";
+import "../../chunks/chunk-4XSDRT23.js";
+import "../../chunks/chunk-3TKBCG7Y.js";
+import "../../chunks/chunk-VROZGPC5.js";
+import "../../chunks/chunk-FD5WR2A5.js";
+import "../../chunks/chunk-4XBUJAQU.js";
+import "../../chunks/chunk-C6QTHDDM.js";
+import "../../chunks/chunk-IV75M3KE.js";
+import "../../chunks/chunk-ZEZCYPLQ.js";
+import "../../chunks/chunk-ZSUG52DO.js";
 import "../../chunks/chunk-JMU5PDBD.js";
 import "../../chunks/chunk-FENXVJYO.js";
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 export {
   storage_exports as Storage
 };

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

@@ -0,0 +1,35 @@
+import { S3Client, ListObjectsV2CommandInput, CopyObjectCommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type CopyDirOptions = {
+    /**
+     * Extra parameters forwarded to each `ListObjectsV2Command`.
+     * `Bucket` and `Prefix` are supplied by this utility.
+     */
+    listObjectsOptions?: Omit<ListObjectsV2CommandInput, 'Bucket' | 'Prefix'>;
+    /**
+     * Extra parameters forwarded to each `CopyObjectCommand`.
+     * `Bucket`, `Key` and `CopySource` are supplied by this utility.
+     */
+    copyOptions?: Omit<CopyObjectCommandInput, 'Bucket' | 'Key' | 'CopySource'>;
+    /**
+     * If false (default), existing target files will be skipped (not overwritten).
+     */
+    overwrite?: boolean;
+};
+/**
+ * Recursively copies every object under `sourceDir` to the same relative path
+ * beneath `targetDir` in a single S3 bucket (AWS SDK v3).
+ *
+ * @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 copy from.
+ * @param {string} targetDir - The target directory prefix to copy to.
+ * @param {CopyDirOptions} [options] - Optional copy‑behaviour configuration.
+ * @param {Omit<ListObjectsV2CommandInput,'Bucket'|'Prefix'>} [options.listObjectsOptions] - Extra list parameters.
+ * @param {Omit<CopyObjectCommandInput,'Bucket'|'Key'|'CopySource'>} [options.copyOptions] - Extra copy parameters.
+ * @param {boolean} [options.overwrite=false] - Whether to overwrite existing files at target.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - Success: `Outcome.makeSuccess(true)` if every object is copied.
+ * - Failure: `Outcome.makeFailure(errStr)` on error.
+ */
+export declare function copyDir(client: S3Client, bucketName: string, sourceDir: string, targetDir: string, options?: CopyDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  copyDir
+} from "../../../../../chunks/chunk-4XBUJAQU.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  copyDir
+};

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

@@ -0,0 +1,5 @@
+import * as CopyDir from './copy-dir';
+import * as List from './list';
+import * as MoveDir from './move-dir';
+import * as RemoveDir from './remove-dir';
+export { CopyDir, List, MoveDir, RemoveDir };

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

@@ -0,0 +1,22 @@
+import "../../../../chunks/chunk-H5O26IRG.js";
+import {
+  move_dir_exports
+} from "../../../../chunks/chunk-ON6LC3HE.js";
+import {
+  remove_dir_exports
+} from "../../../../chunks/chunk-4XSDRT23.js";
+import {
+  copy_dir_exports
+} from "../../../../chunks/chunk-4XBUJAQU.js";
+import {
+  list_exports
+} from "../../../../chunks/chunk-ZSUG52DO.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  copy_dir_exports as CopyDir,
+  list_exports as List,
+  move_dir_exports as MoveDir,
+  remove_dir_exports as RemoveDir
+};

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

@@ -0,0 +1,17 @@
+import { S3Client, ListObjectsV2CommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+/** Extra parameters forwarded to each `ListObjectsV2Command`. */
+export type ListOptions = Omit<ListObjectsV2CommandInput, 'Bucket' | 'Prefix' | 'Delimiter'>;
+/**
+ * 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>>}
+ * - Success: `Outcome.makeSuccess(keys)` where `keys` is an array of object keys.
+ * - Failure: `Outcome.makeFailure(errStr)` if the list operation fails.
+ */
+export declare function list(client: S3Client, bucketName: string, directoryPath: string, options?: ListOptions): Promise<Outcome.Either<string[], string>>;

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

@@ -0,0 +1,9 @@
+import {
+  list
+} from "../../../../../chunks/chunk-ZSUG52DO.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  list
+};

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

@@ -0,0 +1,33 @@
+import { S3Client, ListObjectsV2CommandInput, CopyObjectCommandInput, DeleteObjectCommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type MoveDirOptions = {
+    /** Extra parameters forwarded to every `ListObjectsV2Command` call. */
+    listObjectsOptions?: Omit<ListObjectsV2CommandInput, 'Bucket' | 'Prefix'>;
+    /** Extra parameters forwarded to every `CopyObjectCommand` (`Bucket`, `Key`, `CopySource` are supplied internally). */
+    copyOptions?: Omit<CopyObjectCommandInput, 'Bucket' | 'Key' | 'CopySource'>;
+    /** Extra parameters forwarded to every `DeleteObjectCommand` (`Bucket`, `Key` are supplied internally). */
+    deleteOptions?: Omit<DeleteObjectCommandInput, 'Bucket' | 'Key'>;
+    /**
+     * If **false** (default) and *any* destination key already exists, the move
+     * operation aborts with an error.
+     * @default false
+     */
+    overwrite?: boolean;
+};
+/**
+ * Recursively moves every object under `sourceDir` to the corresponding path
+ * under `targetDir` within the same S3 bucket (AWS SDK v3).
+ *
+ * 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>>}
+ * - On success: `Outcome.makeSuccess(true)`.
+ * - On failure: `Outcome.makeFailure(errStr)`.
+ */
+export declare function moveDir(client: S3Client, bucketName: string, sourceDir: string, targetDir: string, options?: MoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  moveDir
+} from "../../../../../chunks/chunk-ON6LC3HE.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  moveDir
+};

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

@@ -0,0 +1,31 @@
+import { S3Client, ListObjectsV2CommandInput, DeleteObjectsCommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type RemoveDirOptions = {
+    /** Extra parameters forwarded to each `ListObjectsV2Command` call. */
+    listObjectsOptions?: Omit<ListObjectsV2CommandInput, 'Bucket' | 'Prefix'>;
+    /** Extra parameters forwarded to each `DeleteObjectsCommand` call. */
+    deleteObjectsOptions?: Omit<DeleteObjectsCommandInput, 'Bucket' | 'Delete'>;
+    /**
+     * If **true** (default) the function ignores the case where the prefix is
+     * already empty / does not exist and simply resolves with success.
+     * If **false** and nothing is found, the function returns a failure.
+     * @default true
+     */
+    ignoreMissing?: boolean;
+};
+/**
+ * Recursively deletes all objects under a directory prefix in an S3 bucket
+ * 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>>}
+ * - On success: `Outcome.makeSuccess(true)` – deletion succeeded, or prefix
+ *   absent and `ignoreMissing` is true.
+ * - On failure: `Outcome.makeFailure(errStr)` if deletion fails, or prefix
+ *   absent and `ignoreMissing` is false.
+ */
+export declare function removeDir(client: S3Client, bucketName: string, directoryPath: string, options?: RemoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  removeDir
+} from "../../../../../chunks/chunk-4XSDRT23.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  removeDir
+};

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

@@ -0,0 +1,30 @@
+import { S3Client, CopyObjectCommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type CopyOptions = {
+    /**
+     * Additional parameters forwarded to the underlying `CopyObjectCommand`.
+     * `Bucket`, `Key`, and `CopySource` are set by this utility.
+     */
+    copyOptions?: Omit<CopyObjectCommandInput, 'Bucket' | 'Key' | 'CopySource'>;
+    /**
+     * If `false` (default) and `targetPath` already exists, the copy aborts
+     * with an error.
+     * @default false
+     */
+    overwrite?: boolean;
+};
+/**
+ * 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>>}
+ * - On success:  `Outcome.makeSuccess(true)`.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export declare function copy(client: S3Client, bucketName: string, sourcePath: string, targetPath: string, options?: CopyOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  copy
+} from "../../../../../chunks/chunk-C6QTHDDM.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  copy
+};

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

@@ -1,22 +1,22 @@
 import { Readable } from 'node:stream';
-import { S3 } from 'aws-sdk';
+import { S3Client, GetObjectCommandInput } from '@aws-sdk/client-s3';
 import { Outcome } from '../../../../../agnostic/misc/outcome';
-export type DownloadOptions = {
-    downloadSettings?: S3.Types.GetObjectRequest;
-};
+/**
+ * Additional parameters forwarded to `GetObjectCommand`.
+ * `Bucket` and `Key` are provided by this util.
+ */
+export type DownloadOptions = Omit<GetObjectCommandInput, 'Bucket' | 'Key'>;
 /**
  * Downloads a file from a specified Amazon S3 bucket.
  *
- * This function downloads a file from the given bucket and path, returning the file content as a `Readable` stream.
- * The download process can be customized using optional `downloadSettings`.
+ * The function streams the object’s content back as a Node `Readable`.
  *
- * @param {string} sourcePath - The path of the file to be downloaded in the bucket.
- * @param {string} bucketName - The name of the S3 bucket from which to download the file.
- * @param {S3} s3 - The AWS S3 client instance.
- * @param {DownloadOptions} [options] - Optional configuration options for the download.
- * @param {S3.Types.GetObjectRequest} [options.downloadSettings] - Settings for the download process.
- * @returns {Promise<Outcome.Either<Readable, string>>} A promise that resolves to an `Outcome.Either`.
- * - On success: `Outcome.makeSuccess(stream)` containing the downloaded file's content as a `Readable` stream.
- * - On failure: `Outcome.makeFailure(errStr)` with an error message if the download fails.
+ * @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>>}
+ * - On success:  `Outcome.makeSuccess(stream)` containing the file content.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
  */
-export declare function download(sourcePath: string, bucketName: string, s3: S3, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;
+export declare function download(client: S3Client, bucketName: string, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;

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

@@ -1,9 +1,9 @@
 import {
   download
-} from "../../../../../chunks/chunk-26QQ56SS.js";
+} from "../../../../../chunks/chunk-IV75M3KE.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   download
 };

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

@@ -0,0 +1,23 @@
+import { S3Client, HeadObjectCommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type ExistsOptions = {
+    /**
+     * Additional parameters forwarded to the underlying `HeadObjectCommand`.
+     * `Bucket` and `Key` are supplied by this utility.
+     */
+    headObjectOptions?: Omit<HeadObjectCommandInput, 'Bucket' | 'Key'>;
+};
+/**
+ * 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>>}
+ * - Success: `Outcome.makeSuccess(true)` if the object exists,
+ *            `Outcome.makeSuccess(false)` if it does not.
+ * - Failure: `Outcome.makeFailure(errStr)` for unexpected errors.
+ */
+export declare function exists(client: S3Client, bucketName: string, sourcePath: string, options?: ExistsOptions): Promise<Outcome.Either<boolean, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  exists
+} from "../../../../../chunks/chunk-ZEZCYPLQ.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  exists
+};

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

@@ -1,3 +1,8 @@
+import * as Copy from './copy';
 import * as Download from './download';
+import * as Exists from './exists';
+import * as Move from './move';
+import * as Remove from './remove';
+import * as Stat from './stat';
 import * as Upload from './upload';
-export { Download, Upload };
+export { Copy, Download, Exists, Move, Remove, Stat, Upload, };

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

@@ -1,14 +1,34 @@
-import "../../../../chunks/chunk-BWXVJB4I.js";
+import "../../../../chunks/chunk-IWZAUQGO.js";
 import {
-  download_exports
-} from "../../../../chunks/chunk-26QQ56SS.js";
+  move_exports
+} from "../../../../chunks/chunk-QWZ4ZNFA.js";
+import {
+  remove_exports
+} from "../../../../chunks/chunk-3TKBCG7Y.js";
+import {
+  stat_exports
+} from "../../../../chunks/chunk-VROZGPC5.js";
 import {
   upload_exports
-} from "../../../../chunks/chunk-O7UEQQ6H.js";
+} from "../../../../chunks/chunk-FD5WR2A5.js";
+import {
+  copy_exports
+} from "../../../../chunks/chunk-C6QTHDDM.js";
+import {
+  download_exports
+} from "../../../../chunks/chunk-IV75M3KE.js";
+import {
+  exists_exports
+} from "../../../../chunks/chunk-ZEZCYPLQ.js";
 import "../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
 export {
+  copy_exports as Copy,
   download_exports as Download,
+  exists_exports as Exists,
+  move_exports as Move,
+  remove_exports as Remove,
+  stat_exports as Stat,
   upload_exports as Upload
 };

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

@@ -0,0 +1,33 @@
+import { S3Client, CopyObjectCommandInput, DeleteObjectCommandInput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type MoveOptions = {
+    /** Extra parameters forwarded to `CopyObjectCommand` (`Bucket`, `Key`, `CopySource` are filled internally). */
+    copyOptions?: Omit<CopyObjectCommandInput, 'Bucket' | 'Key' | 'CopySource'>;
+    /** Extra parameters forwarded to `DeleteObjectCommand` (`Bucket`, `Key` are filled internally). */
+    deleteOptions?: Omit<DeleteObjectCommandInput, 'Bucket' | 'Key'>;
+    /**
+     * If **false** (default) and `targetPath` already exists, the move aborts
+     * with an error.
+     * @default false
+     */
+    overwrite?: boolean;
+};
+/**
+ * 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>>}
+ * - Success: `Outcome.makeSuccess(true)`
+ * - Failure: `Outcome.makeFailure(errStr)`
+ */
+export declare function move(client: S3Client, bucketName: string, sourcePath: string, targetPath: string, options?: MoveOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  move
+} from "../../../../../chunks/chunk-QWZ4ZNFA.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  move
+};

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

@@ -0,0 +1,17 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export type RemoveOptions = {
+    ignoreMissing?: boolean;
+};
+/**
+ * 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>>}
+ */
+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

@@ -0,0 +1,9 @@
+import {
+  remove
+} from "../../../../../chunks/chunk-3TKBCG7Y.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  remove
+};

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

@@ -0,0 +1,24 @@
+import { S3Client, HeadObjectCommandInput, HeadObjectCommandOutput } from '@aws-sdk/client-s3';
+import { Outcome } from '../../../../../agnostic/misc/outcome';
+export interface Stat {
+    size?: number;
+    modifiedAt?: Date;
+    checksum?: string;
+    contentType?: string;
+    metadata?: Record<string, string>;
+    storageClass?: string;
+    raw: HeadObjectCommandOutput;
+}
+export type StatOptions = {
+    headObjectOptions?: Omit<HeadObjectCommandInput, 'Bucket' | 'Key'>;
+};
+/**
+ * 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>>}
+ */
+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

@@ -0,0 +1,9 @@
+import {
+  stat
+} from "../../../../../chunks/chunk-VROZGPC5.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  stat
+};