/*
 * SPDX-FileCopyrightText: 2003-2026 Sébastien Helleu <flashcode@flashtux.org>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 */

#ifndef WEECHAT_HOOK_TIMER_H
#define WEECHAT_HOOK_TIMER_H

#include <time.h>
#include <sys/time.h>

struct t_weechat_plugin;
struct t_infolist_item;

#define HOOK_TIMER(hook, var) (((struct t_hook_timer *)hook->hook_data)->var)

typedef int (t_hook_callback_timer)(const void *pointer, void *data,
                                    int remaining_calls);

struct t_hook_timer
{
    t_hook_callback_timer *callback;   /* timer callback                    */
    long interval;                     /* timer interval (milliseconds)     */
    int align_second;                  /* alignment on a second             */
                                       /* for ex.: 60 = each min. at 0 sec  */
    int remaining_calls;               /* calls remaining (0 = unlimited)   */
    struct timeval last_exec;          /* last time hook was executed       */
    struct timeval next_exec;          /* next scheduled execution          */
};

extern time_t hook_last_system_time;

extern char *hook_timer_get_description (struct t_hook *hook);
extern struct t_hook *hook_timer (struct t_weechat_plugin *plugin,
                                  long interval, int align_second,
                                  int max_calls,
                                  t_hook_callback_timer *callback,
                                  const void *callback_pointer,
                                  void *callback_data);
extern int hook_timer_get_time_to_next (void);
extern void hook_timer_exec (void);
extern void hook_timer_free_data (struct t_hook *hook);
extern struct t_hdata *hook_timer_hdata_hook_timer_cb (const void *pointer,
                                                       void *data,
                                                       const char *hdata_name);
extern int hook_timer_add_to_infolist (struct t_infolist_item *item,
                                       struct t_hook *hook);
extern void hook_timer_print_log (struct t_hook *hook);

#endif /* WEECHAT_HOOK_TIMER_H */
