* Protected API route to update selection description
 * 
 * @route PATCH /api/files/selections/:selectionId/description
 * @authentication Required
 * @param {string} selectionId - Selection ID from URL parameter
 * @param {Object} body - Request body containing description
 * @returns {Object} Response containing updated selection
 * @error 400 - If selectionId is invalid or description is missing
 * @error 403 - If user doesn't have EDIT permission for the dataset
 * @error 404 - If selection not found
 * @error 500 - If database operation fails
 * @description Updates the description for a specific selection
 */
files.patch("/selections/:selectionId/description", authenticate, async (c) => {
  try {
    const jwtPayload = (c as unknown as { jwtPayload: JWTPayload }).jwtPayload;
    const userId = jwtPayload.sub;
    
    const selectionId = c.req.param("selectionId");
    
    // Validate selection ID format
    if (!isValidFileId(selectionId)) {
      return c.json({
        error: "Invalid selection ID format"
      }, 400);
    }
    
    // Parse request body
    const body = await c.req.json();
    const { description } = body;
    
    if (typeof description !== 'string') {
      return c.json({
        error: "Missing or invalid description"
      }, 400);
    }
    
    // Connect to database
    const db = createDatabase(c.env);
    
    // Get selection and dataset info for permission check
    const selectionResult = await db
      .select({
        id: selection.id,
        datasetId: selection.datasetId,
        active: selection.active
      })
      .from(selection)
      .where(eq(selection.id, selectionId))
      .limit(1);
    
    if (selectionResult.length === 0) {
      return c.json({
        error: "Selection not found"
      }, 404);
    }
    
    const selectionRecord = selectionResult[0];
    
    if (!selectionRecord.active) {
      return c.json({
        error: "Selection is not active"
      }, 404);
    }
    
    // Check if user has EDIT permission for this dataset
    const hasPermission = await checkUserPermission(db, userId, selectionRecord.datasetId, 'EDIT');
    
    if (!hasPermission) {
      return c.json({
        error: "Access denied: No EDIT permission for this dataset"
      }, 403);
    }
    
    // Update the selection description
    await db
      .update(selection)
      .set({
        description: description || null,
        lastModified: new Date(),
        modifiedBy: userId
      })
      .where(eq(selection.id, selectionId));
    
    return c.json({
      data: {
        selectionId,
        description
      }
    });
    
  } catch (error) {
    return c.json(standardErrorResponse(error, "updating selection description"), 500);
  }
});
/**

    fieldType: 'description' | 'distance' | 'note' | 'species' | 'callType',

    fieldType: 'description' | 'distance' | 'note' | 'species' | 'callType' | 'speciesCertainty' | 'callTypeCertainty',

            <option value="close">Close</option>
            <option value="ok">OK</option>
            <option value="far">Far</option>

            <option value="close">close</option>
            <option value="ok">ok</option>
            <option value="far">far</option>

      
      case 'speciesCertainty':
      case 'callTypeCertainty':
        return (
          <input
            type="number"
            min="0"
            max="100"
            step="0.1"
            value={String(state.editingData[fieldKey] || "")}
            onChange={(e) => handleFieldChange(fieldKey, e.target.value ? parseFloat(e.target.value) : null)}
            className="w-full px-2 py-1 text-sm border border-gray-300 rounded focus:outline-none focus:ring-1 focus:ring-blue-500"
            placeholder="0-100"
          />
        );

      // Save description
      const descriptionResponse = await fetch(`/api/files/selections/${state.editingSelectionId}/description`, {
        method: 'PATCH',
        headers: {
          'Authorization': `Bearer ${accessToken}`,
          'Content-Type': 'application/json',
        },
        body: JSON.stringify({
          description: state.editingData.description
        }),
      });
      if (!descriptionResponse.ok) {
        throw new Error('Failed to update description');
      }

                                      {species.certainty
                                        ? `${species.certainty.toFixed(1)}%`
                                        : "N/A"}

                                      {renderEditableField(selection, 'speciesCertainty', species.certainty ? `${species.certainty.toFixed(1)}%` : "N/A", 'speciesCertainty')}

                                    {species.certainty
                                      ? `${species.certainty.toFixed(1)}%`
                                      : "N/A"}

                                    {renderEditableField(selection, 'speciesCertainty', species.certainty ? `${species.certainty.toFixed(1)}%` : "N/A", 'speciesCertainty')}

                                    {callType.certainty
                                      ? `${callType.certainty.toFixed(1)}%`
                                      : "N/A"}

                                    {renderEditableField(selection, 'callTypeCertainty', callType.certainty ? `${callType.certainty.toFixed(1)}%` : "N/A", 'callTypeCertainty')}

[ ] deletable selections