gallery

type AssetPayload struct {
	Data        []byte
	ContentType string
}

type AssetsPage struct {
	Assets  []*entity.GalleryAsset
	Total   int
	Page    int
	PerPage int
}

type DeleteAssetCmd struct {
	WorkspaceID string
	Key         string
}

type GalleryUseCase interface {
	// ListAssets returns a paginated list of assets for the workspace.
	ListAssets(ctx context.Context, cmd ListAssetsCmd) (*AssetsPage, error)

	// SearchAssets returns assets matching the search query.
	SearchAssets(ctx context.Context, cmd SearchAssetsCmd) (*AssetsPage, error)

	// UploadAsset uploads a new image and registers it in the gallery.
	// Deduplicates by SHA-256: returns the existing asset if the content is identical.
	UploadAsset(ctx context.Context, cmd UploadAssetCmd) (*entity.GalleryAsset, error)

	// DeleteAsset removes an asset from storage and from the gallery registry.
	DeleteAsset(ctx context.Context, cmd DeleteAssetCmd) error

	// GetAssetURL returns a resolvable HTTP URL for the given asset key.
	GetAssetURL(ctx context.Context, cmd GetAssetURLCmd) (string, error)

	// ServeAsset resolves an owned asset and returns its payload for direct HTTP serving.
	ServeAsset(ctx context.Context, cmd ServeAssetCmd) (*AssetPayload, error)
}

type GetAssetURLCmd struct {
	WorkspaceID string
	Key         string
}

type ListAssetsCmd struct {
	WorkspaceID string
	Page        int
	PerPage     int
}

type SearchAssetsCmd struct {
	WorkspaceID string
	Query       string
	Page        int
	PerPage     int
}

type ServeAssetCmd struct {
	WorkspaceID string
	Key         string
}

type UploadAssetCmd struct {
	TenantID    string
	WorkspaceID string
	UserID      string
	Filename    string
	ContentType string
	Data        []byte
}