repostore

type FileEntry struct {
	Path string
	Size int64
}

type GitMetadata struct {
	SourceRef  *string
	LastCommit *string
}

type Provider string

type PushOptions struct {
	Force   bool
	Refspec string
}

type RemoteBranch struct {
	Name      string
	IsDefault bool
}

type RemoteGit interface {
	CheckRemote(ctx context.Context, repoURL string, env []string) error
	ListRemoteBranches(ctx context.Context, repoURL string, env []string) ([]RemoteBranch, error)
	CloneRemote(
		ctx context.Context,
		repoURL, branch string,
		env []string,
	) (RepoStore, string, func(), error)
	PushRemote(ctx context.Context, repoDir, repoURL string, env []string, opts PushOptions) error
}

type RepoStore interface {
	// ReadFile returns up to maxBytes of the file at path. A positive maxBytes
	// must be enforced before the implementation materializes file contents.
	// Returns ErrFileNotFound if the file does not exist.
	ReadFile(ctx context.Context, path string, maxBytes int64) ([]byte, error)

	// WriteFile creates or overwrites the file at path with data.
	// message is an opaque commit description used by git-backed implementations.
	WriteFile(ctx context.Context, path string, data []byte, message string) error

	// DeleteFile removes the file at path.
	// Returns ErrFileNotFound if the file does not exist.
	DeleteFile(ctx context.Context, path, message string) error

	// ListFiles returns all files under dir recursively.
	// Pass "" or "." to list files from the repository root.
	ListFiles(ctx context.Context, dir string) ([]FileEntry, error)

	// FileExists reports whether the file at path exists.
	FileExists(ctx context.Context, path string) (bool, error)
}

type StreamingStore interface {
	ReadFileTo(context.Context, string, int64, io.Writer) (*filestream.Metadata, error)
	WriteFileFrom(context.Context, string, io.Reader, filepayload.Reference, bool, string) error
}