algolia · afrencalg · Mar 2, 2026 · Feb 6, 2026 · Feb 11, 2026 · Feb 23, 2026
diff --git a/.github/workflows/carthage.yml b/.github/workflows/carthage.yml
diff --git a/.github/workflows/pods.yml b/.github/workflows/pods.yml
diff --git a/.github/workflows/swift.yml b/.github/workflows/swift.yml
@@ -16,16 +16,3 @@ jobs:
         run: swift build
       - name: Run tests
         run: swift test
-  test-xcode-16:
-    runs-on: macos-15
-    env:
-      ALGOLIA_APPLICATION_ID_1: ${{ secrets.ALGOLIA_APPLICATION_ID_1 }}
-      ALGOLIA_ADMIN_KEY_1: ${{ secrets.ALGOLIA_ADMIN_KEY_1 }}
-    steps:
-      - uses: actions/checkout@v4
-      - name: Select Xcode version
-        run: sudo xcode-select -s '/Applications/Xcode_16.0.app/Contents/Developer'
-      - name: Build project
-        run: swift build
-      - name: Run tests
-        run: swift test
diff --git a/.swiftlint.yml b/.swiftlint.yml
@@ -1,13 +1,21 @@
 excluded:
  - .build
  - ./Tests
+ - ./Examples
 # implicitly
 line_length: 300
 identifier_name:
   excluded:
     - on
     - or
     - id
+function_parameter_count:
+  warning: 8
+  error: 10
+  ignores_default_parameters: true
+function_body_length:
+  warning: 60
+  error: 100
 disabled_rules:
   - todo
   - implicit_getter

diff --git a/Cartfile b/Cartfile
@@ -1,4 +1,4 @@
 github "apple/swift-log" ~> 1.5.4
-github "algolia/algoliasearch-client-swift" ~> 8.18.2
-github "apple/swift-protobuf" == 1.22.0
+github "algolia/algoliasearch-client-swift" ~> 9.37.4
+github "apple/swift-protobuf" == 1.26.0
 github "algolia/instantsearch-telemetry-native" == 0.1.3
diff --git a/Examples/Examples/Demo.swift b/Examples/Examples/Demo.swift
@@ -5,18 +5,17 @@
 //  Created by Vladislav Fitc on 13/12/2021.
 //
 
