@riverbankcms/sdk 0.96.0 → 0.98.0

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

@@ -2,6 +2,7 @@ import type { SiteId } from '../../../../../../core/src/index';
 import { type FieldChange, type JsonDiffMode } from '../../../sync';
 import { type CliDatedOfferingCommandBatchSource, type CliDatedOfferingCommandCompileInput, type DatedOfferingReportSubject, type DatedOfferingUpsertItem } from '../../../site-commands';
 import type { WriterOptions } from '../../../content/writer';
+import type { ContentMetadataTarget } from '../../../content/metadataStore';
 import type { PushScopeResult, ScopePushContext } from './types';
 import type { LocalMediaPushReport } from '../../../media/local-sync';
 type CommandBackedDatedOfferingScopeConfig<TLocal, TRemote> = Readonly<{
@@ -13,7 +14,7 @@ type CommandBackedDatedOfferingScopeConfig<TLocal, TRemote> = Readonly<{
     getDisplayLabel: (item: TLocal) => string;
     shouldPushItem?: (item: TLocal) => boolean;
     readLocal: (contentDir: string) => Promise<TLocal[]>;
-    readMeta: (contentDir: string) => Promise<Record<string, {
+    readMeta: (contentDir: string, metadataTarget?: ContentMetadataTarget) => Promise<Record<string, {
         updatedAt?: string;
     }> | null>;
     fetchRemote: () => Promise<TRemote[]>;

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

@@ -5,12 +5,14 @@ import type { SiteId } from '../../../../../../core/src/index';
 import type { EnvTarget } from '../../../helpers';
 import type { JsonDiffMode } from '../../../sync';
 import type { LocalMediaPushReport } from '../../../media/local-sync';
+import type { ContentMetadataTarget } from '../../../content/metadataStore';
 export type PushMediaPolicy = 'require' | 'allow-missing';
 export interface ScopePushContext {
     output: OutputContext;
     contentDir: string;
     siteId: SiteId;
     targetEnv: EnvTarget;
+    metadataTarget: ContentMetadataTarget;
     client: ManagementClient;
     dryRun: boolean;
     force: boolean;
@@ -60,7 +62,7 @@ export interface PushScopeConfig<TLocal, TRemote> {
     /** Read local items from content directory */
     readLocal: (contentDir: string) => Promise<TLocal[]>;
     /** Read local metadata for stale detection */
-    readMeta: (contentDir: string) => Promise<Record<string, {
+    readMeta: (contentDir: string, metadataTarget?: ContentMetadataTarget) => Promise<Record<string, {
         updatedAt?: string;
     }> | null>;
     /** Fetch remote items */

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

@@ -1,3 +1,4 @@
+import { type ContentMetadataTarget } from '../../content/metadataStore';
 import type { OutputContext } from '../../output';
 import type { PulledContent } from '../../../client/management/types';
 import type { StaleItem } from './stale';
@@ -18,7 +19,7 @@ export declare function resolveStaleOrAbort(opts: {
     yes: boolean;
 }): Promise<'resolve' | 'abort'>;
 /**
- * Write only the stale entries/pages/navigation/forms from the already-fetched
+ * Write only the stale entries/pages/navigation/forms/settings from the already-fetched
  * remoteContent to disk and update their metadata. Non-stale local content is
  * preserved — we only touch the specific items identified as stale.
  *
@@ -29,14 +30,19 @@ export declare function resolveStaleOrAbort(opts: {
  */
 export declare function writeStaleItems(contentDir: string, remoteContent: PulledContent, staleItems: StaleItem[], output: OutputContext, options?: {
     skipMeta?: boolean;
+    metadataTarget?: ContentMetadataTarget;
 }): Promise<void>;
 /**
  * Update only the theme metadata timestamp without touching the theme content file.
  * Used when the local theme IS the content being pushed — we just need to acknowledge
  * the remote is newer so stale detection passes on the next push.
  */
-export declare function updateStaleThemeMeta(contentDir: string, themeName: string, remoteUpdatedAt: string): Promise<void>;
+export declare function updateStaleThemeMeta(contentDir: string, themeName: string, remoteUpdatedAt: string, options?: {
+    metadataTarget?: ContentMetadataTarget;
+}): Promise<void>;
 /**
  * Update only the footer metadata timestamp without touching the footer content file.
  */
-export declare function updateStaleFooterMeta(contentDir: string, remoteUpdatedAt: string): Promise<void>;
+export declare function updateStaleFooterMeta(contentDir: string, remoteUpdatedAt: string, options?: {
+    metadataTarget?: ContentMetadataTarget;
+}): Promise<void>;

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

@@ -0,0 +1,34 @@
+import type { PushScope } from './consts';
+export type PushWorkflowStep = Readonly<{
+    tag: 'config';
+    mode: 'apply';
+}> | Readonly<{
+    tag: 'content';
+}>;
+export type PushWorkflowPreContentStep = Extract<PushWorkflowStep, {
+    tag: 'config';
+}>;
+export type PushWorkflowPlan = Readonly<{
+    steps: readonly PushWorkflowStep[];
+    warnings: readonly PushWorkflowWarning[];
+}>;
+export type PushWorkflowWarning = Readonly<{
+    tag: 'with_config_ignored_for_scope';
+    pushScope: PushScope;
+}>;
+export type PlanPushWorkflowInput = Readonly<{
+    pushScope: PushScope;
+    withConfig: boolean;
+    dryRun: boolean;
+}>;
+export declare function planPushWorkflow(input: PlanPushWorkflowInput): PushWorkflowPlan;
+export declare function shouldApplyConfigBeforeContent(plan: PushWorkflowPlan): boolean;
+export declare function preContentWorkflowSteps(plan: PushWorkflowPlan): readonly PushWorkflowPreContentStep[];
+export type PushWorkflowPreContentHandlers = Readonly<{
+    [TStep in PushWorkflowPreContentStep as TStep['tag']]: (step: TStep) => Promise<boolean>;
+}>;
+export declare function runPushWorkflowPreContentSteps(plan: PushWorkflowPlan, handlers: PushWorkflowPreContentHandlers): Promise<Readonly<{
+    success: true;
+}> | Readonly<{
+    success: false;
+}>>;

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const setupCommand: Command;

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

@@ -4,6 +4,7 @@
  * Loads riverbank.config.ts and extracts CLI-relevant configuration
  * (contentDir and sync settings) with appropriate defaults.
  */
+import type { EnvTarget } from './helpers';
 import type { SyncConfig, BlockFieldExtensionsMap, SdkCustomBlock } from '../config/types';
 /**
  * Loaded CLI configuration with defaults applied.
@@ -36,6 +37,7 @@ export interface LoadedCliConfig {
  * ```
  */
 export declare function loadCliConfig(configPath?: string): Promise<LoadedCliConfig>;
+export declare function loadCliConfigForEnv(target: EnvTarget, configPath?: string): Promise<LoadedCliConfig>;
 /**
  * Check if a CLI config file exists.
  *

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

@@ -0,0 +1,29 @@
+import type { SdkEnvironment } from '../env';
+export type ContentMetadataEnv = 'local' | 'remote';
+export type ContentMetadataTarget = Readonly<{
+    env: ContentMetadataEnv;
+    siteId: string;
+    dashboardUrl: string;
+}>;
+export type ContentMetadataReadPath = Readonly<{
+    path: string;
+    source: 'scoped' | 'legacy';
+}>;
+export declare function metadataTargetFromEnvironment(env: ContentMetadataEnv, environment: Pick<SdkEnvironment, 'siteId' | 'dashboardUrl'>): ContentMetadataTarget;
+export declare function legacyMetadataDir(contentDir: string): string;
+export declare function scopedMetadataDir(contentDir: string, target: ContentMetadataTarget): string;
+export declare function metadataFilePath(contentDir: string, fileName: string, target?: ContentMetadataTarget): string;
+export declare function legacyMetadataFilePath(contentDir: string, fileName: string): string;
+export declare function ensureMetadataDir(contentDir: string, target?: ContentMetadataTarget): Promise<string>;
+export declare function writeMetadataFile(contentDir: string, fileName: string, value: unknown, target?: ContentMetadataTarget): Promise<string>;
+export declare function readMetadataFile<T>(contentDir: string, fileName: string, target?: ContentMetadataTarget): Promise<T | null>;
+export declare function listMetadataFiles(contentDir: string, target?: ContentMetadataTarget): Promise<string[]>;
+export declare function writeMetadataRecordMap<TRecord>(contentDir: string, fileName: string, recordKey: string, next: Readonly<{
+    pulledAt: string;
+    records: Readonly<Record<string, TRecord>>;
+    extra?: Readonly<Record<string, unknown>>;
+}>, options?: Readonly<{
+    mode?: 'replace' | 'merge';
+    target?: ContentMetadataTarget;
+}>): Promise<string>;
+export declare function resolveMetadataReadPath(contentDir: string, fileName: string, target?: ContentMetadataTarget): Promise<ContentMetadataReadPath | null>;

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

@@ -4,6 +4,7 @@
  * Reads content from the file system for push operations.
  * Mirrors the structure created by writer.ts.
  */
+import { type ContentMetadataTarget } from './metadataStore';
 import type { NavigationAuthoringLinkInput, NavigationLocalItemInput } from '../../../../api/src/navigation';
 import type { SdkEventPricingInput } from '../../../../api/src/sdk-event-pricing';
 import type { EventPaymentTermsInput } from '../../client/management/types';
@@ -233,7 +234,7 @@ export declare function findLegacyEntryFiles(contentDir: string): Promise<string
  * @param contentType - Optional specific content type to read
  * @returns Map of content type to entries
  */
-export declare function readEntries(contentDir: string, contentType?: string): Promise<Map<string, LocalEntry[]>>;
+export declare function readEntries(contentDir: string, contentType?: string, metadataTarget?: ContentMetadataTarget): Promise<Map<string, LocalEntry[]>>;
 /**
  * Read pages from content directory
  *
@@ -350,7 +351,7 @@ export interface LocalContent {
     events: LocalEvent[];
     courses: LocalCourse[];
 }
-export declare function readAllContent(contentDir: string): Promise<LocalContent>;
+export declare function readAllContent(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<LocalContent>;
 /**
  * Check if content directory exists and has content
  */
@@ -387,6 +388,7 @@ export interface EntryMetadata {
         createdAt?: string;
         updatedAt?: string;
         publishedAt?: string;
+        hasUnpublishedChanges?: boolean;
     }>;
 }
 export interface PagesMetadata {
@@ -414,35 +416,35 @@ export interface SettingsMetadata {
  * @param contentType - Content type to read metadata for
  * @returns Metadata or null if not found
  */
-export declare function readEntriesMeta(contentDir: string, contentType: string): Promise<EntryMetadata | null>;
+export declare function readEntriesMeta(contentDir: string, contentType: string, metadataTarget?: ContentMetadataTarget): Promise<EntryMetadata | null>;
 /**
  * Read all entry metadata files from .meta/ directory
  *
  * @param contentDir - Base content directory
  * @returns Map of content type to metadata
  */
-export declare function readAllMeta(contentDir: string): Promise<Map<string, EntryMetadata>>;
+export declare function readAllMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): 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>;
+export declare function readSettingsMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<SettingsMetadata | null>;
 /**
  * Read pages metadata from .meta/pages.json
  *
  * @param contentDir - Base content directory
  * @returns Pages metadata or null if not found
  */
-export declare function readPagesMeta(contentDir: string): Promise<PagesMetadata | null>;
+export declare function readPagesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<PagesMetadata | null>;
 /**
  * Read navigation metadata from .meta/navigation.json
  *
  * @param contentDir - Base content directory
  * @returns Navigation metadata or null if not found
  */
-export declare function readNavigationMeta(contentDir: string): Promise<NavigationMetadata | null>;
+export declare function readNavigationMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<NavigationMetadata | null>;
 export interface FormsMetadata {
     pulledAt: string;
     forms: Record<string, {
@@ -456,7 +458,7 @@ export interface FormsMetadata {
  * @param contentDir - Base content directory
  * @returns Forms metadata or null if not found
  */
-export declare function readFormsMeta(contentDir: string): Promise<FormsMetadata | null>;
+export declare function readFormsMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<FormsMetadata | null>;
 export interface ThemesMetadata {
     pulledAt: string;
     themes: Record<string, {
@@ -471,7 +473,7 @@ export interface ThemesMetadata {
  * @param contentDir - Base content directory
  * @returns Themes metadata or null if not found
  */
-export declare function readThemesMeta(contentDir: string): Promise<ThemesMetadata | null>;
+export declare function readThemesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<ThemesMetadata | null>;
 export interface VenuesMetadata {
     pulledAt: string;
     venues: Record<string, {
@@ -485,7 +487,7 @@ export interface VenuesMetadata {
  * @param contentDir - Base content directory
  * @returns Venues metadata or null if not found
  */
-export declare function readVenuesMeta(contentDir: string): Promise<VenuesMetadata | null>;
+export declare function readVenuesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<VenuesMetadata | null>;
 export interface EventCategoriesMetadata {
     pulledAt: string;
     eventCategories: Record<string, {
@@ -499,7 +501,7 @@ export interface EventCategoriesMetadata {
  * @param contentDir - Base content directory
  * @returns Event categories metadata or null if not found
  */
-export declare function readEventCategoriesMeta(contentDir: string): Promise<EventCategoriesMetadata | null>;
+export declare function readEventCategoriesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<EventCategoriesMetadata | null>;
 export interface EventsMetadata {
     pulledAt: string;
     events: Record<string, {
@@ -520,14 +522,14 @@ export interface CoursesMetadata {
  * @param contentDir - Base content directory
  * @returns Events metadata or null if not found
  */
-export declare function readEventsMeta(contentDir: string): Promise<EventsMetadata | null>;
+export declare function readEventsMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<EventsMetadata | null>;
 /**
  * Read courses metadata from .meta/courses.json
  *
  * @param contentDir - Base content directory
  * @returns Courses metadata or null if not found
  */
-export declare function readCoursesMeta(contentDir: string): Promise<CoursesMetadata | null>;
+export declare function readCoursesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<CoursesMetadata | null>;
 export interface FooterMetadata {
     pulledAt: string;
     updatedAt?: string;
@@ -538,4 +540,4 @@ export interface FooterMetadata {
  * @param contentDir - Base content directory
  * @returns Footer metadata or null if not found
  */
-export declare function readFooterMeta(contentDir: string): Promise<FooterMetadata | null>;
+export declare function readFooterMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<FooterMetadata | null>;

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

@@ -5,17 +5,19 @@
  */
 import type { PulledEntries, PulledPages, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledFooter, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses } from '../../client/management/types';
 import type { Theme } from '../../contracts';
-import { type PulledEntryOutput } from '../helpers';
+import { type EntryForOutput } from '../helpers';
 import type { EntryBaseSnapshotTarget } from '../merge-remote/entrySnapshots';
 import type { PageBaseSnapshotTarget } from '../merge-remote/pageSnapshots';
+import { type ContentMetadataTarget } from './metadataStore';
 export interface WriterOptions {
     skipMeta?: boolean;
     cleanupMissing?: boolean;
+    metadataTarget?: ContentMetadataTarget;
     entryBaseSnapshot?: EntryBaseSnapshotTarget;
     pageBaseSnapshot?: PageBaseSnapshotTarget;
 }
 type WritablePulledEntries = Omit<PulledEntries, 'entries'> & {
-    entries: PulledEntryOutput[];
+    entries: EntryForOutput[];
 };
 /**
  * Write entries to content directory
@@ -92,7 +94,7 @@ export declare function writeThemesMeta(contentDir: string, meta: {
         selectionId: string;
         updatedAt: string;
     }>;
-}): Promise<void>;
+}, options?: Pick<WriterOptions, 'metadataTarget'>): Promise<void>;
 /**
  * Write a pulled theme to content directory with metadata
  *
@@ -207,7 +209,7 @@ export declare function updateMetadataAfterPush(contentDir: string, remoteConten
         updatedAt: string;
         createdAt?: string;
     }>;
-}): Promise<void>;
+}, options?: Pick<WriterOptions, 'metadataTarget'>): Promise<void>;
 export declare function writeAllContent(contentDir: string, content: {
     entries: Record<string, PulledEntries['entries']>;
     pages: PulledPages;

package/dist/_dts/sdk/src/cli/env-scope.d.ts

@@ -0,0 +1,2 @@
+import type { EnvTarget } from './helpers';
+export declare function withRiverbankEnv<T>(target: EnvTarget, run: () => Promise<T>): Promise<T>;

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

@@ -85,17 +85,16 @@ export interface ParsedPagination {
  */
 export type RowFormatter<T> = (item: T) => string[];
 /**
- * Entry format for SDK pull operations.
- * Matches the server-side PulledEntry type.
+ * Entry format written to content/entries/*.json.
+ * Operational fields such as manual ordering and unpublished state live in
+ * metadata so entry files remain authoring-focused.
  */
-export interface PulledEntryOutput {
+export interface EntryContentFileOutput {
     identifier: string;
     data: Record<string, unknown>;
     status: 'draft' | 'published';
-    hasUnpublishedChanges: boolean;
     /** Slug for URL routing - only present for routable content types */
     slug?: string;
-    manualOrder?: number;
     blocks?: Record<string, Array<{
         identifier: string | null;
         kind: string;
@@ -114,9 +113,9 @@ export interface EntryForOutput {
     slug?: string;
     title?: string;
     manualOrder?: number;
-    blocks?: PulledEntryOutput['blocks'];
+    blocks?: EntryContentFileOutput['blocks'];
 }
-export declare function mapEntryForOutput<T extends EntryForOutput>(entry: T): PulledEntryOutput;
+export declare function mapEntryForOutput<T extends EntryForOutput>(entry: T): EntryContentFileOutput;
 /**
  * Parse pagination options from command flags.
  *

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

@@ -1,5 +1,6 @@
 import { type SiteId } from '../../../../core/src/index';
 import type { ManagementClient } from '../../client/management/types';
+import type { ContentMetadataTarget } from '../content/metadataStore';
 import type { LocalEntry } from '../content/reader';
 import type { EnvTarget } from '../helpers';
 import type { OutputContext } from '../output';
@@ -12,6 +13,7 @@ export declare function planAndReportRemoteEntryMerge(input: Readonly<{
     contentDir: string;
     target: EnvTarget;
     siteId: SiteId;
+    metadataTarget: ContentMetadataTarget;
     contentType?: string;
     identifier?: string;
     localEntries: ReadonlyMap<string, readonly LocalEntry[]>;

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

@@ -1,5 +1,6 @@
 import type { SiteId } from '../../../../core/src/index';
 import type { ManagementClient } from '../../client/management/types';
+import type { ContentMetadataTarget } from '../content/metadataStore';
 import type { LocalPage } from '../content/reader';
 import type { EnvTarget } from '../helpers';
 import type { OutputContext } from '../output';
@@ -12,6 +13,7 @@ export declare function planAndReportRemotePageMerge(input: Readonly<{
     contentDir: string;
     target: EnvTarget;
     siteId: SiteId;
+    metadataTarget: ContentMetadataTarget;
     identifier?: string;
     localPages: readonly LocalPage[];
     dryRun: boolean;

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/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: {