engine

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

type BackupOption func(*backupConfig)

type BackupProfile struct {
	Source            string   `yaml:"source"`
	Store             string   `yaml:"store,omitempty"`
	AuthRef           string   `yaml:"auth_ref,omitempty"`
	Tags              []string `yaml:"tags,omitempty"`
	Excludes          []string `yaml:"excludes,omitempty"`
	ExcludeFile       string   `yaml:"exclude_file,omitempty"`
	IgnoreEmpty       bool     `yaml:"ignore_empty,omitempty"`
	SkipNativeFiles   bool     `yaml:"skip_native_files,omitempty"`
	VolumeUUID        string   `yaml:"volume_uuid,omitempty"`
	GoogleCreds       string   `yaml:"google_credentials,omitempty"`
	GoogleCredsRef    string   `yaml:"google_credentials_ref,omitempty"`
	GoogleCredsJSON   string   `yaml:"google_credentials_json,omitempty"`
	GoogleTokenFile   string   `yaml:"google_token_file,omitempty"`
	GoogleTokenRef    string   `yaml:"google_token_ref,omitempty"`
	OneDriveClientID  string   `yaml:"onedrive_client_id,omitempty"`
	OneDriveTokenFile string   `yaml:"onedrive_token_file,omitempty"`
	OneDriveTokenRef  string   `yaml:"onedrive_token_ref,omitempty"`
	Enabled           *bool    `yaml:"enabled,omitempty"`
}

type ChangeType string

type CheckError struct {
	Key     string // Object key (e.g. "chunk/abc123")
	Type    string // Error category: "missing", "read_error", "corrupt", "parse_error"
	Message string
}

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

type CheckOption func(*checkConfig)

type CheckResult struct {
	SnapshotsChecked int
	ObjectsVerified  int
	Errors           []CheckError
}

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

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

type DiffOption func(*diffConfig)

type DiffResult struct {
	Ref1    string
	Ref2    string
	Changes []FileChange
}

type DiscoveredSource struct {
	SourceURI   string `json:"source_uri"`
	DisplayName string `json:"display_name"`
	MountPoint  string `json:"mount_point"`
	DriveName   string `json:"drive_name,omitempty"`
	Identity    string `json:"identity,omitempty"`
	PathID      string `json:"path_id,omitempty"`
	FsType      string `json:"fs_type,omitempty"`
	Portable    bool   `json:"portable"`
}

type FileChange struct {
	Type ChangeType
	Path string
	Meta core.FileMeta
}

type FileMatch struct {
	FileID      string           `json:"file_id,omitempty"`
	ContentHash string           `json:"content_hash,omitempty"`
	Source      *core.SourceInfo `json:"source,omitempty"`
	Type        core.FileType    `json:"type,omitempty"`
	Versions    []FileVersion    `json:"versions"` // newest first
}

type FileVersion struct {
	Ref         string        `json:"ref"`
	FileID      string        `json:"file_id"`
	Name        string        `json:"name"`
	Paths       []string      `json:"paths"`
	ContentHash string        `json:"content_hash,omitempty"`
	Type        core.FileType `json:"type,omitempty"`
	Size        int64         `json:"size"`
	Mtime       int64         `json:"mtime"`
	Mode        uint32        `json:"mode,omitempty"`
	Snapshots   []SnapshotRef `json:"snapshots"`
	FirstSeen   string        `json:"first_seen"` // ISO8601, earliest containing snapshot
	LastSeen    string        `json:"last_seen"`  // ISO8601, latest containing snapshot
}

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

type FindOption func(*findConfig)

type FindQuery struct {
	// Entry predicates. All given predicates must match (conjunction).
	Name        string        `json:"name,omitempty"`
	Path        string        `json:"path,omitempty"`
	Regex       string        `json:"regex,omitempty"`
	IgnoreCase  bool          `json:"ignore_case,omitempty"`
	FileID      string        `json:"file_id,omitempty"`
	ContentHash string        `json:"content_hash,omitempty"`
	Ref         string        `json:"ref,omitempty"`
	Type        core.FileType `json:"type,omitempty"`
	Size        *SizeCompare  `json:"size,omitempty"`
	Newer       string        `json:"newer,omitempty"` // RFC3339 or a duration like "7d"
	Older       string        `json:"older,omitempty"`

	// Snapshot selectors.
	Snapshots []string `json:"snapshots,omitempty"`
	Source    string   `json:"source,omitempty"`
	Tags      []string `json:"tags,omitempty"`
	Latest    int      `json:"latest,omitempty"`
	Since     string   `json:"since,omitempty"`
	Until     string   `json:"until,omitempty"`

	// Presentation and execution.
	GroupByContent bool `json:"group_by_content,omitempty"`
	MaxResults     int  `json:"max_results,omitempty"`
	NoDelta        bool `json:"no_delta,omitempty"`
}

