mindoodb-app-sdk 0.0.19 → 0.0.20

package/dist/{types-nFt-aryL.d.ts → types-CQt2ObMu.d.ts}

@@ -295,13 +295,36 @@ interface MindooDBAppRichTextBlockSpan {
     value: Record<string, MindooDBAppRichTextMaterializeValue>;
 }
 type MindooDBAppRichTextSpan = MindooDBAppRichTextTextSpan | MindooDBAppRichTextBlockSpan;
+interface MindooDBAppRichTextMarkRange {
+    index: number;
+    length: number;
+    marks: Record<string, MindooDBAppRichTextMaterializeValue>;
+}
+interface MindooDBAppRichTextSpliceStep {
+    type: "splice";
+    index: number;
+    deleteCount: number;
+    insert?: string;
+    marks?: MindooDBAppRichTextMarkRange[];
+}
+type MindooDBAppRichTextStep = MindooDBAppRichTextSpliceStep;
+interface MindooDBAppRichTextStepPatch {
+    /** Path to the Automerge rich-text field inside the document payload. */
+    path: Array<string | number>;
+    /** Automerge heads of the document state these positional steps were based on. */
+    baseHeads?: string[];
+    /** Ordered rich-text positional operations to apply with Automerge splice/mark. */
+    steps: MindooDBAppRichTextStep[];
+}
 interface MindooDBAppRichTextPatch {
     /** Path to the Automerge rich-text field inside the document payload. */
     path: Array<string | number>;
     /** Automerge heads of the document state this rich-text snapshot was based on. */
     baseHeads?: string[];
     /** Full JSON-safe span snapshot to apply with Automerge `updateSpans`. */
-    spans: MindooDBAppRichTextSpan[];
+    spans?: MindooDBAppRichTextSpan[];
+    /** Ordered snapshots to apply one-by-one so each `updateSpans` diff stays transaction-sized. */
+    spansSequence?: MindooDBAppRichTextSpan[][];
     /** Optional Automerge `updateSpans` configuration, kept JSON-safe over the bridge. */
     updateSpansConfig?: Record<string, unknown>;
 }
@@ -314,6 +337,43 @@ interface MindooDBAppRichTextGetOptions {
     /** Stable revision id previously obtained from `documents.listHistory()`. */
     revisionId?: MindooDBAppDocumentRevisionId;
 }
