useLocations

An event type can offer one or more locations: an online meeting link, a phone call, an in-person address. The list comes from the remote configuration.

import { useLocations } from "@zaptime/core";

const { locations, setLocations, isPhoneCall } = useLocations(calendarId?);

Set locations

Called during initialization with locations from the remote configuration.

setLocations(remote.locations);

Locations

type Location = {
  type: string; // e.g. "online", "phone-call", "in-person"
  value: string; // display value or provider key
  default?: boolean;
};

locations.value; // Location[]

Is phone call

true when one of the locations is a phone call. The built-in UI uses it to make the phone field mandatory.

isPhoneCall.value;

Booking with a location

book and reserve accept a location. When omitted, the first location of the event type is used.

await book({
  email,
  location: locations.value.find((l) => l.default) ?? locations.value[0],
});

Render a picker when there is more than one location and let the attendee choose.