feat: core improvements + local fs provider + UI fixes

server/modules/storage/box/definition.yml

@@ -0,0 +1,7 @@
+key: box
+title: Box
+author: requarks.io
+props:
+  clientId: String
+  clientSecret: String
+  rootFolder: String

server/modules/storage/box/storage.js

@@ -0,0 +1,23 @@
+module.exports = {
+  async activated() {
+
+  },
+  async deactivated() {
+
+  },
+  async init() {
+
+  },
+  async created() {
+
+  },
+  async updated() {
+
+  },
+  async deleted() {
+
+  },
+  async renamed() {
+
+  }
+}

server/modules/storage/disk/definition.yml

@@ -1,5 +1,8 @@
 key: disk
-title: Local FS
+title: Local File System
 author: requarks.io
 props:
-  path: String
+  path:
+    type: String
+    title: Path
+    hint: Absolute path without a trailing slash (e.g. /home/wiki/backup, C:\wiki\backup)

server/modules/storage/disk/storage.js

@@ -1,23 +1,68 @@
-module.exports = {
-  async activated() {
-
-  },
-  async deactivated() {
-
-  },
-  async init() {
-
-  },
-  async created() {
-
-  },
-  async updated() {
-
-  },
-  async deleted() {
-
-  },
-  async renamed() {
+const fs = require('fs-extra')
+const path = require('path')
 
+/**
+ * Get file extension based on content type
+ */
+const getFileExtension = (contentType) => {
+  switch (contentType) {
+    case 'markdown':
+      return 'md'
+    case 'html':
+      return 'html'
+    default:
+      return 'txt'
+  }
+}
+
+/**
+ * Inject page metadata into contents
+ */
+const injectMetadata = (page) => {
+  let meta = [
+    ['title', page.title],
+    ['description', page.description]
+  ]
+  let metaFormatted = ''
+  switch (page.contentType) {
+    case 'markdown':
+      metaFormatted = meta.map(mt => `[//]: # ${mt[0]}: ${mt[1]}`).join('\n')
+      break
+    case 'html':
+      metaFormatted = meta.map(mt => `<!-- ${mt[0]}: ${mt[1]} -->`).join('\n')
+      break
+    default:
+      metaFormatted = meta.map(mt => `#WIKI ${mt[0]}: ${mt[1]}`).join('\n')
+      break
+  }
+  return `${metaFormatted}\n\n${page.content}`
+}
+
+module.exports = {
+  async activated() {
+    // not used
+  },
+  async deactivated() {
+    // not used
+  },
+  async init() {
+    await fs.ensureDir(this.config.path)
+  },
+  async created() {
+    const filePath = path.join(this.config.path, `${this.page.path}.${getFileExtension(this.page.contentType)}`)
+    await fs.outputFile(filePath, injectMetadata(this.page), 'utf8')
+  },
+  async updated() {
+    const filePath = path.join(this.config.path, `${this.page.path}.${getFileExtension(this.page.contentType)}`)
+    await fs.outputFile(filePath, injectMetadata(this.page), 'utf8')
+  },
+  async deleted() {
+    const filePath = path.join(this.config.path, `${this.page.path}.${getFileExtension(this.page.contentType)}`)
+    await fs.unlink(filePath)
+  },
+  async renamed() {
+    const sourceFilePath = path.join(this.config.path, `${this.page.sourcePath}.${getFileExtension(this.page.contentType)}`)
+    const destinationFilePath = path.join(this.config.path, `${this.page.destinationPath}.${getFileExtension(this.page.contentType)}`)
+    await fs.move(sourceFilePath, destinationFilePath, { overwrite: true })
   }
 }

server/modules/storage/git/definition.yml

@@ -5,16 +5,32 @@ props:
   authType:
     type: String
     default: 'ssh'
+    title: Authentication Type
+    hint: Use SSH for maximum security.
     enum:
       - 'basic'
       - 'ssh'
-  repoUrl: String
+  repoUrl:
+    type: String
+    title: Repository URI
+    hint: Git-compliant URI (e.g. git@github.com:org/repo.git for ssh, https://github.com/org/repo.git for basic)
   branch:
     type: String
     default: 'master'
   verifySSL:
     type: Boolean
     default: true
-  sshPrivateKeyPath: String
-  basicUsername: String
-  basicPassword: String
+    title: Verify SSL Certificate
+    hint: Some hosts requires SSL certificate checking to be disabled. Leave enabled for proper security.
+  sshPrivateKeyPath:
+    type: String
+    title: SSH Private Key Path
+    hint: SSH Authentication Only - Absolute path to the key. The key must NOT be passphrase-protected.
+  basicUsername:
+    type: String
+    title: Username
+    hint: Basic Authentication Only
+  basicPassword:
+    type: String
+    title: Password / PAT
+    hint: Basic Authentication Only