@wix/calendar 1.0.30 → 1.0.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/calendar",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -18,10 +18,10 @@
     "type-bundles"
   ],
   "dependencies": {
-    "@wix/calendar_event-views": "1.0.5",
-    "@wix/calendar_events": "1.0.17",
-    "@wix/calendar_participations": "1.0.7",
-    "@wix/calendar_schedule-time-frames": "1.0.13",
+    "@wix/calendar_event-views": "1.0.6",
+    "@wix/calendar_events": "1.0.18",
+    "@wix/calendar_participations": "1.0.8",
+    "@wix/calendar_schedule-time-frames": "1.0.14",
     "@wix/calendar_schedules": "1.0.18"
   },
   "devDependencies": {
@@ -47,5 +47,5 @@
       "fqdn": ""
     }
   },
-  "falconPackageHash": "ac76a7955f99ae519136b3df615a562d027153f75aa02648e107370c"
+  "falconPackageHash": "a103c195dff3b85cd19ed1bb33bb62944dbc27e23f2ea43d164af160"
 }

package/type-bundles/context.bundle.d.ts

@@ -704,71 +704,96 @@ declare enum Status$4 {
 /** A date time with a time zone, having the UTC offset and date determined by the server. */
 interface ZonedDate$2 {
     /**
-     * Local date time, in ISO-8601 format.
-     * E.g, "2024-01-30T13:30:00".
-     *
-     * Note: seconds are not supported and ignored.
+     * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2024-01-30T13:30:00`.
+     * Wix Calendar APIs ignore seconds.
      */
     localDate?: string | null;
     /**
-     * The event time zone.
+     * Time zone in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * For example, `America/New_York`.
      * @readonly
      */
     timeZone?: string | null;
     /**
-     * The UTC date determined by the server.
-     * Not returned for adjusted dates.
+     * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2024-01-30T13:30:00`.
+     * Not available for adjusted date fields.
      * @readonly
      */
     utcDate?: Date | null;
 }
 declare enum RecurrenceType$1 {
     UNKNOWN_RECURRENCE_TYPE = "UNKNOWN_RECURRENCE_TYPE",
-    /** No recurrence, i.e the event is a single event instance. Default. */
+    /** The event occurs only once and doesn't repeat. */
     NONE = "NONE",
-    /** The event is the recurrence master defining the recurrence rule, which is the repeat pattern for the events. */
+    /** Defines the recurrence pattern for a series of recurring events. */
     MASTER = "MASTER",
-    /** The event is an instance of a recurring event. Read only. */
+    /** A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`. */
     INSTANCE = "INSTANCE",
-    /** The event is an exceptional instance of a recurring event. Read only. */
+    /** A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event. */
     EXCEPTION = "EXCEPTION"
 }
 interface RecurrenceRule$1 {
-    /** The frequency with which the event should be repeated. */
+    /**
+     * Frequency how often the event repeats. Works together with `interval`.
+     *
+     * Supported values:
+     * + `WEEKLY`: The event's recurrence pattern is based on weeks.
+     */
     frequency?: Frequency$1;
     /**
-     * Works together with `frequency` to specify how often the event should be repeated. Default is `1`.
-     * For example, `WEEKLY` frequency and `interval` of `2` means once every two weeks.
+     * Interval how often the event repeats. Works together with `frequency`.
+     * For example, `frequency` set to `WEEKLY`  and `interval` set to `2` means
+     * the event repeats every 2 weeks.
+     *
+     * Min: `1`
+     * Max: `4`
+     * Default: `1`
      */
     interval?: number | null;
     /**
-     * The days of the week when the event should be repeated.
+     * Days of the week when the recurring event takes place.
      * Currently, only a single day is supported.
+     *
+     * Min: 1 day
+     * Max: 1 day
      */
     days?: Day$1[];
     /**
-     * The date until which the event should be repeated.
-     * When it is not specified, the event repeats forever.
+     * Date until when the event repeats.
+     * If not specified, the event repeats forever.
      */
     until?: ZonedDate$2;
     /**
-     * Read-only until date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Date until when the event repeats
+     * adjusted to the `timeZone` of the business
+     * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedUntil?: ZonedDate$2;
 }
 declare enum Frequency$1 {
     UNKNOWN_FREQUENCY = "UNKNOWN_FREQUENCY",
-    /** The event repeats every few weeks. */
+    /** The event's recurrence pattern is based on weeks. */
     WEEKLY = "WEEKLY"
 }
 declare enum Day$1 {
+    /** The recurring event takes place on Mondays. */
     MONDAY = "MONDAY",
+    /** The recurring event takes place on Tuesdays. */
     TUESDAY = "TUESDAY",
+    /** The recurring event takes place on Wednesday. */
     WEDNESDAY = "WEDNESDAY",
+    /** The recurring event takes place on Thursdays. */
     THURSDAY = "THURSDAY",
+    /** The recurring event takes place on Fridays. */
     FRIDAY = "FRIDAY",
+    /** The recurring event takes place on Saturdays. */
     SATURDAY = "SATURDAY",
+    /** The recurring event takes place on Sundays. */
     SUNDAY = "SUNDAY"
 }
 declare enum Transparency$1 {
@@ -813,24 +838,33 @@ declare enum LocationType$2 {
     CUSTOM = "CUSTOM"
 }
 interface Resource$1 {
-    /** The resource ID. */
+    /** Resource ID. */
     _id?: string | null;
     /**
-     * The resource name.
+     * Resource name.
      * @readonly
      */
     name?: string | null;
     /**
-     * The resource type.
+     * Resource type.
      * @readonly
      */
     type?: string | null;
     /**
-     * Specifies whether the event blocks the resource time.
-     * Default is `OPAQUE`.
+     * Specifies whether the event blocks time in the resource's schedule.
+     *
+     * Supported values:
+     * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same resource from being scheduled at the same time.
+     * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
+     *
+     * Default: `OPAQUE`.
      */
     transparency?: Transparency$1;
-    /** Optional permission role to grant the identities associated with the resource. */
+    /**
+     * Permission role associated with the resource. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
+     */
     permissionRole?: Role$2;
 }
 declare enum Role$2 {
@@ -841,36 +875,57 @@ declare enum Role$2 {
     COMMENTER = "COMMENTER"
 }
 interface Participants$1 {
-    /** The total number of participants. */
+    /**
+     * Total number of participants.
+     *
+     * Min: `0`
+     */
     total?: number | null;
-    /** A full or partial list of the participants. */
+    /**
+     * Full or partial list of the participants.
+     *
+     * Max: 50 participants
+     */
     list?: Participant$2[];
-    /** Whether there are more participants for the event which were not listed. */
+    /**
+     * Whether there are more participants for the event than listed.
+     *
+     * + `false`: The list includes all participants.
+     * + `true`: The list doesn't include all participants.
+     */
     hasMore?: boolean | null;
     /**
-     * The participants status.
+     * Participant's status.
      *
-     * The possible values are:
-     * - `"CONFIRMED"` All participants are confirmed.
-     * - `"PENDING_CONFIRMATION"` Some participants are pending confirmation..
+     * Supported values:
+     * + `CONFIRMED`: All participants are confirmed.
+     * + `PENDING_CONFIRMATION`: At least one participant isn't confirmed yet.
      */
     status?: ParticipantsStatus$1;
 }
 interface Participant$2 {
-    /** The participant name. */
+    /**
+     * Participant name.
+     *
+     * Min: 1 character
+     * Max: 200 characters
+     */
     name?: string | null;
-    /** The participant phone. */
+    /** Participant's phone number. */
     phone?: string | null;
-    /** The participant email address. */
+    /** Participant's email address. */
     email?: string | null;
-    /** The ID of the Wix contact. */
+    /**
+     * [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+     * ID of the parcipant.
+     */
     contactId?: string | null;
 }
 declare enum ParticipantsStatus$1 {
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
     /** All participants are confirmed. */
     CONFIRMED = "CONFIRMED",
-    /** Some participants are pending confirmation. */
+    /** At least one participant isn't confirmed yet. */
     PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
 }
 interface ConferencingDetails$2 {
@@ -2709,6 +2764,11 @@ interface QueryEventsSignature {
      * or [List Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/list-events)
      * instead.
      *
+     * You can't query by the participant's contact or member ID, to do so use
+     * [List Events by Contact ID](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/list-events-by-contact-id)
+     * or [List Events by Member ID](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/list-events-by-member-id)
+     * instead.
+     *
      * Query Events runs with these defaults, which you can override:
      * - sorted by `start` in `ASC` order
      * - `cursorPaging.limit` is `50`
@@ -3061,7 +3121,12 @@ declare namespace context$4 {
   export { type ActionEvent$4 as ActionEvent, type Address$2 as Address, type AddressHint$2 as AddressHint, type context$4_ApplicationError as ApplicationError, type BaseEventMetadata$4 as BaseEventMetadata, type context$4_BulkActionMetadata as BulkActionMetadata, type context$4_BulkCancelEventOptions as BulkCancelEventOptions, type context$4_BulkCancelEventRequest as BulkCancelEventRequest, type context$4_BulkCancelEventResponse as BulkCancelEventResponse, type context$4_BulkCancelEventResponseNonNullableFields as BulkCancelEventResponseNonNullableFields, type context$4_BulkCreateEventOptions as BulkCreateEventOptions, type context$4_BulkCreateEventRequest as BulkCreateEventRequest, type context$4_BulkCreateEventResponse as BulkCreateEventResponse, type context$4_BulkCreateEventResponseNonNullableFields as BulkCreateEventResponseNonNullableFields, type context$4_BulkEventResult as BulkEventResult, type context$4_BulkUpdateEventOptions as BulkUpdateEventOptions, type context$4_BulkUpdateEventRequest as BulkUpdateEventRequest, type context$4_BulkUpdateEventRequestMaskedEvent as BulkUpdateEventRequestMaskedEvent, type context$4_BulkUpdateEventResponse as BulkUpdateEventResponse, type context$4_BulkUpdateEventResponseNonNullableFields as BulkUpdateEventResponseNonNullableFields, type BusinessSchedule$2 as BusinessSchedule, type context$4_CancelEventOptions as CancelEventOptions, type context$4_CancelEventRequest as CancelEventRequest, type context$4_CancelEventResponse as CancelEventResponse, type context$4_CancelEventResponseNonNullableFields as CancelEventResponseNonNullableFields, type Categories$2 as Categories, type ChangeContext$2 as ChangeContext, type ChangeContextPayloadOneOf$2 as ChangeContextPayloadOneOf, type context$4_CommonCursorPaging as CommonCursorPaging, type context$4_CommonCursorPagingMetadata as CommonCursorPagingMetadata, type context$4_CommonCursors as CommonCursors, type CommonIdentificationData$2 as CommonIdentificationData, type CommonIdentificationDataIdOneOf$2 as CommonIdentificationDataIdOneOf, type ConferencingDetails$2 as ConferencingDetails, type ConsentPolicy$2 as ConsentPolicy, type context$4_CreateEventOptions as CreateEventOptions, type context$4_CreateEventRequest as CreateEventRequest, type context$4_CreateEventResponse as CreateEventResponse, type context$4_CreateEventResponseNonNullableFields as CreateEventResponseNonNullableFields, type CursorPaging$2 as CursorPaging, type CursorPagingMetadata$2 as CursorPagingMetadata, type CursorQuery$2 as CursorQuery, type CursorQueryPagingMethodOneOf$2 as CursorQueryPagingMethodOneOf, type Cursors$2 as Cursors, Day$1 as Day, DayOfWeek$2 as DayOfWeek, type context$4_DeleteTargetsRequest as DeleteTargetsRequest, type context$4_DeleteTargetsResponse as DeleteTargetsResponse, type DomainEvent$4 as DomainEvent, type DomainEventBodyOneOf$4 as DomainEventBodyOneOf, type Empty$4 as Empty, type EntityCreatedEvent$4 as EntityCreatedEvent, type EntityDeletedEvent$4 as EntityDeletedEvent, type EntityUpdatedEvent$4 as EntityUpdatedEvent, type Event$1 as Event, type context$4_EventCancelled as EventCancelled, type context$4_EventCancelledEnvelope as EventCancelledEnvelope, type context$4_EventCreatedEnvelope as EventCreatedEnvelope, type EventMetadata$4 as EventMetadata, type context$4_EventNonNullableFields as EventNonNullableFields, type context$4_EventRecurringSplitEnvelope as EventRecurringSplitEnvelope, type context$4_EventUpdatedEnvelope as EventUpdatedEnvelope, type context$4_EventUpdatedWithMetadata as EventUpdatedWithMetadata, type context$4_EventsQueryBuilder as EventsQueryBuilder, type context$4_EventsQueryResult as EventsQueryResult, type ExtendedFields$3 as ExtendedFields, Field$1 as Field, Frequency$1 as Frequency, type GeoCoordinates$2 as GeoCoordinates, type context$4_GetEventOptions as GetEventOptions, type context$4_GetEventRequest as GetEventRequest, type context$4_GetEventResponse as GetEventResponse, type context$4_GetEventResponseNonNullableFields as GetEventResponseNonNullableFields, type IdentificationData$4 as IdentificationData, type IdentificationDataIdOneOf$4 as IdentificationDataIdOneOf, IdentityType$2 as IdentityType, type context$4_ItemMetadata as ItemMetadata, type context$4_ListEventsByContactIdOptions as ListEventsByContactIdOptions, type context$4_ListEventsByContactIdRequest as ListEventsByContactIdRequest, type context$4_ListEventsByContactIdResponse as ListEventsByContactIdResponse, type context$4_ListEventsByContactIdResponseNonNullableFields as ListEventsByContactIdResponseNonNullableFields, type context$4_ListEventsByMemberIdOptions as ListEventsByMemberIdOptions, type context$4_ListEventsByMemberIdRequest as ListEventsByMemberIdRequest, type context$4_ListEventsByMemberIdResponse as ListEventsByMemberIdResponse, type context$4_ListEventsByMemberIdResponseNonNullableFields as ListEventsByMemberIdResponseNonNullableFields, type context$4_ListEventsOptions as ListEventsOptions, type context$4_ListEventsRequest as ListEventsRequest, type context$4_ListEventsResponse as ListEventsResponse, type context$4_ListEventsResponseNonNullableFields as ListEventsResponseNonNullableFields, type context$4_ListRecurringEventInstancesHistoryRequest as ListRecurringEventInstancesHistoryRequest, type context$4_ListRecurringEventInstancesHistoryResponse as ListRecurringEventInstancesHistoryResponse, type Locale$2 as Locale, type Location$2 as Location, LocationType$2 as LocationType, type context$4_MaskedEvent as MaskedEvent, type MessageEnvelope$4 as MessageEnvelope, type Multilingual$2 as Multilingual, type Participant$2 as Participant, type ParticipantNotification$1 as ParticipantNotification, type Participants$1 as Participants, ParticipantsStatus$1 as ParticipantsStatus, type Permission$2 as Permission, PlacementType$2 as PlacementType, type Properties$2 as Properties, type PropertiesChange$2 as PropertiesChange, type context$4_QueryEventsOptions as QueryEventsOptions, type context$4_QueryEventsRequest as QueryEventsRequest, type context$4_QueryEventsResponse as QueryEventsResponse, type context$4_QueryEventsResponseNonNullableFields as QueryEventsResponseNonNullableFields, type RecurrenceRule$1 as RecurrenceRule, RecurrenceType$1 as RecurrenceType, type context$4_RecurringEventSplit as RecurringEventSplit, RequestedFields$1 as RequestedFields, ResolutionMethod$2 as ResolutionMethod, type Resource$1 as Resource, type context$4_RestoreEventDefaultsOptions as RestoreEventDefaultsOptions, type context$4_RestoreEventDefaultsRequest as RestoreEventDefaultsRequest, type context$4_RestoreEventDefaultsResponse as RestoreEventDefaultsResponse, type context$4_RestoreEventDefaultsResponseNonNullableFields as RestoreEventDefaultsResponseNonNullableFields, type RestoreInfo$4 as RestoreInfo, Role$2 as Role, type SiteCloned$2 as SiteCloned, type SiteCreated$2 as SiteCreated, type SitePropertiesEvent$2 as SitePropertiesEvent, type SitePropertiesNotification$2 as SitePropertiesNotification, context$4_SortOrder as SortOrder, type context$4_Sorting as Sorting, type SpecialHourPeriod$2 as SpecialHourPeriod, type context$4_SplitRecurringEventOptions as SplitRecurringEventOptions, type context$4_SplitRecurringEventRequest as SplitRecurringEventRequest, type context$4_SplitRecurringEventResponse as SplitRecurringEventResponse, type context$4_SplitRecurringEventResponseNonNullableFields as SplitRecurringEventResponseNonNullableFields, Status$4 as Status, type SupportedLanguage$2 as SupportedLanguage, type TimePeriod$2 as TimePeriod, type Translation$2 as Translation, Transparency$1 as Transparency, Type$2 as Type, type context$4_UpdateEvent as UpdateEvent, type context$4_UpdateEventOptions as UpdateEventOptions, type context$4_UpdateEventParticipantsRequest as UpdateEventParticipantsRequest, type context$4_UpdateEventParticipantsResponse as UpdateEventParticipantsResponse, type context$4_UpdateEventRequest as UpdateEventRequest, type context$4_UpdateEventResponse as UpdateEventResponse, type context$4_UpdateEventResponseNonNullableFields as UpdateEventResponseNonNullableFields, WebhookIdentityType$4 as WebhookIdentityType, type ZonedDate$2 as ZonedDate, type context$4__publicOnEventCancelledType as _publicOnEventCancelledType, type context$4__publicOnEventCreatedType as _publicOnEventCreatedType, type context$4__publicOnEventRecurringSplitType as _publicOnEventRecurringSplitType, type context$4__publicOnEventUpdatedType as _publicOnEventUpdatedType, context$4_bulkCancelEvent as bulkCancelEvent, context$4_bulkCreateEvent as bulkCreateEvent, context$4_bulkUpdateEvent as bulkUpdateEvent, context$4_cancelEvent as cancelEvent, context$4_createEvent as createEvent, context$4_getEvent as getEvent, context$4_listEvents as listEvents, context$4_listEventsByContactId as listEventsByContactId, context$4_listEventsByMemberId as listEventsByMemberId, context$4_onEventCancelled as onEventCancelled, context$4_onEventCreated as onEventCreated, context$4_onEventRecurringSplit as onEventRecurringSplit, context$4_onEventUpdated as onEventUpdated, onEventCancelled$1 as publicOnEventCancelled, onEventCreated$1 as publicOnEventCreated, onEventRecurringSplit$1 as publicOnEventRecurringSplit, onEventUpdated$1 as publicOnEventUpdated, context$4_queryEvents as queryEvents, context$4_restoreEventDefaults as restoreEventDefaults, context$4_splitRecurringEvent as splitRecurringEvent, context$4_updateEvent as updateEvent };
 }
 
-/** {{TBD}} */
+/**
+ * The `eventsView` object gives you details about how far into the future you can
+ * easily get a complete picture of a calendar. Subscribing to the event view
+ * webhooks lets you keep track of a calendar's single-occurrence, `EXCEPTION`, and
+ * `INSTANCE` events at least one year into the future.
+ */
 interface EventsView {
     /**
      * End date of the event view in `YYYY-MM-DDThh:mm:ss.sssZ` format.
@@ -3323,71 +3388,96 @@ declare enum Status$3 {
 /** A date time with a time zone, having the UTC offset and date determined by the server. */
 interface ZonedDate$1 {
     /**
-     * Local date time, in ISO-8601 format.
-     * E.g, "2024-01-30T13:30:00".
-     *
-     * Note: seconds are not supported and ignored.
+     * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2024-01-30T13:30:00`.
+     * Wix Calendar APIs ignore seconds.
      */
     localDate?: string | null;
     /**
-     * The event time zone.
+     * Time zone in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * For example, `America/New_York`.
      * @readonly
      */
     timeZone?: string | null;
     /**
-     * The UTC date determined by the server.
-     * Not returned for adjusted dates.
+     * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2024-01-30T13:30:00`.
+     * Not available for adjusted date fields.
      * @readonly
      */
     utcDate?: Date | null;
 }
 declare enum RecurrenceType {
     UNKNOWN_RECURRENCE_TYPE = "UNKNOWN_RECURRENCE_TYPE",
-    /** No recurrence, i.e the event is a single event instance. Default. */
+    /** The event occurs only once and doesn't repeat. */
     NONE = "NONE",
-    /** The event is the recurrence master defining the recurrence rule, which is the repeat pattern for the events. */
+    /** Defines the recurrence pattern for a series of recurring events. */
     MASTER = "MASTER",
-    /** The event is an instance of a recurring event. Read only. */
+    /** A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`. */
     INSTANCE = "INSTANCE",
-    /** The event is an exceptional instance of a recurring event. Read only. */
+    /** A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event. */
     EXCEPTION = "EXCEPTION"
 }
 interface RecurrenceRule {
-    /** The frequency with which the event should be repeated. */
+    /**
+     * Frequency how often the event repeats. Works together with `interval`.
+     *
+     * Supported values:
+     * + `WEEKLY`: The event's recurrence pattern is based on weeks.
+     */
     frequency?: Frequency;
     /**
-     * Works together with `frequency` to specify how often the event should be repeated. Default is `1`.
-     * For example, `WEEKLY` frequency and `interval` of `2` means once every two weeks.
+     * Interval how often the event repeats. Works together with `frequency`.
+     * For example, `frequency` set to `WEEKLY`  and `interval` set to `2` means
+     * the event repeats every 2 weeks.
+     *
+     * Min: `1`
+     * Max: `4`
+     * Default: `1`
      */
     interval?: number | null;
     /**
-     * The days of the week when the event should be repeated.
+     * Days of the week when the recurring event takes place.
      * Currently, only a single day is supported.
+     *
+     * Min: 1 day
+     * Max: 1 day
      */
     days?: Day[];
     /**
-     * The date until which the event should be repeated.
-     * When it is not specified, the event repeats forever.
+     * Date until when the event repeats.
+     * If not specified, the event repeats forever.
      */
     until?: ZonedDate$1;
     /**
-     * Read-only until date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Date until when the event repeats
+     * adjusted to the `timeZone` of the business
+     * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedUntil?: ZonedDate$1;
 }
 declare enum Frequency {
     UNKNOWN_FREQUENCY = "UNKNOWN_FREQUENCY",
-    /** The event repeats every few weeks. */
+    /** The event's recurrence pattern is based on weeks. */
     WEEKLY = "WEEKLY"
 }
 declare enum Day {
+    /** The recurring event takes place on Mondays. */
     MONDAY = "MONDAY",
+    /** The recurring event takes place on Tuesdays. */
     TUESDAY = "TUESDAY",
+    /** The recurring event takes place on Wednesday. */
     WEDNESDAY = "WEDNESDAY",
+    /** The recurring event takes place on Thursdays. */
     THURSDAY = "THURSDAY",
+    /** The recurring event takes place on Fridays. */
     FRIDAY = "FRIDAY",
+    /** The recurring event takes place on Saturdays. */
     SATURDAY = "SATURDAY",
+    /** The recurring event takes place on Sundays. */
     SUNDAY = "SUNDAY"
 }
 declare enum Transparency {
@@ -3432,24 +3522,33 @@ declare enum LocationType$1 {
     CUSTOM = "CUSTOM"
 }
 interface Resource {
-    /** The resource ID. */
+    /** Resource ID. */
     _id?: string | null;
     /**
-     * The resource name.
+     * Resource name.
      * @readonly
      */
     name?: string | null;
     /**
-     * The resource type.
+     * Resource type.
      * @readonly
      */
     type?: string | null;
     /**
-     * Specifies whether the event blocks the resource time.
-     * Default is `OPAQUE`.
+     * Specifies whether the event blocks time in the resource's schedule.
+     *
+     * Supported values:
+     * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same resource from being scheduled at the same time.
+     * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
+     *
+     * Default: `OPAQUE`.
      */
     transparency?: Transparency;
-    /** Optional permission role to grant the identities associated with the resource. */
+    /**
+     * Permission role associated with the resource. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
+     */
     permissionRole?: Role$1;
 }
 declare enum Role$1 {
@@ -3460,36 +3559,57 @@ declare enum Role$1 {
     COMMENTER = "COMMENTER"
 }
 interface Participants {
-    /** The total number of participants. */
+    /**
+     * Total number of participants.
+     *
+     * Min: `0`
+     */
     total?: number | null;
-    /** A full or partial list of the participants. */
+    /**
+     * Full or partial list of the participants.
+     *
+     * Max: 50 participants
+     */
     list?: Participant$1[];
-    /** Whether there are more participants for the event which were not listed. */
+    /**
+     * Whether there are more participants for the event than listed.
+     *
+     * + `false`: The list includes all participants.
+     * + `true`: The list doesn't include all participants.
+     */
     hasMore?: boolean | null;
     /**
-     * The participants status.
+     * Participant's status.
      *
-     * The possible values are:
-     * - `"CONFIRMED"` All participants are confirmed.
-     * - `"PENDING_CONFIRMATION"` Some participants are pending confirmation..
+     * Supported values:
+     * + `CONFIRMED`: All participants are confirmed.
+     * + `PENDING_CONFIRMATION`: At least one participant isn't confirmed yet.
      */
     status?: ParticipantsStatus;
 }
 interface Participant$1 {
-    /** The participant name. */
+    /**
+     * Participant name.
+     *
+     * Min: 1 character
+     * Max: 200 characters
+     */
     name?: string | null;
-    /** The participant phone. */
+    /** Participant's phone number. */
     phone?: string | null;
-    /** The participant email address. */
+    /** Participant's email address. */
     email?: string | null;
-    /** The ID of the Wix contact. */
+    /**
+     * [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+     * ID of the parcipant.
+     */
     contactId?: string | null;
 }
 declare enum ParticipantsStatus {
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
     /** All participants are confirmed. */
     CONFIRMED = "CONFIRMED",
-    /** Some participants are pending confirmation. */
+    /** At least one participant isn't confirmed yet. */
     PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
 }
 interface ConferencingDetails$1 {
@@ -3829,7 +3949,7 @@ declare namespace context$3 {
  * an [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
  * or [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
  * It includes details about the participant, whether the participation status is confirmed or
- * pending, which app owns the relevant event or shcedule, and allows for custom data extensions.
+ * pending, which app owns the relevant event or schedule, and allows for custom data extensions.
  */
 interface Participation extends ParticipationParticipatedItemOneOf {
     /**
@@ -6147,20 +6267,22 @@ declare enum Status {
 /** A date time with a time zone, having the UTC offset and date determined by the server. */
 interface ZonedDate {
     /**
-     * Local date time, in ISO-8601 format.
-     * E.g, "2024-01-30T13:30:00".
-     *
-     * Note: seconds are not supported and ignored.
+     * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2024-01-30T13:30:00`.
+     * Wix Calendar APIs ignore seconds.
      */
     localDate?: string | null;
     /**
-     * The event time zone.
+     * Time zone in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * For example, `America/New_York`.
      * @readonly
      */
     timeZone?: string | null;
     /**
-     * The UTC date determined by the server.
-     * Not returned for adjusted dates.
+     * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2024-01-30T13:30:00`.
+     * Not available for adjusted date fields.
      * @readonly
      */
     utcDate?: Date | null;