{ output key => field type }. A field type drives both * the structural check and the sanitizer below. * * @var array> */ private const FIELD_TYPES = array( Generators::DESCRIPTION => array( 'description' => 'html', 'shortDescription' => 'html', 'tags' => 'tag_list', ), Generators::TITLE => array( 'title' => 'text', ), Generators::SEO_META => array( 'metaTitle' => 'text', 'metaDescription' => 'text', 'focusKeyword' => 'text', ), Generators::FAQ => array( 'faq' => 'faq_list', ), Generators::IMAGE_ALT => array( 'alt' => 'alt_map', ), Generators::TAXONOMY => array( 'termDescription' => 'html', ), ); /** * @param string $generator Generator key. * @param array $rawOutputs Decoded `outputs` body value. * @param array $storedOutputs The stored result's own `payload.outputs` (image_alt's attachment-id subset check reads this). * @return array|WP_Error Sanitized override, keyed exactly like `$rawOutputs`, or a 400 `aipt_blueprint_invalid_outputs` error. */ public static function validate( string $generator, array $rawOutputs, array $storedOutputs ) { if ( empty( $rawOutputs ) ) { return self::invalid(); } $schema = self::FIELD_TYPES[ $generator ] ?? array(); $sanitized = array(); foreach ( $rawOutputs as $key => $value ) { if ( ! is_string( $key ) || '' === $key || ! isset( $schema[ $key ] ) ) { return self::invalid(); } $result = self::sanitizeField( $schema[ $key ], $value, $storedOutputs ); if ( is_wp_error( $result ) ) { return $result; } $sanitized[ $key ] = $result; } return $sanitized; } /** * @param string $type Field type (see FIELD_TYPES). * @param mixed $value Raw field value. * @param array $storedOutputs Stored result outputs (alt_map's subset check). * @return mixed|WP_Error */ private static function sanitizeField( string $type, $value, array $storedOutputs ) { switch ( $type ) { case 'html': return is_string( $value ) ? wp_kses_post( $value ) : self::invalid(); case 'text': return is_string( $value ) ? sanitize_text_field( $value ) : self::invalid(); case 'tag_list': return self::sanitizeScalarList( $value ); case 'faq_list': return self::sanitizeFaqList( $value ); case 'alt_map': return self::sanitizeAltMap( $value, $storedOutputs ); default: return self::invalid(); } } /** * `tags` (string[]): every entry sanitized with `sanitize_text_field()`. * * @param mixed $value Raw field value. * @return string[]|WP_Error */ private static function sanitizeScalarList( $value ) { if ( ! is_array( $value ) ) { return self::invalid(); } $list = array(); foreach ( $value as $entry ) { if ( ! is_scalar( $entry ) ) { return self::invalid(); } $list[] = sanitize_text_field( (string) $entry ); } return $list; } /** * `faq` ([{question, answer}]): question via `sanitize_text_field()`, * answer via `wp_kses_post()` — the same format the FAQ applier stores * today ({@see \AIPT\Core\ContentReview\FaqApplier::apply()}). * * @param mixed $value Raw field value. * @return array|WP_Error */ private static function sanitizeFaqList( $value ) { if ( ! is_array( $value ) ) { return self::invalid(); } $faq = array(); foreach ( $value as $entry ) { if ( ! is_array( $entry ) || ! isset( $entry['question'], $entry['answer'] ) ) { return self::invalid(); } if ( ! is_scalar( $entry['question'] ) || ! is_scalar( $entry['answer'] ) ) { return self::invalid(); } $faq[] = array( 'question' => sanitize_text_field( (string) $entry['question'] ), 'answer' => wp_kses_post( (string) $entry['answer'] ), ); } return $faq; } /** * `alt` ({"": text}): every key must already be present in * the stored result's own `outputs.alt` — a foreign attachment id is * invalid, never silently dropped. * * @param mixed $value Raw field value. * @param array $storedOutputs Stored result outputs. * @return array|WP_Error */ private static function sanitizeAltMap( $value, array $storedOutputs ) { if ( ! is_array( $value ) ) { return self::invalid(); } $stored_alt = is_array( $storedOutputs['alt'] ?? null ) ? $storedOutputs['alt'] : array(); $stored_ids = array_map( 'strval', array_keys( $stored_alt ) ); $alt = array(); foreach ( $value as $attachment_id => $text ) { if ( ! is_scalar( $attachment_id ) || 1 !== preg_match( '/^\d+$/', (string) $attachment_id ) ) { return self::invalid(); } if ( ! in_array( (string) $attachment_id, $stored_ids, true ) ) { return self::invalid(); } if ( ! is_scalar( $text ) ) { return self::invalid(); } $alt[ (string) $attachment_id ] = sanitize_text_field( (string) $text ); } return $alt; } /** * @return WP_Error */ private static function invalid(): WP_Error { return new WP_Error( 'aipt_blueprint_invalid_outputs', __( 'This output selection is invalid.', 'ai-product-tools' ), array( 'status' => 400 ) ); } }