server

type Clock struct {
	// contains filtered or unexported fields
}

type Listener interface {
	Accept() (io.ReadWriteCloser, error)
	Close() error
	Addr() string // the endpoint, as SERVE names it
	Remote() bool
}

type Options struct {
	// Version is the server's, as WELCOME states it.
	Version string

	// Logger receives the server's own logs; nil takes the store's, labelled
	// engine=server.
	Logger *slog.Logger

	// Tokens let remote connections in, each with its capability; a local
	// connection needs none.
	Tokens Tokens

	// KV is the kv engine the program opened. When it is nil the server opens
	// it with KVOptions the first time a client asks, since an engine opens
	// once a store. The same holds for every engine below.
	KV             *kv.Store
	KVOptions      kv.Options
	Jobs           *jobs.Store
	JobsOptions    jobs.Options
	Blobs          *blobs.Store
	BlobsOptions   blobs.Options
	Records        *records.Store
	RecordsOptions records.Options
	Metrics        *metrics.Store
	MetricsOptions metrics.Options

	// Stop stops the program serving the store when an admin client asks it
	// to, by server.stop, once the server has answered; nil refuses the
	// request, since a program serving its own store decides when it stops.
	// It returns at once, and the program closes the server as it would.
	Stop func()

	// Sidecar says in SERVE that this is the directory's sidecar, which a
	// client of a newer release replaces with its own: tinystore serve --local
	// started for its clients, not a program's own server or a person's.
	Sidecar bool

	// Clock is the time the store runs on in a test, which an admin's
	// server.clock moves; the store must read it, through
	// tinystore.Options.Clock. Nil refuses the call: the system's time.
	Clock *Clock

	// SQL holds the databases the program opened, by name. A client's sql.open
	// of one checks the migrations it carries against those the file applied,
	// since a database opens once a store. The server opens any other name
	// itself, with the migrations the client carries.
	SQL map[string]*sqldb.DB

	// JobsIn holds the jobs stores the program opened In its databases, by the
	// database's name, as SQL holds the databases. A client's queue in one of
	// them lives there; the server opens any other itself, In the database of
	// that name, once a client has opened it.
	JobsIn map[string]*jobs.Store
}

type Server struct {
	// contains filtered or unexported fields
}

type Tokens struct {
	// contains filtered or unexported fields
}