package datasources

import (
	"context"

	"github.com/google/uuid"
)

// Datasources provides bucket/datasource access for plugins.
// The CMS implements this interface and wires it into CoreServices.
type Datasources interface {
	ResolveBucket(ctx context.Context, bucketID uuid.UUID) (*Result, error)
	ResolveBucketByKey(ctx context.Context, bucketKey string) (*Result, error)
}

// Result is the output from resolving a bucket.
type Result struct {
	Items []any          `json:"items"`
	Total int            `json:"total"`
	Meta  map[string]any `json:"meta,omitempty"`
}