type FindResult struct {
	Query             FindQuery   `json:"query"`
	SnapshotsSearched int         `json:"snapshots_searched"`
	EntriesScanned    int         `json:"entries_scanned"`
	MetaFetched       int         `json:"meta_fetched"` // filemeta objects actually read
	Matches           []FileMatch `json:"matches"`
	Truncated         bool        `json:"truncated"`
	Warnings          []string    `json:"warnings,omitempty"`
	GroupedBy         string      `json:"grouped_by"` // "file" or "content"
	Elapsed           string      `json:"elapsed,omitempty"`
}

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

type ForgetOption func(*forgetConfig)

type ForgetPolicy struct {
	KeepLast    int
	KeepHourly  int
	KeepDaily   int
	KeepWeekly  int
	KeepMonthly int
	KeepYearly  int
}

type ForgetResult struct {
	Prune *PruneResult // nil when prune was not requested

	// DryRun reports that nothing was written. Callers need this to tell a
	// preview from a real mutation — stamping the repository format after a
	// dry run would make a read-only command lock other machines out.
	DryRun bool
}

type GroupKey struct {
	Source  string
	Account string
	Path    string
	Tags    string // sorted, comma-joined
}

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

type InitOption func(*initConfig)

type InitResult struct {
	Encrypted    bool
	AdoptedSlots bool   // true if existing key slots were adopted
	RecoveryKey  string // BIP39 24-word mnemonic; empty if not requested
}

type KeepReason struct {
	Entry   SnapshotEntry
	Reasons []string
}

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

type ListOption func(*listConfig)

type ListResult struct {
	Snapshots []SnapshotEntry
}

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

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

type LsSnapshotOption func(*lsSnapshotConfig)

type LsSnapshotResult struct {
	Ref       string
	Snapshot  core.Snapshot
	RootRefs  []string
	RefToMeta map[string]core.FileMeta
	ChildRefs map[string][]string
}

type PolicyGroupResult struct {
	Key    GroupKey
	Keep   []KeepReason
	Remove []SnapshotEntry
}

type PolicyResult struct {
	Groups []PolicyGroupResult
	Prune  *PruneResult

	// DryRun reports that nothing was written. See ForgetResult.DryRun.
	DryRun bool
}

type ProfileAuth struct {
	Provider          string `yaml:"provider"` // google | onedrive
	GoogleCreds       string `yaml:"google_credentials,omitempty"`
	GoogleCredsRef    string `yaml:"google_credentials_ref,omitempty"`
	GoogleCredsJSON   string `yaml:"google_credentials_json,omitempty"`
	GoogleTokenFile   string `yaml:"google_token_file,omitempty"`
	GoogleTokenRef    string `yaml:"google_token_ref,omitempty"`
	OneDriveClientID  string `yaml:"onedrive_client_id,omitempty"`
	OneDriveTokenFile string `yaml:"onedrive_token_file,omitempty"`
	OneDriveTokenRef  string `yaml:"onedrive_token_ref,omitempty"`
}

type ProfileStore struct {
	URI               string `yaml:"uri"`
	S3Endpoint        string `yaml:"s3_endpoint,omitempty"`
	S3Region          string `yaml:"s3_region,omitempty"`
	S3Profile         string `yaml:"s3_profile,omitempty"`
	S3AccessKey       string `yaml:"s3_access_key,omitempty"`
	S3SecretKey       string `yaml:"s3_secret_key,omitempty"`
	B2KeyID           string `yaml:"b2_key_id,omitempty"`
	B2AppKey          string `yaml:"b2_app_key,omitempty"`
	StoreSFTPPassword string `yaml:"store_sftp_password,omitempty"`
	StoreSFTPKey      string `yaml:"store_sftp_key,omitempty"`

	// Encryption: env var indirection for secrets, direct values for non-secrets.
	PasswordSecret          string `yaml:"password_secret,omitempty"`
	EncryptionKeySecret     string `yaml:"encryption_key_secret,omitempty"`
	RecoveryKeySecret       string `yaml:"recovery_key_secret,omitempty"`
	S3AccessKeySecret       string `yaml:"s3_access_key_secret,omitempty"`
	S3SecretKeySecret       string `yaml:"s3_secret_key_secret,omitempty"`
	B2KeyIDSecret           string `yaml:"b2_key_id_secret,omitempty"`
	B2AppKeySecret          string `yaml:"b2_app_key_secret,omitempty"`
	StoreSFTPPasswordSecret string `yaml:"store_sftp_password_secret,omitempty"`
	StoreSFTPKeySecret      string `yaml:"store_sftp_key_secret,omitempty"`
	KMSKeyARN               string `yaml:"kms_key_arn,omitempty"`
	KMSRegion               string `yaml:"kms_region,omitempty"`
	KMSEndpoint             string `yaml:"kms_endpoint,omitempty"`
}

