@riverbankcms/sdk 0.111.0 → 0.119.0

package/dist/_dts/blocks/src/system/runtime/nodes/richText-coerce.d.ts

@@ -1,2 +1,14 @@
-import { type TipTapNode } from '../../manifest/richTextSchema';
-export declare function coerceRichTextDoc(value: unknown): TipTapNode | null;
+import { type RichTextDoc } from '../../manifest/richTextSchema';
+export type RichTextDocParseIssue = Readonly<{
+    path: readonly (string | number)[];
+    message: string;
+}>;
+export type RichTextDocParseResult = Readonly<{
+    kind: 'valid';
+    doc: RichTextDoc;
+}> | Readonly<{
+    kind: 'invalid';
+    issues: readonly RichTextDocParseIssue[];
+}>;
+export declare function parseRichTextDoc(value: unknown): RichTextDocParseResult;
+export declare function coerceRichTextDoc(value: unknown, source: string): RichTextDoc | null;

package/dist/_dts/blocks/src/system/transforms/typed.d.ts

@@ -123,7 +123,7 @@ export declare function bindProp(from: string, opts?: {
     pick?: "value" | "collection" | "context";
 }): {
     readonly $bind: {
-        readonly pick?: "value" | "collection" | "context" | undefined;
+        readonly pick?: "value" | "context" | "collection" | undefined;
         readonly fallback?: {} | null | undefined;
         readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "boxStyles.cardVariantClass" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitNavSingleClass" | "layout.footerSimpleRootClass" | "layout.footerSimpleNavClass" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible">[] | undefined;
         readonly from: string;

package/dist/_dts/content-editor/src/controller/seedDraftBaselinesFromBlocks.d.ts

@@ -1,4 +1,4 @@
-import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
+import { type BlockItem } from '../../../editor-blocks/src/index';
 import type { EditorUiState } from '../ui/editorUiStore';
 type StoreApi<T> = {
     getState: () => T;

package/dist/_dts/content-editor/src/hooks/useBlockAutosave.d.ts

@@ -9,11 +9,27 @@ export type BlockAutosaveOptions = {
     siteId: string;
     /** Whether this entry has a route (pages have blocks, content entries don't) */
     hasRoute: boolean;
+    owner: BlockAutosaveOwner;
 };
+export type BlockAutosaveOwner = Readonly<{
+    kind: 'contentEntry';
+}> | Readonly<{
+    kind: 'pageSurface';
+}>;
+export type BlockSaveRevisionPlan = Readonly<{
+    kind: 'bestEffort';
+    optimisticHash: string | null;
+}> | Readonly<{
+    kind: 'compareAndSet';
+    optimisticHash: string;
+}> | Readonly<{
+    kind: 'missingRequiredRevision';
+}>;
+export declare function planBlockSaveRevisionForOwner(owner: BlockAutosaveOwner, optimisticHash: string | null): BlockSaveRevisionPlan;
 /**
  * Hook to handle block autosave for pages.
  * Watches for pending block changes and debounces saves to the server.
  *
  * Only enabled for pages (hasRoute=true), as content entries don't have blocks.
  */
-export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;
+export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, owner, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;

package/dist/_dts/content-editor/src/hooks/useDebouncedLatestSave.d.ts

@@ -1,7 +1,7 @@
 export type DebouncedLatestSaveHandle = {
     trigger: () => void;
     cancel: () => void;
-    flush: () => void;
+    flush: () => Promise<void>;
     isPending: () => boolean;
 };
 export type DebouncedLatestSaveConfig<TSnapshot, TPayload, TResult> = {

package/dist/_dts/content-editor/src/hooks/useSimpleAutosave.d.ts

@@ -37,7 +37,7 @@ type AutosaveConfig<TValues, TPayload> = {
 export type AutosaveHandle = {
     trigger: () => void;
     cancel: () => void;
-    flush: () => void;
+    flush: () => void | Promise<void>;
     isPending: () => boolean;
 };
 export declare function useSimpleAutosave<TValues = Record<string, unknown>, TPayload = unknown>(config: AutosaveConfig<TValues, TPayload>): AutosaveHandle;

package/dist/_dts/content-editor/src/ui/editorSnapshot.d.ts

@@ -1,4 +1,4 @@
-import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
+import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorDraftSaveFailureRecovery, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
 import { type LinkedContentEntryId, type LinkedContentTypeKey } from '../linkedEntries/domain';
 export { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockId, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorSiteId, };
 export type EditorCommand = {
@@ -234,6 +234,7 @@ export type EditorSystemOperation = {
     type: 'autosave-draft-failed';
     blockId: EditorBlockId;
     message?: string;
+    recovery?: EditorDraftSaveFailureRecovery;
 } | {
     type: 'clear-draft-error';
     blockId: EditorBlockId;
@@ -298,7 +299,7 @@ export declare function updateDraftBlockBaseline(snapshot: EditorHistorySnapshot
 export declare function removeDraftBlock(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function setDraftPublishedBaselines(snapshot: EditorHistorySnapshot, blocks: readonly BlockPublishedBaselineInput[]): EditorHistorySnapshot;
 export declare function autosaveDraftSucceeded(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, savedValues: EditorBlockValues | null, acknowledgedVersion: number, optimisticHash: string | null): EditorHistorySnapshot;
-export declare function autosaveDraftFailed(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, message?: string): EditorHistorySnapshot;
+export declare function autosaveDraftFailed(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, message?: string, recovery?: EditorDraftSaveFailureRecovery): EditorHistorySnapshot;
 export declare function clearDraftError(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function setDraftPending(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function clearDraftPending(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;

package/dist/_dts/content-editor/src/ui/editorUiStore.d.ts

@@ -1,4 +1,4 @@
-import type { FooterModuleId } from '../../../core/src/index';
+import type { EditorDraftSaveFailureRecovery, FooterModuleId } from '../../../core/src/index';
 import { type EditorUnpublishedState } from '../controller/deriveEditorUnpublishedState';
 import { type AutosaveState } from './stores/autosaveStore';
 import { type GeneratedIconAssetsState } from './stores/generatedIconAssetsStore';
@@ -167,7 +167,7 @@ export type DraftsState = {
     clearPending: (blockId: EditorBlockId) => void;
     setFailed: (blockId: EditorBlockId, message?: string) => void;
     autosaveSucceeded: (blockId: EditorBlockId, content: Record<string, unknown> | null, acknowledgement?: AutosaveAcknowledgement) => void;
-    autosaveFailed: (blockId: EditorBlockId, message?: string) => void;
+    autosaveFailed: (blockId: EditorBlockId, message?: string, recovery?: EditorDraftSaveFailureRecovery) => void;
     setAtPath: (blockId: EditorBlockId, path: string, value: unknown) => void;
     getAtPath: <T = unknown>(blockId: EditorBlockId, path: string) => T | undefined;
     updateBlockOrder: (blockIds: EditorBlockId[]) => void;

package/dist/_dts/content-editor/src/ui/stores/autosaveStore.d.ts

@@ -24,7 +24,7 @@ export type AutosaveState = {
      * Unlike flushAllPending(), this does not rely on a debounced callback being pending, so it
      * works for manual-save mode where background triggers are disabled.
      */
-    saveNow: (types: AutosaveType[]) => void;
+    saveNow: (types: AutosaveType[]) => Promise<void>;
     flushAllPending: () => void;
     cancelAllPending: () => void;
 };

package/dist/_dts/content-editor/src/ui/stores/types.d.ts

@@ -8,7 +8,7 @@ export type AutosaveStatus = {
 export type AutosaveHandle = {
     trigger: () => void;
     cancel?: () => void;
-    flush: () => void;
+    flush: () => void | Promise<void>;
     isPending: () => boolean;
 };
 export type AutosaveType = 'metadata' | 'content' | 'blocks' | 'linkedEntries';

package/dist/_dts/content-model/src/content-types/builtins.d.ts

@@ -13,29 +13,17 @@
  * together. A schema edit updates the binding type surface without a
  * parallel hand-maintained interface.
  */
+import type { RichTextDoc } from '../../../blocks/src/system/manifest/richTextSchema';
 import { COURSE_CONTENT_TYPE_SCHEMA, EVENT_CONTENT_TYPE_SCHEMA, POST_CONTENT_TYPE_SCHEMA, PRODUCT_CATEGORY_CONTENT_TYPE_SCHEMA, PRODUCT_CONTENT_TYPE_SCHEMA, TEAM_MEMBER_CONTENT_TYPE_SCHEMA, TESTIMONIAL_CONTENT_TYPE_SCHEMA } from './builtin-schemas';
 export interface ContentMediaValue {
+    identifier: string;
     url?: string;
     alt?: string;
     width?: number;
     height?: number;
     readonly [key: string]: unknown;
 }
-/**
- * Canonical rich-text content shape stored on entries. Same structural shape
- * as `TipTapNode` from `@riverbankcms/blocks/system/manifest/richTextSchema`;
- * any value validated through {@link RichTextValueSchema} satisfies this.
- */
-export interface ContentRichText {
-    type: string;
-    content?: ContentRichText[];
-    text?: string;
-    attrs?: Record<string, unknown>;
-    marks?: Array<{
-        type: string;
-        attrs?: Record<string, unknown>;
-    }>;
-}
+export type ContentRichText = RichTextDoc;
 type DerivableContentField = Readonly<{
     id: string;
     type: string;

package/dist/_dts/content-model/src/content-types/entryValidation.d.ts

@@ -28,4 +28,6 @@ export interface EntryValidationResult {
 export declare function validateEntryInstance(input: {
     schema: ContentTypeSchema;
     data: Record<string, unknown>;
+    /** Validate present values while permitting required fields to remain unset in drafts. */
+    allowIncomplete?: boolean;
 }): EntryValidationResult;

package/dist/_dts/content-model/src/content-types/schema.d.ts

@@ -16,11 +16,11 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         file: "file";
         media: "media";
         reference: "reference";
+        repeater: "repeater";
         group: "group";
         datetime: "datetime";
         button: "button";
         richText: "richText";
-        repeater: "repeater";
     }>;
     label: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;

package/dist/_dts/content-model/src/templates/defaults.d.ts

@@ -1,25 +1,5 @@
 import { type TemplateDefinition } from './types';
 import type { BuiltinContentTypeKey } from '../content-types/builtins';
-/**
- * Build a canonical TipTap doc from plain-text paragraphs.
- *
- * Local mirror of `createRichTextDoc` from
- * `@riverbankcms/blocks/system/manifest/richTextSchema` — content-model
- * doesn't depend on blocks (blocks sits downstream), but the shape both
- * functions produce is governed by the same Zod schema in blocks.
- *
- * Exported with `@internal` so the cross-package parity test
- * (`packages/dummy-content/src/richTextDoc-parity.test.ts`) can import
- * the *real* implementation rather than reimplement it — eliminates the
- * "test verifies two copies of itself" failure mode.
- *
- * Returns `Record<string, unknown>` rather than the canonical
- * `RichTextDoc` type because that type lives in blocks; downstream
- * consumers narrow it via the canonical schema.
- *
- * @internal
- */
-export declare function createRichTextDocInternal(paragraphs: ReadonlyArray<string>): Record<string, unknown>;
 /**
  * Built-in content type keys that intentionally ship without a default
  * template — they use the block editor directly rather than a templated
@@ -79,7 +59,7 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
             readonly content: {
                 readonly eyebrow: "Stay in the loop";
                 readonly title: "Get the latest updates";
-                readonly content: Record<string, unknown>;
+                readonly content: import("../../../core/src/index").RichTextDoc;
                 readonly ctas: readonly [{
                     readonly label: "Subscribe now";
                     readonly link: {

package/dist/_dts/core/src/editor-state.d.ts

@@ -22,6 +22,19 @@ export type EditorSyncState = {
     kind: 'failed';
     error: string;
 };
+export type EditorDraftSaveFailureRecovery = Readonly<{
+    kind: 'manualRetry';
+}> | Readonly<{
+    kind: 'rebaseOnNewRevision';
+    failedOptimisticHash: string | null;
+}>;
+export type EditorDraftSyncState = Exclude<EditorSyncState, {
+    kind: 'failed';
+}> | Readonly<{
+    kind: 'failed';
+    error: string;
+    recovery: EditorDraftSaveFailureRecovery;
+}>;
 export type EditorStructuralDraftMeta = Readonly<{
     kind: string;
     purpose: string | null;
@@ -34,7 +47,7 @@ export type EditorStructuralDraftSnapshot = Readonly<{
     version: number;
     baseline: EditorBlockValues | null;
     current: EditorBlockValues | null;
-    syncState: EditorSyncState;
+    syncState: EditorDraftSyncState;
     meta: EditorStructuralDraftMeta;
 }>;
 export type EditorBlockDataRowInput = Readonly<{

package/dist/_dts/core/src/footer-composition.d.ts

@@ -1,8 +1,9 @@
 import type { Brand } from './branded';
+import { type RichTextDoc } from './rich-text';
 import { type Result } from './result';
 export type FooterModuleId = Brand<string, 'FooterModuleId'>;
 export type FooterMembershipKey = Brand<string, 'FooterMembershipKey'>;
-export type FooterRichText = Readonly<Record<string, unknown>>;
+export type FooterRichText = RichTextDoc;
 export type FooterNavigationRole = 'main' | 'legal-policy';
 type FooterSectionBase<TKind extends string> = Readonly<{
     id: FooterModuleId;

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

@@ -30,6 +30,7 @@ export * from './participants';
 export * from './participant-identity';
 export * from './public-url-validation';
 export * from './public-profile';
+export * from './rich-text';
 export * from './footer-composition';
 export * from './number-input';
 export * from './field-errors';

package/dist/_dts/core/src/rich-text.d.ts

@@ -0,0 +1,16 @@
+export type TipTapMark = {
+    type: string;
+    attrs?: Record<string, unknown>;
+};
+export type TipTapNode = {
+    type: string;
+    content?: TipTapNode[];
+    text?: string;
+    attrs?: Record<string, unknown>;
+    marks?: TipTapMark[];
+};
+export type RichTextDoc = {
+    type: 'doc';
+    content: TipTapNode[];
+};
+export declare function isCanonicalRichTextDoc(value: unknown): value is RichTextDoc;