Merge #724 #725 #726 #728

724: Add method to get documents by ID r=curquiza a=kumarUjjawal

# Pull Request

## Related issue
Fixes #662 

## What does this PR do?
- Added a method to get the documents by ID
- also added code samples

## PR checklist
Please check if your PR fulfills the following requirements:
- [x] Does this PR fix an existing issue, or have you listed the changes applied in the PR description (and why they are needed)?
- [x] Have you read the contributing guidelines?
- [x] Have you made sure that the title is accurate and descriptive of the changes?

Thank you so much for contributing to Meilisearch!


<!-- This is an auto-generated comment: release notes by coderabbit.ai -->

## Summary by CodeRabbit

* **New Features**
  * Added capability to retrieve documents by their IDs for more targeted queries.

* **Documentation**
  * Added code sample demonstrating ID-based document retrieval.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

725: Update diesel-async requirement from 0.6.1 to 0.7.3 r=curquiza a=dependabot[bot]

Updates the requirements on [diesel-async](https://github.com/weiznich/diesel_async) to permit the latest version.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a href="https://github.com/weiznich/diesel_async/releases">diesel-async's releases</a>.</em></p>
<blockquote>
<h2>Diesel-Async 0.7.3</h2>
<ul>
<li>Another attempt to fix the docs.rs build by <a href="https://github.com/paolobarbolini"><code>`@​paolobarbolini</code></a></li>`
</ul>
<p><strong>Full Changelog</strong>: <a href="https://github.com/weiznich/diesel_async/compare/v0.7.2...v0.7.3">https://github.com/weiznich/diesel_async/compare/v0.7.2...v0.7.3</a></p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a href="https://github.com/weiznich/diesel_async/blob/main/CHANGELOG.md">diesel-async's changelog</a>.</em></p>
<blockquote>
<h2>[0.7.3] - 2025-10-05</h2>
<ul>
<li>Another docs.rs build fix</li>
</ul>
<h2>[0.7.2] - 2025-10-02</h2>
<ul>
<li>Fix versions in the Readme</li>
</ul>
<h2>[0.7.1] - 2025-10-02</h2>
<ul>
<li>Fix the docs.rs build</li>
</ul>
<h2>[0.7.0] - 2025-10-02</h2>
<ul>
<li>Support for diesel 2.3</li>
<li>Added support for running migrations via <code>AsyncMigrationHarness</code></li>
<li>Improved ergonomics of using query pipelining with <code>AsyncPgConnection</code></li>
<li>Added the ability to cancel queries using <code>AsyncMysqlConnection::cancel_token</code></li>
</ul>
<h2>[0.6.1] - 2025-07-03</h2>
<ul>
<li>Fix features for some dependencies</li>
</ul>
<h2>[0.6.0] - 2025-07-02</h2>
<ul>
<li>Allow to control the statement cache size</li>
<li>Minimize dependencies features</li>
<li>Bump minimal supported mysql_async version to 0.36.0</li>
<li>Fixing a bug in how we tracked open transaction that could lead to dangling transactions is specific cases</li>
</ul>
<h2>[0.5.2] - 2024-11-26</h2>
<ul>
<li>Fixed an issue around transaction cancellation that could lead to connection pools containing connections with dangling transactions</li>
</ul>
<h2>[0.5.1] - 2024-11-01</h2>
<ul>
<li>Add crate feature <code>pool</code> for extending connection pool implements through external crate</li>
<li>Implement <code>Deref</code> and <code>DerefMut</code> for <code>AsyncConnectionWrapper</code> to allow using it in an async context as well</li>
</ul>
<h2>[0.5.0] - 2024-07-19</h2>
<ul>
<li>Added type <code>diesel_async::pooled_connection::mobc::PooledConnection</code></li>
<li>MySQL/MariaDB now use <code>CLIENT_FOUND_ROWS</code> capability to allow consistent behaviour with PostgreSQL regarding return value of UPDATe commands.</li>
<li>The minimal supported rust version is now 1.78.0</li>
<li>Add a <code>SyncConnectionWrapper</code> type that turns a sync connection into an async one. This enables SQLite support for diesel-async</li>
<li>Add support for <code>diesel::connection::Instrumentation</code> to support logging and other instrumentation for any of the provided connection impls.</li>
<li>Bump minimal supported mysql_async version to 0.34</li>
</ul>
<h2>[0.4.1] - 2023-09-01</h2>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a href="https://github.com/weiznich/diesel_async/commit/e5e71da49416159f593f4896375e5e5c3a3b103c"><code>e5e71da</code></a> Prepare a 0.7.3 release to finally fix the docs.rs build</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/dacc14b0148a0a7dceb3337d0aeb2577bce67d4e"><code>dacc14b</code></a> Merge pull request <a href="https://redirect.github.com/weiznich/diesel_async/issues/265">#265</a> from paolobarbolini/no-docsrs-in-rustc</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/4ae157321ebf3bcd69264765bd43400449f6aaa1"><code>4ae1573</code></a> Fix docs.rs build by avoiding <code>--cfg docsrs</code> in rustc flags</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/46cd5fed6b7ac0a7f7b1b6e1a1283fece3813fe9"><code>46cd5fe</code></a> Fix versions in the readme</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/d5ac63e13307077babf976e02ef6bbab8353f079"><code>d5ac63e</code></a> Fix docs.rs build</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/df4c823d38d0c4e1e8d78bff5977986c8107068d"><code>df4c823</code></a> Explicitly specify what should be published and what not</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/4c449530625df0580ef9d19a055109a2385ae90a"><code>4c44953</code></a> Merge pull request <a href="https://redirect.github.com/weiznich/diesel_async/issues/264">#264</a> from weiznich/prepare/0.7.0</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/d0c4ea025d85616f95d368b951f92ff784ed721a"><code>d0c4ea0</code></a> Prepare a 0.7.0 release</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/356919091e47968ca2dcc534b533cf4cb62de958"><code>3569190</code></a> Merge pull request <a href="https://redirect.github.com/weiznich/diesel_async/issues/262">#262</a> from stormshield-kg/fix-hrtb-errors</li>
<li><a href="https://github.com/weiznich/diesel_async/commit/661de8c4442a123ccde74001b44fc6a154dbc4b2"><code>661de8c</code></a> Replace hand written future impls</li>
<li>Additional commits viewable in <a href="https://github.com/weiznich/diesel_async/compare/v0.6.1...v0.7.3">compare view</a></li>
</ul>
</details>
<br />


You can trigger a rebase of this PR by commenting ``@dependabot` rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- ``@dependabot` rebase` will rebase this PR
- ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it
- ``@dependabot` merge` will merge this PR after your CI passes on it
- ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it
- ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging
- ``@dependabot` reopen` will reopen this PR if it is closed
- ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- ``@dependabot` show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency
- ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)


