merge Entitlements Prioritized
Merges a list of entitlements, keeping the highest priority entitlement for each ID. Uses EntitlementPriorityComparator to determine priority. When merging, productIds from all entitlements with the same ID are combined.