agent foundation

lib/Support/Search/SearchSqlResourceProvider.php

@@ -4,6 +4,8 @@ namespace MintyPHP\Support\Search;
 
 use MintyPHP\Service\Access\PermissionService;
 
+// Defines all SQL-backed search resources. Each resource declares count/preview/result queries
+// with a {{tenantFilter}} placeholder that is substituted at query time based on the user's tenant scope.
 class SearchSqlResourceProvider
 {
     public static function tenantScopeFilters(): array
@@ -25,6 +27,7 @@ class SearchSqlResourceProvider
                 'key' => 'address-book',
                 'label' => t('Address book'),
                 'permission' => PermissionService::ADDRESS_BOOK_VIEW,
+                // escape '\\\\' — four backslashes: PHP reduces to two, SQL reduces to one literal backslash escape char.
                 'countSql' => "select count(*) from users where active = 1 and (first_name like ? escape '\\\\' or last_name like ? escape '\\\\' or email like ? escape '\\\\') {{tenantFilter}}",
                 'countParams' => [$like, $like, $like],
                 'previewSql' => "select uuid, first_name, last_name, email from users where active = 1 and (first_name like ? escape '\\\\' or last_name like ? escape '\\\\' or email like ? escape '\\\\') {{tenantFilter}} order by last_name, first_name limit ?",