# Install the package
composer require srwiez/nativephp-mobile-calendar
 
# Publish the plugins provider (first time only)
php artisan vendor:publish --tag=nativephp-plugins-provider
 
# Register the plugin
php artisan native:plugin:register srwiez/nativephp-mobile-calendar
 
# Verify registration
php artisan native:plugin:list

use SRWieZ\NativePHP\Mobile\Calendar\Facades\Calendar;
use SRWieZ\NativePHP\Mobile\Calendar\Enums\CalendarAccessLevel;
 
// Check current permission status (no user interaction)
$status = Calendar::checkPermission();
// Returns: 'not_determined', 'denied', 'restricted', 'write_only', 'full_access'
 
// Request full access (read + write)
$result = Calendar::requestAccess(CalendarAccessLevel::Full);
 
// Request write-only access (iOS 17+ only)
$result = Calendar::requestAccess(CalendarAccessLevel::Write);
 
if ($result['granted']) {
    // Permission granted
}

// Get all calendars
$calendars = Calendar::calendars()->get();
 
// Get only writable calendars
$calendars = Calendar::calendars()->writable()->get();
 
// Get default calendar
$default = Calendar::getDefaultCalendar();
 
// Calendar properties: id, name, color, accountName, isPrimary, isReadOnly, isDeletable

$calendar = Calendar::createCalendar(
    title: 'My App Calendar',
    color: '#FF5733'
);

$deleted = Calendar::deleteCalendar($calendarId);

use SRWieZ\NativePHP\Mobile\Calendar\Facades\Calendar;
 
// Query events with fluent builder
$events = Calendar::events()
    ->calendarId($calendarId)
    ->between(now(), now()->addMonth())
    ->search('meeting')
    ->limit(50)
    ->get();
 
// Get a single event
$event = Calendar::getEvent($eventId);

use SRWieZ\NativePHP\Mobile\Calendar\Data\EventData;
use SRWieZ\NativePHP\Mobile\Calendar\Data\RecurrenceRule;
use SRWieZ\NativePHP\Mobile\Calendar\Data\Alarm;
use SRWieZ\NativePHP\Mobile\Calendar\Enums\DayOfWeek;
 
// Simple event
$event = Calendar::createEvent([
    'title' => 'Team Meeting',
    'startDate' => now()->addDay()->timestamp,
    'endDate' => now()->addDay()->addHour()->timestamp,
    'location' => 'Conference Room A',
]);
 
// Using fluent builder
$event = Calendar::createEvent(
    EventData::make('Weekly Standup')
        ->startsAt(now()->next(DayOfWeek::Monday)->setHour(10))
        ->endsAt(now()->next(DayOfWeek::Monday)->setHour(10, 30))
        ->at('Virtual - Zoom')
        ->describedAs('Team weekly sync meeting')
        ->inCalendar($calendarId)
        ->repeating(
            RecurrenceRule::weekly()
                ->onDays(DayOfWeek::Monday)
                ->count(12)
        )
        ->withAlarm(Alarm::minutesBefore(15))
        ->withAlarm(Alarm::hoursBefore(1))
);

$event = Calendar::createEvent(
    EventData::make('Team Meeting')
        ->from(now()->addDay(), now()->addDay()->addHour())
        ->inCalendar($calendarId)
);
 
if ($event) {
    // Persist the native event ID for future lookups
    $user->calendarEvents()->create([
        'native_event_id' => $event->id,
        'title' => $event->title,
    ]);
 
    // Later, retrieve the event from the native calendar
    $nativeEvent = Calendar::getEvent($event->id);
}

$updated = Calendar::updateEvent($eventId, [
    'title' => 'Updated Title',
    'location' => 'New Location',
]);
 
// Or with EventData
$updated = Calendar::updateEvent($eventId,
    EventData::make('Updated Meeting')
        ->startsAt($newStart)
        ->endsAt($newEnd)
);

// Delete single event
Calendar::deleteEvent($eventId);
 
