mindoodb-app-sdk 0.0.20 → 0.0.27

package/dist/types-CQt2ObMu.d.ts

@@ -1,888 +0,0 @@
-import { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppViewSortDirection, MindooDBAppViewTotalMode, MindooDBAppViewDefinition } from 'mindoodb-view-language';
-
-/** Launch target used by the Haven when opening an app. */
-type MindooDBAppRuntime = "iframe" | "window";
-/** Theme mode currently active in the Haven host UI. */
-type MindooDBAppThemeMode = "light" | "dark";
-/** Host theme snapshot exposed to running apps. */
-interface MindooDBAppHostTheme {
-    mode: MindooDBAppThemeMode;
-    preset: string;
-}
-/** Iframe viewport dimensions reported by the Haven host. */
-interface MindooDBAppViewport {
-    width: number;
-    height: number;
-}
-/** Host-controlled UI preferences exposed to embedded apps. */
-interface MindooDBAppUiPreferences {
-    iosMultitaskingOptimized: boolean;
-}
-/** Saved categorization mode for Haven-managed view mappings delivered at launch time. */
-type MindooDBAppConfiguredViewCategorizationStyle = "document_then_category" | "category_then_document";
-/** Preferred preview layout for a Haven-managed view mapping. */
-type MindooDBAppConfiguredViewPreviewMode = "tree" | "table";
-/** Column role used by Haven-managed view mappings. */
-type MindooDBAppConfiguredViewColumnRole = "category" | "sort" | "display" | "total";
-/** Filter authoring mode used by Haven-managed view mappings. */
-type MindooDBAppConfiguredViewFilterMode = "rules" | "formula";
-/** Rule match mode used by visual-rule filters. */
-type MindooDBAppConfiguredViewRuleMatchMode = "all" | "any";
-/** Visual-rule operator supported by Haven-managed view mappings. */
-type MindooDBAppConfiguredViewRuleOperator = "eq" | "neq" | "contains" | "notContains" | "gt" | "gte" | "lt" | "lte" | "exists" | "notExists";
-/** Field/formula authoring modes for Haven-managed view columns. */
-type MindooDBAppConfiguredViewExpressionMode = "field" | "formula";
-/** One visual filter rule inside a Haven-managed view mapping. */
-interface MindooDBAppConfiguredViewFilterRule {
-    id: string;
-    field: string;
-    operator: MindooDBAppConfiguredViewRuleOperator;
-    value?: string;
-}
-/** Field-based value expression used by Haven-managed view mappings. */
-interface MindooDBAppConfiguredViewFieldExpression {
-    mode: "field";
-    field: string;
-}
-/** Formula-based value expression used by Haven-managed view mappings. */
-interface MindooDBAppConfiguredViewFormulaExpression {
-    mode: "formula";
-    expression: MindooDBAppExpression;
-}
-/** Column expression authoring shape used by Haven-managed view mappings. */
-type MindooDBAppConfiguredViewValueExpression = MindooDBAppConfiguredViewFieldExpression | MindooDBAppConfiguredViewFormulaExpression;
-/** Rule-based filter stored by Haven for app-owned view mappings. */
-interface MindooDBAppConfiguredViewRuleFilterDefinition {
-    mode: "rules";
-    match: MindooDBAppConfiguredViewRuleMatchMode;
-    rules: MindooDBAppConfiguredViewFilterRule[];
-}
-/** Formula-based filter stored by Haven for app-owned view mappings. */
-interface MindooDBAppConfiguredViewFormulaFilterDefinition {
-    mode: "formula";
-    expression: MindooDBAppBooleanExpression;
-}
-/** Full filter authoring shape stored for Haven-managed app view mappings. */
-type MindooDBAppConfiguredViewFilterDefinition = MindooDBAppConfiguredViewRuleFilterDefinition | MindooDBAppConfiguredViewFormulaFilterDefinition;
-/** Column definition stored for a Haven-managed app view mapping. */
-interface MindooDBAppConfiguredViewColumn {
-    id: string;
-    title: string;
-    name: string;
-    role: MindooDBAppConfiguredViewColumnRole;
-    expression: MindooDBAppConfiguredViewValueExpression;
-    sorting: MindooDBAppViewSortDirection;
-    totalMode: MindooDBAppViewTotalMode;
-    hidden: boolean;
-}
-/** One resolved source binding for an app-owned Haven view mapping. */
-interface MindooDBAppResolvedViewSource {
-    origin: string;
-    databaseId: string;
-    title: string;
-    targetMode: "local" | "server";
-    connectionId?: string;
-    tenantId: string;
-    databaseName: string;
-}
-/** Full Haven-managed view mapping delivered to the running application at launch time. */
-interface MindooDBAppResolvedViewDefinition {
-    id: string;
-    description?: string;
-    categorizationStyle: MindooDBAppConfiguredViewCategorizationStyle;
-    previewMode: MindooDBAppConfiguredViewPreviewMode;
-    sources: MindooDBAppResolvedViewSource[];
-    filter: MindooDBAppConfiguredViewFilterDefinition;
-    columns: MindooDBAppConfiguredViewColumn[];
-}
-/** Permission/capability flags exposed for a database binding inside the app session. */
-type MindooDBAppCapability = "read" | "create" | "update" | "delete" | "history" | "attachments" | "views";
-/** Metadata about the current app launch supplied by the Haven host. */
-interface MindooDBAppLaunchContext {
-    appId: string;
-    appInstanceId: string;
-    appVersion?: string;
-    launchId: string;
-    runtime: MindooDBAppRuntime;
-    theme: MindooDBAppHostTheme;
-    viewport: MindooDBAppViewport | null;
-    uiPreferences: MindooDBAppUiPreferences;
-    tenantId?: string;
-    preferredDatabaseId?: string;
-    /**
-     * Epoch-millisecond cutoff when the host opened app databases in time travel
-     * read-only mode. Absent/null means the app is looking at live data.
-     */
-    timeTravelDate?: number | null;
-    user: {
-        id: string;
-        username: string;
-    };
-    launchParameters: Record<string, string>;
-    databases: MindooDBAppDatabaseInfo[];
-    views: MindooDBAppResolvedViewDefinition[];
-}
-/** Attachment metadata returned by the attachment APIs. */
-interface MindooDBAppAttachmentInfo {
-    attachmentId: string;
-    fileName: string;
-    mimeType: string;
-    size: number;
-}
-/** Preview modes supported by the Haven-hosted attachment preview dialog. */
-type MindooDBAppAttachmentPreviewMode = "image" | "pdf" | "text" | "markdown" | "docx" | "pptx" | "spreadsheet" | "video" | "audio";
-/** Optional parameters for opening an attachment preview in Haven. */
-interface MindooDBAppAttachmentPreviewOptions {
-    /** Historical snapshot timestamp previously obtained from `documents.history.getAtTimestamp()`. */
-    timestamp?: number;
-    /** Stable revision id previously obtained from `documents.listHistory()`. */
-    revisionId?: MindooDBAppDocumentRevisionId;
-}
-type MindooDBAppDocumentScanPreset = "auto" | "a4-portrait" | "a4-landscape" | "letter-portrait" | "letter-landscape";
-interface MindooDBAppScanAttachmentOptions {
-    defaultFileName?: string;
-    preset?: MindooDBAppDocumentScanPreset;
-    mimeType?: "image/jpeg" | "image/png" | "application/pdf";
-}
-interface MindooDBAppScanAttachmentResult {
-    ok: boolean;
-    attachment?: MindooDBAppAttachmentInfo | null;
-}
-/** Resolved Haven preview session prepared for opening in a separate tab or window. */
-interface MindooDBAppAttachmentPreviewSession {
-    sessionId: string;
-    previewUrl: string;
-}
-/** Database entry visible to the app during launch and database listing. */
-interface MindooDBAppDatabaseInfo {
-    id: string;
-    title: string;
-    role?: string;
-    capabilities: MindooDBAppCapability[];
-}
-/** Lightweight document row returned by list operations. */
-interface MindooDBAppDocumentSummary {
-    id: string;
-    data?: Record<string, unknown>;
-    attachmentCount?: number;
-    createdAt?: string;
-    updatedAt?: string;
-    identityLabel?: string;
-    publicKeyFingerprint?: string;
-    isDeleted?: boolean;
-}
-/** Fully loaded document returned by `get()`, `create()`, or `update()`. */
-interface MindooDBAppDocument {
-    id: string;
-    data: Record<string, unknown>;
-    /** Current Automerge heads for causal text edit reconciliation. */
-    heads?: string[];
-    attachments?: MindooDBAppAttachmentInfo[];
-    createdAt?: string;
-    updatedAt?: string;
-}
-/** Opaque persisted id for a document revision in the MindooDB DAG. */
-type MindooDBAppDocumentRevisionId = string;
-/** One entry in the document history timeline. */
-interface MindooDBAppDocumentHistoryEntry {
-    revisionId: MindooDBAppDocumentRevisionId;
-    timestamp: number;
-    heads?: string[];
-    publicKey: string;
-    publicKeyFingerprint?: string;
-    identityLabel?: string;
-    isDeleted: boolean;
-    isCurrent: boolean;
-    summary?: string;
-}
-/** Historical snapshot returned for a document at a specific timestamp. */
-interface MindooDBAppHistoricalDocument {
-    id: string;
-    revisionId?: MindooDBAppDocumentRevisionId;
-    timestamp: number;
-    heads?: string[];
-    state: "missing" | "deleted" | "exists";
-    data: Record<string, unknown> | null;
-    attachments?: MindooDBAppAttachmentInfo[];
-    attachmentSnapshotRevisionId?: MindooDBAppDocumentRevisionId | null;
-}
-/** Query options for paging through changefeed-backed document listings in a database. */
-interface MindooDBAppDocumentListQuery {
-    cursor?: string | null;
-    limit?: number;
-    skip?: number;
-    status?: "all" | "existing" | "deleted";
-    metadataOnly?: boolean;
-    fields?: string[];
-    filter?: Record<string, unknown>;
-}
-/** Paged result returned by `documents.list()`. */
-interface MindooDBAppDocumentListResult {
-    items: MindooDBAppDocumentSummary[];
-    nextCursor: string | null;
-}
-/** Latest known changefeed cursor for a database. */
-interface MindooDBAppDocumentHeadCursorResult {
-    cursor: string | null;
-}
-/** Opaque cursor representing the DB state reflected in a bridge-built view snapshot. */
-interface MindooDBAppViewCursorResult {
-    viewCursor: string | null;
-}
-/** Lightweight document row returned by multi-source view-cursor delta queries. */
-interface MindooDBAppScopedDocumentSummary extends MindooDBAppDocumentSummary {
-    origin: string;
-    databaseId: string;
-}
-/** Result returned when querying document changes since a view snapshot cursor. */
-interface MindooDBAppViewCursorDocumentListResult {
-    items: MindooDBAppScopedDocumentSummary[];
-    nextCursor: string | null;
-}
-/**
- * Payload used when creating a new document.
- *
- * `set` becomes the initial top-level document state, mirroring the update
- * API's field-assignment language while still creating a brand-new document.
- */
-interface MindooDBAppCreateDocumentInput {
-    set: Record<string, unknown>;
-    /** Optional named document key. Defaults to `"default"` when omitted. */
-    decryptionKeyId?: string;
-    /**
-     * Optional caller-provided document id. When omitted, MindooDB generates a
-     * UUID7. When provided, the id must match `^[A-Za-z][A-Za-z0-9_]*$`: the
-     * first character is an ASCII letter and subsequent characters may be ASCII
-     * letters, ASCII digits, or `_`.
-     *
-     * If a document with this id already exists locally, MindooDB returns the
-     * existing document instead of creating a new one (idempotent create), and
-     * the values in `set` are NOT applied. Caller-provided ids are useful for
-     * loading a known well-known document directly without first building a
-     * view, and for migrations that want to preserve external ids.
-     *
-     * Documents created with the same caller-provided id on independent replicas
-     * share Automerge ancestry, so subsequent edits on either replica still
-     * merge correctly when the replicas sync.
-     */
-    id?: string;
-}
-interface MindooDBAppTextEdit {
-    index: number;
-    deleteCount: number;
-    insert?: string;
-}
-interface MindooDBAppTextPatch {
-    path: Array<string | number>;
-    baseHeads?: string[];
-    edits: MindooDBAppTextEdit[];
-}
-type MindooDBAppRichTextScalar = string | number | boolean | null;
-interface MindooDBAppRichTextImmutableString {
-    type: "immutableString";
-    value: string;
-}
-type MindooDBAppRichTextMaterializeValue = MindooDBAppRichTextScalar | MindooDBAppRichTextImmutableString | MindooDBAppRichTextMaterializeValue[] | {
-    [key: string]: MindooDBAppRichTextMaterializeValue;
-};
-interface MindooDBAppRichTextTextSpan {
-    type: "text";
-    value: string;
-    marks?: Record<string, MindooDBAppRichTextMaterializeValue>;
-}
-interface MindooDBAppRichTextBlockSpan {
-    type: "block";
-    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[];
-    /** 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>;
-}
-interface MindooDBAppRichTextSnapshot {
-    path: Array<string | number>;
-    heads?: string[];
-    spans: MindooDBAppRichTextSpan[];
-}
-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.
- *
- * Creates the field if it does not exist, or replaces the existing value.
- * `path` addresses a property using object keys and list indices, for example
- * `["workbook", "worksheetsById", "ws-1", "title"]`.
- */
-interface MindooDBAppJsonSetPatch {
-    path: Array<string | number>;
-    value: unknown;
-}
-/**
- * Removes the value at `path` from the document payload.
- *
- * For object properties this deletes the key; for list entries the host
- * decides whether unset is supported and may reject the patch.
- */
-interface MindooDBAppJsonUnsetPatch {
-    path: Array<string | number>;
-}
-/**
- * Inserts one or more values into the list located at `path`.
- *
- * `index` is the insertion point within the current list, where `0` prepends
- * and `list.length` appends. Existing entries at or after `index` shift right.
- */
-interface MindooDBAppJsonListInsertPatch {
-    path: Array<string | number>;
-    index: number;
-    values: unknown[];
-}
-/**
- * Deletes a contiguous run of entries from the list located at `path`.
- *
- * Removes `deleteCount` entries starting at `index`. Subsequent entries shift
- * left to fill the gap.
- */
-interface MindooDBAppJsonListDeletePatch {
-    path: Array<string | number>;
-    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
-     * against. Hosts can use this to apply order-sensitive edits at the original
-     * causal version and merge them with concurrent changes.
-     */
-    baseHeads?: string[];
-    set?: MindooDBAppJsonSetPatch[];
-    unset?: MindooDBAppJsonUnsetPatch[];
-    listInsert?: MindooDBAppJsonListInsertPatch[];
-    listDelete?: MindooDBAppJsonListDeletePatch[];
-    textSplice?: MindooDBAppJsonTextSplicePatch[];
-    textMark?: MindooDBAppJsonTextMarkPatch[];
-    textUnmark?: MindooDBAppJsonTextUnmarkPatch[];
-}
-/**
- * Sparse patch payload used when updating an existing document.
- *
- * Prefer targeted `set` / `unset` operations over whole-document rewrites so
- * MindooDB can preserve more meaningful change history and Automerge can merge
- * smaller, more intentional updates.
- */
-interface MindooDBAppUpdateDocumentInput {
-    /** Top-level fields to assign on the document. */
-    set?: Record<string, unknown>;
-    /** Top-level fields to remove from the document entirely. */
-    unset?: string[];
-    /** Granular JSON operations to apply at document paths. */
-    json?: MindooDBAppJsonPatch;
-    /** Granular text edits to apply at document paths. */
-    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 {
-    timestamp: number;
-}
-/** Optional parameters for establishing the app bridge connection. */
-interface MindooDBAppBridgeConnectOptions {
-    launchId?: string;
-    targetOrigin?: string;
-    connectTimeoutMs?: number;
-}
-/** Initial postMessage handshake sent from the app to the Haven. */
-interface MindooDBAppBridgeConnectMessage {
-    protocol: "mindoodb-app-bridge";
-    type: "mindoodb-app:connect";
-    launchId: string;
-}
-/** Handshake acknowledgement returned by the Haven host. */
-interface MindooDBAppBridgeConnectedMessage {
-    protocol: "mindoodb-app-bridge";
-    type: "mindoodb-app:connected";
-}
-/** Handshake error returned when the Haven host rejects a launch. */
-interface MindooDBAppBridgeHandshakeErrorMessage {
-    protocol: "mindoodb-app-bridge";
-    type: "mindoodb-app:error";
-    error: string;
-}
-/** Structured error payload transported over bridge RPC or stream messages. */
-interface MindooDBAppBridgeErrorPayload {
-    code: string;
-    message: string;
-}
-/** Request envelope used by the port-based RPC transport. */
-interface MindooDBAppBridgeRpcRequest<TParams = unknown> {
-    protocol: "mindoodb-app-bridge";
-    kind: "request";
-    id: string;
-    method: string;
-    params: TParams;
-}
-/** Successful RPC response envelope. */
-interface MindooDBAppBridgeRpcSuccess<TResult = unknown> {
-    protocol: "mindoodb-app-bridge";
-    kind: "success";
-    id: string;
-    result: TResult;
-}
-/** Failed RPC response envelope. */
-interface MindooDBAppBridgeRpcError {
-    protocol: "mindoodb-app-bridge";
-    kind: "error";
-    id: string;
-    error: MindooDBAppBridgeErrorPayload;
-}
-/** Union of all RPC-level bridge messages. */
-type MindooDBAppBridgeRpcMessage = MindooDBAppBridgeRpcRequest | MindooDBAppBridgeRpcSuccess | MindooDBAppBridgeRpcError;
-/** Result returned when the host opens a streamed attachment channel. */
-interface MindooDBAppBridgeStreamOpenResult {
-    streamId: string;
-}
-/** Request asking the host for the next chunk on a read stream. */
-interface MindooDBAppBridgeStreamReadRequest {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-read";
-    streamId: string;
-}
-/** Request sending one chunk over a write stream. */
-interface MindooDBAppBridgeStreamWriteRequest {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-write";
-    streamId: string;
-    chunk: ArrayBuffer;
-}
-/** Request closing a stream gracefully. */
-interface MindooDBAppBridgeStreamCloseRequest {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-close";
-    streamId: string;
-}
-/** Request aborting a stream due to cancellation or failure. */
-interface MindooDBAppBridgeStreamAbortRequest {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-abort";
-    streamId: string;
-}
-/** Streamed attachment payload delivered over the message port. */
-interface MindooDBAppAttachmentChunk {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-chunk";
-    streamId: string;
-    chunk?: ArrayBuffer;
-    done: boolean;
-}
-/** Host acknowledgement for a write/close/abort stream request. */
-interface MindooDBAppBridgeStreamAck {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-ack";
-    streamId: string;
-}
-/** Stream-level error message. */
-interface MindooDBAppBridgeStreamError {
-    protocol: "mindoodb-app-bridge";
-    kind: "stream-error";
-    streamId: string;
-    error: MindooDBAppBridgeErrorPayload;
-}
-/** Union of all non-RPC stream transport messages. */
-type MindooDBAppBridgeStreamMessage = MindooDBAppBridgeStreamReadRequest | MindooDBAppBridgeStreamWriteRequest | MindooDBAppBridgeStreamCloseRequest | MindooDBAppBridgeStreamAbortRequest | MindooDBAppAttachmentChunk | MindooDBAppBridgeStreamAck | MindooDBAppBridgeStreamError;
-/** Host-pushed event emitted when the Haven theme changes. */
-interface MindooDBAppBridgeThemeChangedMessage {
-    protocol: "mindoodb-app-bridge";
-    kind: "theme-changed";
-    theme: MindooDBAppHostTheme;
-}
-/** Host-pushed event emitted when the Haven iframe viewport changes. */
-interface MindooDBAppBridgeViewportChangedMessage {
-    protocol: "mindoodb-app-bridge";
-    kind: "viewport-changed";
-    viewport: MindooDBAppViewport;
-}
-/** Host-pushed event emitted when host-controlled UI preferences change. */
-interface MindooDBAppBridgeUiPreferencesChangedMessage {
-    protocol: "mindoodb-app-bridge";
-    kind: "ui-preferences-changed";
-    uiPreferences: MindooDBAppUiPreferences;
-}
-/** Any message that can travel across the dedicated bridge MessagePort. */
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage;
-/** Placement hint for a host-rendered overlay menu. */
-type MindooDBAppMenuPlacement = "auto" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "right-start" | "left-start";
-/** Semantic hint allowing Haven to tune menu behavior or styling. */
-type MindooDBAppMenuKind = "context" | "dropdown" | "picker";
-/** Rectangle expressed in app-viewport coordinates. */
-interface MindooDBAppMenuRect {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-/** Point anchor used for context menus or other click-triggered overlays. */
-interface MindooDBAppMenuPointAnchor {
-    type: "point";
-    x: number;
-    y: number;
-}
-/** Rectangle anchor used for toolbar menus or picker buttons. */
-interface MindooDBAppMenuRectAnchor {
-    type: "rect";
-    rect: MindooDBAppMenuRect;
-}
-/** Anchor describing where the host should position the rendered menu. */
-type MindooDBAppMenuAnchor = MindooDBAppMenuPointAnchor | MindooDBAppMenuRectAnchor;
-/** Visual separator between menu groups. */
-interface MindooDBAppMenuSeparatorItem {
-    separator: true;
-}
-/** One actionable entry in a structured host-rendered menu. */
-interface MindooDBAppMenuCommandItem {
-    id: string;
-    label: string;
-    enabled?: boolean;
-    destructive?: boolean;
-    checked?: boolean;
-    items?: MindooDBAppMenuItem[];
-}
-/** Structured menu item transported over the app bridge. */
-type MindooDBAppMenuItem = MindooDBAppMenuSeparatorItem | MindooDBAppMenuCommandItem;
-/** Request payload for a host-rendered overlay menu. */
-interface MindooDBAppShowMenuInput {
-    anchor: MindooDBAppMenuAnchor;
-    placement?: MindooDBAppMenuPlacement;
-    kind?: MindooDBAppMenuKind;
-    items: MindooDBAppMenuItem[];
-    dismissOnOutsideClick?: boolean;
-    dismissOnEscape?: boolean;
-    dismissOnViewportChange?: boolean;
-}
-/** Reason why a host-rendered menu was dismissed without a selection. */
-type MindooDBAppMenuDismissReason = "outside_click" | "escape" | "app_blur" | "viewport_change" | "hide" | "replaced";
-/** Successful selection result returned from a host-rendered menu. */
-interface MindooDBAppMenuSelectionResult {
-    action: "selected";
-    itemId: string;
-}
-/** Dismissal result returned from a host-rendered menu. */
-interface MindooDBAppMenuDismissedResult {
-    action: "dismissed";
-    reason: MindooDBAppMenuDismissReason;
-}
-/** Result returned when Haven closes or resolves a host-rendered menu. */
-type MindooDBAppShowMenuResult = MindooDBAppMenuSelectionResult | MindooDBAppMenuDismissedResult;
-/** Overlay menu operations exposed by the host session. */
-interface MindooDBAppMenuApi {
-    show(input: MindooDBAppShowMenuInput): Promise<MindooDBAppShowMenuResult>;
-    hide(): Promise<void>;
-}
-/** Pull-based read stream for document attachments. */
-interface MindooDBAppReadableAttachmentStream {
-    read(): Promise<Uint8Array | null>;
-    close(): Promise<void>;
-}
-/** Push-based write stream for document attachments. */
-interface MindooDBAppWritableAttachmentStream {
-    write(chunk: Uint8Array): Promise<void>;
-    close(): Promise<void>;
-    abort(): Promise<void>;
-}
-/** Document operations exposed by an opened database handle. */
-interface MindooDBAppDocumentApi {
-    list(query?: MindooDBAppDocumentListQuery): Promise<MindooDBAppDocumentListResult>;
-    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<{
-        ok: true;
-    }>;
-    undelete(docId: string): Promise<{
-        ok: true;
-    }>;
-    listHistory(docId: string): Promise<MindooDBAppDocumentHistoryEntry[]>;
-    getAtTimestamp(docId: string, timestamp: number): Promise<MindooDBAppHistoricalDocument>;
-    getAtRevision(docId: string, revisionId: MindooDBAppDocumentRevisionId): Promise<MindooDBAppHistoricalDocument>;
-}
-type MindooDBAppViewEntryKind = "category" | "document";
-/** Unique document identity within a multi-source view. */
-interface MindooDBAppScopedDocId {
-    origin: string;
-    docId: string;
-}
-/** Serialized view entry returned by the navigator APIs. */
-interface MindooDBAppViewEntry {
-    /** Unique occurrence key within the current navigator session. */
-    key: string;
-    kind: MindooDBAppViewEntryKind;
-    origin: string;
-    docId: string | null;
-    level: number;
-    parentKey: string | null;
-    categoryPath: unknown[];
-    categoryValue: unknown | null;
-    columnValues: Record<string, unknown>;
-    childCount?: number;
-    descendantDocumentCount?: number;
-    descendantCount?: number;
-    descendantCategoryCount?: number;
-    childCategoryCount?: number;
-    childDocumentCount?: number;
-    siblingCount?: number;
-    /** Stable continuation token for the current occurrence. */
-    position: string | null;
-    expanded: boolean;
-    selected: boolean;
-    isVisible: boolean;
-}
-/** Options that shape which subtree and entry kinds a navigator exposes. */
-interface MindooDBAppViewNavigatorOpenOptions {
-    includeCategories?: boolean;
-    includeDocuments?: boolean;
-    hideEmptyCategories?: boolean;
-    rootCategoryPath?: unknown[];
-    rootEntryKey?: string;
-}
-/** Input used when creating a dynamic view and immediately opening a navigator. */
-interface MindooDBAppCreateViewNavigatorInput {
-    databaseIds: string[];
-    definition: MindooDBAppViewDefinition;
-    categorizationStyle?: MindooDBAppConfiguredViewCategorizationStyle;
-    options?: MindooDBAppViewNavigatorOpenOptions;
-}
-/** @deprecated Use `MindooDBAppCreateViewNavigatorInput`. */
-type MindooDBAppCreateViewInput = MindooDBAppCreateViewNavigatorInput;
-/** Range query options for key and key-range lookups within a category. */
-interface MindooDBAppViewNavigatorRangeQuery {
-    startKey?: unknown;
-    endKey?: unknown;
-    descending?: boolean;
-    exact?: boolean;
-}
-/** Options for batched navigator reads. */
-interface MindooDBAppViewNavigatorPageOptions {
-    limit?: number;
-    selectedOnly?: boolean;
-    startPosition?: string | null;
-}
-/** Paged batch of navigator entries. */
-interface MindooDBAppViewNavigatorPageResult {
-    entries: MindooDBAppViewEntry[];
-    nextPosition: string | null;
-    hasMore: boolean;
-}
-/** Serializable selection state for restoring a navigator session. */
-interface MindooDBAppViewNavigatorSelectionState {
-    selectAllByDefault: boolean;
-    entryKeys: string[];
-}
-/** Serializable expansion state for restoring a navigator session. */
-interface MindooDBAppViewNavigatorExpansionState {
-    expandAllByDefault: boolean;
-    expandLevel: number;
-    entryKeys: string[];
-}
-/** Stateful view navigator that closely mirrors the core VirtualViewNavigator. */
-interface MindooDBAppViewNavigator {
-    getDefinition(): Promise<MindooDBAppViewDefinition>;
-    getViewCursor(): Promise<string | null>;
-    refresh(): Promise<string | null>;
-    getCurrentEntry(): Promise<MindooDBAppViewEntry | null>;
-    gotoFirst(): Promise<boolean>;
-    gotoLast(): Promise<boolean>;
-    gotoNext(): Promise<boolean>;
-    gotoPrev(): Promise<boolean>;
-    gotoNextSibling(): Promise<boolean>;
-    gotoPrevSibling(): Promise<boolean>;
-    gotoParent(): Promise<boolean>;
-    gotoFirstChild(): Promise<boolean>;
-    gotoLastChild(): Promise<boolean>;
-    gotoPos(position: string): Promise<boolean>;
-    getPos(position: string): Promise<MindooDBAppViewEntry | null>;
-    findCategoryEntryByParts(parts: unknown[]): Promise<MindooDBAppViewEntry | null>;
-    entriesForward(options?: MindooDBAppViewNavigatorPageOptions): Promise<MindooDBAppViewNavigatorPageResult>;
-    entriesBackward(options?: MindooDBAppViewNavigatorPageOptions): Promise<MindooDBAppViewNavigatorPageResult>;
-    gotoNextSelected(): Promise<boolean>;
-    gotoPrevSelected(): Promise<boolean>;
-    select(origin: string, docId: string, selectParentCategories?: boolean): Promise<void>;
-    deselect(origin: string, docId: string): Promise<void>;
-    selectAllEntries(): Promise<void>;
-    deselectAllEntries(): Promise<void>;
-    isSelected(origin: string, docId: string): Promise<boolean>;
-    getSelectionState(): Promise<MindooDBAppViewNavigatorSelectionState>;
-    setSelectionState(state: MindooDBAppViewNavigatorSelectionState): Promise<void>;
-    expand(origin: string, docId: string): Promise<void>;
-    collapse(origin: string, docId: string): Promise<void>;
-    expandAll(): Promise<void>;
-    collapseAll(): Promise<void>;
-    expandToLevel(level: number): Promise<void>;
-    isExpanded(entryKey: string): Promise<boolean>;
-    getExpansionState(): Promise<MindooDBAppViewNavigatorExpansionState>;
-    setExpansionState(state: MindooDBAppViewNavigatorExpansionState): Promise<void>;
-    childEntries(entryKey: string, descending?: boolean): Promise<MindooDBAppViewEntry[]>;
-    childCategories(entryKey: string, descending?: boolean): Promise<MindooDBAppViewEntry[]>;
-    childDocuments(entryKey: string, descending?: boolean): Promise<MindooDBAppViewEntry[]>;
-    childCategoriesByKey(entryKey: string, key: unknown, exact?: boolean, descending?: boolean): Promise<MindooDBAppViewEntry[]>;
-    childDocumentsByKey(entryKey: string, key: unknown, exact?: boolean, descending?: boolean): Promise<MindooDBAppViewEntry[]>;
-    childCategoriesBetween(entryKey: string, range: MindooDBAppViewNavigatorRangeQuery): Promise<MindooDBAppViewEntry[]>;
-    childDocumentsBetween(entryKey: string, range: MindooDBAppViewNavigatorRangeQuery): Promise<MindooDBAppViewEntry[]>;
-    getSortedDocIds(descending?: boolean): Promise<MindooDBAppScopedDocId[]>;
-    getSortedDocIdsScoped(entryKey: string, descending?: boolean): Promise<MindooDBAppScopedDocId[]>;
-    dispose(): Promise<void>;
-}
-/** Attachment operations exposed by an opened database handle. */
-interface MindooDBAppAttachmentApi {
-    list(docId: string, options?: MindooDBAppAttachmentPreviewOptions): Promise<MindooDBAppAttachmentInfo[]>;
-    remove(docId: string, attachmentName: string): Promise<{
-        ok: true;
-    }>;
-    openReadStream(docId: string, attachmentName: string, options?: MindooDBAppAttachmentPreviewOptions): Promise<MindooDBAppReadableAttachmentStream>;
-    openWriteStream(docId: string, attachmentName: string, contentType?: string): Promise<MindooDBAppWritableAttachmentStream>;
-    scan(docId: string, options?: MindooDBAppScanAttachmentOptions): Promise<MindooDBAppScanAttachmentResult>;
-    preparePreviewSession(docId: string, attachmentName: string, options?: MindooDBAppAttachmentPreviewOptions): Promise<MindooDBAppAttachmentPreviewSession>;
-    openPreview(docId: string, attachmentName: string, options?: MindooDBAppAttachmentPreviewOptions): Promise<{
-        ok: true;
-    }>;
-}
-/** Database handle returned from `session.openDatabase()`. */
-interface MindooDBAppDatabase {
-    info(): Promise<MindooDBAppDatabaseInfo>;
-    documents: MindooDBAppDocumentApi;
-    attachments: MindooDBAppAttachmentApi;
-}
-/** Connected session between the running app and the Haven host. */
-interface MindooDBAppSession {
-    getLaunchContext(): Promise<MindooDBAppLaunchContext>;
-    listDatabases(): Promise<MindooDBAppDatabaseInfo[]>;
-    openDatabase(databaseId: string): Promise<MindooDBAppDatabase>;
-    listDocumentsSinceViewCursor(cursor: string | null): Promise<MindooDBAppViewCursorDocumentListResult>;
-    createViewNavigator(input: MindooDBAppCreateViewNavigatorInput): Promise<MindooDBAppViewNavigator>;
-    openViewNavigator(viewId: string, options?: MindooDBAppViewNavigatorOpenOptions): Promise<MindooDBAppViewNavigator>;
-    menus: MindooDBAppMenuApi;
-    onThemeChange(listener: (theme: MindooDBAppHostTheme) => void): () => void;
-    onViewportChange(listener: (viewport: MindooDBAppViewport) => void): () => void;
-    onUiPreferencesChange(listener: (uiPreferences: MindooDBAppUiPreferences) => void): () => void;
-    disconnect(): Promise<void>;
-}
-/** Root SDK bridge object used to establish a session. */
-interface MindooDBAppBridge {
-    connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
-}
-
-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 };