mindoodb-app-sdk 0.0.10 → 0.0.12

package/README.md

@@ -107,10 +107,31 @@ session.onViewportChange((viewport) => {
 const db = await session.openDatabase(ctx.databases[0]!.id);
 const result = await db.documents.list({ limit: 25 });
 console.log("Documents:", result.items);
+
+// 5. Open a Haven-configured view
+//
+// A "view" is a pre-built, categorized query that a Haven administrator
+// attaches to your app (think: a pivot table over one or more databases).
+// `ctx.views` is the list of views that were made available at launch time.
+// `openViewNavigator()` returns a stateful "cursor" over the view's rows
+// that you can page through and navigate entry by entry.
+if (ctx.views[0]) {
+  const viewNav = await session.openViewNavigator(ctx.views[0].id);
+
+  // Move the cursor to the first row and read a batch of visible entries.
+  await viewNav.gotoFirst();
+  const page = await viewNav.entriesForward({ limit: 50 });
+  console.log("View rows:", page.entries);
+
+  // Always dispose when you are done -- this frees the host-side navigator.
+  await viewNav.dispose();
+}
 ```
 
 When Haven launches your app it injects a `mindoodbAppLaunchId` query parameter into the URL. `connect()` reads it automatically -- no manual wiring needed.
 
+> New to views? They are optional. If your app only needs raw document access you can stop at step 4. The full navigator API (paging, category expand/collapse, selection, child lookups, dynamic app-defined views via `session.createViewNavigator()`) is documented in the [Virtual Views](#virtual-views) section below, and the [`mindoodb-app-example`](https://github.com/klehmann/mindoodb-app-example) repo shows an end-to-end UI built on top of it.
+
 ## Core concepts
 
 ### Launch context
@@ -443,12 +464,13 @@ Haven includes a **built-in file viewer** that your app can open for common atta
 |---|---|
 | `image` | All common image formats (JPEG, PNG, GIF, WebP, SVG, ...) |
 | `pdf` | PDF documents |
-| `text` | Plain text, Markdown, CSV, JSON, XML, YAML, SVG, log files |
+| `markdown` | Markdown rendered to HTML (.md, .markdown, .mdown, .mkd, .mkdn) |
+| `text` | Plain text, CSV, JSON, XML, YAML, SVG, log files |
 | `docx` | Microsoft Word (.docx) |
 | `pptx` | Microsoft PowerPoint (.pptx) |
 | `spreadsheet` | Microsoft Excel (.xls, .xlsx, .xlsm, .xlsb) |
-| `video` | Video files with embedded player (streaming + seek support) |
-| `audio` | Audio files with embedded player (streaming + seek support) |
+| `video` | Video files with embedded player, streaming + seek (.mp4, .m4v, .webm, .ogv, .ogg, plus any `video/*`) |
+| `audio` | Audio files with embedded player, streaming + seek (.mp3, .m4a, .wav, .aac, .oga, plus any `audio/*`) |
 
 **Open the Haven preview dialog:**
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge } from './types-Bh1Q2qGN.js';
-export { b as MindooDBAppAttachmentApi, c as MindooDBAppAttachmentChunk, d as MindooDBAppAttachmentInfo, e as MindooDBAppAttachmentPreviewOptions, f as MindooDBAppAttachmentPreviewSession, g as MindooDBAppBridgeConnectMessage, h as MindooDBAppBridgeConnectOptions, i as MindooDBAppBridgeConnectedMessage, j as MindooDBAppBridgeErrorPayload, k as MindooDBAppBridgePortMessage, l as MindooDBAppBridgeRpcError, m as MindooDBAppBridgeRpcMessage, n as MindooDBAppBridgeRpcRequest, o as MindooDBAppBridgeRpcSuccess, p as MindooDBAppBridgeStreamAbortRequest, q as MindooDBAppBridgeStreamAck, r as MindooDBAppBridgeStreamCloseRequest, s as MindooDBAppBridgeStreamError, t as MindooDBAppBridgeStreamMessage, u as MindooDBAppBridgeStreamOpenResult, v as MindooDBAppBridgeStreamReadRequest, w as MindooDBAppBridgeStreamWriteRequest, x as MindooDBAppBridgeThemeChangedMessage, y as MindooDBAppBridgeViewportChangedMessage, z as MindooDBAppCapability, A as MindooDBAppConfiguredViewCategorizationStyle, B as MindooDBAppConfiguredViewColumn, C as MindooDBAppConfiguredViewColumnRole, D as MindooDBAppConfiguredViewExpressionMode, E as MindooDBAppConfiguredViewFieldExpression, F as MindooDBAppConfiguredViewFilterDefinition, G as MindooDBAppConfiguredViewFilterMode, H as MindooDBAppConfiguredViewFilterRule, I as MindooDBAppConfiguredViewFormulaExpression, J as MindooDBAppConfiguredViewFormulaFilterDefinition, K as MindooDBAppConfiguredViewPreviewMode, L as MindooDBAppConfiguredViewRuleFilterDefinition, N as MindooDBAppConfiguredViewRuleMatchMode, O as MindooDBAppConfiguredViewRuleOperator, P as MindooDBAppConfiguredViewValueExpression, Q as MindooDBAppCreateDocumentInput, R as MindooDBAppCreateViewInput, S as MindooDBAppCreateViewNavigatorInput, T as MindooDBAppDatabase, U as MindooDBAppDatabaseInfo, V as MindooDBAppDocument, W as MindooDBAppDocumentApi, X as MindooDBAppDocumentHistoryEntry, Y as MindooDBAppDocumentListQuery, Z as MindooDBAppDocumentListResult, _ as MindooDBAppDocumentSummary, $ as MindooDBAppHistoricalDocument, a0 as MindooDBAppHistoryQuery, a1 as MindooDBAppHostTheme, a2 as MindooDBAppLaunchContext, a3 as MindooDBAppMenuAnchor, a4 as MindooDBAppMenuApi, a5 as MindooDBAppMenuCommandItem, a6 as MindooDBAppMenuDismissReason, a7 as MindooDBAppMenuDismissedResult, a8 as MindooDBAppMenuItem, a9 as MindooDBAppMenuKind, aa as MindooDBAppMenuPlacement, ab as MindooDBAppMenuPointAnchor, ac as MindooDBAppMenuRect, ad as MindooDBAppMenuRectAnchor, ae as MindooDBAppMenuSelectionResult, af as MindooDBAppMenuSeparatorItem, ag as MindooDBAppReadableAttachmentStream, ah as MindooDBAppResolvedViewDefinition, ai as MindooDBAppResolvedViewSource, aj as MindooDBAppRuntime, ak as MindooDBAppScopedDocId, al as MindooDBAppSession, am as MindooDBAppShowMenuInput, an as MindooDBAppShowMenuResult, ao as MindooDBAppThemeMode, ap as MindooDBAppUpdateDocumentInput, aq as MindooDBAppViewEntry, ar as MindooDBAppViewEntryKind, as as MindooDBAppViewNavigator, at as MindooDBAppViewNavigatorExpansionState, au as MindooDBAppViewNavigatorOpenOptions, av as MindooDBAppViewNavigatorPageOptions, aw as MindooDBAppViewNavigatorPageResult, ax as MindooDBAppViewNavigatorRangeQuery, ay as MindooDBAppViewNavigatorSelectionState, az as MindooDBAppViewport, aA as MindooDBAppWritableAttachmentStream } from './types-Bh1Q2qGN.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge } from './types-DNQi5FbH.js';
+export { b as MindooDBAppAttachmentApi, c as MindooDBAppAttachmentChunk, d as MindooDBAppAttachmentInfo, e as MindooDBAppAttachmentPreviewOptions, f as MindooDBAppAttachmentPreviewSession, g as MindooDBAppBridgeConnectMessage, h as MindooDBAppBridgeConnectOptions, i as MindooDBAppBridgeConnectedMessage, j as MindooDBAppBridgeErrorPayload, k as MindooDBAppBridgePortMessage, l as MindooDBAppBridgeRpcError, m as MindooDBAppBridgeRpcMessage, n as MindooDBAppBridgeRpcRequest, o as MindooDBAppBridgeRpcSuccess, p as MindooDBAppBridgeStreamAbortRequest, q as MindooDBAppBridgeStreamAck, r as MindooDBAppBridgeStreamCloseRequest, s as MindooDBAppBridgeStreamError, t as MindooDBAppBridgeStreamMessage, u as MindooDBAppBridgeStreamOpenResult, v as MindooDBAppBridgeStreamReadRequest, w as MindooDBAppBridgeStreamWriteRequest, x as MindooDBAppBridgeThemeChangedMessage, y as MindooDBAppBridgeUiPreferencesChangedMessage, z as MindooDBAppBridgeViewportChangedMessage, A as MindooDBAppCapability, B as MindooDBAppConfiguredViewCategorizationStyle, C as MindooDBAppConfiguredViewColumn, D as MindooDBAppConfiguredViewColumnRole, E as MindooDBAppConfiguredViewExpressionMode, F as MindooDBAppConfiguredViewFieldExpression, G as MindooDBAppConfiguredViewFilterDefinition, H as MindooDBAppConfiguredViewFilterMode, I as MindooDBAppConfiguredViewFilterRule, J as MindooDBAppConfiguredViewFormulaExpression, K as MindooDBAppConfiguredViewFormulaFilterDefinition, L as MindooDBAppConfiguredViewPreviewMode, N as MindooDBAppConfiguredViewRuleFilterDefinition, O as MindooDBAppConfiguredViewRuleMatchMode, P as MindooDBAppConfiguredViewRuleOperator, Q as MindooDBAppConfiguredViewValueExpression, R as MindooDBAppCreateDocumentInput, S as MindooDBAppCreateViewInput, T as MindooDBAppCreateViewNavigatorInput, U as MindooDBAppDatabase, V as MindooDBAppDatabaseInfo, W as MindooDBAppDocument, X as MindooDBAppDocumentApi, Y as MindooDBAppDocumentHeadCursorResult, Z as MindooDBAppDocumentHistoryEntry, _ as MindooDBAppDocumentListQuery, $ as MindooDBAppDocumentListResult, a0 as MindooDBAppDocumentSummary, a1 as MindooDBAppHistoricalDocument, a2 as MindooDBAppHistoryQuery, a3 as MindooDBAppHostTheme, a4 as MindooDBAppLaunchContext, a5 as MindooDBAppMenuAnchor, a6 as MindooDBAppMenuApi, a7 as MindooDBAppMenuCommandItem, a8 as MindooDBAppMenuDismissReason, a9 as MindooDBAppMenuDismissedResult, aa as MindooDBAppMenuItem, ab as MindooDBAppMenuKind, ac as MindooDBAppMenuPlacement, ad as MindooDBAppMenuPointAnchor, ae as MindooDBAppMenuRect, af as MindooDBAppMenuRectAnchor, ag as MindooDBAppMenuSelectionResult, ah as MindooDBAppMenuSeparatorItem, ai as MindooDBAppReadableAttachmentStream, aj as MindooDBAppResolvedViewDefinition, ak as MindooDBAppResolvedViewSource, al as MindooDBAppRuntime, am as MindooDBAppScopedDocId, an as MindooDBAppSession, ao as MindooDBAppShowMenuInput, ap as MindooDBAppShowMenuResult, aq as MindooDBAppThemeMode, ar as MindooDBAppUiPreferences, as as MindooDBAppUpdateDocumentInput, at as MindooDBAppViewEntry, au as MindooDBAppViewEntryKind, av as MindooDBAppViewNavigator, aw as MindooDBAppViewNavigatorExpansionState, ax as MindooDBAppViewNavigatorOpenOptions, ay as MindooDBAppViewNavigatorPageOptions, az as MindooDBAppViewNavigatorPageResult, aA as MindooDBAppViewNavigatorRangeQuery, aB as MindooDBAppViewNavigatorSelectionState, aC as MindooDBAppViewport, aD as MindooDBAppWritableAttachmentStream } from './types-DNQi5FbH.js';
 export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterDefinition, MindooDBAppViewCategoryChildrenPageRequest, MindooDBAppViewColumn, MindooDBAppViewColumnRole, MindooDBAppViewDefinition, MindooDBAppViewExpansionState, MindooDBAppViewExpressionBase, MindooDBAppViewExpressionDatePart, MindooDBAppViewExpressionOperation, MindooDBAppViewFieldExpression, MindooDBAppViewIfExpression, MindooDBAppViewLetExpression, MindooDBAppViewLiteralExpression, MindooDBAppViewLookupByPath, MindooDBAppViewOperationExpression, MindooDBAppViewOriginExpression, MindooDBAppViewPageRequest, MindooDBAppViewPageResult, MindooDBAppViewRow, MindooDBAppViewSortDirection, MindooDBAppViewTotalMode, MindooDBAppViewValueExpressionRef, MindooDBAppViewVariableExpression, createViewLanguage } from 'mindoodb-view-language';
 
 /**

package/dist/index.js

@@ -2,6 +2,9 @@
 function canPreviewAttachment(fileName, mimeType) {
   const normalizedMimeType = mimeType.toLowerCase();
   const normalizedFileName = fileName.toLowerCase();
+  if (normalizedMimeType === "text/markdown" || normalizedMimeType === "text/x-markdown" || normalizedMimeType === "application/markdown" || normalizedMimeType === "application/x-markdown" || normalizedFileName.endsWith(".md") || normalizedFileName.endsWith(".markdown") || normalizedFileName.endsWith(".mdown") || normalizedFileName.endsWith(".mkd") || normalizedFileName.endsWith(".mkdn")) {
+    return "markdown";
+  }
   if (normalizedMimeType.startsWith("image/")) {
     return "image";
   }
@@ -11,6 +14,12 @@ function canPreviewAttachment(fileName, mimeType) {
   if (normalizedMimeType.startsWith("audio/")) {
     return "audio";
   }
+  if (normalizedFileName.endsWith(".mp4") || normalizedFileName.endsWith(".m4v") || normalizedFileName.endsWith(".webm") || normalizedFileName.endsWith(".ogv") || normalizedFileName.endsWith(".ogg")) {
+    return "video";
+  }
+  if (normalizedFileName.endsWith(".m4a") || normalizedFileName.endsWith(".mp3") || normalizedFileName.endsWith(".wav") || normalizedFileName.endsWith(".aac") || normalizedFileName.endsWith(".oga")) {
+    return "audio";
+  }
   if (normalizedMimeType === "application/pdf" || normalizedFileName.endsWith(".pdf")) {
     return "pdf";
   }
@@ -23,7 +32,7 @@ function canPreviewAttachment(fileName, mimeType) {
   if (normalizedMimeType === "application/vnd.openxmlformats-officedocument.presentationml.presentation" || normalizedFileName.endsWith(".pptx")) {
     return "pptx";
   }
-  if (normalizedMimeType.startsWith("text/") || normalizedMimeType === "application/json" || normalizedMimeType === "application/xml" || normalizedMimeType === "image/svg+xml" || normalizedFileName.endsWith(".json") || normalizedFileName.endsWith(".txt") || normalizedFileName.endsWith(".md") || normalizedFileName.endsWith(".csv") || normalizedFileName.endsWith(".log") || normalizedFileName.endsWith(".xml") || normalizedFileName.endsWith(".yaml") || normalizedFileName.endsWith(".yml") || normalizedFileName.endsWith(".svg")) {
+  if (normalizedMimeType.startsWith("text/") || normalizedMimeType === "application/json" || normalizedMimeType === "application/xml" || normalizedMimeType === "image/svg+xml" || normalizedFileName.endsWith(".json") || normalizedFileName.endsWith(".txt") || normalizedFileName.endsWith(".csv") || normalizedFileName.endsWith(".log") || normalizedFileName.endsWith(".xml") || normalizedFileName.endsWith(".yaml") || normalizedFileName.endsWith(".yml") || normalizedFileName.endsWith(".svg")) {
     return "text";
   }
   return null;
@@ -240,6 +249,9 @@ function isThemeChangedMessage(message) {
 function isViewportChangedMessage(message) {
   return message.kind === "viewport-changed";
 }
+function isUiPreferencesChangedMessage(message) {
+  return message.kind === "ui-preferences-changed";
+}
 function toStreamError(message) {
   const error = new Error(message.error.message);
   error.name = message.error.code || "MindooDBAppBridgeStreamError";
@@ -627,6 +639,9 @@ var MindooDBAppDatabaseImpl = class {
         databaseId: this.databaseId,
         query: query ?? {}
       }),
+      getHeadCursor: async () => await this.rpc.call("documents.getHeadCursor", {
+        databaseId: this.databaseId
+      }),
       get: async (docId) => await this.rpc.call("documents.get", {
         databaseId: this.databaseId,
         docId
@@ -765,6 +780,14 @@ var MindooDBAppSessionImpl = class {
       }
     });
   }
+  /** Subscribe to host-pushed embedded UI preference changes. */
+  onUiPreferencesChange(listener) {
+    return this.rpc.addMessageListener((message) => {
+      if (isUiPreferencesChangedMessage(message)) {
+        listener(message.uiPreferences);
+      }
+    });
+  }
   /** Disconnects from the host and always disposes the underlying port client. */
   async disconnect() {
     try {

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { a2 as MindooDBAppLaunchContext, U as MindooDBAppDatabaseInfo, W as MindooDBAppDocumentApi, S as MindooDBAppCreateViewNavigatorInput, as as MindooDBAppViewNavigator, au as MindooDBAppViewNavigatorOpenOptions, b as MindooDBAppAttachmentApi, a as MindooDBAppBridge, al as MindooDBAppSession, n as MindooDBAppBridgeRpcRequest, a1 as MindooDBAppHostTheme, az as MindooDBAppViewport, k as MindooDBAppBridgePortMessage } from '../types-Bh1Q2qGN.js';
+import { a4 as MindooDBAppLaunchContext, V as MindooDBAppDatabaseInfo, X as MindooDBAppDocumentApi, T as MindooDBAppCreateViewNavigatorInput, av as MindooDBAppViewNavigator, ax as MindooDBAppViewNavigatorOpenOptions, b as MindooDBAppAttachmentApi, a as MindooDBAppBridge, an as MindooDBAppSession, n as MindooDBAppBridgeRpcRequest, a3 as MindooDBAppHostTheme, aC as MindooDBAppViewport, ar as MindooDBAppUiPreferences, k as MindooDBAppBridgePortMessage } from '../types-DNQi5FbH.js';
 import 'mindoodb-view-language';
 
 type MaybePromise<T> = T | Promise<T>;
@@ -29,6 +29,7 @@ interface MockMindooDBAppSessionController {
     setDatabases(definitions: MockMindooDBAppDatabaseDefinition[]): void;
     emitThemeChange(theme: MindooDBAppHostTheme): void;
     emitViewportChange(viewport: MindooDBAppViewport): void;
+    emitUiPreferencesChange(uiPreferences: MindooDBAppUiPreferences): void;
 }
 declare function createMockMindooDBAppSession(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;
 declare function createMockMindooDBAppBridge(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;
@@ -55,6 +56,7 @@ interface FakeBridgeHostController {
     dispose(): void;
     emitThemeChange(theme: MindooDBAppHostTheme): void;
     emitViewportChange(viewport: MindooDBAppViewport): void;
+    emitUiPreferencesChange(uiPreferences: MindooDBAppUiPreferences): void;
     postPortMessage(message: MindooDBAppBridgePortMessage, transfer?: Transferable[]): void;
     setRequestHandler(method: string, handler: FakeBridgeRequestHandler): void;
     clearRequestHandler(method: string): void;

package/dist/testing/index.js

@@ -18,6 +18,7 @@ function mergeLaunchContext(current, patch) {
       ...current,
       theme: { ...current.theme },
       viewport: current.viewport ? { ...current.viewport } : null,
+      uiPreferences: { ...current.uiPreferences },
       user: { ...current.user },
       launchParameters: { ...current.launchParameters },
       databases: current.databases.map((database) => ({
@@ -47,6 +48,7 @@ function mergeLaunchContext(current, patch) {
     ...patch,
     theme: patch.theme ? { ...current.theme, ...patch.theme } : { ...current.theme },
     viewport: patch.viewport === void 0 ? current.viewport ? { ...current.viewport } : null : patch.viewport ? { ...patch.viewport } : null,
+    uiPreferences: patch.uiPreferences ? { ...current.uiPreferences, ...patch.uiPreferences } : { ...current.uiPreferences },
     user: patch.user ? { ...current.user, ...patch.user } : { ...current.user },
     launchParameters: patch.launchParameters ? { ...current.launchParameters, ...patch.launchParameters } : { ...current.launchParameters },
     databases: patch.databases ? patch.databases.map((database) => ({
@@ -104,6 +106,9 @@ function createDefaultLaunchContext(patch) {
       width: 1024,
       height: 768
     },
+    uiPreferences: {
+      iosMultitaskingOptimized: false
+    },
     user: {
       id: "user-1",
       username: "Test User"
@@ -405,6 +410,11 @@ function createDatabaseHandle(definition) {
         nextCursor
       };
     },
+    async getHeadCursor() {
+      return {
+        cursor: String(storedDocuments.size)
+      };
+    },
     async get(_docId) {
       const document = storedDocuments.get(_docId);
       if (!document || document.isDeleted) {
@@ -526,6 +536,7 @@ function createMockSessionState(options = {}) {
   let launchContext = createDefaultLaunchContext(options.launchContext);
   const themeListeners = /* @__PURE__ */ new Set();
   const viewportListeners = /* @__PURE__ */ new Set();
+  const uiPreferencesListeners = /* @__PURE__ */ new Set();
   const databaseHandles = /* @__PURE__ */ new Map();
   const databaseViewApis = /* @__PURE__ */ new Map();
   const sessionViews = /* @__PURE__ */ new Map();
@@ -634,6 +645,12 @@ function createMockSessionState(options = {}) {
         viewportListeners.delete(listener);
       };
     },
+    onUiPreferencesChange(listener) {
+      uiPreferencesListeners.add(listener);
+      return () => {
+        uiPreferencesListeners.delete(listener);
+      };
+    },
     async disconnect() {
       await options.onDisconnect?.();
     }
@@ -676,6 +693,10 @@ function createMockSessionState(options = {}) {
     emitViewportChange(viewport) {
       launchContext = mergeLaunchContext(launchContext, { viewport });
       viewportListeners.forEach((listener) => listener({ ...viewport }));
+    },
+    emitUiPreferencesChange(uiPreferences) {
+      launchContext = mergeLaunchContext(launchContext, { uiPreferences });
+      uiPreferencesListeners.forEach((listener) => listener({ ...launchContext.uiPreferences }));
     }
   };
 }
@@ -689,7 +710,8 @@ function createMockMindooDBAppSession(options = {}) {
     listDatabases: state.listDatabaseInfos,
     setDatabases: state.setDatabases,
     emitThemeChange: state.emitThemeChange,
-    emitViewportChange: state.emitViewportChange
+    emitViewportChange: state.emitViewportChange,
+    emitUiPreferencesChange: state.emitUiPreferencesChange
   };
 }
 function createMockMindooDBAppBridge(options = {}) {
@@ -875,6 +897,8 @@ function createFakeBridgeHost(options = {}) {
         return { ok: true };
       case "documents.list":
         return await state.getDatabase(String(params.databaseId)).documents.list(params.query);
+      case "documents.getHeadCursor":
+        return await state.getDatabase(String(params.databaseId)).documents.getHeadCursor();
       case "documents.get":
         return await state.getDatabase(String(params.databaseId)).documents.get(String(params.docId));
       case "documents.create":
@@ -1198,6 +1222,15 @@ function createFakeBridgeHost(options = {}) {
       };
       connectedPorts.forEach((port) => port.postMessage(payload));
     },
+    emitUiPreferencesChange(uiPreferences) {
+      state.emitUiPreferencesChange(uiPreferences);
+      const payload = {
+        protocol: PROTOCOL,
+        kind: "ui-preferences-changed",
+        uiPreferences
+      };
+      connectedPorts.forEach((port) => port.postMessage(payload));
+    },
     postPortMessage(message, transfer = []) {
       connectedPorts.forEach((port) => port.postMessage(message, transfer));
     },

package/dist/{types-Bh1Q2qGN.d.ts → types-DNQi5FbH.d.ts}

@@ -14,6 +14,10 @@ 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. */
@@ -93,7 +97,7 @@ interface MindooDBAppResolvedViewDefinition {
 }
 /** 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 Administrator host. */
+/** Metadata about the current app launch supplied by the Haven host. */
 interface MindooDBAppLaunchContext {
     appId: string;
     appInstanceId: string;
@@ -102,6 +106,7 @@ interface MindooDBAppLaunchContext {
     runtime: MindooDBAppRuntime;
     theme: MindooDBAppHostTheme;
     viewport: MindooDBAppViewport | null;
+    uiPreferences: MindooDBAppUiPreferences;
     tenantId?: string;
     preferredDatabaseId?: string;
     user: {
@@ -120,7 +125,7 @@ interface MindooDBAppAttachmentInfo {
     size: number;
 }
 /** Preview modes supported by the Haven-hosted attachment preview dialog. */
-type MindooDBAppAttachmentPreviewMode = "image" | "pdf" | "text" | "docx" | "pptx" | "spreadsheet" | "video" | "audio";
+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()`. */
@@ -187,6 +192,10 @@ interface MindooDBAppDocumentListResult {
     items: MindooDBAppDocumentSummary[];
     nextCursor: string | null;
 }
+/** Latest known changefeed cursor for a database. */
+interface MindooDBAppDocumentHeadCursorResult {
+    cursor: string | null;
+}
 /** Payload used when creating a new document. */
 interface MindooDBAppCreateDocumentInput {
     data: Record<string, unknown>;
@@ -311,8 +320,14 @@ interface MindooDBAppBridgeViewportChangedMessage {
     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;
+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. */
@@ -395,6 +410,7 @@ interface MindooDBAppWritableAttachmentStream {
 /** Document operations exposed by an opened database handle. */
 interface MindooDBAppDocumentApi {
     list(query?: MindooDBAppDocumentListQuery): Promise<MindooDBAppDocumentListResult>;
+    getHeadCursor(): Promise<MindooDBAppDocumentHeadCursorResult>;
     get(docId: string): Promise<MindooDBAppDocument | null>;
     create(input: MindooDBAppCreateDocumentInput): Promise<MindooDBAppDocument>;
     update(docId: string, patch: MindooDBAppUpdateDocumentInput): Promise<MindooDBAppDocument>;
@@ -552,6 +568,7 @@ interface MindooDBAppSession {
     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. */
@@ -559,4 +576,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export type { MindooDBAppHistoricalDocument as $, MindooDBAppConfiguredViewCategorizationStyle as A, MindooDBAppConfiguredViewColumn as B, MindooDBAppConfiguredViewColumnRole as C, MindooDBAppConfiguredViewExpressionMode as D, MindooDBAppConfiguredViewFieldExpression as E, MindooDBAppConfiguredViewFilterDefinition as F, MindooDBAppConfiguredViewFilterMode as G, MindooDBAppConfiguredViewFilterRule as H, MindooDBAppConfiguredViewFormulaExpression as I, MindooDBAppConfiguredViewFormulaFilterDefinition as J, MindooDBAppConfiguredViewPreviewMode as K, MindooDBAppConfiguredViewRuleFilterDefinition as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewRuleMatchMode as N, MindooDBAppConfiguredViewRuleOperator as O, MindooDBAppConfiguredViewValueExpression as P, MindooDBAppCreateDocumentInput as Q, MindooDBAppCreateViewInput as R, MindooDBAppCreateViewNavigatorInput as S, MindooDBAppDatabase as T, MindooDBAppDatabaseInfo as U, MindooDBAppDocument as V, MindooDBAppDocumentApi as W, MindooDBAppDocumentHistoryEntry as X, MindooDBAppDocumentListQuery as Y, MindooDBAppDocumentListResult as Z, MindooDBAppDocumentSummary as _, MindooDBAppBridge as a, MindooDBAppHistoryQuery as a0, MindooDBAppHostTheme as a1, MindooDBAppLaunchContext as a2, MindooDBAppMenuAnchor as a3, MindooDBAppMenuApi as a4, MindooDBAppMenuCommandItem as a5, MindooDBAppMenuDismissReason as a6, MindooDBAppMenuDismissedResult as a7, MindooDBAppMenuItem as a8, MindooDBAppMenuKind as a9, MindooDBAppWritableAttachmentStream as aA, MindooDBAppMenuPlacement as aa, MindooDBAppMenuPointAnchor as ab, MindooDBAppMenuRect as ac, MindooDBAppMenuRectAnchor as ad, MindooDBAppMenuSelectionResult as ae, MindooDBAppMenuSeparatorItem as af, MindooDBAppReadableAttachmentStream as ag, MindooDBAppResolvedViewDefinition as ah, MindooDBAppResolvedViewSource as ai, MindooDBAppRuntime as aj, MindooDBAppScopedDocId as ak, MindooDBAppSession as al, MindooDBAppShowMenuInput as am, MindooDBAppShowMenuResult as an, MindooDBAppThemeMode as ao, MindooDBAppUpdateDocumentInput as ap, MindooDBAppViewEntry as aq, MindooDBAppViewEntryKind as ar, MindooDBAppViewNavigator as as, MindooDBAppViewNavigatorExpansionState as at, MindooDBAppViewNavigatorOpenOptions as au, MindooDBAppViewNavigatorPageOptions as av, MindooDBAppViewNavigatorPageResult as aw, MindooDBAppViewNavigatorRangeQuery as ax, MindooDBAppViewNavigatorSelectionState as ay, MindooDBAppViewport as az, MindooDBAppAttachmentApi as b, MindooDBAppAttachmentChunk as c, MindooDBAppAttachmentInfo as d, MindooDBAppAttachmentPreviewOptions as e, MindooDBAppAttachmentPreviewSession as f, MindooDBAppBridgeConnectMessage as g, MindooDBAppBridgeConnectOptions as h, MindooDBAppBridgeConnectedMessage as i, MindooDBAppBridgeErrorPayload as j, MindooDBAppBridgePortMessage as k, MindooDBAppBridgeRpcError as l, MindooDBAppBridgeRpcMessage as m, MindooDBAppBridgeRpcRequest as n, MindooDBAppBridgeRpcSuccess as o, MindooDBAppBridgeStreamAbortRequest as p, MindooDBAppBridgeStreamAck as q, MindooDBAppBridgeStreamCloseRequest as r, MindooDBAppBridgeStreamError as s, MindooDBAppBridgeStreamMessage as t, MindooDBAppBridgeStreamOpenResult as u, MindooDBAppBridgeStreamReadRequest as v, MindooDBAppBridgeStreamWriteRequest as w, MindooDBAppBridgeThemeChangedMessage as x, MindooDBAppBridgeViewportChangedMessage as y, MindooDBAppCapability as z };
+export type { MindooDBAppDocumentListResult as $, MindooDBAppCapability as A, MindooDBAppConfiguredViewCategorizationStyle as B, MindooDBAppConfiguredViewColumn as C, MindooDBAppConfiguredViewColumnRole as D, MindooDBAppConfiguredViewExpressionMode as E, MindooDBAppConfiguredViewFieldExpression as F, MindooDBAppConfiguredViewFilterDefinition as G, MindooDBAppConfiguredViewFilterMode as H, MindooDBAppConfiguredViewFilterRule as I, MindooDBAppConfiguredViewFormulaExpression as J, MindooDBAppConfiguredViewFormulaFilterDefinition as K, MindooDBAppConfiguredViewPreviewMode as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewRuleFilterDefinition as N, MindooDBAppConfiguredViewRuleMatchMode as O, MindooDBAppConfiguredViewRuleOperator as P, MindooDBAppConfiguredViewValueExpression as Q, MindooDBAppCreateDocumentInput as R, MindooDBAppCreateViewInput as S, MindooDBAppCreateViewNavigatorInput as T, MindooDBAppDatabase as U, MindooDBAppDatabaseInfo as V, MindooDBAppDocument as W, MindooDBAppDocumentApi as X, MindooDBAppDocumentHeadCursorResult as Y, MindooDBAppDocumentHistoryEntry as Z, MindooDBAppDocumentListQuery as _, MindooDBAppBridge as a, MindooDBAppDocumentSummary as a0, MindooDBAppHistoricalDocument as a1, MindooDBAppHistoryQuery as a2, MindooDBAppHostTheme as a3, MindooDBAppLaunchContext as a4, MindooDBAppMenuAnchor as a5, MindooDBAppMenuApi as a6, MindooDBAppMenuCommandItem as a7, MindooDBAppMenuDismissReason as a8, MindooDBAppMenuDismissedResult as a9, MindooDBAppViewNavigatorRangeQuery as aA, MindooDBAppViewNavigatorSelectionState as aB, MindooDBAppViewport as aC, MindooDBAppWritableAttachmentStream as aD, MindooDBAppMenuItem as aa, MindooDBAppMenuKind as ab, MindooDBAppMenuPlacement as ac, MindooDBAppMenuPointAnchor as ad, MindooDBAppMenuRect as ae, MindooDBAppMenuRectAnchor as af, MindooDBAppMenuSelectionResult as ag, MindooDBAppMenuSeparatorItem as ah, MindooDBAppReadableAttachmentStream as ai, MindooDBAppResolvedViewDefinition as aj, MindooDBAppResolvedViewSource as ak, MindooDBAppRuntime as al, MindooDBAppScopedDocId as am, MindooDBAppSession as an, MindooDBAppShowMenuInput as ao, MindooDBAppShowMenuResult as ap, MindooDBAppThemeMode as aq, MindooDBAppUiPreferences as ar, MindooDBAppUpdateDocumentInput as as, MindooDBAppViewEntry as at, MindooDBAppViewEntryKind as au, MindooDBAppViewNavigator as av, MindooDBAppViewNavigatorExpansionState as aw, MindooDBAppViewNavigatorOpenOptions as ax, MindooDBAppViewNavigatorPageOptions as ay, MindooDBAppViewNavigatorPageResult as az, MindooDBAppAttachmentApi as b, MindooDBAppAttachmentChunk as c, MindooDBAppAttachmentInfo as d, MindooDBAppAttachmentPreviewOptions as e, MindooDBAppAttachmentPreviewSession as f, MindooDBAppBridgeConnectMessage as g, MindooDBAppBridgeConnectOptions as h, MindooDBAppBridgeConnectedMessage as i, MindooDBAppBridgeErrorPayload as j, MindooDBAppBridgePortMessage as k, MindooDBAppBridgeRpcError as l, MindooDBAppBridgeRpcMessage as m, MindooDBAppBridgeRpcRequest as n, MindooDBAppBridgeRpcSuccess as o, MindooDBAppBridgeStreamAbortRequest as p, MindooDBAppBridgeStreamAck as q, MindooDBAppBridgeStreamCloseRequest as r, MindooDBAppBridgeStreamError as s, MindooDBAppBridgeStreamMessage as t, MindooDBAppBridgeStreamOpenResult as u, MindooDBAppBridgeStreamReadRequest as v, MindooDBAppBridgeStreamWriteRequest as w, MindooDBAppBridgeThemeChangedMessage as x, MindooDBAppBridgeUiPreferencesChangedMessage as y, MindooDBAppBridgeViewportChangedMessage as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "MindooDB app SDK for building apps that connect to the Haven host bridge",
   "license": "ISC",
   "author": "Mindoo GmbH",