Download stream

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "@ztimson/utils",
-	"version": "0.3.0",
+	"version": "0.4.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@ztimson/utils",
-			"version": "0.3.0",
+			"version": "0.4.0",
 			"license": "MIT",
 			"devDependencies": {
 				"@types/jest": "^29.5.12",

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ztimson/utils",
-	"version": "0.3.0",
+	"version": "0.7.0",
 	"description": "Utility library",
 	"author": "Zak Timson",
 	"license": "MIT",

src/aset.ts

@@ -0,0 +1,58 @@
+export class ASet<T> extends Array {
+	get size() {
+		return this.length;
+	}
+
+	constructor(elements: T[] = []) {
+		super();
+		if(!!elements?.['forEach'])
+			elements.forEach(el => this.add(el));
+	}
+
+	add(el: T) {
+		if(!this.has(el)) this.push(el);
+	}
+
+	delete(el: T) {
+		const index = this.indexOf(el);
+		if(index != -1) this.slice(index, 1);
+	}
+
+	difference(set: ASet<T>) {
+		return new ASet<T>(this.reduce((acc, el) => {
+			if(!set.has(el)) acc.push(el);
+			return acc;
+		}, []));
+	}
+
+	has(el: T) {
+		return this.indexOf(el) != -1;
+	}
+
+	intersection(set: ASet<T>) {
+		return new ASet<T>(this.reduce((acc, el) => {
+			if(set.has(el)) acc.push(el);
+			return acc;
+		}, []));
+	}
+
+	isDisjointFrom(set: ASet<T>) {
+		return this.intersection(set).size == 0;
+	}
+
+	isSubsetOf(set: ASet<T>) {
+		return this.findIndex(el => !set.has(el)) == -1;
+	}
+
+	isSuperset(set: ASet<T>) {
+		return set.findIndex(el => !this.has(el)) == -1;
+	}
+
+	symmetricDifference(set: ASet<T>) {
+		return new ASet([...this.difference(set), ...set.difference(this)]);
+	}
+
+	union(set: ASet<T> | Array<T>) {
+		return new ASet([...this, ...set]);
+	}
+}

src/download.ts

@@ -0,0 +1,52 @@
+import {TypedEmitter, TypedEvents} from './emitter.ts';
+
+export type downloadEvents = TypedEvents & {
+	complete: (blob: Blob) => any;
+	progress: (progress: number) => any;
+}
+
+export function download(href: any, name: string) {
+	const a = document.createElement('a');
+	a.href = href;
+	a.download = name;
+	document.body.appendChild(a);
+	a.click();
+	document.body.removeChild(a);
+}
+
+/**
+ * Download a URL using fetch so progress can be tracked. Uses Typed Emitter to emit a "progress" &
+ * "complete" event.
+ *
+ * @param {string} url
+ * @param {string} downloadName
+ * @return {TypedEmitter<downloadEvents>}
+ */
+export function downloadProgress(url: string, downloadName?: string) {
+	const emitter = new TypedEmitter<downloadEvents>();
+	fetch(url).then(response => {
+		const contentLength = response.headers.get('Content-Length') || '0';
+		const total = parseInt(contentLength, 10);
+		let chunks: any[] = [], loaded = 0;
+		const reader = response.body?.getReader();
+		reader?.read().then(function processResult(result) {
+			if(result.done) {
+				const blob = new Blob(chunks);
+				if(downloadName) {
+					const url = URL.createObjectURL(blob);
+					download(url, downloadName);
+					URL.revokeObjectURL(url);
+				}
+				emitter.emit('complete', blob);
+			} else {
+				const chunk = result.value;
+				chunks.push(chunk);
+				loaded += chunk.length;
+				const progress = loaded / total;
+				emitter.emit('progress', progress);
+				reader.read().then(processResult);
+			}
+		});
+	});
+	return emitter;
+}

src/index.ts

@@ -1,4 +1,6 @@
 export * from './array';
+export * from './aset';
+export * from './download.ts';
 export * from './emitter';
 export * from './errors';
 export * from './logger';

src/xhr.ts

@@ -1,3 +1,4 @@
+import {TypedEmitter, TypedEvents} from './emitter.ts';
 import {clean} from './objects';
 
 export type Interceptor = (request: Response, next: () => void) => void;
@@ -7,6 +8,7 @@ export type RequestOptions = {
 	method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
 	body?: any;
 	headers?: {[key: string | symbol]: string | null | undefined};
+	skipConverting?: boolean;
 	[key: string]: any;
 }
 
@@ -67,8 +69,8 @@ export class XHR {
 			}
 
 			if(!resp.ok) throw new Error(resp.statusText);
-			if(resp.headers.get('Content-Type')?.startsWith('application/json')) return await resp.json();
+			if(!opts.skipConverting && resp.headers.get('Content-Type')?.startsWith('application/json')) return await resp.json();
-			if(resp.headers.get('Content-Type')?.startsWith('text/plain')) return await <any>resp.text();
+			if(!opts.skipConverting && resp.headers.get('Content-Type')?.startsWith('text/plain')) return await <any>resp.text();
 			return resp;
 		});
 	}