/**
 * Centralized Habbo avatar imager utility.
 * Points to the self-hosted imager API (`/api/imaging/avatar`) which handles
 * disk + memory caching and (Phase 2) local rendering from .nitro bundles.
 * Override with NEXT_PUBLIC_IMAGER_URL when needed (e.g. CDN in front).
 */

const IMAGER_URL = process.env.NEXT_PUBLIC_IMAGER_URL || "/api/imaging/avatar";

export type { AvatarOptions } from "@/types/admin";

import type { AvatarOptions } from "@/types/admin";

/**
 * Build an avatar image URL served by the self-hosted imager.
 *
 * @example
 * getAvatarUrl('hr-893-45.hd-180-1.ch-210-66.lg-270-82')
 * getAvatarUrl(look, { size: 'l', headOnly: true })
 * getAvatarUrl(look, { size: 'm', gesture: 'sml', direction: 2 })
 */
export function getAvatarUrl(figure: string, options: AvatarOptions = {}): string {
  const { size = "m", direction = 2, headDirection = 3, headOnly = false, gesture, action } = options;

  const params = new URLSearchParams({
    figure,
    direction: String(direction),
    head_direction: String(headDirection),
    size,
  });

  if (headOnly) params.set("headonly", "1");
  if (gesture) params.set("gesture", gesture);
  if (action) params.set("action", action);

  return `${IMAGER_URL}?${params.toString()}`;
}