@react-spa-scaffold/mcp 2.2.0 → 2.3.0

package/templates/src/test/supabaseMock.ts

@@ -0,0 +1,112 @@
+/**
+ * Supabase mocks for testing.
+ *
+ * Provides mock implementations of the Supabase context and client,
+ * with state controls for testing different scenarios.
+ */
+
+import type { ReactNode } from 'react';
+import { vi } from 'vitest';
+
+// Re-export fixtures for test convenience
+export { createProfile, createProfiles, mockProfiles } from '@/mocks/fixtures/profiles';
+export type { Profile } from '@/types/database';
+
+// =============================================================================
+// Mock State
+// =============================================================================
+
+interface SupabaseMockState {
+  data: unknown[];
+  error: { message: string; code: string } | null;
+}
+
+const defaultState: SupabaseMockState = {
+  data: [],
+  error: null,
+};
+
+let mockState: SupabaseMockState = { ...defaultState };
+
+// =============================================================================
+// State Controls
+// =============================================================================
+
+/** Set mock data to be returned by Supabase queries */
+export function setMockSupabaseData(data: unknown[]) {
+  mockState.data = data;
+}
+
+/** Set a mock error to be returned by Supabase queries */
+export function setMockSupabaseError(error: { message: string; code: string } | null) {
+  mockState.error = error;
+}
+
+/** Reset all Supabase mocks to default state */
+export function resetSupabaseMocks() {
+  mockState = { ...defaultState };
+}
+
+// =============================================================================
+// Mock Query Builder
+// =============================================================================
+
+function createMockQueryBuilder() {
+  const resolveQuery = () => {
+    if (mockState.error) {
+      return { data: null, error: mockState.error };
+    }
+    return { data: mockState.data, error: null };
+  };
+
+  const resolveSingle = () => {
+    if (mockState.error) {
+      return { data: null, error: mockState.error };
+    }
+    return { data: mockState.data[0] ?? null, error: null };
+  };
+
+  return {
+    select: vi.fn().mockReturnThis(),
+    insert: vi.fn().mockReturnThis(),
+    update: vi.fn().mockReturnThis(),
+    delete: vi.fn().mockReturnThis(),
+    upsert: vi.fn().mockReturnThis(),
+    eq: vi.fn().mockReturnThis(),
+    neq: vi.fn().mockReturnThis(),
+    single: vi.fn().mockImplementation(() => Promise.resolve(resolveSingle())),
+    maybeSingle: vi.fn().mockImplementation(() => Promise.resolve(resolveSingle())),
+    then: (resolve: (value: { data: unknown[] | null; error: unknown }) => void) => {
+      resolve(resolveQuery());
+      return { catch: () => {} };
+    },
+  };
+}
+
+// =============================================================================
+// Mock Supabase Client
+// =============================================================================
+
+/** Create a mock Supabase client for testing */
+export function createMockSupabaseClient() {
+  return {
+    from: vi.fn().mockReturnValue(createMockQueryBuilder()),
+  };
+}
+
+// Singleton client instance for useSupabase hook (maintains referential equality)
+const mockClientInstance = createMockSupabaseClient();
+
+// =============================================================================
+// Mock Context (for vi.mock)
+// =============================================================================
+
+/** Mock SupabaseProvider - passes through children */
+export function SupabaseProvider({ children }: { children: ReactNode }) {
+  return children;
+}
+
+/** Mock useSupabase hook - returns stable client instance */
+export function useSupabase() {
+  return mockClientInstance;
+}

package/templates/src/test-setup.ts

@@ -1,8 +1,30 @@
 import '@testing-library/jest-dom/vitest';
 import { afterAll, afterEach, beforeAll, vi } from 'vitest';
 
