@riverbankcms/sdk 0.111.0 → 0.119.0

package/dist/_dts/editor-blocks/src/index.d.ts

@@ -4,7 +4,8 @@ export type { BlockEditorOwner } from './block-editor/owner';
 export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, mergeBlockDescriptors, getBlockManifestFromSdkConfig, transformSdkBlockToManifest, transformSdkBlockToDefinition, transformToBlockDescriptor, } from './block-editor/sdkBlockMerger';
 export type { CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryEntry, ResolvedCustomBlockManifest, SdkCustomBlock, SdkConfigForBlockPicker, } from './block-editor/sdkBlockMerger';
 export type { BlockEditorHandle, BlockFocusRequest, BlockFocusTarget, BlockItem, } from './block-editor/types';
-export { useBlockListContext, useBlockListContextOptional, BlockListProvider } from './block-editor/BlockListContext';
+export { buildBlockDraftBaselineSeed, type BlockDraftBaselineSeed, type BlockFieldExtensions, } from './block-editor/blockDraftBaselineSeed';
+export { useBlockListContext, useBlockListContextOptional, BlockListProvider, } from './block-editor/BlockListContext';
 export type { BlockListContextValue } from './block-editor/BlockListContext';
 export { BlockThumbnail } from './block-editor/BlockThumbnail';
 export type { BlockThumbnailProps } from './block-editor/BlockThumbnail';
@@ -13,14 +14,14 @@ export { BlockForm } from './BlockForm';
 export { FormProvider } from './FormProvider';
 export type { FormProviderProps } from './FormProvider';
 export { buildBlockContentPayload, formatManifestIssues } from './blockPayload';
-export type { BlockContentPayloadResult, ManifestFieldIssue, BuildBlockContentPayloadOptions } from './blockPayload';
+export type { BlockContentPayloadResult, ManifestFieldIssue, BuildBlockContentPayloadOptions, } from './blockPayload';
 export { deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifestValues, } from '../../block-form/src/client/index';
-export type { BlockDraftSaveability, BlockDraftValidationIssue } from '../../block-form/src/client/index';
+export type { BlockDraftSaveability, BlockDraftValidationIssue, } from '../../block-form/src/client/index';
 export { applyManifestIssuesToForm } from './manifestIssues';
 export { BlockPickerDialog } from './block-editor/BlockPickerDialog';
 export { FileField, MediaField } from './media/MediaField';
 export { hideThemeV2RawStyleFields, prepareBlockEditorManifest, } from './block-editor/preparedManifest';
-export { stripTopLevelRoutingUi, } from './block-editor/settingsIntent';
+export { stripTopLevelRoutingUi } from './block-editor/settingsIntent';
 export * from './widgets/index';
-export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger } from './block-form/debug';
+export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger, } from './block-form/debug';
 export type { BlockFormLogger } from './block-form/debug';

package/dist/_dts/editor-blocks/src/widgets/rich-text/RichTextField.d.ts

@@ -1,6 +1,6 @@
-import type { Content } from '@tiptap/react';
 import type { FieldWidgetProps } from '../../../../block-form/src/client/index';
 import type { RichTextFieldConfig } from '../../../../block-form/src/client/index';
-type RichTextValue = Content;
+import { type RichTextDoc } from '../../../../blocks/src/system/manifest/richTextSchema';
+type RichTextValue = RichTextDoc;
 export declare function RichTextField({ path, backend, config, }: FieldWidgetProps<RichTextValue, RichTextFieldConfig>): import("react").JSX.Element;
 export {};

package/dist/_dts/media-core/src/contentMediaAudit.d.ts