-import AlgoliaSearchClient
 import Foundation
 import UIKit
 
 protocol DemoProtocol {
-  var objectID: ObjectID { get }
+  var objectID: String { get }
   var name: String { get }
   var type: String { get }
 }
 
 struct Demo: Codable, DemoProtocol {
-  let objectID: ObjectID
+  let objectID: String
   let name: String
   let type: String
 

diff --git a/Examples/Examples/DemoListViewController.swift b/Examples/Examples/DemoListViewController.swift
@@ -23,7 +23,7 @@ final class DemoListViewController<Demo: DemoProtocol & Codable>: UITableViewCon
   private let cellIdentifier = "cellID"
   var groupedDemos: [(groupName: String, demos: [Demo])]
 
-  init(indexName: IndexName) {
+  init(indexName: String) {
     searcher = HitsSearcher(client: .instantSearch, indexName: indexName)
     filterState = .init()
     hitsInteractor = HitsInteractor(infiniteScrolling: .on(withOffset: 10), showItemsOnEmptyQuery: true)
@@ -44,8 +44,12 @@ final class DemoListViewController<Demo: DemoProtocol & Codable>: UITableViewCon
     navigationItem.searchController = searchController
     tableView.register(UITableViewCell.self, forCellReuseIdentifier: cellIdentifier)
     hitsInteractor.onResultsUpdated.subscribe(with: self) { viewController, results in
-      let demos = (try? results.extractHits(jsonDecoder: JSONDecoder()) as [Demo]) ?? []
-      viewController.updateDemos(demos)
+      do {
+        let demos: [Demo] = try results.extractHits(jsonDecoder: JSONDecoder())
+        viewController.updateDemos(demos)
+      } catch {
+        print("DemoListViewController: extractHits failed: \(error)")
+      }
     }
   }
 

diff --git a/Examples/Examples/DemoViewControllerFactory.swift b/Examples/Examples/DemoViewControllerFactory.swift
@@ -10,7 +10,7 @@ import UIKit
 // swiftlint:disable cyclomatic_complexity
 class DemoViewControllerFactory: ViewControllerFactory {
   func viewController(for demo: Demo) -> UIViewController? {
-    guard let id = Demo.ID(rawValue: demo.objectID.rawValue) else {
+    guard let id = Demo.ID(rawValue: demo.objectID) else {
       return .none
     }
 

diff --git a/Examples/Examples/FacetListTableController.swift b/Examples/Examples/FacetListTableController.swift
@@ -16,11 +16,11 @@ struct TitleDescriptor {
 }
 
 class FacetListTableController: NSObject, FacetListController {
-  var onClick: ((Facet) -> Void)?
+  var onClick: ((FacetHits) -> Void)?
 
   var tableView: UITableView
 
-  var selectableItems: [SelectableItem<Facet>] = []
+  var selectableItems: [SelectableItem<FacetHits>] = []
   let titleDescriptor: TitleDescriptor?
   private let cellID = "cellID"
 
@@ -35,7 +35,7 @@ class FacetListTableController: NSObject, FacetListController {
 
   // MARK: RefinementFacetsViewController protocol
 
-  func setSelectableItems(selectableItems: [SelectableItem<Facet>]) {
+  func setSelectableItems(selectableItems: [SelectableItem<FacetHits>]) {
     self.selectableItems = selectableItems
   }
 

diff --git a/Examples/Examples/ShowcaseDemo.swift b/Examples/Examples/ShowcaseDemo.swift
@@ -5,11 +5,10 @@
 //  Created by Vladislav Fitc on 05.04.2022.
 //
 
-import AlgoliaSearchClient
 import Foundation
 
 struct ShowcaseDemo: Codable, DemoProtocol {
-  let objectID: ObjectID
+  let objectID: String
   let name: String
   let type: String
 

diff --git a/Examples/Examples/ShowcaseDemoViewControllerFactory.swift b/Examples/Examples/ShowcaseDemoViewControllerFactory.swift
@@ -21,7 +21,7 @@ class ShowcaseDemoViewControllerFactory: ViewControllerFactory {
   }
 
   func viewController(for demo: ShowcaseDemo) -> UIViewController? {
-    guard let demoID = ShowcaseDemo.ID(rawValue: demo.objectID.rawValue) else {
+    guard let demoID = ShowcaseDemo.ID(rawValue: demo.objectID) else {
       return nil
     }
 

diff --git a/Examples/Examples/StoreItemTableViewCell+StoreItem.swift b/Examples/Examples/StoreItemTableViewCell+StoreItem.swift
@@ -5,7 +5,6 @@
 //  Created by Vladislav Fitc on 13/12/2021.
 //
 
-import AlgoliaSearchClient
 import Foundation
 import InstantSearchCore
 import UIKit

diff --git a/Examples/Examples/StoreItemTableViewCell.swift b/Examples/Examples/StoreItemTableViewCell.swift
@@ -5,7 +5,6 @@
 //  Created by Vladislav Fitc on 04/11/2021.
 //
 
-import AlgoliaSearchClient
 import Foundation
 import UIKit
 

diff --git a/Examples/Guide/GettingStartedSwiftUIGuide/AlgoliaController.swift b/Examples/Guide/GettingStartedSwiftUIGuide/AlgoliaController.swift
@@ -28,7 +28,7 @@ class AlgoliaController {
   let facetListController: FacetListObservableController
 
   init() {
-    searcher = HitsSearcher(appID: "latency",
+    searcher = try! HitsSearcher(appID: "latency",
                             apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
                             indexName: "bestbuy")
     searchBoxInteractor = .init()

diff --git a/Examples/Guide/GettingStartedUIKitGuide/GettingStartedSearchViewController.swift b/Examples/Guide/GettingStartedUIKitGuide/GettingStartedSearchViewController.swift
@@ -137,9 +137,9 @@ extension GettingStartedGuide.StepTwo {
     lazy var searchController = UISearchController(searchResultsController: hitsViewController)
     let hitsViewController = SearchResultsViewController()
 
-    let searcher = HitsSearcher(appID: "latency",
-                                apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
-                                indexName: "bestbuy")
+    let searcher = try! HitsSearcher(appID: "latency",
+                                     apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
+                                     indexName: "bestbuy")
     lazy var searchConnector = SearchConnector<Item>(searcher: searcher,
                                                      searchController: searchController,
                                                      hitsInteractor: .init(),
@@ -162,9 +162,9 @@ extension GettingStartedGuide.StepThree {
     lazy var searchController = UISearchController(searchResultsController: hitsViewController)
     let hitsViewController = SearchResultsViewController()
 
-    let searcher = HitsSearcher(appID: "latency",
-                                apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
-                                indexName: "bestbuy")
+    let searcher = try! HitsSearcher(appID: "latency",
+                                     apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
+                                     indexName: "bestbuy")
     lazy var searchConnector = SearchConnector<Item>(searcher: searcher,
                                                      searchController: searchController,
                                                      hitsInteractor: .init(),
@@ -205,9 +205,9 @@ extension GettingStartedGuide.StepFour {
     lazy var searchController = UISearchController(searchResultsController: hitsViewController)
     let hitsViewController = SearchResultsViewController()
 
-    let searcher = HitsSearcher(appID: "latency",
-                                apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
-                                indexName: "bestbuy")
+    let searcher = try! HitsSearcher(appID: "latency",
+                                     apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
+                                     indexName: "bestbuy")
     lazy var searchConnector = SearchConnector<Item>(searcher: searcher,
                                                      searchController: searchController,
                                                      hitsInteractor: .init(),
@@ -249,9 +249,9 @@ extension GettingStartedGuide.StepFive {
     lazy var searchController = UISearchController(searchResultsController: hitsTableViewController)
     let hitsTableViewController = SearchResultsViewController()
 
-    let searcher = HitsSearcher(appID: "latency",
-                                apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
-                                indexName: "bestbuy")
+    let searcher = try! HitsSearcher(appID: "latency",
+                                     apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
+                                     indexName: "bestbuy")
     lazy var searchConnector = SearchConnector<Item>(searcher: searcher,
                                                      searchController: searchController,
                                                      hitsInteractor: .init(),
@@ -305,9 +305,9 @@ extension GettingStartedGuide.StepSix {
     lazy var searchController = UISearchController(searchResultsController: hitsViewController)
     let hitsViewController = SearchResultsViewController()
 
-    let searcher = HitsSearcher(appID: "latency",
-                                apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
-                                indexName: "bestbuy")
+    let searcher = try! HitsSearcher(appID: "latency",
+                                     apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
+                                     indexName: "bestbuy")
     lazy var searchConnector = SearchConnector<Item>(searcher: searcher,
                                                      searchController: searchController,
                                                      hitsInteractor: .init(),
@@ -365,9 +365,9 @@ extension GettingStartedGuide.StepSeven {
     lazy var searchController = UISearchController(searchResultsController: hitsViewController)
     let hitsViewController = SearchResultsViewController()
 
-    let searcher = HitsSearcher(appID: "latency",
-                                apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
-                                indexName: "bestbuy")
+    let searcher = try! HitsSearcher(appID: "latency",
+                                     apiKey: "1f6fd3a6fb973cb08419fe7d288fa4db",
+                                     indexName: "bestbuy")
     lazy var searchConnector = SearchConnector<Item>(searcher: searcher,
                                                      searchController: searchController,
                                                      hitsInteractor: .init(),

diff --git a/Examples/Insights/InsightsViewController.swift b/Examples/Insights/InsightsViewController.swift
@@ -31,7 +31,8 @@ class InsightsViewController: UIViewController {
     textFieldController = .init(searchBar: searchController.searchBar)
     searchBoxConnector = .init(searcher: searcher,
                                controller: textFieldController)
-    let insights = Insights.register(appId: SearchClient.ecommerce.applicationID, apiKey: SearchClient.ecommerce.apiKey)
+    // Use the same credentials as SearchClient.ecommerce
+    let insights = try! Insights.register(appId: "latency", apiKey: "927c3fe76d4b52c5a2912973f35a3077")
     hitsTracker = .init(eventName: "demo",
                         searcher: searcher,
                         insights: insights)

diff --git a/Examples/QuerySuggestions/QuerySuggestionsDemoView.swift b/Examples/QuerySuggestions/QuerySuggestionsDemoView.swift
@@ -66,13 +66,13 @@ final class SearchViewModel: ObservableObject {
   init() {
     let appID: ApplicationID = "latency"
     let apiKey: APIKey = "af044fb0788d6bb15f807e4420592bc5"
-    let itemsSearcher = HitsSearcher(appID: appID,
-                                     apiKey: apiKey,
-                                     indexName: "instant_search")
+    let itemsSearcher = try! HitsSearcher(appID: appID,
+                                          apiKey: apiKey,
+                                          indexName: "instant_search")
     self.itemsSearcher = itemsSearcher
-    self.suggestionsSearcher = HitsSearcher(appID: appID,
-                                            apiKey: apiKey,
-                                            indexName: "query_suggestions")
+    self.suggestionsSearcher = try! HitsSearcher(appID: appID,
+                                                 apiKey: apiKey,
+                                                 indexName: "query_suggestions")
     self.hits = itemsSearcher.paginatedData(of: Hit<Item>.self)
     searchQuery = ""
     suggestions = []

diff --git a/Examples/Shared/Credentials/Ecommerce.swift b/Examples/Shared/Credentials/Ecommerce.swift
@@ -5,25 +5,31 @@
 //  Created by Vladislav Fitc on 08/05/2022.
 //
 
-import AlgoliaSearchClient
 import Foundation
+import Search
+
+#if canImport(Recommend)
+import Recommend
+#endif
 
 extension SearchClient {
-  static let ecommerce = Self(appID: "latency", apiKey: "927c3fe76d4b52c5a2912973f35a3077")
-  static let ecommerceRecommend = Self(appID: "XX85YRZZMV", apiKey: "d17ff64e913b3293cfba3d3665480217")
+  static let ecommerce = try! SearchClient(appID: "latency", apiKey: "927c3fe76d4b52c5a2912973f35a3077")
+  static let ecommerceRecommend = try! SearchClient(appID: "XX85YRZZMV", apiKey: "d17ff64e913b3293cfba3d3665480217")
 }
 
-extension IndexName {
-  static let ecommerceProducts: IndexName = "STAGING_native_ecom_demo_products"
-  static let ecommerceProductsAsc: IndexName = "STAGING_native_ecom_demo_products_products_price_asc"
-  static let ecommerceProductsDesc: IndexName = "STAGING_native_ecom_demo_products_products_price_desc"
-  static let ecommerceSuggestions: IndexName = "STAGING_native_ecom_demo_products_query_suggestions"
+extension String {
+  static let ecommerceProducts = "STAGING_native_ecom_demo_products"
+  static let ecommerceProductsAsc = "STAGING_native_ecom_demo_products_products_price_asc"
+  static let ecommerceProductsDesc = "STAGING_native_ecom_demo_products_products_price_desc"
+  static let ecommerceSuggestions = "STAGING_native_ecom_demo_products_query_suggestions"
 }
 
+#if canImport(Recommend)
 extension RecommendClient {
-  static let ecommerceRecommend = Self(appID: "XX85YRZZMV", apiKey: "d17ff64e913b3293cfba3d3665480217")
+  static let ecommerceRecommend = try! RecommendClient(appID: "XX85YRZZMV", apiKey: "d17ff64e913b3293cfba3d3665480217")
 }
+#endif
 
-extension IndexName {
-  static let ecommerceRecommend: IndexName = "test_FLAGSHIP_ECOM_recommend"
+extension String {
+  static let ecommerceRecommend = "test_FLAGSHIP_ECOM_recommend"
 }