+// =============================================================================
+// Environment Variable Mock (must be mocked before any imports that use env.ts)
+// =============================================================================
+vi.mock('@/lib/env', () => ({
+  env: {
+    VITE_APP_NAME: 'My App',
+    VITE_APP_URL: 'http://localhost:5173',
+    VITE_API_URL: 'https://jsonplaceholder.typicode.com',
+    VITE_SENTRY_DSN: 'https://test@sentry.io/123',
+    VITE_SENTRY_ENABLED: false,
+    VITE_CLERK_PUBLISHABLE_KEY: 'pk_test_mock',
+    VITE_SUPABASE_DATABASE_URL: 'https://test.supabase.co',
+    VITE_SUPABASE_ANON_KEY: 'test-anon-key',
+    VITE_PERF_TEST: false,
+    MODE: 'test',
+    DEV: false,
+    PROD: false,
+  },
+  validateEnv: vi.fn(),
+}));
+
 import { server } from '@/mocks/node';
 import { resetClerkMocks } from '@/test/clerkMock';
+import { resetSupabaseMocks } from '@/test/supabaseMock';
 
 // =============================================================================
 // Module Mocks
@@ -16,6 +38,9 @@ vi.mock('@clerk/themes', () => ({
   shadcn: { baseTheme: 'shadcn' },
 }));
 
+// Mock Supabase context with test client
+vi.mock('@/contexts/supabaseContext', async () => import('@/test/supabaseMock'));
+
 // =============================================================================
 // MSW Server Setup
 // =============================================================================
