@riverbankcms/sdk 0.90.0 → 0.90.1

package/dist/{PreviewEditorSidebar-KVXNF3VW.mjs → PreviewEditorSidebar-FNFRVSIM.mjs}

@@ -1,6 +1,6 @@
 "use client";
-import { resolvePreviewDashboardSetupHandoff, buildPreviewDashboardSetupUrl, resolvePreviewSidebarChromeModel, resolvePreviewEditorGuidanceModel, previewWidgetOverrides, canInspectSiteStyle, mapContentSchemaToFormFields, PreviewFormProvider, usePreviewBlockCustomizeSelectionOptional, BlockEditor, canApplySiteStyle, useBlockCustomizeControls, MAX_QUICK_MANIFEST_FIELDS } from './chunk-RQ3XZ4SJ.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, unwrapResponse, 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-PMBB6MQ7.mjs';
+import { resolvePreviewDashboardSetupHandoff, buildPreviewDashboardSetupUrl, resolvePreviewSidebarChromeModel, resolvePreviewEditorGuidanceModel, previewWidgetOverrides, canInspectSiteStyle, mapContentSchemaToFormFields, PreviewFormProvider, usePreviewBlockCustomizeSelectionOptional, BlockEditor, canApplySiteStyle, useBlockCustomizeControls, MAX_QUICK_MANIFEST_FIELDS } from './chunk-H6TT5ZXI.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, unwrapResponse, 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-CR2VX432.mjs';
 import { usePreviewAuth, getDashboardUrl } from './chunk-BOQXMCSP.mjs';
 import './chunk-R7POPVJR.mjs';
 import { useMemo, useRef, useCallback, useEffect, useState, useTransition, useLayoutEffect, useSyncExternalStore, useId } from 'react';

package/dist/{PreviewEditorUI-J3JN5Z7T.mjs → PreviewEditorUI-3WXJFQXG.mjs}

@@ -1,6 +1,6 @@
 "use client";
-import { resolvePreviewChromeSurface, usePreviewPageDesignEditorState, PREVIEW_CHROME_PORTAL_CLASS_NAME, PREVIEW_CHROME_THEME_CLASS_NAME, applyPreviewChromeSurfaceToElement, setPreviewSidebarTab } from './chunk-GSPFFUVB.mjs';
-import { useEntryEditorController, useEditorUiStore, useMultiAutosave, usePreviewDesignHistoryOrder, useSiteChromeCustomizeOptional, selectPreviewDesignHistoryDomain, EditorChrome, previewDesignHistoryDomainForCommand, classifyHistoryShortcut, previewAssistantEnabled, unwrapResponse, cn, Dialog, Button, Palette, DialogContent, DialogHeader, DialogTitle, DialogDescription, TriangleAlert, Pencil, Sparkles, useEditorUiStoreInstance } from './chunk-PMBB6MQ7.mjs';
+import { resolvePreviewChromeSurface, usePreviewPageDesignEditorState, PREVIEW_CHROME_PORTAL_CLASS_NAME, PREVIEW_CHROME_THEME_CLASS_NAME, applyPreviewChromeSurfaceToElement, setPreviewSidebarTab } from './chunk-SYYJZPKU.mjs';
+import { useEntryEditorController, useEditorUiStore, useMultiAutosave, usePreviewDesignHistoryOrder, useSiteChromeCustomizeOptional, selectPreviewDesignHistoryDomain, EditorChrome, previewDesignHistoryDomainForCommand, classifyHistoryShortcut, previewAssistantEnabled, unwrapResponse, cn, Dialog, Button, Palette, DialogContent, DialogHeader, DialogTitle, DialogDescription, TriangleAlert, Pencil, Sparkles, useEditorUiStoreInstance } from './chunk-CR2VX432.mjs';
 import { usePreviewAuth } from './chunk-BOQXMCSP.mjs';
 import './chunk-R7POPVJR.mjs';
 import { useState, useMemo, useCallback, useEffect, useTransition } from 'react';

