feat: 实现 Go 与 JS/TS SDK 连接收发与其余接口

sdk/go/transport.go

@@ -0,0 +1,40 @@
+package nixmsg
+
+import (
+	"context"
+	"time"
+)
+
+// transport 抽象 MQTT 应用层通道，便于单测注入假实现。
+type transport interface {
+	// Start 开始连接循环（含重连）。凭据在每次 CONNECT 时读取。
+	Start(ctx context.Context, cfg transportConfig) error
+	// PublishUp 向 up 主题发布一帧。
+	PublishUp(payload []byte) error
+	// Stop 停止并断开，不再重连。
+	Stop(ctx context.Context) error
+	// Credential 当前用于 CONNECT 的密码字段（密码或令牌）。
+	SetCredential(passwordOrToken string)
+}
+
+type transportConfig struct {
+	URL            string // ws(s):// 或 mqtt(s)://
+	EndpointID     string
+	ConnectTimeout time.Duration
+	AllowTCP       bool
+	Backoff        *reconnectBackoff
+	OnDown         func(payload []byte)
+	OnOnline       func() // MQTT 已连上且可发（订阅完成前也会调；hello 由上层做）
+	OnOffline      func()
+	OnAuthFailed   func(reason AuthReason)
+	OnKicked       func()
+	// OnConnectPacket 每次 CONNECT 构建后回调（单测核对 Clean Start）。
+	OnConnectPacket func(cleanStart bool, sessionExpiry uint32)
+	// MQTTConnected 在 CONNACK 成功、订阅 down 完成后调用，上层在此发 hello。
+	MQTTReady func(ctx context.Context) error
+}
+
+// buildCleanConnect 供真实与假传输共用：每次连接 Clean Start=true，会话过期=0。
+func buildCleanConnectFlags() (cleanStart bool, sessionExpiry uint32) {
+	return true, 0
+}