import type { AuthContext } from '../authentication.ts';
import { type Principal } from '../principal.ts';
/**
 * Convert the REST transport's `authContext` into a `Principal`. The
 * authenticator (`serve()`) reports method + optional claims; this maps
 * that transport authentication result into the `Principal` used by the
 * operation pipeline.
 * Returns `anonymousPrincipal()` when no context is provided (public
 * request).
 *
 * @example
 * ```ts
 * import { authContextToPrincipal } from '@lostgradient/weft/server/handler';
 *
 * const principal = authContextToPrincipal({ method: 'api-key' });
 * console.log(principal.method); // 'api-key'
 * ```
 */
export declare function authContextToPrincipal(authContext: AuthContext | undefined): Principal;