@riverbankcms/sdk 0.96.0 → 0.99.0

package/dist/_dts/sdk/src/cli/merge-remote/sharedMergeReport.d.ts

@@ -0,0 +1,63 @@
+import type { OutputContext } from '../output';
+type MergeDecisionSubject<TSubject> = Readonly<{
+    kind: string;
+    subject: TSubject;
+}>;
+type ConflictCode<TDecision> = Extract<TDecision, {
+    kind: 'conflict';
+}> extends {
+    conflict: {
+        code: infer TCode extends string;
+    };
+} ? TCode : string;
+type ReportDecisionLineKind<TDecision extends {
+    kind: string;
+}> = Exclude<TDecision['kind'], 'auto_merge' | 'conflict' | 'unchanged'>;
+export type RemoteMergeDecisionLabels<TDecision extends {
+    kind: string;
+}> = {
+    readonly [TKind in ReportDecisionLineKind<TDecision>]: string;
+};
+export type RemoteMergeDecisionReport<TDecision extends {
+    kind: string;
+}, TSubjectJson extends object> = Readonly<{
+    kind: TDecision['kind'];
+} & TSubjectJson & {
+    localFieldPaths?: readonly string[];
+    remoteFieldPaths?: readonly string[];
+    conflict?: Readonly<{
+        code: ConflictCode<TDecision>;
+        fieldPath?: string;
+        message: string;
+    }>;
+}>;
+export type RemoteMergeJsonReport<TScope extends string, TSummary, TDecision extends {
+    kind: string;
+}, TSubjectJson extends object> = Readonly<{
+    kind: 'push';
+    scope: TScope;
+    mergeRemote: true;
+    dryRun: boolean;
+    summary: TSummary;
+    decisions: readonly RemoteMergeDecisionReport<TDecision, TSubjectJson>[];
+}>;
+export type RemoteMergeReportConfig<TScope extends string, TSummary, TSubject, TSubjectJson extends object, TDecision extends MergeDecisionSubject<TSubject>> = Readonly<{
+    scope: TScope;
+    title: string;
+    summaryLines(summary: TSummary): readonly string[];
+    subjectLabel(subject: TSubject): string;
+    subjectJson(subject: TSubject): TSubjectJson;
+    decisionLabels: RemoteMergeDecisionLabels<TDecision>;
+}>;
+export declare function remoteMergeJsonReport<TScope extends string, TSummary, TSubject, TSubjectJson extends object, TDecision extends MergeDecisionSubject<TSubject>>(input: Readonly<{
+    config: RemoteMergeReportConfig<TScope, TSummary, TSubject, TSubjectJson, TDecision>;
+    decisions: readonly TDecision[];
+    dryRun: boolean;
+    summary: TSummary;
+}>): RemoteMergeJsonReport<TScope, TSummary, TDecision, TSubjectJson>;
+export declare function writeRemoteMergeHumanReport<TScope extends string, TSummary, TSubject, TSubjectJson extends object, TDecision extends MergeDecisionSubject<TSubject>>(output: Pick<OutputContext, 'info'>, config: RemoteMergeReportConfig<TScope, TSummary, TSubject, TSubjectJson, TDecision>, input: Readonly<{
+    decisions: readonly TDecision[];
+    dryRun: boolean;
+    summary: TSummary;
+}>): void;
+export {};

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

@@ -11,18 +11,29 @@ interface PushConfigOptions {
     apiKey?: string;
     dashboard: string;
     forceContentTypes?: boolean;
+    dryRun?: boolean;
 }
+export type PushConfigActionResult = Readonly<{
+    success: true;
+}> | Readonly<{
+    success: false;
+}>;
 type PushConfigResponse = NonNullable<APIEndpoints['pushSdkConfig']['response']>;
 type PushConfigSync = NonNullable<PushConfigResponse['configSync']>;
 type LegacyPushConfigSync = NonNullable<PushConfigResponse['sync']>;
 type PushConfigDisplaySync = PushConfigSync | LegacyPushConfigSync;
 type PushConfigSyncArea = 'contentTypes' | 'customBlocks' | 'templateBlocks' | 'settings' | 'ignoredDocuments' | 'pages' | 'entries' | 'navigationMenus';
