cj-tauri 0.8.0 → 1.1.0

package/src/plugins/notification/plugin_notification.cj

@@ -0,0 +1,146 @@
+package cjTauri.plugins.notification
+
+import cjTauri.*
+
+import std.collection.*
+import stdx.encoding.json.*
+
+/**
+ * 官方插件 notification：系统通知（对标 Tauri 的 notification 插件，RFC-003 第 3 期）
+ *
+ * 命令：notification:notify
+ * 权限：**不自动放行**，应用要在 capabilities 里显式声明：
+ *   "commands": ["notification:notify"]
+ *   "permissions": ["notification:default"]
+ * 前端：window.__CJ_TAURI__.notification.notify({ title, body })
+ *
+ * 实现落 C 桥 `cj_bridge_notification_notify`：Linux 走 freedesktop Notifications
+ * （会话总线）；**Windows 桩阶段返回 -4 未实现**——命令如实报失败，`system:host` 的能力位
+ * 同口径不置 CJ_CAP_NOTIFICATION，不假装成功（AGENTS §1 的如实交付口径）。
+ *
+ * 「发后即忘」：提交即返回，通知显示与否不回传（freedesktop 协议本就没有同步回执）。
+ */
+public class NotificationPlugin <: Plugin {
+    private let handler: NotificationCommands = NotificationCommands()
+
+    public init() {}
+
+    public func name(): String {
+        return "notification"
+    }
+
+    public func commands(): HashMap<String, CommandHandler> {
+        let m = HashMap<String, CommandHandler>()
+        m.add("notify", this.handler)
+        return m
+    }
+
+    /**
+     * 命名权限集（v1.1）：只有一条命令，default 与明文等价——保留集名是为了
+     * 应用清单写法统一（全部走 permissions 数组）。
+     */
+    public func permissions(): HashMap<String, ArrayList<String>> {
+        let m = HashMap<String, ArrayList<String>>()
+        let all = ArrayList<String>()
+        all.add("notify")
+        m.add("default", all)
+        return m
+    }
+
+    /**
+     * 前端 shim：往桥对象上挂一个 notification 命名空间（与 dialog 同款）
+     */
+    public func jsShim(): String {
+        return "(function () { var t = window.__CJ_TAURI__ || (window.__CJ_TAURI__ = {});" +
+            " t.notification = {" +
+            " notify: function (o) { return window.__CJ_TAURI__.invoke('notification:notify', o || {}); }" +
+            " }; })();\n"
+    }
+
+    public func setup(app: TauriApp): Unit {
+        // 多窗口按报文里的 label 解析宿主（与 dialog 插件同一口径）：固定 `app.webviewHost()`
+        // 会让第二扇窗的通知全部落到默认窗那一个宿主上（2026-10-20 dialog 实机取证同款）。
+        this.handler.attachHostResolver({ label => app.hostOf(label) })
+    }
+}
+
+/**
+ * 通知命令处理器：notify 收 { title, body? }。body 省略 / null 都合法。
+ */
+public class NotificationCommands <: CommandHandler {
+    private var host: Option<WebViewHost> = None
+
+    /* 按 label 解析宿主（多窗口的正路）：单槽 `host` 只记着装配时那一个宿主，
+       多窗口下用它就是「所有窗的通知都发给默认窗那一个宿主」。 */
+    private var hostByWindow: Option<(String) -> Option<WebViewHost>> = None
+
+    public init() {}
+
+    /** 由 NotificationPlugin.setup() 调用（单窗口 / 单测用；这个槽不带窗口身份） */
+    public func attachHost(h: WebViewHost): Unit {
+        this.host = Some(h)
+    }
+
+    /** 装配「label → 宿主」解析器；由 NotificationPlugin.setup() 传入 `app.hostOf` */
+    public func attachHostResolver(resolve: (String) -> Option<WebViewHost>): Unit {
+        this.hostByWindow = Some(resolve)
+    }
+
+    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        match (cmd) {
+            case "notification:notify" =>
+                let title = this.requireString(args, "title")
+                let body = this.optionalString(args, "body")
+                if (this.requireHost(ipc).notify(title, body)) {
+                    return JsonNull()
+                }
+                throw CommandException(
+                    "notification: 发送失败（宿主未就绪 / 本平台未实现 / 桌面环境不可用）")
+            case _ => throw CommandException("unknown notification command: ${cmd}")
+        }
+    }
+
+    /**
+     * 取**发起这条命令的窗口**的宿主
+     *
+     * 多窗口下必须按 `ipc.window` 解析：用装配时那一个宿主，第二扇窗的通知会落到默认窗的宿主上。
+     * 解析器在场而窗口没登记时**如实报错**，不回落到单槽（与 dialog 插件同一口径）。
+     */
+    private func requireHost(ipc: IpcContext): WebViewHost {
+        match (this.hostByWindow) {
+            case Some(resolve) => match (resolve(ipc.window)) {
+                case Some(h) => return h
+                case None => throw CommandException(
+                    "notification: 窗口 \"${ipc.window}\" 没有登记宿主（addWindow(); 默认窗在 run() 之前也可用）")
+            }
+            case None => ()
+        }
+        match (this.host) {
+            case Some(h) => h
+            case None => throw CommandException(
+                "notification: 宿主未装配（用 .plugin(NotificationPlugin()) 装配插件后才可用）")
+        }
+    }
+
+    private func requireString(args: JsonObject, key: String): String {
+        match (args.get(key)) {
+            case Some(v) => match (v.kind()) {
+                case JsonKind.JsString => return v.asString().getValue()
+                case _ => throw CommandException("notification: argument \"${key}\" must be a string")
+            }
+            case None => throw CommandException("notification: missing argument \"${key}\"")
+        }
+    }
+
+    /** 可选字符串参数：缺失 / null 都按空串（body 可省） */
+    private func optionalString(args: JsonObject, key: String): String {
+        match (args.get(key)) {
+            case Some(v) => match (v.kind()) {
+                case JsonKind.JsString => return v.asString().getValue()
+                case JsonKind.JsNull => return ""
+                case _ => throw CommandException("notification: argument \"${key}\" must be a string")
+            }
+            case None => return ""
+        }
+    }
+}

package/src/plugins/plugins.cj

@@ -0,0 +1,5 @@
+package cjTauri.plugins
+
+// 扫描锚点：cjpm 只在目录里有 .cj 文件时才递归扫描子目录——本文件为空占位，
+// 保证 src/plugins/<名字>/ 的各插件子包（package cjTauri.plugins.<名字>）能被编进产物。
+// 插件实现一律放各自的子包目录，别往这里平铺（check-static 第 6b-2 项盯着）。