Add intent_options parameter on Portal.generate_link() method

[jonatascastro12]

Description

This PR introduces the intent_options parameter in the Portal.generate_link() method. This feature is not generally available on WorkOS API. Contact WorkOS support for access.

Documentation

Does this require changes to the WorkOS Docs? E.g. the API Reference or code snippets need updates.

[ ] Yes

If yes, link a related docs PR and add a docs maintainer as a reviewer. Their approval is required.

[linear]

DSYNC-2460 Add bookmark_id parameter to portal link generation method on Python SDK

[mattgd]

Left a method signature suggestion. Let me know your thoughts.

[mattgd]

I wonder if we should defined this as a structured TypedDict so it makes future expansion easier.

For example:

# types/portal/portal_link_intent_options.py
class SSOIntentOptions(TypedDict):
    bookmark_slug: str


class IntentOptions(TypedDict):
    sso: SSOIntentOptions

# portal.py
def generate_link(
        self,
        *,
        intent: PortalLinkIntent,
        organization_id: str,
        return_url: Optional[str] = None,
        success_url: Optional[str] = None,
        intent_options: Optional[IntentOptions] = None,
    ) -> PortalLink:
    ...
    if intent_options and intent_options["sso"]:
        json["intent_options"] = {
            "sso": {
                "bookmark_slug": intent_options["sso"]["bookmark_slug"],
             }
         }

Usage would be something like:

Portal.generate_link(
    intent="sso",
    organization_id="org_123",
    intent_options={"sso": {"bookmark_slug": "test"}},
)

[mattgd]

Looks good!