@riverbankcms/sdk 0.78.2 → 0.80.0

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

@@ -1,7 +1,7 @@
 import type { SiteRole } from "../siteMembers";
 import { type NavStage } from "./visibility";
 import { type DashboardDemoUiMode } from "./dashboardSiteNav";
-export type DashboardSettingsNavSurfaceId = "settings.features" | "settings.general" | "settings.privacy" | "settings.domains" | "settings.fonts" | "settings.bookings" | "settings.redirects" | "settings.emails" | "settings.ai.siteProfile" | "settings.ai.brandGuidelines" | "settings.team" | "settings.billing" | "settings.developer" | "settings.logs" | "settings.apiKeys" | "settings.backup";
+export type DashboardSettingsNavSurfaceId = "settings.features" | "settings.general" | "settings.privacy" | "settings.domains" | "settings.fonts" | "settings.bookings" | "settings.redirects" | "settings.emails" | "settings.ai.siteProfile" | "settings.ai.brandGuidelines" | "settings.ai.iconStyleGuide" | "settings.team" | "settings.billing" | "settings.developer" | "settings.logs" | "settings.apiKeys" | "settings.backup";
 export type DashboardSettingsDangerItemId = "settings.danger";
 export type SettingsNavFeatureFlag = "hasSiteCost";
 export type DashboardSettingsNavDescriptor = Readonly<{

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

@@ -1,11 +1,11 @@
-import type { SiteRole } from "../siteMembers";
-import { type NavStage } from "./visibility";
+import type { SiteRole } from '../siteMembers';
+import { type NavStage } from './visibility';
 export declare const dashboardDemoUiModeValues: readonly ["standard", "demo"];
 export type DashboardDemoUiMode = (typeof dashboardDemoUiModeValues)[number];
 export declare function isDemoDashboardUiRestricted(mode: DashboardDemoUiMode): boolean;
-export type DashboardSiteNavSurfaceId = "site.overview" | "site.content" | "site.footerBlocks" | "site.navigation" | "site.media" | "site.bookings" | "site.shop" | "site.money" | "site.newsletter" | "site.style" | "site.performance" | "site.settings";
-export type DashboardSiteNavGroupId = "site.website";
-export type SiteNavFeatureFlag = "analyticsVisible" | "bookingsVisible" | "isSdkSite" | "moneyVisible" | "newsletterVisible" | "shopVisible" | "themeEditorVisible";
+export type DashboardSiteNavSurfaceId = 'site.overview' | 'site.content' | 'site.footerBlocks' | 'site.navigation' | 'site.media' | 'site.bookings' | 'site.shop' | 'site.money' | 'site.newsletter' | 'site.performance' | 'site.settings';
+export type DashboardSiteNavGroupId = 'site.website';
+export type SiteNavFeatureFlag = 'analyticsVisible' | 'bookingsVisible' | 'footerBlocksVisible' | 'isSdkSite' | 'moneyVisible' | 'newsletterVisible' | 'shopVisible';
 export type DashboardSiteNavDescriptor = Readonly<{
     id: DashboardSiteNavSurfaceId;
     label: string;
@@ -14,12 +14,12 @@ export type DashboardSiteNavDescriptor = Readonly<{
     featureFlag?: SiteNavFeatureFlag;
 }>;
 export type DashboardSiteNavLinkPlan = Readonly<{
-    kind: "link";
+    kind: 'link';
     id: DashboardSiteNavSurfaceId;
     label: string;
 }>;
 export type DashboardSiteNavGroupPlan = Readonly<{
-    kind: "group";
+    kind: 'group';
     id: DashboardSiteNavGroupId;
     label: string;
     items: readonly DashboardSiteNavLinkPlan[];
@@ -30,11 +30,11 @@ export type DashboardSiteNavPlanContext = Readonly<{
     sdkConfig: unknown;
     analyticsVisible?: boolean;
     bookingsVisible?: boolean;
+    footerBlocksVisible?: boolean;
     isSdkSite?: boolean;
     moneyVisible?: boolean;
     newsletterVisible?: boolean;
     shopVisible?: boolean;
-    themeEditorVisible?: boolean;
     demoUiMode?: DashboardDemoUiMode;
 }>;
 export declare const DASHBOARD_SITE_NAV_DESCRIPTORS: readonly DashboardSiteNavDescriptor[];

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

@@ -0,0 +1,59 @@
+import { type Brand, type Result } from '../../../core/src/index';
+export type NavigationMenuIdentifier = Brand<string, 'NavigationMenuIdentifier'>;
+export type NavigationMenuIdentity = Brand<string, 'NavigationMenuIdentity'>;
+export type NavigationMenuIdentifierParseError = Readonly<{
+    kind: 'not_string';
+}> | Readonly<{
+    kind: 'empty_string';
+}>;
+export type NavigationMenuIdentityInput = Readonly<{
+    identifier?: string | null;
+    name: string;
+}>;
+export type NavigationMenuMatchCandidate = Readonly<{
+    id: string;
+    identifier?: string | null;
+    name: string;
+    isPrimary: boolean;
+}>;
+export type NavigationMenuMatchInput = Readonly<{
+    identifier?: string | null;
+    name: string;
+}>;
+export type NavigationMenuMatchPlan = Readonly<{
+    type: 'create';
+    identifier: NavigationMenuIdentifier | null;
+} | {
+    type: 'update';
+    menuId: string;
+    identifier: NavigationMenuIdentifier | null;
+} | {
+    type: 'adopt_legacy_primary';
+    menuId: string;
+    identifier: NavigationMenuIdentifier;
+} | {
+    type: 'identifier_conflict';
+    identifier: NavigationMenuIdentifier;
+    menuIds: readonly string[];
+} | {
+    type: 'ambiguous_legacy_primary';
+    identifier: NavigationMenuIdentifier;
+    menuIds: readonly string[];
+} | {
+    type: 'ambiguous_name';
+    name: string;
+    menuIds: readonly string[];
+}>;
+export type ActionableNavigationMenuMatchPlan = Extract<NavigationMenuMatchPlan, {
+    type: 'create' | 'update' | 'adopt_legacy_primary';
+}>;
+export type NavigationMenuMatchFailure = Exclude<NavigationMenuMatchPlan, ActionableNavigationMenuMatchPlan>;
+export declare function unsafeAsNavigationMenuIdentifier(identifier: string): NavigationMenuIdentifier;
+export declare function unsafeAsNavigationMenuIdentity(identity: string): NavigationMenuIdentity;
+export declare const MAIN_NAVIGATION_MENU_IDENTIFIER: NavigationMenuIdentifier;
+export declare function parseNavigationMenuIdentifier(value: unknown): Result<NavigationMenuIdentifier, NavigationMenuIdentifierParseError>;
+export declare function normalizeNavigationMenuIdentifier(identifier: string | null | undefined): NavigationMenuIdentifier | null;
+export declare function isMainNavigationMenuIdentifier(identifier: string | null | undefined): boolean;
+export declare function navigationMenuIdentity(input: NavigationMenuIdentityInput): NavigationMenuIdentity;
+export declare function planNavigationMenuMatch(input: NavigationMenuMatchInput, menus: readonly NavigationMenuMatchCandidate[]): NavigationMenuMatchPlan;
+export declare function actionableNavigationMenuMatchPlan(plan: NavigationMenuMatchPlan): Result<ActionableNavigationMenuMatchPlan, NavigationMenuMatchFailure>;

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

@@ -9,12 +9,14 @@ export { DASHBOARD_SITE_NAV_DESCRIPTORS, buildDashboardSiteNavPlan, dashboardDem
 export { DASHBOARD_SETTINGS_NAV_GROUPS, buildDashboardSettingsNavPlan, isDemoSettingsNavSurfaceVisible, } from './navigation/dashboardSettingsNav';
 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 { 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';
+export type { ActionableNavigationMenuMatchPlan, NavigationMenuIdentifier, NavigationMenuIdentifierParseError, NavigationMenuIdentity, NavigationMenuIdentityInput, NavigationMenuMatchCandidate, NavigationMenuMatchFailure, NavigationMenuMatchInput, NavigationMenuMatchPlan, } from './navigation/identity';
 export { linkPayloadToValue, linkValueToPayload, toInternalLinkValue, toPersistableNavigationLinkValue, } from './navigation/linkValue';
 export type { PersistableNavigationLinkError, PersistableNavigationLinkResult, PersistableNavigationLinkValue, } from './navigation/linkValue';
 export type { CartLinkLabelConfig, CartLinkPayload, EntryLinkPayload, InternalLinkRoutablePayload, LinkResolutionOptions, LinkPayload, NavigationLinkInput, NavigationUrlType, PageLinkPayload, PortalLinkPayload, ResolvedNavigationLink, RoutableContentItem, SitemapRouteItem, } from './navigation/types';

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

@@ -4,6 +4,7 @@ import type { AutoAppliedDiscountPreview } from "./bookingRecords";
 import type { PublicCourseDetails } from "./courses";
 import type { PublicTeamMemberBlockItem, PublicTeamMemberSummary } from "./teamMembers";
 import type { EventPreset } from "./bookingConfig";
+import type { GeneratedIconRenderAssetsRequest, GeneratedIconRenderAssetsResponse } from "./siteIcons";
 /**
  * Public-experience endpoints group the storefront-facing event, booking, newsletter,
  * and commerce loaders that are shared by blocks and public site runtime consumers.
@@ -678,6 +679,9 @@ export type PublicExperienceAPIEndpoints = {
             };
         }>;
     }>;
+    getGeneratedIconRenderAssets: APIEndpoint<GeneratedIconRenderAssetsRequest, {
+        siteId: string;
+    }, GeneratedIconRenderAssetsResponse>;
     resolveEntrySubroute: APIEndpoint<never, {
         siteId: string;
         entryId: string;

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

@@ -727,6 +727,7 @@ export interface SdkGetCourseResponse {
 export interface SdkUpsertNavigationMenuResponse {
     menu: {
         id: string;
+        identifier: string | null;
         name: string;
         isPrimary: boolean;
         isFooter: boolean;

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

@@ -0,0 +1,128 @@
+export type SiteIconStyleStrokeRule = "line" | "filled" | "duotone";
+export type SemanticIconId = string;
+export type BlockIconValue = {
+    kind: "none";
+} | {
+    kind: "semantic";
+    iconId: SemanticIconId;
+} | {
+    kind: "generated";
+    setId: string;
+    assetId: string;
+    semanticFallbackIconId: SemanticIconId;
+    styleGuideVersionId: string;
+};
+export type SiteIconStyleGuidePayload = {
+    displaySummary: string;
+    untrustedStyleContext: string[];
+    paletteGuidance: string[];
+    strokeRule: SiteIconStyleStrokeRule;
+    fillRule: string;
+    backgroundRule: string;
+    metaphorGuidance: string;
+    avoidList: string[];
+};
+export type SiteIconStyleGuideFreshnessPayload = {
+    kind: "current";
+    sourceFingerprint: string;
+    versionId: string;
+} | {
+    kind: "stale";
+    guideFingerprint: string;
+    currentSourceFingerprint: string;
+    guideVersionId: string;
+    currentVersionId: string;
+};
+export type SiteIconStyleGuideResponse = {
+    guide: SiteIconStyleGuidePayload & {
+        versionId: string;
+        sourceFingerprint: string;
+        provenanceKind: "deterministic" | "ai" | "manual";
+    };
+    source: {
+        brandGuidelinesAvailable: boolean;
+        paletteColorCount: number;
+        approvedExampleRefCount: number;
+    };
+    freshness: SiteIconStyleGuideFreshnessPayload;
+};
+export type SiteIconStyleGuideUpdateRequest = SiteIconStyleGuidePayload;
+export type GeneratedIconSetCardRequest = {
+    cardKey: string;
+    title: string;
+    bodyText: string;
+    semanticIconId: SemanticIconId;
+};
+export type GeneratedIconSetGenerateRequest = {
+    blockKind: string;
+    blockLabel: string;
+    cards: GeneratedIconSetCardRequest[];
+    userStyleNote?: string | null;
+};
+export type GeneratedIconSetPreviewAsset = {
+    cardKey: string;
+    src: string;
+    width: number;
+    height: number;
+    iconValue: BlockIconValue;
+};
+export type GeneratedIconSetCandidateAsset = {
+    cardKey: string;
+    mimeType: "image/png" | "image/webp";
+    width: number;
+    height: number;
+    byteLength: number;
+    bytesBase64: string;
+};
+export type GeneratedIconSetCandidate = {
+    setId: string;
+    blockKind: string;
+    blockLabel: string;
+    userStyleNote: string | null;
+    styleGuideVersionId: string;
+    styleGuideSourceFingerprint: string;
+    prompt: string;
+    promptFingerprint: string;
+    providerName: string;
+    modelId: string;
+    cards: GeneratedIconSetCardRequest[];
+    assets: GeneratedIconSetCandidateAsset[];
+};
+export type GeneratedIconSetGenerateResponse = {
+    styleGuide: {
+        versionId: string;
+        sourceFingerprint: string;
+        displaySummary: string;
+    };
+    candidate: GeneratedIconSetCandidate;
+    preview: {
+        assets: GeneratedIconSetPreviewAsset[];
+    };
+};
+export type GeneratedIconSetApplyRequest = {
+    candidate: GeneratedIconSetCandidate;
+};
+export type GeneratedIconSetApplyResponse = {
+    setId: string;
+    styleGuideVersionId: string;
+    assets: Array<{
+        cardKey: string;
+        mediaAssetId: string;
+        iconValue: BlockIconValue;
+    }>;
+};
+export type GeneratedIconRenderAssetRef = {
+    setId: string;
+    assetId: string;
+};
+export type GeneratedIconRenderAssetsRequest = {
+    refs: GeneratedIconRenderAssetRef[];
+};
+export type GeneratedIconRenderAsset = GeneratedIconRenderAssetRef & {
+    src: string;
+    width?: number;
+    height?: number;
+};
+export type GeneratedIconRenderAssetsResponse = {
+    assets: GeneratedIconRenderAsset[];
+};

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

@@ -69,6 +69,129 @@ export type UpdateWebhookResponse = {
 export type DeleteWebhookResponse = {
     success: boolean;
 };
+export type SetupSdkRevalidationWebhookRequest = {
+    url: string;
+    name?: string;
+    rotateSecret?: boolean;
+    dryRun?: boolean;
+    vercel?: boolean;
+};
+export type SdkRevalidationWebhookPlannedEndpoint = {
+    name: string;
+    url: string;
+    events: string[];
+    enabled: boolean;
+    rotateSecret: boolean;
+};
+type SdkRevalidationWebhookSetupBase = {
+    message: string;
+    checklist: string[];
+    plannedEndpoint: SdkRevalidationWebhookPlannedEndpoint;
+};
+export type SetupSdkRevalidationWebhookDryRunResponse = SdkRevalidationWebhookSetupBase & {
+    dryRun: true;
+    action: 'would_create' | 'would_update' | 'would_rotate' | 'would_leave_unchanged';
+    endpoint: WebhookEndpointRecord | null;
+};
+export type SetupSdkRevalidationWebhookCreatedResponse = SdkRevalidationWebhookSetupBase & {
+    dryRun: false;
+    action: 'created' | 'rotated';
+    endpoint: WebhookEndpointRecord;
+    secret: string;
+};
+export type SetupSdkRevalidationWebhookUpdatedResponse = SdkRevalidationWebhookSetupBase & {
+    dryRun: false;
+    action: 'updated' | 'unchanged';
+    endpoint: WebhookEndpointRecord;
+};
+export type SetupSdkRevalidationWebhookResponse = SetupSdkRevalidationWebhookDryRunResponse | SetupSdkRevalidationWebhookCreatedResponse | SetupSdkRevalidationWebhookUpdatedResponse;
+export type SdkDeploymentHealthStatus = 'not_connected' | 'misconfigured' | 'attention_needed' | 'healthy' | 'unknown';
+export type SdkDeploymentHealthIssueCode = 'endpoint_missing' | 'duplicate_sdk_revalidation_endpoints' | 'endpoint_disabled' | 'endpoint_missing_secret' | 'endpoint_missing_events' | 'recent_delivery_failed' | 'failure_count_nonzero' | 'secret_rotated_without_success' | 'no_delivery_evidence';
+export type SdkDeploymentHealthAction = {
+    tag: 'create_endpoint';
+    label: string;
+    adminOnly: true;
+} | {
+    tag: 'repair_endpoint';
+    label: string;
+    adminOnly: true;
+} | {
+    tag: 'rotate_secret';
+    label: string;
+    adminOnly: true;
+} | {
+    tag: 'inspect_logs';
+    label: string;
+    adminOnly: false;
+} | {
+    tag: 'none';
+    label: string;
+    adminOnly: false;
+};
+export type SdkDeploymentSafeDeliveryStatus = 'success' | 'failed' | 'unknown';
+export type SdkDeploymentSafeDeliverySummary = {
+    id: string;
+    event: string;
+    status: SdkDeploymentSafeDeliveryStatus;
+    statusCode: number | null;
+    responseTimeMs: number | null;
+    deliveredAt: string;
+    snippet: string | null;
+};
+export type SdkDeploymentHealthState = {
+    tag: 'not_connected';
+    status: 'not_connected';
+    message: string;
+    issues: Array<{
+        code: Extract<SdkDeploymentHealthIssueCode, 'endpoint_missing'>;
+        message: string;
+    }>;
+    actions: SdkDeploymentHealthAction[];
+} | {
+    tag: 'misconfigured';
+    status: 'misconfigured';
+    message: string;
+    issues: Array<{
+        code: Extract<SdkDeploymentHealthIssueCode, 'duplicate_sdk_revalidation_endpoints' | 'endpoint_disabled' | 'endpoint_missing_secret' | 'endpoint_missing_events'>;
+        message: string;
+    }>;
+    actions: SdkDeploymentHealthAction[];
+} | {
+    tag: 'attention_needed';
+    status: 'attention_needed';
+    message: string;
+    issues: Array<{
+        code: Extract<SdkDeploymentHealthIssueCode, 'recent_delivery_failed' | 'failure_count_nonzero' | 'secret_rotated_without_success'>;
+        message: string;
+    }>;
+    actions: SdkDeploymentHealthAction[];
+} | {
+    tag: 'healthy';
+    status: 'healthy';
+    message: string;
+    issues: [];
+    actions: SdkDeploymentHealthAction[];
+} | {
+    tag: 'unknown';
+    status: 'unknown';
+    message: string;
+    issues: Array<{
+        code: Extract<SdkDeploymentHealthIssueCode, 'no_delivery_evidence'>;
+        message: string;
+    }>;
+    actions: SdkDeploymentHealthAction[];
+};
+export type SdkDeploymentHealthResponse = {
+    visible: boolean;
+    canonicalWebhookName: string;
+    canonicalEvents: readonly string[];
+    endpoint: WebhookEndpointRecord | null;
+    duplicateEndpoints: WebhookEndpointRecord[];
+    recentDeliveries: SdkDeploymentSafeDeliverySummary[];
+    health: SdkDeploymentHealthState;
+};
+export type SetupSdkDeploymentRevalidationWebhookRequest = SetupSdkRevalidationWebhookRequest;
+export type SetupSdkDeploymentRevalidationWebhookResponse = SetupSdkRevalidationWebhookResponse;
 export type ApiKeyType = "content" | "preview" | "management";
 export type ApiKeyRecord = {
     id: string;
@@ -336,3 +459,4 @@ export type ImportBackupAsNewSiteResponse = {
     error?: string;
     code?: string;
 };
+export {};

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

@@ -12,6 +12,7 @@ import type { LinkPayload, RoutableContentItem, SitemapRouteItem } from "./navig
 import type { RouteMetadataPayload, RouteMetadataResponse } from "./routes";
 import type { SiteAnalyticsSettingsPayload, SiteAnalyticsSettingsResponse } from "./siteAnalytics";
 import type { SiteBannerSettingsPayload, SiteBannerSettingsResponse } from "./siteBanner";
+import type { GeneratedIconSetApplyRequest, GeneratedIconSetApplyResponse, GeneratedIconSetGenerateRequest, GeneratedIconSetGenerateResponse, SiteIconStyleGuideResponse, SiteIconStyleGuideUpdateRequest } from "./siteIcons";
 import type { AiBrandGuidelinesGenerateRequest, AiBrandGuidelinesGenerateResponse, AiBrandGuidelinesGenerationContextResponse, SiteAiBrandGuidelinesPayload, SiteAiBrandGuidelinesResponse, SiteAiProfilePayload, SiteAiProfileResponse, SiteGenerationIntakePayload, SiteGenerationIntakeResponse } from "./siteOnboarding";
 import type { SitePrivacySettingsPayload, SitePrivacySettingsResponse } from "./privacyPolicy";
 import type { MaintenanceSettingsPayload, MaintenanceSettingsResponse, SiteBusinessAddressPayload, SiteBusinessAddressResponse, SiteFooterBlocksEditorResponse, SiteGeneralSettingsPayload, SiteGeneralSettingsResponse, SiteLayoutSettingsPayload, SiteLayoutSettingsResponse, UpdateSiteDeploymentModePayload, UpdateSiteDeploymentModeResponse, UpdateSiteFooterBlocksPayload, UpdateSiteFooterBlocksResponse } from "./siteSettings";
@@ -492,6 +493,21 @@ export type SiteManagementAPIEndpoints = {
     updateSiteAiBrandGuidelines: APIEndpoint<SiteAiBrandGuidelinesPayload, {
         siteId: string;
     }, SiteAiBrandGuidelinesResponse>;
+    getSiteIconStyleGuide: APIEndpoint<never, {
+        siteId: string;
+    }, SiteIconStyleGuideResponse>;
+    updateSiteIconStyleGuide: APIEndpoint<SiteIconStyleGuideUpdateRequest, {
+        siteId: string;
+    }, SiteIconStyleGuideResponse>;
+    regenerateSiteIconStyleGuide: APIEndpoint<never, {
+        siteId: string;
+    }, SiteIconStyleGuideResponse>;
+    generateGeneratedIconSet: APIEndpoint<GeneratedIconSetGenerateRequest, {
+        siteId: string;
+    }, GeneratedIconSetGenerateResponse>;
+    applyGeneratedIconSet: APIEndpoint<GeneratedIconSetApplyRequest, {
+        siteId: string;
+    }, GeneratedIconSetApplyResponse>;
     getSiteAiProfile: APIEndpoint<never, {
         siteId: string;
     }, SiteAiProfileResponse>;

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

@@ -1,4 +1,5 @@
 import type { Theme } from "../../blocks/src/index";
+import type { LogoFacts } from "../../theme-core/src/site-styles/index";
 import { z } from "zod";
 import type { AiGenerateSiteEntityType, AiGenerateSitePrimaryCta, AiGenerateSiteRequest } from "./siteGeneration";
 import type { BookingVerticalConfig } from "./bookingConfig";
@@ -91,11 +92,21 @@ export type MacadamiaOnboardingMappedPalette = {
     palette: Record<"primary" | "secondary" | "accent" | "background" | "surface" | "text", string>;
     mode: "light" | "dark";
 };
+export type MacadamiaOnboardingLogoPaletteRecommendation = {
+    title: string;
+    palette: MacadamiaOnboardingMappedPalette["palette"];
+};
+export type MacadamiaOnboardingLogoAnalysis = {
+    logoFacts: LogoFacts;
+    recommendedPalettes: MacadamiaOnboardingLogoPaletteRecommendation[];
+    ignoredColors: string[];
+};
 export type MacadamiaOnboardingVisualIdentity = {
     logoPath: string | null;
     logoUrl: string | null;
     logoPalette: string[] | null;
     logoMappedPalette: MacadamiaOnboardingMappedPalette | null;
+    logoAnalysis: MacadamiaOnboardingLogoAnalysis | null;
     primaryColor: string | null;
     secondaryColors: string[];
     selectedPaletteKey: string | null;
@@ -412,6 +423,7 @@ export type PublicOnboardingLogoUploadResponse = {
     path: string;
     publicUrl: string | null;
     palette: string[];
+    logoAnalysis: MacadamiaOnboardingLogoAnalysis | null;
 };
 export type PublicOnboardingAttemptStatus = "draft" | "claimed" | "provisioning" | "provisioned" | "completed" | "cancelled";
 export type PublicOnboardingProvisioningStage = "starting" | "site_setup" | "copy_generation" | "media_generation" | "page_creation" | "surface_setup" | "theme_setup" | "preview_ready";
@@ -482,6 +494,7 @@ export type SiteWizardResumeSnapshot = {
         palette: Record<"primary" | "secondary" | "accent" | "background" | "surface" | "text", string>;
         mode: "light" | "dark";
     } | null;
+    logoAnalysis?: MacadamiaOnboardingLogoAnalysis | null;
     goalSuggestions?: AiSiteWizardSuggestGoalsResponse | null;
     goalSuggestionsInputKey?: string | null;
 };

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

@@ -5,7 +5,7 @@ import type { MutableCourseStatus } from "./courses";
 import type { ListCustomBlocksResponse, CreateCustomBlockRequest, CreateCustomBlockResponse, DeleteCustomBlockResponse, GetCustomBlockResponse, SdkWorkflowRunStatusCallbackRequest, SdkWorkflowRunStatusCallbackResponse, UpdateCustomBlockRequest, UpdateCustomBlockResponse } from "./contentRuntime";
 import type { ContentTypeRecord, CreateContentTypeRequest, CreateContentTypeResponse, DeleteContentTypeResponse, DuplicateContentTypeResponse, ListContentTypesResponse, UpdateContentTypeRequest, UpdateContentTypeResponse } from "./contentTypes";
 import type { CheckRedirectQuery, CheckRedirectResponse, CreateRedirectRuleRequest, CreateRedirectRuleResponse, DeleteRedirectRuleResponse, ListRedirectRulesResponse } from "./redirects";
-import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSiteApiKeyRequest, CreateSiteApiKeyResponse, CreateSitePreviewKeyResponse, CreateWebhookRequest, CreateWebhookResponse, DeleteBackupUploadRequest, DeleteBackupUploadResponse, DeleteWebhookResponse, GetSiteApiKeyAccessLogsResponse, GetSitePreviewKeyResponse, GetWebhookResponse, ImportBackupAsNewSiteRequest, ImportBackupAsNewSiteResponse, ImportSiteBackupRequest, ListManagementKeysResponse, ListSiteApiKeysResponse, ListWebhooksResponse, RevokeManagementKeyRequest, RevokeManagementKeyResponse, RevokeSiteApiKeyResponse, UpdateWebhookRequest, UpdateWebhookResponse, BackupImportResponse, BackupPreviewRequest, BackupPreviewResponse, CreateBackupUploadUrlRequest, CreateBackupUploadUrlResponse } from "./siteInfrastructure";
+import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSiteApiKeyRequest, CreateSiteApiKeyResponse, CreateSitePreviewKeyResponse, CreateWebhookRequest, CreateWebhookResponse, DeleteBackupUploadRequest, DeleteBackupUploadResponse, DeleteWebhookResponse, GetSiteApiKeyAccessLogsResponse, GetSitePreviewKeyResponse, GetWebhookResponse, ImportBackupAsNewSiteRequest, ImportBackupAsNewSiteResponse, ImportSiteBackupRequest, ListManagementKeysResponse, ListSiteApiKeysResponse, ListWebhooksResponse, RevokeManagementKeyRequest, RevokeManagementKeyResponse, RevokeSiteApiKeyResponse, SdkDeploymentHealthResponse, SetupSdkDeploymentRevalidationWebhookRequest, SetupSdkDeploymentRevalidationWebhookResponse, SetupSdkRevalidationWebhookRequest, SetupSdkRevalidationWebhookResponse, UpdateWebhookRequest, UpdateWebhookResponse, BackupImportResponse, BackupPreviewRequest, BackupPreviewResponse, CreateBackupUploadUrlRequest, CreateBackupUploadUrlResponse } from "./siteInfrastructure";
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from "./siteGeneration";
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from "./siteOperations";
 import type { ApplySiteStyleSelectionBody, ApplySiteStyleSelectionResponse } from "./siteRuntimeEndpoints";
@@ -49,6 +49,12 @@ export type SitePlatformAPIEndpoints = {
         siteId: string;
         webhookId: string;
     }, DeleteWebhookResponse>;
+    getSdkDeploymentHealth: APIEndpoint<never, {
+        siteId: string;
+    }, SdkDeploymentHealthResponse>;
+    setupSdkDeploymentRevalidationWebhook: APIEndpoint<SetupSdkDeploymentRevalidationWebhookRequest, {
+        siteId: string;
+    }, SetupSdkDeploymentRevalidationWebhookResponse>;
     listSiteApiKeys: APIEndpoint<never, {
         siteId: string;
     }, ListSiteApiKeysResponse>;
@@ -258,6 +264,7 @@ export type SitePlatformAPIEndpoints = {
         reordered: true;
     }>;
     sdkUpsertNavigationMenu: APIEndpoint<{
+        identifier?: string;
         name: string;
         isPrimary?: boolean;
         isFooter?: boolean;
@@ -270,6 +277,12 @@ export type SitePlatformAPIEndpoints = {
     }, {
         siteId: string;
     }, SdkUpsertNavigationMenuResponse>;
+    sdkDeleteNavigationMenu: APIEndpoint<never, {
+        siteId: string;
+        menuId: string;
+    }, {
+        deleted: true;
+    }>;
     sdkUpsertTheme: APIEndpoint<{
         theme: Theme;
         themeId?: string;
@@ -463,6 +476,9 @@ export type SitePlatformAPIEndpoints = {
     }, {
         siteId: string;
     }, SdkUpdateSettingsResponse>;
+    sdkSetupRevalidationWebhook: APIEndpoint<SetupSdkRevalidationWebhookRequest, {
+        siteId: string;
+    }, SetupSdkRevalidationWebhookResponse>;
     listSiteContentTypes: APIEndpoint<never, {
         siteId: string;
     }, ListContentTypesResponse>;

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

@@ -1,4 +1,4 @@
-import type { SystemCustomizeFacetSelection, Theme } from '../../blocks/src/index';
+import type { BackgroundOverride, SystemCustomizeFacetSelection, Theme } from '../../blocks/src/index';
 import type { ListMediaAssetsResult, MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
 import type { DbJson } from '../../db/src/index';
 import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId, LayoutVariantKey, SiteStyleId, TypographyPresetId } from '../../theme-core/src/site-styles/index';
@@ -117,6 +117,11 @@ export type PageDesignEditorAction = {
     blockId: DesignBlockId;
     baseContentId: string | null;
 } & SystemCustomizeFacetSelection) | {
+    kind: 'set-background';
+    blockId: DesignBlockId;
+    baseContentId: string | null;
+    override: BackgroundOverride;
+} | {
     kind: 'set-look';
     blockId: DesignBlockId;
     appearancePresetId: AppearancePresetId | null;

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

@@ -1,6 +1,6 @@
 import type { CamelizeKeys, DbDatabase, DbRow } from "../../db/src/index";
 import type { APIEndpoint } from "./apiEndpointTypes";
-export type { AccessPolicyContract, AccessPolicyTag, CreateMediaAssetBody, EntitledCustomerAccessScopeContract, FileKindContract, FileKindTag, FileUseContract, FileUseTag, ImageFileFormat, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteAssetFailure, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse, RenderableFileKindTag, StorageClass, UploadIntentContract, UploadIntentTag, } from "./media";
+export type { AccessPolicyContract, AccessPolicyTag, AmbientBackgroundRole, CreateMediaAssetBody, EntitledCustomerAccessScopeContract, FileKindContract, FileKindTag, FileUseContract, FileUseTag, ImageFileFormat, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteAssetFailure, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse, RenderableFileKindTag, SiteBackgroundAssetUse, StorageClass, UploadIntentContract, UploadIntentTag, } from "./media";
 export type { AnalyticsPreset, AnalyticsReferrer, AnalyticsReportFilters, AnalyticsReportQuery, AnalyticsReportResponse, AnalyticsSeriesPoint, AnalyticsTopPage, AnalyticsTotals, } from "./analytics";
 export type { AIChatMessage, AiBriefTurn, JsonPrimitive, JsonValue, MediaUsageCheckItem, MediaUsageCheckResponse, MediaUsageLocation, } from "./shared-contracts";
 export type * from "./accessAdmin";