@iebh/reflib 2.1.4 → 2.2.0

package/lib/browser.js

@@ -1,9 +1,27 @@
-import {identifyFormat} from './identifyFormat.js';
+import {downloadFile} from './downloadFile.js';
 import {formats} from './formats.js';
 import {getModule} from './getModule.js';
+import {identifyFormat} from './identifyFormat.js';
 import {readStream} from './readStream.js';
 import {uploadFile} from './uploadFile.js';
 import {writeStream} from './writeStream.js';
 
-export {identifyFormat, formats, getModule, readStream, uploadFile, writeStream};
-export default {identifyFormat, formats, getModule, readStream, uploadFile, writeStream};
+export {
+	downloadFile,
+	formats,
+	getModule,
+	identifyFormat,
+	readStream,
+	uploadFile,
+	writeStream,
+};
+
+export default {
+	downloadFile,
+	formats,
+	getModule,
+	identifyFormat,
+	readStream,
+	uploadFile,
+	writeStream,
+};

package/lib/default.js

@@ -6,5 +6,22 @@ import {readFile} from './readFile.js';
 import {writeStream} from './writeStream.js';
 import {writeFile} from './writeFile.js';
 
-export {identifyFormat, formats, getModule, readStream, readFile, writeStream, writeFile};
-export default {identifyFormat, formats, getModule, readStream, readFile, writeStream, writeFile};
+export {
+	formats,
+	getModule,
+	identifyFormat,
+	readFile,
+	readStream,
+	writeFile,
+	writeStream,
+};
+
+export default {
+	formats,
+	getModule,
+	identifyFormat,
+	readFile,
+	readStream,
+	writeFile,
+	writeStream,
+};

package/lib/downloadFile.js

@@ -0,0 +1,90 @@
+import {identifyFormat} from './identifyFormat.js';
+import {writeStream} from './writeStream.js';
+
+/**
+* Prompt the user for a file to save as and Write a given array of citations
+*
+* @param {Array<Ref>} Collection of references to write
+*
+* @param {Object} [options] Additional options when prompting the user
+* @param {String} [options.filename='References.xml'] The filename to download
+* @param {Object} [options.writeStreamOptions] Additional options for the subsequent `writeStream` internal call
+*
+* @returns {Promise} A promise which will resolve when the file download has completed
+*/
+export function downloadFile(refs, options) {
+	let settings = {
+		filename: 'References.xml',
+		writeStreamOptions: {},
+		...options,
+	};
+
+	return Promise.resolve()
+		// Identify module from filename {{{
+		.then(()=> {
+			let module = identifyFormat(settings.filename);
+			if (!module) throw new Error(`Unsupported Reflib filename "${settings.filename}"`);
+			return module;
+		})
+		// }}}
+		// Create stream {{{
+		.then(async (module) => {
+			let blobData = [];
+			let writableStream = new WritableStream({
+				write(chunk) {
+					blobData.push(chunk);
+				},
+			});
+
+			let writer = writableStream.getWriter();
+
+			// Map end->close to keep browser compatibility with Node
+			writer.end = async (cb) => {
+				await writer.close();
+				cb();
+			};
+
+			let streamer = await writeStream(module.id, writer, settings.writeStreamOptions);
+
+			return {blobData, streamer};
+		})
+		// }}}
+		// Flush all references into the stream {{{
+		.then(async ({blobData, streamer}) => {
+			// Start stream
+			await streamer.start();
+
+			// Write all references as a promise chain
+			await refs.reduce((promiseChain, ref) =>
+				promiseChain.then(()=>
+					streamer.write(ref)
+				)
+			, Promise.resolve());
+
+			// End stream
+			await streamer.end();
+
+			return blobData;
+		})
+		// }}}
+		// Convert blobData array to a Blob {{{
+		.then(blobData => {
+			return new Blob(blobData);
+		})
+		// }}}
+		// Download Blob
+		.then(blob => {
+			let url = URL.createObjectURL(blob);
+			let aEl = document.createElement('a');
+			aEl.href = url;
+			aEl.download = settings.filename;
+			document.body.appendChild(aEl);
+			aEl.click();
+
+			// Clean up DOM
+			document.body.removeChild(aEl);
+			URL.revokeObjectURL(url);
+			// }}}
+		})
+		// }}}
+}

package/lib/writeFile.js

@@ -4,9 +4,12 @@ import {writeStream} from './writeStream.js';
 
 /**
 * Write a file to disk via the appropriate module
+*
 * @param {string} path The file path to write, the module to use will be determined from this
+* @param {Array<Ref>} Collection of references to write
 * @param {Object} [options] Additional options to pass to the file writer
 * @param {string} [options.module] The module to use if overriding from the file path
+*
 * @returns {Promise} A promise which resolves when the operation has completed
 */
 export function writeFile(path, refs, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iebh/reflib",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "Reference / Citation reference library utilities",
   "scripts": {
     "lint": "eslint lib modules shared test",