files.com 1.0.256 → 1.0.258

package/package.json

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

package/shared/normalization_for_comparison_test_data.json

@@ -0,0 +1,38 @@
+[
+  [ "filename.txt", "filename.txt" ],
+  [ "FiLeNaMe.TxT", "filename.txt" ],
+  [ "FILENAME.TXT", "filename.txt" ],
+  [ "FÎŁĘÑÂMÉ.TXT", "filename.txt" ],
+  [ "Fïłèńämê.Txt", "filename.txt" ],
+  [ "a/b/c.txt", "a/b/c.txt" ],
+  [ "A\\B\\C.TXT", "a/b/c.txt" ],
+  [ "A/B\\C.TXT", "a/b/c.txt" ],
+  [ "//a/b//c.txt", "a/b/c.txt" ],
+  [ "a/b/c.txt  ", "a/b/c.txt" ],
+  [ "a/b/c.txt\t", "a/b/c.txt" ],
+  [ "a/b/c.txt\n", "a/b/c.txt" ],
+  [ "a/b/c.txt\r", "a/b/c.txt" ],
+  [ " space_at_beginning", " space_at_beginning"],
+  [ "space_at_end ", "space_at_end"],
+  [ "tab\tseperated", "tab\tseperated"],
+  [ "<title>hello</hello>", "<title>hello</hello>"],
+  [ "안녕하세요", "안녕하세요" ],
+  [ "こんにちは", "こんにちは" ],
+  [ "今日は", "今日は" ],
+  [ "longest_unicode_character_﷽", "longest_unicode_character_﷽"],
+  [ "invalid_null_byte_before\u0000after", "invalid_null_byte_beforeafter" ],
+  [ "a/b/c/../../hello", "a/b/c/hello" ],
+  [ "a/b/c/././hello", "a/b/c/hello" ],
+  [ "one_code_point_ą", "one_code_point_a" ],
+  [ "two_code_points_ą", "two_code_points_a" ],
+  [ "one_code_point_훯", "one_code_point_훯"],
+  [ "three_code_points_훯", "three_code_points_훯" ],
+  [ "ÞþŊŋŦŧ", "þþŋŋŧŧ" ],
+  [ "ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýÿ", "aaaaaaaeceeeeiiiidnoooooouuuuyssaaaaaaaeceeeeiiiidnoooooouuuuyy" ],
+  [ "ĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİIJij", "aaaaaaccccccccddddeeeeeeeeeegggggggghhhhiiiiiiiiiijij" ],
+  [ "ĴĵĶķĹĺĻļĽľŁłŃńŅņŇňʼnŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤť", "jjkkllllllllnnnnnnʼnoooooooeoerrrrrrsssssssstttt" ],
+  [ "ŨũŪūŬŭŮůŰűŲųŴŵŶŷŸŹźŻżŽž", "uuuuuuuuuuuuwwyyyzzzzzz" ],
+  [ "😂❤️😍🤣😊🙏💕😭😘👍😅👏😁♥️🔥💔💖💙😢🤔😆🙄💪😉☺️👌🤗", "😂❤️😍🤣😊🙏💕😭😘👍😅👏😁♥️🔥💔💖💙😢🤔😆🙄💪😉☺️👌🤗" ],
+  [ "💜😔😎😇🌹🤦🎉💞✌️✨🤷😱😌🌸🙌😋💗💚😏💛🙂💓🤩😄😀🖤😃💯🙈👇🎶😒🤭❣️", "💜😔😎😇🌹🤦🎉💞✌️✨🤷😱😌🌸🙌😋💗💚😏💛🙂💓🤩😄😀🖤😃💯🙈👇🎶😒🤭❣️" ],
+  [ "emoji_‼️", "emoji_!!️" ]
+]

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()