@@ -0,0 +1,104 @@
+import type { SiteId } from '../../core/src/index';
+import type { MediaIdentifier } from './identifiers';
+export type ContentFieldPathSegment = string | number;
+export type ContentFieldPath = readonly ContentFieldPathSegment[];
+export type ContentMediaType = 'image' | 'video' | 'audio' | 'document' | 'spreadsheet' | 'archive';
+export type AllowedContentMediaTypes = readonly [
+    ContentMediaType,
+    ...ContentMediaType[]
+];
+export type ContentMediaAuditContext = Readonly<{
+    source: 'database' | 'backup' | 'snapshot';
+    table: string;
+    recordId: string;
+    siteId: SiteId;
+    ownerKind: string;
+    stage: string | null;
+    schemaKey: string;
+}>;
+export type ContentMediaAuditField = Readonly<{
+    kind: 'media';
+    id: string;
+    allowedMediaTypes: AllowedContentMediaTypes;
+}> | Readonly<{
+    kind: 'object';
+    id: string;
+    fields: readonly ContentMediaAuditField[];
+}> | Readonly<{
+    kind: 'repeater';
+    id: string;
+    mode: 'fields';
+    fields: readonly ContentMediaAuditField[];
+}> | Readonly<{
+    kind: 'repeater';
+    id: string;
+    mode: 'variants';
+    variants: readonly Readonly<{
+        typeId: string;
+        fields: readonly ContentMediaAuditField[];
+    }>[];
+    discriminator?: string;
+}>;
+type LocatedFinding = Readonly<{
+    context: ContentMediaAuditContext;
+    path: ContentFieldPath;
+    valueSummary: string;
+}>;
+export type LegacyStringContentMediaFinding = LocatedFinding & Readonly<{
+    tag: 'legacy-string';
+    originalValue: string;
+    expectedMediaType: ContentMediaType;
+    allowedMediaTypes: AllowedContentMediaTypes;
+}>;
+export type ContentMediaAuditFinding = LegacyStringContentMediaFinding | (LocatedFinding & Readonly<{
+    tag: 'blank-string';
+    expectedMediaType: ContentMediaType;
+}>) | (LocatedFinding & Readonly<{
+    tag: 'malformed-object';
+    expectedMediaType: ContentMediaType;
+}>) | (LocatedFinding & Readonly<{
+    tag: 'missing-schema';
+}>);
+export type ContentMediaAuditInput = Readonly<{
+    context: ContentMediaAuditContext;
+    data: unknown;
+    fields: readonly ContentMediaAuditField[] | null;
+}>;
+export type LegacyMediaAssetCandidate = Readonly<{
+    siteId: SiteId;
+    identifier: MediaIdentifier;
+    mediaType: ContentMediaType;
+    legacyValues: readonly string[];
+    active: boolean;
+}>;
+export type ResolvedLegacyMediaMapping = Readonly<{
+    finding: LegacyStringContentMediaFinding;
+    identifier: MediaIdentifier;
+    mediaType: ContentMediaType;
+}>;
+export type LegacyMediaResolutionError = Readonly<{
+    tag: 'missing-asset';
+    finding: LegacyStringContentMediaFinding;
+}> | Readonly<{
+    tag: 'ambiguous-asset';
+    finding: LegacyStringContentMediaFinding;
+    identifiers: readonly MediaIdentifier[];
+}> | Readonly<{
+    tag: 'kind-mismatch';
+    finding: LegacyStringContentMediaFinding;
+    identifier: MediaIdentifier;
+    actualMediaType: ContentMediaType;
+}>;
+export type LegacyMediaResolutionResult = Readonly<{
+    ok: true;
+    value: ResolvedLegacyMediaMapping;
+}> | Readonly<{
+    ok: false;
+    error: LegacyMediaResolutionError;
+}>;
+export declare function formatContentFieldPath(path: ContentFieldPath): string;
+export declare function summarizeContentMediaValue(value: unknown): string;
+export declare function auditContentMediaValues(input: ContentMediaAuditInput): readonly ContentMediaAuditFinding[];
+export declare function resolveLegacyMediaFinding(finding: LegacyStringContentMediaFinding, assets: readonly LegacyMediaAssetCandidate[]): LegacyMediaResolutionResult;
+export declare function resolveLegacyMediaFindings(findings: readonly ContentMediaAuditFinding[], assets: readonly LegacyMediaAssetCandidate[]): readonly LegacyMediaResolutionResult[];
+export {};

