@wix/auto_sdk_calendar_events 1.0.32 → 1.0.34

package/build/cjs/{calendar-v3-event-events.universal-CLDnUCNu.d.ts → index.typings.d.ts}

@@ -1,3 +1,5 @@
+import { NonNullablePaths } from '@wix/sdk-types';
+
 /**
  * An event is a scheduled entry on a calendar that includes details like timing,
  * location, and participants. Each event is associated with
@@ -621,6 +623,8 @@ declare enum IdentityType {
     UNKNOWN = "UNKNOWN",
     WIX_USER = "WIX_USER"
 }
+/** @enumType */
+type IdentityTypeWithLiterals = IdentityType | 'UNKNOWN' | 'WIX_USER';
 interface ExtendedFields {
     /**
      * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
@@ -1312,7 +1316,7 @@ interface ListEventsRequest {
      * IDs of the events to retrieve.
      *
      * Min: 1 event ID
-     * Min: 100 event IDs
+     * Max: 100 event IDs
      * @minSize 1
      * @maxSize 100
      * @minLength 36
@@ -1821,6 +1825,16 @@ interface BulkCancelEventResponse {
     /** Total successes and failures. */
     bulkActionMetadata?: BulkActionMetadata;
 }
+type CancelEventApplicationErrors = {
+    code?: 'EVENT_ALREADY_CANCELLED';
+    description?: string;
+    data?: Record<string, any>;
+};
+type BulkCancelEventApplicationErrors = {
+    code?: 'EVENT_ALREADY_CANCELLED';
+    description?: string;
+    data?: Record<string, any>;
+};
 interface BaseEventMetadata {
     /**
      * App instance ID.
@@ -1869,18 +1883,139 @@ interface EventCancelledEnvelope {
     data: EventCancelled;
     metadata: EventMetadata;
 }
+/**
+ * Triggered when an event is canceled.
+ *
+ * Not triggered when `INSTANCE` events are canceled. You can use the
+ * [Events View API](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction)
+ * to get notified about `INSTANCE` events.
+ * @permissionScope Read Calendar - Including PI
+ * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
+ * @permissionScope Manage Calendars
+ * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
+ * @permissionScope Manage Bookings
+ * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
+ * @permissionScope Manage Bookings - all permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
+ * @permissionScope Read bookings calendar - including participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @webhook
+ * @eventType wix.calendar.v3.event_cancelled
+ * @slug cancelled
+ */
+declare function onEventCancelled(handler: (event: EventCancelledEnvelope) => void | Promise<void>): void;
 interface EventCreatedEnvelope {
     entity: Event;
     metadata: EventMetadata;
 }
+/**
+ * Triggered when an event is created, including when an existing `MASTER`
+ * event is split.
+ *
+ * Not triggered when `INSTANCE` events are created. You can use the
+ * [Events View API](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction)
+ * to get notified about `INSTANCE` events.
+ * @permissionScope Read Calendar - Including PI
+ * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
+ * @permissionScope Manage Calendars
+ * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
+ * @permissionScope Manage Bookings
+ * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
+ * @permissionScope Manage Bookings - all permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
+ * @permissionScope Read bookings calendar - including participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @webhook
+ * @eventType wix.calendar.v3.event_created
+ * @slug created
+ */
+declare function onEventCreated(handler: (event: EventCreatedEnvelope) => void | Promise<void>): void;
 interface EventRecurringSplitEnvelope {
     data: RecurringEventSplit;
     metadata: EventMetadata;
 }
+/**
+ * Triggered when a `MASTER` event is split.
+ * @permissionScope Read Calendar - Including PI
+ * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
+ * @permissionScope Manage Calendars
+ * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
+ * @permissionScope Manage Bookings
+ * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
+ * @permissionScope Manage Bookings - all permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
+ * @permissionScope Read bookings calendar - including participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @webhook
+ * @eventType wix.calendar.v3.event_recurring_split
+ * @slug recurring_split
+ */
+declare function onEventRecurringSplit(handler: (event: EventRecurringSplitEnvelope) => void | Promise<void>): void;
 interface EventUpdatedEnvelope {
     entity: Event;
     metadata: EventMetadata;
 }
+/**
+ * Triggered when an event is updated, including when it's canceled.
+ *
+ * Not triggered when `INSTANCE` events are updated. You can use the
+ * [Events View API](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction)
+ * to get notified about `INSTANCE` events.
+ * @permissionScope Read Calendar - Including PI
+ * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
+ * @permissionScope Manage Calendars
+ * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
+ * @permissionScope Manage Bookings
+ * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
+ * @permissionScope Manage Bookings - all permissions
+ * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
+ * @permissionScope Read bookings calendar - including participants
+ * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @webhook
+ * @eventType wix.calendar.v3.event_updated
+ * @slug updated
+ */
+declare function onEventUpdated(handler: (event: EventUpdatedEnvelope) => void | Promise<void>): void;
+type EventNonNullablePaths = `status` | `recurrenceType` | `recurrenceRule.frequency` | `recurrenceRule.days` | `transparency` | `location.type` | `resources` | `resources.${number}.transparency` | `resources.${number}.permissionRole` | `participants.list` | `participants.status` | `conferencingDetails.type` | `inheritedFields` | `permissions` | `permissions.${number}.identity.wixUserId` | `permissions.${number}.role`;
+/**
+ * Retrieves a list of events filtered by the participant's
+ * [contact](https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/introduction)
+ * ID.
+ *
+ *
+ * You can't set `toLocalDate` to a value that's more than a full year after
+ * `fromLocalDate`.
+ * @param contactId - ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+ * to retrieve events for. Required, unless you provide `cursorPaging`.
+ * @public
+ * @requiredField contactId
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @applicableIdentity APP
+ * @fqn wix.calendar.participantevents.v3.ParticipantEventsService.ListEventsByContactId
+ */
+declare function listEventsByContactId(contactId: string, options?: ListEventsByContactIdOptions): Promise<NonNullablePaths<ListEventsByContactIdResponse, {
+    [P in EventNonNullablePaths]: `events.${number}.${P}`;
+}[EventNonNullablePaths]>>;
 interface ListEventsByContactIdOptions {
     /**
      * Local start date and time from which events are returned in
@@ -1920,6 +2055,31 @@ interface ListEventsByContactIdOptions {
     /** Cursor to retrieve the next page of the results. */
     cursorPaging?: CommonCursorPaging;
 }
+/**
+ * Retrieves a list of events filtered by the participant's
+ * [member](https://dev.wix.com/docs/sdk/backend-modules/members/members/introduction)
+ * ID.
+ *
+ *
+ * You can't set `toLocalDate` to a value that's more than a full year after
+ * `fromLocalDate`.
+ * @param memberId - ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
+ * to retrieve events for. Required, unless you provide `cursorPaging`.
+ * Provide `me` to retrieve events for the currently logged-in member.
+ * You must have the `Read Calendars - Including PI`
+ * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
+ * to retrieve events for members who aren't the currently logged in member.
+ * @public
+ * @requiredField memberId
+ * @permissionId CALENDAR.EVENT_READ
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @applicableIdentity APP
+ * @applicableIdentity VISITOR
+ * @fqn wix.calendar.participantevents.v3.ParticipantEventsService.ListEventsByMemberId
+ */
+declare function listEventsByMemberId(memberId: string, options?: ListEventsByMemberIdOptions): Promise<NonNullablePaths<ListEventsByMemberIdResponse, {
+    [P in EventNonNullablePaths]: `events.${number}.${P}`;
+}[EventNonNullablePaths]>>;
 interface ListEventsByMemberIdOptions {
     /**
      * Local start date and time from which events are returned in
@@ -1969,6 +2129,22 @@ interface ListEventsByMemberIdOptions {
      */
     eventIds?: string[];
 }
+/**
+ * Retrieves an event.
+ * @param eventId - ID of the event to retrieve.
+ *
+ * Min: 36 characters
+ * Max: 250 characters
+ * @public
+ * @requiredField eventId
+ * @permissionId CALENDAR.EVENT_READ
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @applicableIdentity APP
+ * @applicableIdentity VISITOR
+ * @returns Retrieved event.
+ * @fqn wix.calendar.events.v3.EventsService.GetEvent
+ */
+declare function getEvent(eventId: string, options?: GetEventOptions): Promise<NonNullablePaths<Event, EventNonNullablePaths>>;
 interface GetEventOptions {
     /**
      * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
@@ -1993,6 +2169,23 @@ interface GetEventOptions {
      */
     fields?: RequestedFieldsWithLiterals[];
 }
+/**
+ * Retrieves a list of events by their IDs.
+ * @param eventIds - IDs of the events to retrieve.
+ *
+ * Min: 1 event ID
+ * Max: 100 event IDs
+ * @public
+ * @requiredField eventIds
+ * @permissionId CALENDAR.EVENT_READ
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @applicableIdentity APP
+ * @applicableIdentity VISITOR
+ * @fqn wix.calendar.events.v3.EventsService.ListEvents
+ */
+declare function listEvents(eventIds: string[], options?: ListEventsOptions): Promise<NonNullablePaths<ListEventsResponse, {
+    [P in EventNonNullablePaths]: `events.${number}.${P}`;
+}[EventNonNullablePaths]>>;
 interface ListEventsOptions {
     /**
      * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
@@ -2017,6 +2210,32 @@ interface ListEventsOptions {
      */
     fields?: RequestedFieldsWithLiterals[];
 }
+/**
+ * Creates a query to retrieve a list of events.
+ *
+ * The `queryEvents()` function builds a query to retrieve a list of events and returns an `EventsQueryBuilder` object.
+ *
+ * The returned object contains the query definition, which is typically used to run the query using the [find()](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/events-query-builder/find) function.
+ *
+ * You can refine the query by chaining `EventsQueryBuilder` functions onto the query. `EventsQueryBuilder` functions enable you to sort, filter, and control the results that `queryEvents()` returns.
+ *
+ * `queryEvents()` runs with the following `EventsQueryBuilder` default that you can override:
+ *
+ * + `limit` is `50`.
+ * + Sorted by `event.start` in ascending order.
+ *
+ * The functions that are chained to `queryEvents()` are applied in the order they are called.
+ *
+ * The following `EventsQueryBuilder` functions are supported for the `queryEvents()` function. For a full description of the events object, see the object returned for the [items](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/events-query-result/items) property in `EventsQueryResult`.
+ *
+ * @public
+ * @permissionId CALENDAR.EVENT_READ
+ * @permissionId CALENDAR.EVENT_READ_PI
+ * @applicableIdentity APP
+ * @applicableIdentity VISITOR
+ * @fqn wix.calendar.events.v3.EventsService.QueryEvents
+ */
+declare function queryEvents(options?: QueryEventsOptions): EventsQueryBuilder;
 interface QueryEventsOptions {
     /**
      * Local start date and time from which events are returned in
@@ -2125,6 +2344,37 @@ interface EventsQueryBuilder {
     skipTo: (cursor: string) => EventsQueryBuilder;
     find: () => Promise<EventsQueryResult>;
 }
+/**
+ * Creates an event.
+ *
+ *
+ * If you provide `recurrenceRule`, an event with `{"recurrenceType": "MASTER"}` is created. Then, you can't set `start.localDate` to a past date, though the time can be earlier on the same day. You can, however, create single-occurrence events for past dates.
+ *
+ * You can't create an event with `recurrenceType` set to `INSTANCE` or `EXCEPTION`. `INSTANCE` events are generated automatically based on the recurrence rule in the relevant `MASTER` event. `EXCEPTION` events are automatically created when you [update](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/update-event) an `INSTANCE` event, which changes its `recurrenceType` to `EXCEPTION`.
+ * @param event - Event to create.
+ * @public
+ * @requiredField event
+ * @requiredField event.conferencingDetails.guestUrl
+ * @requiredField event.conferencingDetails.hostUrl
+ * @requiredField event.conferencingDetails.type
+ * @requiredField event.end
+ * @requiredField event.end.localDate
+ * @requiredField event.location.type
+ * @requiredField event.participants.list.name
+ * @requiredField event.recurrenceRule.days
+ * @requiredField event.recurrenceRule.frequency
+ * @requiredField event.recurrenceRule.until.localDate
+ * @requiredField event.resources._id
+ * @requiredField event.scheduleId
+ * @requiredField event.start
+ * @requiredField event.start.localDate
+ * @permissionId CALENDAR.EVENT_CREATE_OWN
+ * @permissionId CALENDAR.EVENT_CREATE
+ * @applicableIdentity APP
+ * @returns Created event.
+ * @fqn wix.calendar.events.v3.EventsService.CreateEvent
+ */
+declare function createEvent(event: NonNullablePaths<Event, `conferencingDetails.guestUrl` | `conferencingDetails.hostUrl` | `conferencingDetails.type` | `end` | `end.localDate` | `location.type` | `participants.list.${number}.name` | `recurrenceRule.days` | `recurrenceRule.frequency` | `recurrenceRule.until.localDate` | `resources.${number}._id` | `scheduleId` | `start` | `start.localDate`>, options?: CreateEventOptions): Promise<NonNullablePaths<Event, EventNonNullablePaths>>;
 interface CreateEventOptions {
     /**
      * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
@@ -2141,6 +2391,46 @@ interface CreateEventOptions {
      */
     idempotencyKey?: string | null;
 }
+/**
+ * Creates multiple events in bulk.
+ *
+ *
+ * If you provide `recurrenceRule`, an event with `{"recurrenceType": "MASTER"}` is
+ * created. Then, you can't set `start.localDate` to a past date, though the time can be
+ * earlier on the same day. You can, however, create single-occurrence events for
+ * past dates.
+ *
+ * You can't create an event with `recurrenceType` set to `INSTANCE` or `EXCEPTION`.
+ * `INSTANCE` events are generated automatically based on the recurrence rule in the
+ * relevant `MASTER` event. `EXCEPTION` events are automatically created when you
+ * [update](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/update-event)
+ * an `INSTANCE` event, which changes its `recurrenceType` to `EXCEPTION`.
+ * @param events - Events to create.
+ * @public
+ * @requiredField events
+ * @requiredField events.event
+ * @requiredField events.event.conferencingDetails.guestUrl
+ * @requiredField events.event.conferencingDetails.hostUrl
+ * @requiredField events.event.conferencingDetails.type
+ * @requiredField events.event.end
+ * @requiredField events.event.end.localDate
+ * @requiredField events.event.location.type
+ * @requiredField events.event.participants.list.name
+ * @requiredField events.event.recurrenceRule.days
+ * @requiredField events.event.recurrenceRule.frequency
+ * @requiredField events.event.recurrenceRule.until.localDate
+ * @requiredField events.event.resources._id
+ * @requiredField events.event.scheduleId
+ * @requiredField events.event.start
+ * @requiredField events.event.start.localDate
+ * @permissionId CALENDAR.EVENT_CREATE_OWN
+ * @permissionId CALENDAR.EVENT_CREATE
+ * @applicableIdentity APP
+ * @fqn wix.calendar.events.v3.EventsService.BulkCreateEvent
+ */
+declare function bulkCreateEvent(events: NonNullablePaths<MaskedEvent, `event` | `event.conferencingDetails.guestUrl` | `event.conferencingDetails.hostUrl` | `event.conferencingDetails.type` | `event.end` | `event.end.localDate` | `event.location.type` | `event.participants.list.${number}.name` | `event.recurrenceRule.days` | `event.recurrenceRule.frequency` | `event.recurrenceRule.until.localDate` | `event.resources.${number}._id` | `event.scheduleId` | `event.start` | `event.start.localDate`>[], options?: BulkCreateEventOptions): Promise<NonNullablePaths<BulkCreateEventResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
+    [P in EventNonNullablePaths]: `results.${number}.item.${P}`;
+}[EventNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures`>>;
 interface BulkCreateEventOptions {
     /**
      * Whether to return created events.
@@ -2157,6 +2447,41 @@ interface BulkCreateEventOptions {
      */
     timeZone?: string | null;
 }
+/**
+ * Updates an event.
+ *
+ *
+ * When updating an event with `{"recurrenceType": "INSTANCE"}`, the
+ * `recurrenceType` automatically changes to `EXCEPTION`.
+ *
+ * When updating an event with `{"recurrenceType": "MASTER"}`:
+ * + Past `INSTANCE` and `EXCEPTION` events remain unchanged.
+ * + For future `INSTANCE` events, all relevant fields are updated.
+ * + For future `EXCEPTION` events, only changes to the `inheritedFields` are
+ * applied, while other fields remain unchanged.
+ * @param _id - Event ID.
+ * @public
+ * @requiredField _id
+ * @requiredField event
+ * @requiredField event.conferencingDetails.guestUrl
+ * @requiredField event.conferencingDetails.hostUrl
+ * @requiredField event.conferencingDetails.type
+ * @requiredField event.end.localDate
+ * @requiredField event.location.type
+ * @requiredField event.participants.list.name
+ * @requiredField event.recurrenceRule.days
+ * @requiredField event.recurrenceRule.frequency
+ * @requiredField event.recurrenceRule.until.localDate
+ * @requiredField event.resources._id
+ * @requiredField event.revision
+ * @requiredField event.start.localDate
+ * @permissionId CALENDAR.EVENT_UPDATE_OWN
+ * @permissionId CALENDAR.EVENT_UPDATE
+ * @applicableIdentity APP
+ * @returns Updated event.
+ * @fqn wix.calendar.events.v3.EventsService.UpdateEvent
+ */
+declare function updateEvent(_id: string, event: NonNullablePaths<UpdateEvent, `conferencingDetails.guestUrl` | `conferencingDetails.hostUrl` | `conferencingDetails.type` | `end.localDate` | `location.type` | `participants.list.${number}.name` | `recurrenceRule.days` | `recurrenceRule.frequency` | `recurrenceRule.until.localDate` | `resources.${number}._id` | `revision` | `start.localDate`>, options?: UpdateEventOptions): Promise<NonNullablePaths<Event, EventNonNullablePaths>>;
 interface UpdateEvent {
     /**
      * Event ID.
@@ -2403,6 +2728,46 @@ interface UpdateEventOptions {
      */
     timeZone?: string | null;
 }
+/**
+ * Updates multiple events in bulk.
+ *
+ *
+ * When updating an event with `{"recurrenceType": "INSTANCE"}`, the
+ * `recurrenceType` automatically changes to `EXCEPTION`.
+ *
+ * When updating an event with `{"recurrenceType": "MASTER"}`:
+ * + Past `INSTANCE` and `EXCEPTION` events remain unchanged.
+ * + For future `INSTANCE` events, all relevant fields are updated.
+ * + For future `EXCEPTION` events, only changes to the `inheritedFields` are
+ * applied, while other fields remain unchanged.
+ * @param events - Events to update.
+ *
+ * Min: 1 event
+ * Max: 50 events
+ * @public
+ * @requiredField events
+ * @requiredField events.event
+ * @requiredField events.event._id
+ * @requiredField events.event.conferencingDetails.guestUrl
+ * @requiredField events.event.conferencingDetails.hostUrl
+ * @requiredField events.event.conferencingDetails.type
+ * @requiredField events.event.end.localDate
+ * @requiredField events.event.location.type
+ * @requiredField events.event.participants.list.name
+ * @requiredField events.event.recurrenceRule.days
+ * @requiredField events.event.recurrenceRule.frequency
+ * @requiredField events.event.recurrenceRule.until.localDate
+ * @requiredField events.event.resources._id
+ * @requiredField events.event.revision
+ * @requiredField events.event.start.localDate
+ * @permissionId CALENDAR.EVENT_UPDATE_OWN
+ * @permissionId CALENDAR.EVENT_UPDATE
+ * @applicableIdentity APP
+ * @fqn wix.calendar.events.v3.EventsService.BulkUpdateEvent
+ */
+declare function bulkUpdateEvent(events: NonNullablePaths<BulkUpdateEventRequestMaskedEvent, `event` | `event._id` | `event.conferencingDetails.guestUrl` | `event.conferencingDetails.hostUrl` | `event.conferencingDetails.type` | `event.end.localDate` | `event.location.type` | `event.participants.list.${number}.name` | `event.recurrenceRule.days` | `event.recurrenceRule.frequency` | `event.recurrenceRule.until.localDate` | `event.resources.${number}._id` | `event.revision` | `event.start.localDate`>[], options?: BulkUpdateEventOptions): Promise<NonNullablePaths<BulkUpdateEventResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
+    [P in EventNonNullablePaths]: `results.${number}.item.${P}`;
+}[EventNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures`>>;
 interface BulkUpdateEventOptions {
     /**
      * Whether to return the updated events.
@@ -2424,6 +2789,37 @@ interface BulkUpdateEventOptions {
      */
     timeZone?: string | null;
 }
+/**
+ * Restores the event's default values from the relevant schedule or `MASTER`
+ * event.
+ *
+ *
+ * You must provide `fields` to specify which `inheritedFields` are restored.
+ *
+ * For example, if you've created an event that takes place in a non-default
+ * location with a custom title and capacity, but you want to reset only title
+ * and capacity to default values without affecting the location, provide the
+ * event ID and set `fields` to `["TITLE", "CAPACITY"]`.
+ *
+ * Refer to the [default values article](https://dev.wix.com/docs/sdk/backend-modules/calendar/default-values)
+ * for more information.
+ * @param eventId - ID of the event for which to restore default values.
+ * @param fields - Fields for which to restore default values.
+ *
+ * `TIME` restores default values for `start` and `end`.
+ *
+ * Min: 1 field
+ * @public
+ * @requiredField eventId
+ * @requiredField fields
+ * @permissionId CALENDAR.EVENT_UPDATE_OWN
+ * @permissionId CALENDAR.EVENT_UPDATE
+ * @applicableIdentity APP
+ * @fqn wix.calendar.events.v3.EventsService.RestoreEventDefaults
+ */
+declare function restoreEventDefaults(eventId: string, fields: FieldWithLiterals[], options?: RestoreEventDefaultsOptions): Promise<NonNullablePaths<RestoreEventDefaultsResponse, {
+    [P in EventNonNullablePaths]: `event.${P}`;
+}[EventNonNullablePaths]>>;
 interface RestoreEventDefaultsOptions {
     /**
      * Information about whether participants of the updated event are notified and
@@ -2439,6 +2835,51 @@ interface RestoreEventDefaultsOptions {
      */
     timeZone?: string | null;
 }
+/**
+ * Splits a recurring `MASTER` event into 2 separate `MASTER` events.
+ *
+ *
+ * You must provide a `splitLocalDate` that's in the future and after the `start`
+ * date of the next `INSTANCE` or `EXCEPTION` event in the series. Additionally,
+ * there must be another `INSTANCE` or `EXCEPTION` event following this next event,
+ * as the changes wouldn't affect any event without a subsequent occurrence.
+ *
+ * If you want to modify a `MASTER` event with the changes already applying to
+ * the very next event, use
+ * [updateEvent()](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/update-event)
+ * instead, as this preserves past events and only modifies future events.
+ *
+ * The main consequences are:
+ * - **The original `MASTER` event is shortened**. Its `recurrenceRule.until.localDate`
+ * is updated to `end.localDate` of the latest `INSTANCE` or `EXCEPTION`
+ * event starting before `splitLocalDate`. If an `INSTANCE` or `EXCEPTION` event
+ * starts before but ends after `splitLocalDate`, `until.localDate` is set
+ * to value that's later than `splitLocalDate`.
+ * - **A new `MASTER` event is created**, starting from the first event that
+ * begins after `splitLocalDate`.
+ * - **Existing `INSTANCE` and `EXCEPTION` events that occur after the split are updated**.
+ * Their `recurringEventId` is set to the ID of the newly created `MASTER` event.
+ * @param recurringEventId - ID of the `MASTER` event to split.
+ * @param splitLocalDate - Local date and time at which the `MASTER` event is split in
+ * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+ * `2025-03-11T09:00:00`.
+ * Must be a future date that's after the `start` date of the next `INSTANCE` or
+ * `EXCEPTION` event in the series. Additionally, there must be another
+ * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
+ * wouldn't affect any event without a subsequent occurrence.
+ * @public
+ * @requiredField recurringEventId
+ * @requiredField splitLocalDate
+ * @permissionId CALENDAR.EVENT_UPDATE_OWN
+ * @permissionId CALENDAR.EVENT_UPDATE
+ * @applicableIdentity APP
+ * @fqn wix.calendar.events.v3.EventsService.SplitRecurringEvent
+ */
+declare function splitRecurringEvent(recurringEventId: string, splitLocalDate: string, options?: SplitRecurringEventOptions): Promise<NonNullablePaths<SplitRecurringEventResponse, {
+    [P in EventNonNullablePaths]: `updatedRecurringEventEndingBeforeSplit.${P}`;
+}[EventNonNullablePaths] | {
+    [P in EventNonNullablePaths]: `newRecurringEventStartingFromSplit.${P}`;
+}[EventNonNullablePaths]>>;
 interface SplitRecurringEventOptions {
     /**
      * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
@@ -2449,6 +2890,21 @@ interface SplitRecurringEventOptions {
      */
     timeZone?: string | null;
 }
+/**
+ * Cancels an event.
+ * @param eventId - ID of the event to cancel.
+ * @public
+ * @requiredField eventId
+ * @permissionId CALENDAR.EVENT_CANCEL_OWN
+ * @permissionId CALENDAR.EVENT_CANCEL
+ * @applicableIdentity APP
+ * @fqn wix.calendar.events.v3.EventsService.CancelEvent
+ */
+declare function cancelEvent(eventId: string, options?: CancelEventOptions): Promise<NonNullablePaths<CancelEventResponse, {
+    [P in EventNonNullablePaths]: `event.${P}`;
+}[EventNonNullablePaths]> & {
+    __applicationErrorsType?: CancelEventApplicationErrors;
+}>;
 interface CancelEventOptions {
     /**
      * Information about whether participants of the canceled event are notified and
@@ -2464,6 +2920,21 @@ interface CancelEventOptions {
      */
     timeZone?: string | null;
 }
+/**
+ * Cancels multiple events in bulk.
+ * @param eventIds - IDs of the events to cancel.
+ * @public
+ * @requiredField eventIds
+ * @permissionId CALENDAR.EVENT_CANCEL_OWN
+ * @permissionId CALENDAR.EVENT_CANCEL
+ * @applicableIdentity APP
+ * @fqn wix.calendar.events.v3.EventsService.BulkCancelEvent
+ */
+declare function bulkCancelEvent(eventIds: string[], options?: BulkCancelEventOptions): Promise<NonNullablePaths<BulkCancelEventResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
+    [P in EventNonNullablePaths]: `results.${number}.item.${P}`;
+}[EventNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures`> & {
+    __applicationErrorsType?: BulkCancelEventApplicationErrors;
+}>;
 interface BulkCancelEventOptions {
     /**
      * Whether to return the canceled events.
@@ -2486,4 +2957,4 @@ interface BulkCancelEventOptions {
     timeZone?: string | null;
 }
 
-export { type Participants as $, Type as A, type BulkCreateEventOptions as B, type CreateEventOptions as C, Day as D, type Event as E, type FieldWithLiterals as F, type GetEventOptions as G, Field as H, IdentityType as I, PlacementType as J, DayOfWeek as K, type ListEventsByContactIdOptions as L, type MaskedEvent as M, ResolutionMethod as N, RequestedFields as O, ParticipantsStatus as P, type QueryEventsOptions as Q, type RestoreEventDefaultsOptions as R, type SplitRecurringEventOptions as S, Transparency as T, type UpdateEvent as U, SortOrder as V, WebhookIdentityType as W, type RecurrenceRule as X, type Location as Y, type ZonedDate as Z, type Resource as _, type ListEventsByContactIdResponse as a, type CreateEventRequest as a$, type Participant as a0, type ConferencingDetails as a1, type Permission as a2, type CommonIdentificationData as a3, type CommonIdentificationDataIdOneOf as a4, type ExtendedFields as a5, type RecurringEventSplit as a6, type EventCancelled as a7, type ParticipantNotification as a8, type EventUpdatedWithMetadata as a9, type GeoCoordinates as aA, type BusinessSchedule as aB, type TimePeriod as aC, type SpecialHourPeriod as aD, type Multilingual as aE, type SupportedLanguage as aF, type ConsentPolicy as aG, type Translation as aH, type ChangeContext as aI, type ChangeContextPayloadOneOf as aJ, type PropertiesChange as aK, type SiteCreated as aL, type SiteCloned as aM, type Empty as aN, type GetEventRequest as aO, type GetEventResponse as aP, type ListEventsRequest as aQ, type QueryEventsRequest as aR, type CursorQuery as aS, type CursorQueryPagingMethodOneOf as aT, type Sorting as aU, type CursorPaging as aV, type QueryEventsResponse as aW, type CursorPagingMetadata as aX, type Cursors as aY, type ListRecurringEventInstancesHistoryRequest as aZ, type ListRecurringEventInstancesHistoryResponse as a_, type UpdateScheduleWithFixedBusinessResourceIdRequest as aa, type UpdateScheduleWithFixedBusinessResourceIdResponse as ab, type UpdateEventsWithFixedBusinessResourceIdRequest as ac, type UpdateEventsWithFixedBusinessResourceIdResponse as ad, type DomainEvent as ae, type DomainEventBodyOneOf as af, type EntityCreatedEvent as ag, type RestoreInfo as ah, type EntityUpdatedEvent as ai, type EntityDeletedEvent as aj, type ActionEvent as ak, type MessageEnvelope as al, type IdentificationData as am, type IdentificationDataIdOneOf as an, type ListEventsByContactIdRequest as ao, type CommonCursorPaging as ap, type CommonCursorPagingMetadata as aq, type CommonCursors as ar, type ListEventsByMemberIdRequest as as, type SitePropertiesNotification as at, type SitePropertiesEvent as au, type Properties as av, type Categories as aw, type Locale as ax, type Address as ay, type AddressHint as az, type ListEventsByMemberIdOptions as b, type CreateEventResponse as b0, type BulkCreateEventRequest as b1, type BulkEventResult as b2, type ItemMetadata as b3, type ApplicationError as b4, type BulkActionMetadata as b5, type UpdateEventRequest as b6, type UpdateEventResponse as b7, type BulkUpdateEventRequest as b8, type UpdateEventParticipantsRequest as b9, type UpdateEventParticipantsResponse as ba, type RestoreEventDefaultsRequest as bb, type SplitRecurringEventRequest as bc, type CancelEventRequest as bd, type BulkCancelEventRequest as be, type BaseEventMetadata as bf, type EventMetadata as bg, type EventsQueryResult as bh, type ListEventsByMemberIdResponse as c, type ListEventsOptions as d, type ListEventsResponse as e, type EventsQueryBuilder as f, type BulkCreateEventResponse as g, type UpdateEventOptions as h, type BulkUpdateEventRequestMaskedEvent as i, type BulkUpdateEventOptions as j, type BulkUpdateEventResponse as k, type RestoreEventDefaultsResponse as l, type SplitRecurringEventResponse as m, type CancelEventOptions as n, type CancelEventResponse as o, type BulkCancelEventOptions as p, type BulkCancelEventResponse as q, type EventCancelledEnvelope as r, type EventCreatedEnvelope as s, type EventRecurringSplitEnvelope as t, type EventUpdatedEnvelope as u, Status as v, RecurrenceType as w, Frequency as x, LocationType as y, Role as z };
+export { type ActionEvent, type Address, type AddressHint, type ApplicationError, type BaseEventMetadata, type BulkActionMetadata, type BulkCancelEventApplicationErrors, type BulkCancelEventOptions, type BulkCancelEventRequest, type BulkCancelEventResponse, type BulkCreateEventOptions, type BulkCreateEventRequest, type BulkCreateEventResponse, type BulkEventResult, type BulkUpdateEventOptions, type BulkUpdateEventRequest, type BulkUpdateEventRequestMaskedEvent, type BulkUpdateEventResponse, type BusinessSchedule, type CancelEventApplicationErrors, type CancelEventOptions, type CancelEventRequest, type CancelEventResponse, type Categories, type ChangeContext, type ChangeContextPayloadOneOf, type CommonCursorPaging, type CommonCursorPagingMetadata, type CommonCursors, type CommonIdentificationData, type CommonIdentificationDataIdOneOf, type ConferencingDetails, type ConsentPolicy, type CreateEventOptions, type CreateEventRequest, type CreateEventResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, Day, DayOfWeek, type DayOfWeekWithLiterals, type DayWithLiterals, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type Event, type EventCancelled, type EventCancelledEnvelope, type EventCreatedEnvelope, type EventMetadata, type EventRecurringSplitEnvelope, type EventUpdatedEnvelope, type EventUpdatedWithMetadata, type EventsQueryBuilder, type EventsQueryResult, type ExtendedFields, Field, type FieldWithLiterals, Frequency, type FrequencyWithLiterals, type GeoCoordinates, type GetEventOptions, type GetEventRequest, type GetEventResponse, type IdentificationData, type IdentificationDataIdOneOf, IdentityType, type IdentityTypeWithLiterals, type ItemMetadata, type ListEventsByContactIdOptions, type ListEventsByContactIdRequest, type ListEventsByContactIdResponse, type ListEventsByMemberIdOptions, type ListEventsByMemberIdRequest, type ListEventsByMemberIdResponse, type ListEventsOptions, type ListEventsRequest, type ListEventsResponse, type ListRecurringEventInstancesHistoryRequest, type ListRecurringEventInstancesHistoryResponse, type Locale, type Location, LocationType, type LocationTypeWithLiterals, type MaskedEvent, type MessageEnvelope, type Multilingual, type Participant, type ParticipantNotification, type Participants, ParticipantsStatus, type ParticipantsStatusWithLiterals, type Permission, PlacementType, type PlacementTypeWithLiterals, type Properties, type PropertiesChange, type QueryEventsOptions, type QueryEventsRequest, type QueryEventsResponse, type RecurrenceRule, RecurrenceType, type RecurrenceTypeWithLiterals, type RecurringEventSplit, RequestedFields, type RequestedFieldsWithLiterals, ResolutionMethod, type ResolutionMethodWithLiterals, type Resource, type RestoreEventDefaultsOptions, type RestoreEventDefaultsRequest, type RestoreEventDefaultsResponse, type RestoreInfo, Role, type RoleWithLiterals, type SiteCloned, type SiteCreated, type SitePropertiesEvent, type SitePropertiesNotification, SortOrder, type SortOrderWithLiterals, type Sorting, type SpecialHourPeriod, type SplitRecurringEventOptions, type SplitRecurringEventRequest, type SplitRecurringEventResponse, Status, type StatusWithLiterals, type SupportedLanguage, type TimePeriod, type Translation, Transparency, type TransparencyWithLiterals, Type, type TypeWithLiterals, type UpdateEvent, type UpdateEventOptions, type UpdateEventParticipantsRequest, type UpdateEventParticipantsResponse, type UpdateEventRequest, type UpdateEventResponse, type UpdateEventsWithFixedBusinessResourceIdRequest, type UpdateEventsWithFixedBusinessResourceIdResponse, type UpdateScheduleWithFixedBusinessResourceIdRequest, type UpdateScheduleWithFixedBusinessResourceIdResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, type ZonedDate, bulkCancelEvent, bulkCreateEvent, bulkUpdateEvent, cancelEvent, createEvent, getEvent, listEvents, listEventsByContactId, listEventsByMemberId, onEventCancelled, onEventCreated, onEventRecurringSplit, onEventUpdated, queryEvents, restoreEventDefaults, splitRecurringEvent, updateEvent };