+/** Binary Automerge snapshot of the full internal document. */
+interface MindooDBAppAutomergeSnapshot {
+    binary: Uint8Array;
+    heads: string[];
+}
+interface MindooDBAppAutomergeGetOptions {
+    /** Stable revision id previously obtained from `documents.listHistory()`. */
+    revisionId?: MindooDBAppDocumentRevisionId;
+}
+/** Raw Automerge change bytes produced by a local replica. */
+interface MindooDBAppAutomergeChangesPatch {
+    /** Heads the client had when authoring `changes`; optional, for correlation only. */
+    baseHeads?: string[];
+    /**
+     * Heads of the local replica after authoring `changes`. When provided, the
+     * apply response includes `changesSince` for incremental reconciliation.
+     */
+    replicaHeads?: string[];
+    /** Change bytes from `Automerge.getChangesSince`; merged into Haven's current doc. */
+    changes: Uint8Array[];
+}
+/** Incremental catch-up bytes for a local replica after an apply merge. */
+interface MindooDBAppAutomergeChangesSince {
+    /** Echo of `replicaHeads` from the request. */
+    sinceHeads: string[];
+    /** Changes on the merged canonical doc that the replica is missing. */
+    changes: Uint8Array[];
+}
+interface MindooDBAppAutomergePatchResult {
+    document: MindooDBAppDocument;
+    heads: string[];
+    /**
+     * Present when the request included `replicaHeads`. Apply locally with
+     * `Automerge.applyChanges` instead of reloading a full snapshot.
+     */
+    changesSince?: MindooDBAppAutomergeChangesSince;
+}
 /**
  * Sets the value at `path` inside the document payload.
  *
@@ -356,6 +416,33 @@ interface MindooDBAppJsonListDeletePatch {
     index: number;
     deleteCount: number;
 }
+/**
+ * Splices text at `path` using Automerge text semantics.
+ */
+interface MindooDBAppJsonTextSplicePatch {
+    path: Array<string | number>;
+    index: number;
+    deleteCount: number;
+    insert?: string;
+}
+/**
+ * Applies one or more marks to a text range at `path`.
+ */
+interface MindooDBAppJsonTextMarkPatch {
+    path: Array<string | number>;
+    index: number;
+    length: number;
+    marks: Record<string, MindooDBAppRichTextMaterializeValue>;
+}
+/**
+ * Removes marks from a text range at `path`.
+ */
+interface MindooDBAppJsonTextUnmarkPatch {
+    path: Array<string | number>;
+    index: number;
+    length: number;
+    names: string[];
+}
 interface MindooDBAppJsonPatch {
     /**
      * Automerge heads of the document snapshot this JSON patch was authored
@@ -367,6 +454,9 @@ interface MindooDBAppJsonPatch {
     unset?: MindooDBAppJsonUnsetPatch[];
     listInsert?: MindooDBAppJsonListInsertPatch[];
     listDelete?: MindooDBAppJsonListDeletePatch[];
+    textSplice?: MindooDBAppJsonTextSplicePatch[];
+    textMark?: MindooDBAppJsonTextMarkPatch[];
+    textUnmark?: MindooDBAppJsonTextUnmarkPatch[];
 }
 /**
  * Sparse patch payload used when updating an existing document.
@@ -386,6 +476,8 @@ interface MindooDBAppUpdateDocumentInput {
     text?: MindooDBAppTextPatch[];
     /** Rich-text span snapshots to apply at document paths. */
     richText?: MindooDBAppRichTextPatch[];
+    /** Rich-text positional steps to apply at document paths. */
+    richTextSteps?: MindooDBAppRichTextStepPatch[];
 }
 /** Query used for history lookups at a specific timestamp. */
 interface MindooDBAppHistoryQuery {
@@ -600,6 +692,22 @@ interface MindooDBAppDocumentApi {
     getHeadCursor(): Promise<MindooDBAppDocumentHeadCursorResult>;
     get(docId: string): Promise<MindooDBAppDocument | null>;
     getRichText(docId: string, path: Array<string | number>, options?: MindooDBAppRichTextGetOptions): Promise<MindooDBAppRichTextSnapshot>;
+    /**
+     * Export the full internal Automerge document as binary.
+     *
+     * **Discouraged** — prefer `getRichText`, `get`, and `documents.update` (`set`,
+     * `unset`, `text`, `richText`, `json`) unless those APIs cannot express your
+     * edits. Added for TeamEdit Word/.docx (local Automerge replica + binary flush).
+     */
+    getAutomergeSnapshot(docId: string, options?: MindooDBAppAutomergeGetOptions): Promise<MindooDBAppAutomergeSnapshot>;
+    /**
+     * Merge raw Automerge change bytes into the canonical document on Haven.
+     *
+     * **Discouraged** — prefer `documents.update` patch operations. Escape hatch
+     * for apps that host a local Automerge replica when JSON patches are insufficient.
+     * Include `replicaHeads` to receive incremental `changesSince` in the response.
+     */
+    applyAutomergeChanges(docId: string, patch: MindooDBAppAutomergeChangesPatch): Promise<MindooDBAppAutomergePatchResult>;
     create(input: MindooDBAppCreateDocumentInput): Promise<MindooDBAppDocument>;
     update(docId: string, patch: MindooDBAppUpdateDocumentInput): Promise<MindooDBAppDocument>;
     delete(docId: string): Promise<{
@@ -777,4 +885,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export type { MindooDBAppDocumentHeadCursorResult as $, MindooDBAppBridgeStreamReadRequest as A, MindooDBAppBridgeStreamWriteRequest as B, MindooDBAppBridgeThemeChangedMessage as C, MindooDBAppBridgeUiPreferencesChangedMessage as D, MindooDBAppBridgeViewportChangedMessage as E, MindooDBAppCapability as F, MindooDBAppConfiguredViewCategorizationStyle as G, MindooDBAppConfiguredViewColumn as H, MindooDBAppConfiguredViewColumnRole as I, MindooDBAppConfiguredViewExpressionMode as J, MindooDBAppConfiguredViewFieldExpression as K, MindooDBAppConfiguredViewFilterDefinition as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewFilterMode as N, MindooDBAppConfiguredViewFilterRule as O, MindooDBAppConfiguredViewFormulaExpression as P, MindooDBAppConfiguredViewFormulaFilterDefinition as Q, MindooDBAppConfiguredViewPreviewMode as R, MindooDBAppConfiguredViewRuleFilterDefinition as S, MindooDBAppConfiguredViewRuleMatchMode as T, MindooDBAppConfiguredViewRuleOperator as U, MindooDBAppConfiguredViewValueExpression as V, MindooDBAppCreateDocumentInput as W, MindooDBAppCreateViewInput as X, MindooDBAppCreateViewNavigatorInput as Y, MindooDBAppDatabaseInfo as Z, MindooDBAppDocumentApi as _, MindooDBAppBridge as a, MindooDBAppWritableAttachmentStream as a$, MindooDBAppDocumentHistoryEntry as a0, MindooDBAppDocumentListQuery as a1, MindooDBAppDocumentListResult as a2, MindooDBAppDocumentRevisionId as a3, MindooDBAppDocumentScanPreset as a4, MindooDBAppDocumentSummary as a5, MindooDBAppHistoricalDocument as a6, MindooDBAppHistoryQuery as a7, MindooDBAppHostTheme as a8, MindooDBAppJsonListDeletePatch as a9, MindooDBAppRichTextScalar as aA, MindooDBAppRichTextTextSpan as aB, MindooDBAppRuntime as aC, MindooDBAppScanAttachmentOptions as aD, MindooDBAppScanAttachmentResult as aE, MindooDBAppScopedDocId as aF, MindooDBAppScopedDocumentSummary as aG, MindooDBAppSession as aH, MindooDBAppShowMenuInput as aI, MindooDBAppShowMenuResult as aJ, MindooDBAppTextEdit as aK, MindooDBAppTextPatch as aL, MindooDBAppThemeMode as aM, MindooDBAppUiPreferences as aN, MindooDBAppUpdateDocumentInput as aO, MindooDBAppViewCursorDocumentListResult as aP, MindooDBAppViewCursorResult as aQ, MindooDBAppViewEntry as aR, MindooDBAppViewEntryKind as aS, MindooDBAppViewNavigator as aT, MindooDBAppViewNavigatorExpansionState as aU, MindooDBAppViewNavigatorOpenOptions as aV, MindooDBAppViewNavigatorPageOptions as aW, MindooDBAppViewNavigatorPageResult as aX, MindooDBAppViewNavigatorRangeQuery as aY, MindooDBAppViewNavigatorSelectionState as aZ, MindooDBAppViewport as a_, MindooDBAppJsonListInsertPatch as aa, MindooDBAppJsonPatch as ab, MindooDBAppJsonSetPatch as ac, MindooDBAppJsonUnsetPatch as ad, MindooDBAppLaunchContext as ae, MindooDBAppMenuAnchor as af, MindooDBAppMenuApi as ag, MindooDBAppMenuCommandItem as ah, MindooDBAppMenuDismissReason as ai, MindooDBAppMenuDismissedResult as aj, MindooDBAppMenuItem as ak, MindooDBAppMenuKind as al, MindooDBAppMenuPlacement as am, MindooDBAppMenuPointAnchor as an, MindooDBAppMenuRect as ao, MindooDBAppMenuRectAnchor as ap, MindooDBAppMenuSelectionResult as aq, MindooDBAppMenuSeparatorItem as ar, MindooDBAppReadableAttachmentStream as as, MindooDBAppResolvedViewDefinition as at, MindooDBAppResolvedViewSource as au, MindooDBAppRichTextBlockSpan as av, MindooDBAppRichTextGetOptions as aw, MindooDBAppRichTextImmutableString as ax, MindooDBAppRichTextMaterializeValue as ay, MindooDBAppRichTextPatch as az, MindooDBAppDatabase as b, MindooDBAppDocument as c, MindooDBAppRichTextSpan as d, MindooDBAppRichTextSnapshot as e, MindooDBAppAttachmentApi as f, MindooDBAppAttachmentChunk as g, MindooDBAppAttachmentInfo as h, MindooDBAppAttachmentPreviewOptions as i, MindooDBAppAttachmentPreviewSession as j, MindooDBAppBridgeConnectMessage as k, MindooDBAppBridgeConnectOptions as l, MindooDBAppBridgeConnectedMessage as m, MindooDBAppBridgeErrorPayload as n, MindooDBAppBridgeHandshakeErrorMessage as o, MindooDBAppBridgePortMessage as p, MindooDBAppBridgeRpcError as q, MindooDBAppBridgeRpcMessage as r, MindooDBAppBridgeRpcRequest as s, MindooDBAppBridgeRpcSuccess as t, MindooDBAppBridgeStreamAbortRequest as u, MindooDBAppBridgeStreamAck as v, MindooDBAppBridgeStreamCloseRequest as w, MindooDBAppBridgeStreamError as x, MindooDBAppBridgeStreamMessage as y, MindooDBAppBridgeStreamOpenResult as z };
+export type { MindooDBAppCreateDocumentInput as $, MindooDBAppBridgeStreamAck as A, MindooDBAppBridgeStreamCloseRequest as B, MindooDBAppBridgeStreamError as C, MindooDBAppBridgeStreamMessage as D, MindooDBAppBridgeStreamOpenResult as E, MindooDBAppBridgeStreamReadRequest as F, MindooDBAppBridgeStreamWriteRequest as G, MindooDBAppBridgeThemeChangedMessage as H, MindooDBAppBridgeUiPreferencesChangedMessage as I, MindooDBAppBridgeViewportChangedMessage as J, MindooDBAppCapability as K, MindooDBAppConfiguredViewCategorizationStyle as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewColumn as N, MindooDBAppConfiguredViewColumnRole as O, MindooDBAppConfiguredViewExpressionMode as P, MindooDBAppConfiguredViewFieldExpression as Q, MindooDBAppConfiguredViewFilterDefinition as R, MindooDBAppConfiguredViewFilterMode as S, MindooDBAppConfiguredViewFilterRule as T, MindooDBAppConfiguredViewFormulaExpression as U, MindooDBAppConfiguredViewFormulaFilterDefinition as V, MindooDBAppConfiguredViewPreviewMode as W, MindooDBAppConfiguredViewRuleFilterDefinition as X, MindooDBAppConfiguredViewRuleMatchMode as Y, MindooDBAppConfiguredViewRuleOperator as Z, MindooDBAppConfiguredViewValueExpression as _, MindooDBAppBridge as a, MindooDBAppViewCursorDocumentListResult as a$, MindooDBAppCreateViewInput as a0, MindooDBAppCreateViewNavigatorInput as a1, MindooDBAppDatabaseInfo as a2, MindooDBAppDocumentApi as a3, MindooDBAppDocumentHeadCursorResult as a4, MindooDBAppDocumentHistoryEntry as a5, MindooDBAppDocumentListQuery as a6, MindooDBAppDocumentListResult as a7, MindooDBAppDocumentRevisionId as a8, MindooDBAppDocumentScanPreset as a9, MindooDBAppReadableAttachmentStream as aA, MindooDBAppResolvedViewDefinition as aB, MindooDBAppResolvedViewSource as aC, MindooDBAppRichTextBlockSpan as aD, MindooDBAppRichTextGetOptions as aE, MindooDBAppRichTextImmutableString as aF, MindooDBAppRichTextMarkRange as aG, MindooDBAppRichTextMaterializeValue as aH, MindooDBAppRichTextPatch as aI, MindooDBAppRichTextScalar as aJ, MindooDBAppRichTextSpliceStep as aK, MindooDBAppRichTextStep as aL, MindooDBAppRichTextStepPatch as aM, MindooDBAppRichTextTextSpan as aN, MindooDBAppRuntime as aO, MindooDBAppScanAttachmentOptions as aP, MindooDBAppScanAttachmentResult as aQ, MindooDBAppScopedDocId as aR, MindooDBAppScopedDocumentSummary as aS, MindooDBAppSession as aT, MindooDBAppShowMenuInput as aU, MindooDBAppShowMenuResult as aV, MindooDBAppTextEdit as aW, MindooDBAppTextPatch as aX, MindooDBAppThemeMode as aY, MindooDBAppUiPreferences as aZ, MindooDBAppUpdateDocumentInput as a_, MindooDBAppDocumentSummary as aa, MindooDBAppHistoricalDocument as ab, MindooDBAppHistoryQuery as ac, MindooDBAppHostTheme as ad, MindooDBAppJsonListDeletePatch as ae, MindooDBAppJsonListInsertPatch as af, MindooDBAppJsonPatch as ag, MindooDBAppJsonSetPatch as ah, MindooDBAppJsonTextMarkPatch as ai, MindooDBAppJsonTextSplicePatch as aj, MindooDBAppJsonTextUnmarkPatch as ak, MindooDBAppJsonUnsetPatch as al, MindooDBAppLaunchContext as am, MindooDBAppMenuAnchor as an, MindooDBAppMenuApi as ao, MindooDBAppMenuCommandItem as ap, MindooDBAppMenuDismissReason as aq, MindooDBAppMenuDismissedResult as ar, MindooDBAppMenuItem as as, MindooDBAppMenuKind as at, MindooDBAppMenuPlacement as au, MindooDBAppMenuPointAnchor as av, MindooDBAppMenuRect as aw, MindooDBAppMenuRectAnchor as ax, MindooDBAppMenuSelectionResult as ay, MindooDBAppMenuSeparatorItem as az, MindooDBAppDatabase as b, MindooDBAppViewCursorResult as b0, MindooDBAppViewEntry as b1, MindooDBAppViewEntryKind as b2, MindooDBAppViewNavigator as b3, MindooDBAppViewNavigatorExpansionState as b4, MindooDBAppViewNavigatorOpenOptions as b5, MindooDBAppViewNavigatorPageOptions as b6, MindooDBAppViewNavigatorPageResult as b7, MindooDBAppViewNavigatorRangeQuery as b8, MindooDBAppViewNavigatorSelectionState as b9, MindooDBAppViewport as ba, MindooDBAppWritableAttachmentStream as bb, MindooDBAppDocument as c, MindooDBAppRichTextSpan as d, MindooDBAppRichTextSnapshot as e, MindooDBAppAttachmentApi as f, MindooDBAppAttachmentChunk as g, MindooDBAppAttachmentInfo as h, MindooDBAppAttachmentPreviewOptions as i, MindooDBAppAttachmentPreviewSession as j, MindooDBAppAutomergeChangesPatch as k, MindooDBAppAutomergeChangesSince as l, MindooDBAppAutomergeGetOptions as m, MindooDBAppAutomergePatchResult as n, MindooDBAppAutomergeSnapshot as o, MindooDBAppBridgeConnectMessage as p, MindooDBAppBridgeConnectOptions as q, MindooDBAppBridgeConnectedMessage as r, MindooDBAppBridgeErrorPayload as s, MindooDBAppBridgeHandshakeErrorMessage as t, MindooDBAppBridgePortMessage as u, MindooDBAppBridgeRpcError as v, MindooDBAppBridgeRpcMessage as w, MindooDBAppBridgeRpcRequest as x, MindooDBAppBridgeRpcSuccess as y, MindooDBAppBridgeStreamAbortRequest as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "engines": {
     "node": ">=22.13.0"
   },
@@ -39,6 +39,7 @@
     "mindoodb-view-language": "0.0.13"
   },
   "devDependencies": {
+    "@automerge/automerge": "^3.2.1",
     "@types/node": "25.5.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",