@design-edito/tools 0.1.70 → 0.1.72

package/chunks/chunk-ZB73RE7P.js

@@ -0,0 +1,35 @@
+import {
+  register
+} from "./chunk-LYMZZ4BB.js";
+
+// src/agnostic/html/selector-to-element/index.ts
+function selectorToElement(selector, documentObj) {
+  const actualDocument = documentObj ?? window.document;
+  if (actualDocument === null) throw register.getError("no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */, "The optional second parameter expects a Document object");
+  const tagRegexp = /^[A-Za-z]+/;
+  const idRegexp = /#[A-Za-z]+[\w\-\:]*/;
+  const classRegexp = /\.[A-Za-z]+[\w\-]*/;
+  const attributeRegexp = /\[[A-Za-z]+[\w\-]*(="[\w\-]+")?\]/;
+  const matchedTags = selector.match(tagRegexp) ?? [];
+  const matchedIds = selector.match(idRegexp) ?? [];
+  const matchedClasses = selector.match(classRegexp) ?? [];
+  const matchedAttrs = selector.match(attributeRegexp) ?? [];
+  const tag = matchedTags[matchedTags.length - 1] ?? "div";
+  const id = matchedIds[matchedIds.length - 1] ?? null;
+  const classes = matchedClasses.map((matchedClass) => matchedClass.replace(/^\./, ""));
+  const attributes = matchedAttrs.map((matchedAttr) => matchedAttr.replace(/^\[/, "").replace(/\]$/, "").split("="));
+  const element = actualDocument.createElement(tag);
+  if (id !== null) {
+    element.id = id;
+  }
+  element.classList.add(...classes);
+  attributes.forEach(([name, value = ""]) => {
+    if (name === void 0) return;
+    element.setAttribute(name, value);
+  });
+  return element;
+}
+
+export {
+  selectorToElement
+};

package/chunks/chunk-ZO5FRL3M.js

@@ -0,0 +1,29 @@
+import {
+  Outcome
+} from "./chunk-JMU5PDBD.js";
+import {
+  unknownToString
+} from "./chunk-FENXVJYO.js";
+import {
+  __export
+} from "./chunk-KH45J4DC.js";
+
+// src/node/sftp/file/exists/index.ts
+var exists_exports = {};
+__export(exists_exports, {
+  exists: () => exists
+});
+async function exists(sftp, sourcePath) {
+  try {
+    const res = await sftp.exists(sourcePath);
+    const isFile = res === "-" || res === "l";
+    return Outcome.makeSuccess(isFile);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
+
+export {
+  exists,
+  exists_exports
+};

package/chunks/chunk-ZONKYNKA.js

@@ -0,0 +1,28 @@
+import {
+  Sanitize
+} from "./chunk-WECTUHS5.js";
+import {
+  register
+} from "./chunk-EAY65ZP6.js";
+
+// src/agnostic/html/string-to-nodes/index.ts
+function stringToNodes(dirtyStr, options) {
+  const actualDocument = options?.documentObj ?? window.document;
+  if (actualDocument === null) throw register.getError("no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */, "See documentObj in the options object");
+  const sanitizeOptions = {
+    ...options?.sanitize,
+    documentObj: options?.sanitize?.documentObj ?? options?.documentObj
+  };
+  const str = options?.sanitize !== void 0 ? Sanitize.sanitize(dirtyStr, sanitizeOptions) : dirtyStr;
+  const wrapperDiv = actualDocument.createElement("div");
+  wrapperDiv.innerHTML = str;
+  const nodes = Array.from(wrapperDiv.childNodes).filter((node) => {
+    const allowedNodeTypes = [Node.ELEMENT_NODE, Node.TEXT_NODE];
+    return allowedNodeTypes.includes(node.nodeType);
+  });
+  return nodes;
+}
+
+export {
+  stringToNodes
+};

package/chunks/chunk-ZUWQPR2N.js

@@ -0,0 +1,37 @@
+import {
+  Cast,
+  Tree,
+  Utils
+} from "./chunk-HZJY7N36.js";
+import {
+  Types
+} from "./chunk-XEQ2PBT2.js";
+import {
+  SmartTags
+} from "./chunk-UT2J62LH.js";
+import {
+  Serialize
+} from "./chunk-SXRWMH3U.js";
+import {
+  Transformer
+} from "./chunk-BKO7GLC2.js";
+import {
+  Method
+} from "./chunk-RW7VAKJW.js";
+
+// src/agnostic/html/hyper-json/index.ts
+var HyperJson;
+((HyperJson2) => {
+  HyperJson2.Cast = Cast;
+  HyperJson2.Method = Method;
+  HyperJson2.Serialize = Serialize;
+  HyperJson2.SmartTags = SmartTags;
+  HyperJson2.Transformer = Transformer;
+  HyperJson2.Tree = Tree;
+  HyperJson2.Types = Types;
+  HyperJson2.Utils = Utils;
+})(HyperJson || (HyperJson = {}));
+
+export {
+  HyperJson
+};

package/chunks/chunk-ZVJO36JU.js

@@ -0,0 +1 @@
+var e=[null,void 0];function u(l){return e.includes(l)}function i(l){return!u(l)}var n=u;export{e as a,u as b,i as c,n as d};

package/chunks/chunk-ZWWJ52EY.js

@@ -0,0 +1,42 @@
+import {
+  download as download4
+} from "./chunk-MPYCQ5IF.js";
+import {
+  download as download3
+} from "./chunk-H4NHF72W.js";
+import {
+  download as download2
+} from "./chunk-5RA25FYM.js";
+import {
+  download
+} from "./chunk-QKK6WQDI.js";
+import {
+  isFtpClient,
+  isGcsBucket,
+  isS3ClientWithBucket,
+  isSftpClient
+} from "./chunk-4IHBBNAG.js";
+import {
+  Outcome
+} from "./chunk-JMU5PDBD.js";
+import {
+  __export
+} from "./chunk-KH45J4DC.js";
+
+// src/node/cloud-storage/operations/download-file/index.ts
+var download_file_exports = {};
+__export(download_file_exports, {
+  downloadFile: () => downloadFile
+});
+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 Outcome.makeFailure("Invalid client type");
+}
+
+export {
+  downloadFile,
+  download_file_exports
+};

package/components/Comp/index.js

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

package/index.d.ts

@@ -0,0 +1,3 @@
+export { Agnostic } from './agnostic';
+export { Components } from './components';
+export { Node } from './node';

package/index.js

@@ -0,0 +1,96 @@
+import * as Comp from './components/Comp/index.js'
+import * as absoluteModulo from './utils/agnostic/absolute-modulo/index.js'
+import * as array from './utils/agnostic/array/index.js'
+import * as assert from './utils/agnostic/assert/index.js'
+import * as awaitTimeout from './utils/agnostic/await-timeout/index.js'
+import * as bem from './utils/agnostic/bem/index.js'
+import * as cast from './utils/agnostic/cast/index.js'
+import * as charcodeString from './utils/agnostic/charcode-string/index.js'
+import * as clamp from './utils/agnostic/clamp/index.js'
+import * as clientsideHtmlSanitizer from './utils/agnostic/clientside-html-sanitizer/index.js'
+import * as crossenv from './utils/agnostic/crossenv/index.js'
+import * as flattenGetters from './utils/agnostic/flatten-getters/index.js'
+import * as generateHtmlPlaceholders from './utils/agnostic/generate-html-placeholders/index.js'
+import * as generateNiceColor from './utils/agnostic/generate-nice-color/index.js'
+import * as insertNode from './utils/agnostic/insert-node/index.js'
+import * as interpolate from './utils/agnostic/interpolate/index.js'
+import * as isArrayOf from './utils/agnostic/is-array-of/index.js'
+import * as isConstructorFunction from './utils/agnostic/is-constructor-function/index.js'
+import * as isFalsy from './utils/agnostic/is-falsy/index.js'
+import * as isInEnum from './utils/agnostic/is-in-enum/index.js'
+import * as isNullish from './utils/agnostic/is-nullish/index.js'
+import * as isObject from './utils/agnostic/is-object/index.js'
+import * as isRecord from './utils/agnostic/is-record/index.js'
+import * as isValidCssClassName from './utils/agnostic/is-valid-css-class-name/index.js'
+import * as memoize from './utils/agnostic/memoize/index.js'
+import * as objectValidateFromPartial from './utils/agnostic/object-validate-from-partial/index.js'
+import * as random from './utils/agnostic/random/index.js'
+import * as recordFormat from './utils/agnostic/record-format/index.js'
+import * as regexp from './utils/agnostic/regexp/index.js'
+import * as replaceAll from './utils/agnostic/replace-all/index.js'
+import * as responsiveHarmonics from './utils/agnostic/responsive-harmonics/index.js'
+import * as roundNumbers from './utils/agnostic/round-numbers/index.js'
+import * as selectorToElement from './utils/agnostic/selector-to-element/index.js'
+import * as silentLog from './utils/agnostic/silent-log/index.js'
+import * as strToNodes from './utils/agnostic/str-to-nodes/index.js'
+import * as stringMatches from './utils/agnostic/string-matches/index.js'
+import * as stringNormalizeIndent from './utils/agnostic/string-normalize-indent/index.js'
+import * as throttleDebounce from './utils/agnostic/throttle-debounce/index.js'
+import * as toAlphanum from './utils/agnostic/to-alphanum/index.js'
+import * as transition from './utils/agnostic/transition/index.js'
+import * as wait from './utils/agnostic/wait/index.js'
+import * as dynamicCss from './utils/browser/dynamic-css/index.js'
+import * as getCurrentDownlink from './utils/browser/get-current-downlink/index.js'
+import * as getNodeAncestors from './utils/browser/get-node-ancestors/index.js'
+import * as isInDirectory from './utils/node/is-in-directory/index.js'
+import * as listSubpaths from './utils/node/list-subpaths/index.js'
+import * as processExit from './utils/node/process-exit/index.js'
+import * as readWriteFile from './utils/node/read-write-file/index.js'
+export { Comp }
+export { absoluteModulo }
+export { array }
+export { assert }
+export { awaitTimeout }
+export { bem }
+export { cast }
+export { charcodeString }
+export { clamp }
+export { clientsideHtmlSanitizer }
+export { crossenv }
+export { flattenGetters }
+export { generateHtmlPlaceholders }
+export { generateNiceColor }
+export { insertNode }
+export { interpolate }
+export { isArrayOf }
+export { isConstructorFunction }
+export { isFalsy }
+export { isInEnum }
+export { isNullish }
+export { isObject }
+export { isRecord }
+export { isValidCssClassName }
+export { memoize }
+export { objectValidateFromPartial }
+export { random }
+export { recordFormat }
+export { regexp }
+export { replaceAll }
+export { responsiveHarmonics }
+export { roundNumbers }
+export { selectorToElement }
+export { silentLog }
+export { strToNodes }
+export { stringMatches }
+export { stringNormalizeIndent }
+export { throttleDebounce }
+export { toAlphanum }
+export { transition }
+export { wait }
+export { dynamicCss }
+export { getCurrentDownlink }
+export { getNodeAncestors }
+export { isInDirectory }
+export { listSubpaths }
+export { processExit }
+export { readWriteFile }

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

@@ -1,12 +1,23 @@
 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-V7JZNA6N.js";
+import "../../chunks/chunk-3J4WAVX6.js";
+import "../../chunks/chunk-V7FJOKAC.js";
+import "../../chunks/chunk-QQAPFSMW.js";
+import "../../chunks/chunk-LBDZQNBM.js";
+import "../../chunks/chunk-ZAIWJI6A.js";
+import "../../chunks/chunk-LF4VYSOT.js";
+import "../../chunks/chunk-XYNIGHGL.js";
+import "../../chunks/chunk-IIXTJZ6G.js";
+import "../../chunks/chunk-5WARYKLO.js";
+import "../../chunks/chunk-H4NHF72W.js";
+import "../../chunks/chunk-3G4NTP23.js";
+import "../../chunks/chunk-2UPQ73EE.js";
+import "../../chunks/chunk-NHMEZ6ZP.js";
+import "../../chunks/chunk-IZP4VIFZ.js";
 import "../../chunks/chunk-JMU5PDBD.js";
 import "../../chunks/chunk-FENXVJYO.js";
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-KH45J4DC.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,10 @@
+import {
+  copyDir
+} from "../../../../../chunks/chunk-5WARYKLO.js";
+import "../../../../../chunks/chunk-IZP4VIFZ.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-KH45J4DC.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,23 @@
+import "../../../../chunks/chunk-3J4WAVX6.js";
+import {
+  list_exports
+} from "../../../../chunks/chunk-ZAIWJI6A.js";
+import {
+  remove_dir_exports
+} from "../../../../chunks/chunk-LF4VYSOT.js";
+import {
+  copy_dir_exports
+} from "../../../../chunks/chunk-5WARYKLO.js";
+import {
+  move_dir_exports
+} from "../../../../chunks/chunk-2UPQ73EE.js";
+import "../../../../chunks/chunk-IZP4VIFZ.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.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,10 @@
+import {
+  list
+} from "../../../../../chunks/chunk-ZAIWJI6A.js";
+import "../../../../../chunks/chunk-IZP4VIFZ.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-KH45J4DC.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,10 @@
+import {
+  moveDir
+} from "../../../../../chunks/chunk-2UPQ73EE.js";
+import "../../../../../chunks/chunk-IZP4VIFZ.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-KH45J4DC.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,10 @@
+import {
+  removeDir
+} from "../../../../../chunks/chunk-LF4VYSOT.js";
+import "../../../../../chunks/chunk-IZP4VIFZ.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-KH45J4DC.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,10 @@
+import {
+  copy
+} from "../../../../../chunks/chunk-3G4NTP23.js";
+import "../../../../../chunks/chunk-IZP4VIFZ.js";
+import "../../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../../chunks/chunk-KH45J4DC.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,10 @@
 import {
   download
-} from "../../../../../chunks/chunk-26QQ56SS.js";
+} from "../../../../../chunks/chunk-H4NHF72W.js";
+import "../../../../../chunks/chunk-IZP4VIFZ.js";
 import "../../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../chunks/chunk-KH45J4DC.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>>;