@riverbankcms/sdk 0.77.1 → 0.78.2

package/dist/_dts/path-utils/src/safeAppPath.d.ts

@@ -0,0 +1,26 @@
+import { type RedirectPathParseError } from './redirectPaths';
+declare const __brand: unique symbol;
+type Brand<T, B extends string> = T & {
+    readonly [__brand]: B;
+};
+/**
+ * A redirect path that has been validated as a safe, same-origin relative path.
+ *
+ * Parse once at the boundary, then carry the branded value inward instead of
+ * re-validating ad hoc string inputs in every auth flow.
+ */
+export type SafeAppPath = Brand<string, 'SafeAppPath'>;
+export type SafeAppPathParseError = RedirectPathParseError;
+export type SafeAppPathParseResult = {
+    ok: true;
+    value: SafeAppPath;
+} | {
+    ok: false;
+    error: SafeAppPathParseError;
+};
+export declare function parseSafeAppPath(value: unknown): SafeAppPathParseResult;
+export declare function sanitizeSafeAppPath(value: unknown): SafeAppPath | null;
+export declare function assertSafeAppPath(value: string): SafeAppPath;
+export declare function safeAppPathOrFallback(value: unknown, fallback: SafeAppPath): SafeAppPath;
+export declare function buildSafeRedirectUrl(path: SafeAppPath, baseUrl: string | URL): URL;
+export {};

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeButton.d.ts

