Files
Warp/server/cmd/warp/commands.go
T
tajniak81andClaude Opus 5 6004bb01de
CI / Test (ubuntu-latest) (push) Canceled after 0s
CI / Test (windows-latest) (push) Canceled after 0s
CI / Storage tests on PostgreSQL (push) Canceled after 0s
CI / Complement (federation off) (push) Canceled after 0s
CI / golangci-lint (push) Canceled after 0s
CI / Smoke test the binary (push) Canceled after 0s
Phase 1: accounts and sessions
Implements PLAN.md Phase 1. A client can now register, log in, manage its
devices and set its profile; an operator can create accounts and flip the
runtime switches. There are still no rooms and no real /sync.

userapi: accounts, argon2id passwords in PHC format, devices, access and
refresh tokens stored as SHA-256 hashes, account data and the admin flag.
Its storage interface is storage.UserStore, implemented once in sqlstore
with `?` placeholders; the postgres driver supplies a rebind function and
unique-violation recognition rather than keeping a second copy of thirty
statements. Timestamps in these tables are int64 milliseconds, the unit the
Client-Server API uses on the wire.

Client-Server API: register (user-interactive auth with m.login.dummy and
optional registration tokens), register/available, token validity, login
with m.login.password, logout, logout/all, refresh, account/whoami,
capabilities, devices/* with password-gated deletion, profile/*, global and
per-room account data.

GET /sync is a deliberate placeholder: it answers a valid token with an
empty but well-formed response and refuses a revoked one. Phase 1 has no
rooms, so that is the whole truth, and it is what makes session revocation
observable. Phase 4 replaces it with the syncapi.

Auth middleware resolves a bearer token (header or the legacy query
parameter) to a device and user, answering an expired token with the soft
logout the spec asks for. Rate limiting is a token bucket per endpoint class
keyed on the client address, returning M_LIMIT_EXCEEDED with retry_after_ms.

adminapi v1 under /_warp/admin/v1: admin-only auth via a normal Matrix
token, GET/PUT /federation and /registration driving internal/settings and
reporting a config-pinned switch as a 409, GET/POST /users, GET /stats.

warp create-account [--admin] creates the first account straight in the
database, so a new install with registration off has a way in.

Complement is wired up for the federation=off profile: an image meeting its
contract, an entrypoint that configures Warp entirely from WARP_*
variables, and a runner that builds, clones and executes the target set
(TestRegistration, TestLogin, TestDeviceManagement). It has not been run
yet -- there is no container runtime on the development machine -- so the
three tests' assertions were read from the Complement sources and pinned as
httptest tests instead, and CI gained a job that runs the real thing.

Also fixes a .gitignore bug from Phase 0: the unanchored `warp` pattern,
meant for the built binary, also matched the directory server/cmd/warp and
silently excluded the entire command package from the repository. The
binary patterns are now anchored to the repository root, and cmd/warp is
committed for the first time.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-15 18:18:37 +02:00

192 lines
4.9 KiB
Go

package main
import (
"context"
"errors"
"flag"
"fmt"
"log/slog"
"os"
"github.com/dariuszjaniak/warp/server/internal/buildinfo"
"github.com/dariuszjaniak/warp/server/internal/config"
"github.com/dariuszjaniak/warp/server/internal/logging"
"github.com/dariuszjaniak/warp/server/internal/matrix/signing"
"github.com/dariuszjaniak/warp/server/internal/setup"
"github.com/dariuszjaniak/warp/server/internal/storage"
_ "github.com/dariuszjaniak/warp/server/internal/storage/drivers" // link in the storage drivers
)
// defaultConfigPath is used when neither --config nor WARP_CONFIG is given
// and the file happens to exist next to the binary's working directory.
const defaultConfigPath = "warp.yaml"
// newFlagSet builds a flag set that prints usage to stdout on --help.
func newFlagSet(name string) *flag.FlagSet {
fs := flag.NewFlagSet(name, flag.ContinueOnError)
fs.SetOutput(os.Stdout)
return fs
}
// addConfigFlag registers --config and returns the resolver for it.
func addConfigFlag(fs *flag.FlagSet) func() (*config.Config, error) {
path := fs.String("config", "", "path to warp.yaml (default: $WARP_CONFIG, then ./warp.yaml)")
return func() (*config.Config, error) {
resolved := resolveConfigPath(*path)
cfg, err := config.Load(resolved)
if err != nil {
return nil, err
}
return cfg, nil
}
}
// resolveConfigPath implements the --config / $WARP_CONFIG / ./warp.yaml
// precedence. An empty result means "defaults plus environment", which is
// how a container with only WARP_* variables starts.
func resolveConfigPath(flagValue string) string {
if flagValue != "" {
return flagValue
}
if env := os.Getenv("WARP_CONFIG"); env != "" {
return env
}
if _, err := os.Stat(defaultConfigPath); err == nil {
return defaultConfigPath
}
return ""
}
// newLogger builds the logger described by the config.
func newLogger(cfg *config.Config) (*slog.Logger, error) {
return logging.New(os.Stderr, logging.Options{
Level: cfg.Logging.Level,
Format: cfg.Logging.Format,
AddSource: cfg.Logging.AddSource,
})
}
func runServe(ctx context.Context, args []string) error {
fs := newFlagSet("serve")
loadConfig := addConfigFlag(fs)
if err := fs.Parse(args); err != nil {
return err
}
cfg, err := loadConfig()
if err != nil {
return err
}
log, err := newLogger(cfg)
if err != nil {
return err
}
slog.SetDefault(log)
if cfg.Path() == "" {
log.Warn("no configuration file; using defaults and WARP_* environment variables")
} else {
log.Info("loaded configuration", "path", cfg.Path())
}
server, err := setup.New(ctx, cfg, setup.Options{Logger: log})
if err != nil {
return err
}
defer func() {
if err := server.Close(); err != nil {
log.Error("closing storage failed", "error", err)
}
}()
return server.Run(ctx)
}
func runMigrate(ctx context.Context, args []string) error {
fs := newFlagSet("migrate")
loadConfig := addConfigFlag(fs)
statusOnly := fs.Bool("status", false, "list pending migrations without applying them")
if err := fs.Parse(args); err != nil {
return err
}
cfg, err := loadConfig()
if err != nil {
return err
}
log, err := newLogger(cfg)
if err != nil {
return err
}
slog.SetDefault(log)
db, err := openDatabase(ctx, cfg, log)
if err != nil {
return err
}
defer func() { _ = db.Close() }()
pending, err := db.PendingMigrations(ctx)
if err != nil {
return err
}
if len(pending) == 0 {
fmt.Printf("%s: schema is up to date\n", db.Driver())
return nil
}
if *statusOnly {
fmt.Printf("%s: %d pending migration(s):\n", db.Driver(), len(pending))
for _, name := range pending {
fmt.Printf(" %s\n", name)
}
return nil
}
if err := db.Migrate(ctx); err != nil {
return err
}
fmt.Printf("%s: applied %d migration(s)\n", db.Driver(), len(pending))
return nil
}
func runGenerateKeys(_ context.Context, args []string) error {
fs := newFlagSet("generate-keys")
loadConfig := addConfigFlag(fs)
output := fs.String("output", "", "where to write the key (default: global.private_key from the config)")
keyID := fs.String("key-id", "", "key identifier without the \"ed25519:\" prefix (default: random)")
if err := fs.Parse(args); err != nil {
return err
}
path := *output
if path == "" {
cfg, err := loadConfig()
if err != nil {
return fmt.Errorf("%w\n(pass --output to generate a key without a configuration file)", err)
}
path = cfg.Global.PrivateKeyPath
}
key, err := signing.Generate(*keyID)
if err != nil {
return err
}
if err := key.Save(path); err != nil {
return err
}
fmt.Printf("wrote %s\n key ID: %s\n public key: %s\n", path, key.KeyID(), key.PublicBase64())
return nil
}
func runVersion(_ context.Context, args []string) error {
fs := newFlagSet("version")
if err := fs.Parse(args); err != nil {
return err
}
if fs.NArg() > 0 {
return errors.New("version takes no arguments")
}
fmt.Printf("warp %s\n", buildinfo.String())
fmt.Printf("storage drivers: %v\n", storage.Drivers())
return nil
}