mindoodb-app-sdk 0.0.48 → 0.0.51

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { as as MindooDBAppCreateViewNavigatorInput, cl as MindooDBAppViewNavigator, bd as MindooDBAppLaunchContext, at as MindooDBAppDatabaseInfo, aB as MindooDBAppDocumentApi, cn as MindooDBAppViewNavigatorOpenOptions, v as MindooDBAppAttachmentApi, b1 as MindooDBAppIdentityApi, cb as MindooDBAppTimestampApi, az as MindooDBAppDirectoryApi, j as MindooDBAppDocument, aZ as MindooDBAppFulltextSetup, aY as MindooDBAppExtractionSetup, bs as MindooDBAppProposeAppInput, bt as MindooDBAppProposeAppResult, e as MindooDBAppBridge, c0 as MindooDBAppSession, V as MindooDBAppBridgeRpcRequest, b0 as MindooDBAppHostTheme, ct as MindooDBAppViewport, cf as MindooDBAppUiPreferences, by as MindooDBAppQueryResult, cs as MindooDBAppViewUpdateStats, R as MindooDBAppBridgePortMessage, c as MindooDBAppDragStartResult, aS as MindooDBAppDragProfile } from '../types-C-eyC839.js';
+import { au as MindooDBAppCreateViewNavigatorInput, cw as MindooDBAppViewNavigator, bg as MindooDBAppLaunchContext, av as MindooDBAppDatabaseInfo, aD as MindooDBAppDocumentApi, cy as MindooDBAppViewNavigatorOpenOptions, w as MindooDBAppAttachmentApi, b3 as MindooDBAppIdentityApi, cm as MindooDBAppTimestampApi, aB as MindooDBAppDirectoryApi, j as MindooDBAppDocument, a$ as MindooDBAppFulltextSetup, a_ as MindooDBAppExtractionSetup, ce as MindooDBAppSummarySetup, by as MindooDBAppProposeAppInput, bz as MindooDBAppProposeAppResult, e as MindooDBAppBridge, c6 as MindooDBAppSession, X as MindooDBAppBridgeRpcRequest, b2 as MindooDBAppHostTheme, cE as MindooDBAppViewport, cq as MindooDBAppUiPreferences, bE as MindooDBAppQueryResult, cD as MindooDBAppViewUpdateStats, T as MindooDBAppBridgePortMessage, c as MindooDBAppDragStartResult, aU as MindooDBAppDragProfile } from '../types-BLyV6Ejy.js';
 import * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 
@@ -72,6 +72,13 @@ interface MockMindooDBAppDatabaseDefinition {
      * their setup/bootstrap logic.
      */
     extractionSetup?: MindooDBAppExtractionSetup | null;
+    /**
+     * Initial summary buffer configuration returned by `getSummarySetup()`.
+     * `setSummarySetup()` overwrites it for the lifetime of the handle. The
+     * mock's `query()` reads the seeded documents directly and ignores this
+     * config — it exists so apps can test their setup/bootstrap logic.
+     */
+    summarySetup?: MindooDBAppSummarySetup | null;
 }
 /**
  * Stands in for the host-owned sealed channel.
@@ -122,6 +129,8 @@ interface MockMindooDBAppSessionController {
     emitLocaleChange(locale: string): void;
     /** Runs the app's `onBeforeClose` listeners, as the host does before a teardown. */
     emitBeforeClose(): Promise<void>;
+    /** Sets whether this mock launch has host focus and notifies listeners. */
+    emitHostFocusChange(focused: boolean): void;
     resolveDrag(result: MindooDBAppDragStartResult): void;
     getDragProfile(): MindooDBAppDragProfile | null;
 }
