WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

internal/im/feishu/factory.go

@@ -0,0 +1,69 @@
+package feishu
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/Tencent/WeKnora/internal/im"
+	"github.com/Tencent/WeKnora/internal/logger"
+)
+
+// NewFactory returns an im.AdapterFactory for channels on the given region's
+// cloud — RegionFeishu for 飞书, RegionLark for Lark. Both use the same
+// credentials and modes; only the API host and tenant differ.
+//
+// The HTTP adapter is always created (needed for SendReply in both modes);
+// "websocket" mode additionally runs a long-connection event stream.
+func NewFactory(region Region) im.AdapterFactory {
+	return func(factoryCtx context.Context, channel *im.IMChannel, msgHandler func(context.Context, *im.IncomingMessage) error) (im.Adapter, context.CancelFunc, error) {
+		creds, err := im.ParseCredentials(channel.Credentials)
+		if err != nil {
+			return nil, nil, fmt.Errorf("parse %s credentials: %w", region.Platform, err)
+		}
+
+		appID := im.GetString(creds, "app_id")
+		appSecret := im.GetString(creds, "app_secret")
+		verificationToken := im.GetString(creds, "verification_token")
+		encryptKey := im.GetString(creds, "encrypt_key")
+		apiBaseURL := im.GetString(creds, "api_base_url")
+
+		// Always create the HTTP adapter (needed for SendReply in both modes).
+		// apiBaseURL is validated here; an invalid value fails the channel.
+		adapter, err := NewAdapter(region, appID, appSecret, verificationToken, encryptKey, apiBaseURL)
+		if err != nil {
+			return nil, nil, fmt.Errorf("create %s adapter: %w", region.Platform, err)
+		}
+
+		mode := im.ResolveMode(channel, "websocket")
+
+		switch mode {
+		case "webhook":
+			return adapter, nil, nil
+
+		case "websocket":
+			client := NewLongConnClient(region, appID, appSecret, apiBaseURL, msgHandler)
+
+			wsCtx, wsCancel := context.WithCancel(context.Background())
+			go func() {
+				if err := client.Start(wsCtx); err != nil && wsCtx.Err() == nil {
+					logger.Errorf(context.Background(), "[IM] %s long connection stopped for channel %s: %v",
+						region.Label, channel.ID, err)
+				}
+			}()
+
+			// stop tears down the connection for real. wsCancel alone is a
+			// no-op: the Feishu SDK's Start blocks on select{} and never
+			// observes ctx, so we must call Close() to actually close the
+			// socket and disable auto-reconnect. wsCancel is kept as a
+			// belt-and-braces fallback for the start goroutine.
+			stop := func() {
+				client.Close()
+				wsCancel()
+			}
+			return adapter, stop, nil
+
+		default:
+			return nil, nil, fmt.Errorf("unknown %s mode: %s", region.Platform, mode)
+		}
+	}
+}