</details>

726: Add exhaustive facet search r=curquiza a=kumarUjjawal

# Pull Request

## Related issue
Fixes #664

## What does this PR do?
- 

## PR checklist
Please check if your PR fulfills the following requirements:
- [x] Does this PR fix an existing issue, or have you listed the changes applied in the PR description (and why they are needed)?
- [x] Have you read the contributing guidelines?
- [x] Have you made sure that the title is accurate and descriptive of the changes?

Thank you so much for contributing to Meilisearch!


<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit

* **New Features**
  * Results now include a flag indicating whether facet counts are exact or estimated, so callers can know when displayed facet totals are definitive.
  * Added an optional query setting and a builder-style method to request exhaustive (exact) facet counts when performing searches, giving users control over accuracy vs. performance.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

728: Add support for compacting database indexes r=curquiza a=kumarUjjawal

# Pull Request

## Related issue
Fixes #727 

## What does this PR do?
- I noticed a typo in the `.code-samples.meilisearch.yaml` so fixed that as well.
- 
## PR checklist
Please check if your PR fulfills the following requirements:
- [x] Does this PR fix an existing issue, or have you listed the changes applied in the PR description (and why they are needed)?
- [x] Have you read the contributing guidelines?
- [x] Have you made sure that the title is accurate and descriptive of the changes?

Thank you so much for contributing to Meilisearch!


<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit

* **New Features**
  * Added ability to perform index compaction and monitor its completion as an async task.

* **Documentation**
  * Added compact index code sample.
  * Fixed typos in field properties guide examples (corrected "overview" in searchable and displayed attributes).
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Kumar Ujjawal <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Author: 3 people

.code-samples.meilisearch.yaml

@@ -142,6 +142,13 @@ get_documents_post_1: |-
     .execute::<Movies>()
     .await
     .unwrap();
