pitr

type BaseBackup struct {
	Timestamp time.Time `json:"timestamp"`
	RemoteKey string    `json:"remote_key"` // e.g. pitr/base/20260422T020000.tar.age
	SizeBytes int64     `json:"size_bytes,omitempty"`
}

type Catalog struct {
	BaseBackups []BaseBackup `json:"base_backups"`
	WALSegments []WALSegment `json:"wal_segments"`
}

type EnableConfig struct {
	Destination       string // remote destination URL (s3://, r2://, etc.)
	EncryptRecipient  string // age public key recipient for encryption
	RetentionDays     int    // WAL retention window in days
	WALArchiveTimeout int    // archive_timeout in seconds
}

type PruneOptions struct {
	// RetentionDays is the number of days to retain WAL segments and base
	// backups. Segments older than Now()-RetentionDays are deleted.
	RetentionDays int

	// RemoteDeleteFn is called for each remote key that should be deleted.
	// Implementations must be idempotent (safe to call on already-deleted keys).
	// If nil, only the catalog is updated (no remote deletion).
	RemoteDeleteFn func(ctx context.Context, key string) error

	// LocalBaseBackupDir is the directory where local base backup archives are
	// stored. Files in this directory whose names match pruned entries are
	// removed. Set to "" to skip local file deletion.
	LocalBaseBackupDir string
}

type RestoreOptions struct {
	// TargetTime is the point in time to recover to. The database will be
	// restored to the state it held at this timestamp.
	TargetTime time.Time

	// CatalogPath is the path to the WAL catalog. Defaults to ~/.nself/wal-catalog.json.
	CatalogPath string

	// IdentityPath is the path to the age identity file for decrypting encrypted
	// base backups and WAL segments. Required if segments are encrypted.
	IdentityPath string

	// WorkDir is a scratch directory for the restore operation. Defaults to a
	// OS temp directory under pitr-restore-*.
	WorkDir string

	// AutoPromote, when true, calls pg_ctl promote after recovery completes.
	AutoPromote bool

	// ContainerName overrides the Postgres container name derived from cfg.
	ContainerName string
}

type WALSegment struct {
	Start     time.Time `json:"start"`
	End       time.Time `json:"end"`
	RemoteKey string    `json:"remote_key"`
}