Project Data Utility

The Project Data utility provides functions for fetching project data from the AWS S3 Bucket. It serves as a data provider for the DataContext, enabling the application to access and display project information throughout the app.

Core Functionality

The utility exports a primary function:

fetchCSVFromS3

export const fetchCSVFromS3 = async () => {
  // Implementation details
};

This function:

1. Attempts to fetch project data from the API endpoint
2. Handles environment-specific URLs (development vs production)
3. Implements error handling with fallback to local CSV data
4. Returns structured project data for consumption by the DataContext

Implementation Details

The function follows a robust error-handling pattern:

1. Primary Request: Attempts to fetch data from the API endpoint
2. Uses localhost:5001/api/csv in development

3. Uses /api/csv in production

4. Fallback Mechanism: If the primary request fails, attempts to load local CSV data

5. Parses the CSV text into a structured object

6. Displays an error toast notification to inform the user

7. Final Error Handling: If both primary and fallback requests fail

8. Returns null to indicate failure
9. Displays an error toast notification

Integration with DataContext

The DataContext uses this utility to:

1. Fetch project data on initial application load
2. Refresh project data when requested by the user
3. Cache the returned data to minimize redundant API calls

Example usage within DataContext:

const getCsvData = useCallback(
  async (forceRefresh = false) => {
    // Check cache first unless forceRefresh is true
    if (csvData && !forceRefresh) {
      return csvData;
    }

    // Check for pending request
    if (pendingRequests.csv) {
      return pendingRequests.csv;
    }

    // Create new request
    const request = fetchCSVFromS3();
    pendingRequests.csv = request;

    try {
      const data = await request;
      setCsvData(data);
      return data;
    } finally {
      pendingRequests.csv = null;
    }
  },
  [csvData, pendingRequests]
);

Error Handling

The utility implements comprehensive error handling:

• Catches and logs network errors
• Provides user feedback via toast notifications
• Attempts to load fallback data when primary sources fail
• Returns null when all data sources are unavailable