@iebh/reflib 2.1.3 → 2.2.0

package/README.md

@@ -55,7 +55,7 @@ Each reference has the following standardized fields, these are translated from
 | researchNotes    | `string`        |                                                                                        |
 | keywords         | `array<string>` | Optional list of keywords that apply to the reference                                  |
 | accessDate       | `string`        |                                                                                        |
-| accession        | `string`        |                                                                                        |
+| accession        | `string`        | [Accession numbers spec](https://support.nlm.nih.gov/knowledgebase/article/KA-03434/en-us), can sometimes be the PubMed ID |
 | doi              | `string`        |                                                                                        |
 | section          | `string`        |                                                                                        |
 | language         | `string`        |                                                                                        |

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/modules/endnoteXml.js

@@ -136,8 +136,6 @@ export function readStream(stream) {
 			})
 		}
 
-		console.error("This line should not be hit!");
-
 	})
 
 	return emitter;
@@ -215,6 +213,7 @@ export function writeStream(stream, options) {
 						['database', 'remote-database-name'],
 						['doi', 'electronic-resource-num'],
 						['isbn', 'isbn'],
+						['accessionNum', 'accession-num'],
 						['label', 'label'],
 						['language', 'language'],
 						['notes', 'notes'],
@@ -357,6 +356,7 @@ export let translations = {
 			{rl: 'volume', raw: 'volume'},
 			{rl: 'number', raw: 'number'},
 			{rl: 'isbn', raw: 'isbn'},
+			{rl: 'accessionNum', raw: 'accessionNum'},
 			{rl: 'abstract', raw: 'abstract'},
 			{rl: 'label', raw: 'label'},
 			{rl: 'caption', raw: 'caption'},

package/package.json

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