<?php
/**
 * The one platform-neutral signup value object every provider maps into,
 * and the only shape Sync_Service/Api_Client ever consume - see Part Q.
 * Contains only what the 404 Emails API contract actually needs; no
 * Event-Tickets-specific (or any other provider-specific) field ever
 * appears here.
 *
 * @package Emails404
 */

namespace Emails404;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Signup_Dto {

	/** @var string */
	public $email;

	/** @var string|null */
	public $first_name;

	/** @var string|null */
	public $last_name;

	/** @var bool Explicit, affirmative marketing consent - never inferred. */
	public $consent;

	/** @var string|null Freeform external reference, e.g. "wordpress-event-tickets:event-12:attendee-345". */
	public $source_reference;

	/** @var string|null The 404 Emails Form to submit through when consent is true - null routes through the Contacts endpoint instead (see Api_Client::upsert_contact()'s doc comment). */
	public $destination_form_public_id;

	/** @var string Deterministic, stable across retries - see Idempotency::build_key(). */
	public $idempotency_key;

	/** @var string|null The permission wording the person agreed to on another plugin's form (Form_Connections) - recorded instead of the 404 Emails form's own. */
	public $consent_text;

	/** @var string|null "cs" or "en": the language of the page they signed up on (Site_Language), kept for retries. */
	public $locale;

	public function __construct(
		$email,
		$first_name,
		$last_name,
		$consent,
		$source_reference,
		$destination_form_public_id,
		$idempotency_key,
		$consent_text = null,
		$locale = false
	) {
		$this->email                      = (string) $email;
		$this->first_name                 = $first_name ? (string) $first_name : null;
		$this->last_name                  = $last_name ? (string) $last_name : null;
		$this->consent                    = (bool) $consent;
		$this->source_reference           = $source_reference ? (string) $source_reference : null;
		$this->destination_form_public_id = $destination_form_public_id ? (string) $destination_form_public_id : null;
		$this->idempotency_key            = (string) $idempotency_key;
		$this->consent_text               = is_string( $consent_text ) && '' !== trim( $consent_text ) ? $consent_text : null;
		// Not given (false): the page being used right now. A retry passes the stored value (or null).
		$this->locale = false === $locale ? Site_Language::current() : Site_Language::normalize( $locale );
	}

	public function is_valid() {
		return '' !== trim( $this->email ) && false !== strpos( $this->email, '@' ) && '' !== trim( $this->idempotency_key );
	}
}