files.com 1.0.256 → 1.0.257

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "files.com",
-  "version": "1.0.256",
+  "version": "1.0.257",
   "description": "Files.com SDK for JavaScript",
   "keywords": [
     "files.com",

package/src/isomorphic/File.node.js

@@ -21,6 +21,19 @@ const saveUrlToStream = async (url, stream) => new Promise((resolve, reject) =>
   })
 })
 
+const saveUrlToString = async url => new Promise((resolve, reject) => {
+  const https = require('https')
+
+  https.get(url, response => {
+    const chunks = []
+    response.on('data', chunk => chunks.push(Buffer.from(chunk)))
+    response.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+  })
+  .on('error', error => {
+    reject(error)
+  })
+})
+
 const saveUrlToFile = async (url, destinationPath) => {
   const stream = openDiskFileWriteStream(destinationPath)
   await saveUrlToStream(url, stream)
@@ -32,4 +45,5 @@ export {
   openDiskFileWriteStream,
   saveUrlToFile,
   saveUrlToStream,
+  saveUrlToString,
 }

package/src/models/File.js

@@ -199,6 +199,21 @@ class File {
     return saveUrlToStream(downloadUri, writableStream)
   }
 
+  downloadToString = async () => {
+    if (isBrowser()) {
+      throw new errors.NotImplementedError('String downloads are only available in a NodeJS environment')
+    }
+
+    const downloadUri = this.getDownloadUri()
+
+    if (!downloadUri) {
+      throw new errors.EmptyPropertyError('Current object has no download URI')
+    }
+
+    const { saveUrlToString } = require('../isomorphic/File.node.js')
+    return saveUrlToString(downloadUri)
+  }
+
   downloadToFile = async destinationPath => {
     if (isBrowser()) {
       throw new errors.NotImplementedError('Disk file downloads are only available in a NodeJS environment')

package/test/src/index.js

@@ -64,7 +64,7 @@ const testSuite = async () => {
     Logger.info('***** testFolderListAutoPagination() succeeded! *****')
   }
 
-  const testUploadAndDownload = async () => {
+  const testUploadAndDownloadToFile = async () => {
     const sourceFilePath = '../files.com-logo.png'
 
     const displayName = `files.com-logo__${nonce}.png`
@@ -99,7 +99,37 @@ const testSuite = async () => {
 
     await file.delete()
 
-    Logger.info('***** testUploadAndDownload() succeeded! *****')
+    Logger.info('***** testUploadAndDownloadToFile() succeeded! *****')
+  }
+
+  const testUploadAndDownloadToString = async () => {
+    const displayName = `test-text__${nonce}.txt`
+    const destinationPath = `${SDK_TEST_ROOT_FOLDER}/${displayName}`
+
+    const sourceFileContents = 'The quick brown fox jumped over the lazy dogs.'
+    const file = await File.uploadData(destinationPath, sourceFileContents)
+
+    assert(!!file.path)
+    assert(file.display_name === displayName)
+
+    const foundFile = await File.find(destinationPath)
+
+    assert(foundFile.path === destinationPath)
+    assert(foundFile.display_name === displayName)
+    assert(typeof foundFile.getDownloadUri() === 'undefined')
+
+    if (!isBrowser()) {
+      const downloadableFile = await foundFile.download()
+      assert(typeof downloadableFile.getDownloadUri() !== 'undefined')
+
+      const downloadedFileContents = await downloadableFile.downloadToString()
+
+      assert(sourceFileContents === downloadedFileContents)
+    }
+
+    await file.delete()
+
+    Logger.info('***** testUploadAndDownloadToString() succeeded! *****')
   }
 
   /* to run this test, put a file (or symlink) at huge-file.ext * /
@@ -200,7 +230,8 @@ const testSuite = async () => {
   //
 
   await testFolderListAutoPagination()
-  await testUploadAndDownload()
+  await testUploadAndDownloadToFile()
+  await testUploadAndDownloadToString()
   // await testUploadHugeFile() // to run this test, put a file (or symlink) at huge-file.ext
   await testSession()
   await testFailure()