Files
Bose-SoundTouch/pkg/service/setup/telnet_migration_test.go
T
Tobias GesellchenandClaude Opus 4.7 fb47807f70 feat(telnet): add port-17000 migration method and account pairing
Adds an SSH-free third migration path that drives the SoundTouch device's
diagnostic shell on TCP port 17000, plus a hardened replacement for the
fragile /setMargeAccount HTTP pairing call.

* `pkg/telnet` — new reusable, dependency-free client (sibling of `pkg/ssh`)
  with deadline-driven Dial / Probe / SendCommand / Close. Mock-server tests
  cover happy path, command-not-found, mid-stream close, and the wedged-device
  read-timeout scenario.

* `setup.MigrationMethodTelnet` — runs `sys configuration` for all four URLs
  plus the parallel `envswitch boseurls set` persistence layer that otherwise
  wins on reboot, then verifies with `getpdo CurrentSystemConfiguration`.
  Aborts on the first non-OK response so configuration is never half-written.
  No SSH backup or rw pre-flight (the path is SSH-free by design).

* `setup.PairAccount` — probes :8090/supportedURLs first, time-bounds
  POST /setMargeAccount aggressively (5s connect / 12s total) to avoid the
  hangs reported in #236, and falls back to `envswitch accountid set <id>`
  over telnet when the HTTP endpoint is missing or wedged. Returns a
  PairAccountResult breadcrumb so the UI can show which path actually
  succeeded.

* `setup.Reboot(deviceIP, method)` — gains a RebootMethod selector;
  RebootMethodSSH stays the default (preserving prior behavior),
  RebootMethodTelnet sends `sys reboot` over a fresh telnet session and
  treats the inevitable socket-close as success.

* New endpoints on `/setup`:
  - GET  /account-id-suggestions/{deviceId} — returns the device's current
    margeAccountUUID (from :8090/info) plus known account IDs from the
    datastore, so the UI can offer reuse.
  - POST /pair-account/{deviceId}?account_id=NNNNNNN — invokes PairAccount;
    the existing reboot endpoint reads ?method=ssh|telnet from the query
    string.

* Helpers `IsValidAccountID` (exactly 7 digits) and `GenerateAccountID`
  (crypto/rand, retries on collision against a known-IDs list).

Documentation in docs/analysis/TELNET-MIGRATION-METHOD.md is updated to match
the implementation: bare-URL convention for `soundtouch-service`, no automatic
`sys reboot` (user-initiated via the existing button with a method selector),
and the realised package layout. The /etc/hosts method is intentionally not
exposed in the new flow.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 12:43:36 +02:00

198 lines
5.9 KiB
Go

