@riverbankcms/sdk 0.144.0 → 0.146.0

package/dist/_dts/api/src/appointmentEndpointDefinitions.d.ts

@@ -432,4 +432,53 @@ export declare const APPOINTMENT_ENDPOINT_DEFINITIONS: {
         responseKind: "json";
         errors: ("auth:forbidden" | "validation:invalid_input" | "resource:not_found" | "resource:conflict" | "server:internal_error")[];
     };
+    listGroupedAppointmentServices: {
+        path: "/sites/{siteId}/bookings/services/grouped";
+        method: "GET";
+        auth: "user";
+        responseKind: "json";
+        errors: "server:internal_error"[];
+    };
+    reorderAppointmentServices: {
+        path: "/sites/{siteId}/bookings/services/order";
+        method: "PUT";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:not_found" | "resource:conflict" | "server:internal_error")[];
+    };
+    listAppointmentServiceCategories: {
+        path: "/sites/{siteId}/bookings/service-categories";
+        method: "GET";
+        auth: "user";
+        responseKind: "json";
+        errors: "server:internal_error"[];
+    };
+    createAppointmentServiceCategory: {
+        path: "/sites/{siteId}/bookings/service-categories";
+        method: "POST";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:conflict" | "server:internal_error")[];
+    };
+    updateAppointmentServiceCategory: {
+        path: "/sites/{siteId}/bookings/service-categories/{categoryId}";
+        method: "PUT";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:not_found" | "resource:conflict" | "server:internal_error")[];
+    };
+    deleteAppointmentServiceCategory: {
+        path: "/sites/{siteId}/bookings/service-categories/{categoryId}";
+        method: "DELETE";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "resource:not_found" | "server:internal_error")[];
+    };
+    reorderAppointmentServiceCategories: {
+        path: "/sites/{siteId}/bookings/service-categories/order";
+        method: "PUT";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:conflict" | "server:internal_error")[];
+    };
 };

package/dist/_dts/api/src/appointmentServiceCategoryEndpoints.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Appointment-service categories and the manual order of categories and of
+ * services within a group (issue 1403): the endpoint contracts and their
+ * descriptors, composed into `APIEndpoints` and `API_ENDPOINTS`.
+ */
+import type { APIEndpoint } from './apiEndpointTypes';
+import type { AppointmentServiceCategoryResponse, AppointmentServiceOrderResponse, CreateAppointmentServiceCategoryRequest, DeleteAppointmentServiceCategoryResponse, ListAppointmentServiceCategoriesResponse, ListGroupedAppointmentServicesResponse, ReorderAppointmentServiceCategoriesRequest, ReorderAppointmentServicesRequest, UpdateAppointmentServiceCategoryRequest } from './appointmentServiceContracts';
+type SiteParams = {
+    siteId: string;
+};
+type CategoryParams = {
+    siteId: string;
+    categoryId: string;
+};
+export type AppointmentServiceCategoryAPIEndpoints = {
+    listGroupedAppointmentServices: APIEndpoint<never, SiteParams, ListGroupedAppointmentServicesResponse>;
+    reorderAppointmentServices: APIEndpoint<ReorderAppointmentServicesRequest, SiteParams, AppointmentServiceOrderResponse>;
+    listAppointmentServiceCategories: APIEndpoint<never, SiteParams, ListAppointmentServiceCategoriesResponse>;
+    createAppointmentServiceCategory: APIEndpoint<CreateAppointmentServiceCategoryRequest, SiteParams, AppointmentServiceCategoryResponse>;
+    updateAppointmentServiceCategory: APIEndpoint<UpdateAppointmentServiceCategoryRequest, CategoryParams, AppointmentServiceCategoryResponse>;
+    deleteAppointmentServiceCategory: APIEndpoint<never, CategoryParams, DeleteAppointmentServiceCategoryResponse>;
+    reorderAppointmentServiceCategories: APIEndpoint<ReorderAppointmentServiceCategoriesRequest, SiteParams, AppointmentServiceOrderResponse>;
+};
+export declare const APPOINTMENT_SERVICE_CATEGORY_ENDPOINT_DEFINITIONS: {
+    listGroupedAppointmentServices: {
+        path: "/sites/{siteId}/bookings/services/grouped";
+        method: "GET";
+        auth: "user";
+        responseKind: "json";
+        errors: "server:internal_error"[];
+    };
+    reorderAppointmentServices: {
+        path: "/sites/{siteId}/bookings/services/order";
+        method: "PUT";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:not_found" | "resource:conflict" | "server:internal_error")[];
+    };
+    listAppointmentServiceCategories: {
+        path: "/sites/{siteId}/bookings/service-categories";
+        method: "GET";
+        auth: "user";
+        responseKind: "json";
+        errors: "server:internal_error"[];
+    };
+    createAppointmentServiceCategory: {
+        path: "/sites/{siteId}/bookings/service-categories";
+        method: "POST";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:conflict" | "server:internal_error")[];
+    };
+    updateAppointmentServiceCategory: {
+        path: "/sites/{siteId}/bookings/service-categories/{categoryId}";
+        method: "PUT";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:not_found" | "resource:conflict" | "server:internal_error")[];
+    };
+    deleteAppointmentServiceCategory: {
+        path: "/sites/{siteId}/bookings/service-categories/{categoryId}";
+        method: "DELETE";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "resource:not_found" | "server:internal_error")[];
+    };
+    reorderAppointmentServiceCategories: {
+        path: "/sites/{siteId}/bookings/service-categories/order";
+        method: "PUT";
+        auth: "user";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "resource:conflict" | "server:internal_error")[];
+    };
+};
+export {};