@@ -155,6 +164,7 @@ interface FakeBridgeHostController {
     emitViewportChange(viewport: MindooDBAppViewport): void;
     emitUiPreferencesChange(uiPreferences: MindooDBAppUiPreferences): void;
     emitLocaleChange(locale: string): void;
+    emitHostFocusChange(focused: boolean): void;
     /** Push a live-query result to connected apps, as the Haven host would. */
     emitQueryResult(subscriptionId: string, result: MindooDBAppQueryResult): void;
     /** Push a navigator view-changed event to connected apps. */

package/dist/testing/index.js

@@ -1,6 +1,7 @@
 import {
+  MINDOODB_APP_VALUE_TAG,
   releaseMindooDBAppBridgeSessions
-} from "../chunk-TPYDERAK.js";
+} from "../chunk-R76XXRJ6.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
@@ -473,7 +474,7 @@ function cloneBytes(chunk) {
 function applyDocumentUpdatePatch(current, patch) {
   const next = {
     ...structuredClone(current),
-    ...patch.set ? structuredClone(patch.set) : {}
+    ...patch.set ? readMockTypedValues(patch.set) : {}
   };
   for (const key of patch.unset ?? []) {
     Reflect.deleteProperty(next, key);
@@ -496,7 +497,7 @@ function applyMockJsonPatch(target, patch) {
     return;
   }
   for (const operation of patch.set ?? []) {
-    setValueAtPath(target, operation.path, structuredClone(operation.value));
+    setValueAtPath(target, operation.path, readMockTypedValues(operation.value));
   }
   for (const operation of patch.unset ?? []) {
     unsetValueAtPath(target, operation.path);
@@ -506,8 +507,13 @@ function applyMockJsonPatch(target, patch) {
     list.splice(operation.index, operation.deleteCount);
   }
   for (const operation of patch.listInsert ?? []) {
+    const parent = ensureParentAtPath(target, operation.path);
+    const leaf = operation.path[operation.path.length - 1];
+    if (parent[leaf] == null) {
+      parent[leaf] = [];
+    }
     const list = readListAtPath(target, operation.path);
-    list.splice(operation.index, 0, ...structuredClone(operation.values));
+    list.splice(operation.index, 0, ...readMockTypedValues(operation.values));
   }
   for (const operation of patch.textSplice ?? []) {
     applyMockTextPatch(target, operation.path, [{
@@ -522,6 +528,81 @@ function applyMockJsonPatch(target, patch) {
   for (const operation of patch.textUnmark ?? []) {
     applyMockTextMarks(target, operation.path, operation.index, operation.length, Object.fromEntries(operation.names.map((name) => [name, null])), true);
   }
+  for (const operation of patch.counterIncrement ?? []) {
+    assertMockCounterAmount(operation.delta, "JSON counterIncrement delta");
+    const parent = ensureParentAtPath(target, operation.path);
+    const leaf = operation.path[operation.path.length - 1];
+    const current = parent[leaf];
+    if (current == null) {
+      parent[leaf] = operation.delta;
+    } else if (typeof current === "number") {
+      parent[leaf] = current + operation.delta;
+    } else {
+      throw new Error(
+        `Cannot increment non-counter value at ${operation.path.map(String).join(".")}`
+      );
+    }
+  }
+}
+var MOCK_CURSOR_PREFIX = "mock-cursor:";
+function readMockCursorText(data, path) {
+  let value = data;
+  for (const segment of path) {
+    value = value?.[segment];
+  }
+  if (typeof value !== "string") {
+    throw new Error(
+      `Text cursors require an Automerge text field at '${path.map(String).join(".")}'`
+    );
+  }
+  return value;
+}
+function readMockTypedValues(value) {
+  if (value === null || typeof value !== "object") {
+    return value;
+  }
+  if (value instanceof Uint8Array) {
+    return value.slice();
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => readMockTypedValues(entry));
+  }
+  const record = value;
+  if (Object.prototype.hasOwnProperty.call(record, MINDOODB_APP_VALUE_TAG)) {
+    switch (record[MINDOODB_APP_VALUE_TAG]) {
+      case "atomic":
+        if (typeof record.value !== "string") {
+          throw new Error('Typed value "atomic" needs a string value');
+        }
+        return record.value;
+      case "counter":
+        assertMockCounterAmount(record.value, 'Typed value "counter"');
+        return record.value;
+      case "timestamp":
+        return toMockTimestamp(record.value);
+      default:
+        throw new Error(
+          `Unknown typed value ${JSON.stringify(record[MINDOODB_APP_VALUE_TAG])}; the "${MINDOODB_APP_VALUE_TAG}" key is reserved`
+        );
+    }
+  }
+  return Object.fromEntries(
+    Object.entries(record).map(([key, entry]) => [key, readMockTypedValues(entry)])
+  );
+}
+function toMockTimestamp(value) {
+  const date = typeof value === "number" || typeof value === "string" && value.trim() !== "" ? new Date(value) : null;
+  if (!date || Number.isNaN(date.getTime())) {
+    throw new Error(
+      'Typed value "timestamp" must be epoch milliseconds or an ISO 8601 date-time string'
+    );
+  }
+  return date.toISOString();
+}
+function assertMockCounterAmount(amount, label) {
+  if (typeof amount !== "number" || !Number.isSafeInteger(amount)) {
+    throw new Error(`${label} must be a safe integer`);
+  }
 }
 function setValueAtPath(target, path, value) {
   if (path.length === 0) {
@@ -1737,6 +1818,45 @@ function createDatabaseHandle(definition, peers) {
         spans: structuredClone(readRichTextSpansAtPath(document.data, path))
       };
     },
+    // Mock cursors store the index they were created at and do not follow
+    // later edits; Haven's Automerge-backed cursors do.
+    async getTextCursors(docId, path, positions, options) {
+      const document = storedDocuments.get(docId);
+      if (!document || document.isDeleted) {
+        throw new Error(`Document ${docId} was not found.`);
+      }
+      const text = readMockCursorText(document.data, path);
+      return {
+        path: [...path],
+        heads: options?.heads ? [...options.heads] : [...document.heads ?? []],
+        cursors: positions.map((position) => {
+          if (position === "start") return `${MOCK_CURSOR_PREFIX}0`;
+          if (position === "end") return `${MOCK_CURSOR_PREFIX}end`;
+          if (typeof position !== "number" || !Number.isFinite(position)) {
+            throw new Error('Text cursor positions must be numbers, "start" or "end"');
+          }
+          return `${MOCK_CURSOR_PREFIX}${Math.max(0, Math.min(Math.trunc(position), text.length))}`;
+        })
+      };
+    },
+    async resolveTextCursors(docId, path, cursors, options) {
+      const document = storedDocuments.get(docId);
+      if (!document || document.isDeleted) {
+        throw new Error(`Document ${docId} was not found.`);
+      }
+      const text = readMockCursorText(document.data, path);
+      return {
+        path: [...path],
+        heads: options?.heads ? [...options.heads] : [...document.heads ?? []],
+        positions: cursors.map((cursor) => {
+          if (typeof cursor !== "string" || !cursor.startsWith(MOCK_CURSOR_PREFIX)) {
+            throw new Error(`Unknown text cursor ${String(cursor)}`);
+          }
+          const raw = cursor.slice(MOCK_CURSOR_PREFIX.length);
+          return raw === "end" ? text.length : Math.min(Number(raw), text.length);
+        })
+      };
+    },
     async getAutomergeSnapshot(docId, _options) {
       const document = storedDocuments.get(docId);
       if (!document || document.isDeleted) {
@@ -1785,6 +1905,13 @@ function createDatabaseHandle(definition, peers) {
         changesSince
       };
     },
+    async applyAutomergeChangesBatch(items) {
+      const results = [];
+      for (const item of items) {
+        results.push(await this.applyAutomergeChanges(item.docId, item.patch));
+      }
+      return results;
+    },
     async create(input) {
       if (input.id !== void 0 && input.idPrefix !== void 0) {
         throw new Error("documents.create: id and idPrefix are mutually exclusive");
@@ -1831,7 +1958,7 @@ function createDatabaseHandle(definition, peers) {
       const created = {
         id,
         data: {
-          ...input.set,
+          ...readMockTypedValues(input.set ?? {}),
           ...Array.isArray(input.recipients) ? { _encryptFor: mockEncryptForMap(input.recipients) } : {}
         },
         heads: [`mock-head-${++changeCounter}`],
@@ -2119,6 +2246,7 @@ function createDatabaseHandle(definition, peers) {
   const methods = definition.methods ?? {};
   let fulltextSetup = definition.fulltextSetup ?? null;
   let extractionSetup = definition.extractionSetup ?? null;
+  let summarySetup = definition.summarySetup ?? null;
   const databaseHandle = {
     async info() {
       return {
@@ -2157,6 +2285,12 @@ function createDatabaseHandle(definition, peers) {
     },
     async setExtractionSetup(config) {
       extractionSetup = config === null ? null : { ...config };
+    },
+    async getSummarySetup() {
+      return summarySetup === null ? null : structuredClone(summarySetup);
+    },
+    async setSummarySetup(config) {
+      summarySetup = config === null ? null : structuredClone(config);
     }
   };
   return {
@@ -2174,6 +2308,8 @@ function createDatabaseHandle(definition, peers) {
 function createMockSessionState(options = {}) {
   let launchContext = createDefaultLaunchContext(options.launchContext);
   const themeListeners = /* @__PURE__ */ new Set();
+  const hostFocusListeners = /* @__PURE__ */ new Set();
+  let hostFocused = false;
   const viewportListeners = /* @__PURE__ */ new Set();
   const uiPreferencesListeners = /* @__PURE__ */ new Set();
   const localeListeners = /* @__PURE__ */ new Set();
@@ -2465,6 +2601,23 @@ function createMockSessionState(options = {}) {
         beforeCloseListeners.delete(listener);
       };
     },
+    async requestHostFocus() {
+      hostFocused = true;
+      hostFocusListeners.forEach((listener) => listener(true));
+    },
+    async hasHostFocus() {
+      return hostFocused;
+    },
+    onHostFocusChange(listener) {
+      hostFocusListeners.add(listener);
+      return () => {
+        hostFocusListeners.delete(listener);
+      };
+    },
+    async notify(input) {
+      const id = input.id?.trim() || crypto.randomUUID();
+      return { id };
+    },
     async disconnect() {
       await options.onDisconnect?.();
     }
@@ -2527,6 +2680,10 @@ function createMockSessionState(options = {}) {
     async emitBeforeClose() {
       await Promise.all([...beforeCloseListeners].map(async (listener) => listener()));
     },
+    setHostFocused(focused) {
+      hostFocused = focused;
+      hostFocusListeners.forEach((listener) => listener(focused));
+    },
     resolveDrag(result) {
       activeDragResolve?.(result);
       activeDragResolve = null;
@@ -2552,6 +2709,9 @@ function createMockMindooDBAppSession(options = {}) {
     emitUiPreferencesChange: state.emitUiPreferencesChange,
     emitLocaleChange: state.emitLocaleChange,
     emitBeforeClose: state.emitBeforeClose,
+    emitHostFocusChange(focused) {
+      state.setHostFocused(focused);
+    },
     resolveDrag: state.resolveDrag,
     getDragProfile: state.getDragProfile
   };
@@ -2755,6 +2915,15 @@ function createFakeBridgeHost(options = {}) {
       case "menus.hide":
         await state.session.menus.hide();
         return { ok: true };
+      case "session.requestHostFocus":
+        await state.session.requestHostFocus();
+        return null;
+      case "session.hasHostFocus":
+        return { focused: await state.session.hasHostFocus() };
+      case "notifications.show":
+        return await state.session.notify(
+          request.params
+        );
       case "session.disconnect":
         await state.session.disconnect();
         return { ok: true };
@@ -2799,6 +2968,15 @@ function createFakeBridgeHost(options = {}) {
           params.config ?? null
         );
         return { ok: true };
+      case "database.getSummarySetup":
+        return {
+          config: await state.getDatabase(String(params.databaseId)).getSummarySetup()
+        };
+      case "database.setSummarySetup":
+        await state.getDatabase(String(params.databaseId)).setSummarySetup(
+          params.config ?? null
+        );
+        return { ok: true };
       case "documents.query":
         return await state.getDatabase(String(params.databaseId)).documents.query(
           params.query
@@ -2844,6 +3022,23 @@ function createFakeBridgeHost(options = {}) {
           String(params.docId),
           params.path
         );
+      case "documents.textCursors.get":
+        return await state.getDatabase(String(params.databaseId)).documents.getTextCursors(
+          String(params.docId),
+          params.path,
+          params.positions,
+          {
+            heads: params.heads,
+            move: params.move
+          }
+        );
+      case "documents.textCursors.resolve":
+        return await state.getDatabase(String(params.databaseId)).documents.resolveTextCursors(
+          String(params.docId),
+          params.path,
+          params.cursors,
+          { heads: params.heads }
+        );
       case "documents.automerge.getSnapshot":
         return await state.getDatabase(String(params.databaseId)).documents.getAutomergeSnapshot(
           String(params.docId),
@@ -3205,6 +3400,16 @@ function createFakeBridgeHost(options = {}) {
       beforeCloseWaiters.get(message.closeId)?.();
       return;
     }
+    if (message.kind === "workspace-focus-requested") {
+      state.setHostFocused(true);
+      const payload = {
+        protocol: PROTOCOL,
+        kind: "host-focus-changed",
+        focused: true
+      };
+      port.postMessage(payload);
+      return;
+    }
     if (message.kind === "request") {
       requests.push(message);
       try {
@@ -3315,6 +3520,15 @@ function createFakeBridgeHost(options = {}) {
       };
       connectedPorts.forEach((port) => port.postMessage(payload));
     },
+    emitHostFocusChange(focused) {
+      state.setHostFocused(focused);
+      const payload = {
+        protocol: PROTOCOL,
+        kind: "host-focus-changed",
+        focused
+      };
+      connectedPorts.forEach((port) => port.postMessage(payload));
+    },
     emitQueryResult(subscriptionId, result) {
       const payload = {
         protocol: PROTOCOL,