@riverbankcms/sdk 0.77.0 → 0.78.0

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/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/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
  */
@@ -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/contracts/theme.d.ts

@@ -7,7 +7,7 @@
  */
 export type Theme = {
     header?: {
-        variant?: 'classic' | 'centered' | 'transparent' | 'floating' | 'editorial';
+        variant?: 'classic' | 'centered' | 'transparent' | 'floating';
         [key: string]: unknown;
     };
     footer?: {

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;

package/dist/_dts/sdk/src/next/content-load-failure.d.ts

@@ -0,0 +1,51 @@
+export { RiverbankContentLoadError } from '../routing/resolvePageContent';
+import { RiverbankContentLoadError } from '../routing/resolvePageContent';
+export type SdkContentLoadFailureKind = 'timeout' | 'network' | 'http_5xx' | 'http_non_404' | 'circuit_open' | 'aborted' | 'unknown';
+export type SdkContentLoadNotFound = Readonly<{
+    kind: 'not_found';
+    status: 404;
+    message: string;
+    upstreamCode?: string;
+    requestId?: string;
+}>;
+export type SdkContentLoadFailure = Readonly<{
+    kind: SdkContentLoadFailureKind;
+    message: string;
+    status?: number;
+    upstreamCode?: string;
+    requestId?: string;
+    retryAfterMs?: number;
+}>;
+export type ClassifiedContentLoadError = SdkContentLoadNotFound | Readonly<{
+    kind: 'upstream_failed';
+    failure: SdkContentLoadFailure;
+}>;
+export type CatchAllRequestContext = Readonly<{
+    host?: string;
+    requestId?: string;
+    correlationId?: string;
+    monitorRunId?: string;
+}>;
+export type CatchAllContentLoadFailureContext = Readonly<{
+    siteId: string;
+    path: string;
+    preview: boolean;
+    sdkVersion: string;
+    failure: SdkContentLoadFailure;
+    requestContext?: CatchAllRequestContext;
+}>;
+export type SdkContentLoadError = RiverbankContentLoadError & {
+    readonly context: CatchAllContentLoadFailureContext;
+};
+export declare const SdkContentLoadError: typeof RiverbankContentLoadError;
+export declare function isSdkContentLoadError(error: unknown): error is SdkContentLoadError;
+export declare function classifyContentLoadError(error: unknown): ClassifiedContentLoadError;
+export declare function createSdkContentLoadError(input: {
+    siteId: string;
+    path: string;
+    preview: boolean;
+    failure: SdkContentLoadFailure;
+    requestContext?: CatchAllRequestContext;
+    cause?: unknown;
+}): SdkContentLoadError;
+export declare function toContentLoadFailureLogFields(error: SdkContentLoadError): Record<string, string | number | boolean | undefined>;

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

@@ -38,9 +38,10 @@
  * @packageDocumentation
  */
 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 { createSitemap, type CreateSitemapOptions, type SitemapGenerator } from './sitemap';
+export { createSitemap, type CreateSitemapOptions, type SitemapGenerator, } from './sitemap';
 export { createRobots, type CreateRobotsOptions } from './robots';
 /**
  * ISR revalidation duration in seconds for production mode.

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

@@ -11,6 +11,7 @@ import type { Theme } from '../contracts';
 import type { BlockOverrideRegistrations } from '../rendering/overrides';
 import type { Metadata } from '../metadata/generatePageMetadata';
 import type { LoadContentResult } from '../rendering/helpers/loadContent';
+import type { CatchAllContentLoadFailureContext, CatchAllRequestContext } from './content-load-failure';
 /**
  * Context passed to escape hatch callbacks.
  */
@@ -219,6 +220,24 @@ export type CreateCatchAllPageOptions = {
      * ```
      */
     beforeRender?: (context: CatchAllContext) => ReactNode | null | Promise<ReactNode | null>;
+    /**
+     * Optional per-request context used for SDK content-load failure logs.
+     *
+     * The SDK does not call Next's `headers()` automatically because that would
+     * change caching/dynamic behavior for all consumers. If you need host,
+     * request ID, correlation ID, or monitor run ID in failure logs, pass them
+     * through this hook from your app router page.
+     */
+    getRequestContext?: () => CatchAllRequestContext | Promise<CatchAllRequestContext>;
+    /**
+     * Optional escape hatch for upstream CMS/API failures while loading content.
+     *
+     * By default, `createCatchAllPage()` throws `RiverbankContentLoadError`
+     * for timeout/network/5xx/circuit-open failures so they cannot be mistaken
+     * for content 404s. Return a React node here only if your site deliberately
+     * wants to render a custom temporary-unavailable UI for those failures.
+     */
+    onContentLoadFailure?: (context: CatchAllContentLoadFailureContext) => ReactNode | undefined | Promise<ReactNode | undefined>;
     /**
      * Custom metadata generator. If provided, replaces default metadata generation.
      *

package/dist/_dts/sdk/src/portal/redirects.d.ts

@@ -1,4 +1,4 @@
-import { type SafeAppPath } from '@riverbankcms/path-utils';
+import { type SafeAppPath } from '../../../path-utils/src/index';
 type RedirectOptions = {
     defaultRedirectPath?: string;
     redirectPath?: string;

package/dist/_dts/sdk/src/rendering/components/Layout.d.ts

@@ -29,7 +29,7 @@ export type LayoutProps = {
     children: React.ReactNode;
     header?: boolean | ((data: HeaderData) => React.ReactNode);
     footer?: boolean | ((data: FooterData) => React.ReactNode);
-    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating' | 'editorial';
+    headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating';
     /**
      * Whether the current request has an active portal session.
      * Used to resolve portal navigation labels (e.g. "Login" vs "My account").
@@ -58,7 +58,7 @@ export type LayoutProps = {
  * the strict `@riverbankcms/sdk/rendering/server` surface stays bootstrap-free.
  * If a custom host renders hydratable CMS islands through the strict server
  * surface, mount `BlocksIslandsHydrator` from
-   * `@riverbankcms/sdk/rendering/islands` explicitly.
+ * `@riverbankcms/sdk/rendering/islands` explicitly.
  *
  * @example With pre-fetched site data (recommended)
  * ```tsx

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

@@ -9,11 +9,12 @@ export { getContentEntryPrefixes, getContentEntryPrefixesFromContentTypes, isCon
 export type { ContentEntryMatch } from './contentRoutes';
 export { toRoutingInfo } from './contentTypeResolver';
 export type { ContentTypeRoutingInfo } from './contentTypeResolver';
-export { isISODateString, isUUID, isValidSegment, } from './segmentValidators';
+export { isISODateString, isUUID, isValidSegment } from './segmentValidators';
 export { detectEntrySubrouteFromTypes, extractPotentialEntrySubroute, defaultShouldAttemptEntrySubroute, inferKnownEntrySubrouteKind, } from './entrySubroutes';
 export type { EntrySubrouteCandidate, ShouldAttemptEntrySubrouteArgs, KnownEntrySubrouteKind, } from './entrySubroutes';
 export { resolvePageContent } from './resolvePageContent';
-export type { OccurrenceData, EntrySubrouteData, ResolvePageContentOptions, PageResolutionResult, } from './resolvePageContent';
+export { contentFound, contentLoadFailed, contentNotFound, RiverbankContentLoadError, } from './resolvePageContent';
+export type { OccurrenceData, EntrySubrouteData, LoadContentResult, PublicContentLoadError, PublicLoadStage, ResolvePageContentOptions, PageResolutionResult, RiverbankContentLoadErrorOptions, } from './resolvePageContent';
 export { resolveEntrySubrouteFromSegment } from './resolveEntrySubroute';
 export type { ResolveEntrySubrouteParams } from './resolveEntrySubroute';
 export { checkRedirectForPath } from './checkRedirect';

package/dist/_dts/sdk/src/routing/resolvePageContent.d.ts

@@ -22,6 +22,61 @@ export type EntrySubrouteData = {
     kind: 'course-run';
     run: CourseRunData;
 };
+export type PublicLoadStage = 'site_lookup' | 'content_lookup' | 'entry_subroute_lookup' | 'redirect_lookup' | 'content_normalization';
+export type PublicContentLoadError = {
+    kind: 'timeout';
+    stage: PublicLoadStage;
+    message: string;
+    requestId?: string | null;
+} | {
+    kind: 'network';
+    stage: PublicLoadStage;
+    message: string;
+    code?: string | null;
+    requestId?: string | null;
+} | {
+    kind: 'api_error';
+    stage: PublicLoadStage;
+    status: number;
+    message: string;
+    code?: string | null;
+    requestId?: string | null;
+} | {
+    kind: 'invalid_payload';
+    stage: PublicLoadStage;
+    message: string;
+    requestId?: string | null;
+} | {
+    kind: 'unknown';
+    stage: PublicLoadStage;
+    message: string;
+    requestId?: string | null;
+};
+export type RiverbankContentLoadErrorOptions = Readonly<{
+    surface: string;
+    reason?: string | null;
+    path?: string | null;
+    cause?: unknown;
+}>;
+export declare class RiverbankContentLoadError extends Error {
+    readonly surface: string;
+    readonly reason: string | null;
+    readonly path: string | null;
+    readonly cause?: unknown;
+    constructor(message: string, options: RiverbankContentLoadErrorOptions);
+}
+export type LoadContentResult<TContent> = {
+    kind: 'found';
+    content: TContent;
+} | {
+    kind: 'not_found';
+} | {
+    kind: 'failed';
+    error: PublicContentLoadError;
+};
+export declare function contentFound<TContent>(content: TContent): LoadContentResult<TContent>;
+export declare function contentNotFound<TContent>(): LoadContentResult<TContent>;
+export declare function contentLoadFailed<TContent>(error: PublicContentLoadError): LoadContentResult<TContent>;
 /**
  * Options for resolving page content.
  *
@@ -35,13 +90,14 @@ export interface ResolvePageContentOptions<TContent> {
     /**
      * Load content by path.
      *
-     * **Contract:** MUST return null for not-found (not throw).
-     * Callers should wrap their client to normalize exceptions.
+     * **Contract:** MUST return a closed result that distinguishes not-found
+     * from upstream failure. Callers should wrap their client to normalize
+     * exceptions before they reach this routing helper.
      *
      * @param path - The path to load
-     * @returns Content if found, null if not found
+     * @returns Content load result
      */
-    loadContent: (path: string) => Promise<TContent | null>;
+    loadContent: (path: string) => Promise<LoadContentResult<TContent>>;
     /**
      * Resolve occurrence by entry ID and segment.
      *
@@ -99,6 +155,14 @@ export type PageResolutionResult<TContent> = {
     found: false;
     /** Reason for not finding content */
     reason: 'not-found' | 'invalid-subroute';
+} | {
+    /** Content could not be loaded due to an upstream failure */
+    found: false;
+    reason: 'load-failed';
+    /** The path whose content load failed */
+    failedPath: string;
+    /** Normalized load failure */
+    error: PublicContentLoadError;
 };
 /**
  * Resolve page content for a given path.
@@ -112,8 +176,9 @@ export type PageResolutionResult<TContent> = {
  *
  * ## Error Handling
  *
- * The `loadContent` function MUST return `null` for not-found, not throw.
- * SDK callers should wrap their client to catch and normalize exceptions.
+ * The `loadContent` function MUST return `not_found` for absence and `failed`
+ * for upstream errors. SDK callers should wrap their client to catch and
+ * normalize exceptions.
  *
  * @template TContent - The content type
  * @param options - Resolution options with injected loaders

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.77.0";
+export declare const SDK_VERSION = "0.78.0";

package/dist/_dts/site-commands/src/commands.d.ts

@@ -190,8 +190,8 @@ export declare const upsertNavigationMenuCommandSchema: z.ZodObject<{
     input: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         location: z.ZodOptional<z.ZodEnum<{
-            footer: "footer";
             header: "header";
+            footer: "footer";
             main: "main";
         }>>;
         role: z.ZodOptional<z.ZodEnum<{
@@ -409,9 +409,9 @@ export declare const upsertEventSeriesCommandSchema: z.ZodObject<{
         }>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
-            cancelled: "cancelled";
             draft: "draft";
             archived: "archived";
+            cancelled: "cancelled";
         }>>;
         visibility: z.ZodEnum<{
             draft: "draft";
@@ -533,8 +533,8 @@ export declare const upsertCourseCommandSchema: z.ZodObject<{
         title: z.ZodString;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
-            cancelled: "cancelled";
             draft: "draft";
+            cancelled: "cancelled";
         }>>;
         visibility: z.ZodEnum<{
             draft: "draft";
@@ -723,8 +723,8 @@ export declare const grantCustomerPassCommandSchema: z.ZodObject<{
         expiresAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         status: z.ZodDefault<z.ZodEnum<{
             active: "active";
-            refunded: "refunded";
             expired: "expired";
+            refunded: "refunded";
             exhausted: "exhausted";
         }>>;
         note: z.ZodOptional<z.ZodString>;
@@ -1091,8 +1091,8 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     input: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         location: z.ZodOptional<z.ZodEnum<{
-            footer: "footer";
             header: "header";
+            footer: "footer";
             main: "main";
         }>>;
         role: z.ZodOptional<z.ZodEnum<{
@@ -1311,9 +1311,9 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
-            cancelled: "cancelled";
             draft: "draft";
             archived: "archived";
+            cancelled: "cancelled";
         }>>;
         visibility: z.ZodEnum<{
             draft: "draft";
@@ -1432,8 +1432,8 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         title: z.ZodString;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
-            cancelled: "cancelled";
             draft: "draft";
+            cancelled: "cancelled";
         }>>;
         visibility: z.ZodEnum<{
             draft: "draft";
@@ -1572,8 +1572,8 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         expiresAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         status: z.ZodDefault<z.ZodEnum<{
             active: "active";
-            refunded: "refunded";
             expired: "expired";
+            refunded: "refunded";
             exhausted: "exhausted";
         }>>;
         note: z.ZodOptional<z.ZodString>;
@@ -1924,8 +1924,8 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
         input: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             location: z.ZodOptional<z.ZodEnum<{
-                footer: "footer";
                 header: "header";
+                footer: "footer";
                 main: "main";
             }>>;
             role: z.ZodOptional<z.ZodEnum<{
@@ -2144,9 +2144,9 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             }>;
             status: z.ZodOptional<z.ZodEnum<{
                 active: "active";
-                cancelled: "cancelled";
                 draft: "draft";
                 archived: "archived";
+                cancelled: "cancelled";
             }>>;
             visibility: z.ZodEnum<{
                 draft: "draft";
@@ -2265,8 +2265,8 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             title: z.ZodString;
             status: z.ZodOptional<z.ZodEnum<{
                 active: "active";
-                cancelled: "cancelled";
                 draft: "draft";
+                cancelled: "cancelled";
             }>>;
             visibility: z.ZodEnum<{
                 draft: "draft";
@@ -2405,8 +2405,8 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             expiresAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             status: z.ZodDefault<z.ZodEnum<{
                 active: "active";
-                refunded: "refunded";
                 expired: "expired";
+                refunded: "refunded";
                 exhausted: "exhausted";
             }>>;
             note: z.ZodOptional<z.ZodString>;

package/dist/_dts/site-commands/src/index.d.ts

@@ -4,6 +4,7 @@ export * from './commands';
 export * from './domain';
 export * from './exposure';
 export * from './metadata';
+export * from './pagePaths';
 export * from './planner';
 export * from './refContributions';
 export * from './refs';

package/dist/_dts/site-commands/src/pagePaths.d.ts

@@ -0,0 +1,6 @@
+export declare const HOME_PAGE_COMMAND_SLUG = "home";
+export declare const ROOT_PAGE_PATH = "/";
+export declare function commandPageSlug(slug: string): string;
+export declare function normalizedPagePath(slug: string): string;
+export declare function normalizedNavigationHref(href: string): string;
+export declare function isInternalPageHref(href: string): boolean;