+get_documents_by_ids_1: |-
+  let index = client.index("books");
+  let documents: DocumentsResults = DocumentsQuery::new(&index)
+    .with_ids(["1", "2"]) // retrieve documents by IDs
+    .execute::<Movies>()
+    .await
+    .unwrap();
 add_or_replace_documents_1: |-
   let task: TaskInfo = client
     .index("movies")
@@ -712,10 +719,16 @@ distinct_attribute_guide_1: |-
     .set_distinct_attribute("product_id")
     .await
     .unwrap();
+compact_index_1: |-
+  let task: TaskInfo = client
+    .index("INDEX_UID")
+    .compact()
+    .await
+    .unwrap();
 field_properties_guide_searchable_1: |-
   let searchable_attributes = [
     "title",
-    "overvieww",
+    "overview",
     "genres"
   ];
 
@@ -727,7 +740,7 @@ field_properties_guide_searchable_1: |-
 field_properties_guide_displayed_1: |-
   let displayed_attributes = [
     "title",
-    "overvieww",
+    "overview",
     "genres",
     "release_date"
   ];

examples/web_app_graphql/Cargo.toml

@@ -12,7 +12,7 @@ actix-web = "4.4.0"
 async-graphql = "6.0.11"
 async-graphql-actix-web = "6.0.11"
 diesel = { version = "2.1.4", features = ["postgres"] }
-diesel-async = { version = "0.6.1", features = ["postgres", "deadpool"] }
+diesel-async = { version = "0.7.3", features = ["postgres", "deadpool"] }
 diesel_migrations = "2.1.0"
 dotenvy = "0.15.7"
 env_logger = "0.11.3"

src/documents.rs

@@ -202,6 +202,15 @@ pub struct DocumentsQuery<'a, Http: HttpClient> {
     /// Read the [dedicated guide](https://www.meilisearch.com/docs/learn/filtering_and_sorting) to learn the syntax.
     #[serde(skip_serializing_if = "Option::is_none")]
     pub filter: Option<&'a str>,
+
+    /// Retrieve documents by their IDs.
+    ///
+    /// When `ids` is provided, the SDK will call the `/documents/fetch` endpoint with a POST request.
+    ///
+    /// Note: IDs are represented as strings to keep consistency with [`Index::get_document`]. If your IDs
+    /// are numeric, pass them as strings (e.g., `"1"`, `"2"`).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub ids: Option<Vec<&'a str>>,
 }
 
 impl<'a, Http: HttpClient> DocumentsQuery<'a, Http> {
@@ -214,6 +223,7 @@ impl<'a, Http: HttpClient> DocumentsQuery<'a, Http> {
             fields: None,
             sort: None,
             filter: None,
+            ids: None,
         }
     }
 
@@ -314,6 +324,29 @@ impl<'a, Http: HttpClient> DocumentsQuery<'a, Http> {
         self
     }
 
+    /// Specify a list of document IDs to retrieve.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// # use meilisearch_sdk::{client::*, indexes::*, documents::*};
+    /// # use serde::{Deserialize, Serialize};
+    /// #
+    /// # let MEILISEARCH_URL = option_env!("MEILISEARCH_URL").unwrap_or("http://localhost:7700");
+    /// # let MEILISEARCH_API_KEY = option_env!("MEILISEARCH_API_KEY").unwrap_or("masterKey");
+    /// # let client = Client::new(MEILISEARCH_URL, Some(MEILISEARCH_API_KEY)).unwrap();
+    /// let index = client.index("get_documents_by_ids_example");
+    /// let mut query = DocumentsQuery::new(&index);
+    /// query.with_ids(["1", "2"]);
+    /// ```
+    pub fn with_ids(
+        &mut self,
+        ids: impl IntoIterator<Item = &'a str>,
+    ) -> &mut DocumentsQuery<'a, Http> {
+        self.ids = Some(ids.into_iter().collect());
+        self
+    }
+
     /// Execute the get documents query.
     ///
     /// # Example
@@ -468,6 +501,19 @@ mod tests {
         Ok(())
     }
 