package/dist/SdkPreviewModeRuntime-2UCIMKUB.mjs

@@ -0,0 +1,8 @@
+"use client";
+export { SdkPreviewModeRuntime } from './chunk-FA6LVZ7C.mjs';
+import './chunk-UG7I7S7W.mjs';
+import './chunk-H6TT5ZXI.mjs';
+import './chunk-SYYJZPKU.mjs';
+import './chunk-CR2VX432.mjs';
+import './chunk-BOQXMCSP.mjs';
+import './chunk-R7POPVJR.mjs';

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

@@ -1,5 +1,6 @@
 import type { EventOnlineDetails, EventOnlineDetailsInput } from "./bookingRecords";
 import type { SiteVerticalBookingConfig } from "./bookingVerticals";
+import type { EventListingDestinationInput } from "./event-listing-destination";
 import type { EventPricingMode, StaffMemberId, UserId } from "../../core/src/index";
 export type { EventPricingMode } from "../../core/src/index";
 /**
@@ -235,6 +236,7 @@ export type CreateEventSeriesRequest = {
     visibility?: "public" | "private" | "unlisted";
     eventCategoryId?: string | null;
     status?: "draft" | "active" | "archived" | "cancelled" | "completed";
+    listingDestination?: EventListingDestinationInput;
     /** Arbitrary per-series settings persisted to event_series.settings_json (server-validated). */
     settingsJson?: Record<string, unknown>;
     contentEntryId?: string | null;
@@ -380,6 +382,7 @@ export type TeamMemberProfilePageSettings = {
     policy: TeamMemberProfilePagePolicyMode;
 };
 export type { EventDestinationMode, EventDestinationPolicy, EventDestinationPreset, EventDestinationPresetOverrides, } from "./event-destination-policy";
