npm - nodebb-plugin-integration - Versions diffs - 0.3.0 → 0.4.1 - Mend

nodebb-plugin-integration 0.3.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/library.js CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "nodebb-plugin-integration",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "AI integration layer for NodeBB forums with MCP, semantic search, RAG and Qdrant knowledge pipeline",
   "main": "library.js",
   "license": "MIT",

package/plugin.json CHANGED Viewed

@@ -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/src/config/index.js CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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
+        );
+    }
 };