feat(mqtt): add MQTT broker connection support

This commit is contained in:
jinmo authored and GitHub committed 2026-08-04 19:05:05 +08:00
1 parent dff33662fc
commit 8cfe380784
125 files changed
+23056 -107

No files matched your search

+10
View File
@@ -748,3 +748,13 @@ export type {
AgentEvent,
SqlFileEntry,
} from "@/lib/backend/tauri";
// MQTT
export const mqttGetBrokerInfo = forward("mqttGetBrokerInfo");
export const mqttSubscribe = forward("mqttSubscribe");
export const mqttUnsubscribe = forward("mqttUnsubscribe");
export const mqttPublish = forward("mqttPublish");
export const mqttListTopics = forward("mqttListTopics");
export const mqttGetTopicTree = forward("mqttGetTopicTree");
export const mqttGetMessages = forward("mqttGetMessages");
export const mqttClearMessages = forward("mqttClearMessages");
+1
View File
@@ -3358,3 +3358,4 @@ export async function refreshConnections(): Promise<void> {
}
export * from "@/lib/backend/mq-http";
export * from "@/lib/backend/mqtt-http";
+38
View File
@@ -0,0 +1,38 @@
// MQTT HTTP backend stubs (MQTT is not yet supported in web/Docker mode).
// Throw descriptive errors so the user knows this isn't available.
function mqttWebNotAvailable(name: string): never {
throw new Error(`MQTT ${name}: MQTT 功能暂不支持 Web/Docker 模式。请使用桌面版。`);
}
export async function mqttGetBrokerInfo(_connectionId: string) {
mqttWebNotAvailable("mqttGetBrokerInfo");
}
export async function mqttSubscribe(_connectionId: string, _topic: string, _qos?: string | null) {
mqttWebNotAvailable("mqttSubscribe");
}
export async function mqttUnsubscribe(_connectionId: string, _topic: string) {
mqttWebNotAvailable("mqttUnsubscribe");
}
export async function mqttPublish(_connectionId: string, _request: unknown) {
mqttWebNotAvailable("mqttPublish");
}
export async function mqttListTopics(_connectionId: string) {
mqttWebNotAvailable("mqttListTopics");
}
export async function mqttGetTopicTree(_connectionId: string) {
mqttWebNotAvailable("mqttGetTopicTree");
}
export async function mqttGetMessages(_connectionId: string, _topicFilter?: string | null, _limit?: number | null) {
mqttWebNotAvailable("mqttGetMessages");
}
export async function mqttClearMessages(_connectionId: string) {
mqttWebNotAvailable("mqttClearMessages");
}
@@ -0,0 +1,33 @@
import { invoke } from "@tauri-apps/api/core";
export async function mqttGetBrokerInfo(connectionId: string) {
return invoke("mqtt_get_broker_info", { connectionId });
}
export async function mqttSubscribe(connectionId: string, topic: string, qos?: string | null) {
return invoke("mqtt_subscribe", { connectionId, topic, qos: qos ?? null });
}
export async function mqttUnsubscribe(connectionId: string, topic: string) {
return invoke("mqtt_unsubscribe", { connectionId, topic });
}
export async function mqttPublish(connectionId: string, request: { topic: string; payloadBase64: string; payloadText?: string | null; qos: string; retain: boolean }) {
return invoke("mqtt_publish", { connectionId, request });
}
export async function mqttListTopics(connectionId: string) {
return invoke("mqtt_list_topics", { connectionId });
}
export async function mqttGetTopicTree(connectionId: string) {
return invoke("mqtt_get_topic_tree", { connectionId });
}
export async function mqttGetMessages(connectionId: string, topicFilter?: string | null, limit?: number | null) {
return invoke("mqtt_get_messages", { connectionId, topicFilter: topicFilter ?? null, limit: limit ?? null });
}
export async function mqttClearMessages(connectionId: string) {
return invoke("mqtt_clear_messages", { connectionId });
}
+1
View File
@@ -3864,4 +3864,5 @@ export async function exportQueryResultMarkdown(filePath: string, columns: strin
}
export * from "@/lib/backend/mq-tauri";
export * from "@/lib/backend/mqtt-tauri";
export * from "@/lib/backend/nacos-tauri";
@@ -84,6 +84,7 @@ export const DATABASE_NAMESPACE_CREATION_MATRIX = {
jdbc: { deferred: "generic JDBC does not expose a reliable dialect-specific create target" },
mq: { deferred: "message queue namespaces are handled by MQ admin panels" },
nacos: { deferred: "Nacos namespace creation already uses the Nacos admin flow" },
mqtt: { deferred: "MQTT topics are managed via the MQTT console" },
} satisfies Record<DatabaseType, DatabaseNamespaceCreationMatrixEntry>;
export function connectionNamespaceCreationTarget(connection: CreationConnection): ConnectionCreationTarget | null {
@@ -84,6 +84,7 @@ export const DATABASE_PROPERTY_EDITING_MATRIX = {
jdbc: { deferred: "generic JDBC does not expose reliable dialect-specific properties" },
mq: { deferred: "message queue namespaces are handled by MQ admin panels" },
nacos: { deferred: "Nacos namespace editing already uses the Nacos admin flow" },
mqtt: { deferred: "MQTT topics are managed via the MQTT console" },
} satisfies Record<DatabaseType, DatabasePropertyEditingEntry>;
function entryFor(connection: PropertyEditConnection): DatabasePropertyEditingEntry | null {
@@ -0,0 +1,180 @@
/**
* MQTT Payload 编解码工具
* 支持 Plaintext / JSON / Base64 / Hex / CBOR / MsgPack 六种格式
*/
import { decode as cborDecode, encode as cborEncode } from "cbor-x";
import { decode as msgpackDecode, encode as msgpackEncode } from "@msgpack/msgpack";
/** 支持的编码格式 */
export type PayloadEncoding = "plaintext" | "json" | "base64" | "hex" | "cbor" | "msgpack";
export const PAYLOAD_ENCODING_LABELS: Record<PayloadEncoding, string> = {
plaintext: "Plaintext",
json: "JSON",
base64: "Base64",
hex: "Hex",
cbor: "CBOR",
msgpack: "MsgPack",
};
export const PAYLOAD_ENCODINGS: PayloadEncoding[] = ["plaintext", "json", "base64", "hex", "cbor", "msgpack"];
/**
* 将 base64 编码的 payload 按指定格式解码为可展示的字符串
*/
export function decodePayload(base64: string, encoding: PayloadEncoding): string {
if (!base64) return "";
try {
const bytes = base64ToBytes(base64);
switch (encoding) {
case "plaintext":
return bytesToUtf8(bytes);
case "json": {
const text = bytesToUtf8(bytes);
const parsed = JSON.parse(text);
return JSON.stringify(parsed, null, 2);
}
case "base64":
return base64;
case "hex":
return bytesToHex(bytes);
case "cbor": {
const decoded = cborDecode(bytes);
return formatDecodedValue(decoded);
}
case "msgpack": {
const decoded = msgpackDecode(bytes);
return formatDecodedValue(decoded);
}
default:
return bytesToUtf8(bytes);
}
} catch {
/* 解码失败时回退为纯文本显示 */
try {
return bytesToUtf8(base64ToBytes(base64));
} catch {
return `[解码失败] ${base64}`;
}
}
}
/**
* 将用户输入的文本按指定格式编码为 base64(用于发布消息)
*/
export function encodePayload(input: string, encoding: PayloadEncoding): string {
if (!input) return "";
try {
switch (encoding) {
case "plaintext":
return bytesToBase64(utf8ToBytes(input));
case "json": {
/* 确保输入是合法 JSON 后再编码 */
const parsed = JSON.parse(input);
return bytesToBase64(utf8ToBytes(JSON.stringify(parsed)));
}
case "base64":
/* 浏览器 atob 接受缺失 padding 和空白;规范化后再交给 Rust 严格解码 */
return bytesToBase64(base64ToBytes(input));
case "hex": {
const cleaned = input.replace(/\s/g, "");
if (!/^([0-9A-Fa-f]{2})*$/.test(cleaned)) {
throw new Error("无效的十六进制字符串");
}
const bytes = hexToBytes(cleaned);
return bytesToBase64(bytes);
}
case "cbor": {
/* 将 JSON 文本编码为 CBOR */
const parsed = JSON.parse(input);
const cborBytes = cborEncode(parsed);
return bytesToBase64(cborBytes);
}
case "msgpack": {
/* 将 JSON 文本编码为 MsgPack */
const parsed = JSON.parse(input);
const msgpackBytes = msgpackEncode(parsed);
return bytesToBase64(msgpackBytes);
}
default:
return bytesToBase64(utf8ToBytes(input));
}
} catch (e) {
throw new Error(`编码失败 (${PAYLOAD_ENCODING_LABELS[encoding]}): ${String(e)}`);
}
}
/* ========== 基础转换工具 ========== */
function base64ToBytes(base64: string): Uint8Array {
const binary = atob(base64);
const bytes = new Uint8Array(binary.length);
for (let i = 0; i < binary.length; i++) {
bytes[i] = binary.charCodeAt(i);
}
return bytes;
}
function bytesToBase64(bytes: Uint8Array): string {
let binary = "";
for (let i = 0; i < bytes.length; i++) {
binary += String.fromCharCode(bytes[i]);
}
return btoa(binary);
}
function utf8ToBytes(text: string): Uint8Array {
return new TextEncoder().encode(text);
}
function bytesToUtf8(bytes: Uint8Array): string {
return new TextDecoder("utf-8", { fatal: false }).decode(bytes);
}
function bytesToHex(bytes: Uint8Array): string {
return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join(" ");
}
function hexToBytes(hex: string): Uint8Array {
const bytes = new Uint8Array(hex.length / 2);
for (let i = 0; i < hex.length; i += 2) {
bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);
}
return bytes;
}
function formatDecodedValue(value: unknown): string {
if (value === null || value === undefined) return String(value);
if (typeof value === "string") return value;
if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
return String(value);
}
/* Buffer / Uint8Array 等二进制类型 */
if (value instanceof Uint8Array || (ArrayBuffer.isView(value) && (value as ArrayBufferView).byteLength !== undefined)) {
return `[二进制数据, ${(value as Uint8Array).byteLength ?? (value as Uint8Array).length} bytes]`;
}
if (value instanceof ArrayBuffer) {
return `[二进制数据, ${value.byteLength} bytes]`;
}
/* 对象/数组 → JSON 格式化 */
try {
return JSON.stringify(value, null, 2);
} catch {
return String(value);
}
}
@@ -29,6 +29,7 @@ export function getTreeNodeIconInfo(node: TreeNode): TreeNodeIconInfo | null {
return { icon: FolderOpen, colorClass: "text-emerald-500" };
case "nacos-namespace":
case "etcd-root":
case "mqtt-topic":
return { icon: FolderOpen, colorClass: "text-sky-500" };
case "etcd-dashboard":
return { icon: Gauge, colorClass: "text-sky-500" };