package setup
import (
"errors"
"strings"
"testing"
)
// fakeTelnet is a deterministic TelnetClient for unit tests. The responses
// map keys on the exact command string; the value is what SendCommand
// returns. Commands not in the map return "Command not found\n".
type fakeTelnet struct {
dialErr error
banner string
responses map[string]string
// fail returns this error from SendCommand for the named command.
fail map[string]error
// commands records every command actually sent, in order, so tests can
// assert on sequencing.
commands []string
}
func (f *fakeTelnet) Dial() error { return f.dialErr }
func (f *fakeTelnet) Probe() (string, error) { return f.banner, nil }
func (f *fakeTelnet) Close() error { return nil }
func (f *fakeTelnet) SendCommand(cmd string) (string, error) {
f.commands = append(f.commands, cmd)
if err, ok := f.fail[cmd]; ok {
return "", err
}
if resp, ok := f.responses[cmd]; ok {
return resp, nil
}
return "Command not found\n", nil
}
func newFakeTelnetManager(f *fakeTelnet) *Manager {
m := &Manager{
ServerURL: "http://example:8000",
NewTelnet: func(host string) TelnetClient { return f },
}
return m
}
func happyResponses(targetURL string) map[string]string {
return map[string]string{
"sys configuration bmxRegistryUrl " + targetURL + "/bmx/registry/v1/services": "OK\n",
"sys configuration statsServerUrl " + targetURL: "OK\n",
"sys configuration margeServerUrl " + targetURL: "OK\n",
"sys configuration swUpdateUrl " + targetURL + "/updates/soundtouch": "OK\n",
"envswitch boseurls set " + targetURL + " " + targetURL + "/updates/soundtouch": "OK\n",
"getpdo CurrentSystemConfiguration": "margeServerUrl=" + targetURL + "\nbmxRegistryUrl=" + targetURL + "/bmx/registry/v1/services\n",
}
}
func TestMigrateViaTelnet_HappyPath(t *testing.T) {
target := "http://example:8000"
f := &fakeTelnet{
banner: "BoseShell\n-> ",
responses: happyResponses(target),
}
m := newFakeTelnetManager(f)
logs, err := m.migrateViaTelnet("192.0.2.1", target)
if err != nil {
t.Fatalf("migrateViaTelnet: %v", err)
}
wantOrder := []string{
"sys configuration bmxRegistryUrl " + target + "/bmx/registry/v1/services",
"sys configuration statsServerUrl " + target,
"sys configuration margeServerUrl " + target,
"sys configuration swUpdateUrl " + target + "/updates/soundtouch",
"envswitch boseurls set " + target + " " + target + "/updates/soundtouch",
"getpdo CurrentSystemConfiguration",
}
if len(f.commands) != len(wantOrder) {
t.Fatalf("sent %d commands, want %d:\n%v", len(f.commands), len(wantOrder), f.commands)
}
for i, want := range wantOrder {
if f.commands[i] != want {
t.Errorf("command[%d] = %q, want %q", i, f.commands[i], want)
}
}
if !strings.Contains(logs, "succeeded") {
t.Errorf("logs missing success marker:\n%s", logs)
}
if !strings.Contains(logs, "BoseShell") {
t.Errorf("logs missing banner echo:\n%s", logs)
}
}
func TestMigrateViaTelnet_DialFailureReturnsError(t *testing.T) {
f := &fakeTelnet{dialErr: errors.New("connection refused")}
m := newFakeTelnetManager(f)
_, err := m.migrateViaTelnet("192.0.2.1", "http://example:8000")
if err == nil {
t.Fatal("expected dial error, got nil")
}
if !strings.Contains(err.Error(), "connection refused") {
t.Errorf("err = %v, want to wrap connection refused", err)
}
if len(f.commands) != 0 {
t.Errorf("expected no commands sent on dial failure, got %v", f.commands)
}
}
func TestMigrateViaTelnet_CommandNotFoundAborts(t *testing.T) {
target := "http://example:8000"
resp := happyResponses(target)
// The ST20-Portable case: `envswitch` is not implemented.
delete(resp, "envswitch boseurls set "+target+" "+target+"/updates/soundtouch")
f := &fakeTelnet{responses: resp}
m := newFakeTelnetManager(f)
_, err := m.migrateViaTelnet("192.0.2.1", target)
if err == nil {
t.Fatal("expected error when envswitch is rejected, got nil")
}
if !strings.Contains(err.Error(), "envswitch") {
t.Errorf("err = %v, want to mention the rejected command", err)
}
// The verification command must NOT have been sent — the run aborts on
// the first rejection.
for _, c := range f.commands {
if c == "getpdo CurrentSystemConfiguration" {
t.Errorf("verification was sent after a rejected command: %v", f.commands)
}
}
}
func TestMigrateViaTelnet_VerifyMismatchFails(t *testing.T) {
target := "http://example:8000"
resp := happyResponses(target)
// Device echoes the OLD URLs (envswitch/sys configuration silently dropped).
resp["getpdo CurrentSystemConfiguration"] = "margeServerUrl=https://streaming.bose.com\n"
f := &fakeTelnet{responses: resp}
m := newFakeTelnetManager(f)
_, err := m.migrateViaTelnet("192.0.2.1", target)
if err == nil {
t.Fatal("expected verification mismatch error, got nil")
}
if !strings.Contains(err.Error(), "verification failed") {
t.Errorf("err = %v, want to mention verification failure", err)
}
}
func TestMigrateViaTelnet_TransportErrorAborts(t *testing.T) {
target := "http://example:8000"
f := &fakeTelnet{
responses: happyResponses(target),
fail: map[string]error{
"sys configuration margeServerUrl " + target: errors.New("write: broken pipe"),
},
}
m := newFakeTelnetManager(f)
_, err := m.migrateViaTelnet("192.0.2.1", target)
if err == nil {
t.Fatal("expected transport error, got nil")
}
if !strings.Contains(err.Error(), "broken pipe") {
t.Errorf("err = %v, want to wrap broken pipe", err)
}
}
func TestMigrateViaTelnet_MissingNewTelnetIsClearError(t *testing.T) {
m := &Manager{ServerURL: "http://example:8000"} // NewTelnet deliberately nil
_, err := m.migrateViaTelnet("192.0.2.1", "http://example:8000")
if err == nil {
t.Fatal("expected error when NewTelnet is nil")
}
if !strings.Contains(err.Error(), "NewTelnet") {
t.Errorf("err = %v, want a configuration error mentioning NewTelnet", err)
}
}