vault

type Event struct {
	Kind EventKind `json:"kind"`
	Rel  string    `json:"rel"` // KindDocChanged 时为变更文件的相对路径
}

type EventKind int

type Node struct {
	Name     string  `json:"name"`
	Rel      string  `json:"rel"` // 相对文档根目录的路径，根节点为空串
	IsDir    bool    `json:"isDir"`
	Children []*Node `json:"children,omitempty"`
}

type Vault interface {
	// Root 返回消解符号链接后的绝对根路径。
	Root() string
	// Tree 返回当前的文件树快照。没有任何文档时返回一个空的根节点。
	Tree() *Node
	// ReadDoc 读取一篇 Markdown 文档，扩展名不是 .md/.markdown 时返回 ErrNotReadable。
	// 其余错误语义同 ReadAsset。
	ReadDoc(rel string) ([]byte, error)
	// ReadAsset 读取文档中引用的资源文件。
	// 路径逃逸时返回 ErrOutsideRoot，文件不存在时返回 os.ErrNotExist，
	// 路径在根内但不可读（目录、设备文件、点目录内的非资源文件，或 I/O 错误）时返回 ErrNotReadable。
	ReadAsset(rel string) ([]byte, error)
	// Watch 持续推送文件变更事件，直到 ctx 结束时关闭返回的 channel。
	Watch(ctx context.Context) <-chan Event
}