@riverbankcms/sdk 0.67.0 → 0.68.0

package/README.md

@@ -179,6 +179,10 @@ const circuitState = client.getCircuitState();
 
 For detailed testing and verification steps, see [`docs/resilience-verification.md`](./docs/resilience-verification.md).
 
+### Headless Appointment Booking
+
+SDK sites that need bespoke appointment booking UI can use the headless booking runtime from `@riverbankcms/sdk/bookings`. See [`docs/headless-booking.md`](./docs/headless-booking.md) for the real `blockOverrides` pattern with an `'appointment-booking'` override, `HeadlessBookingProvider`, `getAppointmentBookingOverrideInput`, and `useHeadlessBookingFlow`.
+
 ### Server-Side API
 
 ```tsx
@@ -1484,9 +1488,10 @@ Style Builder blocks to match your brand using the Theme Bridge. This provides C
 
 ### Quick Start
 
-Wrap your app with `ThemeBridgeProvider` and define your color tokens:
+Import the SDK base stylesheet, then wrap your app with `ThemeBridgeProvider` and define your color tokens:
 
 ```tsx
+import '@riverbankcms/sdk/styles.css';
 import { ThemeBridgeProvider } from '@riverbankcms/sdk/theme-bridge';
 
 export default function RootLayout({ children }) {
@@ -1509,7 +1514,7 @@ export default function RootLayout({ children }) {
 
 ### Token System
 
-Define color tokens as key-value pairs. Keys become CSS variables (`--color-{key}`):
+Define color tokens as key-value pairs. Keys become runtime CSS variables such as `--tb-primary`:
 
 ```tsx
 <ThemeBridgeProvider
@@ -1523,18 +1528,20 @@ Define color tokens as key-value pairs. Keys become CSS variables (`--color-{key
       background: '#ffffff',
       surface: '#f8fafc',
 
-      // Text
-      text: '#1e293b',
-      mutedText: '#64748b',
+      // Text. foreground/mutedForeground are preferred;
+      // text/mutedText remain accepted aliases.
+      foreground: '#1e293b',
+      mutedForeground: '#64748b',
 
       // UI
       border: '#e2e8f0',
-      white: '#ffffff',
+      primaryForeground: '#ffffff',
 
       // Status
       success: '#22c55e',
       warning: '#f59e0b',
-      danger: '#ef4444',
+      destructive: '#ef4444',
+      info: '#0ea5e9',
     },
   }}
 >
@@ -1545,6 +1552,8 @@ Token values can be:
 - **CSS variable refs**: `'var(--brand-purple)'` (passed through)
 - **RGB values**: `'109 40 217'` (used directly)
 
+Canonical tokens win when aliases are also present. Accepted aliases are `text -> foreground`, `mutedText -> mutedForeground`, `white -> primaryForeground`, and `danger -> destructive`.
+
 ### Design Presets
 
 Control typography, spacing, corners, and shadows:
@@ -1576,7 +1585,7 @@ Control typography, spacing, corners, and shadows:
 
 ### Component CSS (Opt-in)
 
-By default, only CSS variables are generated. Enable component CSS for buttons, cards, and inputs:
+By default, the provider emits CSS variables plus structural runtime CSS used by system blocks: status classes, step/progress classes, and block-specific variables such as appointment booking `--ab-*` vars. Generated visual skins for buttons, cards, and inputs remain opt-in:
 
 ```tsx
 <ThemeBridgeProvider
@@ -1584,7 +1593,7 @@ By default, only CSS variables are generated. Enable component CSS for buttons,
     tokens: {
       primary: '#6d28d9',
       secondary: '#4c1d95',
-      white: '#ffffff',
+      primaryForeground: '#ffffff',
       surface: '#f8fafc',
       text: '#1e293b',
       border: '#e2e8f0',
@@ -1643,9 +1652,8 @@ Reference existing CSS variables from your design system:
       primary: 'var(--brand-purple)',
       secondary: 'var(--brand-navy)',
       background: 'var(--ds-bg)',
-      text: 'var(--ds-text)',
+      foreground: 'var(--ds-text)',
     },
-    components: { buttons: true },
   }}
 >
 ```
