server

type BackfillOptions struct {
	// StorageIDs, when non-empty, restricts the run to specific storages.
	// Empty means "every enabled storage".
	StorageIDs []int64
	// Limit caps the number of files processed across all storages
	// combined. 0 = unlimited.
	Limit int
	// RetryFailed includes nodes whose existing thumbnails row is in
	// state="failed". Without this, failed rows are skipped (so a flaky
	// office doc doesn't block every subsequent run).
	RetryFailed bool
	// RetrySkipped includes nodes whose existing thumbnails row is in
	// state="skipped". Use when the pipeline has gained coverage for
	// kinds that previously skipped (e.g. v0.1.7 generic fallback /
	// audio waveform) — without this, old rows freeze the pipeline.
	RetrySkipped bool
	// Stale includes ready thumbnails drawn from other content (the file
	// changed after its render), and failures or skips recorded on other
	// content. `filex thumb backfill` turns it on unless --no-stale.
	Stale bool
	// All draws every file in scope, whatever its row says ("Rebuild").
	All bool
	// Path narrows the run to one file, or one folder with everything in it:
	// storage-relative ("/Photos/2024"). "" or "/" is the whole storage. Only
	// with exactly one storage in StorageIDs; a path that has no row answers
	// ErrPathNotFound.
	Path string
	// Concurrency controls the worker pool size. <=0 → 4.
	Concurrency int
	// ProgressEvery determines how many processed nodes between an
	// OnProgress callback. <=0 disables intermediate notifications.
	ProgressEvery int
	// OnProgress, if non-nil, is invoked with the running counters every
	// ProgressEvery files. CLI uses this to print to stdout; the boot
	// goroutine leaves it nil and lets the slog summary do the work.
	OnProgress func(BackfillStats)
}

type BackfillStats struct {
	Processed int
	OK        int
	Failed    int
	Skipped   int
	// NotIndexed names the storages this run REFUSED, and why. See
	// ErrNotIndexed.
	NotIndexed []NotIndexedStorage
}

type FirstRunCredentials struct {
	AdminEmail    string
	AdminPassword string // plaintext — only ever shown ONCE (blank when preset)
	WroteFile     string // path of ~/.filex/.first-run.txt (blank when preset)
	// Preset is true when the admin was created from FILEX_ADMIN_EMAIL /
	// FILEX_ADMIN_PASSWORD — the operator already knows the password, so it is
	// neither written to disk nor echoed in the banner.
	Preset bool
}

type NotIndexedStorage struct {
	ID     int64
	Name   string
	Reason string
	// Code is Reason for a client to say in its own language: one of the
	// Gap* constants.
	Code string
}

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