nodebb-plugin-integration 0.4.4 → 0.6.0

package/src/nodebb/posts.js

@@ -3,18 +3,10 @@
 const NodeBB = require("./index");
 
 const META_FIELDS = [
-    "pid",
-    "tid",
-    "uid",
-    "timestamp",
-    "deleted",
-    "cid"
+    "pid", "tid", "uid", "timestamp", "deleted", "cid"
 ];
 
-const CONTENT_FIELDS = [
-    "pid",
-    "content"
-];
+const CONTENT_FIELDS = ["pid", "content"];
 
 function validatePid(pid) {
     pid = Number(pid);
@@ -26,9 +18,18 @@ function validatePid(pid) {
     return pid;
 }
 
+function validateUid(uid) {
+    uid = Number(uid);
+
+    if (!Number.isSafeInteger(uid) || uid <= 0) {
+        throw new TypeError("Invalid user ID");
+    }
+
+    return uid;
+}
+
 async function getPostMeta(pid) {
     pid = validatePid(pid);
-
     const posts = NodeBB.get("posts");
 
     if (typeof posts.getPostFields !== "function") {
@@ -40,7 +41,6 @@ async function getPostMeta(pid) {
 
 async function getPostContent(pid) {
     pid = validatePid(pid);
-
     const posts = NodeBB.get("posts");
 
     if (typeof posts.getPostFields !== "function") {
@@ -61,17 +61,13 @@ async function getPosts(pids = [], uid) {
         throw new TypeError("Invalid user ID");
     }
 
-    const unique = [
-        ...new Set(
-            pids
-                .map(Number)
-                .filter(pid => Number.isSafeInteger(pid) && pid > 0)
+    const unique = [...new Set(
+        pids.map(Number).filter(
+            pid => Number.isSafeInteger(pid) && pid > 0
         )
-    ];
+    )];
 
-    if (!unique.length) {
-        return [];
-    }
+    if (!unique.length) return [];
 
     const posts = NodeBB.get("posts");
 
@@ -84,10 +80,65 @@ async function getPosts(pids = [], uid) {
     return result.posts || result;
 }
 
+async function editPost(pid, uid, content) {
+    pid = validatePid(pid);
+    uid = validateUid(uid);
+
+    const posts = NodeBB.get("posts");
+
+    if (typeof posts.edit !== "function") {
+        throw new Error("NodeBB posts.edit is unavailable");
+    }
+
+    return posts.edit({ pid, uid, content });
+}
+
+async function deletePost(pid, uid) {
+    pid = validatePid(pid);
+    uid = validateUid(uid);
+
+    const posts = NodeBB.get("posts");
+
+    if (!posts.tools || typeof posts.tools.delete !== "function") {
+        throw new Error("NodeBB posts.tools.delete is unavailable");
+    }
+
+    return posts.tools.delete(uid, pid);
+}
+
+async function restorePost(pid, uid) {
+    pid = validatePid(pid);
+    uid = validateUid(uid);
+
+    const posts = NodeBB.get("posts");
+
+    if (!posts.tools || typeof posts.tools.restore !== "function") {
+        throw new Error("NodeBB posts.tools.restore is unavailable");
+    }
+
+    return posts.tools.restore(uid, pid);
+}
+
+async function getUserPostIds(uid, start, stop) {
+    uid = validateUid(uid);
+
+    const users = NodeBB.get("users");
+
+    if (typeof users.getPostIds !== "function") {
+        throw new Error("NodeBB users.getPostIds is unavailable");
+    }
+
+    return users.getPostIds(uid, start, stop);
+}
+
 module.exports = {
     getPostMeta,
     getPostContent,
     getPosts,
+    editPost,
+    deletePost,
+    restorePost,
+    getUserPostIds,
     META_FIELDS,
     CONTENT_FIELDS
 };

package/src/nodebb/topics.js

@@ -3,22 +3,19 @@
 const NodeBB = require("./index");
 
 const FIELDS = [
-    "tid",
-    "uid",
-    "title",
-    "cid",
-    "timestamp",
-    "mainPid",
-    "deleted"
+    "tid", "uid", "title", "cid", "timestamp", "mainPid", "deleted", "postcount"
 ];
 
-async function getTopic(tid) {
-    tid = Number(tid);
-
-    if (!Number.isSafeInteger(tid) || tid <= 0) {
-        throw new TypeError("Invalid topic ID");
+function validId(value, name) {
+    const id = Number(value);
+    if (!Number.isSafeInteger(id) || id <= 0) {
+        throw new TypeError(`Invalid ${name}`);
     }
+    return id;
+}
 
+async function getTopic(tid) {
+    tid = validId(tid, "topic ID");
     const topics = NodeBB.get("topics");
 
     if (typeof topics.getTopicFields !== "function") {
@@ -28,13 +25,19 @@ async function getTopic(tid) {
     return topics.getTopicFields(tid, FIELDS);
 }
 
-async function getTopicPids(tid) {
-    tid = Number(tid);
+async function getTopicData(tid) {
+    tid = validId(tid, "topic ID");
+    const topics = NodeBB.get("topics");
 
-    if (!Number.isSafeInteger(tid) || tid <= 0) {
-        throw new TypeError("Invalid topic ID");
+    if (typeof topics.getTopicData !== "function") {
+        throw new Error("NodeBB topics.getTopicData is unavailable");
     }
 
+    return topics.getTopicData(tid);
+}
+
+async function getTopicPids(tid) {
+    tid = validId(tid, "topic ID");
     const topics = NodeBB.get("topics");
 
     if (typeof topics.getPids !== "function") {
@@ -61,9 +64,7 @@ async function getTopics(tids = []) {
         )
     )];
 
-    if (!unique.length) {
-        return [];
-    }
+    if (!unique.length) return [];
 
     const topics = NodeBB.get("topics");
 
@@ -75,18 +76,114 @@ async function getTopics(tids = []) {
 
     for (const tid of unique) {
         const topic = await getTopic(tid);
-
-        if (topic) {
-            result.push(topic);
-        }
+        if (topic) result.push(topic);
     }
 
     return result;
 }
 
+async function createTopic(data) {
+    const topics = NodeBB.get("topics");
+
+    if (typeof topics.post !== "function") {
+        throw new Error("NodeBB topics.post is unavailable");
+    }
+
+    return topics.post(data);
+}
+
+async function createReply(data) {
+    const topics = NodeBB.get("topics");
+
+    if (typeof topics.reply !== "function") {
+        throw new Error("NodeBB topics.reply is unavailable");
+    }
+
+    return topics.reply(data);
+}
+
+async function deleteTopic(tid, uid) {
+    tid = validId(tid, "topic ID");
+    uid = validId(uid, "user ID");
+
+    const topics = NodeBB.get("topics");
+
+    if (!topics.tools || typeof topics.tools.delete !== "function") {
+        throw new Error("NodeBB topics.tools.delete is unavailable");
+    }
+
+    return topics.tools.delete(tid, uid);
+}
+
+async function restoreTopic(tid, uid) {
+    tid = validId(tid, "topic ID");
+    uid = validId(uid, "user ID");
+
+    const topics = NodeBB.get("topics");
+
+    if (!topics.tools || typeof topics.tools.restore !== "function") {
+        throw new Error("NodeBB topics.tools.restore is unavailable");
+    }
+
+    return topics.tools.restore(tid, uid);
+}
+
+async function listTopics(options) {
+    const topics = NodeBB.get("topics");
+
+    if (typeof topics.getSortedTopics !== "function") {
+        throw new Error("NodeBB topics.getSortedTopics is unavailable");
+    }
+
+    const params = {
+        uid: validId(options.uid, "user ID"),
+        start: options.start,
+        stop: options.stop,
+        sort: options.sort || "recent"
+    };
+
+    if (options.cid !== undefined) {
+        params.cids = validId(options.cid, "category ID");
+    }
+
+    return topics.getSortedTopics(params);
+}
+
+async function getTopicPosts(tid, uid, start, limit, reverse = false) {
+    tid = validId(tid, "topic ID");
+    uid = validId(uid, "user ID");
+
+    const topics = NodeBB.get("topics");
+    const topicData = await getTopicData(tid);
+
+    if (!topicData) return [];
+
+    if (typeof topics.getTopicPosts !== "function") {
+        throw new Error("NodeBB topics.getTopicPosts is unavailable");
+    }
+
+    const stop = start + limit - 1;
+
+    return topics.getTopicPosts(
+        topicData,
+        `tid:${tid}:posts`,
+        start,
+        stop,
+        uid,
+        Boolean(reverse)
+    );
+}
+
 module.exports = {
     getTopic,
+    getTopicData,
     getTopics,
     getTopicPids,
+    createTopic,
+    createReply,
+    deleteTopic,
+    restoreTopic,
+    listTopics,
+    getTopicPosts,
     FIELDS
-};
+};

package/src/nodebb/users.js

@@ -36,9 +36,7 @@ async function getUsers(uids = []) {
         )
     )];
 
-    if (!unique.length) {
-        return [];
-    }
+    if (!unique.length) return [];
 
     const users = NodeBB.get("users");
 
@@ -56,8 +54,25 @@ async function getUsers(uids = []) {
     return result;
 }
 
+async function getPostIds(uid, start, stop) {
+    uid = Number(uid);
+
+    if (!Number.isSafeInteger(uid) || uid <= 0) {
+        throw new TypeError("Invalid user ID");
+    }
+
+    const users = NodeBB.get("users");
+
+    if (typeof users.getPostIds !== "function") {
+        throw new Error("NodeBB users.getPostIds is unavailable");
+    }
+
+    return users.getPostIds(uid, start, stop);
+}
+
 module.exports = {
     getUser,
     getUsers,
+    getPostIds,
     FIELDS
-};
+};