package/dist/_dts/media-core/src/contentMediaAuditFieldAdapter.d.ts

@@ -0,0 +1,8 @@
+import { type AllowedContentMediaTypes, type ContentMediaAuditField } from './contentMediaAudit';
+/**
+ * Adapts content-type schemas and block manifests into the dependency-neutral
+ * field tree consumed by the pure audit walker. Unknown field kinds are ignored.
+ */
+export declare function adaptContentMediaAuditFields(schemaOrFields: unknown, options?: Readonly<{
+    defaultFileKinds?: AllowedContentMediaTypes;
+}>): readonly ContentMediaAuditField[] | null;

package/dist/_dts/media-core/src/contentMediaSnapshotAudit.d.ts

@@ -0,0 +1,22 @@
+import { type ContentMediaAuditContext, type ContentMediaAuditFinding, type LegacyMediaResolutionResult } from './contentMediaAudit';
+export type ContentMediaAuditSnapshotRecord = Readonly<Record<string, unknown>>;
+export type ContentMediaAuditSnapshot = Readonly<{
+    contentVersions: readonly ContentMediaAuditSnapshotRecord[];
+    contentEntries: readonly ContentMediaAuditSnapshotRecord[];
+    contentTypes: readonly ContentMediaAuditSnapshotRecord[];
+    blocks: readonly ContentMediaAuditSnapshotRecord[];
+    customBlocks: readonly ContentMediaAuditSnapshotRecord[];
+    pageSurfaces: readonly ContentMediaAuditSnapshotRecord[];
+    mediaAssets: readonly ContentMediaAuditSnapshotRecord[];
+    sites?: readonly ContentMediaAuditSnapshotRecord[];
+    contentTemplates?: readonly ContentMediaAuditSnapshotRecord[];
+    contentTemplateBlocks?: readonly ContentMediaAuditSnapshotRecord[];
+    footerBlocks?: readonly ContentMediaAuditSnapshotRecord[];
+}>;
+export type ContentMediaAuditReport = Readonly<{
+    findings: readonly ContentMediaAuditFinding[];
+    resolutions: readonly LegacyMediaResolutionResult[];
+    counts: Readonly<Record<string, number>>;
+}>;
+export type ContentMediaAuditManifestMap = ReadonlyMap<string, unknown>;
+export declare function auditContentMediaSnapshot(snapshot: ContentMediaAuditSnapshot, source: ContentMediaAuditContext['source'], builtInManifests: ContentMediaAuditManifestMap): ContentMediaAuditReport;

package/dist/_dts/media-core/src/index.d.ts

@@ -44,4 +44,6 @@ export * from './richTextImageWriteNormalizer';
 export * from './mediaUsageProjection';
 export * from './portableMediaReferences';
 export * from './renderableMediaAsset';
-export * from './legacyMediaValue';
+export * from './contentMediaAudit';
+export * from './contentMediaAuditFieldAdapter';
+export * from './contentMediaSnapshotAudit';

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

@@ -1,6 +1,23 @@
 import { Command } from 'commander';
-import type { EventSeriesUpsertInput, ManagementEventSeries } from '../../client/management/types';
+import type { EventOccurrenceCapacityIntent, EventOccurrenceScheduleInput, ManagementEventOccurrence, EventSeriesUpsertInput, ManagementEventSeries } from '../../client/management/types';
 export declare function toEventUpsertInput(identifier: string, raw: Record<string, unknown>): EventSeriesUpsertInput;
 export declare function buildCancelledEventUpsertInput(current: ManagementEventSeries): EventSeriesUpsertInput;
 export declare function canCancelEventStatus(status: ManagementEventSeries['status']): boolean;
