gppControl_usstates: activity controls for US state consent

[dgirardi]

Type of change

• Feature

Description of change

This implements the normalization rules for US state consent defined in here, and uses them to set up the same activity control rules that used for usnat.

By default, including this module activates all rules when GPP is configured. Configuration can be used to:

• only enable rules for some sections

     pbjs.setConfig({
        consentManagement: {
            gpp: {
               // ...
               mspa: {
                  sids: [8, 9] // enforce rules only in CA & VA
               }
            }
        }
     })
  

• override API names to use when talking to the CMP

    pbjs.setConfig({
        consentManagement: {
            gpp: {
               // ...
               mspa: {
                  sections: {
                      8: {
                         name: 'uspv1ca'  // seen in some production CMPs
                      }
                  }
               }
            }
       }
    })
  

• set up rules for sections that are not (yet) known to the module, if they can use the same normalization rules as one of the known sections

    pbjs.setConfig({
        consentManagement: {
            gpp: {
               // ...
               mspa: {
                    sids: [13],
                    sections: {
                        13: {
                             name: 'someBrandNewGppApi',
                             normalizeAs: 7  // "treat this section as section 7 (usnat)"
                        }
                    }
               }
            }
        }
    })
  

Other information

Closes #9666

[robertrmartinez]

Hi all, I am finishing up a couple high priority projects on my side so will not be able to get to this review until next week.

Just wanted to give you a heads up.

[Fawke]

LGTM