[PLT-3393] Add support of groups to invite_user()

[paulnoirel]

Description

The current PR adds an optional user_group_roles to Organization.invite_user(...) so callers can invite a user (with org role NONE) and simultaneously assign one or more UserGroup role memberships, like in the UI.
The new parameter is similar to the existing project_role for consistency.

Guardrails

• Requires org role NONE: passing user_group_roles with any other org role raises ValueError.
• Dedupes exact duplicates: repeated entries with the same user_group.id + role.uid are deduped.
• Rejects conflicts: if the same user_group.id appears with different roles, raises ValueError (prevents backend errors).

Example

from labelbox import Client, UserGroupRole
from labelbox.schema.user_group import UserGroup

invitee: str = "new.user@example.com"

client = Client("<API_KEY>")
organization = client.get_organization()
roles = client.get_roles()

# NOTE: user_group_roles requires org role NONE
org_role = roles["NONE"]

# Use an existing UserGroup id (e.g. from the UI / API)
user_group = UserGroup(client=client, id="<USER_GROUP_ID>")

invite = organization.invite_user(
    email=invitee,
    role=org_role,
    user_group_roles=[
        UserGroupRole(user_group=user_group, role=roles["REVIEWER"]),
    ],
)

Fixes # (PLT-3393)[https://labelbox.atlassian.net/browse/PLT-3393]

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Document change (fix typo or modifying any markdown files, code comments or anything in the examples folder only)

All Submissions

• Have you followed the guidelines in our Contributing document?
• Have you provided a description?
• Are your changes properly formatted?

New Feature Submissions

• Does your submission pass tests?
• Have you added thorough tests for your new feature?
• Have you commented your code, particularly in hard-to-understand areas?
• Have you added a Docstring?

Changes to Core Features

• Have you written new tests for your core changes, as applicable?
• Have you successfully run tests with your changes locally?
• Have you updated any code comments, as applicable?

---

Note

Enables assigning UserGroup roles when inviting a user with org role NONE.

• Adds optional user_group_roles to Organization.invite_user; validates org role is NONE
• Dedupe identical group+role entries; raise ValueError on conflicting roles for the same group
• Extends GraphQL payload with userGroupIds and userGroupWithRoleIds
• Introduces UserGroupRole dataclass and exports it in labelbox.__init__; updates typing in ORM
• Adds unit tests covering deduplication, conflict validation, and payload shape

^{Written by Cursor Bugbot for commit 162aeeb. This will update automatically on new commits. Configure here.}