schema

type BackendListResponse struct {
	Body map[string]string `json:"body"`
}

type CreateObjectRequest struct {
	Path        string
	Body        io.Reader  `json:"-"`
	ContentType string     // optional: MIME type of the object
	ModTime     time.Time  // optional: modification time (stored as metadata)
	Meta        ObjectMeta // optional: user-defined metadata
	IfNotExists bool       // if true, fail with ErrConflict when the object already exists
}

type DeleteObjectRequest struct {
	Path string
}

type DeleteObjectsRequest struct {
	Path      string `json:"path,omitempty"`
	Recursive bool   `json:"recursive,omitempty"` // if true, delete all objects recursively; if false, delete only immediate children
}

type DeleteObjectsResponse struct {
	Volume string   `json:"volume,omitempty"`
	Body   []Object `json:"body,omitempty"` // list of deleted objects
}

type GetObjectRequest struct {
	Path string
}

type ListObjectsRequest struct {
	Path      string `json:"path,omitempty"`      // optional path prefix within the backend
	Recursive bool   `json:"recursive,omitempty"` // if true, list all objects recursively; if false, list only immediate children
	Offset    int    `json:"offset,omitempty"`    // number of objects to skip before returning results (0-based)
	Limit     int    `json:"limit,omitempty"`     // max objects to return; 0 means count-only (Body will be nil)
}

type ListObjectsResponse struct {
	Name  string   `json:"name,omitempty"`
	Count int      `json:"count"`          // total number of matching objects, before offset/limit
	Body  []Object `json:"body,omitempty"` // page of objects; nil when Limit==0 (count-only)
}

type Metadata struct {
	ObjectKey
	MetadataMeta
	CreatedAt time.Time `json:"created_at,omitzero"`
}

type MetadataMeta struct {
	Title   *string  `json:"title,omitempty"`
	Summary *string  `json:"summary,omitempty"`
	Text    *string  `json:"text,omitempty"`
	Tags    []string `json:"tags,omitempty"`
}

type Object struct {
	Volume      string     `json:"volume,omitempty"`
	Path        string     `json:"path,omitempty"`
	IsDir       bool       `json:"dir,omitempty"`
	Size        int64      `json:"size"`
	ModTime     time.Time  `json:"last-modified,omitzero"`
	ContentType string     `json:"type,omitempty"`
	ETag        string     `json:"etag,omitempty"`
	Meta        ObjectMeta `json:"meta,omitempty"`
}

type ObjectKey struct {
	Volume string `json:"volume,omitempty"`
	Path   string `json:"path,omitempty"`
}

type ObjectMeta map[string]string

type ReadObjectRequest struct {
	GetObjectRequest
}