Skip to content

buildListenerUrl

buildListenerUrl(__namedParameters): string

Defined in: utils/iframe/iframeHelper.ts:109

Build the listener iframe URL.

Exported so every iframe creator (here and @frak-labs/react-sdk’s provider) builds the same URL — they drifted before, and a missing clientId param silently costs the listener its SDK-seeded identity.

Query params:

  • clientId — anonymous SDK client identifier used for funnel joining. Omitted entirely when derivation failed; never serialised as "undefined". The listener then falls back to its persisted store.

Hash params (consumed by apps/listener/app/bootstrap.ts#setupPreloadHints):

  • preload=modal,sharing — idle-warms the matching Ring 1 + Ring 2 chunks. Skipped entirely when no preload hints are provided so the listener doesn’t pay for warm-ups that nobody asked for.

string

ListenerPreloadOption[]

string = ...

string