@warlock.js/seal 5.45.0 → 5.47.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@warlock.js/seal` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.47.0 - 2026-11-06
+
+### Fixed
+
+- **`v.array()` accepts one uploaded file** — a lone uploaded file (a multipart part sent without `[]`) is wrapped into a one-element array before validation, and the validated output carries the array. Strings and other scalars are not wrapped and still fail the array rule.
+
+## 5.46.0 - 2026-11-06
+
+### Changed
+
+- `requiredWith`, `requiredWithout` and the rest of the unsuffixed `required*` rules now say, in their JSDoc and in the docs, that the other field is looked up from the root of the validated data. Inside a nested object such as `address: { en, ar }`, use the `Sibling` variant (`requiredWithoutSibling("ar")`). Behaviour is unchanged.
+
 ## 5.40.0 - 2026-10-29
 
 ### Changed

package/cjs/index.cjs

@@ -562,6 +562,20 @@ const stringMutator = async (value) => {
 //#endregion
 //#region ../../packages/seal/src/validators/array-validator.ts
 /**
+* Brand carried by uploaded file objects (see core's `UploadedFile`). Seal does
+* not depend on core, so it recognises an upload by this registered symbol.
+*/
+const UPLOADED_FILE_BRAND = Symbol.for("warlock.uploadedFile");
+/**
+* A multipart request with one part named `files` (no `[]`) delivers a single
+* uploaded file, because browsers cannot express a one-element list otherwise.
+* Only uploaded files are wrapped — strings and other scalars stay as they are
+* so they still fail the array rule.
+*/
+function wrapSingleUpload(value) {
+	return value !== null && typeof value === "object" && value[UPLOADED_FILE_BRAND] === true ? [value] : value;
+}
+/**
 * Array validator class
 */
 var ArrayValidator = class extends require_required_methods.BaseValidator {
@@ -669,7 +683,8 @@ var ArrayValidator = class extends require_required_methods.BaseValidator {
 	* so the parent ObjectValidator can omit the key. Without this, optional array
 	* fields would silently materialise as `[]` in the validated output.
 	*/
-	async validate(data, context) {
+	async validate(input, context) {
+		const data = wrapSingleUpload(input);
 		const valueForRules = data ?? this.getDefaultValue();
 		const mutatedData = await this.mutate(valueForRules, context);
 		const result = await this.validateRules(data, context);