From b666a6d9795bc414fbbdcd07aa3578f81af3f9b3 Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:39:22 +0200 Subject: [PATCH 1/8] Add actionable Supabase task load diagnostics --- src/lib/taskLoadError.ts | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 src/lib/taskLoadError.ts diff --git a/src/lib/taskLoadError.ts b/src/lib/taskLoadError.ts new file mode 100644 index 0000000..a366138 --- /dev/null +++ b/src/lib/taskLoadError.ts @@ -0,0 +1,21 @@ +type SupabaseTaskError = { code?: string; message?: string; details?: string; hint?: string } + +export function getTaskLoadErrorMessage(error: unknown): string { + const value = (error && typeof error === 'object' ? error : {}) as SupabaseTaskError + const code = value.code || '' + const message = value.message || (error instanceof Error ? error.message : '') + + if (code === '42P01' || code === 'PGRST205' || /relation .*tasks.* does not exist|could not find the table .*tasks/i.test(message)) { + return 'The tasks table is missing from this Supabase project. Apply supabase/migrations/20250915000000_initial_schema.sql in the Supabase SQL Editor, then reload the app.' + } + if (code === '42501' || /permission denied|row-level security|violates row-level security/i.test(message)) { + return 'Supabase denied access to the tasks table. Check that the tasks RLS policies from the Taskflow migration are installed and that you are signed in with the correct account.' + } + if (code === 'PGRST301' || code === '401' || /invalid jwt|jwt expired|invalid token/i.test(message)) { + return 'Your Supabase session or public API key is invalid or expired. Sign out and sign in again, then verify the Vercel Supabase URL and anon/publishable key.' + } + if (/failed to fetch|networkerror|fetch failed|name_not_resolved/i.test(message)) { + return 'The browser cannot reach Supabase. Check the VITE_SUPABASE_URL in Vercel, the project status, and your network connection.' + } + return message || 'Unknown Supabase error. Verify the Vercel environment variables and Supabase project configuration.' +} From b9a5364159593af2249c86c811f5b3dd6e8d746e Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:39:25 +0200 Subject: [PATCH 2/8] Test actionable Supabase task load diagnostics --- src/lib/taskLoadError.test.ts | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 src/lib/taskLoadError.test.ts diff --git a/src/lib/taskLoadError.test.ts b/src/lib/taskLoadError.test.ts new file mode 100644 index 0000000..b12a4bb --- /dev/null +++ b/src/lib/taskLoadError.test.ts @@ -0,0 +1,17 @@ +import { describe, expect, it } from 'vitest' +import { getTaskLoadErrorMessage } from './taskLoadError' + +describe('getTaskLoadErrorMessage', () => { + it('explains when the hosted tasks table has not been migrated', () => { + expect(getTaskLoadErrorMessage({ code: '42P01', message: 'relation "public.tasks" does not exist' })).toContain('Apply supabase/migrations/20250915000000_initial_schema.sql') + }) + it('explains RLS and permission failures', () => { + expect(getTaskLoadErrorMessage({ code: '42501', message: 'permission denied for table tasks' })).toContain('RLS policies') + }) + it('explains invalid session or API key errors', () => { + expect(getTaskLoadErrorMessage({ code: 'PGRST301', message: 'JWT expired' })).toContain('Sign out and sign in again') + }) + it('explains network failures without hiding the actual problem', () => { + expect(getTaskLoadErrorMessage(new Error('Failed to fetch'))).toContain('cannot reach Supabase') + }) +}) From ad8fe3d40db24d7f9714c0a19333a0f6a8e421ba Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:39:30 +0200 Subject: [PATCH 3/8] Show actionable Supabase task load failure details --- src/pages/TasksPage.tsx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/pages/TasksPage.tsx b/src/pages/TasksPage.tsx index 541a71a..8299eaa 100644 --- a/src/pages/TasksPage.tsx +++ b/src/pages/TasksPage.tsx @@ -7,6 +7,7 @@ import { TaskForm } from '../components/TaskForm' import { EmptyState } from '../components/EmptyState' import type { Task, TaskInput, TaskPriority, TaskStatus } from '../types' import { filterAndSortTasks, paginateTasks } from '../lib/taskFilters' +import { getTaskLoadErrorMessage } from '../lib/taskLoadError' export function TasksPage() { const {user}=useAuth() @@ -28,7 +29,7 @@ export function TasksPage() {
- {isLoading?
Loading tasks…
:error?
Couldn’t load your tasks. Check your Supabase connection and try again.
:shown.length===0?0} onAdd={()=>setOpen(true)}/>:view==='board'?updateStatus.mutate({taskId,status})}/>:<>
{paginateTasks(shown,visibleCount).map(task=>updateStatus.mutate({taskId:task.id,status})} onEdit={()=>{setEditing(task);setOpen(true)}} onDelete={()=>removeTask(task)}/>)}
{shown.length>visibleCount&&
{Math.min(visibleCount,shown.length)} of {shown.length}
}} + {isLoading?
Loading tasks…
:error?
Couldn’t load your tasks. {getTaskLoadErrorMessage(error)}
:shown.length===0?0} onAdd={()=>setOpen(true)}/>:view==='board'?updateStatus.mutate({taskId,status})}/>:<>
{paginateTasks(shown,visibleCount).map(task=>updateStatus.mutate({taskId:task.id,status})} onEdit={()=>{setEditing(task);setOpen(true)}} onDelete={()=>removeTask(task)}/>)}
{shown.length>visibleCount&&
{Math.min(visibleCount,shown.length)} of {shown.length}
}} {open&&
{setOpen(false);setEditing(null)}} isSaving={create.isPending||update.isPending}/>
} From 2413dbe95748ca58bfb8511e7c65e58425a9211b Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:40:26 +0200 Subject: [PATCH 4/8] Recover safely from malformed local demo task storage --- src/services/tasks.ts | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/src/services/tasks.ts b/src/services/tasks.ts index 427e6d3..4cfa125 100644 --- a/src/services/tasks.ts +++ b/src/services/tasks.ts @@ -4,8 +4,27 @@ import type { Task, TaskInput, TaskStatus } from '../types' const demoTasksKey = 'taskflow-demo-tasks' function readDemoTasks(userId: string): Task[] { - const stored = localStorage.getItem(demoTasksKey) - return stored ? (JSON.parse(stored) as Task[]).filter((task) => task.user_id === userId) : [] + let stored: string | null + try { + stored = localStorage.getItem(demoTasksKey) + } catch { + throw new Error('Browser storage is unavailable. Enable site storage for Taskflow and reload the page.') + } + if (!stored) return [] + try { + const parsed: unknown = JSON.parse(stored) + if (!Array.isArray(parsed)) throw new Error('Stored tasks are not a list') + return (parsed as Task[]).filter((task) => task && task.user_id === userId) + } catch { + // Preserve the malformed value for recovery, then reset only the Taskflow tasks key. + try { + localStorage.setItem('taskflow-demo-tasks-corrupt-backup', stored) + localStorage.removeItem(demoTasksKey) + } catch { + throw new Error('Taskflow demo data is unreadable and browser storage cannot repair it. Enable site storage, then reload.') + } + return [] + } } function writeDemoTasks(tasks: Task[]) { localStorage.setItem(demoTasksKey, JSON.stringify(tasks)) } From 180ccdbf2ce3991e589e9ad5fe54d777026b1fa9 Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:40:28 +0200 Subject: [PATCH 5/8] Test recovery from corrupted browser demo data --- src/services/tasks.test.ts | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/services/tasks.test.ts b/src/services/tasks.test.ts index 5eed256..6f7edce 100644 --- a/src/services/tasks.test.ts +++ b/src/services/tasks.test.ts @@ -23,6 +23,12 @@ describe('demo task CRUD and ownership',()=>{ expect(await listTasks('u1')).toHaveLength(1) expect(await listTasks('u2')).toHaveLength(0) }) + it('recovers from malformed local task storage without crashing the tasks page',async()=>{ + localStorage.setItem('taskflow-demo-tasks','{not valid json') + expect(await listTasks('u1')).toEqual([]) + expect(localStorage.getItem('taskflow-demo-tasks')).toBeNull() + expect(localStorage.getItem('taskflow-demo-tasks-corrupt-backup')).toBe('{not valid json') + }) it('supports status updates through the same owner-scoped update path',async()=>{ localStorage.setItem('taskflow-demo-tasks',JSON.stringify([task])) await (await import('./tasks')).updateTaskStatus('u1','task-1','done') From 7b05b0fd0e6c2fc822126c162c424c7b2021c184 Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:40:30 +0200 Subject: [PATCH 6/8] Distinguish local demo storage errors from Supabase failures --- src/lib/taskLoadError.ts | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/lib/taskLoadError.ts b/src/lib/taskLoadError.ts index a366138..e8ead40 100644 --- a/src/lib/taskLoadError.ts +++ b/src/lib/taskLoadError.ts @@ -1,6 +1,10 @@ type SupabaseTaskError = { code?: string; message?: string; details?: string; hint?: string } -export function getTaskLoadErrorMessage(error: unknown): string { +export function getTaskLoadErrorMessage(error: unknown, demoMode = false): string { + if (demoMode) { + const message = error instanceof Error ? error.message : '' + return message || 'Taskflow could not read browser storage. Enable site storage and reload the page.' + } const value = (error && typeof error === 'object' ? error : {}) as SupabaseTaskError const code = value.code || '' const message = value.message || (error instanceof Error ? error.message : '') From 5d49ace55390a7559e79bbd4f5d381a1b3ac12f9 Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:40:32 +0200 Subject: [PATCH 7/8] Report correct data source in task load error feedback --- src/pages/TasksPage.tsx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/pages/TasksPage.tsx b/src/pages/TasksPage.tsx index 8299eaa..7c23e1e 100644 --- a/src/pages/TasksPage.tsx +++ b/src/pages/TasksPage.tsx @@ -8,6 +8,7 @@ import { EmptyState } from '../components/EmptyState' import type { Task, TaskInput, TaskPriority, TaskStatus } from '../types' import { filterAndSortTasks, paginateTasks } from '../lib/taskFilters' import { getTaskLoadErrorMessage } from '../lib/taskLoadError' +import { isDemoMode } from '../lib/supabase' export function TasksPage() { const {user}=useAuth() @@ -29,7 +30,7 @@ export function TasksPage() {
- {isLoading?
Loading tasks…
:error?
Couldn’t load your tasks. {getTaskLoadErrorMessage(error)}
:shown.length===0?0} onAdd={()=>setOpen(true)}/>:view==='board'?updateStatus.mutate({taskId,status})}/>:<>
{paginateTasks(shown,visibleCount).map(task=>updateStatus.mutate({taskId:task.id,status})} onEdit={()=>{setEditing(task);setOpen(true)}} onDelete={()=>removeTask(task)}/>)}
{shown.length>visibleCount&&
{Math.min(visibleCount,shown.length)} of {shown.length}
}} + {isLoading?
Loading tasks…
:error?
Couldn’t load your tasks. {getTaskLoadErrorMessage(error, isDemoMode)}
:shown.length===0?0} onAdd={()=>setOpen(true)}/>:view==='board'?updateStatus.mutate({taskId,status})}/>:<>
{paginateTasks(shown,visibleCount).map(task=>updateStatus.mutate({taskId:task.id,status})} onEdit={()=>{setEditing(task);setOpen(true)}} onDelete={()=>removeTask(task)}/>)}
{shown.length>visibleCount&&
{Math.min(visibleCount,shown.length)} of {shown.length}
}} {open&&
{setOpen(false);setEditing(null)}} isSaving={create.isPending||update.isPending}/>
} From 3b33625a354e8638bdac5339df16e5371ba11e80 Mon Sep 17 00:00:00 2001 From: adam gomaa Date: Sat, 7 Nov 2026 11:40:38 +0200 Subject: [PATCH 8/8] Test demo-mode storage error messaging --- src/lib/taskLoadError.test.ts | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/lib/taskLoadError.test.ts b/src/lib/taskLoadError.test.ts index b12a4bb..af9c82c 100644 --- a/src/lib/taskLoadError.test.ts +++ b/src/lib/taskLoadError.test.ts @@ -2,6 +2,9 @@ import { describe, expect, it } from 'vitest' import { getTaskLoadErrorMessage } from './taskLoadError' describe('getTaskLoadErrorMessage', () => { + it('does not blame Supabase when the app is using local demo storage', () => { + expect(getTaskLoadErrorMessage(new Error('Browser storage is unavailable'), true)).toContain('Browser storage is unavailable') + }) it('explains when the hosted tasks table has not been migrated', () => { expect(getTaskLoadErrorMessage({ code: '42P01', message: 'relation "public.tasks" does not exist' })).toContain('Apply supabase/migrations/20250915000000_initial_schema.sql') })