nextcloud-spreed-signaling/nats/client.go
2026-01-12 13:16:21 +01:00

136 lines
3.8 KiB
Go

/**
* Standalone signaling server for the Nextcloud Spreed app.
* Copyright (C) 2025 struktur AG
*
* @author Joachim Bauch <bauch@struktur.de>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package nats
import (
"context"
"encoding/base64"
"encoding/json"
"errors"
"os"
"os/signal"
"strings"
"time"
"github.com/nats-io/nats.go"
"github.com/strukturag/nextcloud-spreed-signaling/async"
"github.com/strukturag/nextcloud-spreed-signaling/log"
)
const (
initialConnectInterval = time.Second
maxConnectInterval = 8 * time.Second
LoopbackUrl = "nats://loopback"
DefaultURL = nats.DefaultURL
)
var (
ErrConnectionClosed = nats.ErrConnectionClosed
)
type Msg = nats.Msg
type Subscription interface {
Unsubscribe() error
}
type Client interface {
Close(ctx context.Context) error
Subscribe(subject string, ch chan *Msg) (Subscription, error)
Publish(subject string, message any) error
}
// The NATS client doesn't work if a subject contains spaces. As the room id
// can have an arbitrary format, we need to make sure the subject is valid.
// See "https://github.com/nats-io/nats.js/issues/158" for a similar report.
func GetEncodedSubject(prefix string, suffix string) string {
return prefix + "." + base64.StdEncoding.EncodeToString([]byte(suffix))
}
func NewClient(ctx context.Context, url string, options ...nats.Option) (Client, error) {
logger := log.LoggerFromContext(ctx)
if url == ":loopback:" {
logger.Printf("WARNING: events url %s is deprecated, please use %s instead", url, LoopbackUrl)
url = LoopbackUrl
}
if url == LoopbackUrl {
logger.Println("Using internal NATS loopback client")
return NewLoopbackClient(logger)
}
backoff, err := async.NewExponentialBackoff(initialConnectInterval, maxConnectInterval)
if err != nil {
return nil, err
}
client := &NativeClient{
logger: logger,
closed: make(chan struct{}),
}
options = append([]nats.Option{
nats.ClosedHandler(client.onClosed),
nats.DisconnectHandler(client.onDisconnected),
nats.ReconnectHandler(client.onReconnected),
nats.MaxReconnects(-1),
}, options...)
client.conn, err = nats.Connect(url, options...)
ctx, stop := signal.NotifyContext(ctx, os.Interrupt)
defer stop()
// The initial connect must succeed, so we retry in the case of an error.
for err != nil {
logger.Printf("Could not create connection (%s), will retry in %s", err, backoff.NextWait())
backoff.Wait(ctx)
if ctx.Err() != nil {
return nil, errors.New("interrupted")
}
client.conn, err = nats.Connect(url)
}
logger.Printf("Connection established to %s (%s)", removeURLCredentials(client.conn.ConnectedUrl()), client.conn.ConnectedServerId())
return client, nil
}
func Decode(msg *nats.Msg, vPtr any) (err error) {
switch arg := vPtr.(type) {
case *string:
// If they want a string and it is a JSON string, strip quotes
// This allows someone to send a struct but receive as a plain string
// This cast should be efficient for Go 1.3 and beyond.
str := string(msg.Data)
if strings.HasPrefix(str, `"`) && strings.HasSuffix(str, `"`) {
*arg = str[1 : len(str)-1]
} else {
*arg = str
}
case *[]byte:
*arg = msg.Data
default:
err = json.Unmarshal(msg.Data, arg)
}
return
}