From 851c81fd4b6366a5f6de3aa5e8b33ddf9bc49acf Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Tue, 13 May 2025 19:12:19 +0300
Subject: [PATCH] chore(types,utils): add featureFlag and version tags (#12464)

---
 packages/core/types/src/http/common/response.ts              | 5 ++++-
 .../types/src/index-data/query-config/query-input-config.ts  | 4 ++++
 packages/core/utils/src/core-flows/events.ts                 | 2 ++
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/core/types/src/http/common/response.ts b/packages/core/types/src/http/common/response.ts
index ce0741b858..4fb23a2801 100644
--- a/packages/core/types/src/http/common/response.ts
+++ b/packages/core/types/src/http/common/response.ts
@@ -39,7 +39,10 @@ export type PaginatedResponse<T> = {
    */
   count: number
   /**
-   * The estimated number of items.
+   * The estimated count retrieved from the PostgreSQL query planner, which may be inaccurate.
+   * 
+   * @featureFlag index_engine
+   * @version 2.8.0
    */
   estimate_count?: number
 } & T
diff --git a/packages/core/types/src/index-data/query-config/query-input-config.ts b/packages/core/types/src/index-data/query-config/query-input-config.ts
index 0f03468a76..fe919bdf37 100644
--- a/packages/core/types/src/index-data/query-config/query-input-config.ts
+++ b/packages/core/types/src/index-data/query-config/query-input-config.ts
@@ -69,6 +69,10 @@ export type IndexQueryConfig<TEntry extends string> = {
 export type QueryFunctionReturnPagination = {
   skip: number
   take: number
+  /**
+   * @featureFlag index_engine
+   * @version 2.8.0
+   */
   estimate_count: number
 }
 
diff --git a/packages/core/utils/src/core-flows/events.ts b/packages/core/utils/src/core-flows/events.ts
index 8fbb79ccc1..5bd29170a3 100644
--- a/packages/core/utils/src/core-flows/events.ts
+++ b/packages/core/utils/src/core-flows/events.ts
@@ -51,6 +51,8 @@ export const CartWorkflowEvents = {
 
   /**
    * Emitted when the customer in the cart is transferred.
+   * 
+   * @version 2.8.0
    *
    * @eventPayload
    * ```ts