nodebb-plugin-integration 0.3.0 → 0.4.2

package/languages/en-GB/integration.json

@@ -0,0 +1,15 @@
+{
+    "title": "NodeBB Integration",
+
+    "settings": {
+        "ai-provider": "AI Provider",
+        "openai-key": "OpenAI API Key",
+        "openai-model": "OpenAI Embedding Model",
+        "qdrant-url": "Qdrant URL",
+        "collection": "Collection",
+        "mcp-enabled": "Enable MCP Server",
+        "mcp-port": "MCP Port",
+        "save": "Save Settings",
+        "saved": "Settings saved successfully"
+    }
+}

package/languages/ru/integration.json

@@ -0,0 +1,15 @@
+{
+    "title": "���������� NodeBB",
+
+    "settings": {
+        "ai-provider": "AI ���������",
+        "openai-key": "OpenAI API ����",
+        "openai-model": "������ ����������� OpenAI",
+        "qdrant-url": "URL Qdrant",
+        "collection": "���������",
+        "mcp-enabled": "�������� MCP ������",
+        "mcp-port": "���� MCP",
+        "save": "��������� ���������",
+        "saved": "��������� ������� ���������"
+    }
+}

package/library.js

@@ -6,166 +6,110 @@
  * Main plugin entry point
  */
 
-require("dotenv").config();
-
 const Config = require("./src/config");
 const Routes = require("./src/routes");
 const Events = require("./src/events");
 const Indexer = require("./src/ai/indexer");
 const MCP = require("./src/mcp/server");
 
-
 const Plugin = {};
 
-
 /**
- * NodeBB hook:
- *
  * static:app.load
  */
