beginSignup

suspend fun beginSignup(authServer: String = "bsky.social", requirePromptCreateSupport: Boolean = true): String

Starts the OAuth signup flow against a known authorization server.

Unlike beginLogin, no handle or DID is required: the auth server is named directly, the discovery chain is short-circuited to fetch only its metadata, and PAR carries OIDC prompt=create so the server renders its signup UI. After the user signs up in the browser and the redirect lands, completeLogin derives the new account's DID from the token-response sub, then resolves the handle and PDS URL from the DID document.

Return

The authorization URL to open in a Custom Tab or system browser.

Parameters

authServer

The authorization server hostname or URL. Defaults to bsky.social. Accepts either a bare hostname or a full https:// URL.

requirePromptCreateSupport

When true (the default), the module verifies that the auth server's metadata advertises "create" in prompt_values_supported and throws OAuthSignupNotSupportedException otherwise. Pass false to bypass the check for non-conformant entryways.