@@ -1,4 +1,5 @@
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
-export declare function SiteChromeCustomizeButton({ surface, }: {
+export declare function SiteChromeCustomizeButton({ surface, containerClassName, }: {
     surface: SiteChromeEditableSurfaceKind;
+    containerClassName?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeContext.d.ts

@@ -13,6 +13,9 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     kind: 'available';
     surface: 'header';
     label: string;
+    currentLayoutId: HeaderLayoutId;
+    currentLayoutLabel: string;
+    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
     currentId: HeaderStyleId;
     currentLabel: string;
     options: readonly SiteChromeLookOption<HeaderStyleId>[];
@@ -35,6 +38,7 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
 type SiteChromeCustomizeContextValue = Readonly<{
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
     cycleSurfaceLook: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+    cycleSurfaceLayout: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
 }>;
 export type SiteChromeCustomizeProviderProps = Readonly<{
     children: ReactNode;

package/dist/_dts/preview-next/src/client/preview/previewDocumentFrame.d.ts

@@ -0,0 +1,31 @@
+import type { CSSProperties } from "react";
+import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
+type ZoomableStyle = CSSProperties & Readonly<{
+    zoom?: number;
+}>;
+export type PreviewDocumentFramePlan = Readonly<{
+    kind: "squeeze";
+    frameClassName: string;
+    frameDataProps: PreviewDocumentFrameDataProps;
+}> | Readonly<{
+    kind: "fixed";
+    targetWidthPx: number;
+    wrapperStyle: CSSProperties;
+    contentStyle: ZoomableStyle;
+    siteDocumentStyle: CSSProperties;
+    frameClassName: string;
+    frameDataProps: PreviewDocumentFrameDataProps;
+}>;
+export type PreviewDocumentFrameDataProps = Readonly<{
+    "data-builder-preview-document-frame": "squeeze" | "fixed";
+    "data-builder-preview-document-scale": "none" | "scaled";
+    "data-builder-preview-fixed-header-behavior"?: "fixed-as-sticky";
+}>;
+export type PreviewDocumentFrameInput = Readonly<{
+    viewportMode: ViewportMode;
+    viewportWidth: ViewportWidth;
+    scale: number;
+    contentHeight: number;
+}>;
+export declare function planPreviewDocumentFrame(input: PreviewDocumentFrameInput): PreviewDocumentFramePlan;
+export {};

package/dist/_dts/sdk/src/cli/commands/push/consts.d.ts

@@ -1,3 +1,3 @@
-export declare const VALID_PUSH_SCOPES: readonly ["entries", "pages", "navigation", "forms", "theme", "footer", "venues", "event-categories", "events", "courses", "all"];
+export declare const VALID_PUSH_SCOPES: readonly ["entries", "pages", "navigation", "forms", "settings", "theme", "footer", "venues", "event-categories", "events", "courses", "all"];
 export type PushScope = (typeof VALID_PUSH_SCOPES)[number];
 export declare function isValidPushScope(scope: string): scope is PushScope;

package/dist/_dts/sdk/src/cli/commands/push/metadata.d.ts

@@ -12,6 +12,8 @@ export interface MetadataUpdateFlags {
     willUpdateNavigation: boolean;
     /** Whether forms metadata should be updated (zero failures + some synced) */
     willUpdateForms: boolean;
+    /** Whether settings metadata should be updated (zero failures + settings synced) */
+    willUpdateSettings: boolean;
     /** Whether any metadata should be updated (at least one content type qualifies) */
     shouldUpdateMetadata: boolean;
 }

package/dist/_dts/sdk/src/cli/commands/push/stale.d.ts

@@ -1,6 +1,6 @@
-import type { EntryMetadata, PagesMetadata, NavigationMetadata, FormsMetadata, LocalContent } from '../../content/reader';
+import type { EntryMetadata, PagesMetadata, NavigationMetadata, FormsMetadata, LocalContent, SettingsMetadata } from '../../content/reader';
 import type { PulledContent } from '../../../client/management/types';
-export type StaleScope = 'entries' | 'pages' | 'navigation' | 'forms';
+export type StaleScope = 'entries' | 'pages' | 'navigation' | 'settings' | 'forms';
 export interface StaleItem {
     scope: StaleScope;
     /** Only set for entries — the content type slug */
@@ -14,4 +14,4 @@ export interface StaleItem {
  * Check for stale content (remote is newer than local base)
  * @internal Exported for testing
  */
-export declare function checkForStaleContent(localContent: LocalContent, localMeta: Map<string, EntryMetadata>, pagesMeta: PagesMetadata | null, navigationMeta: NavigationMetadata | null, formsMeta: FormsMetadata | null, remoteContent: PulledContent): StaleItem[];
+export declare function checkForStaleContent(localContent: LocalContent, localMeta: Map<string, EntryMetadata>, pagesMeta: PagesMetadata | null, navigationMeta: NavigationMetadata | null, formsMeta: FormsMetadata | null, remoteContent: PulledContent, settingsMeta?: SettingsMetadata | null): StaleItem[];

package/dist/_dts/sdk/src/cli/commands/push-execute.d.ts

@@ -1,11 +1,18 @@
 import { type EnvTarget } from '../helpers';
 import type { OutputContext } from '../output';
+import type { ContentSummary } from '../content/reader';
 import { type JsonDiffMode } from '../sync';
 import type { PushOptions } from './push/options';
 import { type PushScope } from './push/consts';
 export interface PushExecutionResult {
     success: boolean;
 }
+export declare function noContentFoundWarningDetails(contentDir: string): Readonly<{
+    contentDir: string;
+    expectedFiles: readonly string[];
+    suggestion: string;
+}>;
+export declare function contentSummaryHasPushableContent(summary: ContentSummary): boolean;
 type MergeRemoteValidationInput = Readonly<{
     target: EnvTarget;
     pushScope: PushScope;

package/dist/_dts/sdk/src/cli/commands/push.d.ts

@@ -11,6 +11,7 @@
  *   riverbankcms push pages              # Push pages with blocks
  *   riverbankcms push pages home         # Push specific page with blocks
  *   riverbankcms push navigation         # Push navigation menus
+ *   riverbankcms push settings           # Push site settings
  *   riverbankcms push footer             # Push footer content
  *   riverbankcms push theme              # Push activeTheme from config (or 'current')
  *   riverbankcms push theme modern       # Push specific theme file
@@ -18,6 +19,7 @@
  *   riverbankcms push --dry-run          # Show what would be pushed
  */
 import { Command } from 'commander';
+export { contentSummaryHasPushableContent, noContentFoundWarningDetails } from './push-execute';
 export { VALID_PUSH_SCOPES, isValidPushScope, type PushScope } from './push/consts';
 export { calculateMetadataUpdates, type MetadataUpdateFlags } from './push/metadata';
 export { filterLocalContent, type FilterResult } from './push/filter';

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -12,6 +12,7 @@ export interface LocalEntry {
     status?: 'draft' | 'published';
     hasUnpublishedChanges?: boolean;
     slug?: string;
+    manualOrder?: number;
 }
 export declare class LegacyEntryTitleError extends Error {
     readonly filePath: string;
@@ -376,6 +377,7 @@ export interface ContentSummary {
 export declare function getContentSummary(contentDir: string): Promise<ContentSummary>;
 export interface EntryMetadata {
     pulledAt: string;
+    manualOrder?: string[];
     entries: Record<string, {
         id?: string;
         createdAt?: string;
@@ -397,6 +399,10 @@ export interface NavigationMetadata {
         updatedAt?: string;
     }>;
 }
+export interface SettingsMetadata {
+    pulledAt: string;
+    updatedAt: string | null;
+}
 /**
  * Read metadata for a content type from .meta/ directory
  *
@@ -412,6 +418,13 @@ export declare function readEntriesMeta(contentDir: string, contentType: string)
  * @returns Map of content type to metadata
  */
 export declare function readAllMeta(contentDir: string): Promise<Map<string, EntryMetadata>>;
+/**
+ * Read settings metadata from .meta/settings.json
+ *
+ * @param contentDir - Base content directory
+ * @returns Settings metadata or null if not found
+ */
+export declare function readSettingsMeta(contentDir: string): Promise<SettingsMetadata | null>;
 /**
  * Read pages metadata from .meta/pages.json
  *

package/dist/_dts/sdk/src/cli/content/writer.d.ts

@@ -50,7 +50,7 @@ export declare function writeNavigation(contentDir: string, pulledNavigation: Pu
  *
  * Format: content/settings.json
  */
-export declare function writeSettings(contentDir: string, pulledSettings: PulledSettings): Promise<string>;
+export declare function writeSettings(contentDir: string, pulledSettings: PulledSettings, options?: WriterOptions): Promise<string>;
 /**
  * Write forms to content directory
  *
@@ -195,6 +195,7 @@ export declare function updateMetadataAfterPush(contentDir: string, remoteConten
         updatedAt: string;
         createdAt?: string;
     }>;
+    settingsUpdatedAt?: string | null;
     forms?: Array<{
         slug: string;
         updatedAt: string;

package/dist/_dts/sdk/src/cli/helpers.d.ts

@@ -97,6 +97,7 @@ export interface PulledEntryOutput {
     slug?: string;
     /** Resolved title (routable title when present, otherwise content title) */
     title: string;
+    manualOrder?: number;
 }
 /**
  * Map an entry from API response to pull output format.
@@ -109,6 +110,7 @@ export declare function mapEntryForOutput<T extends {
     hasUnpublishedChanges: boolean;
     slug?: string;
     title: string;
+    manualOrder?: number;
 }>(entry: T): PulledEntryOutput;
 /**
  * Parse pagination options from command flags.

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

@@ -5,9 +5,9 @@ export type CliPageIdentifier = Brand<string, 'SdkCliPageIdentifier'>;
 export type CliBlockIdentifier = Brand<string, 'SdkCliBlockIdentifier'>;
 export type CliFormSlug = Brand<string, 'SdkCliFormSlug'>;
 export type CliNavigationMenuName = Brand<string, 'SdkCliNavigationMenuName'>;
-export declare const asCliContentTypeKey: (value: string) => CliContentTypeKey;
-export declare const asCliEntryIdentifier: (value: string) => CliEntryIdentifier;
-export declare const asCliPageIdentifier: (value: string) => CliPageIdentifier;
-export declare const asCliBlockIdentifier: (value: string) => CliBlockIdentifier;
-export declare const asCliFormSlug: (value: string) => CliFormSlug;
-export declare const asCliNavigationMenuName: (value: string) => CliNavigationMenuName;
+export declare const unsafeAsCliContentTypeKey: (value: string) => CliContentTypeKey;
+export declare const unsafeAsCliEntryIdentifier: (value: string) => CliEntryIdentifier;
+export declare const unsafeAsCliPageIdentifier: (value: string) => CliPageIdentifier;
+export declare const unsafeAsCliBlockIdentifier: (value: string) => CliBlockIdentifier;
+export declare const unsafeAsCliFormSlug: (value: string) => CliFormSlug;
+export declare const unsafeAsCliNavigationMenuName: (value: string) => CliNavigationMenuName;

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/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/client/error.d.ts

@@ -5,6 +5,7 @@
  * Provides typed access to error details including code, message, request ID, and field errors.
  */
 import type { ApiError, ApiErrorCode, FieldError } from '../public-api/contracts';
+import type { ResilienceStatus } from './types';
 /**
  * Error options for creating RiverbankApiError
  */
@@ -147,3 +148,5 @@ export declare class RiverbankApiError extends Error {
      */
     toDetailedString(): string;
 }
+export declare function attachResilienceStatusToError(error: unknown, resilienceStatus: ResilienceStatus): unknown;
+export declare function getResilienceStatusFromError(error: unknown): ResilienceStatus | undefined;

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

@@ -13,6 +13,6 @@ import type { RiverbankClient, RiverbankClientConfig } from './types';
  * ```
  */
 export declare function createRiverbankClient(config: RiverbankClientConfig): RiverbankClient;
-export type { RiverbankClient, RiverbankClientConfig, ResilienceConfig, ResilienceStatus, ApiKeyType, SdkAuthConfig } from './types';
-export { RiverbankApiError } from './error';
+export type { ApiKeyType, GetPageParams, GetSiteParams, ResilienceConfig, ResilienceStatus, ResilientData, RiverbankClient, RiverbankClientConfig, SdkAuthConfig, } from './types';
+export { getResilienceStatusFromError, RiverbankApiError } from './error';
 export { CircuitOpenError } from './resilience';

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;
@@ -534,9 +536,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 +590,7 @@ export interface PulledSettings {
     warnings?: string[];
     meta: {
         pulledAt: string;
+        updatedAt: string | null;
     };
 }
 export interface PulledForms {
@@ -734,6 +739,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 */

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

@@ -30,6 +30,24 @@ export interface SdkMethodOptions {
     /** AbortSignal for cancelling the request */
     signal?: AbortSignal;
 }
+export type GetSiteParams = {
+    slug?: string;
+    domain?: string;
+    id?: string;
+    /**
+     * Bypass SDK in-memory cache and Next.js fetch caching (uses `cache: 'no-store'`).
+     *
+     * Useful right after `riverbankcms push-config` in development to avoid waiting
+     * for cache revalidation.
+     */
+    force?: boolean;
+    currentPath?: string;
+} & SdkMethodOptions;
+export type GetPageParams = {
+    siteId: string;
+    path: string;
+    preview?: boolean;
+} & SdkMethodOptions;
 /**
  * Base parameters for getEntries - shared across all overloads
  */
@@ -42,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 */
@@ -69,6 +87,7 @@ export interface ResilienceStatus {
     error?: {
         code?: string;
         message: string;
+        status?: number;
     };
     /** Seconds since cache TTL expired (when source='stale') */
     staleAgeSec?: number;
@@ -81,6 +100,13 @@ export interface ResilienceStatus {
     /** Total request duration including retries (ms) */
     durationMs?: number;
 }
+/**
+ * Data returned with the resilience status for the exact request that produced it.
+ */
+export type ResilientData<T> = Readonly<{
+    data: T;
+    resilience: ResilienceStatus;
+}>;
 /**
  * Circuit breaker state information
  */
@@ -201,7 +227,7 @@ export type SdkAuthConfig = {
     token: string;
 };
 export declare const SDK_CORRELATION_HEADER_NAMES: readonly ["x-request-id", "x-correlation-id", "x-riverbank-monitor-run-id"];
-export type SdkCorrelationHeaderName = typeof SDK_CORRELATION_HEADER_NAMES[number];
+export type SdkCorrelationHeaderName = (typeof SDK_CORRELATION_HEADER_NAMES)[number];
 export type SdkCorrelationHeaders = Readonly<Partial<Record<SdkCorrelationHeaderName, string>>>;
 /**
  * Configuration for creating a Riverbank CMS client
@@ -276,29 +302,21 @@ export interface RiverbankClient {
     /**
      * Fetch site data by slug, domain, or ID
      */
-    getSite(params: {
-        slug?: string;
-        domain?: string;
-        id?: string;
-        /**
-         * Bypass SDK in-memory cache and Next.js fetch caching (uses `cache: 'no-store'`).
-         *
-         * Useful right after `riverbankcms push-config` in development to avoid waiting
-         * for cache revalidation.
-         */
-        force?: boolean;
-        currentPath?: string;
-    } & SdkMethodOptions): Promise<SiteResponse>;
+    getSite(params: GetSiteParams): Promise<SiteResponse>;
+    /**
+     * Fetch site data and return the resilience status for this exact request.
+     */
+    getSiteWithResilience(params: GetSiteParams): Promise<ResilientData<SiteResponse>>;
     /**
      * Fetch a specific page by path
      *
      * @param params.preview - If true, returns draft content instead of published content (requires API key with site access)
      */
-    getPage(params: {
-        siteId: string;
-        path: string;
-        preview?: boolean;
-    } & SdkMethodOptions): Promise<PageResponse>;
+    getPage(params: GetPageParams): Promise<PageResponse>;
+    /**
+     * Fetch page content and return the resilience status for this exact request.
+     */
+    getPageWithResilience(params: GetPageParams): Promise<ResilientData<PageResponse>>;
     /**
      * Fetch published content entries with optional pagination, sorting, and preview mode
      *

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

@@ -35,6 +35,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';

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

@@ -17,9 +17,9 @@
  *
  * @packageDocumentation
  */
-export { createRiverbankClient, RiverbankApiError } from './client/index';
+export { createRiverbankClient, getResilienceStatusFromError, RiverbankApiError, } from './client/index';
 export { SDK_CORRELATION_HEADER_NAMES } from './client/types';
-export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, SdkAuthConfig, SiteResponse, PageResponse, EntriesResponse, EntriesResponseWithMeta, PaginationMeta, EntryResponse, ResilienceConfig, ResilienceStatus, ResilienceSource, CircuitState, RetryConfig, CircuitBreakerConfig, } from './client/types';
+export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, SdkAuthConfig, SiteResponse, PageResponse, EntriesResponse, EntriesResponseWithMeta, GetPageParams, GetSiteParams, PaginationMeta, EntryResponse, ResilienceConfig, ResilienceStatus, ResilientData, ResilienceSource, CircuitState, RetryConfig, CircuitBreakerConfig, } from './client/types';
 export { prebuildCache } from './prebuild/index';
 export type { PrebuildOptions, PrebuildResult, PrebuildProgress, PrebuildManifest, PrebuildContentType, } from './prebuild/types';
 export { PrebuildLoader, createPrebuildLoader, canUsePrebuild, } from './prebuild/loader';

package/dist/_dts/sdk/src/manifest/passes/pass1-fields.d.ts

@@ -8,19 +8,19 @@ import { z } from 'zod';
 export declare const simpleFieldTypeEnum: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
+    text: "text";
+    select: "select";
     media: "media";
     link: "link";
-    select: "select";
-    text: "text";
     richText: "richText";
 }>;
 export declare const fieldTypeEnum: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
+    text: "text";
+    select: "select";
     media: "media";
     link: "link";
-    select: "select";
-    text: "text";
     richText: "richText";
     repeater: "repeater";
     group: "group";
@@ -34,10 +34,10 @@ export declare const extractedFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodEnum<{
         number: "number";
         boolean: "boolean";
+        text: "text";
+        select: "select";
         media: "media";
         link: "link";
-        select: "select";
-        text: "text";
         richText: "richText";
     }>;
     label: z.ZodString;
@@ -61,10 +61,10 @@ export declare const extractedFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
+            text: "text";
+            select: "select";
             media: "media";
             link: "link";
-            select: "select";
-            text: "text";
             richText: "richText";
         }>;
         label: z.ZodString;
@@ -81,10 +81,10 @@ export declare const extractedFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
+            text: "text";
+            select: "select";
             media: "media";
             link: "link";
-            select: "select";
-            text: "text";
             richText: "richText";
         }>;
         label: z.ZodString;
@@ -178,10 +178,10 @@ export declare const pass1OutputSchema: z.ZodObject<{
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
+            text: "text";
+            select: "select";
             media: "media";
             link: "link";
-            select: "select";
-            text: "text";
             richText: "richText";
         }>;
         label: z.ZodString;
@@ -205,10 +205,10 @@ export declare const pass1OutputSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 number: "number";
                 boolean: "boolean";
+                text: "text";
+                select: "select";
                 media: "media";
                 link: "link";
-                select: "select";
-                text: "text";
                 richText: "richText";
             }>;
             label: z.ZodString;
@@ -225,10 +225,10 @@ export declare const pass1OutputSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 number: "number";
                 boolean: "boolean";
+                text: "text";
+                select: "select";
                 media: "media";
                 link: "link";
-                select: "select";
-                text: "text";
                 richText: "richText";
             }>;
             label: z.ZodString;