@@ -31,6 +56,7 @@ beforeAll(() => {
 afterEach(() => {
   server.resetHandlers();
   resetClerkMocks();
+  resetSupabaseMocks();
 });
 
 // Close MSW server after all tests complete

package/templates/src/types/database.ts

@@ -0,0 +1,46 @@
+/**
+ * Database type aliases and re-exports.
+ *
+ * This file provides a database-agnostic public API for type imports.
+ * The underlying types are auto-generated in supabase.ts via `npm run db:types`.
+ *
+ * Usage:
+ *   import type { Profile, ProfileInsert, ProfileUpdate } from '@/types/database';
+ *
+ * When adding new tables:
+ *   1. Run `npm run db:types` to regenerate supabase.ts
+ *   2. Add convenience aliases here for your new tables
+ */
+
+// Re-export everything from the auto-generated Supabase types
+export * from './supabase';
+
+// Re-import for creating aliases
+import type { Database, Tables, TablesInsert, TablesUpdate } from './supabase';
+
+// =============================================================================
+// Generic Table Types
+// =============================================================================
+
+/**
+ * Table names available in the database schema.
+ */
+export type TableName = keyof Database['public']['Tables'];
+
+/**
+ * Row type for a given table.
+ */
+export type TableRowType<T extends TableName> = Database['public']['Tables'][T]['Row'];
+
+// =============================================================================
+// Profile Types
+// =============================================================================
+
+/** Profile row type (read operations) */
+export type Profile = Tables<'profiles'>;
+
+/** Profile insert type (create operations) */
+export type ProfileInsert = TablesInsert<'profiles'>;
+
+/** Profile update type (update operations) */
+export type ProfileUpdate = TablesUpdate<'profiles'>;

package/templates/src/types/index.ts

@@ -1,2 +1,3 @@
 export * from './preferences';
 export * from './api';
+export * from './database';

package/templates/src/types/supabase.ts

@@ -0,0 +1,167 @@
+export type Json = string | number | boolean | null | { [key: string]: Json | undefined } | Json[];
+
+export type Database = {
+  // Allows to automatically instantiate createClient with right options
+  // instead of createClient<Database, { PostgrestVersion: 'XX' }>(URL, KEY)
+  __InternalSupabase: {
+    PostgrestVersion: '14.1';
+  };
+  public: {
+    Tables: {
+      profiles: {
+        Row: {
+          avatar_url: string | null;
+          created_at: string | null;
+          email: string;
+          full_name: string | null;
+          id: string;
+          updated_at: string | null;
+        };
+        Insert: {
+          avatar_url?: string | null;
+          created_at?: string | null;
+          email: string;
+          full_name?: string | null;
+          id: string;
+          updated_at?: string | null;
+        };
+        Update: {
+          avatar_url?: string | null;
+          created_at?: string | null;
+          email?: string;
+          full_name?: string | null;
+          id?: string;
+          updated_at?: string | null;
+        };
+        Relationships: [];
+      };
+    };
+    Views: {
+      [_ in never]: never;
+    };
+    Functions: {
+      [_ in never]: never;
+    };
+    Enums: {
+      [_ in never]: never;
+    };
+    CompositeTypes: {
+      [_ in never]: never;
+    };
+  };
+};
+
+type DatabaseWithoutInternals = Omit<Database, '__InternalSupabase'>;
+
+type DefaultSchema = DatabaseWithoutInternals[Extract<keyof Database, 'public'>];
+
+export type Tables<
+  DefaultSchemaTableNameOrOptions extends
+    | keyof (DefaultSchema['Tables'] & DefaultSchema['Views'])
+    | { schema: keyof DatabaseWithoutInternals },
+  TableName extends DefaultSchemaTableNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+  }
+    ? keyof (DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Tables'] &
+        DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Views'])
+    : never = never,
+> = DefaultSchemaTableNameOrOptions extends {
+  schema: keyof DatabaseWithoutInternals;
+}
+  ? (DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Tables'] &
+      DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Views'])[TableName] extends {
+      Row: infer R;
+    }
+    ? R
+    : never
+  : DefaultSchemaTableNameOrOptions extends keyof (DefaultSchema['Tables'] & DefaultSchema['Views'])
+    ? (DefaultSchema['Tables'] & DefaultSchema['Views'])[DefaultSchemaTableNameOrOptions] extends {
+        Row: infer R;
+      }
+      ? R
+      : never
+    : never;
+
+export type TablesInsert<
+  DefaultSchemaTableNameOrOptions extends keyof DefaultSchema['Tables'] | { schema: keyof DatabaseWithoutInternals },
+  TableName extends DefaultSchemaTableNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+  }
+    ? keyof DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Tables']
+    : never = never,
+> = DefaultSchemaTableNameOrOptions extends {
+  schema: keyof DatabaseWithoutInternals;
+}
+  ? DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Tables'][TableName] extends {
+      Insert: infer I;
+    }
+    ? I
+    : never
+  : DefaultSchemaTableNameOrOptions extends keyof DefaultSchema['Tables']
+    ? DefaultSchema['Tables'][DefaultSchemaTableNameOrOptions] extends {
+        Insert: infer I;
+      }
+      ? I
+      : never
+    : never;
+
+export type TablesUpdate<
+  DefaultSchemaTableNameOrOptions extends keyof DefaultSchema['Tables'] | { schema: keyof DatabaseWithoutInternals },
+  TableName extends DefaultSchemaTableNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+  }
+    ? keyof DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Tables']
+    : never = never,
+> = DefaultSchemaTableNameOrOptions extends {
+  schema: keyof DatabaseWithoutInternals;
+}
+  ? DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions['schema']]['Tables'][TableName] extends {
+      Update: infer U;
+    }
+    ? U
+    : never
+  : DefaultSchemaTableNameOrOptions extends keyof DefaultSchema['Tables']
+    ? DefaultSchema['Tables'][DefaultSchemaTableNameOrOptions] extends {
+        Update: infer U;
+      }
+      ? U
+      : never
+    : never;
+
+export type Enums<
+  DefaultSchemaEnumNameOrOptions extends keyof DefaultSchema['Enums'] | { schema: keyof DatabaseWithoutInternals },
+  EnumName extends DefaultSchemaEnumNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+  }
+    ? keyof DatabaseWithoutInternals[DefaultSchemaEnumNameOrOptions['schema']]['Enums']
+    : never = never,
+> = DefaultSchemaEnumNameOrOptions extends {
+  schema: keyof DatabaseWithoutInternals;
+}
+  ? DatabaseWithoutInternals[DefaultSchemaEnumNameOrOptions['schema']]['Enums'][EnumName]
+  : DefaultSchemaEnumNameOrOptions extends keyof DefaultSchema['Enums']
+    ? DefaultSchema['Enums'][DefaultSchemaEnumNameOrOptions]
+    : never;
+
+export type CompositeTypes<
+  PublicCompositeTypeNameOrOptions extends
+    | keyof DefaultSchema['CompositeTypes']
+    | { schema: keyof DatabaseWithoutInternals },
+  CompositeTypeName extends PublicCompositeTypeNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+  }
+    ? keyof DatabaseWithoutInternals[PublicCompositeTypeNameOrOptions['schema']]['CompositeTypes']
+    : never = never,
+> = PublicCompositeTypeNameOrOptions extends {
+  schema: keyof DatabaseWithoutInternals;
+}
+  ? DatabaseWithoutInternals[PublicCompositeTypeNameOrOptions['schema']]['CompositeTypes'][CompositeTypeName]
+  : PublicCompositeTypeNameOrOptions extends keyof DefaultSchema['CompositeTypes']
+    ? DefaultSchema['CompositeTypes'][PublicCompositeTypeNameOrOptions]
+    : never;
+
+export const Constants = {
+  public: {
+    Enums: {},
+  },
+} as const;

