<?php

/**
 * Workflow storage abstraction (database-backed).
 *
 * @package AfroIT_Messaging_WorkflowAutomations
 */

namespace AfroIT\Messaging\WorkflowAutomations\Workflows;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

interface WorkflowStoreInterface {

	/**
	 * Save a workflow.
	 *
	 * @param array<string,mixed> $workflow_data Workflow payload.
	 * @return array<string,mixed>
	 */
	public function save( array $workflow_data ): array;

	/**
	 * Delete a workflow.
	 *
	 * @param int $workflow_id Workflow ID.
	 * @return array<string,mixed>
	 */
	public function delete( int $workflow_id ): array;

	/**
	 * Update active status.
	 *
	 * @param int  $workflow_id Workflow ID.
	 * @param bool $is_active   Active flag.
	 * @return array<string,mixed>
	 */
	public function update_active_status( int $workflow_id, bool $is_active ): array;

	/**
	 * Find a workflow by ID.
	 *
	 * @param int $workflow_id Workflow ID.
	 * @return Workflow|null
	 */
	public function find( int $workflow_id ): ?Workflow;
}