Add Nextcloud recipe display and controller

node_helper.js

@@ -0,0 +1,144 @@
+const fs = require("node:fs/promises");
+const path = require("node:path");
+const express = require("express");
+const NodeHelper = require("node_helper");
+const QRCode = require("qrcode");
+const NextcloudPublicShare = require("./lib/nextcloud-public-share");
+
+module.exports = NodeHelper.create({
+  start() {
+    this.config = { controlPath: "/MMM-NextcloudCookbook/control" };
+    this.state = { active: false, recipeId: null, recipe: null, error: null };
+    this.recipeCache = { expires: 0, recipes: [] };
+    this.stateFile = path.join(process.cwd(), "config", "MMM-NextcloudCookbook-state.json");
+    this.client = null;
+    this.registerRoutes();
+    this.stateReady = this.loadState().catch((error) => this.setError(error));
+  },
+
+  socketNotificationReceived(notification, payload) {
+    if (notification !== "CONFIG") return;
+    this.config = { ...this.config, ...payload };
+    this.client = new NextcloudPublicShare({
+      shareUrl: process.env.SECRET_NEXTCLOUD_COOKBOOK_SHARE_URL,
+      password: process.env.SECRET_NEXTCLOUD_COOKBOOK_SHARE_PASSWORD || ""
+    });
+    this.stateReady.then(async () => {
+      this.sendSocketNotification("STATE", this.publicState());
+      await this.restoreRecipe();
+    }).catch((error) => this.setError(error));
+  },
+
+  registerRoutes() {
+    this.expressApp.use("/MMM-NextcloudCookbook/api", express.json({ limit: "16kb" }));
+    this.expressApp.get("/MMM-NextcloudCookbook/control", (_request, response) => {
+      response.sendFile(path.join(__dirname, "control", "index.html"));
+    });
+    this.expressApp.use(
+      "/MMM-NextcloudCookbook/assets",
+      express.static(path.join(__dirname, "control"))
+    );
+    this.expressApp.get("/MMM-NextcloudCookbook/qr.svg", async (request, response, next) => {
+      try {
+        const url = `${request.protocol}://${request.get("host")}${this.config.controlPath}`;
+        response.type("image/svg+xml").send(await QRCode.toString(url, { type: "svg", margin: 1 }));
+      } catch (error) {
+        next(error);
+      }
+    });
+    this.expressApp.get("/MMM-NextcloudCookbook/api/state", (_request, response) => {
+      response.json(this.publicState());
+    });
+    this.expressApp.get("/MMM-NextcloudCookbook/api/recipes", async (_request, response, next) => {
+      try {
+        response.json(await this.listRecipes());
+      } catch (error) {
+        next(error);
+      }
+    });
+    this.expressApp.post("/MMM-NextcloudCookbook/api/activate", async (request, response, next) => {
+      try {
+        const recipeId = request.body?.recipeId;
+        if (typeof recipeId !== "string" || !recipeId) {
+          return response.status(400).json({ error: "recipeId is required" });
+        }
+        const recipe = await this.getClient().getRecipe(recipeId);
+        this.state = { active: true, recipeId, recipe, error: null };
+        await this.saveState();
+        this.sendSocketNotification("STATE", this.publicState());
+        return response.json(this.publicState());
+      } catch (error) {
+        return next(error);
+      }
+    });
+    this.expressApp.post("/MMM-NextcloudCookbook/api/exit", async (_request, response, next) => {
+      try {
+        this.state = { active: false, recipeId: null, recipe: null, error: null };
+        await this.saveState();
+        this.sendSocketNotification("STATE", this.publicState());
+        response.json(this.publicState());
+      } catch (error) {
+        next(error);
+      }
+    });
+    this.expressApp.use("/MMM-NextcloudCookbook/api", (error, _request, response, _next) => {
+      console.error(`[MMM-NextcloudCookbook] ${error.message}`);
+      response.status(error.status || 500).json({ error: error.message || "Recipe request failed" });
+    });
+  },
+
+  getClient() {
+    if (!this.client) throw new Error("Nextcloud Cookbook is not configured yet");
+    return this.client;
+  },
+
+  async listRecipes() {
+    if (Date.now() < this.recipeCache.expires) return this.recipeCache.recipes;
+    const recipes = await this.getClient().listRecipes();
+    this.recipeCache = { expires: Date.now() + 5 * 60 * 1000, recipes };
+    return recipes;
+  },
+
+  async loadState() {
+    try {
+      const persisted = JSON.parse(await fs.readFile(this.stateFile, "utf8"));
+      if (!persisted.active || !persisted.recipeId) return;
+      this.state = { active: true, recipeId: persisted.recipeId, recipe: null, error: null };
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+  },
+
+  async restoreRecipe() {
+    if (!this.state.active || !this.state.recipeId) return;
+    try {
+      this.state.recipe = await this.getClient().getRecipe(this.state.recipeId);
+      this.state.error = null;
+    } catch (error) {
+      this.setError(error);
+    }
+    this.sendSocketNotification("STATE", this.publicState());
+  },
+
+  async saveState() {
+    const temporary = `${this.stateFile}.tmp`;
+    await fs.writeFile(temporary, `${JSON.stringify({ active: this.state.active, recipeId: this.state.recipeId })}\n`, {
+      mode: 0o600
+    });
+    await fs.rename(temporary, this.stateFile);
+  },
+
+  setError(error) {
+    this.state.error = error instanceof Error ? error.message : String(error);
+    this.sendSocketNotification("STATE", this.publicState());
+  },
+
+  publicState() {
+    return {
+      active: this.state.active,
+      recipeId: this.state.recipeId,
+      recipe: this.state.recipe,
+      error: this.state.error
+    };
+  }
+});