iya-sts
    Preparing search index...
    decide: (req: ChooserRequest, surfaceId: string) => Decision = ...

    Type Declaration

      • (req: ChooserRequest, surfaceId: string): Decision
      • Decides whether a request for a surface's root must first choose a realm.

        It asks only for a GET or HEAD of exactly the surface's root in the default realm, with realms defined; the caller has already found no session. A choice is a redirect built from the registry's own prefix, never an echo of the request. A choice that resolves is remembered, and a later request with no ?realm= is that choice.

        Parameters

        • req: ChooserRequest

          the express request

        • surfaceId: string

          'admin' or 'portal'

        Returns Decision

        null when this is not the question; { kind: 'page', error } to draw the chooser; { kind: 'here' } to sign in to the default realm; or { kind: 'redirect', location } to the chosen realm's surface