// Delete all occurrences of a recurring event
Calendar::deleteEvent($eventId, deleteAllOccurrences: true);

use SRWieZ\NativePHP\Mobile\Calendar\Data\RecurrenceRule;
use SRWieZ\NativePHP\Mobile\Calendar\Enums\DayOfWeek;
use SRWieZ\NativePHP\Mobile\Calendar\Enums\RecurrenceFrequency;
 
// Daily for 10 occurrences
$rule = RecurrenceRule::daily()->count(10);
 
// Weekly on Monday and Wednesday until date
$rule = RecurrenceRule::weekly()
    ->onDays(DayOfWeek::Monday, DayOfWeek::Wednesday)
    ->until(now()->addMonths(6));
 
// Monthly on the 15th
$rule = RecurrenceRule::monthly()
    ->onDayOfMonth(15)
    ->count(12);
 
// Every 2 weeks
$rule = RecurrenceRule::make(RecurrenceFrequency::Weekly)
    ->interval(2)
    ->count(26);
 
// Get instances of a recurring event
$instances = Calendar::getEventInstances(
    $eventId,
    now(),
    now()->addMonths(3)
);

use SRWieZ\NativePHP\Mobile\Calendar\Data\Alarm;
use SRWieZ\NativePHP\Mobile\Calendar\Enums\AlarmMethod;
 
// Add alarm to existing event
Calendar::addAlarm($eventId, Alarm::minutesBefore(30));
Calendar::addAlarm($eventId, Alarm::hoursBefore(1));
Calendar::addAlarm($eventId, Alarm::daysBefore(1));
 
// Alarm with specific method (Android)
Calendar::addAlarm($eventId,
    Alarm::minutesBefore(15)->method(AlarmMethod::Email)
);
 
// Remove alarm by index
Calendar::removeAlarm($eventId, alarmIndex: 0);

use SRWieZ\NativePHP\Mobile\Calendar\Data\Attendee;
use SRWieZ\NativePHP\Mobile\Calendar\Enums\AttendeeType;
 
// Get attendees
$attendees = Calendar::getAttendees($eventId);
 
// Add attendee (Android only - throws UnsupportedPlatformException on iOS)
try {
    Calendar::addAttendee($eventId,
        Attendee::make('[email protected]')
            ->name('John Doe')
            ->type(AttendeeType::Required)
    );
} catch (UnsupportedPlatformException $e) {
    // Use calendar URI helpers instead for cross-platform support
}

Calendar::isAvailable();    // the plugin's native side is installed
Calendar::canAddAttendee(); // true on Android, false on iOS
 
if (Calendar::canAddAttendee()) {
    Calendar::addAttendee($eventId, Attendee::make('[email protected]'));
}

// Open to add event (uses Intent on Android - no permission needed)
Calendar::openCalendarToAdd(
    EventData::make('Quick Event')
        ->startsAt(now()->addHour())
        ->endsAt(now()->addHours(2))
);
 
// Open to edit existing event
Calendar::openCalendarToEdit($eventId);
 
// Open calendar to view specific date
Calendar::openCalendarToView(now()->addWeek());
 
// Open calendar to today
Calendar::openCalendarToView();

// Start listening for event changes
Calendar::startChangeListener(trackEvents: true);
 
// Also detect calendar create/delete (e.g. from external apps)
Calendar::startChangeListener(trackEvents: true, trackCalendars: true);
 
// In your Livewire component (see Events below for v4 native screens)
use Livewire\Attributes\On;
use SRWieZ\NativePHP\Mobile\Calendar\Events\CalendarChanged;
use SRWieZ\NativePHP\Mobile\Calendar\Events\CalendarCreated;
use SRWieZ\NativePHP\Mobile\Calendar\Events\CalendarDeleted;
 
#[On('native:'.CalendarChanged::class)]
public function handleCalendarChanged(string $changeType, array $eventIds = [])
{
    $this->loadEvents();
}
 
