@h3ravel/http 11.5.0 → 11.5.2

package/dist/index.cjs

@@ -18997,7 +18997,7 @@ var FormRequest = class {
 		};
 		for (const [rawKey, value] of data.entries()) {
 			const key = rawKey.endsWith("[]") ? rawKey.slice(0, -2) : rawKey;
-			if (value instanceof File) {
+			if (value instanceof UploadedFile || value instanceof File) {
 				const uploaded = value instanceof UploadedFile ? value : UploadedFile.createFromBase(value);
 				if (this.dataset.files[key]) {
 					const existing = this.dataset.files[key];
@@ -19110,14 +19110,14 @@ var Request = class Request {
 	*/
 	request;
 	/**
-	* Query string parameters (GET).
-	*/
-	query;
-	/**
 	* Uploaded files (FILES).
 	*/
 	files;
 	/**
+	* Query string parameters (GET).
+	*/
+	query;
+	/**
 	* Server and execution environment parameters
 	*/
 	server;
@@ -19238,14 +19238,37 @@ var Request = class Request {
 	*
 	* @param key
 	* @param defaultValue
+	* @param expectArray 
 	* @returns
 	*/
-	file(key, defaultValue) {
-		const source = this.allFiles();
-		return key ? (0, __h3ravel_support.data_get)(source, key, defaultValue) : source;
+	file(key, defaultValue, expectArray) {
+		const files = (0, __h3ravel_support.data_get)(this.allFiles(), key, defaultValue);
+		if (!files) return defaultValue;
+		if (Array.isArray(files)) return expectArray ? files : files[0];
+		return files;
+	}
+	/**
+	* Determine if the uploaded data contains a file.
+	*
+	* @param  key
+	* @return boolean
+	*/
+	hasFile(key) {
+		let files = this.file(key, void 0, true);
+		if (!Array.isArray(files)) files = [files];
+		return files.some((e) => this.isValidFile(e));
 	}
 	/**
-	* Get an array of all of the files on the request.
+	* Check that the given file is a valid file instance.
+	*
+	* @param file
+	* @return boolean
+	*/
+	isValidFile(file) {
+		return file.content instanceof File && file.size > 0;
+	}
+	/**
+	* Get an object with all the files on the request.
 	*/
 	allFiles() {
 		if (this.convertedFiles) return this.convertedFiles;
@@ -19591,26 +19614,6 @@ var Request = class Request {
 		return content;
 	}
 	/**
-	* Determine if the uploaded data contains a file.
-	*
-	* @param  key
-	* @return boolean
-	*/
-	hasFile(key) {
-		let files = this.file(key);
-		if (!Array.isArray(files)) files = [files];
-		return files.some((e) => this.isValidFile(e));
-	}
-	/**
-	* Check that the given file is a valid file instance.
-	*
-	* @param file
-	* @return boolean
-	*/
-	isValidFile(file) {
-		return file.content instanceof File && file.size > 0;
-	}
-	/**
 	* Gets a "parameter" value from any bag.
 	*
 	* This method is mainly useful for libraries that want to provide some flexibility. If you don't need the

package/dist/index.d.cts

@@ -581,14 +581,14 @@ declare class Request implements IRequest {
    * @see getPayload() for portability between content types
    */
   protected request: InputBag;
-  /**
-   * Query string parameters (GET).
-   */
-  query: InputBag;
   /**
    * Uploaded files (FILES).
    */
   files: FileBag;
+  /**
+   * Query string parameters (GET).
+   */
+  query: InputBag;
   /**
    * Server and execution environment parameters
    */
@@ -664,11 +664,26 @@ declare class Request implements IRequest {
    *
    * @param key
    * @param defaultValue
+   * @param expectArray
    * @returns
    */
-  file<K extends string | undefined = undefined>(key?: K, defaultValue?: any): K extends undefined ? Record<string, UploadedFile | UploadedFile[]> : UploadedFile | UploadedFile[];
+  file<K extends string | undefined = undefined, E extends boolean | undefined = undefined>(key?: K, defaultValue?: any, expectArray?: E): K extends undefined ? Record<string, E extends true ? UploadedFile[] : UploadedFile> : E extends true ? UploadedFile[] : UploadedFile;
+  /**
+   * Determine if the uploaded data contains a file.
+   *
+   * @param  key
+   * @return boolean
+   */
+  hasFile(key: string): boolean;
+  /**
+   * Check that the given file is a valid file instance.
+   *
+   * @param file
+   * @return boolean
+   */
+  protected isValidFile(file: UploadedFile): boolean;
   /**
-   * Get an array of all of the files on the request.
+   * Get an object with all the files on the request.
    */
   allFiles(): Record<string, UploadedFile | UploadedFile[]>;
   /**
@@ -848,20 +863,6 @@ declare class Request implements IRequest {
    * @return {string | ReadableStream | Promise<string | ReadableStream>}
    */
   getContent(asStream?: boolean): string | ReadableStream;
-  /**
-   * Determine if the uploaded data contains a file.
-   *
-   * @param  key
-   * @return boolean
-   */
-  hasFile(key: string): boolean;
-  /**
-   * Check that the given file is a valid file instance.
-   *
-   * @param file
-   * @return boolean
-   */
-  protected isValidFile(file: UploadedFile): boolean;
   /**
    * Gets a "parameter" value from any bag.
    *

package/dist/index.d.ts

@@ -581,14 +581,14 @@ declare class Request implements IRequest {
    * @see getPayload() for portability between content types
    */
   protected request: InputBag;
-  /**
-   * Query string parameters (GET).
-   */
-  query: InputBag;
   /**
    * Uploaded files (FILES).
    */
   files: FileBag;
+  /**
+   * Query string parameters (GET).
+   */
+  query: InputBag;
   /**
    * Server and execution environment parameters
    */
@@ -664,11 +664,26 @@ declare class Request implements IRequest {
    *
    * @param key
    * @param defaultValue
+   * @param expectArray
    * @returns
    */
-  file<K extends string | undefined = undefined>(key?: K, defaultValue?: any): K extends undefined ? Record<string, UploadedFile | UploadedFile[]> : UploadedFile | UploadedFile[];
+  file<K extends string | undefined = undefined, E extends boolean | undefined = undefined>(key?: K, defaultValue?: any, expectArray?: E): K extends undefined ? Record<string, E extends true ? UploadedFile[] : UploadedFile> : E extends true ? UploadedFile[] : UploadedFile;
+  /**
+   * Determine if the uploaded data contains a file.
+   *
+   * @param  key
+   * @return boolean
+   */
+  hasFile(key: string): boolean;
+  /**
+   * Check that the given file is a valid file instance.
+   *
+   * @param file
+   * @return boolean
+   */
+  protected isValidFile(file: UploadedFile): boolean;
   /**
-   * Get an array of all of the files on the request.
+   * Get an object with all the files on the request.
    */
   allFiles(): Record<string, UploadedFile | UploadedFile[]>;
   /**
@@ -848,20 +863,6 @@ declare class Request implements IRequest {
    * @return {string | ReadableStream | Promise<string | ReadableStream>}
    */
   getContent(asStream?: boolean): string | ReadableStream;
-  /**
-   * Determine if the uploaded data contains a file.
-   *
-   * @param  key
-   * @return boolean
-   */
-  hasFile(key: string): boolean;
-  /**
-   * Check that the given file is a valid file instance.
-   *
-   * @param file
-   * @return boolean
-   */
-  protected isValidFile(file: UploadedFile): boolean;
   /**
    * Gets a "parameter" value from any bag.
    *

package/dist/index.js

@@ -18977,7 +18977,7 @@ var FormRequest = class {
 		};
 		for (const [rawKey, value] of data.entries()) {
 			const key = rawKey.endsWith("[]") ? rawKey.slice(0, -2) : rawKey;
-			if (value instanceof File) {
+			if (value instanceof UploadedFile || value instanceof File) {
 				const uploaded = value instanceof UploadedFile ? value : UploadedFile.createFromBase(value);
 				if (this.dataset.files[key]) {
 					const existing = this.dataset.files[key];
@@ -19090,14 +19090,14 @@ var Request = class Request {
 	*/
 	request;
 	/**
-	* Query string parameters (GET).
-	*/
-	query;
-	/**
 	* Uploaded files (FILES).
 	*/
 	files;
 	/**
+	* Query string parameters (GET).
+	*/
+	query;
+	/**
 	* Server and execution environment parameters
 	*/
 	server;
@@ -19218,14 +19218,37 @@ var Request = class Request {
 	*
 	* @param key
 	* @param defaultValue
+	* @param expectArray 
 	* @returns
 	*/
-	file(key, defaultValue) {
-		const source = this.allFiles();
-		return key ? data_get(source, key, defaultValue) : source;
+	file(key, defaultValue, expectArray) {
+		const files = data_get(this.allFiles(), key, defaultValue);
+		if (!files) return defaultValue;
+		if (Array.isArray(files)) return expectArray ? files : files[0];
+		return files;
+	}
+	/**
+	* Determine if the uploaded data contains a file.
+	*
+	* @param  key
+	* @return boolean
+	*/
+	hasFile(key) {
+		let files = this.file(key, void 0, true);
+		if (!Array.isArray(files)) files = [files];
+		return files.some((e) => this.isValidFile(e));
 	}
 	/**
-	* Get an array of all of the files on the request.
+	* Check that the given file is a valid file instance.
+	*
+	* @param file
+	* @return boolean
+	*/
+	isValidFile(file) {
+		return file.content instanceof File && file.size > 0;
+	}
+	/**
+	* Get an object with all the files on the request.
 	*/
 	allFiles() {
 		if (this.convertedFiles) return this.convertedFiles;
@@ -19571,26 +19594,6 @@ var Request = class Request {
 		return content;
 	}
 	/**
-	* Determine if the uploaded data contains a file.
-	*
-	* @param  key
-	* @return boolean
-	*/
-	hasFile(key) {
-		let files = this.file(key);
-		if (!Array.isArray(files)) files = [files];
-		return files.some((e) => this.isValidFile(e));
-	}
-	/**
-	* Check that the given file is a valid file instance.
-	*
-	* @param file
-	* @return boolean
-	*/
-	isValidFile(file) {
-		return file.content instanceof File && file.size > 0;
-	}
-	/**
 	* Gets a "parameter" value from any bag.
 	*
 	* This method is mainly useful for libraries that want to provide some flexibility. If you don't need the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/http",
-  "version": "11.5.0",
+  "version": "11.5.2",
   "description": "HTTP kernel, middleware pipeline, request/response classes for H3ravel.",
   "h3ravel": {
     "providers": [