<?php
/**
 * Global helper functions.
 *
 * @package FunnelFork
 */

defined( 'ABSPATH' ) || exit;

/**
 * Whether the premium add-on is active and licensed.
 *
 * The free plugin never locks features itself; FunnelFork Pro hooks into this
 * filter to announce that its extra features are available.
 */
function funnelfork_is_premium(): bool {
	return (bool) apply_filters( 'funnelfork_is_premium', false );
}

/**
 * Returns the stored (sanitized) graph for a scan, or the default graph.
 *
 * @param int $scan_id Scan post ID.
 */
function funnelfork_get_graph( int $scan_id ): array {
	$raw = get_post_meta( $scan_id, FunnelFork\Post_Type::META_GRAPH, true );
	if ( ! is_string( $raw ) || '' === $raw ) {
		return FunnelFork\Graph::default_graph();
	}

	$decoded = json_decode( $raw, true );
	if ( ! is_array( $decoded ) ) {
		return FunnelFork\Graph::default_graph();
	}

	return FunnelFork\Graph::sanitize( $decoded );
}

/**
 * Stores a graph for a scan. The graph is sanitized before saving.
 *
 * @param int   $scan_id Scan post ID.
 * @param array $graph   Graph data.
 * @return array The sanitized graph that was stored.
 */
function funnelfork_save_graph( int $scan_id, array $graph ): array {
	$clean = FunnelFork\Graph::sanitize( $graph );
	update_post_meta( $scan_id, FunnelFork\Post_Type::META_GRAPH, wp_slash( wp_json_encode( $clean ) ) );

	return $clean;
}

/**
 * Admin URL of the visual editor for a scan.
 *
 * @param int $scan_id Scan post ID.
 */
function funnelfork_editor_url( int $scan_id ): string {
	return add_query_arg(
		array(
			'post_type' => FunnelFork\Post_Type::POST_TYPE,
			'page'      => 'funnelfork-editor',
			'scan'      => $scan_id,
		),
		admin_url( 'edit.php' )
	);
}