@riverbankcms/sdk 0.96.0 → 0.98.0

package/README.md

@@ -3122,6 +3122,16 @@ export default defineConfig({
 
 The SDK includes a CLI for syncing configuration and content between your local environment and the CMS.
 
+### setup plan
+
+Show the read-only lifecycle for site creation, management-key setup, dashboard user access, and SDK env variables:
+
+```bash
+npx riverbankcms setup plan --env=remote
+```
+
+The SDK CLI cannot create remote sites, issue keys, or grant user access from a site-scoped management key. Do those privileged operations through the dashboard/admin surface or approved CMS repo tooling, then use the setup planner and `env status` to verify the SDK repo has the right `RIVERBANK_*` variables.
+
 ### push-config
 
 Push schema/config surfaces to your CMS dashboard, including custom blocks, block field options/extensions, content type definitions/templates, SDK-managed site settings, and footer blocks:
@@ -3141,6 +3151,7 @@ Canonical event files in `content/events/*.json` may include `path` and `blocks`
 | `--api-key <key>` | Management API key (or set `RIVERBANK_*_MGMT_API_KEY`) |
 | `--dashboard <url>` | Dashboard URL (or set `RIVERBANK_*_DASHBOARD_URL`) |
 | `--config <path>` | Path to config file (default: `./riverbank.config.ts`) |
+| `--dry-run` | Validate config and preview schema/config surfaces without mutating the dashboard |
 
 **Example:**
 
@@ -3150,6 +3161,9 @@ export RIVERBANK_LOCAL_DASHBOARD_URL=https://www.riverbankcms.com
 export RIVERBANK_LOCAL_MGMT_API_KEY=bld_mgmt_sk_...
 npx riverbankcms push-config
 
+# Preview without applying
+npx riverbankcms push-config --dry-run
+
 # Or inline (remote)
 npx riverbankcms push-config \
   --api-key bld_mgmt_sk_... \
@@ -3233,9 +3247,14 @@ content/
 │   ├── <identifier>.<ext>
 │   └── .manifest.json
 └── .meta/
-    └── {entity}.json      # Timestamps for sync detection
+    ├── local/
+    │   └── {entity}.json  # Local CMS sync timestamps
+    └── remote/
+        └── {entity}.json  # Remote CMS sync timestamps
 ```
 
+Older projects with flat `content/.meta/{entity}.json` files are read as a compatibility fallback. The CLI writes new metadata into the target-specific `local/` or `remote/` directory the next time you pull or update metadata.
+
 Note: `content/media/` is local cache and migration working data by default. Generated SDK sites gitignore `content/media/*` so large downloaded files are not staged accidentally, while allowing intentional small fixtures under `content/media/fixtures/`. `content/media/.manifest.json` is also cache data (identifier -> checksum/filename) and intentionally does not store env-specific `assetId`s.
 
 ### push

package/dist/{PreviewEditorSidebar-46VT4QVU.mjs → PreviewEditorSidebar-CG3SSJND.mjs}

@@ -1,7 +1,7 @@
 "use client";
-import { resolvePreviewDashboardSetupHandoff, buildPreviewDashboardSetupUrl, resolvePreviewSidebarChromeModel, resolvePreviewEditorGuidanceModel, previewWidgetOverrides, canInspectSiteStyle, mapContentSchemaToFormFields, PreviewFormProvider, usePreviewBlockCustomizeSelectionOptional, BlockEditor, canApplySiteStyle, useBlockCustomizeControls, MAX_QUICK_MANIFEST_FIELDS } from './chunk-VHIMXQ7Z.mjs';
-import { useEntryController, useEditorUiStoreInstance, useUISelector, resolvePreviewSidebarTab, unsafeAsEditorBlockId, Tabs, TabsList, TabsTrigger, Button, X, TabsContent, useEditorUiStore, deriveRouteMetadataPresentation, resolvePageRouteSlug, createManifestValidation, createStoreBackend, ManifestForm, previewAssistantEnabled, Collapsible, CollapsibleTrigger, ChevronRight, CollapsibleContent, ContentFieldsForm, usePreviewDesignCoordinator, useSiteChromeCustomizeOptional, resolveStyleConfiguratorInitialSnapshot, createStyleConfiguratorState, isPreviewingChange, createOptimisticActionRunner, syncStyleConfiguratorState, getCuratedSiteStyle, planSiteStylePreviewChange, openRow, previewSiteStyle, applyResolvedSelections, previewButtonPersonality, previewHeaderLayout, previewHeaderStyle, planSiteChromeLookSelection, previewFooterLook, buildSiteChromeLookModels, planSiteChromeFooterLayoutSelection, previewPaletteVariant, previewTypographyPreset, setTypographyBodyFontOverride, setTypographyHeadingFontOverride, clearTypographyFontOverrides, paletteOverridesSchema, setPaletteOverrides, toggleRow, cancelPreview, dismissWarnings, dismissNotices, deriveStyleConfiguratorCapabilities, buildApplySiteStyleSelectionBody, markApplyFailed, selectionSnapshotFromApplySiteStyleSelectionResponse, styleConfiguratorHistoryEntryForPersistedSelection, markApplySaved, markApplySaving, findButtonPersonality, findPaletteVariant, findTypographyPreset, getHeaderLayout, getHeaderStyle, getFooterLayout, findFooterLook, cycleSiteChromeLookId, resolveContentTitle, foldSubroute, SUBROUTE_KINDS, Smartphone, Tablet, Monitor, Maximize2, cn, DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuItem, listEntryPageContentSlots, ContentSpinner, Callout, CalloutDescription, curatedSiteStyles, ChevronLeft, cycleableSiteChromeOptions, requireEntriesForCuratedChoices, buttonPersonalities, typographyPresets, paletteVariants, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, FormRenderer, evaluateTypographyFontSlot, Separator, Surface, ColorPicker, Input } from './chunk-XMATDBXO.mjs';
-import { usePreviewAuth, getDashboardUrl, unwrapResponse } from './chunk-7ED5UNHL.mjs';
+import { resolvePreviewDashboardSetupHandoff, buildPreviewDashboardSetupUrl, resolvePreviewSidebarChromeModel, resolvePreviewEditorGuidanceModel, previewWidgetOverrides, canInspectSiteStyle, mapContentSchemaToFormFields, PreviewFormProvider, usePreviewBlockCustomizeSelectionOptional, BlockEditor, canApplySiteStyle, useBlockCustomizeControls, MAX_QUICK_MANIFEST_FIELDS } from './chunk-H24OU7WG.mjs';
+import { useEntryController, useEditorUiStoreInstance, useUISelector, resolvePreviewSidebarTab, unsafeAsEditorBlockId, Tabs, TabsList, TabsTrigger, Button, X, TabsContent, useEditorUiStore, deriveRouteMetadataPresentation, resolvePageRouteSlug, createManifestValidation, createStoreBackend, ManifestForm, previewAssistantEnabled, Collapsible, CollapsibleTrigger, ChevronRight, CollapsibleContent, ContentFieldsForm, usePreviewDesignCoordinator, useSiteChromeCustomizeOptional, resolveStyleConfiguratorInitialSnapshot, createStyleConfiguratorState, isPreviewingChange, createOptimisticActionRunner, syncStyleConfiguratorState, getCuratedSiteStyle, planSiteStylePreviewChange, openRow, previewSiteStyle, applyResolvedSelections, previewButtonPersonality, previewHeaderLayout, previewHeaderStyle, planSiteChromeLookSelection, previewFooterLook, buildSiteChromeLookModels, planSiteChromeFooterLayoutSelection, previewPaletteVariant, previewTypographyPreset, setTypographyBodyFontOverride, setTypographyHeadingFontOverride, clearTypographyFontOverrides, paletteOverridesSchema, setPaletteOverrides, toggleRow, cancelPreview, dismissWarnings, dismissNotices, deriveStyleConfiguratorCapabilities, buildApplySiteStyleSelectionBody, markApplyFailed, selectionSnapshotFromApplySiteStyleSelectionResponse, styleConfiguratorHistoryEntryForPersistedSelection, markApplySaved, markApplySaving, findButtonPersonality, findPaletteVariant, findTypographyPreset, getHeaderLayout, getHeaderStyle, getFooterLayout, findFooterLook, cycleSiteChromeLookId, resolveContentTitle, foldSubroute, SUBROUTE_KINDS, Smartphone, Tablet, Monitor, Maximize2, cn, DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuItem, listEntryPageContentSlots, ContentSpinner, Callout, CalloutDescription, curatedSiteStyles, ChevronLeft, cycleableSiteChromeOptions, requireEntriesForCuratedChoices, buttonPersonalities, typographyPresets, paletteVariants, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, FormRenderer, evaluateTypographyFontSlot, Separator, Surface, ColorPicker, Input } from './chunk-DBRI3PQF.mjs';
+import { usePreviewAuth, getDashboardUrl, unwrapResponse } from './chunk-V2BYFSPW.mjs';
 import './chunk-R7POPVJR.mjs';
 import { useMemo, useRef, useCallback, useEffect, useState, useTransition, useLayoutEffect, useSyncExternalStore, useId } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/{PreviewEditorUI-JD75GE5F.mjs → PreviewEditorUI-RHNGKAAU.mjs}

@@ -1,7 +1,7 @@
 "use client";
-import { resolvePreviewChromeSurface, usePreviewPageDesignEditorState, PREVIEW_CHROME_PORTAL_CLASS_NAME, PREVIEW_CHROME_THEME_CLASS_NAME, applyPreviewChromeSurfaceToElement, setPreviewSidebarTab } from './chunk-4TLTV7OB.mjs';
-import { useEntryEditorController, useEditorUiStore, useMultiAutosave, usePreviewDesignHistoryOrder, useSiteChromeCustomizeOptional, selectPreviewDesignHistoryDomain, EditorChrome, previewDesignHistoryDomainForCommand, classifyHistoryShortcut, previewAssistantEnabled, cn, Dialog, Button, Palette, DialogContent, DialogHeader, DialogTitle, DialogDescription, TriangleAlert, Pencil, Sparkles, useEditorUiStoreInstance } from './chunk-XMATDBXO.mjs';
-import { usePreviewAuth, unwrapResponse } from './chunk-7ED5UNHL.mjs';
+import { resolvePreviewChromeSurface, usePreviewPageDesignEditorState, PREVIEW_CHROME_PORTAL_CLASS_NAME, PREVIEW_CHROME_THEME_CLASS_NAME, applyPreviewChromeSurfaceToElement, setPreviewSidebarTab } from './chunk-PKDPQHB5.mjs';
+import { useEntryEditorController, useEditorUiStore, useMultiAutosave, usePreviewDesignHistoryOrder, useSiteChromeCustomizeOptional, selectPreviewDesignHistoryDomain, EditorChrome, previewDesignHistoryDomainForCommand, classifyHistoryShortcut, previewAssistantEnabled, cn, Dialog, Button, Palette, DialogContent, DialogHeader, DialogTitle, DialogDescription, TriangleAlert, Pencil, Sparkles, useEditorUiStoreInstance } from './chunk-DBRI3PQF.mjs';
+import { usePreviewAuth, unwrapResponse } from './chunk-V2BYFSPW.mjs';
 import './chunk-R7POPVJR.mjs';
 import { useState, useMemo, useCallback, useEffect, useTransition } from 'react';
 import { createPortal } from 'react-dom';

package/dist/SdkPreviewModeRuntime-OV5PNJBB.mjs

@@ -0,0 +1,8 @@
+"use client";
+export { SdkPreviewModeRuntime } from './chunk-6WDBXCPX.mjs';
+import './chunk-QPXE2OUZ.mjs';
+import './chunk-H24OU7WG.mjs';
+import './chunk-PKDPQHB5.mjs';
+import './chunk-DBRI3PQF.mjs';
+import './chunk-V2BYFSPW.mjs';
+import './chunk-R7POPVJR.mjs';

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

@@ -5,7 +5,7 @@ import type { BookingRequirementConfigRequest, BookingRequirementConfigResponse,
 import type { BookingClosureConflictResponse, CreateBookingClosureRequest, CreateBookingClosureResponse, DeleteBookingClosureResponse, GetBookingClosureResponse, ListBookingClosuresResponse, PreviewBookingClosureResponse, BookingClosureRequest } from "./bookingClosures";
 import type { BookingSettingsResponse, CreateEventSeriesRequest, EventSeriesRecord, UpdateBookingSettingsRequest, UpdateEventSeriesRequest } from "./bookingConfig";
 import type { AdjustCustomerPassDetailsRequest, AdjustCustomerPassDetailsResponse, AssignCustomerMembershipRequest, AssignCustomerMembershipResponse, AssignCustomerPassRequest, AssignCustomerPassResponse, CancelCustomerMembershipAtPeriodEndRequest, CancelCustomerMembershipAtPeriodEndResponse, ConvertCreditRefundToCashRequest, ConvertCreditRefundToCashResponse, ListCustomerMembershipPaymentRefundsResponse, ListCustomerMembershipPaymentsResponse, ListCustomerPassRefundsResponse, RefundCustomerMembershipPaymentRequest, RefundCustomerMembershipPaymentResponse, RefundCustomerPassRequest, RefundCustomerPassResponse } from "./bookingAdjustments";
-import type { AppointmentResourceResponse, AppointmentServiceResponse, BookingAppointmentWithDetails, CreateAppointmentResourceRequest, CreateAppointmentResourceWithAccountAccessRequest, CreateAppointmentResourceWithAccountAccessResponse, CreateAppointmentServiceRequest, CreateTeamMemberProfileResponse, DiscardTeamMemberProfileDraftResponse, DeleteServiceResponse, ListAppointmentResourcesResponse, ListAppointmentServicesResponse, ListCourseEnrollmentRefundsResponse, ListEventAttendeeRefundsResponse, ListEventAttendeeTransfersResponse, OpsCancelEventAttendeeRequest, OpsCancelEventAttendeeResponse, OpsEventAttendeeDetailsResponse, OpsListUpcomingEventOccurrencesResponse, OpsOccurrenceAttendeesResponse, OpsRefundEventAttendeeResponse, OpsUpdateEventAttendeeCheckinRequest, OpsUpdateEventAttendeeCheckinResponse, OpsValidateEventTicketRequest, OpsValidateEventTicketResponse, ReferenceOptionsResponse, RemoveAppointmentResourceResponse, RefundCourseEnrollmentRequest, RefundCourseEnrollmentResponse, RefundEventAttendeeRequest, RefundEventAttendeeResponse, TransferEventAttendeeRequest, TransferEventAttendeeResponse, UpdateAppointmentResourceRequest, UpdateAppointmentServiceRequest, PublishTeamMemberProfileRequest, PublishTeamMemberProfileResponse, CancelScheduledTeamMemberProfileResponse, ScheduleTeamMemberProfileRequest, ScheduleTeamMemberProfileResponse, TeamMemberProfileContentResponse, UnpublishTeamMemberProfileResponse, UpdateTeamMemberProfileContentRequest, UpdateTeamMemberProfilePolicyRequest, UpdateTeamMemberProfilePolicyResponse, UpdateTeamMemberProfileRouteMetadataRequest, UpdateTeamMemberProfileRouteMetadataResponse } from "./bookingOperations";
+import type { AppointmentResourceResponse, AppointmentReservationLifecycleRequest, AppointmentReservationResponse, AppointmentServiceResponse, BookingAppointmentWithDetails, CreateAppointmentResourceRequest, CreateAppointmentResourceWithAccountAccessRequest, CreateAppointmentResourceWithAccountAccessResponse, CreateAppointmentReservationRequest, CreateAppointmentReservationRunRequest, CreateAppointmentReservationRunResponse, CreateAppointmentServiceRequest, CreateTeamMemberProfileResponse, DiscardTeamMemberProfileDraftResponse, DeleteServiceResponse, EndAppointmentReservationRequest, ListAppointmentResourcesResponse, ListAppointmentReservationsRequest, ListAppointmentReservationsResponse, ListAppointmentServicesResponse, ListCourseEnrollmentRefundsResponse, ListEventAttendeeRefundsResponse, ListEventAttendeeTransfersResponse, OpsCancelEventAttendeeRequest, OpsCancelEventAttendeeResponse, OpsEventAttendeeDetailsResponse, OpsListUpcomingEventOccurrencesResponse, OpsOccurrenceAttendeesResponse, OpsRefundEventAttendeeResponse, OpsUpdateEventAttendeeCheckinRequest, OpsUpdateEventAttendeeCheckinResponse, OpsValidateEventTicketRequest, OpsValidateEventTicketResponse, PreviewAppointmentReservationRunRequest, PreviewAppointmentReservationRunResponse, ReferenceOptionsResponse, RemoveAppointmentResourceResponse, RefundCourseEnrollmentRequest, RefundCourseEnrollmentResponse, 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, EventOccurrenceListRecord, 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, UpdateOccurrenceRequest, UpdateVenueRequest, VenueRecord } from "./bookingRecords";
 import type { ApplyAppointmentSetupRequest, ApplyAppointmentSetupResponse, AppointmentSetupResponse } from "./appointmentSetup";
 import type { AddCourseEnrollmentRequest, AddCourseEnrollmentResponse, CourseRecord, CreateCourseRequest, CreateCourseResponse, DashboardWaitlistListResponse, DeleteCourseProgramResponse, DeleteCourseResponse, DuplicateCourseRequest, DuplicateCourseResponse, ListCourseEnrollmentsResponse, UpdateCourseEnrollmentRequest, UpdateCourseEnrollmentResponse, UpdateCourseRequest, UpdateCourseResponse, WaitlistDashboardActionResponse } from "./courses";
@@ -239,6 +239,40 @@ export type BookingManagementAPIEndpoints = {
         siteId: string;
         resourceId: string;
     }, RemoveAppointmentResourceResponse>;
+    listAppointmentReservations: APIEndpoint<never, {
+        siteId: string;
+    } & ListAppointmentReservationsRequest, ListAppointmentReservationsResponse>;
+    createAppointmentReservation: APIEndpoint<CreateAppointmentReservationRequest, {
+        siteId: string;
+    }, AppointmentReservationResponse>;
+    getAppointmentReservation: APIEndpoint<never, {
+        siteId: string;
+        reservationId: string;
+    }, AppointmentReservationResponse>;
+    updateAppointmentReservation: APIEndpoint<UpdateAppointmentReservationRequest, {
+        siteId: string;
+        reservationId: string;
+    }, AppointmentReservationResponse>;
+    pauseAppointmentReservation: APIEndpoint<AppointmentReservationLifecycleRequest, {
+        siteId: string;
+        reservationId: string;
+    }, AppointmentReservationResponse>;
+    resumeAppointmentReservation: APIEndpoint<AppointmentReservationLifecycleRequest, {
+        siteId: string;
+        reservationId: string;
+    }, AppointmentReservationResponse>;
+    endAppointmentReservation: APIEndpoint<EndAppointmentReservationRequest, {
+        siteId: string;
+        reservationId: string;
+    }, AppointmentReservationResponse>;
+    previewAppointmentReservationRun: APIEndpoint<PreviewAppointmentReservationRunRequest, {
+        siteId: string;
+        reservationId: string;
+    }, PreviewAppointmentReservationRunResponse>;
+    createAppointmentReservationRun: APIEndpoint<CreateAppointmentReservationRunRequest, {
+        siteId: string;
+        reservationId: string;
+    }, CreateAppointmentReservationRunResponse>;
     createTeamMemberProfile: APIEndpoint<never, {
         siteId: string;
         resourceId: string;

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

@@ -452,6 +452,228 @@ export type AppointmentServiceResponse = {
 export type ListAppointmentServicesResponse = {
     services: AppointmentService[];
 };
+export declare const APPOINTMENT_RESERVATION_STATUS_VALUES: readonly ["active", "paused", "ended"];
+export type AppointmentReservationStatus = (typeof APPOINTMENT_RESERVATION_STATUS_VALUES)[number];
+export type AppointmentReservationPaymentMode = Readonly<{
+    kind: "manual";
+}> | Readonly<{
+    kind: "online_request";
+    sendOffsetMinutes: number;
+}>;
+export type AppointmentReservation = {
+    id: string;
+    siteId: string;
+    customerId: string;
+    resourceId: string;
+    serviceId: string;
+    weekday: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    localStartTime: string;
+    timezone: string;
+    startsOn: string;
+    endsOn: string | null;
+    status: AppointmentReservationStatus;
+    paymentMode: AppointmentReservationPaymentMode;
+    durationMinutes: number;
+    prepMinutes: number;
+    cleanupMinutes: number;
+};
+export type AppointmentReservationListItem = AppointmentReservation & {
+    updatedAt: string;
+    customerName: string;
+    customerEmail: string;
+    serviceName: string;
+    serviceColor: string | null;
+    resourceName: string;
+    resourceColor: string | null;
+};
+export type ListAppointmentReservationsRequest = {
+    customerId?: string;
+    resourceId?: string;
+    serviceId?: string;
+    status?: AppointmentReservationStatus;
+    startDate?: string;
+    endDate?: string;
+};
+export type CreateAppointmentReservationRequest = {
+    customerId: string;
+    resourceId: string;
+    serviceId: string;
+    weekday: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    localStartTime: string;
+    timezone: string;
+    startsOn: string;
+    endsOn?: string | null;
+    paymentMode?: AppointmentReservationPaymentMode;
+};
+export type UpdateAppointmentReservationRequest = Partial<Omit<CreateAppointmentReservationRequest, "paymentMode">> & {
+    expectedUpdatedAt: string;
+    paymentMode?: AppointmentReservationPaymentMode;
+};
+export type AppointmentReservationLifecycleRequest = {
+    expectedUpdatedAt: string;
+};
+export type EndAppointmentReservationRequest = {
+    endsOn: string;
+} & AppointmentReservationLifecycleRequest;
+export type AppointmentReservationResponse = {
+    reservation: AppointmentReservation;
+};
+export type ListAppointmentReservationsResponse = {
+    reservations: AppointmentReservationListItem[];
+};
+export type AppointmentReservationRunPlanningMode = Readonly<{
+    kind: "occurrence_count";
+    startsOn: string;
+    occurrenceCount: number;
+}> | Readonly<{
+    kind: "date_range";
+    startsOn: string;
+    endsOn: string;
+}>;
+export type PreviewAppointmentReservationRunRequest = {
+    mode: AppointmentReservationRunPlanningMode;
+    skippedOccurrenceKeys?: string[];
+    expectedReservationUpdatedAt?: string;
+};
+export type CreateAppointmentReservationRunRequest = {
+    mode: AppointmentReservationRunPlanningMode;
+    skippedOccurrenceKeys?: string[];
+    selectedOccurrenceKeys: string[];
+    expectedReservationUpdatedAt: string;
+    idempotencyKey: string;
+};
+export type AppointmentReservationRunOccurrence = {
+    occurrenceKey: string;
+    localDate: string;
+    startAt: string;
+    endAt: string;
+    occupiedStartAt: string;
+    occupiedEndAt: string;
+};
+export type AppointmentReservationRunGlobalConflict = Readonly<{
+    kind: "archived_customer";
+    customerId: string;
+}> | Readonly<{
+    kind: "archived_resource";
+    resourceId: string;
+}> | Readonly<{
+    kind: "archived_service";
+    serviceId: string;
+}> | Readonly<{
+    kind: "stale_reservation";
+    expectedUpdatedAt: string;
+    actualUpdatedAt: string;
+}>;
+export type AppointmentReservationRunOccurrenceConflict = Readonly<{
+    kind: "appointment";
+    appointmentId: string;
+    startAt: string;
+    endAt: string;
+}> | Readonly<{
+    kind: "reservation";
+    reservationId: string;
+    occurrenceKey: string;
+    startAt: string;
+    endAt: string;
+}> | Readonly<{
+    kind: "blackout";
+    blackoutId: string | null;
+    startAt: string;
+    endAt: string;
+}> | Readonly<{
+    kind: "external_busy";
+    externalBusyKey: string | null;
+    startAt: string;
+    endAt: string;
+}>;
+export type AppointmentReservationRunPlannedOccurrence = Readonly<{
+    kind: "ready";
+    occurrence: AppointmentReservationRunOccurrence;
+}> | Readonly<{
+    kind: "skipped";
+    occurrence: AppointmentReservationRunOccurrence;
+}> | Readonly<{
+    kind: "conflict";
+    occurrence: AppointmentReservationRunOccurrence;
+    conflicts: AppointmentReservationRunOccurrenceConflict[];
+}>;
+type AppointmentReservationRunPlanBase = {
+    reservationId: string;
+    reservationUpdatedAt: string;
+    selectedOccurrenceKeys: string[];
+    occurrences: AppointmentReservationRunPlannedOccurrence[];
+    readyOccurrences: Extract<AppointmentReservationRunPlannedOccurrence, {
+        kind: "ready";
+    }>[];
+    skippedOccurrences: Extract<AppointmentReservationRunPlannedOccurrence, {
+        kind: "skipped";
+    }>[];
+    conflictOccurrences: Extract<AppointmentReservationRunPlannedOccurrence, {
+        kind: "conflict";
+    }>[];
+};
+export type AppointmentReservationRunPlan = (AppointmentReservationRunPlanBase & {
+    kind: "empty";
+    canConfirm: false;
+    conflictOccurrences: [];
+    globalConflicts: [];
+}) | (AppointmentReservationRunPlanBase & {
+    kind: "incomplete";
+    canConfirm: false;
+    requestedOccurrenceCount: number;
+    conflictOccurrences: [];
+    globalConflicts: [];
+}) | (AppointmentReservationRunPlanBase & {
+    kind: "ready";
+    canConfirm: true;
+    conflictOccurrences: [];
+    globalConflicts: [];
+}) | (AppointmentReservationRunPlanBase & {
+    kind: "has_conflicts";
+    canConfirm: false;
+    conflictOccurrences: Extract<AppointmentReservationRunPlannedOccurrence, {
+        kind: "conflict";
+    }>[];
+    globalConflicts: [];
+}) | (AppointmentReservationRunPlanBase & {
+    kind: "blocked";
+    canConfirm: false;
+    globalConflicts: AppointmentReservationRunGlobalConflict[];
+});
+export type PreviewAppointmentReservationRunResponse = {
+    plan: AppointmentReservationRunPlan;
+};
+export type AppointmentReservationRunEffectStatus = Readonly<{
+    kind: "succeeded";
+}> | Readonly<{
+    kind: "skipped";
+    reason: "calendar_unavailable" | "manual_payment_mode" | "missing_appointment_resource" | "missing_run_appointments" | "missing_customer_email" | "missing_site_owner" | "payment_request_scheduler_deferred" | "run_reused";
+    message?: string;
+}> | Readonly<{
+    kind: "failed";
+    message: string;
+}>;
+export type AppointmentReservationRunAppointmentEffects = Readonly<{
+    appointmentId: string;
+    calendar: AppointmentReservationRunEffectStatus;
+    paymentRequest: AppointmentReservationRunEffectStatus;
+}>;
+export type AppointmentReservationRunPostCommitEffects = Readonly<{
+    completedAt: string;
+    summaryEmail: AppointmentReservationRunEffectStatus;
+    appointments: readonly AppointmentReservationRunAppointmentEffects[];
+}>;
+export type CreateAppointmentReservationRunResponse = {
+    run: {
+        id: string;
+        reservationId: string;
+        selectedOccurrenceKeys: string[];
+        status: "committed" | "completed_with_effect_failures";
+        reused: boolean;
+    };
+    appointmentIds: string[];
+    effects: AppointmentReservationRunPostCommitEffects;
+};
 export type DeleteServiceResponse = {
     success: boolean;
 };
@@ -492,6 +714,30 @@ export type PublicBookingAvailableDatesResponse = {
 export type PublicBookingAvailableSlotsResponse = {
     slots: TimeSlot[];
 };
+export type PublicWeeklySlotAvailabilityQuery = {
+    siteId: string;
+    serviceId: string;
+    resourceId?: string;
+    horizonWeeks?: number;
+    timezone?: string;
+};
+export type PublicWeeklySlotAvailabilityOption = {
+    id: string;
+    resourceId: string;
+    weekday: number;
+    weekdayLabel: string;
+    startTime: string;
+    endTime: string;
+    nextDate: string;
+    availableWeeks: number;
+};
+export type PublicWeeklySlotAvailabilityResponse = {
+    slots: PublicWeeklySlotAvailabilityOption[];
+    horizonWeeks: number;
+    timezone: string;
+    startDate: string;
+    endDate: string;
+};
 export type PublicCreateBookingAppointmentRequest = {
     formId: string;
     serviceId: string;