+    #[meilisearch_test]
+    async fn test_get_documents_by_ids(client: Client, index: Index) -> Result<(), Error> {
+        setup_test_index(&client, &index).await?;
+
+        let documents = DocumentsQuery::new(&index)
+            .with_ids(["1", "3"]) // retrieve by IDs
+            .execute::<MyObject>()
+            .await?;
+
+        assert_eq!(documents.results.len(), 2);
+        Ok(())
+    }
+
     #[meilisearch_test]
     async fn test_delete_documents_with(client: Client, index: Index) -> Result<(), Error> {
         setup_test_index(&client, &index).await?;

src/indexes.rs

@@ -517,7 +517,7 @@ impl<Http: HttpClient> Index<Http> {
         &self,
         documents_query: &DocumentsQuery<'_, Http>,
     ) -> Result<DocumentsResults<T>, Error> {
-        if documents_query.filter.is_some() {
+        if documents_query.filter.is_some() || documents_query.ids.is_some() {
             let url = format!("{}/indexes/{}/documents/fetch", self.client.host, self.uid);
             return self
                 .client
@@ -1325,6 +1325,55 @@ impl<Http: HttpClient> Index<Http> {
         Ok(self.primary_key.as_deref())
     }
 
+    /// Compact this index to reduce disk usage.
+    ///
+    /// Triggers a compaction task for the current index. Once completed, the
+    /// index data is compacted on disk.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// # use meilisearch_sdk::{client::*, indexes::*, tasks::Task};
+    /// # let MEILISEARCH_URL = option_env!("MEILISEARCH_URL").unwrap_or("http://localhost:7700");
+    /// # let MEILISEARCH_API_KEY = option_env!("MEILISEARCH_API_KEY").unwrap_or("masterKey");
+    /// # tokio::runtime::Builder::new_current_thread().enable_all().build().unwrap().block_on(async {
+    /// # let client = Client::new(MEILISEARCH_URL, Some(MEILISEARCH_API_KEY)).unwrap();
+    /// # let index = client
+    /// #   .create_index("compact_example", None)
+    /// #   .await
+    /// #   .unwrap()
+    /// #   .wait_for_completion(&client, None, None)
+    /// #   .await
+    /// #   .unwrap()
+    /// #   .try_make_index(&client)
+    /// #   .unwrap();
+    ///
+    /// let task = index
+    ///     .compact()
+    ///     .await
+    ///     .unwrap()
+    ///     .wait_for_completion(&client, None, None)
+    ///     .await
+    ///     .unwrap();
+    ///
+    /// assert!(matches!(task, Task::Succeeded { .. }));
+    /// # index.delete().await.unwrap().wait_for_completion(&client, None, None).await.unwrap();
+    /// # });
+    /// ```
+    pub async fn compact(&self) -> Result<TaskInfo, Error> {
+        self.client
+            .http_client
+            .request::<(), (), TaskInfo>(
+                &format!("{}/indexes/{}/compact", self.client.host, self.uid),
+                Method::Post {
+                    query: (),
+                    body: (),
+                },
+                202,
+            )
+            .await
+    }
+
     /// Get a [Task] from a specific [Index] to keep track of [asynchronous operations](https://www.meilisearch.com/docs/learn/advanced/asynchronous_operations).
     ///
     /// # Example
@@ -2441,4 +2490,16 @@ mod tests {
         }
         Ok(())
     }
+
+    #[meilisearch_test]
+    async fn test_compact_index_succeeds(client: Client, index: Index) -> Result<(), Error> {
+        let task = index
+            .compact()
+            .await?
+            .wait_for_completion(&client, None, None)
+            .await?;
+
+        assert!(task.is_success());
+        Ok(())
+    }
 }

src/search.rs

@@ -115,6 +115,9 @@ pub struct SearchResults<T> {
     pub facet_distribution: Option<HashMap<String, HashMap<String, usize>>>,
     /// facet stats of the numerical facets requested in the `facet` search parameter.
     pub facet_stats: Option<HashMap<String, FacetStats>>,
+    /// Indicates whether facet counts are exhaustive (exact) rather than estimated.
+    /// Present when the `exhaustiveFacetCount` search parameter is used.
+    pub exhaustive_facet_count: Option<bool>,
     /// Processing time of the query.
     pub processing_time_ms: usize,
     /// Query originating the response.
@@ -408,6 +411,13 @@ pub struct SearchQuery<'a, Http: HttpClient> {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub retrieve_vectors: Option<bool>,
 
+    /// Request exhaustive facet counts up to the limit defined by `maxTotalHits`.
+    ///
+    /// When set to `true`, Meilisearch computes exact facet counts instead of approximate ones.
+    /// Default is `false`.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub exhaustive_facet_count: Option<bool>,
+
     #[serde(skip_serializing_if = "Option::is_none")]
     pub(crate) federation_options: Option<QueryFederationOptions>,
 }
@@ -453,6 +463,7 @@ impl<'a, Http: HttpClient> SearchQuery<'a, Http> {
             hybrid: None,
             vector: None,
             retrieve_vectors: None,
+            exhaustive_facet_count: None,
             distinct: None,
             ranking_score_threshold: None,
             locales: None,
@@ -721,6 +732,15 @@ impl<'a, Http: HttpClient> SearchQuery<'a, Http> {
         self.clone()
     }
 
+    /// Request exhaustive facet count in the response.
+    pub fn with_exhaustive_facet_count<'b>(
+        &'b mut self,
+        exhaustive: bool,
+    ) -> &'b mut SearchQuery<'a, Http> {
+        self.exhaustive_facet_count = Some(exhaustive);
+        self
+    }
+
     /// Execute the query and fetch the results.
     pub async fn execute<T: 'static + DeserializeOwned + Send + Sync>(
         &'a self,
@@ -1090,6 +1110,7 @@ pub struct FacetSearchResponse {
 
 #[cfg(test)]
 pub(crate) mod tests {
+    use crate::errors::{ErrorCode, MeilisearchError};
     use crate::{
         client::*,
         key::{Action, KeyBuilder},
@@ -1968,6 +1989,64 @@ pub(crate) mod tests {
         Ok(())
     }
 
+    #[meilisearch_test]
+    async fn test_search_with_exhaustive_facet_count(
+        client: Client,
+        index: Index,
+    ) -> Result<(), Error> {
+        setup_test_index(&client, &index).await?;
+
+        // Request exhaustive facet counts for a specific facet and ensure the server
+        // returns the exhaustive flag in the response.
+        let mut query = SearchQuery::new(&index);
+        query
+            .with_facets(Selectors::Some(&["kind"]))
+            .with_exhaustive_facet_count(true);
+
+        let res = index.execute_query::<Document>(&query).await;
+        match res {
+            Ok(results) => {
+                assert!(results.exhaustive_facet_count.is_some());
+                Ok(())
+            }
+            Err(error)
+                if matches!(
+                    error,
+                    Error::Meilisearch(MeilisearchError {
+                        error_code: ErrorCode::BadRequest,
+                        ..
+                    })
+                ) =>
+            {
+                // Server doesn't support this field on /search yet; treat as a skip.
+                Ok(())
+            }
+            Err(e) => Err(e),
+        }
+    }
+
+    #[test]
+    fn test_search_query_serialization_exhaustive_facet_count() {
+        // Build a query and ensure it serializes using the expected camelCase field name
+        let client = Client::new(
+            option_env!("MEILISEARCH_URL").unwrap_or("http://localhost:7700"),
+            Some(option_env!("MEILISEARCH_API_KEY").unwrap_or("masterKey")),
+        )
+        .unwrap();
+        let index = client.index("dummy");
+
+        let mut query = SearchQuery::new(&index);
+        query
+            .with_facets(Selectors::Some(&["kind"]))
+            .with_exhaustive_facet_count(true);
+
+        let v = serde_json::to_value(&query).unwrap();
+        assert_eq!(
+            v.get("exhaustiveFacetCount").and_then(|b| b.as_bool()),
+            Some(true)
+        );
+    }
+
     #[meilisearch_test]
     async fn test_facet_search_with_facet_query(client: Client, index: Index) -> Result<(), Error> {
         setup_test_index(&client, &index).await?;

src/tasks.rs

@@ -45,6 +45,9 @@ pub enum TaskType {
     SnapshotCreation {
         details: Option<SnapshotCreation>,
     },
+    IndexCompaction {
+        details: Option<IndexCompaction>,
+    },
 }
 
 #[derive(Debug, Clone, Deserialize)]
@@ -93,6 +96,10 @@ pub struct IndexDeletion {
 #[serde(rename_all = "camelCase")]
 pub struct SnapshotCreation {}
 
+#[derive(Debug, Clone, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct IndexCompaction {}
+
 #[derive(Debug, Clone, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DumpCreation {