statearchive

type Archive interface {
	// Open materializes the durable archive identified by name into a local
	// working directory and returns a Session. Files persisted by a previous
	// Commit are present under Session.Path() when Open returns. The caller
	// must always defer Session.Close.
	Open(ctx context.Context, name string) (Session, error)
}

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

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

type MockArchiveOpenCall struct {
	*gomock.Call
}

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

type MockSessionCloseCall struct {
	*gomock.Call
}

type MockSessionCommitCall struct {
	*gomock.Call
}

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

type MockSessionPathCall struct {
	*gomock.Call
}

type Session interface {
	// Path is the absolute path of the local working directory backing the
	// session. It is stable for the lifetime of the session.
	Path() string

	// Commit persists every change made under Path since Open (or the previous
	// Commit) to durable storage. When there is nothing to persist it is a
	// no-op. A Commit either durably persists the state or returns an error;
	// it never silently drops changes.
	Commit(ctx context.Context, message string) error

	// Close releases the session's resources. It is best-effort cleanup and is
	// safe to call from a deferred statement; failures are logged rather than
	// returned so they cannot mask the real error on the happy path.
	Close(ctx context.Context)
}