feat(upload): allow to track children of an upload

This allow to better visualize ongoing uploads in an UI

Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>

Author: susnux

lib/upload/uploader/Upload.ts

@@ -62,6 +62,13 @@ export interface IUpload extends TypedEventTarget<UploadEvents> {
 	 */
 	readonly signal: AbortSignal
 
+	/**
+	 * The children of this upload.
+	 * - For a file upload, this will be an empty array.
+	 * - For a folder upload, this will be the uploads of the children files and folders.
+	 */
+	readonly children: IUpload[]
+
 	/**
 	 * Cancels the upload
 	 */
@@ -82,6 +89,14 @@ export abstract class Upload extends TypedEventTarget<UploadEvents> implements P
 		this.#abortController.abort()
 	}
 
+	/**
+	 * Get the children of this upload.
+	 * For a file upload, this will be an empty array, for a folder upload, this will be the uploads of the children files and folders.
+	 */
+	public get children(): IUpload[] {
+		return []
+	}
+
 	/**
 	 * Start the upload
 	 *

lib/upload/uploader/UploadFileTree.ts

@@ -89,10 +89,15 @@ export class UploadFileTree extends Upload implements IUpload {
 		return false
 	}
 
+	get children(): IUpload[] {
+		return [...this.#children]
+	}
+
 	/**
 	 * Set up all child uploads for this upload tree.
 	 */
 	initialize(): (Upload & IUpload)[] {
+		const grandchildren: (Upload & IUpload)[] = []
 		for (const child of this.#directory.children) {
 			if (child instanceof FileTree) {
 				const upload = new UploadFileTree(
@@ -104,7 +109,8 @@ export class UploadFileTree extends Upload implements IUpload {
 						noChunking: this.#noChunking,
 					},
 				)
-				this.#children.push(upload, ...upload.initialize())
+				this.#children.push(upload)
+				grandchildren.push(...upload.initialize())
 			} else {
 				const upload = new UploadFile(
 					join(this.source, child.name),
@@ -114,7 +120,7 @@ export class UploadFileTree extends Upload implements IUpload {
 				this.#children.push(upload)
 			}
 		}
-		return this.#children
+		return [...this.#children, ...grandchildren]
 	}
 
 	async start(queue: PQueue): Promise<void> {