/* WirePlumber
 *
 * Copyright © 2020 Collabora Ltd.
 *    @author George Kiagiadakis <george.kiagiadakis@collabora.com>
 *
 * SPDX-License-Identifier: MIT
 */

#ifndef __WIREPLUMBER_TRANSITION_H__
#define __WIREPLUMBER_TRANSITION_H__

#include <gio/gio.h>
#include "defs.h"

G_BEGIN_DECLS

/**
 * WP_TYPE_TRANSITION:
 *
 * The #WpTransition #GType
 */
#define WP_TYPE_TRANSITION (wp_transition_get_type ())
WP_API
G_DECLARE_DERIVABLE_TYPE (WpTransition, wp_transition, WP, TRANSITION, GObject)

/**
 * WpTransitionStep:
 * @WP_TRANSITION_STEP_NONE: the initial and final step of the transition
 * @WP_TRANSITION_STEP_ERROR: returned by #WpTransitionClass.get_next_step() in
 *   case of an error
 * @WP_TRANSITION_STEP_CUSTOM_START: starting value for steps defined in
 *   subclasses
 */
typedef enum {
  WP_TRANSITION_STEP_NONE = 0,
  WP_TRANSITION_STEP_ERROR,
  WP_TRANSITION_STEP_CUSTOM_START = 0x10
} WpTransitionStep;

/**
 * WpTransitionClass:
 * @get_next_step: See wp_transition_advance()
 * @execute_step: See wp_transition_advance()
 */
struct _WpTransitionClass
{
  GObjectClass parent_class;

  guint (*get_next_step) (WpTransition * transition, guint step);
  void (*execute_step) (WpTransition * transition, guint step);
};

WP_API
WpTransition * wp_transition_new (GType type,
    gpointer source_object, GCancellable * cancellable,
    GAsyncReadyCallback callback, gpointer callback_data);

/* source object */

WP_API
gpointer wp_transition_get_source_object (WpTransition * self);

/* tag */

WP_API
gboolean wp_transition_is_tagged (WpTransition * self, gpointer tag);

WP_API
gpointer wp_transition_get_source_tag (WpTransition * self);

WP_API
void wp_transition_set_source_tag (WpTransition * self, gpointer tag);

/* task data */

WP_API
gpointer wp_transition_get_data (WpTransition * self);

WP_API
void wp_transition_set_data (WpTransition * self, gpointer data,
    GDestroyNotify data_destroy);

/* state machine */

WP_API
gboolean wp_transition_get_completed (WpTransition * self);

WP_API
gboolean wp_transition_had_error (WpTransition * self);

WP_API
void wp_transition_advance (WpTransition * self);

WP_API
void wp_transition_return_error (WpTransition * self, GError * error);

/* result */

WP_API
gboolean wp_transition_finish (GAsyncResult * res, GError ** error);

G_END_DECLS

#endif