add standalone jw player adapter and api logic

src/adapters/class-jw-player.php

@@ -0,0 +1,106 @@
+<?php
+/**
+ * WP Video Sync: JW Player Adapter.
+ *
+ * @package wp-video-sync
+ */
+
+namespace Alley\WP\WP_Video_Sync\Adapters;
+
+use Alley\WP\WP_Video_Sync\API\JW_Player_API;
+use Alley\WP\WP_Video_Sync\Interfaces\Adapter;
+use DateTimeImmutable;
+use stdClass;
+
+/**
+ * JW Player Adapter.
+ */
+class JW_Player implements Adapter {
+
+	/**
+	 * The date of the last modification to the last batch of videos.
+	 *
+	 * @var ?DateTimeImmutable
+	 */
+	private ?DateTimeImmutable $last_modified_date;
+
+	/**
+	 * The JW Player API.
+	 *
+	 * @var JW_Player_API
+	 */
+	public JW_Player_API $jw_player_api;
+
+	/**
+	 * The start date if the `last_modified_date` does not exist.
+	 *
+	 * @var string
+	 */
+	public string $origin_modified_date;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param JW_Player_API $api Instance of the JW Player API object.
+	 * @param string        $origin_modified_date The date of the used if the `last_modified_date` does not exist.
+	 */
+	public function __construct( JW_Player_API $api, string $origin_modified_date = '' ) {
+		$this->jw_player_api        = $api;
+		$this->origin_modified_date = ! empty( $origin_modified_date ) ? $origin_modified_date : date( 'Y-m-d' );
+	}
+
+	/**
+	 * Fetches the date of the last modification to the last batch of videos.
+	 *
+	 * @return ?DateTimeImmutable
+	 */
+	public function get_last_modified_date(): ?DateTimeImmutable {
+		return $this->last_modified_date ?? DateTimeImmutable::createFromFormat('Y-m-d', $this->origin_modified_date );
+	}
+
+	/**
+	 * Sets the date of the last modification to the latest batch of videos.
+	 *
+	 * @param array $videos An array of videos and associated data.
+	 * @return void
+	 */
+	public function set_last_modified_date( array $videos ): void {
+		if (
+			! empty( $videos )
+			&& isset( $videos[ count( $videos ) - 1 ]->last_modified )
+		) {
+			$last_modified_date = DateTimeImmutable::createFromFormat( DATE_W3C, $videos[ count( $videos ) - 1 ]->last_modified );
+
+			if ( $last_modified_date instanceof DateTimeImmutable ) {
+				$this->last_modified_date = $last_modified_date;
+			}
+		}
+	}
+
+	/**
+	 * Fetches videos from JW Player that were modified after the provided DateTime.
+	 *
+	 * @param DateTimeImmutable $updated_after Return videos modified after this date.
+	 * @param int               $batch_size    The number of videos to fetch in each batch.
+	 *
+	 * @return stdClass[] An array of video data.
+	 */
+	public function get_videos( DateTimeImmutable $updated_after, int $batch_size ): array {
+		// Get the latest videos from JW Player.
+		$videos = $this->jw_player_api->request_latest_videos(
+			$updated_after->format( 'Y-m-d' ),
+			$batch_size
+		);
+
+		// Check for an API error.
+		if ( ! empty( $videos['error'] ) ) {
+			return [];
+		}
+
+		// Attempt to set the last modified date.
+		$this->set_last_modified_date( $videos );
+
+		// Return the videos.
+		return ! empty( $videos ) ? $videos : [];
+	}
+}

src/api/class-jw-player-api.php