-Plugin.init = async function ({ router } = {}) {
+Plugin.init = async function (params = {}) {
 
-    console.log(
-        "[NodeBB Integration] initializing"
-    );
+    console.log("[NodeBB Integration] initializing");
 
+    const { router, middleware } = params;
 
     if (router) {
-
-        Routes.init(
-            router
-        );
-
+        Routes.init(router, middleware);
     } else {
-
-        console.log(
-            "[NodeBB Integration] router unavailable (standalone mode)"
-        );
-
+        console.log("[NodeBB Integration] router unavailable (standalone mode)");
     }
 
-
-    if (
-        Events &&
-        typeof Events.init === "function"
-    ) {
-
+    if (Events && typeof Events.init === "function") {
         await Events.init();
-
     }
 
+    const settings = await Config.get();
 
     if (
-        Config?.mcp?.enabled &&
-        process.env.MCP_AUTOSTART === "true" &&
+        settings.mcpEnabled &&
         MCP &&
         typeof MCP.start === "function"
     ) {
-
-        await MCP.start();
-
-        console.log(
-            "[NodeBB Integration] MCP started"
-        );
-
+        try {
+            await MCP.start();
+            console.log("[NodeBB Integration] MCP server started");
+        } catch (err) {
+            console.error("[NodeBB Integration] MCP start failed:", err.message);
+        }
     }
 
-
-    console.log(
-        "[NodeBB Integration] ready"
-    );
-
+    console.log("[NodeBB Integration] ready");
 };
 
-
 /**
- * NodeBB hook:
- *
  * action:post.save
  */
 Plugin.onPostSave = async function (post) {
 
     try {
 
-        if (
-            Events &&
-            typeof Events.postSave === "function"
-        ) {
-
-            await Events.postSave(
-                post
-            );
-
+        if (Events && typeof Events.postSave === "function") {
+            await Events.postSave(post);
         }
 
-
-        if (
-            Indexer &&
-            typeof Indexer.indexPost === "function"
-        ) {
-
-            await Indexer.indexPost(
-                post
-            );
-
+        if (Indexer && typeof Indexer.indexPost === "function") {
+            await Indexer.indexPost(post);
         }
 
+    } catch (err) {
 
-    } catch (error) {
-
-        console.error(
-            "[Plugin] post save error",
-            error.message
-        );
+        console.error("[Plugin] post save error:", err.message);
 
     }
 
 };
 
-
 /**
- * NodeBB hook:
- *
  * action:topic.save
  */
 Plugin.onTopicSave = async function (topic) {
 
     try {
 
-        if (
-            Events &&
-            typeof Events.topicCreate === "function"
-        ) {
-
-            await Events.topicCreate(
-                topic
-            );
-
+        if (Events && typeof Events.topicCreate === "function") {
+            await Events.topicCreate(topic);
         }
 
+        if (Indexer && typeof Indexer.indexTopic === "function") {
+            await Indexer.indexTopic(topic);
+        }
 
-        if (
-            Indexer &&
-            typeof Indexer.indexTopic === "function"
-        ) {
+    } catch (err) {
 
-            await Indexer.indexTopic(
-                topic
-            );
+        console.error("[Plugin] topic save error:", err.message);
 
-        }
+    }
 
+};
 
-    } catch (error) {
+/**
+ * ACP menu item
+ */
+Plugin.addAdminNavigation = async function (header) {
 
-        console.error(
-            "[Plugin] topic save error",
-            error.message
-        );
+    header.plugins.push({
+        route: "/plugins/integration",
+        icon: "fa-robot",
+        name: "NodeBB Integration"
+    });
 
-    }
+    return header;
 
 };
 
-
 module.exports = Plugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodebb-plugin-integration",
-  "version": "0.3.0",
+  "version": "0.4.2",
   "description": "AI integration layer for NodeBB forums with MCP, semantic search, RAG and Qdrant knowledge pipeline",
   "main": "library.js",
   "license": "MIT",
@@ -8,6 +8,17 @@
     "type": "git",
     "url": "https://github.com/Sergey-ek/nodebb-plugin-integration.git"
   },
+  "files": [
+    "library.js",
+    "plugin.json",
+    "src",
+    "public",
+    "templates",
+    "languages",
+    "README.md",
+    "README.ru.md",
+    "LICENSE"
+  ],
   "keywords": [
     "nodebb",
     "nodebb-plugin",
@@ -23,13 +34,6 @@
   "engines": {
     "node": ">=20"
   },
-  "files": [
-    "library.js",
-    "plugin.json",
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
   "scripts": {
     "test": "cross-env NODE_ENV=test mocha test/*.test.js",
     "check": "node --check library.js && node --check src/routes/index.js && node --check src/routes/api.js && node --check src/mcp/server.js && node --check src/mcp/tools.js",

package/plugin.json

@@ -3,9 +3,15 @@
   "name": "NodeBB Integration Layer",
   "description": "AI integration layer for NodeBB with MCP, semantic search, RAG and Qdrant knowledge pipeline",
   "library": "./library.js",
+
   "staticDirs": {
     "public": "public"
   },
+
+  "modules": {
+    "admin/plugins/integration.js": "public/js/admin.js"
+  },
+
   "hooks": [
     {
       "hook": "static:app.load",
@@ -18,6 +24,10 @@
     {
       "hook": "action:topic.save",
       "method": "onTopicSave"
+    },
+    {
+      "hook": "filter:admin.header.build",
+      "method": "addAdminNavigation"
     }
   ]
 }

package/public/js/admin.js

@@ -0,0 +1,45 @@
+"use strict";
+
+define("admin/plugins/integration", [
+    "settings",
+    "alerts"
+], function (Settings, Alerts) {
+
+    const ACP = {};
+
+    ACP.init = function () {
+
+        Settings.load(
+            "nodebb-plugin-integration",
+            $(".acp-page-container"),
+            function () {
+
+                console.log(
+                    "[NodeBB Integration] settings loaded"
+                );
+
+            }
+        );
+
+        $("#save").on("click", function () {
+
+            Settings.save(
+                "nodebb-plugin-integration",
+                $(".acp-page-container"),
+                function () {
+
+                    Alerts.success({
+                        title: "NodeBB Integration",
+                        message: "Settings saved"
+                    });
+
+                }
+            );
+
+        });
+
+    };
+
+    return ACP;
+
+});

package/src/config/index.js

@@ -1,322 +1,133 @@
-"use strict";
-
-/*
-
-NodeBB Integration Layer
-
-
-Global configuration
-
-
-
-*/
-
-require("dotenv").config();
-
-
-
-
-
-
-
-
-
-
-
-
-
-const Config = {
-
-
-
-
-environment:
-
-    process.env.NODE_ENV ||
-
-    "development",
-
-
-
-
-
-nodebb: {
-
-
-    url:
-
-        process.env.NODEBB_URL ||
-
-        "http://localhost:4567",
-
-
-
-    apiKey:
-
-        process.env.NODEBB_API_KEY ||
-
-        ""
-
-
-},
-
-
-
-
-
-
-
-
-redis: {
-
-
-    host:
-
-        process.env.REDIS_HOST ||
-
-        "localhost",
-
-
-
-    port:
-
-        Number(
-
-            process.env.REDIS_PORT ||
-
-            6379
-
-        ),
-
-
-
-    password:
-
-        process.env.REDIS_PASSWORD ||
-
-        ""
-
-
-
-},
-
-
-
-
-
-
-
-
-qdrant: {
-
-
-    url:
-
-        process.env.QDRANT_URL ||
-
-        "http://localhost:6333",
-
-
-
-    collection:
-
-        process.env.QDRANT_COLLECTION ||
-
-        "nodebb_knowledge"
-
-
-
-},
-
-
-
-
-
-
-
-
-openai: {
-
-
-    apiKey:
-
-        process.env.OPENAI_API_KEY ||
-
-        "",
-
-
-
-    model:
-
-        process.env.OPENAI_MODEL ||
-
-        "gpt-4.1-mini",
-
-
-
-    embeddingModel:
-
-        process.env.OPENAI_EMBEDDING_MODEL ||
-
-        "text-embedding-3-small"
-
-
-
-},
-
-
-
-
-
-
-
-
-embeddings: {
-
-
-    provider:
-
-        process.env.AI_PROVIDER ||
-
-        "fake",
-
-
-
-    size:
-
-        Number(
-
-            process.env.EMBEDDING_SIZE ||
-
-            1536
-
-        )
-
-
-
-},
-
-
-
-
-
-
-
-
-mcp: {
-
-
-    enabled:
-
-        process.env.MCP_ENABLED !== "false"
-
-
-
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-};
-
-
-
-
-
-
-
-
-
-
-
-
-
-/*
-
-Safe debug output
-
-
-Does not expose API keys
-*/
-
-Config.info = function() {
-
-
-
-
-return {
-
-
-    environment:
-
-        Config.environment,
-
-
-
-    nodebb:
-
-    {
-
-        url:
-
-            Config.nodebb.url
-
-    },
-
-
-
-    qdrant:
-
-    {
-
-        url:
-
-            Config.qdrant.url,
-
-
-        collection:
-
-            Config.qdrant.collection
-
-    },
-
-
-
-    embeddings:
-
-        Config.embeddings,
-
-
-
-    mcp:
-
-        Config.mcp
-
-
-
-};
-
-};
-
-
-
-
-
-
-
-
-
-
-
-
-
-module.exports = Config;
+"use strict";
+
+/**
+ * NodeBB Integration Layer
+ *
+ * Configuration provider
+ *
+ * Settings are stored in the NodeBB database
+ * using meta.settings.
+ */
+
+let meta = null;
+
+try {
+
+    meta = require.main.require("./src/meta");
+
+} catch (err) {
+
+    // Standalone mode (tests, npm, CLI)
+
+}
+
+const DEFAULTS = {
+
+    aiProvider: "fake",
+
+    openaiApiKey: "",
+
+    openaiModel: "text-embedding-3-small",
+
+    qdrantUrl: "http://localhost:6333",
+
+    collection: "nodebb_knowledge",
+
+    mcpEnabled: false,
+
+    mcpPort: 3001
+
+};
+
+async function get() {
+
+    if (!meta) {
+        return { ...DEFAULTS };
+    }
+
+    try {
+
+        return await meta.settings.get(
+            "nodebb-plugin-integration",
+            DEFAULTS
+        );
+
+    } catch (err) {
+
+        console.error(
+            "[Config] unable to load settings:",
+            err.message
+        );
+
+        return { ...DEFAULTS };
+
+    }
+
+}
+
+async function set(values) {
+
+    if (!meta) {
+        return false;
+    }
+
+    try {
+
+        await meta.settings.set(
+            "nodebb-plugin-integration",
+            values
+        );
+
+        return true;
+
+    } catch (err) {
+
+        console.error(
+            "[Config] unable to save settings:",
+            err.message
+        );
+
+        return false;
+
+    }
+
+}
+
+async function info() {
+
+    const cfg = await get();
+
+    return {
+
+        aiProvider: cfg.aiProvider,
+
+        openaiModel: cfg.openaiModel,
+
+        qdrantUrl: cfg.qdrantUrl,
+
+        collection: cfg.collection,
+
+        mcpEnabled: cfg.mcpEnabled,
+
+        mcpPort: cfg.mcpPort,
+
+        openaiApiKey:
+            cfg.openaiApiKey
+                ? "***configured***"
+                : ""
+
+    };
+
+}
+
+module.exports = {
+
+    get,
+
+    set,
+
+    info,
+
+    defaults: DEFAULTS
+
+};

package/src/routes/api.js

@@ -1,240 +1,97 @@
 "use strict";
 
-/*
+/**
+ * NodeBB Integration Layer
+ *
+ * API controllers
+ */
 
-NodeBB Integration Layer
+const Config = require("../config");
+const Search = require("../ai/search");
+const Meta = require("../nodebb/meta");
 
+/**
+ * GET /api/v3/integration/info
+ */
+exports.apiInfo = async function (req, res) {
 
-HTTP API routes
+    try {
 
+        const forum = await Meta.getInfo();
+        const settings = await Config.info();
 
+        res.json({
+            success: true,
+            forum,
+            settings
+        });
 
-*/
-
-
-
-
-const Meta =
-require("../nodebb/meta");
-
-const Search =
-require("../ai/search");
-
-
-
-
-
-
-
-
-
-
-
-
-
-function init(router) {
-
-
-
-
-if(!router) {
-
-
-    return false;
-
-
-}
-
-
-
-
-
-
-
-
-router.get(
-
-    "/api/v3/integration/info",
-
-    async function(
-
-        req,
-
-        res
-
-    ) {
-
-
-
-        try {
-
-
-
-            const info =
-
-                await Meta.getInfo();
-
-
-
-
-
-
-
-            res.json(info);
-
-
-
-        }
-
-
-        catch(error) {
-
-
-
-            res.status(500)
-
-                .json({
-
-                    error:
-
-                        error.message
-
-                });
-
-
-
-        }
-
+    } catch (err) {
 
+        res.status(500).json({
+            success: false,
+            error: err.message
+        });
 
     }
 
-);
-
-
-
-
-
+};
 
+/**
+ * POST /api/v3/integration/search
+ */
+exports.apiSearch = async function (req, res) {
 
+    try {
 
+        const query = req.body?.query || "";
+        const limit = Number(req.body?.limit || 5);
 
-router.post(
+        const result = await Search.searchText(
+            query,
+            limit
+        );
 
-    "/api/v3/integration/search",
-
-    async function(
-
-        req,
-
-        res
-
-    ) {
-
-
-
-        try {
-
-
-
-            const query =
-
-                req.body.query;
-
-
-
-
-
-
-
-            const limit =
-
-                req.body.limit || 5;
-
-
-
-
-
-
-
-            const result =
-
-                await Search.searchText(
-
-                    query,
-
-                    limit
-
-                );
-
-
-
-
-
-
-
-            res.json(result);
-
-
-
-        }
-
-
-        catch(error) {
-
-
-
-            res.status(500)
-
-                .json({
-
-                    error:
-
-                        error.message
-
-                });
-
-
-
-        }
+        res.json({
+            success: true,
+            result
+        });
 
+    } catch (err) {
 
+        res.status(500).json({
+            success: false,
+            error: err.message
+        });
 
     }
 
-);
-
-
-
-
+};
 
+/**
+ * ACP page
+ */
+exports.renderAdmin = async function (req, res) {
 
+    try {
 
+        const settings = await Config.get();
 
-return true;
+        res.render(
+            "admin/plugins/integration",
+            {
+                title: "NodeBB Integration",
 
+                settings
+            }
+        );
 
+    } catch (err) {
 
+        res.status(500).render("500", {
+            error: err.message
+        });
 
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-module.exports = {
-
-init
-
-
-
+    }
 
 };

package/src/routes/index.js

@@ -1,110 +1,49 @@
-"use strict";
-
-/*
-
-NodeBB Integration Layer
-
-
-Routes loader
-
-
-
-*/
-
-
-
-
-const API =
-require("./api");
-
-
-
-
-
-
-
-
-
-
-
-
-
-function init(router) {
-
-
-
-
-if(!router) {
-
-
-    console.log(
-
-        "[Routes] router unavailable"
-
-    );
-
-
-    return false;
-
-
-}
-
-
-
-
-
-
-
-
-API.init(
-
-    router
-
-);
-
-
-
-
-
-
-
-
-console.log(
-
-    "[Routes] initialized"
-
-);
-
-
-
-
-
-
-
-return true;
-
-
-
-
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-module.exports = {
-
-init
-
-
-
-
+"use strict";
+
+/**
+ * NodeBB Integration Layer
+ *
+ * Routes
+ */
+
+const API = require("./api");
+
+exports.init = function (router, middleware) {
+
+    if (!router) {
+        return;
+    }
+
+    /*
+     * REST API
+     */
+
+    router.get(
+        "/api/v3/integration/info",
+        API.apiInfo
+    );
+
+    router.post(
+        "/api/v3/integration/search",
+        API.apiSearch
+    );
+
+    /*
+     * ACP page
+     */
+
+    if (
+        middleware &&
+        middleware.admin &&
+        typeof middleware.admin.buildHeader === "function"
+    ) {
+
+        router.get(
+            "/admin/plugins/integration",
+            middleware.admin.buildHeader,
+            API.renderAdmin
+        );
+
+    }
+
 };

package/templates/admin/plugins/integration.tpl

@@ -0,0 +1,130 @@
+<div class="acp-page-container">
+
+    <h1>
+        <i class="fa fa-robot"></i>
+        {{title}}
+    </h1>
+
+    <hr />
+
+    <form role="form">
+
+        <div class="mb-3">
+
+            <label class="form-label">
+                {{settings.ai-provider}}
+            </label>
+
+            <select
+                class="form-select"
+                name="aiProvider"
+            >
+                <option value="fake">Fake</option>
+                <option value="openai">OpenAI</option>
+            </select>
+
+        </div>
+
+        <div class="mb-3">
+
+            <label class="form-label">
+                OpenAI API Key
+            </label>
+
+            <input
+                type="password"
+                class="form-control"
+                name="openaiApiKey"
+                autocomplete="off"
+            />
+
+        </div>
+
+        <div class="mb-3">
+
+            <label class="form-label">
+                OpenAI Embedding Model
+            </label>
+
+            <input
+                class="form-control"
+                name="openaiModel"
+            />
+
+        </div>
+
+        <div class="mb-3">
+
+            <label class="form-label">
+                Qdrant URL
+            </label>
+
+            <input
+                class="form-control"
+                name="qdrantUrl"
+            />
+
+        </div>
+
+        <div class="mb-3">
+
+            <label class="form-label">
+                Collection
+            </label>
+
+            <input
+                class="form-control"
+                name="collection"
+            />
+
+        </div>
+
+        <div class="form-check mb-3">
+
+            <input
+                id="mcpEnabled"
+                class="form-check-input"
+                type="checkbox"
+                name="mcpEnabled"
+            />
+
+            <label
+                class="form-check-label"
+                for="mcpEnabled"
+            >
+                Enable MCP Server
+            </label>
+
+        </div>
+
+        <div class="mb-3">
+
+            <label class="form-label">
+                MCP Port
+            </label>
+
+            <input
+                class="form-control"
+                name="mcpPort"
+                type="number"
+            />
+
+        </div>
+
+        <hr />
+
+        <button
+            id="save"
+            class="btn btn-primary"
+            type="button"
+        >
+
+            <i class="fa fa-save"></i>
+
+            Save Settings
+
+        </button>
+
+    </form>
+
+</div>