nodebb-plugin-integration 0.3.0

package/src/ai/indexer.js

@@ -0,0 +1,383 @@
+"use strict";
+
+/*
+
+NodeBB Integration Layer
+
+
+Knowledge Indexer
+
+
+
+*/
+
+
+
+
+const Embeddings =
+require("./embeddings");
+
+const Qdrant =
+require("./qdrant");
+
+const crypto =
+require("crypto");
+
+
+
+
+
+
+
+
+
+
+
+
+
+function createId(prefix, id) {
+
+/*
+ * Qdrant supports UUID or integer.
+ * Create deterministic UUID from source id.
+ */
+
+
+return crypto
+
+    .createHash("sha256")
+
+    .update(
+
+        `${prefix}:${id}`
+
+    )
+
+    .digest("hex")
+
+    .substring(0, 32);
+
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+async function indexDocument(
+
+type,
+
+id,
+
+text,
+
+payload = {}
+
+) {
+
+
+
+
+if(!text || !text.trim()) {
+
+
+    return false;
+
+
+}
+
+
+
+
+
+
+
+const vector =
+
+    await Embeddings.create(
+
+        text
+
+    );
+
+
+
+
+
+
+
+if(!vector) {
+
+
+    console.log(
+
+        "[Indexer] embedding unavailable"
+
+    );
+
+
+    return false;
+
+
+}
+
+
+
+
+
+
+
+await Qdrant.ensureCollection();
+
+
+
+
+
+
+
+
+const pointId =
+
+    createId(
+
+        type,
+
+        id
+
+    );
+
+
+
+
+
+
+
+const result =
+
+    await Qdrant.upsert(
+
+        pointId,
+
+        vector,
+
+        {
+
+
+            type,
+
+
+            sourceId: id,
+
+
+            text,
+
+
+            ...payload
+
+
+        }
+
+
+    );
+
+
+
+
+
+
+
+
+if(result) {
+
+
+
+    console.log(
+
+        `[Indexer] indexed ${type}:${id}`
+
+    );
+
+
+}
+
+
+
+
+
+
+
+return result;
+
+
+
+
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+/*
+
+Index post
+*/
+
+async function indexPost(post) {
+
+
+
+
+if(!post) {
+
+
+    return false;
+
+
+}
+
+
+
+
+
+
+
+return indexDocument(
+
+    "post",
+
+    post.pid,
+
+
+    post.content || post.text || "",
+
+
+    {
+
+
+        pid:
+            post.pid,
+
+
+        uid:
+            post.uid,
+
+
+        tid:
+            post.tid
+
+
+
+    }
+
+
+);
+
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+/*
+
+Index topic
+*/
+
+async function indexTopic(topic) {
+
+
+
+
+if(!topic) {
+
+
+    return false;
+
+
+}
+
+
+
+
+
+
+
+return indexDocument(
+
+    "topic",
+
+    topic.tid,
+
+
+    topic.title || "",
+
+
+    {
+
+
+        tid:
+            topic.tid,
+
+
+        uid:
+            topic.uid
+
+
+
+    }
+
+
+);
+
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+module.exports = {
+
+indexPost,
+
+
+indexTopic,
+
+
+indexDocument
+
+
+
+
+};

package/src/ai/openai.js

@@ -0,0 +1,331 @@
+"use strict";
+
+
+/*
+ * NodeBB Integration Layer
+ *
+ * OpenAI Adapter
+ *
+ * Provides:
+ *
+ * - Chat completion
+ * - Embeddings
+ *
+ * Safe modes:
+ *
+ * - Development
+ * - Test
+ * - Production
+ */
+
+
+
+const Config =
+    require("../config");
+
+
+
+let client = null;
+
+
+
+
+
+
+
+
+/*
+ * Check API availability
+ */
+
+
+function isAvailable() {
+
+
+    return Boolean(
+
+        Config.openai.apiKey
+
+    );
+
+
+}
+
+
+
+
+
+
+
+
+
+/*
+ * Lazy OpenAI client creation
+ */
+
+
+async function getClient() {
+
+
+
+    if(client) {
+
+
+        return client;
+
+
+    }
+
+
+
+
+
+
+
+    if(!isAvailable()) {
+
+
+        console.log(
+
+            "[OpenAI] API key not configured"
+
+        );
+
+
+        return null;
+
+
+    }
+
+
+
+
+
+
+
+
+    try {
+
+
+
+        const OpenAI =
+            require("openai");
+
+
+
+
+
+        client =
+            new OpenAI({
+
+                apiKey:
+                    Config.openai.apiKey
+
+            });
+
+
+
+
+
+
+        return client;
+
+
+    }
+
+
+    catch(error) {
+
+
+
+        console.error(
+
+            "[OpenAI] initialization failed",
+
+            error
+
+        );
+
+
+
+        return null;
+
+
+    }
+
+
+}
+
+
+
+
+
+
+
+
+
+/*
+ * Create embedding vector
+ */
+
+
+async function embeddings(text) {
+
+
+
+    const openai =
+        await getClient();
+
+
+
+
+
+    if(!openai) {
+
+
+
+        return null;
+
+
+    }
+
+
+
+
+
+
+
+
+    if(!text || !text.trim()) {
+
+
+
+        return null;
+
+
+    }
+
+
+
+
+
+
+
+
+    const response =
+        await openai.embeddings.create({
+
+            model:
+                Config.openai.embeddingModel,
+
+
+            input:
+                text
+
+
+        });
+
+
+
+
+
+
+    return response
+        .data[0]
+        .embedding;
+
+
+}
+
+
+
+
+
+
+
+
+
+/*
+ * Chat completion
+ */
+
+
+async function chat(messages) {
+
+
+
+    const openai =
+        await getClient();
+
+
+
+
+
+    if(!openai) {
+
+
+        return null;
+
+
+    }
+
+
+
+
+
+
+
+    const response =
+        await openai.chat.completions.create({
+
+
+            model:
+                Config.openai.model,
+
+
+
+            messages
+
+
+
+        });
+
+
+
+
+
+
+
+    return response
+        .choices[0]
+        .message
+        .content;
+
+
+}
+
+
+
+
+
+
+
+
+
+module.exports = {
+
+
+    isAvailable,
+
+
+    getClient,
+
+
+    embeddings,
+
+
+    chat
+
+
+
+};