// Registrar cuando el usuario visita una página
await base44.appLogs.logUserInApp("dashboard");

// Registrar visitas a páginas específicas
await base44.appLogs.logUserInApp("settings");
await base44.appLogs.logUserInApp("profile");

// Registrar uso de funciones
await base44.appLogs.logUserInApp("export-button-click");

// Registrar vistas de página en cambio de ruta
useEffect(() => {
  base44.appLogs.logUserInApp(window.location.pathname);
}, [location.pathname]);

// Registrar cuando el usuario usa funciones específicas
function handleExport() {
  base44.appLogs.logUserInApp("export-data");
  // ... lógica de exportación
}

function handleSettingsChange() {
  base44.appLogs.logUserInApp("settings-updated");
  // ... guardar configuración
}

// Obtener todos los registros
const logs = await base44.appLogs.fetchLogs();

// Obtener registros con filtros
const recentLogs = await base44.appLogs.fetchLogs({
  limit: 50,
  page: "/dashboard"
});

// Obtener estadísticas de uso de la app
const stats = await base44.appLogs.getStats();

// Obtener estadísticas con parámetros de rango de fechas
const weekStats = await base44.appLogs.getStats({
  from: "2024-01-01",
  to: "2024-01-07"
});

/** Módulo App Logs para rastrear y analizar el uso de la app. */
interface AppLogsModule {
  /**
   * Registra la actividad del usuario en la app.
   * @param pageName - Nombre de la página o sección visitada.
   * @returns Promesa que se resuelve cuando se registra el log.
   */
  logUserInApp(pageName: string): Promise<void>;

  /**
   * Obtiene los registros de la app con parámetros de filtro opcionales.
   * @param params - Parámetros de filtro opcionales (por ejemplo, límite, nombre de página, rango de fechas).
   * @returns Promesa que resuelve a los datos de registros.
   */
  fetchLogs(params?: Record<string, any>): Promise<any>;

  /**
   * Obtiene estadísticas de uso de la app.
   * @param params - Parámetros de filtro opcionales (por ejemplo, rango de fechas).
   * @returns Promesa que resuelve a los datos de estadísticas.
   */
  getStats(params?: Record<string, any>): Promise<any>;
}