storage

type AccessExample struct {
	Description string `json:"description"`
	Command     string `json:"command"`
	SDK         string `json:"sdk,omitempty"`
}

type DatasetAvailability struct {
	Available   bool       `json:"available"`
	Bucket      string     `json:"bucket,omitempty"`
	Prefix      string     `json:"prefix,omitempty"`
	Connection  string     `json:"connection,omitempty"`
	ObjectCount int64      `json:"object_count,omitempty"`
	TotalSize   int64      `json:"total_size,omitempty"`
	LastUpdated *time.Time `json:"last_updated,omitempty"`
	Error       string     `json:"error,omitempty"`
}

type DatasetIdentifier struct {
	Bucket     string `json:"bucket"`
	Prefix     string `json:"prefix,omitempty"`
	Connection string `json:"connection,omitempty"`
}

type NoopProvider struct{}

type ObjectInfo struct {
	Key          string            `json:"key"`
	Bucket       string            `json:"bucket"`
	Size         int64             `json:"size"`
	LastModified *time.Time        `json:"last_modified,omitempty"`
	ContentType  string            `json:"content_type,omitempty"`
	Metadata     map[string]string `json:"metadata,omitempty"`
}

type Provider interface {
	// Name returns the provider name.
	Name() string

	// ResolveDataset converts a URN to a storage dataset identifier.
	ResolveDataset(ctx context.Context, urn string) (*DatasetIdentifier, error)

	// GetDatasetAvailability checks if a dataset is available in storage.
	GetDatasetAvailability(ctx context.Context, urn string) (*DatasetAvailability, error)

	// GetAccessExamples returns examples for accessing a dataset.
	GetAccessExamples(ctx context.Context, urn string) ([]AccessExample, error)

	// ListObjects lists objects in a dataset prefix.
	ListObjects(ctx context.Context, dataset DatasetIdentifier, limit int) ([]ObjectInfo, error)

	// Close releases resources.
	Close() error
}