+export type { EventListingDestination, EventListingDestinationInput, PublicEventDestination, } from "./event-listing-destination";
 export { DEFAULT_EVENT_DESTINATION_POLICY, eventDestinationModeValues, eventDestinationPresetValues, isEventDestinationMode, macadamiaDefaultEventDestinationPolicy, resolveEventDestinationMode, } from "./event-destination-policy";
 export type BookingSettings = {
     modules: BookingModuleToggles;

package/dist/_dts/api/src/event-listing-destination.d.ts

@@ -0,0 +1,59 @@
+import { type Brand } from "../../core/src/index";
+import type { EventDestinationMode } from "./event-destination-policy";
+export declare const EVENT_LISTING_DESTINATION_SETTINGS_KEY = "listingDestination";
+export declare const DEFAULT_EXTERNAL_EVENT_CTA_LABEL = "View details";
+export type ExternalEventUrl = Brand<string, "ExternalEventUrl">;
+export type EventListingDestination = Readonly<{
+    kind: "native";
+}> | Readonly<{
+    kind: "external";
+    url: string;
+    label: string | null;
+}>;
+export type EventListingDestinationInput = Readonly<{
+    kind: "native";
+}> | Readonly<{
+    kind: "external";
+    url?: string | null;
+    label?: string | null;
+}>;
+export type PublicEventDestination = Readonly<{
+    kind: "native";
+    mode: EventDestinationMode;
+    path: string;
+}> | Readonly<{
+    kind: "external";
+    url: ExternalEventUrl;
+    label: string;
+}>;
+export type ExternalEventUrlValidationErrorCode = "missing_url" | "invalid_url";
+export type ExternalEventUrlValidationError = Readonly<{
+    code: ExternalEventUrlValidationErrorCode;
+    message: string;
+}>;
+export type ExternalEventUrlValidationResult = Readonly<{
+    ok: true;
+    url: ExternalEventUrl;
+}> | Readonly<{
+    ok: false;
+    error: ExternalEventUrlValidationError;
+}>;
+export type EventListingDestinationPublicationIssue = Readonly<{
+    field: "listingDestination.url";
+    code: ExternalEventUrlValidationErrorCode;
+    message: string;
+}>;
+export declare function normalizeEventListingDestinationInput(value: EventListingDestinationInput | null | undefined): EventListingDestination;
+export declare function readEventListingDestinationFromSettings(settingsJson: unknown): EventListingDestination;
+export declare function serializeEventListingDestination(destination: EventListingDestination): Record<string, unknown>;
+export declare function buildEventListingDestinationSettingsPatch(destination: EventListingDestination): Record<typeof EVENT_LISTING_DESTINATION_SETTINGS_KEY, Record<string, unknown>>;
+export declare function parseExternalEventUrl(value: unknown): ExternalEventUrlValidationResult;
+export declare function getExternalEventCtaLabel(destination: Extract<EventListingDestination, {
+    kind: "external";
+}>): string;
+export declare function getEventListingDestinationPublicationIssue(destination: EventListingDestination): EventListingDestinationPublicationIssue | null;
+export declare function buildPublicEventDestination(input: Readonly<{
+    listingDestination: EventListingDestination;
+    nativeMode: EventDestinationMode;
+    nativePath: string;
+}>): PublicEventDestination | null;

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

@@ -25,6 +25,8 @@ export * from "./customerMembershipOutcomes";
 export * from "./bookingVerticals";
 export { DEFAULT_EVENT_DESTINATION_POLICY, eventDestinationModeValues, eventDestinationPresetValues, isEventDestinationMode, macadamiaDefaultEventDestinationPolicy, resolveEventDestinationMode, } from "./event-destination-policy";
 export type { EventDestinationMode, EventDestinationPolicy, EventDestinationPreset, EventDestinationPresetOverrides, } from "./event-destination-policy";
+export { DEFAULT_EXTERNAL_EVENT_CTA_LABEL, EVENT_LISTING_DESTINATION_SETTINGS_KEY, buildEventListingDestinationSettingsPatch, buildPublicEventDestination, getEventListingDestinationPublicationIssue, getExternalEventCtaLabel, normalizeEventListingDestinationInput, parseExternalEventUrl, readEventListingDestinationFromSettings, serializeEventListingDestination, } from "./event-listing-destination";
+export type { EventListingDestination, EventListingDestinationInput, EventListingDestinationPublicationIssue, ExternalEventUrl, ExternalEventUrlValidationError, ExternalEventUrlValidationErrorCode, ExternalEventUrlValidationResult, PublicEventDestination, } from "./event-listing-destination";
 export { APPOINTMENT_DEFAULT_MAX_BOOKING_NOTICE_MINUTES_MAX, APPOINTMENT_DEFAULT_MIN_LEAD_MINUTES_MAX, applyAppointmentSetupRequestSchema, applyAppointmentSetupRequest, appointmentSetupAvailabilityDraftSchema, appointmentSetupBookingNoticeSchema, appointmentSetupPaymentDraftSchema, appointmentSetupPractitionerDraftSchema, appointmentSetupRefSchema, appointmentSetupServiceAssignmentDraftSchema, appointmentSetupServiceDraftSchema, appointmentSetupVenueChoiceSchema, appointmentSetupWeeklyWindowDraftSchema, getAppointmentSetupRequest, } from "./appointmentSetup";
 export type { ApplyAppointmentSetupRequest, ApplyAppointmentSetupResponse, AppointmentPractitionerMode, AppointmentSetupAvailabilityDraft, AppointmentSetupAvailabilityWindowInvalidReason, AppointmentSetupBookingNotice, AppointmentSetupDraftMapping, AppointmentSetupPaymentDraft, AppointmentSetupPlanIssue, AppointmentSetupPractitionerDraft, AppointmentSetupReadiness, AppointmentSetupRef, AppointmentSetupResponse, AppointmentSetupSeedCandidate, AppointmentSetupSeedInvalidMetadata, AppointmentSetupSeedSelection, AppointmentSetupServiceAssignmentDraft, AppointmentSetupServiceDraft, AppointmentSetupServiceResourceLink, AppointmentSetupTargetStep, AppointmentSetupVenueChoice, AppointmentSetupWeeklyWindowDraft, } from "./appointmentSetup";
 export type { AppointmentHistoryStatus, BookingSessionCreateAppointmentRequest, BookingSessionCreateAppointmentResponse, BookingSessionEligibleAppointmentPackage, BookingSessionListEligibleAppointmentPackagesResponse, } from "./bookingOperations";
@@ -76,12 +78,14 @@ export { toRoutableLinkPayload } from "./navigation/routableLink";
 export { linkPayloadKindToNavigationUrlType } from "./navigation/linkUrlType";
 export { DASHBOARD_SITE_NAV_DESCRIPTORS, buildDashboardSiteNavPlan, dashboardDemoUiModeValues, isDemoDashboardUiRestricted, isDemoSiteNavSurfaceVisible, } from "./navigation/dashboardSiteNav";
 export { DASHBOARD_SETTINGS_NAV_GROUPS, buildDashboardSettingsNavPlan, isDemoSettingsNavSurfaceVisible, } from "./navigation/dashboardSettingsNav";
+export { SETTINGS_ACTION_POLICIES, SETTINGS_SURFACE_POLICIES, getRolePolicyMinimumRole, getSettingsActionPolicy, getSettingsSurfaceNavPolicy, getSettingsSurfacePagePolicy, getSettingsSurfacePolicy, isSettingsRolePolicyAllowed, } from "./settings/permissions";
 export { planEntryDraftUpdatedWorkflowTriggers } from "./workflows/automaticWorkflowTriggers";
 export type { AutomaticWorkflowCandidate, EntryDraftUpdatedWorkflowTriggerSource, PlanEntryDraftUpdatedWorkflowTriggersInput, WorkflowTriggerSource, } from "./workflows/automaticWorkflowTriggers";
 export type { RoutableLinkPayload } from "./navigation/routableLink";
 export type { LinkPayloadNavigationUrlType } from "./navigation/linkUrlType";
 export type { DashboardDemoUiMode, DashboardSiteNavDescriptor, DashboardSiteNavGroupId, DashboardSiteNavGroupPlan, DashboardSiteNavItemPlan, DashboardSiteNavLinkPlan, DashboardSiteNavPlanContext, DashboardSiteNavSurfaceId, SiteNavFeatureFlag, } from "./navigation/dashboardSiteNav";
 export type { DashboardSettingsDangerItemId, DashboardSettingsDangerItemPlan, DashboardSettingsNavDescriptor, DashboardSettingsNavGroupDescriptor, DashboardSettingsNavGroupPlan, DashboardSettingsNavItemPlan, DashboardSettingsNavPlan, DashboardSettingsNavPlanContext, DashboardSettingsNavSurfaceId, SettingsNavFeatureFlag, } from "./navigation/dashboardSettingsNav";
+export type { SettingsActionId, SettingsPermissionPolicy, SettingsRolePermissionPolicy, SettingsSurfacePolicy, } from "./settings/permissions";
 export { isInternalLink, isPageLink, isEntryLink, resolveNavigationLinkInput, } from "./navigation/linkResolver";
 export type { NavigationUrlType, ResolvedNavigationLink, LinkResolutionOptions, } from "./navigation/linkResolver";
 export { matchNavigationItems } from "./navigation/matcher";

package/dist/_dts/api/src/navigation/dashboardSettingsNav.d.ts

@@ -9,7 +9,6 @@ export type DashboardSettingsNavDescriptor = Readonly<{
     label: string;
     keywords: readonly string[];
     stage: NavStage;
-    minRole?: SiteRole;
     featureFlag?: SettingsNavFeatureFlag;
 }>;
 export type DashboardSettingsNavGroupDescriptor = Readonly<{

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

@@ -9,12 +9,14 @@ export { linkPayloadKindToNavigationUrlType } from './navigation/linkUrlType';
 export type { LinkPayloadNavigationUrlType } from './navigation/linkUrlType';
 export { DASHBOARD_SITE_NAV_DESCRIPTORS, buildDashboardSiteNavPlan, dashboardDemoUiModeValues, isDemoDashboardUiRestricted, isDemoSiteNavSurfaceVisible, } from './navigation/dashboardSiteNav';
 export { DASHBOARD_SETTINGS_NAV_GROUPS, buildDashboardSettingsNavPlan, isDemoSettingsNavSurfaceVisible, } from './navigation/dashboardSettingsNav';
+export { SETTINGS_ACTION_POLICIES, SETTINGS_SURFACE_POLICIES, getRolePolicyMinimumRole, getSettingsActionPolicy, getSettingsSurfaceNavPolicy, getSettingsSurfacePagePolicy, getSettingsSurfacePolicy, isSettingsRolePolicyAllowed, } from './settings/permissions';
 export { buildDashboardTeamMemberNavPlan, isTeamMemberAccessiblePath, } from './navigation/dashboardTeamMemberNav';
 export { buildDashboardBookingsNavPlan, resolveDashboardBookingsNavPolicy, } from './navigation/dashboardBookingsNav';
 export { MAIN_NAVIGATION_MENU_IDENTIFIER, actionableNavigationMenuMatchPlan, isMainNavigationMenuIdentifier, navigationMenuIdentity, normalizeNavigationMenuIdentifier, parseNavigationMenuIdentifier, planNavigationMenuMatch, unsafeAsNavigationMenuIdentifier, unsafeAsNavigationMenuIdentity, } from './navigation/identity';
 export { isDemoMoneyNavSurfaceVisible, isDemoShopNavSurfaceVisible, } from './navigation/dashboardDemoNav';
 export type { DashboardDemoUiMode, DashboardSiteNavDescriptor, DashboardSiteNavGroupId, DashboardSiteNavGroupPlan, DashboardSiteNavItemPlan, DashboardSiteNavLinkPlan, DashboardSiteNavPlanContext, DashboardSiteNavSurfaceId, SiteNavFeatureFlag, } from './navigation/dashboardSiteNav';
 export type { DashboardSettingsDangerItemId, DashboardSettingsDangerItemPlan, DashboardSettingsNavDescriptor, DashboardSettingsNavGroupDescriptor, DashboardSettingsNavGroupPlan, DashboardSettingsNavItemPlan, DashboardSettingsNavPlan, DashboardSettingsNavPlanContext, DashboardSettingsNavSurfaceId, SettingsNavFeatureFlag, } from './navigation/dashboardSettingsNav';
+export type { SettingsActionId, SettingsPermissionPolicy, SettingsRolePermissionPolicy, SettingsSurfacePolicy, } from './settings/permissions';
 export type { DashboardTeamMemberNavContext, DashboardTeamMemberNavDestination, DashboardTeamMemberNavItemId, DashboardTeamMemberNavItemPlan, } from './navigation/dashboardTeamMemberNav';
 export type { DashboardAppointmentResourceLabel, DashboardBookingModules, DashboardBookingsNavContext, DashboardBookingsNavDestination, DashboardBookingsNavGroupPlan, DashboardBookingsNavItemPlan, DashboardBookingsNavPolicy, DashboardBookingsTeamMemberContext, FullAppointmentsNavPolicy, StaffScopedAppointmentsNavPolicy, } from './navigation/dashboardBookingsNav';
 export type { DashboardMoneyNavSurfaceId, DashboardShopNavSurfaceId, } from './navigation/dashboardDemoNav';

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

@@ -1,5 +1,6 @@
 import type { APIEndpoint } from "./apiEndpointTypes";
 import type { PublicEventPricing } from "../../core/src/index";
+import type { PublicEventDestination } from "./event-listing-destination";
 import type { BookingPaymentTermsConfig, BookingPricing, DirectCheckoutCollectionOptionKind, EventAttendanceMode, EventDeliveryMode, EventPricingMode, PublicEventEligibilityTicketTypeRecord, PublicEventTicketTypeRecord } from "./bookingConfig";
 import type { AutoAppliedDiscountPreview } from "./bookingRecords";
 import type { PublicCourseDetails } from "./courses";
@@ -123,6 +124,7 @@ export type PublicExperienceAPIEndpoints = {
         kind?: "event" | "course_session";
         eventPreset?: EventPreset;
         eventDestinationMode?: import("./event-destination-policy").EventDestinationMode;
+        destination: PublicEventDestination;
         scheduleScope?: Exclude<PublicEventScheduleScope, "any">;
         id: string;
         occurrenceId: string;
@@ -154,7 +156,7 @@ export type PublicExperienceAPIEndpoints = {
             } | null;
         };
         slug: string;
-        path: string;
+        path: string | null;
         requiresRegistration: boolean;
         deliveryMode: EventDeliveryMode;
         attendanceModes: Array<{

package/dist/_dts/api/src/settings/permissions.d.ts

@@ -0,0 +1,273 @@
+import type { DashboardSettingsNavSurfaceId } from "../navigation/dashboardSettingsNav";
+import { type SiteRole } from "../siteMembers";
+export type SettingsPermissionPolicy = Readonly<{
+    kind: "roleAtLeast";
+    minimumRole: SiteRole;
+}> | Readonly<{
+    kind: "siteRecordOwner";
+}>;
+export type SettingsRolePermissionPolicy = Extract<SettingsPermissionPolicy, {
+    kind: "roleAtLeast";
+}>;
+export type SettingsActionId = "privacy.update" | "emails.read" | "emails.update" | "apiKeys.read" | "apiKeys.readAccessLogs" | "apiKeys.manageContentKeys" | "apiKeys.managePreviewKey" | "apiKeys.manageManagementKeys" | "backup.export" | "backup.import" | "fonts.upload";
+export type SettingsSurfacePolicy = Readonly<{
+    surfaceId: DashboardSettingsNavSurfaceId;
+    navVisibilityPolicy: SettingsRolePermissionPolicy;
+    pageAccessPolicy: SettingsPermissionPolicy;
+    actionIds: readonly SettingsActionId[];
+}>;
+export declare const SETTINGS_SURFACE_POLICIES: {
+    readonly "settings.features": {
+        readonly surfaceId: "settings.features";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.general": {
+        readonly surfaceId: "settings.general";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.privacy": {
+        readonly surfaceId: "settings.privacy";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly ["privacy.update"];
+    };
+    readonly "settings.domains": {
+        readonly surfaceId: "settings.domains";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "owner";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "owner";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.fonts": {
+        readonly surfaceId: "settings.fonts";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly ["fonts.upload"];
+    };
+    readonly "settings.bookings": {
+        readonly surfaceId: "settings.bookings";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.redirects": {
+        readonly surfaceId: "settings.redirects";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.emails": {
+        readonly surfaceId: "settings.emails";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly ["emails.read", "emails.update"];
+    };
+    readonly "settings.ai.siteProfile": {
+        readonly surfaceId: "settings.ai.siteProfile";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.ai.brandGuidelines": {
+        readonly surfaceId: "settings.ai.brandGuidelines";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.ai.iconStyleGuide": {
+        readonly surfaceId: "settings.ai.iconStyleGuide";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.team": {
+        readonly surfaceId: "settings.team";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.billing": {
+        readonly surfaceId: "settings.billing";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "editor";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.developer": {
+        readonly surfaceId: "settings.developer";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.logs": {
+        readonly surfaceId: "settings.logs";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly [];
+    };
+    readonly "settings.apiKeys": {
+        readonly surfaceId: "settings.apiKeys";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "administrator";
+        };
+        readonly actionIds: readonly ["apiKeys.read", "apiKeys.readAccessLogs", "apiKeys.manageContentKeys", "apiKeys.managePreviewKey", "apiKeys.manageManagementKeys"];
+    };
+    readonly "settings.backup": {
+        readonly surfaceId: "settings.backup";
+        readonly navVisibilityPolicy: {
+            readonly kind: "roleAtLeast";
+            readonly minimumRole: "owner";
+        };
+        readonly pageAccessPolicy: {
+            readonly kind: "siteRecordOwner";
+        };
+        readonly actionIds: readonly ["backup.export", "backup.import"];
+    };
+};
+export declare const SETTINGS_ACTION_POLICIES: {
+    readonly "privacy.update": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "administrator";
+    };
+    readonly "emails.read": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "administrator";
+    };
+    readonly "emails.update": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "administrator";
+    };
+    readonly "apiKeys.read": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "editor";
+    };
+    readonly "apiKeys.readAccessLogs": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "editor";
+    };
+    readonly "apiKeys.manageContentKeys": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "administrator";
+    };
+    readonly "apiKeys.managePreviewKey": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "administrator";
+    };
+    readonly "apiKeys.manageManagementKeys": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "administrator";
+    };
+    readonly "backup.export": {
+        readonly kind: "siteRecordOwner";
+    };
+    readonly "backup.import": {
+        readonly kind: "siteRecordOwner";
+    };
+    readonly "fonts.upload": {
+        readonly kind: "roleAtLeast";
+        readonly minimumRole: "editor";
+    };
+};
+export declare function getSettingsSurfacePolicy(surfaceId: DashboardSettingsNavSurfaceId): SettingsSurfacePolicy;
+export declare function getSettingsSurfaceNavPolicy(surfaceId: DashboardSettingsNavSurfaceId): SettingsRolePermissionPolicy;
+export declare function getSettingsSurfacePagePolicy(surfaceId: DashboardSettingsNavSurfaceId): SettingsPermissionPolicy;
+export declare function getSettingsActionPolicy(actionId: SettingsActionId): SettingsPermissionPolicy;
+export declare function getRolePolicyMinimumRole(policy: SettingsPermissionPolicy): SiteRole | null;
+export declare function isSettingsRolePolicyAllowed(role: SiteRole | null, policy: SettingsRolePermissionPolicy): boolean;

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

