<?php
/**
 * OpenStation — Platform-wide extended options.
 *
 * System-level toggles that enhance the WordPress admin with extra
 * openstation capabilities. Stored in `wp_options` (not per-user) so
 * they affect every user on the site. Admin-only to read or write.
 *
 * Current options:
 *   - media_library_enhanced: when true, enqueues a small JS shim on
 *     every admin page that makes Media Library .attachment tiles
 *     draggable — users can drag images out of the library into any
 *     drop target (text fields, TinyMCE/Gutenberg blocks, custom
 *     drop zones) without the library having to be re-built from
 *     scratch. **Defaults to `true`** — the enhancement is opt-OUT;
 *     sites that want vanilla Media Library behaviour must explicitly
 *     toggle it off in OS Settings → Features → Extended options.
 *   - games: when true, the games framework loads — Games hub window +
 *     desktop icon, built-in games, score/challenge REST routes, the
 *     Heartbeat challenge channel, and the schema check. **Defaults to
 *     `false`** — games are opt-IN; an admin turns them on in
 *     OS Settings → Features → Extended options. While off,
 *     `includes/games/bootstrap.php` skips every module file, so the
 *     framework consumes no resources at all (see
 *     `openstation_games_enabled()`).
 *   - agents: when true, the AI Agents framework loads — synthetic
 *     agent users, the `/desktop-mode/v1/agents` REST surface, the
 *     Agents section in My WordPress, and the Agent chat window.
 *     **Defaults to `false`** — agents are opt-IN. While off,
 *     `includes/agents/bootstrap.php` skips every module file (see
 *     `openstation_agents_enabled()`).
 *
 * @package OpenStation
 */

defined( 'ABSPATH' ) || exit;

/**
 * The `wp_options` key for the extended options bundle.
 *
 * The VALUE keeps its pre-rebrand spelling on purpose: it is a
 * persisted or externally-visible identifier, so renaming it would
 * orphan data already written by live installs (or break a live
 * URL). The mismatch between this constant's name and its value is
 * deliberate — it is NOT a half-finished rename.
 */
const OPENSTATION_EXTENDED_OPTIONS_KEY = 'desktop_mode_extended_options';

// ---------------------------------------------------------------------------
// Get / save
// ---------------------------------------------------------------------------

/**
 * Returns the extended options with defaults filled in.
 *
 * @return array{ media_library_enhanced: bool, games: bool, agents: bool }
 */
function openstation_get_extended_options() {
	$defaults = array(
		'media_library_enhanced' => true,
		'games'                  => false,
		'agents'                 => false,
	);
	$raw      = get_option( OPENSTATION_EXTENDED_OPTIONS_KEY, array() );
	if ( ! is_array( $raw ) ) {
		return $defaults;
	}
	// Fall back to the default only when the key is ABSENT — so an
	// admin who explicitly saved `false` stays opted-out even though
	// the shipped default is now `true`. `! empty()` would wrongly
	// coerce an explicit `false` back to the default.
	$clean = array();
	foreach ( $defaults as $key => $default ) {
		$clean[ $key ] = array_key_exists( $key, $raw )
			? (bool) $raw[ $key ]
			: $default;
	}
	return $clean;
}

/**
 * Persists extended options to `wp_options`.
 *
 * @param mixed $raw Incoming payload.
 * @return bool
 */
function openstation_save_extended_options( $raw ) {
	if ( ! is_array( $raw ) ) {
		return false;
	}
	// Merge over the current values so a payload that omits a key (an
	// older client, a partial save) can't silently reset it.
	$clean = openstation_get_extended_options();
	foreach ( $clean as $key => $current ) {
		if ( array_key_exists( $key, $raw ) ) {
			$clean[ $key ] = ! empty( $raw[ $key ] );
		}
	}
	return update_option( OPENSTATION_EXTENDED_OPTIONS_KEY, $clean, false );
}

// ---------------------------------------------------------------------------
// REST endpoint — admin only
// ---------------------------------------------------------------------------

/**
 * Registers the extended options REST route.
 */
function openstation_register_extended_options_rest_routes() {
	register_rest_route(
		'desktop-mode/v1',
		'/extended-options',
		array(
			array(
				'methods'             => WP_REST_Server::READABLE,
				'callback'            => 'openstation_rest_get_extended_options',
				'permission_callback' => 'openstation_rest_extended_options_permission',
			),
			array(
				'methods'             => WP_REST_Server::CREATABLE,
				'callback'            => 'openstation_rest_save_extended_options',
				'permission_callback' => 'openstation_rest_extended_options_permission',
				'args'                => array(
					'options' => array(
						'required' => true,
						'type'     => 'object',
					),
				),
			),
		)
	);
}
add_action( 'rest_api_init', 'openstation_register_extended_options_rest_routes' );

/**
 * Permission: admins only.
 *
 * @return bool|WP_Error
 */
function openstation_rest_extended_options_permission() {
	if ( ! is_user_logged_in() || ! current_user_can( 'manage_options' ) ) {
		return new WP_Error(
			'openstation_extended_forbidden',
			'Only administrators can manage extended options.',
			array( 'status' => 403 )
		);
	}
	return true;
}

/**
 * GET /desktop-mode/v1/extended-options
 *
 * @return WP_REST_Response
 */
function openstation_rest_get_extended_options() {
	return rest_ensure_response( openstation_get_extended_options() );
}

/**
 * POST /desktop-mode/v1/extended-options
 *
 * @param WP_REST_Request $request
 * @return WP_REST_Response
 */
function openstation_rest_save_extended_options( WP_REST_Request $request ) {
	$payload = $request->get_param( 'options' );
	openstation_save_extended_options( $payload );
	return rest_ensure_response( openstation_get_extended_options() );
}

// ---------------------------------------------------------------------------
// Media Library enhancement enqueue
// ---------------------------------------------------------------------------

/**
 * Enqueues the media-library enhancement shim when the admin has
 * toggled it on. The script is a no-op on pages where wp.media isn't
 * loaded (it checks at runtime), so there's no harm in enqueuing
 * globally in the admin.
 */
function openstation_enqueue_media_library_enhancement() {
	if ( ! is_admin() || ! is_user_logged_in() ) {
		return;
	}

	$options = openstation_get_extended_options();
	if ( empty( $options['media_library_enhanced'] ) ) {
		return;
	}

	wp_enqueue_script(
		'os-media-library-enhanced',
		OPENSTATION_URL . 'assets/js/media-library-enhanced.js',
		array(),
		OPENSTATION_VERSION,
		true
	);
}
add_action( 'admin_enqueue_scripts', 'openstation_enqueue_media_library_enhancement', 20 );