package/dist/_dts/api/src/appointmentServiceContracts.d.ts

@@ -40,6 +40,8 @@ export type AppointmentService = {
             cutoffHours?: number;
         };
     };
+    /** The service's category, or null for the trailing "Other" group (issue 1403). */
+    categoryId: string | null;
     createdAt: string;
     updatedAt: string;
 };
@@ -73,6 +75,14 @@ export type CreateAppointmentServiceRequest = {
     onlineDetails?: AppointmentServiceOnlineDetailsInput | null;
     formId?: string | null;
     cancellationPolicy?: AppointmentService['cancellationPolicy'];
+    /**
+     * The category to put the service in, or null for "Other". On create the
+     * service goes to the end of that group. On update, omitting it leaves the
+     * category alone, and changing it moves the service to the end of its new
+     * group. A category that is not the site's is rejected with
+     * `CATEGORY_NOT_FOUND`.
+     */
+    categoryId?: string | null;
 };
 export type UpdateAppointmentServiceRequest = Partial<CreateAppointmentServiceRequest>;
 export type AppointmentServiceResponse = {
@@ -81,3 +91,73 @@ export type AppointmentServiceResponse = {
 export type ListAppointmentServicesResponse = {
     services: AppointmentService[];
 };
+/**
+ * A category as the dashboard manages it. Order is carried by position in
+ * the list responses, never by a stored number. `identifier` is the internal,
+ * rename-safe key site commands use. It is generated from the name on create
+ * and never shown to a site admin.
+ */
+export type AppointmentServiceCategory = {
+    id: string;
+    siteId: string;
+    name: string;
+    identifier: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** Every category the site has, in its manual order. */
+export type ListAppointmentServiceCategoriesResponse = {
+    categories: AppointmentServiceCategory[];
+};
+/** Names are trimmed. The name must be unique on the site, ignoring case. */
+export type CreateAppointmentServiceCategoryRequest = {
+    name: string;
+    description?: string | null;
+};
+export type UpdateAppointmentServiceCategoryRequest = {
+    name?: string;
+    description?: string | null;
+};
+export type AppointmentServiceCategoryResponse = {
+    category: AppointmentServiceCategory;
+};
+/** Deleting a category moves its services to the end of "Other". */
+export type DeleteAppointmentServiceCategoryResponse = {
+    success: true;
+};
+/**
+ * A compare-and-swap reorder. `expectedOrder` is the order the client last
+ * read and `nextOrder` the order it wants. The server answers
+ * `ORDER_CHANGED` when `expectedOrder` is no longer current (the client
+ * should refetch), and `ORDER_INVALID` when `nextOrder` is not an exact
+ * permutation of the current members.
+ */
+export type ReorderAppointmentServiceCategoriesRequest = {
+    expectedOrder: string[];
+    nextOrder: string[];
+};
+/**
+ * Reorders the services within one group: a category, or "Other" when
+ * `categoryId` is null. Moving a service between groups is not a reorder.
+ * It goes through the service's `categoryId`.
+ */
+export type ReorderAppointmentServicesRequest = {
+    categoryId: string | null;
+    expectedOrder: string[];
+    nextOrder: string[];
+};
+export type AppointmentServiceOrderResponse = {
+    success: true;
+};
+/**
+ * The Services page read: every category in order and every service (paused
+ * and unlisted included) in display order, so
+ * `layoutServicesByCategory(categories, services, { keepEmptyGroups: true })`
+ * gives the page's groups, and a group's service ids are the `expectedOrder`
+ * for a reorder. `listAppointmentServices` stays alphabetical for pickers.
+ */
+export type ListGroupedAppointmentServicesResponse = {
+    categories: AppointmentServiceCategory[];
+    services: AppointmentService[];
+};

package/dist/_dts/api/src/appointmentSetup.d.ts

@@ -1,6 +1,6 @@
 import type { AvailabilityScheduleSettings } from "./availability";
 import type { VenueRecord } from "./bookingRecords";
-import type { DashboardAppointmentResource, AppointmentService } from "./bookingOperations";
+import type { DashboardAppointmentResource, AppointmentService, AppointmentServiceCategory } from "./bookingOperations";
 import type { ApiClient } from "./request";
 import { z } from "zod";
 export type AppointmentSetupTargetStep = "services" | "people" | "assignments" | "availability" | "review";
@@ -73,6 +73,11 @@ export type AppointmentSetupResponse = Readonly<{
     seedSelection: AppointmentSetupSeedSelection;
     readiness: AppointmentSetupReadiness;
     services: readonly AppointmentService[];
+    /**
+     * The site's appointment-service categories in order, for the new-service
+     * wizard's Category field (issue 1403).
+     */
+    serviceCategories: readonly AppointmentServiceCategory[];
     resources: readonly DashboardAppointmentResource[];
     venues: readonly VenueRecord[];
     serviceResourceLinks: readonly AppointmentSetupServiceResourceLink[];
@@ -183,6 +188,7 @@ export declare const appointmentSetupServiceDraftSchema: z.ZodObject<{
             draftId: z.ZodString;
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>], "kind">;
+    categoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type AppointmentSetupServiceDraft = z.infer<typeof appointmentSetupServiceDraftSchema>;
 export declare const appointmentSetupPractitionerDraftSchema: z.ZodObject<{
@@ -318,6 +324,7 @@ export declare const applyAppointmentSetupRequestSchema: z.ZodObject<{
                 draftId: z.ZodString;
             }, z.core.$strip>], "kind">>;
         }, z.core.$strip>], "kind">;
+        categoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     practitioners: z.ZodArray<z.ZodObject<{
         ref: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/_dts/api/src/bookingConfig.d.ts

@@ -1,4 +1,6 @@
 import type { EventOnlineDetails } from './bookingRecords';
+import type { AttendeeNotificationIntent } from './occurrenceScheduling';
+import type { EventVisibility } from './event-visibility';
 import type { CreateEventRequest } from './eventManagementContracts';
 import { BOOKING_SETTINGS_SECTION_KEYS } from './bookingSettingsSections';
 import { type ResolvedEventCatalogue, type EventPreset } from '../../core/src/index';
@@ -153,7 +155,7 @@ export type EventSeriesRecord = {
     capacity: number | null;
     deliveryMode: EventDeliveryMode;
     capacityByAttendanceMode: EventCapacityByAttendanceMode;
-    visibility: 'public' | 'private' | 'unlisted';
+    visibility: EventVisibility;
     status: 'active' | 'draft' | 'archived' | 'cancelled' | 'completed';
     recurrenceRule: string | null;
     exceptionsJson: string[];
@@ -190,6 +192,11 @@ export type UpdateEventSeriesRequest = Partial<Omit<CreateEventRequest, 'creatio
     migrationPricingOptionIndex?: number | null;
     /** If true, regenerate future occurrences based on updated schedule */
     regenerateSchedule?: boolean;
+    /**
+     * The "let everyone booked know" tick. Only a change of the event's usual
+     * venue can notify; the server decides whether there is anything to send.
+     */
+    attendeeNotification?: AttendeeNotificationIntent;
 };
 export type BookingModuleToggles = {
     appointments: boolean;

package/dist/_dts/api/src/bookingManagementEndpoints.d.ts

@@ -6,14 +6,15 @@ import type { BookingClosureConflictResponse, CreateBookingClosureRequest, Creat
 import type { BookingSettingsResponse, UpdateBookingSettingsRequest } from './bookingConfig';
 import type * as Events from './eventManagementContracts';
 import type * as EventEndpoints from './bookingManagementEventEndpointTypes';
+import type { WholeSeriesEndpoints } from './bookingManagementEventEndpointTypes';
 import type { AdjustCustomerPassDetailsRequest, AdjustCustomerPassDetailsResponse, AssignCustomerMembershipRequest, AssignCustomerMembershipResponse, AssignCustomerPassRequest, AssignCustomerPassResponse, CancelCustomerMembershipAtPeriodEndRequest, CancelCustomerMembershipAtPeriodEndResponse, ConvertCreditRefundToCashRequest, ConvertCreditRefundToCashResponse, ListCustomerMembershipPaymentRefundsResponse, ListCustomerMembershipPaymentsResponse, ListCustomerPassRefundsResponse, RefundCustomerMembershipPaymentRequest, RefundCustomerMembershipPaymentResponse, RefundCustomerPassRequest, RefundCustomerPassResponse } from './bookingAdjustments';
 import type { AppointmentResourceResponse, AppointmentReservationLifecycleRequest, AppointmentReservationResponse, AppointmentServiceResponse, BookingAppointmentWithDetails, CreateAppointmentResourceRequest, CreateAppointmentResourceWithAccountAccessRequest, CreateAppointmentResourceWithAccountAccessResponse, CreateAppointmentReservationRequest, CreateAppointmentReservationRunRequest, CreateAppointmentReservationRunResponse, CreateAppointmentServiceRequest, CreateTeamMemberProfileResponse, DiscardTeamMemberProfileDraftResponse, DeleteServiceResponse, EndAppointmentReservationRequest, ListAppointmentResourcesResponse, ListAppointmentReservationsRequest, ListAppointmentReservationsResponse, ListAppointmentServicesResponse, ListEventSeriesRegistrationRefundsResponse, ListEventAttendeeRefundsResponse, ListEventAttendeeTransfersResponse, OpsCancelEventAttendeeRequest, OpsCancelEventAttendeeResponse, OpsEventAttendeeDetailsResponse, OpsListUpcomingEventOccurrencesResponse, OpsOccurrenceAttendeesResponse, OpsRefundEventAttendeeResponse, OpsUpdateEventAttendeeCheckinRequest, OpsUpdateEventAttendeeCheckinResponse, OpsValidateEventTicketRequest, OpsValidateEventTicketResponse, PreviewAppointmentReservationRunRequest, PreviewAppointmentReservationRunResponse, ReferenceOptionsResponse, RemoveAppointmentResourceResponse, RefundEventSeriesRegistrationRequest, RefundEventSeriesRegistrationResponse, RefundEventAttendeeRequest, RefundEventAttendeeResponse, TransferEventAttendeeRequest, TransferEventAttendeeResponse, UpdateAppointmentResourceRequest, UpdateAppointmentReservationRequest, UpdateAppointmentServiceRequest, PublishTeamMemberProfileRequest, PublishTeamMemberProfileResponse, CancelScheduledTeamMemberProfileResponse, ScheduleTeamMemberProfileRequest, ScheduleTeamMemberProfileResponse, TeamMemberProfileContentResponse, UnpublishTeamMemberProfileResponse, UpdateTeamMemberProfileContentRequest, UpdateTeamMemberProfilePolicyRequest, UpdateTeamMemberProfilePolicyResponse, UpdateTeamMemberProfileRouteMetadataRequest, UpdateTeamMemberProfileRouteMetadataResponse } from './bookingOperations';
 import type { AddEventOccurrenceAttendeeRequest, AddEventOccurrenceAttendeeResponse, AdjustCustomerCreditRequest, AdjustCustomerCreditResponse, BookingEventSeriesAttendee, BookingMembershipResponse, BookingPassResponse, CheckEventAdminEligibilityRequest, CheckEventAdminEligibilityResponse, CreateBookingCustomerRequest, CreateBookingCustomerResponse, RectifyBookingCustomerProfileRequest, RectifyBookingCustomerProfileResponse, RectifyBookingParticipantIdentityRequest, RectifyBookingParticipantIdentityResponse, CreateBookingMembershipRequest, CreateBookingPassRequest, CreateDiscountCodeRequest, CreateEventCategoryRequest, CreateOccurrenceRequest, CreateVenueRequest, DeleteDiscountCodeResponse, DeleteVenueResponse, DiscountCodeResponse, EventCategoryResponse, EventOccurrenceRecord, GeocodeVenueRequest, GeocodeVenueResponse, GetCustomerCreditResponse, GetMoneyReportRequest, GetMoneyReportResponse, ExportBookingQuestionAnswersCsvRequest, ExportBookingLedgerCsvRequest, ListBookingActivityRequest, ListBookingActivityResponse, ListBookingCustomersRequest, ListBookingCustomersResponse, ListBookingMembershipsRequest, ListBookingMembershipsResponse, ListBookingPassesRequest, ListBookingPassesResponse, ListCustomerAttendancesRequest, ListCustomerAttendancesResponse, ListCustomerMembershipsResponse, ListCustomerPassesResponse, CreatePersonRecordEntryRequest, CreatePersonRecordEntryResponse, ListDiscountCodesResponse, ListDiscountRedemptionsRequest, ListDiscountRedemptionsResponse, ListEventCategoriesResponse, ListMoneyPaymentsRequest, ListMoneyPaymentsResponse, ListSiteCustomerMembershipsRequest, ListSiteCustomerMembershipsResponse, ListSiteCustomerPassesRequest, ListSiteCustomerPassesResponse, UpdateBookingMembershipRequest, UpdateBookingPassRequest, UpdateDiscountCodeRequest, UpdateEventCategoryRequest, UpdateVenueRequest, VenueRecord } from './bookingRecords';
 import type * as OccurrenceScheduling from './occurrenceScheduling';
 import type { ApplyAppointmentSetupRequest, ApplyAppointmentSetupResponse, AppointmentSetupResponse } from './appointmentSetup';
-import type { AddEventSeriesRegistrationRequest, AddEventSeriesRegistrationResponse, EventSeriesContentOwnershipRequest, EventSeriesContentOwnershipResponse, DashboardWaitlistListResponse, DeleteEventOfferingResponse, ListEventSeriesRegistrationsResponse, UpdateEventSeriesRegistrationRequest, UpdateEventSeriesRegistrationResponse, WaitlistDashboardActionResponse } from './wholeSeriesRuns';
+import type { AddEventSeriesRegistrationRequest, AddEventSeriesRegistrationResponse, EventSeriesContentOwnershipRequest, EventSeriesContentOwnershipResponse, DashboardWaitlistListResponse, DeleteEventOfferingResponse, ListEventSeriesRegistrationsResponse, WaitlistDashboardActionResponse } from './wholeSeriesRuns';
 import type { GetParticipantMessageRecipientsRequest, ListParticipantMessageHistoryRequest, ParticipantMessageHistoryResponse, ParticipantMessageRecipientsResponse, ParticipantMessageSendResponse, SendParticipantMessageRequest, TestParticipantMessageRequest, TestParticipantMessageResponse } from './participantMessaging';
-import type { GetEmailSettingsResponse, GetEventSeriesEmailTemplatesResponse, GetNewsletterCampaignRecipientsSummaryResponse, GetNewsletterCampaignResponse, GetNewsletterCampaignStatsResponse, GetNewsletterSettingsResponse, GetNewsletterSubscriberResponse, GetNewsletterTemplateResponse, ListNewsletterCampaignsResponse, ListNewsletterListMembersQuery, ListNewsletterListMembersResponse, ListNewsletterListsResponse, ListNewsletterSendJobsQuery, ListNewsletterSendJobsResponse, ListNewsletterSubscribersQuery, ListNewsletterSubscribersResponse, ListNewsletterTagsResponse, ListNewsletterTemplatesResponse, PreviewEmailTemplateRequest, PreviewEmailTemplateResponse, PreviewNewsletterTemplateRequest, PreviewNewsletterTemplateResponse, RectifyNewsletterSubscriberRequest, RectifyNewsletterSubscriberResponse, SendTestEmailRequest, SendTestEmailResponse, UpdateEmailSettingsRequest, UpdateEmailSettingsResponse, UpdateEventSeriesEmailTemplatesRequest, UpdateEventSeriesEmailTemplatesResponse, UpdateNewsletterCampaignRequest, UpdateNewsletterCampaignResponse, UpdateNewsletterListMembershipsRequest, UpdateNewsletterListMembershipsResponse, UpdateNewsletterListRequest, UpdateNewsletterListResponse, UpdateNewsletterSettingsRequest, UpdateNewsletterSettingsResponse, UpdateNewsletterSubscriberRequest, UpdateNewsletterSubscriberResponse, UpdateNewsletterTemplateRequest, UpdateNewsletterTemplateResponse, UpsertNewsletterSubscriberRequest, UpsertNewsletterSubscriberResponse, ImportNewsletterSubscribersCsvResponse, ExportNewsletterSubscribersCsvResponse, DeleteNewsletterSubscriberResponse, AnonymizeNewsletterSubscriberResponse, ExportNewsletterSubscriberDataResponse, CreateNewsletterListRequest, CreateNewsletterListResponse, DeleteNewsletterListResponse, CreateNewsletterTemplateRequest, CreateNewsletterTemplateResponse, DeleteNewsletterTemplateResponse, CreateNewsletterCampaignRequest, CreateNewsletterCampaignResponse, DeleteNewsletterCampaignResponse, SendNewsletterCampaignNowRequest, SendNewsletterCampaignNowResponse, TestSendNewsletterCampaignRequest, TestSendNewsletterCampaignResponse, RetryNewsletterSendJobResponse, CancelNewsletterSendJobResponse } from './communications';
+import type { GetEmailSettingsResponse, GetEventSeriesEmailTemplatesResponse, GetNewsletterCampaignRecipientsSummaryResponse, GetNewsletterCampaignResponse, GetNewsletterCampaignStatsResponse, GetNewsletterSettingsResponse, GetNewsletterSubscriberResponse, GetNewsletterTemplateResponse, ListNewsletterCampaignsResponse, ListNewsletterListMembersQuery, ListNewsletterListMembersResponse, ListNewsletterListsResponse, ListNewsletterSubscribersQuery, ListNewsletterSubscribersResponse, ListNewsletterTagsResponse, ListNewsletterTemplatesResponse, PreviewEmailTemplateRequest, PreviewEmailTemplateResponse, PreviewNewsletterTemplateRequest, PreviewNewsletterTemplateResponse, RectifyNewsletterSubscriberRequest, RectifyNewsletterSubscriberResponse, SendTestEmailRequest, SendTestEmailResponse, UpdateEmailSettingsRequest, UpdateEmailSettingsResponse, UpdateEventSeriesEmailTemplatesRequest, UpdateEventSeriesEmailTemplatesResponse, UpdateNewsletterCampaignRequest, UpdateNewsletterCampaignResponse, UpdateNewsletterListMembershipsRequest, UpdateNewsletterListMembershipsResponse, UpdateNewsletterListRequest, UpdateNewsletterListResponse, UpdateNewsletterSettingsRequest, UpdateNewsletterSettingsResponse, UpdateNewsletterSubscriberRequest, UpdateNewsletterSubscriberResponse, UpdateNewsletterTemplateRequest, UpdateNewsletterTemplateResponse, UpsertNewsletterSubscriberRequest, UpsertNewsletterSubscriberResponse, ImportNewsletterSubscribersCsvResponse, ExportNewsletterSubscribersCsvResponse, DeleteNewsletterSubscriberResponse, AnonymizeNewsletterSubscriberResponse, ExportNewsletterSubscriberDataResponse, CreateNewsletterListRequest, CreateNewsletterListResponse, DeleteNewsletterListResponse, CreateNewsletterTemplateRequest, CreateNewsletterTemplateResponse, DeleteNewsletterTemplateResponse, CreateNewsletterCampaignRequest, CreateNewsletterCampaignResponse, DeleteNewsletterCampaignResponse, SendNewsletterCampaignNowRequest, SendNewsletterCampaignNowResponse, TestSendNewsletterCampaignRequest, TestSendNewsletterCampaignResponse } from './communications';
 import type { CreateNewsletterSubscribersImportUploadUrlRequest, CreateNewsletterSubscribersImportUploadUrlResponse, ImportNewsletterSubscribersCsvRequest } from './siteInfrastructure';
 import type { ListSiteActivityLogsResponse, ListSiteEmailEventLogsResponse, ListSiteEmailLogsResponse, ListSitePublicErrorLogsResponse } from './siteOperations';
 import type { SchedulePreviewRequest, SchedulePreviewResponse } from './aiPlayground';
@@ -21,7 +22,7 @@ import type { SchedulePreviewRequest, SchedulePreviewResponse } from './aiPlaygr
  * Booking-management endpoints group scheduler, operational bookings admin, course,
  * newsletter, and customer-ledger APIs that are tightly coupled in dashboard flows.
  */
-export type BookingManagementAPIEndpoints = {
+export type BookingManagementAPIEndpoints = WholeSeriesEndpoints & {
     getBookingSettings: APIEndpoint<never, {
         siteId: string;
     }, BookingSettingsResponse>;
@@ -209,17 +210,6 @@ export type BookingManagementAPIEndpoints = {
         siteId: string;
         campaignId: string;
     }, TestSendNewsletterCampaignResponse>;
-    listNewsletterSendJobs: APIEndpoint<never, {
-        siteId: string;
-    } & ListNewsletterSendJobsQuery, ListNewsletterSendJobsResponse>;
-    retryNewsletterSendJob: APIEndpoint<never, {
-        siteId: string;
-        jobId: string;
-    }, RetryNewsletterSendJobResponse>;
-    cancelNewsletterSendJob: APIEndpoint<never, {
-        siteId: string;
-        jobId: string;
-    }, CancelNewsletterSendJobResponse>;
     listAppointmentResources: APIEndpoint<never, {
         siteId: string;
     }, ListAppointmentResourcesResponse>;
@@ -530,30 +520,24 @@ export type BookingManagementAPIEndpoints = {
         status?: string;
         excludeCancelled?: string;
     }, Blob>;
-    updateEventSeriesRegistration: APIEndpoint<UpdateEventSeriesRegistrationRequest, {
-        siteId: string;
-        seriesId: string;
-        registrationId: string;
-    }, UpdateEventSeriesRegistrationResponse>;
+    updateEventSeriesRegistration: EventEndpoints.UpdateRegistration;
+    saveEventSeriesRegistrationAnswers: EventEndpoints.SaveRegistrationAnswers;
     listEvents: APIEndpoint<never, {
         siteId: string;
         status?: 'draft' | 'active' | 'archived' | 'cancelled' | 'completed';
-        visibility?: 'public' | 'private' | 'unlisted';
+        visibility?: 'public' | 'unlisted';
     }, Events.EventRecord[]>;
-    createEvent: APIEndpoint<Events.CreateEventRequest, {
-        siteId: string;
-    }, Events.CreateEventRecord>;
+    createEvent: EventEndpoints.Create;
     transitionEventLifecycle: EventEndpoints.Lifecycle;
     updateEventIdentity: EventEndpoints.UpdateIdentity;
-    createWholeSeriesRun: EventEndpoints.CreateWholeSeriesRun;
-    updateWholeSeriesRun: EventEndpoints.UpdateWholeSeriesRun;
-    cancelWholeSeriesRun: EventEndpoints.CancelWholeSeriesRun;
+    updateEventAddress: EventEndpoints.UpdateAddress;
     getEventSeries: EventEndpoints.GetSeries;
     updateEventSeries: EventEndpoints.UpdateSeries;
     deleteEventSeries: EventEndpoints.DeleteSeries;
     listEventSeriesAttendees: APIEndpoint<never, {
         siteId: string;
         seriesId: string;
+        occurrenceId?: string;
     }, BookingEventSeriesAttendee[]>;
     exportEventSeriesAttendeesCsv: APIEndpoint<never, {
         siteId: string;

package/dist/_dts/api/src/bookingManagementEventEndpointTypes.d.ts

@@ -1,8 +1,13 @@
 import type { EventOfferingId, EventSeriesId } from '../../core/src/index';
 import type { APIEndpoint } from './apiEndpointTypes';
+import type * as Events from './eventManagementContracts';
 import type { EventSeriesRecord, UpdateEventSeriesRequest } from './bookingConfig';
 import type { EventOccurrenceListRecord } from './bookingRecords';
-import type { CancelWholeSeriesRunRequest, CancelWholeSeriesRunResponse, CreateWholeSeriesRunRequest, EventLifecycleTransitionRequest, EventLifecycleTransitionResponse, UpdateEventIdentityRequest, UpdateEventIdentityResponse, UpdateWholeSeriesRunRequest, WholeSeriesRunMutationResponse } from './eventManagementContracts';
+import type { SaveEventSeriesRegistrationAnswersRequest, SaveEventSeriesRegistrationAnswersResponse, UpdateEventSeriesRegistrationRequest, UpdateEventSeriesRegistrationResponse } from './wholeSeriesRuns';
+import type { CancelWholeSeriesRunRequest, CancelWholeSeriesRunResponse, CourseBookingSettingsRequest, CourseBookingSettingsResponse, CreateWholeSeriesRunRequest, EventLifecycleTransitionRequest, EventLifecycleTransitionResponse, UpdateEventAddressRequest, UpdateEventAddressResponse, UpdateEventIdentityRequest, UpdateEventIdentityResponse, UpdateWholeSeriesRunRequest, WholeSeriesRunMutationResponse } from './eventManagementContracts';
+export type Create = APIEndpoint<Events.CreateEventRequest, {
+    siteId: string;
+}, Events.CreateEventRecord>;
 export type Lifecycle = APIEndpoint<EventLifecycleTransitionRequest, {
     siteId: string;
     eventId: EventOfferingId;
@@ -11,6 +16,10 @@ export type UpdateIdentity = APIEndpoint<UpdateEventIdentityRequest, {
     siteId: string;
     eventId: EventOfferingId;
 }, UpdateEventIdentityResponse>;
+export type UpdateAddress = APIEndpoint<UpdateEventAddressRequest, {
+    siteId: string;
+    eventId: EventOfferingId;
+}, UpdateEventAddressResponse>;
 export type CancelWholeSeriesRun = APIEndpoint<CancelWholeSeriesRunRequest, {
     siteId: string;
     eventId: EventOfferingId;
@@ -26,6 +35,21 @@ export type CreateWholeSeriesRun = APIEndpoint<CreateWholeSeriesRunRequest, {
     eventId: EventOfferingId;
 }, WholeSeriesRunMutationResponse>;
 export type UpdateWholeSeriesRun = APIEndpoint<UpdateWholeSeriesRunRequest, RunParams, WholeSeriesRunMutationResponse>;
+/** The course-wide booking settings, written onto every run in one go. */
+export type UpdateCourseBookingSettings = APIEndpoint<CourseBookingSettingsRequest, {
+    siteId: string;
+    eventId: EventOfferingId;
+}, CourseBookingSettingsResponse>;
+/**
+ * Every booking on every run of one course, as one CSV, narrowed to the run
+ * and status the Attendees tab is filtered by.
+ */
+export type ExportEventOfferingRegistrationsCsv = APIEndpoint<never, {
+    siteId: string;
+    eventOfferingId: string;
+    runId?: string;
+    status?: string;
+}, Blob>;
 type SeriesParams = Omit<RunParams, 'runId'> & {
     seriesId: EventSeriesId;
 };
@@ -41,4 +65,24 @@ export type OccurrenceList = APIEndpoint<never, {
     limit?: number;
     offset?: number;
 }, EventOccurrenceListRecord[]>;
+/**
+ * The whole-series run and course commands, grouped so the booking endpoint map
+ * can spread them in one line. Adding the course Booking tab's writer pushed
+ * that map past its `max-lines` baseline, the same reason the public checkout
+ * block was extracted from `endpoints.ts`.
+ */
+export type WholeSeriesEndpoints = {
+    createWholeSeriesRun: CreateWholeSeriesRun;
+    updateWholeSeriesRun: UpdateWholeSeriesRun;
+    cancelWholeSeriesRun: CancelWholeSeriesRun;
+    updateCourseBookingSettings: UpdateCourseBookingSettings;
+    exportEventOfferingRegistrationsCsv: ExportEventOfferingRegistrationsCsv;
+};
+type ScopedRegistrationParams = Readonly<{
+    siteId: string;
+    seriesId: string;
+    registrationId: string;
+}>;
+export type UpdateRegistration = APIEndpoint<UpdateEventSeriesRegistrationRequest, ScopedRegistrationParams, UpdateEventSeriesRegistrationResponse>;
+export type SaveRegistrationAnswers = APIEndpoint<SaveEventSeriesRegistrationAnswersRequest, ScopedRegistrationParams, SaveEventSeriesRegistrationAnswersResponse>;
 export {};

package/dist/_dts/api/src/clientErrorReporting.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { APIEndpoint } from './apiEndpointTypes';
+export declare const CLIENT_ERROR_REPORT_ENDPOINT_DEFINITIONS: {
+    reportClientError: {
+        path: "/client/error-report";
+        method: "POST";
+        auth: "user";
+        errors: never[];
+        responseKind: "json";
+    };
+};
+export declare const CLIENT_ERROR_REPORT_LIMITS: {
+    readonly pathname: 1024;
+    readonly name: 120;
+    readonly message: 2000;
+    readonly stack: 8000;
+    readonly digest: 128;
+    readonly componentStack: 8000;
+    readonly sourceLocation: 1024;
+};
+export declare const clientErrorEventSchema: z.ZodEnum<{
+    "dashboard:route-error": "dashboard:route-error";
+    "dashboard:app-error": "dashboard:app-error";
+    "client:error-boundary": "client:error-boundary";
+    "client:window-error": "client:window-error";
+    "client:unhandled-rejection": "client:unhandled-rejection";
+}>;
+export declare const clientErrorReportSchema: z.ZodObject<{
+    event: z.ZodEnum<{
+        "dashboard:route-error": "dashboard:route-error";
+        "dashboard:app-error": "dashboard:app-error";
+        "client:error-boundary": "client:error-boundary";
+        "client:window-error": "client:window-error";
+        "client:unhandled-rejection": "client:unhandled-rejection";
+    }>;
+    pathname: z.ZodString;
+    name: z.ZodString;
+    message: z.ZodString;
+    stack: z.ZodNullable<z.ZodString>;
+    digest: z.ZodNullable<z.ZodString>;
+    componentStack: z.ZodNullable<z.ZodString>;
+    sourceLocation: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type ClientErrorEvent = z.infer<typeof clientErrorEventSchema>;
+export type ClientErrorReportRequest = z.infer<typeof clientErrorReportSchema>;
+export type ClientErrorReportingAPIEndpoints = {
+    reportClientError: APIEndpoint<ClientErrorReportRequest, never, {
+        ok: true;
+    }>;
+};

package/dist/_dts/api/src/communications.d.ts

@@ -1,4 +1,4 @@
-import type { CamelizeKeys, DbRow } from "../../db/src/index";
+import type { CamelizeKeys, DbDatabase, DbRow } from "../../db/src/index";
 import type { ListNewsletterListMembersQueryInput, UpdateNewsletterListMembershipsBodyInput } from "./schemas/newsletter-memberships";
 /**
  * Communications Contracts
@@ -78,7 +78,7 @@ export type SendTestEmailRequest = {
     };
 };
 export type SendTestEmailResponse = {
-    delivery: 'sent' | 'queued';
+    delivery: "sent" | "queued";
     email: string;
 };
 export type PreviewEmailTemplateRequest = {
@@ -99,9 +99,10 @@ export type NewsletterSettingsRecord = CamelizeKeys<DbRow<"newsletter_settings">
 export type NewsletterSubscriberRecord = CamelizeKeys<DbRow<"newsletter_subscribers">>;
 export type NewsletterListRecord = CamelizeKeys<DbRow<"newsletter_lists">>;
 export type NewsletterTemplateRecord = CamelizeKeys<DbRow<"newsletter_templates">>;
-export type NewsletterCampaignRecord = CamelizeKeys<DbRow<"newsletter_campaigns">>;
-export type NewsletterSendJobRecord = CamelizeKeys<DbRow<"newsletter_send_jobs">>;
-export type NewsletterSendJobStatus = "pending" | "processing" | "completed" | "failed" | "cancelled";
+export type NewsletterCampaignRecord = Omit<CamelizeKeys<DbRow<"newsletter_campaigns">>, "status" | "finishReason" | "lastClaimedAt"> & {
+    status: "draft" | "scheduled" | "sending" | "finished";
+    finishReason: "completed" | "stopped_by_owner" | "deadline_reached" | "campaign_blocked" | null;
+};
 export type GetNewsletterSettingsResponse = {
     settings: NewsletterSettingsRecord | null;
 };
@@ -199,6 +200,7 @@ export type ExportNewsletterSubscriberDataResponse = {
             id: string;
             name: string;
         }>;
+        deliveries: Array<Pick<DbRow<'newsletter_campaign_deliveries'>, 'id' | 'campaign_id' | 'captured_email' | 'state' | 'reason' | 'accepted_at' | 'delivered_at' | 'bounced_at' | 'complained_at' | 'unsubscribed_at' | 'opened_at' | 'clicked_at' | 'created_at'>>;
     };
 };
 export type ListNewsletterListsResponse = {
@@ -310,7 +312,6 @@ export type PreviewNewsletterTemplateResponse = {
         issues: NewsletterTemplatePreviewIssue[];
     };
 };
-export type NewsletterCampaignAudienceMode = "and" | "or";
 export type ListNewsletterCampaignsResponse = {
     campaigns: NewsletterCampaignRecord[];
 };
@@ -324,29 +325,43 @@ export type CreateNewsletterCampaignResponse = {
 export type GetNewsletterCampaignResponse = {
     campaign: NewsletterCampaignRecord;
 };
+/** Draft edits only. Scheduling, unscheduling and stopping are their own commands below. */
 export type UpdateNewsletterCampaignRequest = Partial<{
     name: string;
     templateId: string | null;
     subject: string | null;
     preheader: string | null;
-    audienceMode: NewsletterCampaignAudienceMode;
     audienceListIds: string[];
     audienceTags: string[];
     scheduledAt: string | null;
     timezone: string | null;
-    status: "draft" | "scheduled" | "sending" | "sent" | "cancelled" | "failed";
-    confirmLargeAudience: boolean;
 }>;
 export type UpdateNewsletterCampaignResponse = {
     campaign: NewsletterCampaignRecord;
 };
+/** Freeze a draft's content and targeting and book its sending window. */
+export type ScheduleNewsletterCampaignRequest = {
+    scheduledAt: string;
+    timezone: string;
+    confirmLargeAudience?: boolean;
+};
+export type ScheduleNewsletterCampaignResponse = {
+    campaign: NewsletterCampaignRecord;
+};
+/** Return a scheduled campaign to draft; fails once sending has started. */
+export type UnscheduleNewsletterCampaignResponse = {
+    campaign: NewsletterCampaignRecord;
+};
+/** Stop the remaining sends of a scheduled or sending campaign. Final. */
+export type StopNewsletterCampaignResponse = {
+    campaign: NewsletterCampaignRecord;
+};
 export type DeleteNewsletterCampaignResponse = {
     deleted: boolean;
 };
 export type NewsletterCampaignRecipientsSummary = {
     count: number;
     filters: {
-        audienceMode: NewsletterCampaignAudienceMode;
         audienceListIds: string[];
         audienceTags: string[];
     };
@@ -354,7 +369,13 @@ export type NewsletterCampaignRecipientsSummary = {
 export type GetNewsletterCampaignRecipientsSummaryResponse = {
     summary: NewsletterCampaignRecipientsSummary;
 };
+export type NewsletterNotSentReason = DbDatabase["public"]["Enums"]["newsletter_delivery_reason"];
 export type NewsletterCampaignStats = {
+    selectedCount: number;
+    notSentCount: number;
+    unknownCount: number;
+    remainingCount: number;
+    notSentReasons: Partial<Record<NewsletterNotSentReason, number>>;
     sentCount: number;
     deliveredCount: number;
     openedCount: number;
@@ -372,7 +393,7 @@ export type SendNewsletterCampaignNowRequest = {
 };
 export type SendNewsletterCampaignNowResponse = {
     campaign: NewsletterCampaignRecord;
-    jobsCreated: number;
+    recipientsCaptured: number;
     recipients: NewsletterCampaignRecipientsSummary;
 };
 export type TestSendNewsletterCampaignRequest = {
@@ -383,16 +404,3 @@ export type TestSendNewsletterCampaignResponse = {
     queued: number;
     failed: number;
 };
-export type ListNewsletterSendJobsQuery = Partial<{
-    campaignId: string;
-    status: NewsletterSendJobStatus;
-}>;
-export type ListNewsletterSendJobsResponse = {
-    jobs: NewsletterSendJobRecord[];
-};
-export type RetryNewsletterSendJobResponse = {
-    job: NewsletterSendJobRecord;
-};
-export type CancelNewsletterSendJobResponse = {
-    job: NewsletterSendJobRecord;
-};