mindoodb-app-sdk 0.0.4 → 0.0.5

package/README.md

@@ -98,6 +98,8 @@ console.log(launchContext.theme.mode);   // "light" | "dark"
 console.log(launchContext.viewport);     // { width, height } | null
 console.log(launchContext.user.username);
 console.log(launchContext.launchParameters);
+console.log(launchContext.databases);
+console.log(launchContext.views);
 ```
 
 `launchContext.viewport` is especially useful for responsive layouts inside embedded iframes. It is the initial viewport snapshot; later changes arrive through `onViewportChange()`.
@@ -126,19 +128,19 @@ The intended pattern is:
 ### 6. Discover the databases Haven exposed
 
 ```ts
-const databases = await session.listDatabases();
+const databases = launchContext.databases;
 
 for (const database of databases) {
   console.log(database.id, database.title, database.capabilities);
 }
 ```
 
-Do not hard-code assumptions about available databases or permissions. Always discover them from the session.
+Prefer `launchContext.databases` for the initial snapshot so your app discovers databases and views from the same source. `session.listDatabases()` is still available when you want to refresh database metadata later.
 
 ### 7. Open a database and work with documents
 
 ```ts
-const databases = await session.listDatabases();
+const databases = launchContext.databases;
 const db = await session.openDatabase(databases[0]!.id);
 
 const list = await db.documents.list({ limit: 25 });
@@ -195,14 +197,16 @@ session.onViewportChange((viewport) => {
   console.log("Resize:", viewport.width, viewport.height);
 });
 
-const databases = await session.listDatabases();
+const databases = launchContext.databases;
 const db = await session.openDatabase(databases[0]!.id);
 
 const list = await db.documents.list({ limit: 25 });
 const firstDoc = list.items[0] ? await db.documents.get(list.items[0].id) : null;
 
 const v = createViewLanguage<{ employee: string; hours: number; rate?: number }>();
