backendless 6.3.3 → 6.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backendless",
-  "version": "6.3.3",
+  "version": "6.3.7",
   "description": "Backendless JavaScript SDK for Node.js and the browser",
   "browser": "dist/backendless.js",
   "main": "lib/index.js",
@@ -83,7 +83,7 @@
     "rimraf": "^3.0.2",
     "socket.io": "^2.3.0",
     "terser-webpack-plugin": "^2.3.8",
-    "typescript": "^4.3.4",
+    "typescript": "^4.5.4",
     "watch": "^1.0.2",
     "watchify": "^4.0.0",
     "webpack": "^4.46.0",

package/src/data/index.js

@@ -61,6 +61,12 @@ export default class Data {
     })
   }
 
+  async getTableNameById(tableId) {
+    return this.app.request.get({
+      url: this.app.urls.dataTableNameById(tableId),
+    })
+  }
+
   mapTableToClass(tableName, clientClass) {
     if (typeof tableName === 'function') {
       clientClass = tableName

package/src/files/index.js

@@ -29,7 +29,7 @@ export default class Files {
       query.overwrite = overwrite
     }
 
-    filePath = FilesUtils.preventSlashInPath(filePath)
+    filePath = FilesUtils.trimSlashesInPath(filePath)
     fileName = FilesUtils.sanitizeFileName(fileName)
 
     return this.app.request.put({
@@ -47,7 +47,7 @@ export default class Files {
       query.overwrite = overwrite
     }
 
-    filePath = FilesUtils.preventSlashInPath(filePath)
+    filePath = FilesUtils.trimSlashesInPath(filePath)
 
     const pathTokens = FilesUtils.parseFilePath(filePath)
 
@@ -66,7 +66,7 @@ export default class Files {
       }
 
       return this.app.request.post({
-        url  : `${this.app.urls.filePath(filePath)}/${fileName || ''}`,
+        url  : `${this.app.urls.filePath(filePath)}/${fileName}`,
         query: query,
         data : {
           url: file
@@ -93,6 +93,94 @@ export default class Files {
     })
   }
 
+  async append(filePath, fileName, fileContent) {
+    if (!filePath || typeof filePath !== 'string') {
+      throw new Error('"filePath" must be provided and must be a string.')
+    }
+
+    filePath = FilesUtils.trimSlashesInPath(filePath)
+
+    if (arguments.length === 2) {
+      fileContent = fileName
+      fileName = undefined
+
+      const pathTokens = FilesUtils.parseFilePath(filePath)
+
+      if (pathTokens.fileName) {
+        filePath = pathTokens.filePath
+        fileName = pathTokens.fileName
+      }
+    }
+
+    if (!fileName) {
+      throw new Error('Can not resolve target file name')
+    }
+
+    fileName = FilesUtils.sanitizeFileName(fileName)
+
+    if (typeof fileContent === 'string') {
+      return this.app.request.post({
+        url : `${this.app.urls.fileAppendPath(filePath)}/${fileName}`,
+        data: {
+          url: fileContent
+        },
+      })
+    }
+
+    if (FilesUtils.isBytesArray(fileContent)) {
+      fileContent = await FilesUtils.toBase64(fileContent)
+
+      return this.app.request.put({
+        url    : `${this.app.urls.fileAppendBinaryPath(filePath)}/${fileName}`,
+        headers: { 'Content-Type': 'text/plain' },
+        data   : fileContent,
+      })
+    }
+
+    return this.app.request.post({
+      url : `${this.app.urls.fileAppendPath(filePath)}/${fileName}`,
+      form: {
+        file: fileContent
+      },
+    })
+  }
+
+  async appendText(filePath, fileName, textContent) {
+    if (!filePath || typeof filePath !== 'string') {
+      throw new Error('"filePath" must be provided and must be a string.')
+    }
+
+    filePath = FilesUtils.trimSlashesInPath(filePath)
+
+    if (arguments.length === 2) {
+      textContent = fileName
+      fileName = undefined
+
+      const pathTokens = FilesUtils.parseFilePath(filePath)
+
+      if (pathTokens.fileName) {
+        filePath = pathTokens.filePath
+        fileName = pathTokens.fileName
+      }
+    }
+
+    if (!fileName) {
+      throw new Error('Can not resolve target file name')
+    }
+
+    if (typeof textContent !== 'string') {
+      throw new Error('"textContent" must be a string')
+    }
+
+    fileName = FilesUtils.sanitizeFileName(fileName)
+
+    return this.app.request.put({
+      url    : `${this.app.urls.fileAppendPath(filePath)}/${fileName}`,
+      headers: { 'Content-Type': 'text/plain' },
+      data   : textContent,
+    })
+  }
+
   async listing(filePath, pattern, sub, pagesize, offset) {
     const query = {}
 
@@ -100,7 +188,7 @@ export default class Files {
       throw new Error('"filePath" must be provided and must be a string.')
     }
 
-    filePath = FilesUtils.preventSlashInPath(filePath)
+    filePath = FilesUtils.trimSlashesInPath(filePath)
 
     if (pattern && typeof pattern === 'string') {
       query.pattern = pattern
@@ -181,7 +269,7 @@ export default class Files {
       throw new Error('"filePath" must be provided and must be a string.')
     }
 
-    filePath = FilesUtils.preventSlashInPath(filePath)
+    filePath = FilesUtils.trimSlashesInPath(filePath)
 
     return this.app.request.get({
       url  : this.app.urls.filePath(filePath),
@@ -196,7 +284,7 @@ export default class Files {
       throw new Error('Directory "path" must be provided and must be a string.')
     }
 
-    directoryPath = FilesUtils.preventSlashInPath(directoryPath)
+    directoryPath = FilesUtils.trimSlashesInPath(directoryPath)
 
     return this.app.request.delete({
       url: this.app.urls.filePath(directoryPath),
@@ -212,7 +300,7 @@ export default class Files {
       throw new Error('Files Pattern must be provided and must be a string.')
     }
 
-    filesPath = FilesUtils.preventSlashInPath(filesPath)
+    filesPath = FilesUtils.trimSlashesInPath(filesPath)
 
     return this.app.request.get({
       url  : this.app.urls.filePath(filesPath),

package/src/files/utils.js

@@ -1,10 +1,33 @@
 const FilesUtils = {
+
+  isBytesArray(data) {
+    if (typeof Buffer !== 'undefined' && data instanceof Buffer) {
+      return true
+    }
+
+    if (typeof ArrayBuffer !== 'undefined' && data instanceof ArrayBuffer) {
+      return true
+    }
+
+    return Array.isArray(data)
+  },
+
   ensureSlashInPath(path) {
     return !path.startsWith('/') ? `/${path}` : path
   },
 
-  preventSlashInPath(path) {
-    return (path && path.startsWith('/')) ? path.slice(1) : path
+  trimSlashesInPath(path) {
+    if (path) {
+      if (path.startsWith('/')) {
+        path = path.slice(1)
+      }
+
+      if (path.endsWith('/')) {
+        path = path.slice(0, path.length - 1)
+      }
+    }
+
+    return path
   },
 
   parseFilePath(path) {

package/src/local-cache/index.js

@@ -9,7 +9,9 @@ export default class LocalCache {
   constructor(app) {
     this.app = app
 
-    this.storageName = `${STORAGE_KEY_NAMESPACE}_${this.app.appId}`
+    this.storageName = this.app.appId
+      ? `${STORAGE_KEY_NAMESPACE}_${this.app.appId}`
+      : STORAGE_KEY_NAMESPACE
 
     const Storage = Utils.isLocalStorageSupported
       ? LocalStorage

package/src/logging/index.js

@@ -47,6 +47,10 @@ export default class Logging {
   }
 
   push(logger, logLevel, message, exception) {
+    if (typeof message !== 'string') {
+      throw new Error('"message" must be a string')
+    }
+
     this.pool.push({ logger, message, exception, 'log-level': logLevel, timestamp: Date.now() })
 
     this.checkMessagesLen()

package/src/urls.js

@@ -157,6 +157,10 @@ export default class Urls {
     return `${this.dataTable(tableName)}/permissions/${permissionType}/${objectId}`
   }
 
+  dataTableNameById(tableId) {
+    return `${this.data()}/${tableId}/table-name`
+  }
+
   transactions() {
     return `${this.root()}/transaction/unit-of-work`
   }
@@ -257,6 +261,14 @@ export default class Urls {
     return `${this.files()}/binary/${path}`
   }
 
+  fileAppendPath(path) {
+    return `${this.files()}/append/${path}`
+  }
+
+  fileAppendBinaryPath(path) {
+    return `${this.files()}/append/binary/${path}`
+  }
+
   //users
   users() {
     return `${this.root()}/users`