mindoodb-app-sdk 0.0.4 → 0.0.6

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,33 @@
-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-BDY_80wd.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-BDY_80wd.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;
+
+/**
+ * Convert a canonical Notes name like `cn=Jane/ou=Dev/o=Mindoo`
+ * into the abbreviated form `Jane/Dev/Mindoo`.
+ *
+ * If the input is not a slash-separated canonical name, the trimmed
+ * original value is returned unchanged.
+ */
+declare function abbreviateCanonicalName(value: string): string;
+/**
+ * Convert an abbreviated Notes name like `Jane/Dev/Mindoo`
+ * into canonical form `cn=Jane/ou=Dev/o=Mindoo`.
+ *
+ * The first segment becomes `cn=`, the last becomes `o=`, and any
+ * middle segments become `ou=` parts in order. Values with fewer than
+ * two segments are returned unchanged.
+ */
+declare function expandAbbreviatedName(value: string): string;
+
 /**
  * Creates the browser-side bridge entry point used by MindooDB apps.
  *
@@ -11,4 +37,4 @@ export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterD
  */
 declare function createMindooDBAppBridge(): MindooDBAppBridge;
 
-export { MindooDBAppBridge, createMindooDBAppBridge };
+export { MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, abbreviateCanonicalName, canPreviewAttachment, createMindooDBAppBridge, expandAbbreviatedName };

package/dist/index.js

@@ -1,3 +1,76 @@
+// 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/canonicalNames.ts
+var CANONICAL_PART_PATTERN = /^\s*([^=]+)\s*=\s*(.*?)\s*$/;
+function splitNameParts(value) {
+  return value.split("/").map((part) => part.trim()).filter(Boolean);
+}
+function abbreviateCanonicalName(value) {
+  const parts = splitNameParts(value);
+  if (!parts.length) {
+    return value.trim();
+  }
+  const abbreviatedParts = [];
+  for (const part of parts) {
+    const match = CANONICAL_PART_PATTERN.exec(part);
+    if (!match) {
+      return value.trim();
+    }
+    const partValue = match[2].trim();
+    if (!partValue) {
+      return value.trim();
+    }
+    abbreviatedParts.push(partValue);
+  }
+  return abbreviatedParts.join("/");
+}
+function expandAbbreviatedName(value) {
+  const parts = splitNameParts(value);
+  if (parts.length < 2) {
+    return value.trim();
+  }
+  const [commonName, ...rest] = parts;
+  const organization = rest.at(-1);
+  if (!commonName || !organization) {
+    return value.trim();
+  }
+  const organizationUnits = rest.slice(0, -1);
+  return [
+    `cn=${commonName}`,
+    ...organizationUnits.map((part) => `ou=${part}`),
+    `o=${organization}`
+  ].join("/");
+}
+
 // src/client/portRpcClient.ts
 var PROTOCOL = "mindoodb-app-bridge";
 function normalizeRpcValue(value, seen = /* @__PURE__ */ new WeakMap()) {
@@ -235,86 +308,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 +382,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 +580,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 +606,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 +640,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 +690,9 @@ import {
   mindooDBViewLanguageHelpersByName
 } from "mindoodb-view-language";
 export {
+  abbreviateCanonicalName,
+  canPreviewAttachment,
   createMindooDBAppBridge,
-  createViewLanguage
+  createViewLanguage,
+  expandAbbreviatedName
 };

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-BDY_80wd.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 {