#[On('native:'.CalendarCreated::class)]
public function handleCalendarCreated(string $calendarId, string $name = '')
{
    $this->loadCalendars();
}
 
#[On('native:'.CalendarDeleted::class)]
public function handleCalendarDeleted(string $calendarId)
{
    $this->loadCalendars();
}
 
// Stop listening when done
Calendar::stopChangeListener();

use SRWieZ\NativePHP\Mobile\Calendar\Data\EventData;
 
$event = EventData::make('Conference Talk')
    ->startsAt(now()->addWeek())
    ->endsAt(now()->addWeek()->addHours(2))
    ->at('Convention Center')
    ->describedAs('My talk on NativePHP');
 
// Google Calendar
$url = Calendar::generateGoogleCalendarUrl($event);
 
// Outlook.com
$url = Calendar::generateOutlookUrl($event);
 
// Office 365
$url = Calendar::generateOffice365Url($event);
 
// Yahoo Calendar
$url = Calendar::generateYahooUrl($event);
 
// Webcal subscription URL
$url = Calendar::generateWebcalUrl('https://example.com/calendar.ics');
 
// Generate ICS file content
$ics = Calendar::generateIcsContent($event);
 
// Generate ICS for multiple events
$ics = Calendar::generateIcsContent([$event1, $event2, $event3]);
 
// Generate data URI for download link
$dataUri = Calendar::generateIcsDataUri($event);
// Use in HTML: <a href="{{ $dataUri }}" download="event.ics">Download</a>

use Native\Mobile\Attributes\On;
use Native\Mobile\Edge\NativeComponent;
use SRWieZ\NativePHP\Mobile\Calendar\Events\EventCreated;
 
class AgendaScreen extends NativeComponent
{
    #[On(EventCreated::class)]
    public function eventCreated(string $eventId, string $calendarId = '', string $title = ''): void
    {
        // ...
    }
}

use Livewire\Attributes\On;
use Livewire\Component;
use SRWieZ\NativePHP\Mobile\Calendar\Events\CalendarAccessDenied;
 
class AgendaScreen extends Component
{
    #[On('native:'.CalendarAccessDenied::class)]
    public function accessDenied(string $reason): void
    {
        // ...
    }
}

use Illuminate\Support\Facades\Event;
use SRWieZ\NativePHP\Mobile\Calendar\Events\EventCreated;
 
Event::listen(function (EventCreated $event) {
    logger()->info('Calendar event created', ['id' => $event->eventId]);
});

import { mobileCalendar } from '../../vendor/srwiez/nativephp-mobile-calendar/resources/js/mobileCalendar.js';
 
// Request permission
const { granted, status } = await mobileCalendar.requestAccess('full');
 
// Get calendars
const { calendars } = await mobileCalendar.getCalendars();
 
// Create event
const { success, event } = await mobileCalendar.createEvent({
    title: 'Meeting',
    startDate: Math.floor(Date.now() / 1000) + 86400,
    endDate: Math.floor(Date.now() / 1000) + 90000,
    location: 'Office'
});
 
// Open native calendar app
await mobileCalendar.openCalendarToAdd({
    title: 'Quick Event',
    startDate: Math.floor(Date.now() / 1000) + 3600,
    endDate: Math.floor(Date.now() / 1000) + 7200
});

$result = Calendar::requestAccess(CalendarAccessLevel::Full);
 
if (! $result['granted']) {
    // Don't attempt calendar operations — they will return empty/null
    return;
}

// Correct: Carbon timestamps work directly
$event = EventData::make('Meeting')
    ->from(now()->addDay(), now()->addDay()->addHour());
 
// Also correct: raw Unix timestamp in seconds
$event = Calendar::createEvent([
    'title' => 'Meeting',
    'startDate' => now()->addDay()->timestamp,
    'endDate' => now()->addDay()->addHour()->timestamp,
]);

const startDate = Math.floor(Date.now() / 1000) + 3600;

// When your component is destroyed or no longer needs updates
Calendar::stopChangeListener();