@riverbankcms/sdk 0.78.0 → 0.79.0

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";
@@ -134,6 +135,16 @@ export type SiteManagementAPIEndpoints = {
         entries: ContentEntrySummary[];
         contentType: SerializedContentTypeSummary;
     }>;
+    reorderContentEntries: APIEndpoint<{
+        orderedEntryIds: string[];
+        orderToken: string;
+    }, {
+        siteId: string;
+        type: string;
+    }, {
+        entries: ContentEntrySummary[];
+        orderToken: string;
+    }>;
     getContentTemplate: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -482,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/sitePlatformEndpoints.d.ts

@@ -258,6 +258,7 @@ export type SitePlatformAPIEndpoints = {
         reordered: true;
     }>;
     sdkUpsertNavigationMenu: APIEndpoint<{
+        identifier?: string;
         name: string;
         isPrimary?: boolean;
         isFooter?: boolean;
@@ -270,6 +271,12 @@ export type SitePlatformAPIEndpoints = {
     }, {
         siteId: string;
     }, SdkUpsertNavigationMenuResponse>;
+    sdkDeleteNavigationMenu: APIEndpoint<never, {
+        siteId: string;
+        menuId: string;
+    }, {
+        deleted: true;
+    }>;
     sdkUpsertTheme: APIEndpoint<{
         theme: Theme;
         themeId?: string;
@@ -423,6 +430,7 @@ export type SitePlatformAPIEndpoints = {
         contentType: string;
         data: Record<string, unknown>;
         slug?: string;
+        manualOrder?: number;
     }, {
         siteId: string;
     }, SdkUpsertEntryResponse>;

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

@@ -1,11 +1,11 @@
-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';
 import type { ButtonPersonalityId } from '../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../theme-core/src/palette/index';
 import type { APIEndpoint } from './apiEndpointTypes';
-import type { AnalyticsReportFilters, AnalyticsReportResponse } from './analytics';
+import type { AnalyticsReportQuery, AnalyticsReportResponse } from './analytics';
 import type { CreateMediaAssetBody, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
 import type { MediaUsageCheckResponse } from './shared-contracts';
 import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkTemplate, SiteBySlugResponse, ThemeGenerationTurn, ThemePreferencesRecord, ThemeRow } from './contentRuntime';
@@ -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;
@@ -181,7 +186,7 @@ export type SiteRuntimeAPIEndpoints = {
         type: string;
         limit?: string;
         offset?: string;
-        order?: 'published_at.asc' | 'published_at.desc' | 'title.asc' | 'title.desc' | 'updated_at.asc' | 'updated_at.desc';
+        order?: 'published_at.asc' | 'published_at.desc' | 'title.asc' | 'title.desc' | 'manual.asc' | 'updated_at.asc' | 'updated_at.desc';
         stage?: ContentEntryListStage;
         meta?: string;
         mode?: 'manual';
@@ -337,26 +342,24 @@ export type SiteRuntimeAPIEndpoints = {
         }>;
     }>;
     createInstagramZipUploadUrl: APIEndpoint<CreateInstagramZipUploadUrlRequest, never, CreateInstagramZipUploadUrlResponse>;
-    getAnalyticsReport: APIEndpoint<AnalyticsReportFilters, {
-        siteId: string;
-    } & AnalyticsReportFilters, AnalyticsReportResponse>;
+    getAnalyticsReport: APIEndpoint<never, AnalyticsReportQuery, AnalyticsReportResponse>;
     createMediaAsset: APIEndpoint<CreateMediaAssetBody, undefined, MediaAssetResponse>;
-    mediaList: APIEndpoint<{
+    mediaList: APIEndpoint<never, {
         siteId: string;
         q?: string;
         limit?: number;
         offset?: number;
         labels?: string;
         fileFilter?: MediaAssetFileFilterContract;
-    }, never, ListMediaAssetsResult>;
-    mediaProductFileList: APIEndpoint<{
+    }, ListMediaAssetsResult>;
+    mediaProductFileList: APIEndpoint<never, {
         siteId: string;
         q?: string;
         limit?: number;
         offset?: number;
         labels?: string;
         fileFilter?: MediaAssetFileFilterContract;
-    }, never, ListMediaAssetsResult>;
+    }, ListMediaAssetsResult>;
     mediaGet: APIEndpoint<never, {
         assetId: string;
     }, MediaAssetWithLabels>;
@@ -544,17 +547,15 @@ export type SiteRuntimeAPIEndpoints = {
         siteId: string;
         pageId: string;
     }, ApplyPageDesignEditorActionResponse>;
-    getContentByPath: APIEndpoint<{
+    getContentByPath: APIEndpoint<never, {
+        siteId: string;
         path: string;
         preview?: boolean;
-    }, {
-        siteId: string;
     }, SdkRuntimeContentByPathResponse>;
-    getPageByPath: APIEndpoint<{
+    getPageByPath: APIEndpoint<never, {
+        siteId: string;
         path: string;
         preview?: boolean;
-    }, {
-        siteId: string;
     }, SdkRuntimeContentByPathResponse>;
     initSiteContent: APIEndpoint<{}, {
         siteId: string;
@@ -563,9 +564,9 @@ export type SiteRuntimeAPIEndpoints = {
         created: number;
         totalBlocks: number;
     }>;
-    getMediaLabels: APIEndpoint<{
+    getMediaLabels: APIEndpoint<never, {
         siteId: string;
-    }, never, {
+    }, {
         items: MediaLabelSummary[];
     }>;
     getMediaSettings: APIEndpoint<never, {
@@ -643,11 +644,11 @@ export type SiteRuntimeAPIEndpoints = {
             summary?: MediaJobSummaryResponse;
         }>;
     }>;
-    mediaJobsStatus: APIEndpoint<{
+    mediaJobsStatus: APIEndpoint<never, {
         siteId: string;
         limit?: number;
         statuses?: string;
-    }, never, {
+    }, {
         jobs: MediaClassifyJobResponse[];
     }>;
     devToolsImpersonateAdmin: APIEndpoint<undefined, never, DevToolsImpersonationResponse>;

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

@@ -1,5 +1,6 @@
 import type { CamelizeKeys, DbDatabase, DbRow } from "../../db/src/index";
-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";
+import type { APIEndpoint } from "./apiEndpointTypes";
+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";
@@ -121,48 +122,32 @@ type EndpointPath<E extends keyof APIEndpoints> = E extends keyof typeof API_END
 type PathParams<E extends keyof APIEndpoints> = ExtractPathParamNames<EndpointPath<E>> extends infer TParam ? [TParam] extends [never] ? {} : {
     [K in Extract<TParam, string>]: string;
 } : {};
-type QueryParams<E extends keyof APIEndpoints> = IsNonEmptyQuery<APIEndpoints[E]["query"]> extends false ? {} : QueryToStringParams<APIEndpoints[E]["query"]>;
+type EndpointQuery<E extends keyof APIEndpoints> = APIEndpoints[E] extends APIEndpoint<unknown, infer TQuery, unknown> ? TQuery : never;
+type QueryParams<E extends keyof APIEndpoints> = IsNonEmptyQuery<EndpointQuery<E>> extends false ? {} : QueryToStringParams<EndpointQuery<E>>;
 type HasPathParams<E extends keyof APIEndpoints> = keyof PathParams<E> extends never ? false : true;
 type ParamsPart<E extends keyof APIEndpoints> = HasPathParams<E> extends true ? {
     params: PathParams<E> & QueryParams<E>;
-} : IsNonEmptyQuery<APIEndpoints[E]["query"]> extends false ? {
+} : IsNonEmptyQuery<EndpointQuery<E>> extends false ? {
     params?: Record<string, string>;
-} : HasRequiredKeys<APIEndpoints[E]["query"]> extends true ? {
+} : HasRequiredKeys<EndpointQuery<E>> extends true ? {
     params: QueryParams<E>;
 } : {
     params?: QueryParams<E>;
 };
-export type APICallParams<E extends keyof APIEndpoints> = APIEndpoints[E] extends {
-    method: "GET";
-} ? {
-    endpoint: E;
-    body?: APIEndpoints[E]["body"];
-    options?: RequestInit;
-} & ParamsPart<E> : APIEndpoints[E] extends {
-    method: "POST" | "PUT" | "PATCH";
-} ? {
-    endpoint: E;
-    body: APIEndpoints[E]["body"];
-    options?: RequestInit;
-} & ParamsPart<E> : {
-    endpoint: E;
-    body?: APIEndpoints[E]["body"];
-    options?: RequestInit;
-} & ParamsPart<E>;
 type EndpointMethod<E extends keyof APIEndpoints> = E extends keyof typeof API_ENDPOINTS ? (typeof API_ENDPOINTS)[E]["method"] : HTTPMethod;
-type EndpointBody<E extends keyof APIEndpoints> = APIEndpoints[E]["body"];
+type EndpointBody<E extends keyof APIEndpoints> = APIEndpoints[E] extends APIEndpoint<infer TBody, unknown, unknown> ? TBody : never;
 type StrictBodyPart<E extends keyof APIEndpoints> = EndpointMethod<E> extends "GET" ? {
     body?: never;
 } : [EndpointBody<E>] extends [never | undefined] ? {
     body?: never;
+} : undefined extends EndpointBody<E> ? {
+    body?: Exclude<EndpointBody<E>, undefined>;
 } : {
-    body: NonNullable<EndpointBody<E>>;
+    body: EndpointBody<E>;
 };
 /**
- * Strict variant of APICallParams that uses endpoint metadata (method + body type)
- * to enforce whether `body` is required/forbidden.
- *
- * Intended for new code. Existing code can continue using APICallParams until migrated.
+ * API call parameters derived from endpoint metadata.
+ * Enforces whether `body` is required, optional, or forbidden for each endpoint.
  */
 export type APICallParamsStrict<E extends keyof APIEndpoints> = {
     endpoint: E;

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

@@ -0,0 +1,239 @@
+import { z } from 'zod';
+export declare const RIVERBANK_SIGNATURE_PREFIX = "sha256=";
+export declare const SUPPORTED_WEBHOOK_EVENTS: readonly ["page.published", "page.unpublished", "page.deleted", "page.path_changed", "entry.published", "entry.unpublished", "entry.deleted", "entry.path_changed", "navigation.updated", "theme.updated", "site.settings_updated"];
+export type WebhookEvent = (typeof SUPPORTED_WEBHOOK_EVENTS)[number];
+export declare const WebhookEventSchema: z.ZodEnum<{
+    "page.published": "page.published";
+    "page.unpublished": "page.unpublished";
+    "page.deleted": "page.deleted";
+    "page.path_changed": "page.path_changed";
+    "entry.published": "entry.published";
+    "entry.unpublished": "entry.unpublished";
+    "entry.deleted": "entry.deleted";
+    "entry.path_changed": "entry.path_changed";
+    "navigation.updated": "navigation.updated";
+    "theme.updated": "theme.updated";
+    "site.settings_updated": "site.settings_updated";
+}>;
+declare const revalidationPathBrand: unique symbol;
+export type RevalidationPath = string & {
+    readonly [revalidationPathBrand]: 'RevalidationPath';
+};
+export type RevalidationPathParseError = Readonly<{
+    tag: 'EMPTY_PATH';
+    input: string;
+}> | Readonly<{
+    tag: 'ABSOLUTE_OR_PROTOCOL_PATH';
+    input: string;
+}> | Readonly<{
+    tag: 'MALFORMED_PATH';
+    input: string;
+}>;
+export type RevalidationPathParseResult = Readonly<{
+    success: true;
+    path: RevalidationPath;
+}> | Readonly<{
+    success: false;
+    error: RevalidationPathParseError;
+}>;
+export declare function parseRevalidationPath(input: string): RevalidationPathParseResult;
+export declare function normalizeRevalidationPath(input: string): RevalidationPath | null;
+export declare function unwrapRevalidationPath(path: RevalidationPath): string;
+export declare const PagePublishedDataSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    path: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const PageRemovedDataSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    path: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const PagePathChangedDataSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    previousPath: z.ZodString;
+    path: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const EntryPublishedDataSchema: z.ZodObject<{
+    entryId: z.ZodString;
+    path: z.ZodString;
+    contentType: z.ZodString;
+}, z.core.$strict>;
+export declare const EntryRemovedDataSchema: z.ZodObject<{
+    entryId: z.ZodString;
+    path: z.ZodString;
+    contentType: z.ZodString;
+}, z.core.$strict>;
+export declare const EntryPathChangedDataSchema: z.ZodObject<{
+    entryId: z.ZodString;
+    previousPath: z.ZodString;
+    path: z.ZodString;
+    contentType: z.ZodString;
+}, z.core.$strict>;
+export declare const NavigationUpdatedDataSchema: z.ZodObject<{
+    menuId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const EmptyWebhookDataSchema: z.ZodObject<{}, z.core.$strict>;
+export type PagePublishedData = z.infer<typeof PagePublishedDataSchema>;
+export type PageRemovedData = z.infer<typeof PageRemovedDataSchema>;
+export type PagePathChangedData = z.infer<typeof PagePathChangedDataSchema>;
+export type EntryPublishedData = z.infer<typeof EntryPublishedDataSchema>;
+export type EntryRemovedData = z.infer<typeof EntryRemovedDataSchema>;
+export type EntryPathChangedData = z.infer<typeof EntryPathChangedDataSchema>;
+export type NavigationUpdatedData = z.infer<typeof NavigationUpdatedDataSchema>;
+export type EmptyWebhookData = z.infer<typeof EmptyWebhookDataSchema>;
+export type WebhookDataByEvent = Readonly<{
+    'page.published': PagePublishedData;
+    'page.unpublished': PageRemovedData;
+    'page.deleted': PageRemovedData;
+    'page.path_changed': PagePathChangedData;
+    'entry.published': EntryPublishedData;
+    'entry.unpublished': EntryRemovedData;
+    'entry.deleted': EntryRemovedData;
+    'entry.path_changed': EntryPathChangedData;
+    'navigation.updated': NavigationUpdatedData;
+    'theme.updated': EmptyWebhookData;
+    'site.settings_updated': EmptyWebhookData;
+}>;
+export type WebhookDataForEvent<E extends WebhookEvent> = WebhookDataByEvent[E];
+export declare const WebhookPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"page.published">;
+    data: z.ZodObject<{
+        pageId: z.ZodString;
+        path: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"page.unpublished">;
+    data: z.ZodObject<{
+        pageId: z.ZodString;
+        path: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"page.deleted">;
+    data: z.ZodObject<{
+        pageId: z.ZodString;
+        path: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"page.path_changed">;
+    data: z.ZodObject<{
+        pageId: z.ZodString;
+        previousPath: z.ZodString;
+        path: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"entry.published">;
+    data: z.ZodObject<{
+        entryId: z.ZodString;
+        path: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"entry.unpublished">;
+    data: z.ZodObject<{
+        entryId: z.ZodString;
+        path: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"entry.deleted">;
+    data: z.ZodObject<{
+        entryId: z.ZodString;
+        path: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"entry.path_changed">;
+    data: z.ZodObject<{
+        entryId: z.ZodString;
+        previousPath: z.ZodString;
+        path: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"navigation.updated">;
+    data: z.ZodObject<{
+        menuId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"theme.updated">;
+    data: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    timestamp: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    siteId: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    event: z.ZodLiteral<"site.settings_updated">;
+    data: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strip>], "event">;
+export type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
+export type WebhookPayloadForEvent<E extends WebhookEvent> = Extract<WebhookPayload, {
+    event: E;
+}>;
+export type WebhookDispatchInputForEvent<E extends WebhookEvent> = Readonly<{
+    siteId: string;
+    event: E;
+    data: WebhookDataForEvent<E>;
+    tags: readonly string[];
+    paths?: readonly RevalidationPath[];
+}>;
+export type WebhookDispatchInput = {
+    [E in WebhookEvent]: WebhookDispatchInputForEvent<E>;
+}[WebhookEvent];
+export {};

package/dist/_dts/block-form/src/fields/types.d.ts

@@ -170,6 +170,12 @@ export type RepeaterFieldConfig = BaseFieldConfig & ({
      * Useful for complex constraints that aren't expressible via field-level config.
      */
     validation?: ZodTypeAny;
+    /** Whether compact row summaries should be rendered. Defaults to true. */
+    showSummary?: boolean;
+    /** Optional ordered field IDs to use for compact row summaries. */
+    summaryFields?: string[];
+    /** Optional positive max character count for compact row summaries. */
+    summaryMaxChars?: number;
 } & ({
     type: 'repeater';
     itemLabel?: string;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterList.d.ts

@@ -1,7 +1,7 @@
 /**
  * Repeater list - DnD context wrapper for sortable items
  */
-import type { ReactNode } from 'react';
+import { type ReactNode, type RefObject } from 'react';
 import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
 export interface RepeaterListProps {
@@ -15,5 +15,6 @@ export interface RepeaterListProps {
     onMove: (from: number, to: number) => void;
     onRemove: (index: number) => void;
     renderChild: (field: FieldConfig, path: string) => ReactNode;
+    focusFallbackRef?: RefObject<HTMLButtonElement | null>;
 }
-export declare function RepeaterList({ config, backend, basePath, items, minItems, onMove, onRemove, renderChild, }: RepeaterListProps): ReactNode;
+export declare function RepeaterList({ config, backend, basePath, items, minItems, onMove, onRemove, renderChild, focusFallbackRef, }: RepeaterListProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterRow.d.ts

@@ -4,9 +4,10 @@
  *
  * Routes non-content item fields into a settings modal in the row header.
  */
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+import type { RepeaterRowActionFocusTarget } from './RepeaterRowActions';
 export interface RepeaterRowProps {
     id: string;
     index: number;
@@ -15,9 +16,11 @@ export interface RepeaterRowProps {
     basePath: string;
     itemsLength: number;
     minItems: number;
-    onMove: (from: number, to: number) => void;
+    containerWidth: number;
+    onMove: (from: number, to: number, focusTarget: RepeaterRowActionFocusTarget) => void;
     onRemove: (index: number) => void;
     renderChild: (field: FieldConfig, path: string) => ReactNode;
     canDrag: boolean;
+    actionControlRefs?: Partial<Record<RepeaterRowActionFocusTarget, Ref<HTMLButtonElement>>>;
 }
-export declare function RepeaterRow({ id, index, config, backend, basePath, itemsLength, minItems, onMove, onRemove, renderChild, canDrag, }: RepeaterRowProps): ReactNode;
+export declare function RepeaterRow({ id, index, config, backend, basePath, itemsLength, minItems, containerWidth, onMove, onRemove, renderChild, canDrag, actionControlRefs, }: RepeaterRowProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterRowActions.d.ts

@@ -1,16 +1,21 @@
 /**
- * Repeater row action buttons - move up/down, delete
+ * Repeater row action controls - direct reorder buttons plus compact menu.
  */
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 export interface RepeaterRowActionsProps {
     index: number;
     itemsLength: number;
     minItems: number;
+    containerWidth?: number;
+    actionPresentation?: 'auto' | 'wide' | 'compact';
+    itemLabel: string;
     onMoveUp: () => void;
     onMoveDown: () => void;
     onRemove: () => void;
+    actionControlRefs?: Partial<Record<RepeaterRowActionFocusTarget, Ref<HTMLButtonElement>>>;
     showReorderActions?: boolean;
     disableMoveUp?: boolean;
     disableMoveDown?: boolean;
 }
-export declare function RepeaterRowActions({ index, itemsLength, minItems, onMoveUp, onMoveDown, onRemove, showReorderActions, disableMoveUp, disableMoveDown, }: RepeaterRowActionsProps): ReactNode;
+export type RepeaterRowActionFocusTarget = 'moveEarlier' | 'moveLater' | 'menu';
+export declare function RepeaterRowActions({ index, itemsLength, minItems, containerWidth, actionPresentation, itemLabel, onMoveUp, onMoveDown, onRemove, actionControlRefs, showReorderActions, disableMoveUp, disableMoveDown, }: RepeaterRowActionsProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/index.d.ts

@@ -1,6 +1,6 @@
 export { useRepeaterVisibility } from './useRepeaterVisibility';
 export { useRepeaterRowErrors, type RowFieldError } from './useRepeaterRowErrors';
-export { useResolvedItemLabel } from './useResolvedItemLabel';
+export { useResolvedItemLabel, useResolvedRepeaterItemLabel, type ResolvedRepeaterItemLabel, } from './useResolvedItemLabel';
 export { useLayoutGridCapacity } from './useLayoutGridCapacity';
 export { useLinearRepeaterDnd, type LinearRepeaterSortingStrategyKind } from './useLinearRepeaterDnd';
 export { useRepeaterPointerDragCapability } from './useRepeaterPointerDragCapability';

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useLinearRepeaterDnd.d.ts

@@ -10,6 +10,7 @@ interface UseLinearRepeaterDndInput {
 }
 export interface UseLinearRepeaterDndResult {
     containerRef: ReturnType<typeof useRepeaterPointerDragCapability>['containerRef'];
+    containerWidth: ReturnType<typeof useRepeaterPointerDragCapability>['containerWidth'];
     breakpoint: ReturnType<typeof useRepeaterPointerDragCapability>['breakpoint'];
     pointerDragCapability: ReturnType<typeof useRepeaterPointerDragCapability>['pointerDragCapability'];
     canUsePointerDrag: boolean;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useRepeaterPointerDragCapability.d.ts

@@ -3,6 +3,7 @@ import { resolveRepeaterGridBreakpointForWidth } from '../../../../../blocks/src
 import { type RepeaterPointerDragCapability } from '../utils';
 export interface UseRepeaterPointerDragCapabilityResult {
     containerRef: RefObject<HTMLDivElement | null>;
+    containerWidth: number;
     breakpoint: ReturnType<typeof resolveRepeaterGridBreakpointForWidth>;
     pointerDragCapability: RepeaterPointerDragCapability;
     canUsePointerDrag: boolean;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useResolvedItemLabel.d.ts

@@ -1,5 +1,11 @@
 import type { RepeaterFieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+import { type RepeaterLabelSource } from '../utils';
+export type ResolvedRepeaterItemLabel = {
+    label: string;
+    sourceFieldId?: string;
+    labelSource: RepeaterLabelSource;
+};
 /**
  * Resolves a display label for a repeater item.
  *
@@ -10,3 +16,4 @@ import type { FormBackend } from '../../../backend/types';
  * is returned.
  */
 export declare function useResolvedItemLabel(config: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;
+export declare function useResolvedRepeaterItemLabel(config: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): ResolvedRepeaterItemLabel;

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/buildSummary.d.ts

@@ -4,4 +4,5 @@
  */
 import type { RepeaterFieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+export declare const DEFAULT_REPEATER_SUMMARY_MAX_CHARS = 96;
 export declare function buildSummary(field: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/index.d.ts

@@ -1,8 +1,10 @@
 export { createDefaultItem } from './createDefaultItem';
 export { buildItemLabel } from './buildItemLabel';
-export { buildSummary } from './buildSummary';
+export { buildSummary, DEFAULT_REPEATER_SUMMARY_MAX_CHARS, } from './buildSummary';
 export { getRepeaterItemFields } from './getRepeaterItemFields';
 export { getRepeaterItemFieldGroups } from './getRepeaterItemFieldGroups';
+export { resolveRepeaterLabelSource, type RepeaterLabelSource, } from './repeaterLabelSource';
+export { REPEATER_ROW_COMPACT_ACTIONS_WIDTH, isRepeaterRowActionDisabled, resolveRepeaterRowActionRenderPlan, type RepeaterRowActionAvailability, type RepeaterRowActionId, type RepeaterRowActionMenu, type RepeaterRowMenuAction, type RepeaterRowActionPresentation, type RepeaterRowActionRenderPlan, } from './repeaterRowActionsDomain';
 export { areLayoutGridCapacityContextsEqual } from './layoutGridCapacityContext';
 export { handleLinearRepeaterDragEnd, resolveLinearRepeaterMoveIntent, resolveRepeaterPointerDragCapability, type LinearRepeaterDragEndEvent, type LinearRepeaterMoveIntent, type RepeaterPointerDragCapability, } from './repeaterDndDomain';
 export { resolveRepeaterPresentation } from './repeaterPresentation';

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/repeaterDndDomain.d.ts

@@ -5,7 +5,7 @@ export type RepeaterPointerDragCapability = {
 } | {
     kind: 'disabled';
     breakpoint: RepeaterGridBreakpoint;
-    reason: 'insufficient-items' | 'small-breakpoint' | 'coarse-pointer';
+    reason: 'insufficient-items' | 'coarse-pointer';
 };
 export type LinearRepeaterMoveIntent = {
     kind: 'none';