chore: import upstream snapshot with attribution

luaplugin/api_notify.go

@@ -0,0 +1,34 @@
+package luaplugin
+
+import (
+	"os/exec"
+
+	lua "github.com/yuin/gopher-lua"
+)
+
+// registerNotifyAPI adds cliamp.notify(title, body) which sends a desktop
+// notification via notify-send. Safe alternative to os.execute for this
+// specific use case.
+func registerNotifyAPI(L *lua.LState, cliamp *lua.LTable, logger *pluginLogger, pluginName string) {
+	L.SetField(cliamp, "notify", L.NewFunction(func(L *lua.LState) int {
+		title := L.CheckString(1)
+		body := L.OptString(2, "")
+
+		args := []string{title}
+		if body != "" {
+			args = append(args, body)
+		}
+
+		path, err := exec.LookPath("notify-send")
+		if err != nil {
+			logger.log(pluginName, "warn", "notify-send not found: %v", err)
+			return 0
+		}
+
+		cmd := exec.Command(path, args...)
+		if err := cmd.Run(); err != nil {
+			logger.log(pluginName, "error", "notify-send failed: %v", err)
+		}
+		return 0
+	}))
+}