@@ -0,0 +1,161 @@
+<?php
+/**
+ * WP Video Sync: JW Player API integration.
+ *
+ * @package wp-video-sync
+ */
+
+namespace Alley\WP\WP_Video_Sync\API;
+
+class JW_Player_API {
+
+	/**
+	 * The API URL.
+	 *
+	 * @var string
+	 */
+	public string $api_url = 'https://api.jwplayer.com/v2/sites';
+
+	/**
+	 * The API public key.
+	 *
+	 * @var string
+	 */
+	public string $api_key;
+
+	/**
+	 * The API v2 secret key.
+	 *
+	 * @var string
+	 */
+	public string $api_secret;
+
+	/**
+	 * Constructor.
+	 */
+	public function __construct( string $api_key, string $api_secret ) {
+		$this->api_key    = $api_key;
+		$this->api_secret = $api_secret;
+	}
+
+	/**
+	 * Set the user agent in the request headers for identification purposes.
+	 *
+	 * @return string
+	 */
+	public function user_agent(): string {
+		global $wp_version;
+
+		return 'WordPress/' . $wp_version . ' WPVideoSync/' . WP_VIDEO_SYNC_VERSION . ' PHP/' . phpversion();
+	}
+
+	/**
+	 * Generate the request URL.
+	 *
+	 * @param string $last_modified_date The date of the last modification to the last batch of videos.
+	 * @param int    $batch_size         The number of videos to fetch in each batch.
+	 *
+	 * @return string
+	 */
+	public function request_url( string $last_modified_date, int $batch_size ): string {
+		$request_url = $this->api_url . '/' . $this->api_key . '/media/';
+
+		return add_query_arg(
+			[
+				'q'           => 'last_modified:[' . $last_modified_date . ' TO *]',
+				'page'        => 1,
+				'sort'        => 'last_modified:asc',
+				'page_length' => $batch_size,
+			],
+			$request_url
+		);
+	}
+
+	/**
+	 * Generate the request arguments.
+	 *
+	 * @param string $type The type of request to make.
+	 *
+	 * @return array
+	 */
+	public function request_args( string $type = '' ): array {
+		$default_args = [
+			'user-agent' => $this->user_agent(),
+			'headers'    => [
+				'Authorization' => 'Bearer ' . $this->api_secret,
+				'Content-Type'  => 'application/json',
+			],
+		];
+
+		return 'vip' === $type
+			? $default_args
+			: array_merge( $default_args, [ 'timeout' => 3 ] );
+	}
+
+	/**
+	 * Parse the API response.
+	 *
+	 * @param mixed $api_response The API response.
+	 *
+	 * @return array
+	 */
+	public function parse_response( mixed $api_response ): array {
+		// Failed request expressed as a WP_Error.
+		if ( is_wp_error( $api_response ) ) {
+			return [];
+		}
+
+		// Condition for when the response body is empty.
+		$response_body = wp_remote_retrieve_body( $api_response );
+
+		if ( empty( $response_body ) ) {
+			return [];
+		}
+
+		// Assign the response object for further evaluation.
+		$response_object = json_decode( $response_body );
+
+		if ( 200 !== wp_remote_retrieve_response_code( $api_response ) ) {
+			return isset( $response_object->errors[0]->description )
+				? [ 'error' => $response_object->errors[0]->description ]
+				: [];
+		}
+
+		return is_array( $response_object->media ) && ! empty( $response_object->media )
+			? $response_object->media
+			: [];
+	}
+
+	/**
+	 * Make the API request.
+	 *
+	 * @param string $updated_after The date of the last modification to the last batch of videos.
+	 * @param int    $batch_size    The number of videos to fetch in each batch.
+	 *
+	 * @return array
+	 */
+	public function request_latest_videos( string $updated_after, int $batch_size ): array {
+		$request_url = $this->request_url(
+			$updated_after,
+			$batch_size
+		);
+
+		if ( function_exists( 'vip_safe_wp_remote_get' ) ) {
+			$api_request = vip_safe_wp_remote_get(
+				$request_url,
+				'',
+				3,
+				5,
+				3,
+				$this->request_args( 'vip' )
+			);
+		} else {
+			$api_request = wp_remote_get(
+				$request_url,
+				$this->request_args()
+			);
+		}
+
+		return $this->parse_response( $api_request );
+	}
+}

wp-video-sync.php

@@ -21,4 +21,7 @@
 	exit;
 }
 
+// Define the plugin version.
+define( 'WP_VIDEO_SYNC_VERSION', '1.7.2' );
+
 require_once __DIR__ . '/src/autoload.php';