-type PushConfigSyncMessage = {
+export type PushConfigSyncMessage = {
     area: PushConfigSyncArea;
     message: string;
 };
 export declare function collectPushConfigSyncErrors(sync: PushConfigDisplaySync): PushConfigSyncMessage[];
 export declare function collectPushConfigSyncWarnings(sync: PushConfigDisplaySync): PushConfigSyncMessage[];
+export declare function groupPushConfigSyncWarningsForHuman(warnings: readonly PushConfigSyncMessage[]): PushConfigSyncMessage[];
+export declare function isPushConfigActionSuccess(result: PushConfigActionResult): result is Extract<PushConfigActionResult, {
+    success: true;
+}>;
+export declare function markFailedPushConfigCommandResult(result: PushConfigActionResult): void;
 /**
  * Main push-config action.
  * Exported for reuse by `push --with-config`.
@@ -30,7 +41,7 @@ export declare function collectPushConfigSyncWarnings(sync: PushConfigDisplaySyn
 export declare function pushConfigAction(output: OutputContext, options: PushConfigOptions & {
     isRemote: boolean;
     isJsonOutput?: boolean;
-}): Promise<void>;
+}): Promise<PushConfigActionResult>;
 /**
  * push-config command definition
  */

package/dist/_dts/sdk/src/cli/setup/setupPlan.d.ts

@@ -0,0 +1,51 @@
+import type { EnvTarget } from '../helpers';
+export type SetupOperation = 'create_site' | 'create_management_key' | 'grant_user_access' | 'configure_env' | 'verify_access';
+export type SetupAuthority = 'dashboard_admin' | 'cms_repo_script' | 'sdk_management_key';
+export type SetupPlanStep = Readonly<{
+    tag: 'admin_action';
+    operation: Exclude<SetupOperation, 'configure_env' | 'verify_access'>;
+    title: string;
+    detail: string;
+    allowedAuthorities: readonly Exclude<SetupAuthority, 'sdk_management_key'>[];
+}> | Readonly<{
+    tag: 'local_env';
+    operation: 'configure_env';
+    title: string;
+    detail: string;
+    missingVariables: readonly string[];
+    exampleLines: readonly string[];
+}> | Readonly<{
+    tag: 'cli_check';
+    operation: 'verify_access';
+    title: string;
+    detail: string;
+    commands: readonly string[];
+}>;
+export type SetupCapability = Readonly<{
+    authority: 'dashboard_admin';
+    can: readonly ('create_site' | 'create_management_key' | 'grant_user_access')[];
+}> | Readonly<{
+    authority: 'cms_repo_script';
+    can: readonly ('create_site' | 'create_management_key' | 'grant_user_access')[];
+    requirement: string;
+}> | Readonly<{
+    authority: 'sdk_management_key';
+    can: readonly ('verify_access')[];
+    cannot: readonly ('create_site' | 'create_management_key' | 'grant_user_access')[];
+}>;
+export interface SetupTargetStatus {
+    target: EnvTarget;
+    siteId: string | null;
+    dashboardUrl: string | null;
+    managementApiKeySet: boolean;
+}
+export interface SdkSetupPlan {
+    target: EnvTarget;
+    configured: boolean;
+    canMutatePrivilegedResources: false;
+    capabilities: readonly SetupCapability[];
+    steps: readonly SetupPlanStep[];
+    securityNotes: readonly string[];
+}
+export declare function planSdkSetup(status: SetupTargetStatus): SdkSetupPlan;
+export declare function formatSdkSetupPlan(plan: SdkSetupPlan): string;

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

@@ -1,5 +1,6 @@
 import { type Result, type SiteId } from '../../../../core/src/index';
 import { type DryRunReport, type SiteCommandBatch, type SiteCommandExecutionSuccess, type SiteCommandOf, type SiteCommandPlanFor, type SiteCommandRef, type SiteCommandType, type SiteCommandValidationError } from '../../../../site-commands/src/index';
+import { type ManagementApiErrorRequest } from '../../client/management';
 import type { EnvTarget } from '../helpers';
 export type CliCommandBatchRefInput<TSource extends string = string> = Readonly<{
     source: TSource;
@@ -11,6 +12,22 @@ export type CliCommandExecutionError<TCommandType extends SiteCommandType> = Rea
     commandRef: SiteCommandRef;
     commandType: TCommandType;
     message: string;
+    detail?: CliCommandFailureDetail;
+}>;
+export type CliCommandFailureFieldError = Readonly<{
+    field: string;
+    message: string;
+    code?: string;
+}>;
+export type CliCommandFailureDetail = Readonly<{
+    tag: 'management_api';
+    code: string;
+    statusCode?: number;
+    request?: ManagementApiErrorRequest;
+    fieldErrors: readonly CliCommandFailureFieldError[];
+    details?: unknown;
+}> | Readonly<{
+    tag: 'unknown';
 }>;
 export type CliCommandExecutionResult<TCommandType extends SiteCommandType> = Readonly<{
     status: 'applied';
@@ -43,6 +60,7 @@ export type CliCommandReportedPlannedCommand<TCommand extends Readonly<{
 export type CliCommandExecutionReportFailure<TSubject> = Readonly<{
     identifier: string;
     message: string;
+    detail?: CliCommandFailureDetail;
     subject?: TSubject;
 }>;
 export type CliCommandOutcome<TSubject> = Readonly<{
@@ -56,6 +74,7 @@ export type CliCommandOutcome<TSubject> = Readonly<{
     commandType: SiteCommandType;
     identifier: string;
     message: string;
+    detail?: CliCommandFailureDetail;
     subject?: TSubject;
 }> | Readonly<{
     status: 'skipped_by_stop_policy';
@@ -97,6 +116,7 @@ export declare function createCliCommandBatchRef(input: CliCommandBatchRefInput)
 export declare function formatSiteCommandValidationErrors(errors: readonly {
     message: string;
 }[]): string;
+export declare function managementErrorDetail(error: unknown): CliCommandFailureDetail;
 export declare function formatManagementError(error: unknown): string;
 export declare function planCliCommandBatchForTypes<TCommandType extends SiteCommandType>(input: CliCommandBatchRefInput & Readonly<{
     commands: readonly SiteCommandOf<TCommandType>[];
@@ -126,6 +146,7 @@ export declare function commandExecutionToReport<TCommand extends Readonly<{
 export declare function commandCompileFailureToReport<TSubject>(input: Readonly<{
     identifier: string;
     message: string;
+    detail?: CliCommandFailureDetail;
     subject?: TSubject;
     warnings?: readonly string[];
 }>): CliCommandExecutionReport<TSubject>;

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

@@ -1,4 +1,9 @@
+import { createBearerAPIClient, createInternalAPIClient } from '../../../api/src/public/index';
 import type { RiverbankClient, RiverbankClientConfig } from './types';
+export type RiverbankClientDeps = Readonly<{
+    createBearerAPIClient: typeof createBearerAPIClient;
+    createInternalAPIClient: typeof createInternalAPIClient;
+}>;
 /**
  * Create a Riverbank CMS client for fetching content
  *
@@ -13,6 +18,7 @@ import type { RiverbankClient, RiverbankClientConfig } from './types';
  * ```
  */
 export declare function createRiverbankClient(config: RiverbankClientConfig): RiverbankClient;
+export declare function createRiverbankClientWithDeps(deps: RiverbankClientDeps, config: RiverbankClientConfig): RiverbankClient;
 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/runtimeCachePolicy.d.ts

@@ -34,7 +34,7 @@ export type ResolveRuntimeCachePolicyInput = Readonly<{
 }>;
 export declare function resolveRuntimeCachePolicy(input: ResolveRuntimeCachePolicyInput): RuntimeCachePolicy;
 export type GetSiteRuntimeCacheParams = Readonly<Pick<GetSiteParams, 'id' | 'slug' | 'domain' | 'currentPath' | 'force'>>;
-export type GetContentByPathRuntimeCacheParams = Readonly<Pick<GetPageParams, 'siteId' | 'path' | 'preview'>>;
+export type GetContentByPathRuntimeCacheParams = Readonly<Pick<GetPageParams, 'siteId' | 'path' | 'preview' | 'contentContract'>>;
 type KeyDeriverInputByEndpoint = Readonly<{
     getSite: GetSiteRuntimeCacheParams;
     getContentByPath: GetContentByPathRuntimeCacheParams;

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

@@ -1,6 +1,6 @@
-import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicCoursesResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, ResolveEntrySubrouteResponse, ResolveEventOccurrenceResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
+import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicCoursesResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, ResolveEntrySubrouteResponse, ResolveEventOccurrenceResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
 import type { PublishedRuntimeCacheAdapter, PublishedRuntimeCacheAdapterErrorKind } from './runtimeCachePolicy';
-export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicCoursesResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, ResolveEntrySubrouteResponse, ResolveEventOccurrenceResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
+export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicCoursesResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, ResolveEntrySubrouteResponse, ResolveEventOccurrenceResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -48,6 +48,7 @@ export type GetPageParams = {
     siteId: string;
     path: string;
     preview?: boolean;
+    contentContract?: 'compat' | 'native';
 } & SdkMethodOptions;
 /**
  * Base parameters for getEntries - shared across all overloads
@@ -456,6 +457,16 @@ export interface RiverbankClient {
         siteId: string;
         ids?: string;
     } & SdkMethodOptions): Promise<PublicBookingServicesResponse>;
+    /**
+     * Fetch public weekly appointment slot availability for a service.
+     */
+    getPublicWeeklySlotAvailability(params: {
+        siteId: string;
+        serviceId: string;
+        resourceId?: string;
+        horizonWeeks?: number;
+        timezone?: string;
+    } & SdkMethodOptions): Promise<PublicWeeklySlotAvailabilityResponse>;
     /**
      * List public events for a site (optionally time-filtered)
      */
@@ -609,6 +620,11 @@ export interface RiverbankClient {
         path: string;
         preview?: boolean;
     } & SdkMethodOptions): Promise<RouteOutcomeResponse>;
+    resolveRouteDecision(params: {
+        siteId: string;
+        path: string;
+        preview?: boolean;
+    } & SdkMethodOptions): Promise<RouteDecisionResponse>;
     /**
      * Get all published routes for a site.
      * Useful for static site generation (SSG) to enumerate all pages.

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

@@ -45,7 +45,7 @@ export type BlockCategory = 'marketing' | 'content' | 'blog' | 'media' | 'layout
  *
  * Re-exported from `@riverbankcms/blocks` (single source of truth).
  */
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
 export type SdkLoaderEndpoint = (typeof SUPPORTED_LOADER_ENDPOINTS)[number];
 export type LoaderParamBinding = {
     $bind: {

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -135,6 +135,7 @@ export declare const siteStyleConfigSchema: z.ZodOptional<z.ZodObject<{
 export declare const sdkLoaderEndpointSchema: z.ZodEnum<{
     getPublicFormById: "getPublicFormById";
     getPublicBookingServices: "getPublicBookingServices";
+    getPublicWeeklySlotAvailability: "getPublicWeeklySlotAvailability";
     listPublicEvents: "listPublicEvents";
     listPublicPasses: "listPublicPasses";
     listPublicCourses: "listPublicCourses";
@@ -223,6 +224,7 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
     endpoint: z.ZodEnum<{
         getPublicFormById: "getPublicFormById";
         getPublicBookingServices: "getPublicBookingServices";
+        getPublicWeeklySlotAvailability: "getPublicWeeklySlotAvailability";
         listPublicEvents: "listPublicEvents";
         listPublicPasses: "listPublicPasses";
         listPublicCourses: "listPublicCourses";
@@ -287,6 +289,7 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
     endpoint: z.ZodEnum<{
         getPublicFormById: "getPublicFormById";
         getPublicBookingServices: "getPublicBookingServices";
+        getPublicWeeklySlotAvailability: "getPublicWeeklySlotAvailability";
         listPublicEvents: "listPublicEvents";
         listPublicPasses: "listPublicPasses";
         listPublicCourses: "listPublicCourses";

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

@@ -6,20 +6,16 @@
  *
  * Runtime implementations are delegated to `@riverbankcms/blocks/bindings`.
  */
+import { type BindingTransformName as SharedBindingTransformName } from '../../../field-primitives/src/bindings/index';
 export type BindingSource = 'field' | 'meta' | 'literal' | 'transform' | 'fallback';
-/**
- * Keep in sync with:
- * - @riverbankcms/blocks `TRANSFORMS`
- * - @riverbankcms/content-model `TEMPLATE_BINDING_TRANSFORMS`
- */
 export declare const BINDING_TRANSFORMS: {
     readonly RICHTEXT_FIRST_PARAGRAPH: "richtext.firstParagraph";
     readonly DATE_FORMAT_SHORT: "date.formatShort";
     readonly DATE_FORMAT_LONG: "date.formatLong";
     readonly TEXT_INLINE_TEXT: "text.inlineText";
 };
-export type BindingTransformName = typeof BINDING_TRANSFORMS[keyof typeof BINDING_TRANSFORMS];
-export declare const BINDING_TRANSFORM_VALUES: [BindingTransformName, ...BindingTransformName[]];
+export type BindingTransformName = SharedBindingTransformName;
+export declare const BINDING_TRANSFORM_VALUES: [SharedBindingTransformName, ...SharedBindingTransformName[]];
 export declare const BINDING_TRANSFORM_LIST: string;
 export declare function describeInvalidBindingTransform(transform: string): string;
 export type BindingDescriptor = {

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

@@ -642,6 +642,18 @@ export type AppointmentBookingContent = {
     description?: unknown;
     _sectionStyles?: SectionStylesContent;
 };
+export type WeeklySlotAvailabilityContent = {
+    serviceId: string;
+    resourceId?: string | null;
+    horizonWeeks?: string | null;
+    timezone?: string | null;
+    heading?: string | null;
+    description?: unknown;
+    emptyMessage?: string | null;
+    ctaText?: string | null;
+    ctaUrl?: string | null;
+    _sectionStyles?: SectionStylesContent;
+};
 export type BlogPostContent = {
     title?: string | null;
     postSlug?: string | null;
@@ -708,6 +720,7 @@ export type SystemBlockContentByFullKind = {
     'block.form': FormBlockContent;
     'block.contact-newsletter': ContactNewsletterContent;
     'block.appointment-booking': AppointmentBookingContent;
+    'block.weekly-slot-availability': WeeklySlotAvailabilityContent;
     'block.event-registration': EventRegistrationContent;
     'block.event-details': EventDetailsContent;
     'block.course-registration': CourseRegistrationContent;

package/dist/_dts/sdk/src/data/prefetchBlockData.d.ts

@@ -4,7 +4,7 @@
  */
 import type { PageOutline } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
-import { SUPPORTED_LOADER_ENDPOINTS, type SupportedLoaderEndpoint } from '../../../blocks/src/system/data/index';
+import { prefetchBlockData as prefetchBlockDataCore, normalizeLoaderParams, SUPPORTED_LOADER_ENDPOINTS, type SupportedLoaderEndpoint } from '../../../blocks/src/system/data/index';
 import type { RiverbankClient } from '../client/types';
 export type PrefetchContext = {
     siteId?: string;
@@ -25,6 +25,10 @@ export type SdkPrefetchOptions = {
      */
     customBlocks?: SdkCustomBlock[];
 };
+export type PrefetchBlockDataDeps = Readonly<{
+    prefetchBlockDataCore: typeof prefetchBlockDataCore;
+    normalizeLoaderParams: typeof normalizeLoaderParams;
+}>;
 /**
  * Prefetch block data for SDK-based applications.
  * Maps loader endpoints to corresponding SDK client methods.
@@ -52,3 +56,4 @@ export type SdkPrefetchOptions = {
  * ```
  */
 export declare function prefetchBlockData(page: PageOutline, context: PrefetchContext, client: RiverbankClient, options?: SdkPrefetchOptions): Promise<ResolvedBlockData>;
+export declare function prefetchBlockDataWithDeps(deps: PrefetchBlockDataDeps, page: PageOutline, context: PrefetchContext, client: RiverbankClient, options?: SdkPrefetchOptions): Promise<ResolvedBlockData>;

package/dist/_dts/sdk/src/next/route-outcome-proxy.d.ts

@@ -1,13 +1,13 @@
 import { NextResponse, type NextRequest } from 'next/server';
 import type { RiverbankClient } from '../client/types';
-import type { RedirectHttpStatus, RouteOutcomeResponse } from '../public-api/contracts';
+import type { RouteDecisionResponse, RedirectHttpStatus } from '../public-api/contracts';
 export type RouteOutcomeRedirectFailureContext = Readonly<{
     siteId: string;
     path: string;
     preview: boolean;
 }>;
 export type HandleRouteOutcomeRedirectOptions = Readonly<{
-    client: Pick<RiverbankClient, 'resolveRouteOutcome'>;
+    client: Pick<RiverbankClient, 'resolveRouteDecision'>;
     siteId: string;
     onFailure?: (error: unknown, context: RouteOutcomeRedirectFailureContext) => void;
 }>;
@@ -18,5 +18,5 @@ export type RouteOutcomeRedirectPlan = Readonly<{
     destination: string;
     status: RedirectHttpStatus;
 }>;
-export declare function planRouteOutcomeRedirect(outcome: RouteOutcomeResponse): RouteOutcomeRedirectPlan;
+export declare function planRouteOutcomeRedirect(outcome: RouteDecisionResponse): RouteOutcomeRedirectPlan;
 export declare function handleRouteOutcomeRedirect(request: NextRequest, options: HandleRouteOutcomeRedirectOptions): Promise<NextResponse | null>;

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

@@ -32,6 +32,14 @@ export interface CatchAllContext {
     /** Search parameters from the URL (for filtering, pagination, etc.) */
     searchParams: Record<string, string | string[] | undefined>;
 }
+export type CreateCatchAllContentContract = 'compat' | 'native';
+export type CreateCatchAllContentContractResolverContext = Readonly<{
+    /** Resolved URL path being loaded, e.g. '/about'. */
+    path: string;
+    /** Whether preview mode is enabled for this catch-all instance. */
+    preview: boolean;
+}>;
+export type CreateCatchAllContentContractSelector = CreateCatchAllContentContract | ((context: CreateCatchAllContentContractResolverContext) => CreateCatchAllContentContract);
 /**
  * Configuration for runtime theme switching when `themes` is provided.
  *
@@ -179,6 +187,17 @@ export type CreateCatchAllPageOptions = {
      * ```
      */
     preview?: boolean;
+    /**
+     * Selects the public content API contract used by the catch-all loader.
+     *
+     * Defaults to `compat`, preserving the long-standing page/entry response
+     * shape. Use `native` only after the target site and route are ready to
+     * receive native page-surface payloads. A resolver can opt in route-by-route
+     * during staged rollouts.
+     *
+     * @default 'compat'
+     */
+    contentContract?: CreateCatchAllContentContractSelector;
     /**
      * Custom block component overrides for rendering.
      * Keys can be full block kind ("block.hero") or short form ("hero").

package/dist/_dts/sdk/src/prebuild/loader.d.ts

@@ -10,6 +10,8 @@ export interface PrebuildLoaderConfig {
     prebuildDir: string;
     /** Maximum age in seconds for prebuild cache */
     maxPrebuildAgeSec?: number;
+    /** Filesystem adapter for tests and non-standard runtimes. */
+    fileSystem?: PrebuildFileSystem;
 }
 export interface LoadResult<T> {
     /** Loaded data */
@@ -17,11 +19,15 @@ export interface LoadResult<T> {
     /** Age of prebuild in seconds */
     prebuildAgeSec: number;
 }
+export interface PrebuildFileSystem {
+    existsSync(filePath: string): boolean;
+    readFileSync(filePath: string, encoding: 'utf-8'): string;
+}
 /**
  * Check if we're running in a Node.js environment with filesystem access.
  * Edge runtimes (Vercel Edge, Cloudflare Workers) don't have fs access.
  */
-export declare function canUsePrebuild(): boolean;
+export declare function canUsePrebuild(fileSystem?: PrebuildFileSystem): boolean;
 /**
  * Loader for reading data from the prebuild cache.
  *
@@ -31,6 +37,7 @@ export declare function canUsePrebuild(): boolean;
 export declare class PrebuildLoader {
     private readonly prebuildDir;
     private readonly maxPrebuildAgeSec;
+    private readonly fileSystem;
     constructor(config: PrebuildLoaderConfig);
     /**
      * Check if prebuild is available and not expired.