@@ -11,6 +11,7 @@ export type * from "./aiEndpoints";
 export type * from "./apiEndpointTypes";
 export type * from "./bookingAdjustments";
 export type * from "./bookingConfig";
+export type * from "./event-listing-destination";
 export type * from "./bookingVerticals";
 export type * from "./bookingManagementEndpoints";
 export type * from "./bookingOperations";

package/dist/_dts/blocks/src/system/blocks/events/shared/schemas.d.ts

@@ -14,6 +14,18 @@ export declare const eventDestinationModeSchema: z.ZodEnum<{
     "cms-managed": "cms-managed";
     "system-managed": "system-managed";
 }>;
+export declare const publicEventDestinationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"native">;
+    mode: z.ZodEnum<{
+        "cms-managed": "cms-managed";
+        "system-managed": "system-managed";
+    }>;
+    path: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"external">;
+    url: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>], "kind">;
 /**
  * Zod schema for venue data
  */
@@ -40,6 +52,7 @@ export declare const eventCategorySchema: z.ZodObject<{
 export declare const pricingTypeSchema: z.ZodEnum<{
     free: "free";
     paid: "paid";
+    external: "external";
 }>;
 /**
  * Access restriction type for public events
@@ -91,6 +104,9 @@ export declare const publicEventPriceDisplaySchema: z.ZodDiscriminatedUnion<[z.Z
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"unavailable">;
     currency: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"external">;
+    label: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"course">;
     display: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -309,6 +325,12 @@ export declare const publicEventPricingSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             currency: z.ZodString;
         }, z.core.$strip>], "kind">;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"external">;
+    display: z.ZodObject<{
+        kind: z.ZodLiteral<"external">;
+        label: z.ZodString;
+    }, z.core.$strip>;
 }, z.core.$strip>], "kind">;
 export declare const publicTeamMemberSummarySchema: z.ZodObject<{
     id: z.ZodString;
@@ -615,7 +637,19 @@ export declare const publicEventSchema: z.ZodObject<{
         }, z.core.$strip>], "type">>>;
     }, z.core.$strip>>;
     slug: z.ZodString;
-    path: z.ZodString;
+    path: z.ZodNullable<z.ZodString>;
+    destination: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"native">;
+        mode: z.ZodEnum<{
+            "cms-managed": "cms-managed";
+            "system-managed": "system-managed";
+        }>;
+        path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"external">;
+        url: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>], "kind">;
     requiresRegistration: z.ZodBoolean;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
@@ -774,6 +808,12 @@ export declare const publicEventSchema: z.ZodObject<{
                 currency: z.ZodString;
             }, z.core.$strip>], "kind">;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"external">;
+        display: z.ZodObject<{
+            kind: z.ZodLiteral<"external">;
+            label: z.ZodString;
+        }, z.core.$strip>;
     }, z.core.$strip>], "kind">;
     paymentTerms: z.ZodObject<{
         allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -1241,7 +1281,19 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodObject<{
         }, z.core.$strip>], "type">>>;
     }, z.core.$strip>>;
     slug: z.ZodString;
-    path: z.ZodString;
+    path: z.ZodNullable<z.ZodString>;
+    destination: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"native">;
+        mode: z.ZodEnum<{
+            "cms-managed": "cms-managed";
+            "system-managed": "system-managed";
+        }>;
+        path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"external">;
+        url: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>], "kind">;
     requiresRegistration: z.ZodBoolean;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
@@ -1400,6 +1452,12 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodObject<{
                 currency: z.ZodString;
             }, z.core.$strip>], "kind">;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"external">;
+        display: z.ZodObject<{
+            kind: z.ZodLiteral<"external">;
+            label: z.ZodString;
+        }, z.core.$strip>;
     }, z.core.$strip>], "kind">;
     paymentTerms: z.ZodObject<{
         allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{

package/dist/_dts/blocks/src/system/blocks/events/shared/types.d.ts

@@ -39,6 +39,15 @@ export type PricingType = PublicEventPricingType;
  * Access restriction type for events
  */
 export type AccessRestriction = "none" | "category";
+export type PublicEventDestination = Readonly<{
+    kind: "native";
+    mode: "cms-managed" | "system-managed";
+    path: string;
+}> | Readonly<{
+    kind: "external";
+    url: string;
+    label: string;
+}>;
 export type PublicEventTicketTypeAvailability = {
     kind: "available";
     remainingCapacity: number | null;
@@ -84,6 +93,8 @@ export type PublicEvent = {
     eventPreset?: "event" | EventSurfacePreset;
     /** Resolved destination mode for the event series. */
     eventDestinationMode?: "cms-managed" | "system-managed";
+    /** Public navigation destination for cards/details CTAs. */
+    destination: PublicEventDestination;
     /** Whether this occurrence belongs to a recurring or one-off series. */
     scheduleScope?: Exclude<EventScheduleScope, "any">;
     id: string;
@@ -102,7 +113,7 @@ export type PublicEvent = {
     };
     slug: string;
     /** Canonical URL path (includes any required date segments for occurrences) */
-    path: string;
+    path: string | null;
     /** Whether this event requires registration (drop-in events return false). */
     requiresRegistration: boolean;
     /** How people can attend this event. */