type ProfilesConfig struct {
	Version  int                      `yaml:"version"`
	Stores   map[string]ProfileStore  `yaml:"stores"`
	Auth     map[string]ProfileAuth   `yaml:"auth"`
	Profiles map[string]BackupProfile `yaml:"profiles"`
}

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

type PruneOption func(*pruneConfig)

type PruneResult struct {
	BytesReclaimed int64
	ObjectsDeleted int
	ObjectsScanned int
	DryRun         bool
}

type RepoLock struct {
	Operation  string `json:"operation"`
	Holder     string `json:"holder"`
	AcquiredAt string `json:"acquired_at"`
	ExpiresAt  string `json:"expires_at"`
	IsShared   bool   `json:"is_shared,omitempty"`
}

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

type RestoreOption func(*restoreConfig)

type RestoreResult struct {
	SnapshotRef  string
	Root         string
	FilesWritten int
	DirsWritten  int
	BytesWritten int64
	Errors       int
	Warnings     int
	DryRun       bool
}

type RestoreWriter interface {
	MkdirAll(path string, meta core.FileMeta) error
	WriteFile(path string, meta core.FileMeta, writeContent func(io.Writer) error) error
	BytesWritten() int64
	Close() error
}

type RunResult struct {
	SnapshotHash         string
	SnapshotRef          string
	Root                 string
	FilesNew             int64
	FilesChanged         int64
	FilesUnmodified      int64
	FilesRemoved         int64
	DirsNew              int64
	DirsChanged          int64
	DirsUnmodified       int64
	DirsRemoved          int64
	BytesAddedRaw        int64
	BytesAddedStored     int64
	Duration             time.Duration
	DryRun               bool
	EmptySnapshotIgnored bool
}

type SizeCompare struct {
	Op    SizeOp `json:"op"`
	Bytes int64  `json:"bytes"`
}

type SizeOp string

type SnapshotEntry struct {
	Ref     string
	Snap    core.Snapshot
	Created time.Time
}

type SnapshotRef struct {
	Ref     string `json:"ref"`
	Seq     int    `json:"seq"`
	Created string `json:"created"` // ISO8601
}

type WorkstationApplyResult struct {
	ProfilesCreated int      `json:"profiles_created"`
	ProfilesUpdated int      `json:"profiles_updated"`
	ProfileNames    []string `json:"profile_names,omitempty"`
}

type WorkstationCoverageSummary struct {
	ProtectedNow         []string `json:"protected_now,omitempty"`
	SkippedIntentionally []string `json:"skipped_intentionally,omitempty"`
	NotAvailableNow      []string `json:"not_available_now,omitempty"`
	Warnings             []string `json:"warnings,omitempty"`
}

type WorkstationFolderCandidate struct {
	Key      string `json:"key"`
	Label    string `json:"label"`
	Category string `json:"category"`
	Path     string `json:"path"`
	Selected bool   `json:"selected"`
}

type WorkstationProfileDraft struct {
	Name         string   `json:"name"`
	SourceURI    string   `json:"source_uri"`
	StoreRef     string   `json:"store_ref,omitempty"`
	Tags         []string `json:"tags,omitempty"`
	Action       string   `json:"action"`
	DisplayLabel string   `json:"display_label,omitempty"`
	Selected     bool     `json:"selected"`
}

type WorkstationSetupOption func(*workstationSetupOptions)

type WorkstationSetupPlan struct {
	Hostname        string                       `json:"hostname"`
	StoreRef        string                       `json:"store_ref,omitempty"`
	StoreAction     string                       `json:"store_action"`
	Folders         []WorkstationFolderCandidate `json:"folders,omitempty"`
	PortableSources []DiscoveredSource           `json:"portable_sources,omitempty"`
	Profiles        []WorkstationProfileDraft    `json:"profiles,omitempty"`
	Coverage        WorkstationCoverageSummary   `json:"coverage"`
}

type WorkstationSetupResult struct {
	Plan    *WorkstationSetupPlan   `json:"plan,omitempty"`
	Applied *WorkstationApplyResult `json:"applied,omitempty"`
}