Add upsert option to client API to move an existing file

[cohlar]

It'd be nice to have an upsert option in the supabase.storage.from().move() function, that would replace the existing file instead of firing a StorageApiError: The resource already exists error.

Sharing my code for this purpose in case it helps anyone:

async function supabaseStorageUpsertMove(bucket: string, fromPath: string, toPath: string) {
  try {
    const response = await supabase.storage.from(bucket).move(fromPath, toPath);
    if (response.error) throw response.error;
    return response;
  } catch (error) {
    if (error instanceof Error && error.name == 'StorageApiError') {
      if (error.message === 'The resource already exists') {
        const { error: fileDeleteError } = await supabase.storage.from('spapi').remove([toPath]);
        if (fileDeleteError) return { data: null, error: fileDeleteError };
        const { error: fileMoveError } = await supabase.storage.from('spapi').move(fromPath, toPath);
        if (fileMoveError) return { data: null, error: fileMoveError };
        return { data: { message: 'The resource already existed and has successfully been replaced.' }, error: null };
      }
      return { data: null, error };
    }
    throw error;
  }
}