@riverbankcms/sdk 0.78.0 → 0.79.0

package/dist/_dts/sdk/src/cli/site-commands/commandRuntime.d.ts

@@ -68,6 +68,11 @@ export type CliCommandOutcome<TSubject> = Readonly<{
     identifier: string;
     message: string;
     subject?: TSubject;
+}> | Readonly<{
+    status: 'preflight_failed';
+    identifier: string;
+    message: string;
+    subject?: TSubject;
 }>;
 export type CliCommandExecutionReport<TSubject> = Readonly<{
     outcomes: readonly CliCommandOutcome<TSubject>[];

package/dist/_dts/sdk/src/cli/site-commands/commandSurfaceDispatch.d.ts

@@ -19,9 +19,13 @@ export type CommandSurfaceDispatchInput = Readonly<{
 }>;
 export type CommandSurfaceDispatchDependencies = Readonly<{
     compileCommandSurface?: (surface: CommandSurface, input: CommandSurfaceDispatchInput) => CommandSurfaceCompileResult;
+    preflightCommandSurfaceAsReport?: (surface: CommandSurfaceCompileSuccess, input: CommandSurfaceDispatchInput) => CommandSurfaceExecutionReport;
     executeCommandSurfaceAsReport?: (surface: CommandSurfaceCompileSuccess, input: CommandSurfaceDispatchInput) => Promise<CommandSurfaceExecutionReport>;
 }>;
 export declare function compileContentPushExecutionPlan(plan: ContentPushExecutionPlan, input: CommandSurfaceDispatchInput, dependencies?: CommandSurfaceDispatchDependencies): Result<CompiledContentPushExecutionPlan, ContentPushExecutionReport>;
+export declare function preflightContentPushExecutionPlan(steps: readonly CompiledContentPushExecutionStep[], input: CommandSurfaceDispatchInput, dependencies?: CommandSurfaceDispatchDependencies): ContentPushExecutionReport;
+export declare function contentPushExecutionReportHasFailures(report: ContentPushExecutionReport): boolean;
 export declare function executeCommandSurfaceAsReport(surface: CommandSurfaceCompileSuccess, input: CommandSurfaceDispatchInput): Promise<CommandSurfaceExecutionReport>;
+export declare function preflightCommandSurfaceAsReport(surface: CommandSurfaceCompileSuccess, input: CommandSurfaceDispatchInput): CommandSurfaceExecutionReport;
 export declare function skippedRemainingCommandReports(steps: readonly CompiledContentPushExecutionStep[]): CommandSurfaceExecutionReport[];
 export declare function commandSurfaceReportToSyncResult(report: CommandSurfaceExecutionReport): SyncResult;

package/dist/_dts/sdk/src/cli/site-commands/navigationCommands.d.ts

@@ -12,6 +12,10 @@ export type CliNavigationCommandCompileError = Readonly<{
     code: 'missing_local_navigation_menu';
     name: CliNavigationMenuName;
     message: string;
+}> | Readonly<{
+    code: 'duplicate_navigation_identity';
+    identity: string;
+    message: string;
 }> | CliCommandValidationCompileError;
 export type CliNavigationCommandCompileInput = Readonly<{
     source: CliNavigationCommandBatchSource;

package/dist/_dts/sdk/src/cli/site-commands/oneOffCommands.d.ts

@@ -47,6 +47,7 @@ export type OneOffBlockMutation = Readonly<{
 }>;
 export type OneOffNavigationMutation = Readonly<{
     kind: 'upsert';
+    identifier?: string;
     menuName: string;
     items: readonly NavigationItemInput[];
 }>;

package/dist/_dts/sdk/src/cli/site-commands/pageCommands.d.ts

@@ -53,7 +53,7 @@ export type PageCommandReportSubject = Readonly<{
     counter: BlockCommandSyncCounter;
 }>;
 export type PageCommandExecutionReport = CliCommandExecutionReport<PageCommandReportSubject>;
-type PageCommandCompiledPlan = Pick<CliPageCommandCompileSuccess, 'plan' | 'reportedCommands' | 'warnings'>;
+export type PageCommandCompiledPlan = Pick<CliPageCommandCompileSuccess, 'plan' | 'reportedCommands' | 'warnings'>;
 export declare function compilePagePushCommands(input: CliPageCommandCompileInput): Result<CliPageCommandCompileSuccess, CliPageCommandCompileError>;
 export type PageCommandRoutingDecision = Readonly<{
     kind: 'no_page_changes';
@@ -75,5 +75,8 @@ export declare function pageCommandExecutionToReport(input: Readonly<{
     execution: CliPageCommandExecutionResult;
     compiledPlan: PageCommandCompiledPlan;
 }>): PageCommandExecutionReport;
+export declare function preflightPageCommandPlanAsReport(input: Readonly<{
+    compiledPlan: PageCommandCompiledPlan;
+    blockFieldExtensions?: BlockFieldExtensionsMap;
+}>): PageCommandExecutionReport;
 export declare function pageCommandReportToSyncResult(report: PageCommandExecutionReport): SyncResult;
-export {};

package/dist/_dts/sdk/src/cli/site-commands/pushExecution.d.ts

@@ -6,7 +6,7 @@ import type { OutputContext } from '../output';
 import { type ContentDiff, type SyncResult } from '../sync';
 import { type CommandSurfaceDispatchDependencies } from './commandSurfaceDispatch';
 import { planContentPushExecution } from './pushExecutionPlan';
-import type { CommandSurface, CommandSurfaceCompileResult, CommandSurfaceCompileSuccess, CommandSurfaceExecutionReport, ContentPushScope, ContentPushExecutionPlan, ContentPushExecutionReport, ContentPushExecutionStep } from './pushExecutionTypes';
+import type { CommandSurface, CommandSurfaceCompileResult, CommandSurfaceCompileSuccess, CommandSurfaceExecutionReport, CompiledContentPushExecutionPlan, ContentPushScope, ContentPushExecutionPlan, ContentPushExecutionReport, ContentPushExecutionStep } from './pushExecutionTypes';
 import type { compilePagePushCommands } from './pageCommands';
 export { planContentPushExecution };
 export type { CommandSurface, CommandSurfaceCompileResult, CommandSurfaceCompileSuccess, CommandSurfaceExecutionReport, ContentPushScope, ContentPushExecutionPlan, ContentPushExecutionReport, ContentPushExecutionStep, };
@@ -26,4 +26,13 @@ export type ContentPushExecutionInput = Readonly<{
 }>;
 export declare function executeContentPushPlan(input: ContentPushExecutionInput): Promise<SyncResult>;
 export declare function executeContentPushPlanAsCommandReport(input: ContentPushExecutionInput, dependencies?: CommandSurfaceDispatchDependencies): Promise<ContentPushExecutionReport>;
+export type ContentPushPreflightOutcome = Readonly<{
+    ok: true;
+    compiled: CompiledContentPushExecutionPlan;
+    report: ContentPushExecutionReport;
+}> | Readonly<{
+    ok: false;
+    report: ContentPushExecutionReport;
+}>;
+export declare function preflightContentPushPlanAsCommandReport(input: ContentPushExecutionInput, dependencies?: CommandSurfaceDispatchDependencies): ContentPushPreflightOutcome;
 export declare function contentPushExecutionReportToSyncResult(report: ContentPushExecutionReport): SyncResult;

package/dist/_dts/sdk/src/cli/site-commands/pushExecutionTypes.d.ts

@@ -7,7 +7,7 @@ import type { compileNavigationPushCommands, NavigationCommandExecutionReport }
 import type { compilePagePushCommands, PageCommandExecutionReport } from './pageCommands';
 export type CommandSurface = 'entry' | 'page' | 'form' | 'navigation';
 export type CommandSurfaceFailurePolicy = 'continue' | 'stop';
-export type ContentPushScope = Extract<PushScope, 'entries' | 'pages' | 'navigation' | 'forms' | 'all'>;
+export type ContentPushScope = Extract<PushScope, 'entries' | 'pages' | 'navigation' | 'forms' | 'settings' | 'all'>;
 export type ResidualSettingsPushPlan = Readonly<{
     diff: ResidualSettingsDiff;
     local: ResidualSettingsLocalContent;

package/dist/_dts/sdk/src/cli/sync/diff.d.ts

@@ -35,6 +35,7 @@ export interface BlockDiff {
 }
 export interface NavigationDiff {
     type: DiffType;
+    identifier?: string | null;
     name: string;
     /** List of changed field paths (for updates) */
     changes?: string[];
@@ -135,6 +136,13 @@ export interface JsonDiffChange {
     /** Status change: publish or unpublish */
     statusChange?: 'publish' | 'unpublish';
 }
+export interface JsonDiffWarning {
+    type: 'duplicate_navigation_identity';
+    source: 'local' | 'remote';
+    identity: string;
+    menuNames: readonly string[];
+    message: string;
+}
 export interface JsonDiff {
     summary: {
         creates: number;
@@ -144,6 +152,7 @@ export interface JsonDiff {
         unpublishes: number;
     };
     changes: JsonDiffChange[];
+    warnings?: readonly JsonDiffWarning[];
 }
 /** JSON diff output for pull --dry-run --json-diff */
 export interface PullJsonDiff {

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -39,12 +39,14 @@ export interface ManagementEntry {
     createdAt: string;
     updatedAt: string;
     publishedAt: string | null;
+    manualOrder: number;
 }
 export interface EntryUpsertInput {
     identifier: string;
     contentType: string;
     data: Record<string, unknown>;
     slug?: string;
+    manualOrder?: number;
 }
 export interface ManagementPage {
     id: string;
@@ -129,6 +131,7 @@ export interface PulledNavigationMenu {
     updatedAt: string;
 }
 export interface NavigationMenuUpsertInput {
+    identifier?: string;
     name: string;
     isPrimary?: boolean;
     isFooter?: boolean;
@@ -534,9 +537,11 @@ export interface PulledEntries {
          * Canonical entry title (route title for routable content types).
          */
         title: string;
+        manualOrder?: number;
     }>;
     meta: {
         pulledAt: string;
+        manualOrder?: string[];
         entries: Record<string, {
             createdAt: string;
             updatedAt: string;
@@ -586,6 +591,7 @@ export interface PulledSettings {
     warnings?: string[];
     meta: {
         pulledAt: string;
+        updatedAt: string | null;
     };
 }
 export interface PulledForms {
@@ -734,6 +740,7 @@ export interface PulledContent {
     courses?: PulledCourses['courses'];
     meta: {
         pulledAt: string;
+        settingsUpdatedAt?: string | null;
         /** Whether the response was truncated due to size limits */
         truncated?: boolean;
         /** Message explaining what was truncated */
@@ -802,6 +809,7 @@ export interface NavigationOperations {
     list(): Promise<ManagementNavigationMenu[]>;
     get(name: string): Promise<ManagementNavigationMenu | null>;
     upsert(input: NavigationMenuUpsertInput): Promise<ManagementNavigationMenu>;
+    delete(menuId: string): Promise<void>;
 }
 export interface SettingsOperations {
     get(): Promise<ManagementSettings>;

package/dist/_dts/sdk/src/client/types.d.ts

@@ -60,8 +60,8 @@ export interface GetEntriesBaseParams extends SdkMethodOptions {
     limit?: number;
     /** Number of entries to skip for pagination */
     offset?: number;
-    /** Sort order for entries. 'order' uses custom ordering (default behavior). */
-    order?: 'newest' | 'oldest' | 'title' | 'order';
+    /** Sort order for entries. Use 'manual' for content types that opt into manual ordering. */
+    order?: 'newest' | 'oldest' | 'title' | 'manual';
     /** If true, includes draft entries (requires API key with site access) */
     preview?: boolean;
     /** Selection mode: 'query' for automatic, 'manual' for specific entry IDs */

package/dist/_dts/sdk/src/config/content-types.d.ts

@@ -150,6 +150,13 @@ export interface ContentTypeConfig {
     fields: FieldDefinition[];
     /** Field ID to use as the entry title source */
     titleField?: string;
+    /**
+     * Entry ordering behavior. Set `mode: 'manual'` to allow editors and SDK
+     * content metadata to curate entry order for this content type.
+     */
+    ordering?: {
+        mode?: 'default' | 'manual';
+    };
     /**
      * When true, only one entry can exist for this content type.
      * The entry is auto-created when the content type is created.

package/dist/_dts/sdk/src/config/field-definitions.d.ts

@@ -9,6 +9,8 @@
 import type { LinkValue, Media, TipTapNode } from '../contracts';
 export type VisibilityLevel = 'admin' | 'designer' | 'author';
 export type ReferenceValueFrom = 'id' | 'identifier' | 'slug';
+export declare const SDK_ICON_PICKER_PRESETS: readonly ["cta", "feature"];
+export type SdkIconPickerPreset = (typeof SDK_ICON_PICKER_PRESETS)[number];
 export type MediaDeliveryOptions = {
     sizes?: string;
     widthCandidates?: number[];
@@ -35,6 +37,8 @@ export type FieldUi = Partial<{
     mediaPickerAutoOpen: boolean;
     showMediaPreview: boolean;
     showMediaOverlayActions: boolean;
+    mediaPreviewMaxWidth: 'xs' | 'sm' | 'md' | 'none';
+    preventMediaPreviewUpscale: boolean;
     mediaDelivery: MediaDeliveryOptions;
     mediaDeliveryByVariant: Record<string, MediaDeliveryOptions>;
     inputType: 'text' | 'email' | 'tel' | 'number';
@@ -78,7 +82,7 @@ export type FieldUi = Partial<{
     thumbnailAltField: string;
     thumbnailLabelField: string;
     thumbnailCardDensity: 'compact' | 'comfortable';
-    iconPickerPreset: 'cta';
+    iconPickerPreset: SdkIconPickerPreset;
     contentTypeField: string;
     fixedContentType: string;
     valueFrom: 'id' | 'identifier' | 'slug';

package/dist/_dts/sdk/src/contracts/index.d.ts

@@ -1,5 +1,5 @@
 export type { TipTapNode, TipTapMark, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, } from './system-block-content';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
 export type { PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';
 export type { CustomCssDeclarationsInput, CustomCssRuleInput, CustomCssNestedRuleInput, CustomCssAtRuleInput, KeyframesAtRuleInput, FontFaceAtRuleInput, MediaAtRuleInput, SupportsAtRuleInput, RawAtRuleInput, } from './custom-css';

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -5,7 +5,7 @@
  * require importing internal blocks package types.
  */
 import type { LinkValue, Media, TipTapNode } from './content';
-import type { EventCategoryId, VenueId } from '../../../core/src/index';
+import type { Brand, EventCategoryId, VenueId } from '../../../core/src/index';
 type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
@@ -53,6 +53,20 @@ export type ContainerStylesContent = {
     fullWidth?: boolean | null;
 } | null;
 export type CtaIconName = 'ArrowRight' | 'ArrowLeft' | 'ChevronRight' | 'ChevronLeft' | 'ChevronUp' | 'ChevronDown' | 'ExternalLink' | 'Download' | 'Upload' | 'Mail' | 'Phone' | 'Play' | 'ShoppingCart' | 'Calendar' | 'MapPin' | 'Info' | 'Plus' | 'Minus' | 'Check' | 'X';
+export type SemanticIconId = 'protection-trust' | 'confidentiality' | 'care-support' | 'partnership' | 'warmth' | 'community' | 'personal-guidance' | 'conversation' | 'friendly-welcome' | 'insight-learning' | 'natural-wellbeing' | 'growth' | 'gentle-care' | 'special-touch' | 'ideas' | 'direction' | 'focus' | 'quality' | 'highlight' | 'verified-quality' | 'learning' | 'training' | 'programmes-dates' | 'place' | 'products' | 'packages' | 'time' | 'practical-service' | 'at-home' | 'worldwide' | 'professional-service';
+export type BlockIconValue = {
+    kind: 'none';
+} | {
+    kind: 'semantic';
+    iconId: SemanticIconId;
+} | {
+    kind: 'generated';
+    setId: Brand<string, 'GeneratedIconSetId'>;
+    assetId: Brand<string, 'GeneratedIconAssetId'>;
+    semanticFallbackIconId: SemanticIconId;
+    styleGuideVersionId: Brand<string, 'SiteIconStyleGuideVersionId'>;
+};
+export type FeatureCardIconTreatment = 'plain' | 'soft-badge' | 'utility-badge';
 export type RichTextDoc = {
     type: 'doc';
     content?: Array<{
@@ -306,6 +320,7 @@ export type FaqItem = {
     answer: unknown;
 };
 export type FaqContent = {
+    variant?: 'default' | 'two-column' | 'question-columns' | 'split-heading-columns' | null;
     eyebrow?: string | null;
     title?: string | null;
     description?: unknown;
@@ -315,6 +330,7 @@ export type FaqContent = {
 export type FeatureCard = {
     media?: Media | null;
     aspectRatio?: StandardAspectRatio | null;
+    icon?: BlockIconValue | SemanticIconId | null;
     title: string;
     body?: TipTapNode | null;
     ctas?: BlockCtaContent[] | null;
@@ -324,6 +340,7 @@ export type FeatureCardsContent = {
     title?: string | null;
     description?: TipTapNode | null;
     columns?: '2' | '3' | '4' | null;
+    _iconTreatment?: FeatureCardIconTreatment | null;
     cards?: FeatureCard[] | null;
 };
 export type HeroCta = {
@@ -502,7 +519,7 @@ export type TeamMembersContent = (TeamMembersCommonContent & {
     members?: ManualTeamMemberItem[];
 });
 export type TestimonialsBlockContent = {
-    variant?: 'carousel' | 'grid' | null;
+    variant?: 'carousel' | 'grid' | 'split-grid' | null;
     heading?: string | null;
     subheading?: string | null;
     avatarLayout?: 'above-centered' | 'inline-left' | 'hidden' | null;

package/dist/_dts/sdk/src/next/index.d.ts

@@ -40,7 +40,7 @@
 export { createCatchAllPage } from './catch-all';
 export { RiverbankContentLoadError, SdkContentLoadError, classifyContentLoadError, isSdkContentLoadError, toContentLoadFailureLogFields, type CatchAllContentLoadFailureContext, type CatchAllRequestContext, type ClassifiedContentLoadError, type SdkContentLoadFailure, type SdkContentLoadFailureKind, type SdkContentLoadNotFound, } from './content-load-failure';
 export type { CreateCatchAllPageOptions, CreateCatchAllPageResult, CatchAllPageProps, CatchAllContext, ThemeSwitchConfigV1, ThemeResolverContext, } from './types';
-export { generateAllStaticParams, validateStaticParamsEnv, pathToSlugArray, type StaticParamsEnvResult, } from './static-params';
+export { createGenerateStaticParams, generateAllStaticParams, normalizeStaticRoutePath, validateStaticParamsEnv, pathToSlugArray, routesToStaticParams, type CreateGenerateStaticParamsOptions, type GenerateAllStaticParamsOptions, type StaticParam, type StaticParamsClient, type StaticParamsEnvResult, type StaticParamsFailureContext, type StaticParamsFailureMode, type StaticParamsRoute, } from './static-params';
 export { createSitemap, type CreateSitemapOptions, type SitemapGenerator, } from './sitemap';
 export { createRobots, type CreateRobotsOptions } from './robots';
 /**

package/dist/_dts/sdk/src/next/revalidate.d.ts

@@ -17,13 +17,34 @@
  * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
  *
  * export const POST = createRevalidateHandler({
- *   onRevalidate: (payload, items) => {
- *     console.log(`Revalidated ${items.length} items for ${payload.event}`);
+ *   onRevalidate: (payload, items, metadata) => {
+ *     console.log(`Revalidated ${items.length} items for ${payload.event}`, metadata);
  *   },
  * });
  * ```
  */
 import { type WebhookPayload } from '../webhooks/verify';
+export type NormalizedRevalidationPaths = Readonly<{
+    paths: string[];
+    invalidPaths: string[];
+}>;
+export type RevalidationRequestMetadata = Readonly<{
+    event: WebhookPayload['event'];
+    siteId: string;
+    dispatchId?: string;
+    pathCount: number;
+    tagCount: number;
+    itemCount: number;
+    requestId?: string;
+    correlationId?: string;
+    monitorRunId?: string;
+}>;
+/**
+ * Normalize a public URL path for Next revalidation.
+ */
+export declare function normalizeRevalidationPath(path: string): string | null;
+export declare function normalizeRevalidationPaths(paths?: readonly string[]): NormalizedRevalidationPaths;
+export declare function normalizeRevalidationTags(tags?: readonly string[]): string[];
 /**
  * Options for the revalidation handler.
  */
@@ -36,15 +57,15 @@ export interface RevalidateHandlerOptions {
      * Callback called after successful revalidation.
      * Useful for logging or analytics.
      */
-    onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[]) => void;
+    onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[], metadata: RevalidationRequestMetadata) => void;
 }
 /**
  * Create a Next.js API route handler for webhook revalidation.
  *
  * The handler:
  * 1. Verifies the webhook signature using HMAC-SHA256
- * 2. Calls `revalidateTag()` for each tag in the payload
- * 3. Calls `revalidatePath()` if a path is included in the data
+ * 2. Calls `revalidateTag()` for each normalized tag in the payload
+ * 3. Calls `revalidatePath()` for each normalized path in the payload
  * 4. Returns a JSON response with the revalidation results
  *
  * @param options - Configuration options

package/dist/_dts/sdk/src/next/static-params.d.ts

@@ -11,6 +11,29 @@
  * export { generateAllStaticParams as generateStaticParams };
  * ```
  */
+import type { RiverbankClient } from '../client/types';
+import type { RoutableContentResponse } from '../public-api/contracts';
+export type StaticParam = Readonly<{
+    slug: string[];
+}>;
+export type StaticParamsRoute = Pick<RoutableContentResponse['items'][number], 'path'>;
+export type StaticParamsClient = Pick<RiverbankClient, 'getAllPublishedRoutes'>;
+export type StaticParamsFailureMode = 'throw' | 'fallback';
+export type StaticParamsFailureContext = Readonly<{
+    siteId: string;
+    error: unknown;
+    reason: 'route_discovery_failed' | 'invalid_route_path';
+    path?: string;
+}>;
+export type CreateGenerateStaticParamsOptions = Readonly<{
+    getClient: () => StaticParamsClient | Promise<StaticParamsClient>;
+    siteId: string;
+    failureMode?: StaticParamsFailureMode;
+    fallbackPaths?: readonly string[];
+    onFailure?: (context: StaticParamsFailureContext) => void;
+    signal?: AbortSignal;
+}>;
+export type GenerateAllStaticParamsOptions = Pick<CreateGenerateStaticParamsOptions, 'failureMode' | 'fallbackPaths' | 'onFailure' | 'signal'>;
 /**
  * Environment variable validation result
  */
@@ -25,6 +48,7 @@ export type StaticParamsEnvResult = {
     valid: false;
     missingVars: string[];
 };
+export declare function dashboardUrlToApiBaseUrl(input: string): string;
 /**
  * Validate that all required environment variables are set.
  *
@@ -36,6 +60,7 @@ export type StaticParamsEnvResult = {
  * @returns Validation result with config or missing vars
  */
 export declare function validateStaticParamsEnv(): StaticParamsEnvResult;
+export declare function normalizeStaticRoutePath(path: string): string;
 /**
  * Convert a route path to a Next.js slug array.
  *
@@ -50,6 +75,8 @@ export declare function validateStaticParamsEnv(): StaticParamsEnvResult;
  * ```
  */
 export declare function pathToSlugArray(path: string): string[];
+export declare function routesToStaticParams(routes: readonly StaticParamsRoute[]): StaticParam[];
+export declare function createGenerateStaticParams(options: CreateGenerateStaticParamsOptions): () => Promise<StaticParam[]>;
 /**
  * Generate static params for all published routes.
  *
@@ -79,6 +106,4 @@ export declare function pathToSlugArray(path: string): string[];
  * }
  * ```
  */
-export declare function generateAllStaticParams(): Promise<{
-    slug: string[];
-}[]>;
+export declare function generateAllStaticParams(options?: GenerateAllStaticParamsOptions): Promise<StaticParam[]>;

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -810,7 +810,7 @@ export type SitemapRoutesResponse = {
     pageSize: number;
     allowIndexingInProduction: boolean;
 };
-export type PublicEndpointName = "getSite" | "getContentByPath" | "listPublishedEntries" | "getPublishedEntryPreview" | "getPublicFormById" | "listPublicForms" | "getPublicBookingServices" | "getPublicChallenge" | "listPublicEvents" | "batchBlockLoaders" | "listPublicCourses" | "listPublicTeamMembers" | "listPublicProducts" | "listPublicPasses" | "listPublicMemberships" | "resolveEntrySubroute" | "resolveEventOccurrence" | "checkRedirect" | "getRoutableContent" | "getPublicSitemapRoutes";
+export type PublicEndpointName = "getSite" | "getContentByPath" | "listPublishedEntries" | "getPublishedEntryPreview" | "getPublicFormById" | "listPublicForms" | "getPublicBookingServices" | "getPublicChallenge" | "listPublicEvents" | "batchBlockLoaders" | "listPublicCourses" | "listPublicTeamMembers" | "listPublicProducts" | "listPublicPasses" | "listPublicMemberships" | "resolveEntrySubroute" | "resolveEventOccurrence" | "checkRedirect" | "getRoutableContent" | "getPublicRoutableContent" | "getPublicSitemapRoutes";
 export type PublicAPIEndpoints = {
     getSite: APIEndpointBase<never, {
         id?: string;
@@ -949,6 +949,10 @@ export type PublicAPIEndpoints = {
         siteId: string;
         publishedOnly?: string;
     }, RoutableContentResponse>;
+    getPublicRoutableContent: APIEndpointBase<never, {
+        siteId: string;
+        publishedOnly?: string;
+    }, RoutableContentResponse>;
     getPublicSitemapRoutes: APIEndpointBase<never, {
         siteId: string;
         page?: string;

package/dist/_dts/sdk/src/public-api/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { ApiResult, HTTPMethod, PublicAPIEndpoints, PublicEndpointName } from './contracts';
-export declare const PUBLIC_ENDPOINT_NAMES: readonly ["getSite", "getContentByPath", "listPublishedEntries", "getPublishedEntryPreview", "getPublicFormById", "listPublicForms", "getPublicBookingServices", "getPublicChallenge", "listPublicEvents", "batchBlockLoaders", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "resolveEntrySubroute", "resolveEventOccurrence", "checkRedirect", "getRoutableContent", "getPublicSitemapRoutes"];
+export declare const PUBLIC_ENDPOINT_NAMES: readonly ["getSite", "getContentByPath", "listPublishedEntries", "getPublishedEntryPreview", "getPublicFormById", "listPublicForms", "getPublicBookingServices", "getPublicChallenge", "listPublicEvents", "batchBlockLoaders", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "resolveEntrySubroute", "resolveEventOccurrence", "checkRedirect", "getRoutableContent", "getPublicRoutableContent", "getPublicSitemapRoutes"];
 export type ApiClient = <E extends PublicEndpointName>(params: {
     endpoint: E;
     params?: PublicAPIEndpoints[E]['query'];

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.78.0";
+export declare const SDK_VERSION = "0.79.0";

package/dist/_dts/sdk/src/webhooks/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Webhook utilities for Riverbank SDK
  */
-export { verifyWebhookSignature, parseWebhookPayload, WebhookPayloadSchema, type WebhookPayload, type ParseWebhookResult, } from './verify';
+export { SUPPORTED_WEBHOOK_EVENTS, verifyWebhookSignature, parseWebhookPayload, RIVERBANK_SIGNATURE_PREFIX, WebhookPayloadSchema, WebhookEventSchema, normalizeRevalidationPath, parseRevalidationPath, unwrapRevalidationPath, type RevalidationPath, type RevalidationPathParseError, type RevalidationPathParseResult, type WebhookEvent, type WebhookPayload, type ParseWebhookResult, } from './verify';

package/dist/_dts/sdk/src/webhooks/verify.d.ts

@@ -3,116 +3,20 @@
  *
  * Provides framework-agnostic webhook signature verification and payload parsing.
  */
-import { z } from 'zod';
-/**
- * Supported webhook event types.
- * Keep in sync with apps/dashboard/src/lib/db/helpers/webhooks.ts
- */
-export declare const WebhookEventSchema: z.ZodEnum<{
-    "page.published": "page.published";
-    "entry.published": "entry.published";
-    "navigation.updated": "navigation.updated";
-    "theme.updated": "theme.updated";
-    "site.settings_updated": "site.settings_updated";
-}>;
-export type WebhookEvent = z.infer<typeof WebhookEventSchema>;
-/** Data for page.published events */
-export declare const PagePublishedDataSchema: z.ZodObject<{
-    pageId: z.ZodString;
-    path: z.ZodString;
-    slug: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/** Data for entry.published events */
-export declare const EntryPublishedDataSchema: z.ZodObject<{
-    entryId: z.ZodString;
-    path: z.ZodString;
-    contentType: z.ZodString;
-}, z.core.$strip>;
-/** Data for navigation.updated events */
-export declare const NavigationUpdatedDataSchema: z.ZodObject<{
-    menuId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/** Data for theme.updated and site.settings_updated events (empty) */
-export declare const EmptyDataSchema: z.ZodObject<{}, z.core.$strip>;
-/**
- * Combined data schema that accepts any valid event data.
- * The actual shape depends on the event type.
- */
-export declare const WebhookDataSchema: z.ZodUnion<readonly [z.ZodObject<{
-    pageId: z.ZodString;
-    path: z.ZodString;
-    slug: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    entryId: z.ZodString;
-    path: z.ZodString;
-    contentType: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    menuId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>;
-export type PagePublishedData = z.infer<typeof PagePublishedDataSchema>;
-export type EntryPublishedData = z.infer<typeof EntryPublishedDataSchema>;
-export type NavigationUpdatedData = z.infer<typeof NavigationUpdatedDataSchema>;
-/**
- * Zod schema for webhook payload validation.
- */
-export declare const WebhookPayloadSchema: z.ZodObject<{
-    event: z.ZodEnum<{
-        "page.published": "page.published";
-        "entry.published": "entry.published";
-        "navigation.updated": "navigation.updated";
-        "theme.updated": "theme.updated";
-        "site.settings_updated": "site.settings_updated";
-    }>;
-    timestamp: z.ZodString;
-    siteId: z.ZodString;
-    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-/**
- * Webhook payload structure sent by the CMS.
- */
-export type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
+import { type EmptyWebhookData, type EntryPathChangedData, type EntryPublishedData, type EntryRemovedData, type NavigationUpdatedData, type PagePathChangedData, type PagePublishedData, type PageRemovedData, type RevalidationPath, type RevalidationPathParseError, type RevalidationPathParseResult, type WebhookEvent, type WebhookPayload } from '../../../api/src/webhooks';
+export { EmptyWebhookDataSchema as EmptyDataSchema, EntryPathChangedDataSchema, EntryPublishedDataSchema, EntryRemovedDataSchema, NavigationUpdatedDataSchema, PagePathChangedDataSchema, PagePublishedDataSchema, PageRemovedDataSchema, RIVERBANK_SIGNATURE_PREFIX, SUPPORTED_WEBHOOK_EVENTS, WebhookEventSchema, WebhookPayloadSchema, normalizeRevalidationPath, parseRevalidationPath, unwrapRevalidationPath, } from '../../../api/src/webhooks';
+export type { EmptyWebhookData as EmptyData, RevalidationPath, RevalidationPathParseError, RevalidationPathParseResult, EntryPathChangedData, EntryPublishedData, EntryRemovedData, NavigationUpdatedData, PagePathChangedData, PagePublishedData, PageRemovedData, WebhookEvent, WebhookPayload, };
 /**
  * Type-safe webhook payload with discriminated data based on event type.
  */
-export type TypedWebhookPayload = {
-    event: 'page.published';
-    data: PagePublishedData;
-    siteId: string;
-    timestamp: string;
-    tags?: string[];
-} | {
-    event: 'entry.published';
-    data: EntryPublishedData;
-    siteId: string;
-    timestamp: string;
-    tags?: string[];
-} | {
-    event: 'navigation.updated';
-    data: NavigationUpdatedData;
-    siteId: string;
-    timestamp: string;
-    tags?: string[];
-} | {
-    event: 'theme.updated';
-    data: Record<string, never>;
-    siteId: string;
-    timestamp: string;
-    tags?: string[];
-} | {
-    event: 'site.settings_updated';
-    data: Record<string, never>;
-    siteId: string;
-    timestamp: string;
-    tags?: string[];
-};
+export type TypedWebhookPayload = WebhookPayload;
 /**
- * Verify a webhook signature using HMAC-SHA256.
+ * Verify a `sha256=<digest>` webhook signature using HMAC-SHA256.
  *
  * Uses timing-safe comparison to prevent timing attacks.
  *
  * @param payload - The raw request body as a string
- * @param signature - The X-Riverbank-Signature header value
+ * @param signature - The X-Riverbank-Signature header value (`sha256=<hex digest>`)
  * @param secret - The webhook signing secret (RIVERBANK_WEBHOOK_SECRET)
  * @returns true if signature is valid, false otherwise
  *