@open-mercato/core 0.6.8-develop.7029.1.a1bb3363af → 0.6.8-develop.7031.1.005201cd70

package/src/modules/catalog/components/categories/CategoriesDataTable.tsx

@@ -39,6 +39,7 @@ type CategoriesResponse = {
   page: number
   pageSize: number
   totalPages: number
+  totalIsCapped?: boolean
 }
 
 const PAGE_SIZE = 50
@@ -114,6 +115,7 @@ export default function CategoriesDataTable() {
   const rows = data?.items ?? []
   const total = data?.total ?? 0
   const totalPages = data?.totalPages ?? 0
+  const totalIsCapped = data?.totalIsCapped === true
 
   const columns = React.useMemo<ColumnDef<CategoryRow>[]>(() => [
     {
@@ -249,6 +251,7 @@ export default function CategoriesDataTable() {
           pageSize: PAGE_SIZE,
           total,
           totalPages,
+          totalIsCapped,
           onPageChange: setPage,
         }}
         isLoading={isLoading}

package/src/modules/catalog/components/products/ProductsDataTable.tsx

@@ -86,6 +86,7 @@ type ProductsResponse = {
   items?: ProductRow[]
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 const PAGE_SIZE = 25
@@ -177,6 +178,7 @@ export default function ProductsDataTable({
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [cacheStatus, setCacheStatus] = React.useState<'hit' | 'miss' | null>(null)
   const [sorting, setSorting] = React.useState<SortingState>([{ id: 'title', desc: false }])
   const [search, setSearch] = React.useState('')
@@ -598,6 +600,7 @@ export default function ProductsDataTable({
         setRows(normalized)
         setTotal(typeof payload.total === 'number' ? payload.total : normalized.length)
         setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : 1)
+        setTotalIsCapped(payload.totalIsCapped === true)
       } catch (error) {
         if (!cancelled) {
           setCacheStatus(null)
@@ -712,12 +715,16 @@ export default function ProductsDataTable({
           // dependency on the host page.
           total,
           totalMatching: total,
+          // `total` is a floor when the server capped the count, so the
+          // merchandising widget must not present it as an exact match count.
+          totalIsCapped,
         }}
         pagination={{
           page,
           pageSize: PAGE_SIZE,
           total,
           totalPages,
+          totalIsCapped,
           onPageChange: setPage,
           cacheStatus,
         }}

package/src/modules/catalog/i18n/de.json

@@ -90,6 +90,7 @@
   "catalog.merchandising_assistant.agents.merchandising.label": "Merchandising-Assistent",
   "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
   "catalog.merchandising_assistant.context.matchingProducts": "{count} Produkte in der Ansicht",
+  "catalog.merchandising_assistant.context.matchingProductsCapped": "{count}+ Produkte in der Ansicht",
   "catalog.merchandising_assistant.context.selectedProducts": "{count} Produkte ausgewählt",
   "catalog.merchandising_assistant.context.tags": "{count} tags",
   "catalog.merchandising_assistant.dock.subtitle": "Catalog",

package/src/modules/catalog/i18n/en.json

@@ -90,6 +90,7 @@
   "catalog.merchandising_assistant.agents.merchandising.label": "Merchandising Assistant",
   "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
   "catalog.merchandising_assistant.context.matchingProducts": "{count} products in view",
+  "catalog.merchandising_assistant.context.matchingProductsCapped": "{count}+ products in view",
   "catalog.merchandising_assistant.context.selectedProducts": "{count} products selected",
   "catalog.merchandising_assistant.context.tags": "{count} tags",
   "catalog.merchandising_assistant.dock.subtitle": "Catalog",

package/src/modules/catalog/i18n/es.json

@@ -90,6 +90,7 @@
   "catalog.merchandising_assistant.agents.merchandising.label": "Asistente de Merchandising",
   "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
   "catalog.merchandising_assistant.context.matchingProducts": "{count} productos en la vista",
+  "catalog.merchandising_assistant.context.matchingProductsCapped": "{count}+ productos en la vista",
   "catalog.merchandising_assistant.context.selectedProducts": "{count} productos seleccionados",
   "catalog.merchandising_assistant.context.tags": "{count} tags",
   "catalog.merchandising_assistant.dock.subtitle": "Catalog",

package/src/modules/catalog/i18n/ko.json

@@ -90,6 +90,7 @@
   "catalog.merchandising_assistant.agents.merchandising.label": "머천다이징 어시스턴트",
   "catalog.merchandising_assistant.context.filteredByCategory": "카테고리로 필터링됨",
   "catalog.merchandising_assistant.context.matchingProducts": "{count} 제품 보기",
+  "catalog.merchandising_assistant.context.matchingProductsCapped": "조회 중 {count}+개 제품",
   "catalog.merchandising_assistant.context.selectedProducts": "{count} 제품 선택됨",
   "catalog.merchandising_assistant.context.tags": "태그 {count}개",
   "catalog.merchandising_assistant.dock.subtitle": "카탈로그",

package/src/modules/catalog/i18n/pl.json

@@ -90,6 +90,7 @@
   "catalog.merchandising_assistant.agents.merchandising.label": "Asystent merchandisingu",
   "catalog.merchandising_assistant.context.filteredByCategory": "Filtrowane po kategorii",
   "catalog.merchandising_assistant.context.matchingProducts": "{count} produktów w widoku",
+  "catalog.merchandising_assistant.context.matchingProductsCapped": "{count}+ produktów w widoku",
   "catalog.merchandising_assistant.context.selectedProducts": "Wybrano {count} produktów",
   "catalog.merchandising_assistant.context.tags": "Tagi: {count}",
   "catalog.merchandising_assistant.dock.subtitle": "Katalog",

package/src/modules/catalog/widgets/injection/merchandising-assistant-trigger/widget.client.tsx

@@ -31,6 +31,8 @@ interface HostInjectionContext {
   scopeVersion?: unknown
   total?: number | string
   totalMatching?: number | string
+  /** `totalMatching` is a floor, not an exact count (server-capped list count). */
+  totalIsCapped?: boolean
   /** Selected row IDs from DataTable (auto-enriched when bulk actions are present). */
   selectedRowIds?: string[]
   selectedCount?: number
@@ -83,6 +85,7 @@ export function computeCatalogMerchandisingPageContext(
   context: HostInjectionContext | undefined,
 ): MerchandisingPageContext {
   const totalMatching = readNumber(context?.totalMatching ?? context?.total)
+  const totalMatchingIsCapped = context?.totalIsCapped === true
   const selectedRowIds = Array.isArray(context?.selectedRowIds) ? context.selectedRowIds : []
   const selectedCount = selectedRowIds.length > 0 ? selectedRowIds.length : readNumber(context?.selectedCount)
   return {
@@ -93,6 +96,7 @@ export function computeCatalogMerchandisingPageContext(
     extra: {
       filter: normalizeFilters(context),
       totalMatching,
+      totalMatchingIsCapped,
       selectedCount,
     },
   }

package/src/modules/communication_channels/backend/communication_channels/channels/page.tsx

@@ -24,6 +24,7 @@ type ChannelListResponse = {
   items?: ChannelRow[]
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 export default function ChannelsListPage() {
@@ -31,6 +32,7 @@ export default function ChannelsListPage() {
   const [rows, setRows] = React.useState<ChannelRow[]>([])
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [page, setPage] = React.useState(1)
   const [isLoading, setIsLoading] = React.useState(true)
   const [errorMessage, setErrorMessage] = React.useState<string | null>(null)
@@ -72,6 +74,7 @@ export default function ChannelsListPage() {
         setRows(Array.isArray(data.items) ? data.items : [])
         setTotal(typeof data.total === 'number' ? data.total : 0)
         setTotalPages(typeof data.totalPages === 'number' ? data.totalPages : 1)
+        setTotalIsCapped(data.totalIsCapped === true)
       }
       setIsLoading(false)
     }
@@ -139,6 +142,7 @@ export default function ChannelsListPage() {
             pageSize,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: setPage,
           }}
         />

package/src/modules/configs/i18n/de.json

@@ -155,6 +155,8 @@
   "configs.systemStatus.variables.entitiesBackcompatEav.label": "Legacy-EAV-Schreibvorgänge",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.description": "Query-Index-Ergebnisse auch bei unvollständiger Abdeckung bereitstellen.",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.label": "Teilindex-Nutzung erzwingen",
+  "configs.systemStatus.variables.listCountCap.description": "Maximal gemeldete Gesamtzahl einer Liste; die Zählung stoppt an der Obergrenze und begrenzte Summen werden z. B. als „10 000+“ angezeigt. 0 deaktiviert die Begrenzung.",
+  "configs.systemStatus.variables.listCountCap.label": "Obergrenze für Listenzählung",
   "configs.systemStatus.variables.logLevel.description": "Fallback-Log-Level, wenn die Verbosität nicht gesetzt ist.",
   "configs.systemStatus.variables.logLevel.label": "Log-Level",
   "configs.systemStatus.variables.logVerbosity.description": "Überschreibt die strukturierte Log-Verbosität wie Debug oder Trace.",

package/src/modules/configs/i18n/en.json

@@ -155,6 +155,8 @@
   "configs.systemStatus.variables.entitiesBackcompatEav.label": "Legacy EAV writes",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.description": "Serve query index results even when coverage is partial.",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.label": "Force partial index usage",
+  "configs.systemStatus.variables.listCountCap.description": "Maximum reported list total; counting stops at the cap and capped totals render as e.g. “10 000+”. 0 disables capping.",
+  "configs.systemStatus.variables.listCountCap.label": "List count cap",
   "configs.systemStatus.variables.logLevel.description": "Fallback log level applied when verbosity is not set.",
   "configs.systemStatus.variables.logLevel.label": "Log level",
   "configs.systemStatus.variables.logVerbosity.description": "Overrides structured log verbosity such as debug or trace.",

package/src/modules/configs/i18n/es.json

@@ -155,6 +155,8 @@
   "configs.systemStatus.variables.entitiesBackcompatEav.label": "Escrituras EAV heredadas",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.description": "Servir resultados del índice de consultas incluso cuando la cobertura es parcial.",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.label": "Forzar uso de índice parcial",
+  "configs.systemStatus.variables.listCountCap.description": "Total máximo informado en listas; el conteo se detiene en el límite y los totales limitados se muestran p. ej. como «10 000+». 0 desactiva el límite.",
+  "configs.systemStatus.variables.listCountCap.label": "Límite del conteo de listas",
   "configs.systemStatus.variables.logLevel.description": "Nivel de registro de respaldo cuando la verbosidad no está configurada.",
   "configs.systemStatus.variables.logLevel.label": "Nivel de registro",
   "configs.systemStatus.variables.logVerbosity.description": "Anula la verbosidad del registro estructurado, como debug o trace.",

package/src/modules/configs/i18n/ko.json

@@ -155,6 +155,8 @@
   "configs.systemStatus.variables.entitiesBackcompatEav.label": "레거시 EAV 쓰기",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.description": "커버리지가 부분적이어도 쿼리 인덱스 결과를 제공합니다.",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.label": "부분 인덱스 사용 강제",
+  "configs.systemStatus.variables.listCountCap.description": "목록 총계의 최대 보고 값입니다. 카운트는 상한에서 멈추며 제한된 총계는 예를 들어 “10 000+”로 표시됩니다. 0이면 상한이 비활성화됩니다.",
+  "configs.systemStatus.variables.listCountCap.label": "목록 카운트 상한",
   "configs.systemStatus.variables.logLevel.description": "상세 수준이 설정되지 않았을 때 적용되는 대체 로그 레벨입니다.",
   "configs.systemStatus.variables.logLevel.label": "로그 레벨",
   "configs.systemStatus.variables.logVerbosity.description": "debug나 trace와 같은 구조화된 로그 상세 수준을 재정의합니다.",

package/src/modules/configs/i18n/pl.json

@@ -155,6 +155,8 @@
   "configs.systemStatus.variables.entitiesBackcompatEav.label": "Zapis do legacy EAV",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.description": "Pozwala korzystać z wyników indeksu zapytań nawet przy częściowym pokryciu.",
   "configs.systemStatus.variables.forceQueryIndexOnPartialIndexes.label": "Wymuś użycie częściowego indeksu",
+  "configs.systemStatus.variables.listCountCap.description": "Maksymalna raportowana liczba wyników listy; zliczanie zatrzymuje się na limicie, a ograniczone sumy są pokazywane np. jako „10 000+”. 0 wyłącza limit.",
+  "configs.systemStatus.variables.listCountCap.label": "Limit licznika list",
   "configs.systemStatus.variables.logLevel.description": "Domyślny poziom logowania używany, gdy nie ustawiono szczegółowości.",
   "configs.systemStatus.variables.logLevel.label": "Poziom logowania",
   "configs.systemStatus.variables.logVerbosity.description": "Nadpisuje poziom szczegółowości logów, np. debug lub trace.",

package/src/modules/configs/lib/system-status.ts

@@ -267,6 +267,15 @@ export const SYSTEM_STATUS_VARIABLES: SystemStatusVariableDefinition[] = [
     docUrl: `${SYSTEM_STATUS_DOC_BASE}#optimize_index_coverage_stats`,
     defaultValue: 'false',
   },
+  {
+    key: 'OM_LIST_COUNT_CAP',
+    category: 'query_index',
+    kind: 'string',
+    labelKey: 'configs.systemStatus.variables.listCountCap.label',
+    descriptionKey: 'configs.systemStatus.variables.listCountCap.description',
+    docUrl: `${SYSTEM_STATUS_DOC_BASE}#om_list_count_cap`,
+    defaultValue: '10000',
+  },
   {
     key: 'FORCE_QUERY_INDEX_ON_PARTIAL_INDEXES',
     category: 'query_index',

package/src/modules/currencies/backend/currencies/page.tsx

@@ -41,6 +41,7 @@ type ResponsePayload = {
   total: number
   page: number
   totalPages: number
+  totalIsCapped?: boolean
 }
 
 export default function CurrenciesPage() {
@@ -50,6 +51,7 @@ export default function CurrenciesPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [filters, setFilters] = React.useState<FilterValues>({})
   const [isLoading, setIsLoading] = React.useState(true)
@@ -96,6 +98,7 @@ export default function CurrenciesPage() {
           setRows(Array.isArray(payload.items) ? payload.items : [])
           setTotal(payload.total || 0)
           setTotalPages(payload.totalPages || 1)
+          setTotalIsCapped(payload?.totalIsCapped === true)
         }
       } catch (error) {
         if (!cancelled) {
@@ -342,7 +345,7 @@ export default function CurrenciesPage() {
               createLabel={t('currencies.list.actions.create')}
             />
           )}
-          pagination={{ page, pageSize: 50, total, totalPages, onPageChange: setPage }}
+          pagination={{ page, pageSize: 50, total, totalPages, totalIsCapped, onPageChange: setPage }}
           isLoading={isLoading}
           perspective={{ tableId: extensionPoints.hosts.currenciesTable.tableId }}
         />

package/src/modules/currencies/backend/exchange-rates/page.tsx

@@ -42,6 +42,7 @@ type ResponsePayload = {
   total: number
   page: number
   totalPages: number
+  totalIsCapped?: boolean
 }
 
 export default function ExchangeRatesPage() {
@@ -51,6 +52,7 @@ export default function ExchangeRatesPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [filters, setFilters] = React.useState<FilterValues>({})
   const [isLoading, setIsLoading] = React.useState(true)
@@ -100,6 +102,7 @@ export default function ExchangeRatesPage() {
           setRows(Array.isArray(payload.items) ? payload.items : [])
           setTotal(payload.total || 0)
           setTotalPages(payload.totalPages || 1)
+          setTotalIsCapped(payload?.totalIsCapped === true)
         }
       } catch (error) {
         if (!cancelled) {
@@ -332,7 +335,7 @@ export default function ExchangeRatesPage() {
               createLabel={t('exchangeRates.list.actions.create')}
             />
           )}
-          pagination={{ page, pageSize: 50, total, totalPages, onPageChange: setPage }}
+          pagination={{ page, pageSize: 50, total, totalPages, totalIsCapped, onPageChange: setPage }}
           isLoading={isLoading}
           perspective={{ tableId: extensionPoints.hosts.exchangeRatesTable.tableId }}
         />

package/src/modules/customer_accounts/backend/customer_accounts/roles/page.tsx

@@ -34,6 +34,7 @@ type RolesResponse = {
   items?: RoleRow[]
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 export default function CustomerRolesPage() {
@@ -45,6 +46,7 @@ export default function CustomerRolesPage() {
   const [pageSize] = React.useState(50)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [isLoading, setIsLoading] = React.useState(true)
   const [reloadToken, setReloadToken] = React.useState(0)
@@ -88,6 +90,7 @@ export default function CustomerRolesPage() {
         setRows(items)
         setTotal(typeof payload?.total === 'number' ? payload.total : items.length)
         setTotalPages(typeof payload?.totalPages === 'number' ? payload.totalPages : 1)
+        setTotalIsCapped(payload?.totalIsCapped === true)
       } catch (err) {
         if (!cancelled) {
           const message = err instanceof Error ? err.message : t('customer_accounts.admin.roles.error.load', 'Failed to load roles')
@@ -240,7 +243,7 @@ export default function CustomerRolesPage() {
               ]}
             />
           )}
-          pagination={{ page, pageSize, total, totalPages, onPageChange: setPage }}
+          pagination={{ page, pageSize, total, totalPages, totalIsCapped, onPageChange: setPage }}
           isLoading={isLoading}
         />
       </PageBody>

package/src/modules/customer_accounts/backend/customer_accounts/users/page.tsx

@@ -41,6 +41,7 @@ type UsersResponse = {
   items?: UserRow[]
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 function formatDate(value: string | null | undefined, fallback: string): string {
@@ -235,6 +236,7 @@ export default function CustomerAccountsPage() {
   const [pageSize] = React.useState(50)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [filterValues, setFilterValues] = React.useState<FilterValues>({})
   const [isLoading, setIsLoading] = React.useState(true)
@@ -314,6 +316,7 @@ export default function CustomerAccountsPage() {
         setRows(items)
         setTotal(typeof payload?.total === 'number' ? payload.total : items.length)
         setTotalPages(typeof payload?.totalPages === 'number' ? payload.totalPages : 1)
+        setTotalIsCapped(payload?.totalIsCapped === true)
       } catch (err) {
         if (!cancelled) {
           const message = err instanceof Error ? err.message : t('customer_accounts.admin.error.loadUsers', 'Failed to load customer users')
@@ -579,7 +582,7 @@ export default function CustomerAccountsPage() {
               ]}
             />
           )}
-          pagination={{ page, pageSize, total, totalPages, onPageChange: setPage }}
+          pagination={{ page, pageSize, total, totalPages, totalIsCapped, onPageChange: setPage }}
           isLoading={isLoading}
         />
         <CreateUserDialog

package/src/modules/customers/ai-tools/companies-pack.ts

@@ -85,7 +85,7 @@ const listCompaniesTool = defineApiBackedAiTool<
   name: 'customers.list_companies',
   displayName: 'List companies',
   description:
-    'Search / list companies for the caller tenant + organization. Returns { items, total, limit, offset }.',
+    'Search / list companies for the caller tenant + organization. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor ("at least N", render it as "N+"), and pagination is exhausted only when a page returns fewer than limit items — never when offset reaches total.',
   inputSchema: listCompaniesInput,
   requiredFeatures: ['customers.companies.view'],
   toOperation: (input, ctx) => {
@@ -122,6 +122,9 @@ const listCompaniesTool = defineApiBackedAiTool<
         sizeBucket: row.size_bucket ?? row.sizeBucket ?? null,
       })),
       total: typeof data.total === 'number' ? data.total : 0,
+      // A capped count reports a floor: phrase the total as "at least N" and
+      // never treat it as proof that pagination is exhausted.
+      totalIsCapped: (data as { totalIsCapped?: boolean }).totalIsCapped === true,
       limit,
       offset,
     }

package/src/modules/customers/ai-tools/deals-pack.ts

@@ -99,7 +99,7 @@ const listDealsTool = defineApiBackedAiTool<ListDealsInput, ListDealsApiResponse
   name: 'customers.list_deals',
   displayName: 'List deals',
   description:
-    'Search / list deals for the caller tenant + organization. Optional filters include linked person / company / pipeline stage.',
+    'Search / list deals for the caller tenant + organization. Optional filters include linked person / company / pipeline stage. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor ("at least N", render it as "N+"), and pagination is exhausted only when a page returns fewer than limit items — never when offset reaches total.',
   inputSchema: listDealsInput,
   requiredFeatures: ['customers.deals.view'],
   toOperation: (input, ctx) => {
@@ -155,6 +155,9 @@ const listDealsTool = defineApiBackedAiTool<ListDealsInput, ListDealsApiResponse
         }
       }),
       total: typeof data.total === 'number' ? data.total : 0,
+      // A capped count reports a floor: phrase the total as "at least N" and
+      // never treat it as proof that pagination is exhausted.
+      totalIsCapped: (data as { totalIsCapped?: boolean }).totalIsCapped === true,
       limit,
       offset,
     }

package/src/modules/customers/ai-tools/people-pack.ts

@@ -90,7 +90,7 @@ const listPeopleTool = defineApiBackedAiTool<ListPeopleInput, ListPeopleApiRespo
   name: 'customers.list_people',
   displayName: 'List people',
   description:
-    'Search / list people (CRM persons) for the caller tenant + organization. Returns { items, total, limit, offset }.',
+    'Search / list people (CRM persons) for the caller tenant + organization. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor ("at least N", render it as "N+"), and pagination is exhausted only when a page returns fewer than limit items — never when offset reaches total.',
   inputSchema: listPeopleInput,
   requiredFeatures: ['customers.people.view'],
   toOperation: async (input, ctx) => {
@@ -144,6 +144,9 @@ const listPeopleTool = defineApiBackedAiTool<ListPeopleInput, ListPeopleApiRespo
     return {
       items: rawItems.map((row) => toCustomerListSummary(row)),
       total: typeof data.total === 'number' ? data.total : 0,
+      // A capped count reports a floor: phrase the total as "at least N" and
+      // never treat it as proof that pagination is exhausted.
+      totalIsCapped: (data as { totalIsCapped?: boolean }).totalIsCapped === true,
       limit,
       offset,
     }

package/src/modules/customers/api/deals/map/route.ts

@@ -545,5 +545,6 @@ export async function GET(req: Request) {
     page: query.page,
     pageSize: query.pageSize,
     totalPages: Math.ceil(res.total / (query.pageSize || 1)),
+    ...(res.meta?.listCountCapWarning ? { totalIsCapped: true } : {}),
   })
 }

package/src/modules/customers/backend/customers/companies/page.tsx

@@ -118,6 +118,7 @@ type CompaniesResponse = {
   total?: number
   page?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 type DictionaryKindKey = CustomerDictionaryKind
@@ -198,6 +199,7 @@ export default function CustomersCompaniesPage() {
   const [sorting, setSorting] = React.useState<SortingState>([])
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const pathname = usePathname()
   const searchParams = useSearchParams()
@@ -422,6 +424,7 @@ export default function CustomersCompaniesPage() {
         setRows(items.map((item) => mapApiItem(item as Record<string, unknown>)).filter((row): row is CompanyRow => !!row))
         setTotal(typeof payload.total === 'number' ? payload.total : items.length)
         setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : 1)
+        setTotalIsCapped(payload?.totalIsCapped === true)
       } catch (err) {
         if (!cancelled) {
           setCacheStatus(null)
@@ -963,7 +966,7 @@ export default function CustomersCompaniesPage() {
             />
           )}
           virtualized
-          pagination={{ page, pageSize, total, totalPages, onPageChange: setPage, pageSizeOptions: [10, 25, 50, 100], onPageSizeChange: handlePageSizeChange, cacheStatus }}
+          pagination={{ page, pageSize, total, totalPages, totalIsCapped, onPageChange: setPage, pageSizeOptions: [10, 25, 50, 100], onPageSizeChange: handlePageSizeChange, cacheStatus }}
           isLoading={isLoading}
         />
         <AdvancedFilterPanel

package/src/modules/customers/backend/customers/deals/page.tsx

@@ -125,6 +125,7 @@ type DealsResponse = {
   items?: Array<Record<string, unknown>>
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 type FilterOption = { value: string; label: string }
@@ -210,6 +211,7 @@ export default function CustomersDealsPage() {
   const [sorting, setSorting] = React.useState<import('@tanstack/react-table').SortingState>([])
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState(() => searchParams?.get('search')?.trim() ?? '')
   const [isLoading, setIsLoading] = React.useState(false)
   const [reloadToken, setReloadToken] = React.useState(0)
@@ -397,6 +399,7 @@ export default function CustomersDealsPage() {
         setRows(mapped)
         setTotal(typeof payload.total === 'number' ? payload.total : mapped.length)
         setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : 1)
+        setTotalIsCapped(payload.totalIsCapped === true)
       } catch (err) {
         if (!cancelled) {
           setCacheStatus(null)
@@ -412,10 +415,12 @@ export default function CustomersDealsPage() {
   }, [queryParams, reloadToken, scopeVersion, t])
 
   React.useEffect(() => {
-    if (totalPages > 0 && page > totalPages) {
+    // A capped totalPages is a floor — pages past it hold reachable rows, so
+    // clamping would bounce a deep-linked user off data that exists.
+    if (!totalIsCapped && totalPages > 0 && page > totalPages) {
       setPage(totalPages)
     }
-  }, [page, totalPages])
+  }, [page, totalPages, totalIsCapped])
 
   const queryRef = React.useRef(searchParams?.toString() ?? '')
   React.useEffect(() => {
@@ -1136,6 +1141,7 @@ export default function CustomersDealsPage() {
             pageSize,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: (nextPage) => setPage(nextPage),
             pageSizeOptions: [10, 25, 50, 100],
             onPageSizeChange: handlePageSizeChange,

package/src/modules/customers/backend/customers/people/page.tsx

@@ -125,6 +125,7 @@ type PeopleResponse = {
   total?: number
   page?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 type DictionaryKindKey = CustomerDictionaryKind
@@ -206,6 +207,7 @@ export default function CustomersPeoplePage() {
   const [sorting, setSorting] = React.useState<SortingState>([])
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const pathname = usePathname()
   const searchParams = useSearchParams()
@@ -435,6 +437,7 @@ export default function CustomersPeoplePage() {
         setRows(items.map((item) => mapApiItem(item as Record<string, unknown>)).filter((row): row is PersonRow => !!row))
         setTotal(typeof payload.total === 'number' ? payload.total : items.length)
         setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : 1)
+        setTotalIsCapped(payload?.totalIsCapped === true)
       } catch (err) {
         if (!cancelled) {
           setCacheStatus(null)
@@ -990,7 +993,7 @@ export default function CustomersPeoplePage() {
             />
           )}
           virtualized
-          pagination={{ page, pageSize, total, totalPages, onPageChange: setPage, cacheStatus, pageSizeOptions: [10, 25, 50, 100], onPageSizeChange: handlePageSizeChange }}
+          pagination={{ page, pageSize, total, totalPages, totalIsCapped, onPageChange: setPage, cacheStatus, pageSizeOptions: [10, 25, 50, 100], onPageSizeChange: handlePageSizeChange }}
           isLoading={isLoading}
         />
         <AdvancedFilterPanel

package/src/modules/customers/components/CustomerTodosTable.tsx

@@ -47,6 +47,7 @@ type CustomerTodosResponse = {
   page: number
   pageSize: number
   totalPages: number
+  totalIsCapped?: boolean
 }
 
 const TASKS_TAB_QUERY = 'tab=tasks'
@@ -279,6 +280,7 @@ export function CustomerTodosTable(): React.JSX.Element {
         pageSize,
         total: data?.total ?? 0,
         totalPages: data?.totalPages ?? 0,
+        totalIsCapped: data?.totalIsCapped === true,
         onPageChange: setPage,
       }}
       isLoading={isLoading}

package/src/modules/data_sync/backend/data-sync/page.tsx

@@ -74,6 +74,7 @@ type ResponsePayload = {
   total: number
   page: number
   totalPages: number
+  totalIsCapped?: boolean
 }
 
 type SyncOption = {
@@ -153,6 +154,7 @@ export default function SyncRunsDashboardPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [filterValues, setFilterValues] = React.useState<FilterValues>({})
   const [isLoading, setIsLoading] = React.useState(true)
@@ -200,6 +202,7 @@ export default function SyncRunsDashboardPage() {
         setRows(Array.isArray(payload.items) ? payload.items : [])
         setTotal(payload.total || 0)
         setTotalPages(payload.totalPages || 1)
+        setTotalIsCapped(payload?.totalIsCapped === true)
         setIsLoading(false)
       }
     }
@@ -1065,7 +1068,7 @@ export default function SyncRunsDashboardPage() {
               }] : []),
             ]} />
           )}
-          pagination={{ page, pageSize: 20, total, totalPages, onPageChange: setPage }}
+          pagination={{ page, pageSize: 20, total, totalPages, totalIsCapped, onPageChange: setPage }}
           isLoading={isLoading}
         />
       </PageBody>

package/src/modules/devices/backend/devices/page.tsx

@@ -32,6 +32,7 @@ type ResponsePayload = {
   page?: number
   pageSize?: number
   totalPages: number
+  totalIsCapped?: boolean
 }
 
 function formatDate(value: string | null, t: (key: string) => string) {
@@ -50,6 +51,7 @@ export default function DevicesAdminListPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [isLoading, setIsLoading] = React.useState(true)
   const [reloadToken, setReloadToken] = React.useState(0)
   const scopeVersion = useOrganizationScopeVersion()
@@ -138,6 +140,7 @@ export default function DevicesAdminListPage() {
           setRows(Array.isArray(payload.items) ? payload.items : [])
           setTotal(payload.total || 0)
           setTotalPages(payload.totalPages || 1)
+          setTotalIsCapped(payload?.totalIsCapped === true)
         }
       } catch (error) {
         if (!cancelled) {
@@ -249,7 +252,7 @@ export default function DevicesAdminListPage() {
               { id: 'deactivate', label: t('devices.list.actions.deactivate'), destructive: true, onSelect: () => { void handleDeactivate(row) } },
             ]} />
           )}
-          pagination={{ page, pageSize: 50, total, totalPages, onPageChange: setPage }}
+          pagination={{ page, pageSize: 50, total, totalPages, totalIsCapped, onPageChange: setPage }}
           isLoading={isLoading}
         />
       </PageBody>