From afa26914e33bfeaa51bf8d2c9f3907c1f39cbc86 Mon Sep 17 00:00:00 2001
From: Diksha Dabhole <dikshadabhole78@gmail.com>
Date: Sat, 23 May 2026 23:16:30 +0530
Subject: [PATCH] feat(issues): implement full-text search with ts_rank via RPC

---
 src/app/actions/issues.ts               | 18 +++++++++++++-----
 supabase/migrations/0012_issues_fts.sql | 17 +++++++++++++++++
 2 files changed, 30 insertions(+), 5 deletions(-)
 create mode 100644 supabase/migrations/0012_issues_fts.sql

diff --git a/src/app/actions/issues.ts b/src/app/actions/issues.ts
index 330504e..d37f718 100644
--- a/src/app/actions/issues.ts
+++ b/src/app/actions/issues.ts
@@ -130,19 +130,27 @@ export async function getIssuesPage(filters: IssueFilter): Promise<Result<Issues
   const from = (page - 1) * PAGE_SIZE;
   const to = from + PAGE_SIZE - 1;
 
-  let query = service
-    .from('issues')
+  const isSearch = !!filters.search?.trim();
+
+  // Cast to any to avoid complex union type builder errors between rpc and from
+  let query: any = isSearch
+    ? service.rpc('search_issues', { search_query: filters.search!.trim() })
+    : service.from('issues');
+
+  query = query
     .select(
       'id, repo_full_name, github_issue_number, title, difficulty, xp_reward, labels, state, url, fetched_at',
       { count: 'exact' },
     )
     .eq('state', filters.state ?? 'open')
-    .order('fetched_at', { ascending: false })
     .range(from, to);
 
-  if (filters.search?.trim()) {
-    query = query.ilike('title', `%${filters.search.trim()}%`);
+  // When searching via RPC, results are naturally ordered by rank (from the SQL function).
+  // Otherwise, we order by fetched_at descending.
+  if (!isSearch) {
+    query = query.order('fetched_at', { ascending: false });
   }
+
   if (filters.difficulty) {
     query = query.eq('difficulty', filters.difficulty);
   }
diff --git a/supabase/migrations/0012_issues_fts.sql b/supabase/migrations/0012_issues_fts.sql
new file mode 100644
index 0000000..9c47d51
--- /dev/null
+++ b/supabase/migrations/0012_issues_fts.sql
@@ -0,0 +1,17 @@
+-- Migration to add FTS column, index, and RPC for searching and ranking
+ALTER TABLE issues ADD COLUMN fts tsvector 
+  GENERATED ALWAYS AS (to_tsvector('english', coalesce(title, '') || ' ' || coalesce(body_excerpt, ''))) STORED;
+
+CREATE INDEX issues_fts_idx ON issues USING GIN(fts);
+
+-- Function to allow PostgREST to search issues and sort by ts_rank
+CREATE OR REPLACE FUNCTION search_issues(search_query text)
+RETURNS SETOF issues
+LANGUAGE sql
+STABLE
+AS $$
+  SELECT *
+  FROM issues
+  WHERE fts @@ plainto_tsquery('english', search_query)
+  ORDER BY ts_rank(fts, plainto_tsquery('english', search_query)) DESC;
+$$;