/**
 * Viral-attribution helper for framework "share URL" builders.
 *
 * Public share/copy links self-attribute so the signup funnel can be measured
 * even when `document.referrer` is empty (desktop app, Slack, native clients,
 * etc). `server/attribution.ts` captures first-touch `ref`/`via` query params
 * into a cookie and enriches the `signup` event; each app's only job is to
 * tag the share URL it mints when building it — the framework does the rest.
 *
 * Centralized here (rather than reimplemented per app) so every share-link
 * builder tags the same two params the same way. `ref` is always required so
 * an app's share path isn't silently miscategorized by the landing-path
 * fallback in `deriveReferralSource` (e.g. `/share/...` defaults to
 * "clip_share" for any app that happens to use that prefix).
 *
 * Privacy: `ownerId` must be a non-PII stable id — the same Better Auth user
 * id `signup` events carry as `auth_user_id` (e.g. `session.userId` from
 * `useSession()`) — never an email or name. Omit it for a logged-out sharer
 * rather than emit an empty `via`.
 */
export declare const SHARE_LINK_REF_PARAM = "ref";
export declare const SHARE_LINK_VIA_PARAM = "via";
export declare function withShareLinkAttribution(url: string | undefined, source: string, ownerId?: string | null): string | undefined;