+type OccurrenceScheduleOptions = Readonly<{
+    startsAt?: string;
+    endsAt?: string;
+    durationMinutes?: string;
+}>;
+type OccurrenceCapacityOptions = Readonly<{
+    capacity?: string;
+    inheritCapacity?: boolean;
+}>;
+export declare function occurrenceScheduleFromOptions(options: OccurrenceScheduleOptions, required: true): EventOccurrenceScheduleInput;
+export declare function occurrenceScheduleFromOptions(options: OccurrenceScheduleOptions, required: false): EventOccurrenceScheduleInput | undefined;
+export declare function occurrenceCapacityFromOptions(options: OccurrenceCapacityOptions): EventOccurrenceCapacityIntent | undefined;
+export declare function formatDeletionEligibility(occurrence: ManagementEventOccurrence): string;
+export declare function occurrenceListJson(occurrences: readonly ManagementEventOccurrence[]): Readonly<{
+    occurrences: readonly ManagementEventOccurrence[];
+}>;
 export declare const eventCommand: Command;
+export {};

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

@@ -1,5 +1,5 @@
 import type { OutputContext } from '../../../output';
-import type { Theme } from '../../../../contracts';
+import type { ValidatedThemeForPersistence } from '../../../../../../blocks/src/index';
 import type { ThemeUpsertUpdateInput } from '../../../../client/management/types';
 export type ThemePushClient = {
     theme: {
@@ -56,22 +56,8 @@ export declare function handleThemePushForAllScope(params: {
     };
     readTheme: (contentDir: string, themeName: string) => Promise<{
         name: string;
-        theme: Theme;
+        theme: ValidatedThemeForPersistence;
     } | null>;
     readThemesMeta: (contentDir: string) => Promise<ThemesMetaFile | null>;
     writeThemesMeta: (contentDir: string, data: ThemesMetaFile) => Promise<void>;
-    themeSchema: {
-        safeParse: (value: unknown) => {
-            success: true;
-            data: ThemeUpsertUpdateInput['theme'];
-        } | {
-            success: false;
-            error: {
-                issues: Array<{
-                    path: Array<PropertyKey>;
-                    message: string;
-                }>;
-            };
-        };
-    };
 }): Promise<void>;

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

@@ -7,8 +7,9 @@
 import { type ContentMetadataTarget } from './metadataStore';
 import type { NavigationAuthoringLinkInput, NavigationLocalItemInput } from '../../../../api/src/navigation';
 import type { SdkEventPricingInput } from '../../../../api/src/sdk-event-pricing';
+import { type ValidatedThemeForPersistence } from '../../../../blocks/src/index';
 import type { EventPaymentTermsInput } from '../../client/management/types';
-import type { Theme } from '../../contracts';
+import { type RichTextDoc } from '../../../../core/src/index';
 export interface LocalEntry {
     identifier: string;
     data: Record<string, unknown>;
@@ -112,7 +113,7 @@ export interface LocalTheme {
     /** Filename without .json extension */
     name: string;
     /** Full theme object matching themeSchema */
-    theme: Theme;
+    theme: ValidatedThemeForPersistence;
 }
 /**
  * Local footer content structure.
@@ -122,7 +123,7 @@ export interface LocalTheme {
  */
 export interface LocalFooterContent {
     /** Rich text content in ProseMirror JSON format. Set to null to clear. */
-    bottomText?: Record<string, unknown> | null;
+    bottomText?: RichTextDoc | null;
 }
 export interface LocalVenueAddress {
     line1?: string | null;
@@ -164,8 +165,10 @@ export interface LocalEventSchedule {
 export type LocalEventPricing = SdkEventPricingInput;
 export interface LocalEventContent {
     summary?: string | null;
-    body?: string | Record<string, unknown> | null;
-    image?: string | Record<string, unknown> | null;
+    body?: string | RichTextDoc | null;
+    image?: (Record<string, unknown> & {
+        identifier: string;
+    }) | null;
 }
 export interface LocalEvent {
     identifier: string;

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

@@ -2,5 +2,6 @@
  * Event Operations for Management Client
  */
 import { type HttpClient } from './http';
-import type { EventOperations } from './types';
+import type { EventOperations, EventOccurrenceOperations } from './types';
+export declare function createEventOccurrenceOperations(http: HttpClient): EventOccurrenceOperations;
 export declare function createEventOperations(http: HttpClient): EventOperations;

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

@@ -36,7 +36,7 @@ import { CourseSessionConflictError } from './courses';
  * @returns ManagementClient instance
  */
 export declare function createManagementClient(config: ManagementClientConfig): ManagementClient;
-export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, EntryPublishUpsertResult, UpsertedManagementEntry, PageUpsertInput, PagePublishUpsertResult, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInitializeInput, ThemeUpsertInput, ThemeUpsertResult, ThemeUpsertUpdateInput, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledDrafts, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, CatalogOperations, PulledCatalogTheme, PulledCatalogBlocks, PulledCatalogContentTypes, Capabilities, DemoContent, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
+export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, ManagementEventOccurrence, EventOccurrenceScheduleInput, AddEventOccurrenceInput, EventOccurrenceCapacityIntent, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, EntryPublishUpsertResult, UpsertedManagementEntry, PageUpsertInput, PagePublishUpsertResult, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInitializeInput, ThemeUpsertInput, ThemeUpsertResult, ThemeUpsertUpdateInput, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledDrafts, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, EventOccurrenceOperations, CourseOperations, PullOperations, CatalogOperations, PulledCatalogTheme, PulledCatalogBlocks, PulledCatalogContentTypes, Capabilities, DemoContent, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
 export { ManagementApiError, type ManagementApiErrorRequest } from './http';
 export { BlockPatchStaleContentError, isBlockPatchStaleContentError, } from './blocks';
 export { applySiteStyleSelectionBodyFromCommand, buildApplySiteStyleSelectionCommand, } from './theme';

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

@@ -9,13 +9,14 @@ import type { SiteCommandOf } from '../../../../site-commands/src/index';
 import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } from '../../../../api/src/sdk-event-pricing';
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../../api/src/sdk-event-payment-terms';
 import type { SdkEventUpsertBody } from '../../../../api/src/sdk-event-upsert';
-import type { SdkManagementEventSeries } from '../../../../api/src/sdkContracts';
+import type { SdkAddEventOccurrenceRequest, SdkEventOccurrenceCapacityIntent, SdkEventOccurrenceScheduleInput, SdkManagementEventOccurrence, SdkManagementEventSeries } from '../../../../api/src/sdkContracts';
 import type { SdkPullTruncationMeta } from '../../../../api/src/sdkContracts';
 import type { SdkCapabilitiesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCatalogThemeResponse, SdkDemoContentResponse } from '../../../../api/src/sdkContracts';
 import type { SdkEntryPublishErrorCode, SdkPagePublishErrorCode, SdkPublicationOutcome } from '../../../../api/src/sdkContracts';
 import type { PaletteSelection } from '../../../../theme-core/src/palette/index';
 import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
 import type { Theme } from '../../contracts';
+import type { RichTextDoc } from '../../../../core/src/index';
 export type SdkDeletePageResponse = NonNullable<APIEndpoints['sdkDeletePage']['response']>;
 export type SdkGetPageBlockResponse = NonNullable<APIEndpoints['sdkGetPageBlock']['response']>;
 export type SdkPatchPageBlockBody = NonNullable<APIEndpoints['sdkPatchPageBlock']['body']>;
@@ -457,11 +458,17 @@ export type EventPaymentTermsInput = SdkEventPaymentTermsInput;
  */
 export interface EventContent {
     summary?: string;
-    body?: string | Record<string, unknown>;
-    image?: string | Record<string, unknown>;
+    body?: string | RichTextDoc;
+    image?: Record<string, unknown> & {
+        identifier: string;
+    };
     [key: string]: unknown;
 }
 export type ManagementEventSeries = SdkManagementEventSeries;
+export type ManagementEventOccurrence = SdkManagementEventOccurrence;
+export type EventOccurrenceScheduleInput = SdkEventOccurrenceScheduleInput;
+export type AddEventOccurrenceInput = SdkAddEventOccurrenceRequest;
+export type EventOccurrenceCapacityIntent = SdkEventOccurrenceCapacityIntent;
 export type EventSeriesUpsertInput = SdkEventUpsertBody;
 export interface CourseSession {
     startsAt: string;
@@ -597,21 +604,21 @@ export interface ThemeStyleSelectionApplyResult {
  */
 export interface FooterContent {
     /** Rich text content in ProseMirror JSON format */
-    bottomText?: Record<string, unknown>;
+    bottomText?: RichTextDoc;
 }
 /**
  * Footer content as returned from CMS.
  */
 export interface ManagementFooterContent {
     /** Rich text content in ProseMirror JSON format */
-    bottomText: Record<string, unknown>;
+    bottomText: RichTextDoc;
 }
 /**
  * Input for upserting footer content.
  */
 export interface FooterContentUpsertInput {
     /** Set to null to clear. */
-    bottomText?: Record<string, unknown> | null;
+    bottomText?: RichTextDoc | null;
 }
 export interface PulledFooter {
     footer: ManagementFooterContent | null;
@@ -1009,6 +1016,25 @@ export interface EventOperations {
     get(identifier: string): Promise<ManagementEventSeries | null>;
     upsert(input: EventSeriesUpsertInput): Promise<ManagementEventSeries>;
     delete(identifier: string): Promise<void>;
+    occurrences: EventOccurrenceOperations;
+}
+export interface EventOccurrenceOperations {
+    list(identifier: string, options?: Readonly<{
+        all?: boolean;
+        status?: ManagementEventOccurrence['status'];
+        cursor?: string;
+        limit?: number;
+    }>): Promise<Readonly<{
+        occurrences: ManagementEventOccurrence[];
+        nextCursor: string | null;
+    }>>;
+    add(identifier: string, input: AddEventOccurrenceInput): Promise<ManagementEventOccurrence>;
+    update(identifier: string, occurrenceId: string, input: Readonly<{
+        schedule?: EventOccurrenceScheduleInput;
+        capacity?: EventOccurrenceCapacityIntent;
+    }>): Promise<ManagementEventOccurrence>;
+    cancel(identifier: string, occurrenceId: string): Promise<ManagementEventOccurrence>;
+    delete(identifier: string, occurrenceId: string): Promise<void>;
 }
 export interface CourseOperations {
     list(): Promise<ManagementCourseRun[]>;
@@ -1156,9 +1182,10 @@ export interface ManagementClient {
      */
     capabilities(): Promise<Capabilities>;
     /**
-     * Demo-seed provenance ledger: the resources demo recipe runs created on this
-     * site (plan 8.2), so an agent can distinguish placeholder demo content from
-     * authored content and drive cleanup.
+     * Demo-seed provenance ledger: created and existing resource observations
+     * from demo recipe runs (plan 8.2). Historical heuristic-era observations are
+     * not cleanup-authoritative, and destructive cleanup remains disabled pending
+     * an explicit trust cutoff or purge.
      */
     demoContent(): Promise<DemoContent>;
 }

package/dist/_dts/sdk/src/config/typed-entries.d.ts

@@ -31,9 +31,9 @@
  * ```
  */
 import type { BooleanFieldDefinition, ContentTypeSelectFieldDefinition, DateFieldDefinition, DateTimeFieldDefinition, EntryPickerFieldDefinition, FileFieldDefinition, FieldDefinition, GroupFieldDefinition, InlineTextFieldDefinition, LinkFieldDefinition, MediaFieldDefinition, ModalFieldDefinition, NumberFieldDefinition, PresetOrCustomFieldDefinition, ReferenceFieldDefinition, RepeaterFieldDefinition, RichTextFieldDefinition, SelectFieldDefinition, SlugFieldDefinition, TabGroupFieldDefinition, TextFieldDefinition, TimeFieldDefinition, UrlFieldDefinition } from './field-definitions';
-import type { InlineText, LinkValue, Media, TipTapNode } from '../contracts';
+import type { InlineText, LinkValue, Media, RichTextDoc, TipTapNode } from '../contracts';
 import type { ContentTypeConfig, EntryConfig } from './content-types';
-export type { TipTapNode, Media, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, } from '../contracts';
+export type { TipTapNode, RichTextDoc, Media, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, } from '../contracts';
 /**
  * Infers the data object shape from tabGroup tabs (flattens all tab fields).
  * TabGroup fields flatten all their tab fields into a single data object.
@@ -64,7 +64,7 @@ export type FieldValueType<F extends FieldDefinition> = F extends {
     type: 'number';
 } ? number : F extends {
     type: 'richText';
-} ? TipTapNode : F extends {
+} ? RichTextDoc : F extends {
     type: 'inlineText';
 } ? InlineText : F extends {
     type: 'media';
@@ -95,7 +95,7 @@ export type FieldValueType<F extends FieldDefinition> = F extends {
     type: 'select';
 } ? string : F extends {
     type: 'entryPicker';
-} ? string | null : F extends TextFieldDefinition ? string : F extends BooleanFieldDefinition ? boolean : F extends NumberFieldDefinition ? number : F extends RichTextFieldDefinition ? TipTapNode : F extends InlineTextFieldDefinition ? InlineText : F extends MediaFieldDefinition ? Media | null : F extends FileFieldDefinition ? Media | null : F extends LinkFieldDefinition ? LinkValue | null : F extends DateFieldDefinition ? string : F extends TimeFieldDefinition ? string : F extends DateTimeFieldDefinition ? string : F extends SlugFieldDefinition ? string : F extends UrlFieldDefinition ? string : F extends ReferenceFieldDefinition ? string : F extends PresetOrCustomFieldDefinition ? string : F extends ContentTypeSelectFieldDefinition ? string : F extends SelectFieldDefinition & {
+} ? string | null : F extends TextFieldDefinition ? string : F extends BooleanFieldDefinition ? boolean : F extends NumberFieldDefinition ? number : F extends RichTextFieldDefinition ? RichTextDoc : F extends InlineTextFieldDefinition ? InlineText : F extends MediaFieldDefinition ? Media | null : F extends FileFieldDefinition ? Media | null : F extends LinkFieldDefinition ? LinkValue | null : F extends DateFieldDefinition ? string : F extends TimeFieldDefinition ? string : F extends DateTimeFieldDefinition ? string : F extends SlugFieldDefinition ? string : F extends UrlFieldDefinition ? string : F extends ReferenceFieldDefinition ? string : F extends PresetOrCustomFieldDefinition ? string : F extends ContentTypeSelectFieldDefinition ? string : F extends SelectFieldDefinition & {
     multiple: true;
 } ? string[] : F extends SelectFieldDefinition ? string : F extends EntryPickerFieldDefinition ? string | null : F extends GroupFieldDefinition & {
     schema: {
@@ -243,21 +243,21 @@ export declare const tiptap: {
      *
      * @returns An empty TipTap document node
      */
-    empty(): TipTapNode;
+    empty(): RichTextDoc;
     /**
      * Create a TipTap document with a single paragraph.
      *
      * @param text - The paragraph text content
      * @returns A TipTap document with one paragraph
      */
-    paragraph(text: string): TipTapNode;
+    paragraph(text: string): RichTextDoc;
     /**
      * Create a TipTap document with custom content nodes.
      *
      * @param content - Array of TipTap nodes to include in the document
      * @returns A TipTap document wrapping the content
      */
-    doc(content: TipTapNode[]): TipTapNode;
+    doc(content: TipTapNode[]): RichTextDoc;
     /**
      * Create a heading node.
      *

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

@@ -158,8 +158,8 @@ export declare const loaderParamBindingSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         pick: z.ZodDefault<z.ZodEnum<{
             value: "value";
-            collection: "collection";
             context: "context";
+            collection: "collection";
         }>>;
         coerce: z.ZodOptional<z.ZodEnum<{
             string: "string";
@@ -181,8 +181,8 @@ export declare const loaderParamValueSchema: z.ZodUnion<readonly [z.ZodString, z
         }, z.core.$strip>>>;
         pick: z.ZodDefault<z.ZodEnum<{
             value: "value";
-            collection: "collection";
             context: "context";
+            collection: "collection";
         }>>;
         coerce: z.ZodOptional<z.ZodEnum<{
             string: "string";
@@ -205,8 +205,8 @@ export declare const loaderWhenValueSchema: z.ZodUnion<readonly [z.ZodBoolean, z
         }, z.core.$strip>>>;
         pick: z.ZodDefault<z.ZodEnum<{
             value: "value";
-            collection: "collection";
             context: "context";
+            collection: "collection";
         }>>;
         coerce: z.ZodOptional<z.ZodEnum<{
             string: "string";
@@ -248,8 +248,8 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
             }, z.core.$strip>>>;
             pick: z.ZodDefault<z.ZodEnum<{
                 value: "value";
-                collection: "collection";
                 context: "context";
+                collection: "collection";
             }>>;
             coerce: z.ZodOptional<z.ZodEnum<{
                 string: "string";
@@ -272,8 +272,8 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
             }, z.core.$strip>>>;
             pick: z.ZodDefault<z.ZodEnum<{
                 value: "value";
-                collection: "collection";
                 context: "context";
+                collection: "collection";
             }>>;
             coerce: z.ZodOptional<z.ZodEnum<{
                 string: "string";
@@ -314,8 +314,8 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
             }, z.core.$strip>>>;
             pick: z.ZodDefault<z.ZodEnum<{
                 value: "value";
-                collection: "collection";
                 context: "context";
+                collection: "collection";
             }>>;
             coerce: z.ZodOptional<z.ZodEnum<{
                 string: "string";
@@ -338,8 +338,8 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
             }, z.core.$strip>>>;
             pick: z.ZodDefault<z.ZodEnum<{
                 value: "value";
-                collection: "collection";
                 context: "context";
+                collection: "collection";
             }>>;
             coerce: z.ZodOptional<z.ZodEnum<{
                 string: "string";

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

@@ -1,22 +1,12 @@
 /**
  * Public SDK content contracts.
  *
- * These types intentionally live in the SDK (not re-exported from internal
- * workspace packages) so external consumers can typecheck without installing
- * `@riverbankcms/blocks`.
+ * SDK consumers import these contracts from the SDK. Internally, rich text
+ * aliases the dependency-free core contract used by the runtime validator.
  */
 import type React from 'react';
-export type TipTapMark = {
-    type: string;
-    attrs?: Record<string, unknown>;
-};
-export type TipTapNode = {
-    type: string;
-    content?: TipTapNode[];
-    text?: string;
-    attrs?: Record<string, unknown>;
-    marks?: TipTapMark[];
-};
+import type { RichTextDoc } from '../../../core/src/index';
+export type { RichTextDoc, TipTapMark, TipTapNode } from '../../../core/src/index';
 export type InlineTextAccentTone = 'accent' | 'brand' | 'contrast';
 export type InlineTextHighlightTone = 'soft' | 'accent' | 'brand';
 export type InlineTextMark = Readonly<{
@@ -126,7 +116,7 @@ export type RichTextPrimitiveProps = {
     as?: React.ElementType;
     className?: string;
     path?: string;
-    doc?: TipTapNode | null;
+    doc?: RichTextDoc | null;
     variant?: RichTextVariant;
     blockData?: Record<string, unknown> | null;
 };

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

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