chore: deprecate Places components (#232)

Author: VladislavFitz

Sources/InstantSearchCore/Hits/Connector/HitsConnector+GeoSearch.swift

@@ -8,8 +8,11 @@
 import Foundation
 
 extension Hit: Geolocated {}
+
+@available(*, deprecated, message: "Places feature is deprecated")
 public typealias PlaceHit = Hit<Place>
 
+@available(*, deprecated, message: "Places feature is deprecated")
 public extension HitsConnector where Hit == PlaceHit {
 
   /**
@@ -18,6 +21,7 @@ public extension HitsConnector where Hit == PlaceHit {
      - searcher: Places Searcher that handles your searches
      - interactor: External hits interactor
   */
+  @available(*, deprecated, message: "Places feature is deprecated")
   convenience init(searcher: PlacesSearcher,
                    interactor: HitsInteractor<Hit>) {
     self.init(searcher: searcher,
@@ -34,6 +38,7 @@ public extension HitsConnector where Hit == PlaceHit {
      - infiniteScrolling: Whether or not infinite scrolling is enabled
      - showItemsOnEmptyQuery: If false, no results are displayed when the user hasn’t entered any query text
   */
+  @available(*, deprecated, message: "Places feature is deprecated")
   convenience init(placesAppID: ApplicationID,
                    apiKey: APIKey,
                    infiniteScrolling: InfiniteScrolling = Constants.Defaults.infiniteScrolling,
@@ -48,6 +53,7 @@ public extension HitsConnector where Hit == PlaceHit {
 
 }
 
+@available(*, deprecated, message: "Places feature is deprecated")
 public extension HitsConnector where Hit == PlaceHit {
 
   /**
@@ -57,6 +63,7 @@ public extension HitsConnector where Hit == PlaceHit {
      - interactor: External hits interactor
      - controller: Controller interfacing with a concrete hits view
   */
+  @available(*, deprecated, message: "Places feature is deprecated")
   convenience init<Controller: GeoHitsController>(searcher: PlacesSearcher,
                                                   interactor: HitsInteractor<Hit>,
                                                   controller: Controller) where Controller.DataSource == HitsInteractor<PlaceHit> {
@@ -76,6 +83,7 @@ public extension HitsConnector where Hit == PlaceHit {
      - showItemsOnEmptyQuery: If false, no results are displayed when the user hasn’t entered any query text
      - controller: Controller interfacing with a concrete hits view
   */
+  @available(*, deprecated, message: "Places feature is deprecated")
   convenience init<Controller: GeoHitsController>(placesAppID: ApplicationID,
                                                   apiKey: APIKey,
                                                   infiniteScrolling: InfiniteScrolling = Constants.Defaults.infiniteScrolling,
@@ -96,6 +104,7 @@ public extension HitsConnector where Hit == PlaceHit {
      - controller: Controller interfacing with a concrete hits view
    - Returns: Established connection
   */
+  @available(*, deprecated, message: "Places feature is deprecated")
   @discardableResult func connectController<Controller: GeoHitsController>(_ controller: Controller) -> HitsInteractor<PlaceHit>.GeoHitsControllerConnection<Controller> where Controller.DataSource == HitsInteractor<PlaceHit> {
     let connection = interactor.connectController(controller)
     controllerConnections.append(connection)

Sources/InstantSearchCore/Hits/HitsInteractor+PlacesSearcher.swift

@@ -8,6 +8,7 @@
 
 import Foundation
 
+@available(*, deprecated, message: "Places feature is deprecated")
 public extension HitsInteractor where Record == Hit<Place> {
 
   struct PlacesSearcherConnection: Connection {
@@ -48,6 +49,7 @@ public extension HitsInteractor where Record == Hit<Place> {
 
 public extension HitsInteractor where Record == Hit<Place> {
 
+  @available(*, deprecated, message: "Places feature is deprecated")
   @discardableResult func connectPlacesSearcher(_ searcher: PlacesSearcher) -> PlacesSearcherConnection {
     let connection = PlacesSearcherConnection(interactor: self, searcher: searcher)
     connection.connect()

Sources/InstantSearchCore/Pagination/PageLoadable.swift

@@ -32,6 +32,7 @@ extension FacetSearcher: PageLoadable {
 
 }
 
+@available(*, deprecated, message: "Places feature is deprecated")
 extension PlacesSearcher: PageLoadable {
 
   public func loadPage(atIndex pageIndex: Int) {

Sources/InstantSearchCore/Searcher/Places/PlacesSearcher.swift

@@ -9,6 +9,7 @@
 import Foundation
 import AlgoliaSearchClient
 
+@available(*, deprecated, message: "Places feature is deprecated")
 final public class PlacesSearcher: AbstractSearcher<AlgoliaPlacesSearchService> {
 
   public var placesQuery: PlacesQuery {