@@ -1669,6 +1677,8 @@ const { css, cssVars } = generateThemeBridgeCss({
 // cssVars: Object of CSS variable name-value pairs
 ```
 
+When using `generateThemeBridgeCss` directly, render the affected blocks inside an element with `data-theme-scope="sdk"` so the generated status, progress, component, and block-var selectors apply. `ThemeBridgeProvider` adds that wrapper for you.
+
 ### Available Exports
 
 ```tsx

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

@@ -229,7 +229,62 @@ export type ApplyAiDesignerThemePatchResponse = {
     themeId: string;
     themeUpdatedAt: string;
 };
-export type AiDesignerCommandBackedPageProposal = {
+type AiDesignerPageBlocksEnvelope = {
+    blockIds: string[];
+};
+type AiDesignerAddedPageBlock = {
+    id: string;
+    kind: string;
+    content?: Record<string, unknown> | null;
+};
+type AiDesignerBasePageOpPreview = {
+    id: string;
+    summary: string;
+    scope: "page";
+    pageId: string;
+    base: AiDesignerPageBlocksEnvelope;
+    before: AiDesignerPageBlocksEnvelope;
+    after: AiDesignerPageBlocksEnvelope & {
+        addedBlocks?: AiDesignerAddedPageBlock[];
+    };
+};
+type AiDesignerReorderBlocksPreview = AiDesignerBasePageOpPreview & {
+    kind: "reorder_blocks";
+};
+type AiDesignerMoveBlockPreview = AiDesignerBasePageOpPreview & {
+    kind: "move_block";
+    blockId: string;
+    anchor: {
+        kind: "after";
+        blockId: string | null;
+    } | {
+        kind: "before";
+        blockId: string | null;
+    };
+};
+type AiDesignerSwapBlocksPreview = AiDesignerBasePageOpPreview & {
+    kind: "swap_blocks";
+    blockIdA: string;
+    blockIdB: string;
+};
+type AiDesignerAddBlockPreview = AiDesignerBasePageOpPreview & {
+    kind: "add_block";
+    blockKind: string;
+    afterBlockId: string | null;
+    after: AiDesignerPageBlocksEnvelope & {
+        addedBlocks: AiDesignerAddedPageBlock[];
+    };
+};
+type AiDesignerDuplicateBlockPreview = AiDesignerBasePageOpPreview & {
+    kind: "duplicate_block";
+    blockId: string;
+    afterBlockId: string | null;
+    after: AiDesignerPageBlocksEnvelope & {
+        addedBlocks: AiDesignerAddedPageBlock[];
+    };
+};
+type AiDesignerPageOpPreview = AiDesignerReorderBlocksPreview | AiDesignerMoveBlockPreview | AiDesignerSwapBlocksPreview | AiDesignerAddBlockPreview | AiDesignerDuplicateBlockPreview;
+export type AiDesignerCommandBackedPageProposal<TPreview extends AiDesignerPageOpPreview = AiDesignerPageOpPreview> = {
     proposalId: string;
     surface: "page";
     baseFingerprint: string;
@@ -241,41 +296,34 @@ export type AiDesignerCommandBackedPageProposal = {
         };
         commands: readonly unknown[];
     };
-    preview: unknown;
+    preview: TPreview;
     dryRunSummary?: string;
 };
 export type ApplyAiDesignerPageOpsRequest = {
     kind: "reorder_blocks";
     pageId: string;
     baseBlockIds: string[];
-    commandBacked: AiDesignerCommandBackedPageProposal;
+    commandBacked: AiDesignerCommandBackedPageProposal<AiDesignerReorderBlocksPreview>;
 } | {
     kind: "move_block";
     pageId: string;
     baseBlockIds: string[];
-    commandBacked: AiDesignerCommandBackedPageProposal;
+    commandBacked: AiDesignerCommandBackedPageProposal<AiDesignerMoveBlockPreview>;
 } | {
     kind: "swap_blocks";
     pageId: string;
     baseBlockIds: string[];
-    commandBacked: AiDesignerCommandBackedPageProposal;
-} | {
-    kind: "delete_block";
-    pageId: string;
-    baseBlockIds: string[];
-    blockId: string;
+    commandBacked: AiDesignerCommandBackedPageProposal<AiDesignerSwapBlocksPreview>;
 } | {
     kind: "add_block";
     pageId: string;
     baseBlockIds: string[];
-    blockKind: string;
-    afterBlockId?: string | null;
+    commandBacked: AiDesignerCommandBackedPageProposal<AiDesignerAddBlockPreview>;
 } | {
     kind: "duplicate_block";
     pageId: string;
     baseBlockIds: string[];
-    blockId: string;
-    afterBlockId?: string | null;
+    commandBacked: AiDesignerCommandBackedPageProposal<AiDesignerDuplicateBlockPreview>;
 };
 export type ApplyAiDesignerPageOpsResponse = {
     ok: true;

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

@@ -1,5 +1,6 @@
 import type { ChangePlanRequest, ChangePlanResponse } from './types';
 import type { ApiClient } from './request';
+import type { BillingComponentSummaryAddOnComponent, BillingComponentSummaryBasePlanComponent, BillingComponentSummaryComponent, BillingComponentSummarySiteComponent } from '@riverbankcms/billing/components';
 export type BillingStatusResponse = {
     hasActiveSubscription: boolean;
     subscriptionStatus: string | null;
@@ -52,45 +53,12 @@ export type BillingSummaryResponse = {
         isCustomPrice: boolean;
     } | null;
 };
-export type BillingSummaryComponentKind = "plan_base" | "custom_site_price" | "extra_site" | "managed_domain_overage";
-export type BillingSummaryComponentSource = {
-    kind: "plan";
-    planId: string;
-} | {
-    kind: "site";
-    siteId: string;
-} | {
-    kind: "site_domain";
-    siteId: string;
-    siteDomainId: string;
-};
-type BillingSummaryComponentBase<TKind extends BillingSummaryComponentKind> = {
-    kind: TKind;
-    label: string;
-    amountCents: number;
-    formatted: string;
-    interval: "month" | "year";
-};
-export type BillingSummaryComponent = BillingSummaryBasePlanComponent | BillingSummarySiteComponent | BillingSummaryAddOnComponent;
-export type BillingSummaryBasePlanComponent = BillingSummaryComponentBase<"plan_base"> & {
-    source: Extract<BillingSummaryComponentSource, {
-        kind: "plan";
-    }>;
-};
-export type BillingSummarySiteComponent = BillingSummaryComponentBase<"custom_site_price"> & {
-    source: Extract<BillingSummaryComponentSource, {
-        kind: "site";
-    }>;
-};
-export type BillingSummaryAddOnComponent = (BillingSummaryComponentBase<"extra_site"> & {
-    source: Extract<BillingSummaryComponentSource, {
-        kind: "site";
-    }>;
-}) | (BillingSummaryComponentBase<"managed_domain_overage"> & {
-    source: Extract<BillingSummaryComponentSource, {
-        kind: "site_domain";
-    }>;
-});
+export type BillingSummaryComponent = BillingComponentSummaryComponent;
+export type BillingSummaryComponentKind = BillingSummaryComponent["kind"];
+export type BillingSummaryComponentSource = BillingSummaryComponent["source"];
+export type BillingSummaryBasePlanComponent = BillingComponentSummaryBasePlanComponent;
+export type BillingSummarySiteComponent = BillingComponentSummarySiteComponent;
+export type BillingSummaryAddOnComponent = BillingComponentSummaryAddOnComponent;
 export type SiteBillingCostResponse = {
     hasCost: boolean;
     formattedCost: string;
@@ -153,4 +121,3 @@ export declare function changePlan(apiClient: ApiClient, { planId, interval, pro
 export declare function billingCheckout(apiClient: ApiClient, { planId, interval, options, }: BillingCheckoutRequest & {
     options?: RequestInit;
 }): Promise<BillingCheckoutResponse>;
-export {};

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, 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, 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 { 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";
@@ -224,6 +224,9 @@ export type BookingManagementAPIEndpoints = {
     createAppointmentResource: APIEndpoint<CreateAppointmentResourceRequest, {
         siteId: string;
     }, AppointmentResourceResponse>;
+    createAppointmentResourceWithAccountAccess: APIEndpoint<CreateAppointmentResourceWithAccountAccessRequest, {
+        siteId: string;
+    }, CreateAppointmentResourceWithAccountAccessResponse>;
     getAppointmentResource: APIEndpoint<never, {
         siteId: string;
         resourceId: string;

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

@@ -1,5 +1,6 @@
 import type { TimeSlot } from "./availability";
 import type { BookingPaymentOptionsSource, BookingPaymentTermsConfig, PublicBookingPaymentTermsAvailability, BookingPricing, BookingPricingInput } from "./bookingConfig";
+import type { InviteSiteMemberEmailResult, SiteInvitation, StaffOperationalCapability } from "./accessAdmin";
 import type { CourseEnrollmentRefundFailedCode, EventAttendeeRefundFailedCode } from "./bookingRefundOutcomes";
 /**
  * Booking Operations Contracts
@@ -304,7 +305,37 @@ export type CreateAppointmentResourceRequest = {
     bio?: string | null;
     timezone?: string;
     colorHex?: string | null;
-    calendarSyncEnabled?: boolean;
+};
+export type TeamMemberAccountAccessInput = {
+    kind: "managed_by_site_admins";
+} | {
+    kind: "link_current_user";
+} | {
+    kind: "invite_by_email";
+    email: string;
+    staffCapabilities: StaffOperationalCapability[];
+} | {
+    kind: "link_existing_member";
+    memberId: string;
+};
+export type TeamMemberPractitionerLinkState = {
+    kind: "linked_to_current_user";
+} | {
+    kind: "linked_to_another_user";
+} | {
+    kind: "pending_invite";
+} | {
+    kind: "unlinked";
+};
+export type CreateAppointmentResourceWithAccountAccessRequest = CreateAppointmentResourceRequest & {
+    accountAccess: TeamMemberAccountAccessInput;
+};
+export type CreateAppointmentResourceWithAccountAccessResponse = {
+    resource: DashboardAppointmentResource;
+    linkState: TeamMemberPractitionerLinkState;
+    invitation?: SiteInvitation;
+    email?: InviteSiteMemberEmailResult;
+    accountAccessWarning?: string;
 };
 export type UpdateAppointmentResourceRequest = Partial<CreateAppointmentResourceRequest>;
 export type AppointmentResourceResponse = {

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

@@ -800,6 +800,13 @@ export declare const API_ENDPOINTS: {
         readonly responseKind: "json";
         readonly errors: readonly ["validation:invalid_input", "billing:plan_limit_exceeded", "server:internal_error"];
     };
+    readonly createAppointmentResourceWithAccountAccess: {
+        readonly path: "/sites/{siteId}/bookings/resources/account-access";
+        readonly method: "POST";
+        readonly auth: "user";
+        readonly responseKind: "json";
+        readonly errors: readonly ["validation:invalid_input", "auth:forbidden", "billing:plan_limit_exceeded", "resource:conflict", "resource:not_found", "server:internal_error"];
+    };
     readonly getAppointmentResource: {
         readonly path: "/sites/{siteId}/bookings/resources/{resourceId}";
         readonly method: "GET";

package/dist/_dts/api/src/public/types.d.ts

@@ -8,6 +8,6 @@
  * to get only the types relevant to SDK usage.
  */
 export type { HTTPMethod, ApiResponseKind, ApiAuthRequirement, APIEndpointBase, ContentEntryStatus, ContentEntryListStage, } from '../common/types';
-export type { APIEndpoints } from '../types';
+export type { APICallParams, APIEndpoints } from '../types';
 export type { SiteBySlugResponse, ContentTypeRoutingInfo, ContentTypeRoutingSubroute, NavigationMenuWithItems, NavigationMenuRecord, NavigationItemRecord, SiteLayoutResolvedPayload, SiteLayoutSettingsPayload, RiverbankSiteConfig, SdkThemeConfig, SdkThemePalette, SdkSiteStyleConfig, SdkSectionBackground, SdkSectionOptionsConfig, SdkContainerOptionsConfig, SdkBlockFieldConfig, SdkBlockFieldOptionsMap, SdkFieldSelectOption, ContentEntryListItem, ListPublishedEntriesResponse, PublishedContentEntryPreview, PublishedContentEntryPreviewResponse, PublishedPostPreview, PublishedPostPreviewResponse, FormRecord, PageRecord, PageRouteRecord, ContentRouteRecord, ContentEntryRecord, } from '../types';
 export type { Theme, SdkCustomBlock } from '@riverbankcms/blocks';