<?php

declare(strict_types=1);

namespace App\Events\Websites;

use App\Models\Core\Client;
use App\Models\Marketing\ContactSubmission;
use App\Models\Websites\BuilderSession;
use App\Models\Websites\BuilderSubmission;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

/**
 * Fired when a builder wizard is submitted for review.
 *
 * Plan 274 §274-B — Client is now the canonical lead anchor (positioned
 * first). ContactSubmission is nullable during the 274 expand/contract
 * window and is removed entirely in 274-E. Listeners that still depend on
 * it (Switchyard forwarding, legacy email notification) must tolerate null.
 */
class BuilderSubmitted
{
    use Dispatchable;
    use SerializesModels;

    public function __construct(
        public readonly Client $client,
        public readonly BuilderSubmission $submission,
        public readonly BuilderSession $session,
        public readonly ?ContactSubmission $contactSubmission = null,
    ) {}
}