-const view = await db.views.create({
+const view = await session.createView({
+  databaseId: databases[0]!.id,
+  definition: {
   title: "Hours by employee",
   defaultExpand: "collapsed",
   filter: {
@@ -230,6 +234,7 @@ const view = await db.views.create({
       ),
     },
   ],
+  },
 });
 
 const page = await view.page({ pageSize: 100 });
@@ -239,7 +244,7 @@ await view.dispose();
 
 ## Views and expression language
 
-Views are app-defined and session-scoped. Create a definition, page through rows, inspect categories, manage expansion state, then dispose the handle when done.
+Views are app-defined and session-scoped. Create a definition with `session.createView()`, open Haven-configured mappings with `session.openView()`, page through rows, inspect categories, manage expansion state, then dispose the handle when done.
 
 ```ts
 import { createViewLanguage } from "mindoodb-app-sdk";
@@ -252,7 +257,9 @@ const v = createViewLanguage<{
   note?: string;
 }>();
 
-const view = await db.views.create({
+const view = await session.createView({
+  databaseId: "main",
+  definition: {
   title: "By employee",
   defaultExpand: "collapsed",
   filter: {
@@ -281,6 +288,7 @@ const view = await db.views.create({
       sorting: "descending",
     },
   ],
+  },
 });
 
 const page = await view.page({ pageSize: 100 });

package/TESTING.md

@@ -85,11 +85,13 @@ Both accept the same options:
 - `databases`
 - `onDisconnect`
 
+When you pass `databases`, the mock session also exposes them through `session.getLaunchContext().databases`.
+
 Each database entry can provide:
 
 - `info`
 - `methods.documents`
-- `methods.views`
+- `methods.views` for session-level `createView()` and `openView()` calls
 - `methods.attachments`
 
 ## Level 2 example

package/dist/index.d.ts

@@ -1,7 +1,15 @@
-import { M as MindooDBAppBridge } from './types-BGdIfp-D.js';
-export { a as MindooDBAppAttachmentApi, b as MindooDBAppAttachmentChunk, c as MindooDBAppAttachmentInfo, d as MindooDBAppBridgeConnectMessage, e as MindooDBAppBridgeConnectOptions, f as MindooDBAppBridgeConnectedMessage, g as MindooDBAppBridgeErrorPayload, h as MindooDBAppBridgePortMessage, i as MindooDBAppBridgeRpcError, j as MindooDBAppBridgeRpcMessage, k as MindooDBAppBridgeRpcRequest, l as MindooDBAppBridgeRpcSuccess, m as MindooDBAppBridgeStreamAbortRequest, n as MindooDBAppBridgeStreamAck, o as MindooDBAppBridgeStreamCloseRequest, p as MindooDBAppBridgeStreamError, q as MindooDBAppBridgeStreamMessage, r as MindooDBAppBridgeStreamOpenResult, s as MindooDBAppBridgeStreamReadRequest, t as MindooDBAppBridgeStreamWriteRequest, u as MindooDBAppBridgeThemeChangedMessage, v as MindooDBAppBridgeViewportChangedMessage, w as MindooDBAppCapability, x as MindooDBAppConfiguredViewCategorizationStyle, y as MindooDBAppConfiguredViewColumn, z as MindooDBAppConfiguredViewColumnRole, A as MindooDBAppConfiguredViewExpressionMode, B as MindooDBAppConfiguredViewFieldExpression, C as MindooDBAppConfiguredViewFilterDefinition, D as MindooDBAppConfiguredViewFilterMode, E as MindooDBAppConfiguredViewFilterRule, F as MindooDBAppConfiguredViewFormulaExpression, G as MindooDBAppConfiguredViewFormulaFilterDefinition, H as MindooDBAppConfiguredViewPreviewMode, I as MindooDBAppConfiguredViewRuleFilterDefinition, J as MindooDBAppConfiguredViewRuleMatchMode, K as MindooDBAppConfiguredViewRuleOperator, L as MindooDBAppConfiguredViewValueExpression, N as MindooDBAppCreateDocumentInput, O as MindooDBAppDatabase, P as MindooDBAppDatabaseInfo, Q as MindooDBAppDocument, R as MindooDBAppDocumentApi, S as MindooDBAppDocumentHistoryEntry, T as MindooDBAppDocumentListQuery, U as MindooDBAppDocumentListResult, V as MindooDBAppDocumentSummary, W as MindooDBAppHistoricalDocument, X as MindooDBAppHistoryQuery, Y as MindooDBAppHostTheme, Z as MindooDBAppLaunchContext, _ as MindooDBAppReadableAttachmentStream, $ as MindooDBAppResolvedViewDefinition, a0 as MindooDBAppResolvedViewSource, a1 as MindooDBAppRuntime, a2 as MindooDBAppSession, a3 as MindooDBAppThemeMode, a4 as MindooDBAppUpdateDocumentInput, a5 as MindooDBAppViewApi, a6 as MindooDBAppViewHandle, a7 as MindooDBAppViewport, a8 as MindooDBAppWritableAttachmentStream } from './types-BGdIfp-D.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge } from './types-Cvlkh3vJ.js';
+export { b as MindooDBAppAttachmentApi, c as MindooDBAppAttachmentChunk, d as MindooDBAppAttachmentInfo, e as MindooDBAppAttachmentPreviewOptions, f as MindooDBAppBridgeConnectMessage, g as MindooDBAppBridgeConnectOptions, h as MindooDBAppBridgeConnectedMessage, i as MindooDBAppBridgeErrorPayload, j as MindooDBAppBridgePortMessage, k as MindooDBAppBridgeRpcError, l as MindooDBAppBridgeRpcMessage, m as MindooDBAppBridgeRpcRequest, n as MindooDBAppBridgeRpcSuccess, o as MindooDBAppBridgeStreamAbortRequest, p as MindooDBAppBridgeStreamAck, q as MindooDBAppBridgeStreamCloseRequest, r as MindooDBAppBridgeStreamError, s as MindooDBAppBridgeStreamMessage, t as MindooDBAppBridgeStreamOpenResult, u as MindooDBAppBridgeStreamReadRequest, v as MindooDBAppBridgeStreamWriteRequest, w as MindooDBAppBridgeThemeChangedMessage, x as MindooDBAppBridgeViewportChangedMessage, y as MindooDBAppCapability, z as MindooDBAppConfiguredViewCategorizationStyle, A as MindooDBAppConfiguredViewColumn, B as MindooDBAppConfiguredViewColumnRole, C as MindooDBAppConfiguredViewExpressionMode, D as MindooDBAppConfiguredViewFieldExpression, E as MindooDBAppConfiguredViewFilterDefinition, F as MindooDBAppConfiguredViewFilterMode, G as MindooDBAppConfiguredViewFilterRule, H as MindooDBAppConfiguredViewFormulaExpression, I as MindooDBAppConfiguredViewFormulaFilterDefinition, J as MindooDBAppConfiguredViewPreviewMode, K as MindooDBAppConfiguredViewRuleFilterDefinition, L as MindooDBAppConfiguredViewRuleMatchMode, N as MindooDBAppConfiguredViewRuleOperator, O as MindooDBAppConfiguredViewValueExpression, P as MindooDBAppCreateDocumentInput, Q as MindooDBAppCreateViewInput, R as MindooDBAppDatabase, S as MindooDBAppDatabaseInfo, T as MindooDBAppDocument, U as MindooDBAppDocumentApi, V as MindooDBAppDocumentHistoryEntry, W as MindooDBAppDocumentListQuery, X as MindooDBAppDocumentListResult, Y as MindooDBAppDocumentSummary, Z as MindooDBAppHistoricalDocument, _ as MindooDBAppHistoryQuery, $ as MindooDBAppHostTheme, a0 as MindooDBAppLaunchContext, a1 as MindooDBAppReadableAttachmentStream, a2 as MindooDBAppResolvedViewDefinition, a3 as MindooDBAppResolvedViewSource, a4 as MindooDBAppRuntime, a5 as MindooDBAppSession, a6 as MindooDBAppThemeMode, a7 as MindooDBAppUpdateDocumentInput, a8 as MindooDBAppViewHandle, a9 as MindooDBAppViewport, aa as MindooDBAppWritableAttachmentStream } from './types-Cvlkh3vJ.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';
 
+/**
+ * Resolves whether Haven can render a built-in preview for an attachment.
+ *
+ * Apps can use this as a fast local check before calling
+ * `attachments.openPreview()`.
+ */
+declare function canPreviewAttachment(fileName: string, mimeType: string): MindooDBAppAttachmentPreviewMode | null;
+
 /**
  * Creates the browser-side bridge entry point used by MindooDB apps.
  *
@@ -11,4 +19,4 @@ export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterD
  */
 declare function createMindooDBAppBridge(): MindooDBAppBridge;
 
-export { MindooDBAppBridge, createMindooDBAppBridge };
+export { MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, canPreviewAttachment, createMindooDBAppBridge };

package/dist/index.js

@@ -1,3 +1,34 @@
+// src/attachmentPreview.ts
+function canPreviewAttachment(fileName, mimeType) {
+  const normalizedMimeType = mimeType.toLowerCase();
+  const normalizedFileName = fileName.toLowerCase();
+  if (normalizedMimeType.startsWith("image/")) {
+    return "image";
+  }
+  if (normalizedMimeType.startsWith("video/")) {
+    return "video";
+  }
+  if (normalizedMimeType.startsWith("audio/")) {
+    return "audio";
+  }
+  if (normalizedMimeType === "application/pdf" || normalizedFileName.endsWith(".pdf")) {
+    return "pdf";
+  }
+  if (normalizedMimeType === "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" || normalizedMimeType === "application/vnd.ms-excel" || normalizedMimeType === "application/vnd.ms-excel.sheet.macroenabled.12" || normalizedMimeType === "application/vnd.ms-excel.sheet.binary.macroenabled.12" || normalizedFileName.endsWith(".xlsx") || normalizedFileName.endsWith(".xls") || normalizedFileName.endsWith(".xlsm") || normalizedFileName.endsWith(".xlsb")) {
+    return "spreadsheet";
+  }
+  if (normalizedMimeType === "application/vnd.openxmlformats-officedocument.wordprocessingml.document" || normalizedFileName.endsWith(".docx")) {
+    return "docx";
+  }
+  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")) {
+    return "text";
+  }
+  return null;
+}
+
 // src/client/portRpcClient.ts
 var PROTOCOL = "mindoodb-app-bridge";
 function normalizeRpcValue(value, seen = /* @__PURE__ */ new WeakMap()) {
@@ -235,86 +266,73 @@ function waitForConnectedPort(options, launchId) {
   });
 }
 var MindooDBAppViewHandleImpl = class {
-  constructor(rpc, databaseId, viewId) {
+  constructor(rpc, viewId) {
     this.rpc = rpc;
-    this.databaseId = databaseId;
     this.viewId = viewId;
   }
   async getDefinition() {
     return await this.rpc.call("views.getDefinition", {
-      databaseId: this.databaseId,
       viewId: this.viewId
     });
   }
   async refresh() {
     await this.rpc.call("views.refresh", {
-      databaseId: this.databaseId,
       viewId: this.viewId
     });
   }
   async page(input) {
     return await this.rpc.call("views.page", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       request: input ?? {}
     });
   }
   async getExpansionState() {
     return await this.rpc.call("views.expansion.get", {
-      databaseId: this.databaseId,
       viewId: this.viewId
     });
   }
   async setExpansionState(state) {
     return await this.rpc.call("views.expansion.set", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       expansion: state
     });
   }
   async expand(rowKey) {
     return await this.rpc.call("views.expansion.expand", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       rowKey
     });
   }
   async collapse(rowKey) {
     return await this.rpc.call("views.expansion.collapse", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       rowKey
     });
   }
   async expandAll() {
     return await this.rpc.call("views.expansion.expandAll", {
-      databaseId: this.databaseId,
       viewId: this.viewId
     });
   }
   async collapseAll() {
     return await this.rpc.call("views.expansion.collapseAll", {
-      databaseId: this.databaseId,
       viewId: this.viewId
     });
   }
   async getRow(rowKey) {
     return await this.rpc.call("views.row.get", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       rowKey
     });
   }
   async getCategory(input) {
     return await this.rpc.call("views.category.get", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       lookup: input
     });
   }
   async pageCategory(categoryKey, input) {
     return await this.rpc.call("views.category.page", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       categoryKey,
       request: input ?? {}
@@ -322,14 +340,12 @@ var MindooDBAppViewHandleImpl = class {
   }
   async listCategoryDocumentIds(categoryKey) {
     return await this.rpc.call("views.category.documentIds", {
-      databaseId: this.databaseId,
       viewId: this.viewId,
       categoryKey
     });
   }
   async dispose() {
     await this.rpc.call("views.dispose", {
-      databaseId: this.databaseId,
       viewId: this.viewId
     });
   }
@@ -522,16 +538,6 @@ var MindooDBAppDatabaseImpl = class {
         timestamp
       })
     };
-    this.views = {
-      create: async (definition) => {
-        const result = await this.rpc.call("views.create", {
-          databaseId: this.databaseId,
-          definition
-        });
-        return new MindooDBAppViewHandleImpl(this.rpc, this.databaseId, result.viewId);
-      },
-      open: async (viewId) => new MindooDBAppViewHandleImpl(this.rpc, this.databaseId, viewId)
-    };
     this.attachments = {
       list: async (docId) => await this.rpc.call("attachments.list", {
         databaseId: this.databaseId,
@@ -558,11 +564,16 @@ var MindooDBAppDatabaseImpl = class {
           contentType
         });
         return new MindooDBAppWritableAttachmentStreamImpl(this.rpc, result.streamId);
-      }
+      },
+      openPreview: async (docId, attachmentName, options) => await this.rpc.call("attachments.openPreview", {
+        databaseId: this.databaseId,
+        docId,
+        attachmentName,
+        timestamp: options?.timestamp
+      })
     };
   }
   documents;
-  views;
   attachments;
   /** Returns database metadata for the currently opened binding. */
   async info() {
@@ -587,6 +598,14 @@ var MindooDBAppSessionImpl = class {
     await this.rpc.call("session.openDatabase", { databaseId });
     return new MindooDBAppDatabaseImpl(this.rpc, databaseId);
   }
+  async createView(input) {
+    const result = await this.rpc.call("session.createView", input);
+    return new MindooDBAppViewHandleImpl(this.rpc, result.viewId);
+  }
+  async openView(viewId) {
+    await this.rpc.call("session.openView", { viewId });
+    return new MindooDBAppViewHandleImpl(this.rpc, viewId);
+  }
   onThemeChange(listener) {
     return this.rpc.addMessageListener((message) => {
       if (isThemeChangedMessage(message)) {
@@ -629,6 +648,7 @@ import {
   mindooDBViewLanguageHelpersByName
 } from "mindoodb-view-language";
 export {
+  canPreviewAttachment,
   createMindooDBAppBridge,
   createViewLanguage
 };

package/dist/testing/index.d.ts

@@ -1,10 +1,14 @@
-import { Z as MindooDBAppLaunchContext, P as MindooDBAppDatabaseInfo, R as MindooDBAppDocumentApi, a5 as MindooDBAppViewApi, a as MindooDBAppAttachmentApi, M as MindooDBAppBridge, a2 as MindooDBAppSession, k as MindooDBAppBridgeRpcRequest, Y as MindooDBAppHostTheme, a7 as MindooDBAppViewport, h as MindooDBAppBridgePortMessage } from '../types-BGdIfp-D.js';
-import 'mindoodb-view-language';
+import { a0 as MindooDBAppLaunchContext, S as MindooDBAppDatabaseInfo, U as MindooDBAppDocumentApi, a8 as MindooDBAppViewHandle, b as MindooDBAppAttachmentApi, a as MindooDBAppBridge, a5 as MindooDBAppSession, m as MindooDBAppBridgeRpcRequest, $ as MindooDBAppHostTheme, a9 as MindooDBAppViewport, j as MindooDBAppBridgePortMessage } from '../types-Cvlkh3vJ.js';
+import { MindooDBAppViewDefinition } from 'mindoodb-view-language';
 
 type MaybePromise<T> = T | Promise<T>;
+type MockViewApi = {
+    create(definition: MindooDBAppViewDefinition): MaybePromise<MindooDBAppViewHandle>;
+    open(viewId: string): MaybePromise<MindooDBAppViewHandle>;
+};
 type MockDatabaseMethods = {
     documents?: Partial<MindooDBAppDocumentApi>;
-    views?: Partial<MindooDBAppViewApi>;
+    views?: Partial<MockViewApi>;
     attachments?: Partial<MindooDBAppAttachmentApi>;
 };
 interface MockMindooDBAppDatabaseDefinition {

package/dist/testing/index.js

@@ -20,6 +20,10 @@ function mergeLaunchContext(current, patch) {
       viewport: current.viewport ? { ...current.viewport } : null,
       user: { ...current.user },
       launchParameters: { ...current.launchParameters },
+      databases: current.databases.map((database) => ({
+        ...database,
+        capabilities: [...database.capabilities]
+      })),
       views: current.views.map((view) => ({
         ...view,
         sources: view.sources.map((source) => ({ ...source })),
@@ -45,6 +49,13 @@ function mergeLaunchContext(current, patch) {
     viewport: patch.viewport === void 0 ? current.viewport ? { ...current.viewport } : null : patch.viewport ? { ...patch.viewport } : null,
     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) => ({
+      ...database,
+      capabilities: [...database.capabilities]
+    })) : current.databases.map((database) => ({
+      ...database,
+      capabilities: [...database.capabilities]
+    })),
     views: patch.views ? patch.views.map((view) => ({
       ...view,
       sources: view.sources.map((source) => ({ ...source })),
@@ -98,6 +109,7 @@ function createDefaultLaunchContext(patch) {
       username: "Test User"
     },
     launchParameters: {},
+    databases: [],
     views: []
   };
   return mergeLaunchContext(base, patch);
@@ -265,6 +277,9 @@ function createDatabaseHandle(definition) {
     },
     async openWriteStream(_docId, _attachmentName, _contentType) {
       return createDefaultWritableAttachmentStream();
+    },
+    async openPreview(_docId, _attachmentName, _options) {
+      return { ok: true };
     }
   };
   const methods = definition.methods ?? {};
@@ -276,10 +291,6 @@ function createDatabaseHandle(definition) {
       ...defaultDocuments,
       ...methods.documents
     },
-    views: {
-      ...defaultViews,
-      ...methods.views
-    },
     attachments: {
       ...defaultAttachments,
       ...methods.attachments
@@ -291,16 +302,29 @@ function createMockSessionState(options = {}) {
   const themeListeners = /* @__PURE__ */ new Set();
   const viewportListeners = /* @__PURE__ */ new Set();
   const databaseHandles = /* @__PURE__ */ new Map();
+  const databaseViewApis = /* @__PURE__ */ new Map();
+  const sessionViews = /* @__PURE__ */ new Map();
   let databaseInfos = [];
   const setDatabases = (definitions) => {
     databaseHandles.clear();
+    databaseViewApis.clear();
     databaseInfos = definitions.map((definition) => ({
       ...definition.info,
       capabilities: [...definition.info.capabilities]
     }));
     for (const definition of definitions) {
       databaseHandles.set(definition.info.id, createDatabaseHandle(definition));
+      databaseViewApis.set(definition.info.id, {
+        async create(_definition) {
+          return await createDefaultViewHandle();
+        },
+        async open(_viewId) {
+          return await createDefaultViewHandle();
+        },
+        ...definition.methods?.views ?? {}
+      });
     }
+    launchContext = mergeLaunchContext(launchContext, { databases: databaseInfos });
   };
   setDatabases(options.databases ?? []);
   const session = {
@@ -320,6 +344,33 @@ function createMockSessionState(options = {}) {
       }
       return database;
     },
+    async createView(input) {
+      const api = databaseViewApis.get(input.databaseId);
+      if (!api) {
+        throw new Error(`Unknown test database for view creation: ${input.databaseId}`);
+      }
+      const view = await api.create(input.definition);
+      const viewId = input.definition.id || crypto.randomUUID();
+      sessionViews.set(viewId, view);
+      return view;
+    },
+    async openView(viewId) {
+      const existing = sessionViews.get(viewId);
+      if (existing) {
+        return existing;
+      }
+      const sourceDatabaseId = launchContext.views.find((view2) => view2.id === viewId)?.sources[0]?.databaseId;
+      if (!sourceDatabaseId) {
+        throw new Error(`Unknown test view: ${viewId}`);
+      }
+      const api = databaseViewApis.get(sourceDatabaseId);
+      if (!api) {
+        throw new Error(`Unknown test database for view ${viewId}: ${sourceDatabaseId}`);
+      }
+      const view = await api.open(viewId);
+      sessionViews.set(viewId, view);
+      return view;
+    },
     onThemeChange(listener) {
       themeListeners.add(listener);
       return () => {
@@ -363,6 +414,8 @@ function createMockSessionState(options = {}) {
       }
       return database;
     },
+    createView: session.createView,
+    openView: session.openView,
     bridge,
     session,
     emitThemeChange(theme) {
@@ -492,15 +545,13 @@ function createFakeBridgeHost(options = {}) {
     });
     installed = true;
   }
-  async function resolveViewHandle(databaseId, viewId) {
-    const key = `${databaseId}::${viewId}`;
-    const existing = viewSessions.get(key);
+  async function resolveViewHandle(viewId) {
+    const existing = viewSessions.get(viewId);
     if (existing) {
       return existing;
     }
-    const database = state.getDatabase(databaseId);
-    const handle = await database.views.open(viewId);
-    viewSessions.set(key, handle);
+    const handle = await state.openView(viewId);
+    viewSessions.set(viewId, handle);
     return handle;
   }
   function postRpcSuccess(port, requestId, result) {
@@ -544,6 +595,18 @@ function createFakeBridgeHost(options = {}) {
       case "session.openDatabase":
         state.getDatabase(String(params.databaseId));
         return { ok: true };
+      case "session.createView": {
+        const viewId = `view-${viewCounter += 1}`;
+        const handle = await state.createView({
+          databaseId: String(params.databaseId),
+          definition: params.definition
+        });
+        viewSessions.set(viewId, handle);
+        return { viewId };
+      }
+      case "session.openView":
+        await state.openView(String(params.viewId));
+        return { ok: true };
       case "session.disconnect":
         await state.session.disconnect();
         return { ok: true };
@@ -593,52 +656,52 @@ function createFakeBridgeHost(options = {}) {
         writeStreams.set(streamId, stream);
         return { streamId };
       }
-      case "views.create": {
-        const handle = await state.getDatabase(String(params.databaseId)).views.create(params.definition);
-        const viewId = `view-${viewCounter += 1}`;
-        viewSessions.set(`${String(params.databaseId)}::${viewId}`, handle);
-        return { viewId };
-      }
+      case "attachments.openPreview":
+        return await state.getDatabase(String(params.databaseId)).attachments.openPreview(
+          String(params.docId),
+          String(params.attachmentName),
+          typeof params.timestamp === "number" ? { timestamp: params.timestamp } : void 0
+        );
       case "views.getDefinition":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).getDefinition();
+        return await (await resolveViewHandle(String(params.viewId))).getDefinition();
       case "views.refresh":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).refresh();
+        return await (await resolveViewHandle(String(params.viewId))).refresh();
       case "views.page":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).page(
+        return await (await resolveViewHandle(String(params.viewId))).page(
           params.request
         );
       case "views.expansion.get":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).getExpansionState();
+        return await (await resolveViewHandle(String(params.viewId))).getExpansionState();
       case "views.expansion.set":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).setExpansionState(
+        return await (await resolveViewHandle(String(params.viewId))).setExpansionState(
           params.expansion
         );
       case "views.expansion.expand":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).expand(String(params.rowKey));
+        return await (await resolveViewHandle(String(params.viewId))).expand(String(params.rowKey));
       case "views.expansion.collapse":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).collapse(String(params.rowKey));
+        return await (await resolveViewHandle(String(params.viewId))).collapse(String(params.rowKey));
       case "views.expansion.expandAll":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).expandAll();
+        return await (await resolveViewHandle(String(params.viewId))).expandAll();
       case "views.expansion.collapseAll":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).collapseAll();
+        return await (await resolveViewHandle(String(params.viewId))).collapseAll();
       case "views.row.get":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).getRow(String(params.rowKey));
+        return await (await resolveViewHandle(String(params.viewId))).getRow(String(params.rowKey));
       case "views.category.get":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).getCategory(
+        return await (await resolveViewHandle(String(params.viewId))).getCategory(
           params.lookup
         );
       case "views.category.page":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).pageCategory(
+        return await (await resolveViewHandle(String(params.viewId))).pageCategory(
           String(params.categoryKey),
           params.request
         );
       case "views.category.documentIds":
-        return await (await resolveViewHandle(String(params.databaseId), String(params.viewId))).listCategoryDocumentIds(
+        return await (await resolveViewHandle(String(params.viewId))).listCategoryDocumentIds(
           String(params.categoryKey)
         );
       case "views.dispose": {
-        const key = `${String(params.databaseId)}::${String(params.viewId)}`;
-        const handle = await resolveViewHandle(String(params.databaseId), String(params.viewId));
+        const key = String(params.viewId);
+        const handle = await resolveViewHandle(String(params.viewId));
         await handle.dispose();
         viewSessions.delete(key);
         return void 0;

package/dist/{types-BGdIfp-D.d.ts → types-Cvlkh3vJ.d.ts}

@@ -109,6 +109,7 @@ interface MindooDBAppLaunchContext {
         username: string;
     };
     launchParameters: Record<string, string>;
+    databases: MindooDBAppDatabaseInfo[];
     views: MindooDBAppResolvedViewDefinition[];
 }
 /** Attachment metadata returned by the attachment APIs. */
@@ -118,6 +119,13 @@ interface MindooDBAppAttachmentInfo {
     mimeType: string;
     size: number;
 }
+/** Preview modes supported by the Haven-hosted attachment preview dialog. */
+type MindooDBAppAttachmentPreviewMode = "image" | "pdf" | "text" | "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;
+}
 /** Database entry visible to the app during launch and database listing. */
 interface MindooDBAppDatabaseInfo {
     id: string;
@@ -334,10 +342,10 @@ interface MindooDBAppViewHandle {
     listCategoryDocumentIds(categoryKey: string): Promise<string[]>;
     dispose(): Promise<void>;
 }
-/** Entry point for creating or opening views in a database. */
-interface MindooDBAppViewApi {
-    create(definition: MindooDBAppViewDefinition): Promise<MindooDBAppViewHandle>;
-    open(viewId: string): Promise<MindooDBAppViewHandle>;
+/** Payload used when creating one dynamic view inside the current app session. */
+interface MindooDBAppCreateViewInput {
+    databaseId: string;
+    definition: MindooDBAppViewDefinition;
 }
 /** Attachment operations exposed by an opened database handle. */
 interface MindooDBAppAttachmentApi {
@@ -347,12 +355,14 @@ interface MindooDBAppAttachmentApi {
     }>;
     openReadStream(docId: string, attachmentName: string): Promise<MindooDBAppReadableAttachmentStream>;
     openWriteStream(docId: string, attachmentName: string, contentType?: string): Promise<MindooDBAppWritableAttachmentStream>;
+    openPreview(docId: string, attachmentName: string, options?: MindooDBAppAttachmentPreviewOptions): Promise<{
+        ok: true;
+    }>;
 }
 /** Database handle returned from `session.openDatabase()`. */
 interface MindooDBAppDatabase {
     info(): Promise<MindooDBAppDatabaseInfo>;
     documents: MindooDBAppDocumentApi;
-    views: MindooDBAppViewApi;
     attachments: MindooDBAppAttachmentApi;
 }
 /** Connected session between the running app and the Administrator host. */
@@ -360,6 +370,8 @@ interface MindooDBAppSession {
     getLaunchContext(): Promise<MindooDBAppLaunchContext>;
     listDatabases(): Promise<MindooDBAppDatabaseInfo[]>;
     openDatabase(databaseId: string): Promise<MindooDBAppDatabase>;
+    createView(input: MindooDBAppCreateViewInput): Promise<MindooDBAppViewHandle>;
+    openView(viewId: string): Promise<MindooDBAppViewHandle>;
     onThemeChange(listener: (theme: MindooDBAppHostTheme) => void): () => void;
     onViewportChange(listener: (viewport: MindooDBAppViewport) => void): () => void;
     disconnect(): Promise<void>;
@@ -369,4 +381,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export type { MindooDBAppResolvedViewDefinition as $, MindooDBAppConfiguredViewExpressionMode as A, MindooDBAppConfiguredViewFieldExpression as B, MindooDBAppConfiguredViewFilterDefinition as C, MindooDBAppConfiguredViewFilterMode as D, MindooDBAppConfiguredViewFilterRule as E, MindooDBAppConfiguredViewFormulaExpression as F, MindooDBAppConfiguredViewFormulaFilterDefinition as G, MindooDBAppConfiguredViewPreviewMode as H, MindooDBAppConfiguredViewRuleFilterDefinition as I, MindooDBAppConfiguredViewRuleMatchMode as J, MindooDBAppConfiguredViewRuleOperator as K, MindooDBAppConfiguredViewValueExpression as L, MindooDBAppBridge as M, MindooDBAppCreateDocumentInput as N, MindooDBAppDatabase as O, MindooDBAppDatabaseInfo as P, MindooDBAppDocument as Q, MindooDBAppDocumentApi as R, MindooDBAppDocumentHistoryEntry as S, MindooDBAppDocumentListQuery as T, MindooDBAppDocumentListResult as U, MindooDBAppDocumentSummary as V, MindooDBAppHistoricalDocument as W, MindooDBAppHistoryQuery as X, MindooDBAppHostTheme as Y, MindooDBAppLaunchContext as Z, MindooDBAppReadableAttachmentStream as _, MindooDBAppAttachmentApi as a, MindooDBAppResolvedViewSource as a0, MindooDBAppRuntime as a1, MindooDBAppSession as a2, MindooDBAppThemeMode as a3, MindooDBAppUpdateDocumentInput as a4, MindooDBAppViewApi as a5, MindooDBAppViewHandle as a6, MindooDBAppViewport as a7, MindooDBAppWritableAttachmentStream as a8, MindooDBAppAttachmentChunk as b, MindooDBAppAttachmentInfo as c, MindooDBAppBridgeConnectMessage as d, MindooDBAppBridgeConnectOptions as e, MindooDBAppBridgeConnectedMessage as f, MindooDBAppBridgeErrorPayload as g, MindooDBAppBridgePortMessage as h, MindooDBAppBridgeRpcError as i, MindooDBAppBridgeRpcMessage as j, MindooDBAppBridgeRpcRequest as k, MindooDBAppBridgeRpcSuccess as l, MindooDBAppBridgeStreamAbortRequest as m, MindooDBAppBridgeStreamAck as n, MindooDBAppBridgeStreamCloseRequest as o, MindooDBAppBridgeStreamError as p, MindooDBAppBridgeStreamMessage as q, MindooDBAppBridgeStreamOpenResult as r, MindooDBAppBridgeStreamReadRequest as s, MindooDBAppBridgeStreamWriteRequest as t, MindooDBAppBridgeThemeChangedMessage as u, MindooDBAppBridgeViewportChangedMessage as v, MindooDBAppCapability as w, MindooDBAppConfiguredViewCategorizationStyle as x, MindooDBAppConfiguredViewColumn as y, MindooDBAppConfiguredViewColumnRole as z };
+export type { MindooDBAppHostTheme as $, MindooDBAppConfiguredViewColumn as A, MindooDBAppConfiguredViewColumnRole as B, MindooDBAppConfiguredViewExpressionMode as C, MindooDBAppConfiguredViewFieldExpression as D, MindooDBAppConfiguredViewFilterDefinition as E, MindooDBAppConfiguredViewFilterMode as F, MindooDBAppConfiguredViewFilterRule as G, MindooDBAppConfiguredViewFormulaExpression as H, MindooDBAppConfiguredViewFormulaFilterDefinition as I, MindooDBAppConfiguredViewPreviewMode as J, MindooDBAppConfiguredViewRuleFilterDefinition as K, MindooDBAppConfiguredViewRuleMatchMode as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewRuleOperator as N, MindooDBAppConfiguredViewValueExpression as O, MindooDBAppCreateDocumentInput as P, MindooDBAppCreateViewInput as Q, MindooDBAppDatabase as R, MindooDBAppDatabaseInfo as S, MindooDBAppDocument as T, MindooDBAppDocumentApi as U, MindooDBAppDocumentHistoryEntry as V, MindooDBAppDocumentListQuery as W, MindooDBAppDocumentListResult as X, MindooDBAppDocumentSummary as Y, MindooDBAppHistoricalDocument as Z, MindooDBAppHistoryQuery as _, MindooDBAppBridge as a, MindooDBAppLaunchContext as a0, MindooDBAppReadableAttachmentStream as a1, MindooDBAppResolvedViewDefinition as a2, MindooDBAppResolvedViewSource as a3, MindooDBAppRuntime as a4, MindooDBAppSession as a5, MindooDBAppThemeMode as a6, MindooDBAppUpdateDocumentInput as a7, MindooDBAppViewHandle as a8, MindooDBAppViewport as a9, MindooDBAppWritableAttachmentStream as aa, MindooDBAppAttachmentApi as b, MindooDBAppAttachmentChunk as c, MindooDBAppAttachmentInfo as d, MindooDBAppAttachmentPreviewOptions as e, MindooDBAppBridgeConnectMessage as f, MindooDBAppBridgeConnectOptions as g, MindooDBAppBridgeConnectedMessage as h, MindooDBAppBridgeErrorPayload as i, MindooDBAppBridgePortMessage as j, MindooDBAppBridgeRpcError as k, MindooDBAppBridgeRpcMessage as l, MindooDBAppBridgeRpcRequest as m, MindooDBAppBridgeRpcSuccess as n, MindooDBAppBridgeStreamAbortRequest as o, MindooDBAppBridgeStreamAck as p, MindooDBAppBridgeStreamCloseRequest as q, MindooDBAppBridgeStreamError as r, MindooDBAppBridgeStreamMessage as s, MindooDBAppBridgeStreamOpenResult as t, MindooDBAppBridgeStreamReadRequest as u, MindooDBAppBridgeStreamWriteRequest as v, MindooDBAppBridgeThemeChangedMessage as w, MindooDBAppBridgeViewportChangedMessage as x, MindooDBAppCapability as y, MindooDBAppConfiguredViewCategorizationStyle as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "MindooDB app SDK for building apps that connect to the Haven host bridge",
   "license": "ISC",
   "author": "Mindoo GmbH",
@@ -40,7 +40,7 @@
     "prepublishOnly": "npm run build && npm run test"
   },
   "dependencies": {
-    "mindoodb-view-language": "^0.0.4"
+    "mindoodb-view-language": "file:../mindoodb-view-language"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",