feat: normalize content records

2026-04-28 18:13:44 -05:00
parent 7a30bbf1de
commit c66501d0e5
2 changed files with 188 additions and 0 deletions
@@ -0,0 +1,68 @@
+<?php
+/**
+ * Normalizes package content records for handlers.
+ *
+ * @package WPContentSync
+ */
+
+namespace WPContentSync\Content;
+
+final class ContentRecordNormalizer {
+	/**
+	 * @param array<string, mixed> $record Raw post record.
+	 * @return array<string, mixed>
+	 */
+	public function post( array $record ): array {
+		return array(
+			'id'           => (int) ( $record['id'] ?? 0 ),
+			'post_type'    => sanitize_text_field( (string) ( $record['post_type'] ?? 'post' ) ),
+			'post_title'   => sanitize_text_field( (string) ( $record['post_title'] ?? '' ) ),
+			'post_content' => (string) ( $record['post_content'] ?? '' ),
+			'post_excerpt' => sanitize_text_field( (string) ( $record['post_excerpt'] ?? '' ) ),
+			'post_status'  => sanitize_text_field( (string) ( $record['post_status'] ?? 'draft' ) ),
+			'post_name'    => sanitize_text_field( (string) ( $record['post_name'] ?? '' ) ),
+			'post_parent'  => (int) ( $record['post_parent'] ?? 0 ),
+			'menu_order'   => (int) ( $record['menu_order'] ?? 0 ),
+			'meta'         => $this->arrayValue( $record['meta'] ?? array() ),
+		);
+	}
+
+	/**
+	 * @param array<string, mixed> $record Raw term record.
+	 * @return array<string, mixed>
+	 */
+	public function term( array $record ): array {
+		return array(
+			'id'          => (int) ( $record['id'] ?? 0 ),
+			'taxonomy'    => sanitize_text_field( (string) ( $record['taxonomy'] ?? '' ) ),
+			'name'        => sanitize_text_field( (string) ( $record['name'] ?? '' ) ),
+			'slug'        => sanitize_text_field( (string) ( $record['slug'] ?? '' ) ),
+			'description' => (string) ( $record['description'] ?? '' ),
+			'parent'      => (int) ( $record['parent'] ?? 0 ),
+			'meta'        => $this->arrayValue( $record['meta'] ?? array() ),
+		);
+	}
+
+	/**
+	 * @param array<string, mixed> $record Raw media record.
+	 * @return array<string, mixed>
+	 */
+	public function media( array $record ): array {
+		return array(
+			'id'             => (int) ( $record['id'] ?? 0 ),
+			'post_title'     => sanitize_text_field( (string) ( $record['post_title'] ?? '' ) ),
+			'post_mime_type' => sanitize_text_field( (string) ( $record['post_mime_type'] ?? '' ) ),
+			'source_url'     => esc_url_raw( (string) ( $record['source_url'] ?? '' ) ),
+			'metadata'       => $this->arrayValue( $record['metadata'] ?? array() ),
+			'meta'           => $this->arrayValue( $record['meta'] ?? array() ),
+		);
+	}
+
+	/**
+	 * @param mixed $value Value to normalize.
+	 * @return array<string, mixed>
+	 */
+	private function arrayValue( $value ): array {
+		return is_array( $value ) ? $value : array();
+	}
+}