Creating and editing events

use RoundlyConsulting\Events\Enums\AttendanceMode;
use RoundlyConsulting\Events\Enums\GuestList;
use RoundlyConsulting\Events\Enums\Visibility;
use RoundlyConsulting\Events\Facades\Events;

$event = Events::make(['en' => 'Jazz Night', 'sk' => 'Jazzový večer'])  // EventBuilder
    ->description(['en' => 'A live quartet.'])
    ->slug(['en' => 'jazz-night'])                 // optional manual slugs (strict: a taken one throws)
    ->organizedBy($user)                           // Model&Organizer
    ->coHostedBy($partnerTeam)
    ->at($venue)                                   // Venue, a venue id, or null
    ->online('https://meet.example.com/jazz')      // stored encrypted; managers and going attendees only
    ->attendanceMode(AttendanceMode::Mixed)        // else derived: venue → offline, link → online, both → mixed
    ->timezone('Europe/Bratislava')
    ->startsAt('2026-11-14 20:00')->duration('PT3H')   // or ->endsAt(), or ->allDay($from, through: $to)
    ->doorsOpenAt('2026-11-14 19:00')
    ->visibility(Visibility::Unlisted)             // or ->unlisted(), ->private()
    ->capacity(120)->maxGuests(2)->waitlist(true, autoPromote: true)
    ->rsvpWindow(opensAt: '2026-10-01 09:00', closesAt: '2026-11-14 18:00')
    ->guestList(GuestList::Attendees)->showCounts(true)
    ->category('jazz')->labels(['Live', 'Late night'])
    ->poster($upload)                              // UploadedFile, a local path, or draft: $token
    ->tier('Free entry', key: 'free')
    ->reminders(['P1D', 'PT2H'])
    ->meta(['source' => 'import'])
    ->by($user)                                    // checks create (and organizer approval)
    ->create();                                    // a draft — or ->publish(): create + publish in one transaction

use RoundlyConsulting\Events\DataTransferObjects\CreateEventData;
use RoundlyConsulting\Events\DataTransferObjects\ScheduleData;
use RoundlyConsulting\Events\DataTransferObjects\TierData;
use RoundlyConsulting\Events\Facades\Events;

$event = Events::create(new CreateEventData(
    title: ['en' => 'Jazz Night'],
    organizer: $user,
    schedule: new ScheduleData(startsAt: '2026-11-14 20:00', duration: 'PT3H', timezone: 'Europe/Bratislava'),
    capacity: 120,
    tiers: [new TierData(name: 'Free entry', key: 'free')],
    actor: $user,
));

// OrganizesEvents: the builder with the organizer already set
$event = $team->organizeEvent(['en' => 'Hack night'])
    ->at($venue)
    ->startsAt('2026-12-03 18:00')
    ->by($user)                 // the team must allow $user (allowsEventManagementBy)
    ->publish();

use RoundlyConsulting\Events\DataTransferObjects\UpdateEventData;
use RoundlyConsulting\Events\Enums\GuestList;

Events::for($event)->by($user)->edit()
    ->description(null)                      // null clears a nullable field
    ->doorsOpenAt('2026-11-14 19:00')
    ->guestList(GuestList::Attendees)
    ->showCounts(false)
    ->save();

Events::for($event)->by($user)->edit()->title('Renamed')->capacity(150)->save();
Events::for($event)->update(new UpdateEventData(capacity: 150, description: null));   // the DTO form

Events::find($uuid);                         // live events only; no visibility rule — authorize view yourself
Events::findOrFail($uuid);                   // EventNotFoundException otherwise
Events::findBySlug('jazz-night', $viewer);   // along the locale chain; null for what $viewer may not see
Events::for($uuid);                          // a handle; an unknown or trashed uuid throws EventNotFoundException

Events::browse($viewer)->upcoming()->paginate();   // visible, listed (public), announced
Events::visibleTo($viewer)->get();                 // the policy's view as a query — managed drafts included

Events::for($event)->by($organizer)->poster($request->file('poster'));   // an UploadedFile or a local path
Events::for($event)->poster(draft: $token);    // media-library's upload-first flow
Events::for($event)->poster();                 // no file and no draft removes it

$event->poster;                  // ?Media
$event->posterUrl('card');       // the variant once generated, else the original, else events.poster.fallback_url

Events::for($event)->by($organizer)->transferTo($team, keepAsHost: true);
Events::for($event)->by($organizer)->delete();     // soft; refused while people are going (postpone or cancel first)
Events::for($event)->by($organizer)->restore();
Events::for($event)->delete(force: true);          // the row, its RSVPs, ticket types, co-hosts, invitations, tags and poster files