mindoodb-app-sdk 0.0.19 → 0.0.26

package/dist/types-nFt-aryL.d.ts

@@ -1,780 +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 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[];
-    /** 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;
-}
-/**
- * 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;
-}
-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[];
-}
-/**
- * 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[];
-}
-/** 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>;
-    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 { 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 };