// Rastrear un evento simple
base44.analytics.track({
  eventName: "button_clicked"
});

// Rastrear evento con propiedades
base44.analytics.track({
  eventName: "purchase_completed",
  properties: {
    product_id: "prod-123",
    amount: 99.99,
    currency: "USD"
  }
});

// Rastrear vista de página
base44.analytics.track({
  eventName: "page_view",
  properties: {
    page: "/dashboard",
    referrer: document.referrer
  }
});

// Rastrear uso de función
base44.analytics.track({
  eventName: "feature_used",
  properties: {
    feature: "export_data",
    format: "csv"
  }
});

// Bueno: Descriptivo con propiedades relevantes
base44.analytics.track({
  eventName: "subscription_started",
  properties: {
    plan: "pro",
    billing_cycle: "annual"
  }
});

// Evitar: Nombre de evento vago, sin contexto
base44.analytics.track({
  eventName: "click"
});

/** Propiedades que pueden adjuntarse a un evento rastreado. */
type TrackEventProperties = {
  [key: string]: string | number | boolean | null | undefined;
};

/** Parámetros para el método track(). */
interface TrackEventParams {
  /** El nombre del evento a rastrear. */
  eventName: string;
  /** Propiedades opcionales a adjuntar al evento. */
  properties?: TrackEventProperties;
}

/** La interfaz del módulo analytics. */
interface AnalyticsModule {
  /** Rastrea un evento personalizado con propiedades opcionales. */
  track(params: TrackEventParams): void;
}