package/templates/src/vite-env.d.ts

@@ -3,6 +3,12 @@
 interface ImportMetaEnv {
   readonly VITE_APP_NAME: string;
   readonly VITE_APP_URL: string;
+  readonly VITE_API_URL?: string;
+  readonly VITE_SENTRY_DSN?: string;
+  readonly VITE_CLERK_PUBLISHABLE_KEY?: string;
+  readonly MODE: 'development' | 'production' | 'test';
+  readonly DEV: boolean;
+  readonly PROD: boolean;
 }
 
 interface ImportMeta {

package/templates/supabase/migrations/20260104000000_create_profiles_table.sql

@@ -0,0 +1,67 @@
+-- ============================================================
+-- PROFILES TABLE (linked to Clerk user_id)
+-- ============================================================
+
+-- Create the table
+CREATE TABLE IF NOT EXISTS profiles (
+  id TEXT PRIMARY KEY,              -- Clerk user_id (from auth.uid())
+  email TEXT NOT NULL,
+  full_name TEXT,
+  avatar_url TEXT,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Enable Row Level Security
+ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;
+
+-- ============================================================
+-- RLS POLICIES
+-- Using auth.jwt()->>'sub' for Clerk compatibility (string IDs)
+-- ============================================================
+
+-- Users can view their own profile
+-- NOTE: Using auth.jwt()->>'sub' instead of auth.uid() because
+-- Clerk user IDs are strings (e.g., user_xxx), not UUIDs
+CREATE POLICY "Users can view own profile"
+  ON profiles FOR SELECT TO authenticated
+  USING (id = (select auth.jwt()->>'sub'));
+
+-- Users can insert their own profile (first login)
+CREATE POLICY "Users can insert own profile"
+  ON profiles FOR INSERT TO authenticated
+  WITH CHECK (id = (select auth.jwt()->>'sub'));
+
+-- Users can update their own profile
+CREATE POLICY "Users can update own profile"
+  ON profiles FOR UPDATE TO authenticated
+  USING (id = (select auth.jwt()->>'sub'))
+  WITH CHECK (id = (select auth.jwt()->>'sub'));
+
+-- Users can delete their own profile
+CREATE POLICY "Users can delete own profile"
+  ON profiles FOR DELETE TO authenticated
+  USING (id = (select auth.jwt()->>'sub'));
+
+-- ============================================================
+-- AUTO-UPDATE TIMESTAMP TRIGGER
+-- ============================================================
+
+-- Function to update updated_at (with secure search_path)
+CREATE OR REPLACE FUNCTION public.update_updated_at()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = ''
+AS $$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+$$;
+
+-- Trigger for profiles
+CREATE TRIGGER profiles_updated_at
+  BEFORE UPDATE ON profiles
+  FOR EACH ROW
+  EXECUTE FUNCTION update_updated_at();