mindoodb-app-sdk 0.0.59 → 0.0.60

package/dist/testing/index.d.ts

@@ -1,7 +1,24 @@
-import { aK as MindooDBAppCreateViewNavigatorInput, cX as MindooDBAppViewNavigator, aa as MindooDBAppBridgeRpcRequest, bj as MindooDBAppHostTheme, as as MindooDBAppCapability, j as MindooDBAppDefinition, I as MindooDBAppAttachmentApi, e as MindooDBAppBridge, cx as MindooDBAppSession, bZ as MindooDBAppProposeAppInput, d3 as MindooDBAppViewport, cR as MindooDBAppUiPreferences, c3 as MindooDBAppQueryResult, d2 as MindooDBAppViewUpdateStats, a6 as MindooDBAppBridgePortMessage, aL as MindooDBAppDatabaseInfo, a1 as MindooDBAppBridgeErrorPayload, bE as MindooDBAppLaunchContext, aU as MindooDBAppDocumentApi, cZ as MindooDBAppViewNavigatorOpenOptions, bk as MindooDBAppIdentityApi, cN as MindooDBAppTimestampApi, aS as MindooDBAppDirectoryApi, l as MindooDBAppDocument, bg as MindooDBAppFulltextSetup, bf as MindooDBAppExtractionSetup, cF as MindooDBAppSummarySetup, b_ as MindooDBAppProposeAppResult, bu as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, b9 as MindooDBAppDragProfile, bt as MindooDBAppIncomingResult } from '../types-DkzIJKBw.js';
+import { ax as MindooDBAppComponentInfo, bo as MindooDBAppEmbedRect, aT as MindooDBAppCreateViewNavigatorInput, dc as MindooDBAppViewNavigator, ac as MindooDBAppBridgeRpcRequest, bA as MindooDBAppHostTheme, au as MindooDBAppCapability, j as MindooDBAppDefinition, J as MindooDBAppAttachmentApi, e as MindooDBAppBridge, cO as MindooDBAppSession, ce as MindooDBAppProposeAppInput, dk as MindooDBAppViewport, d6 as MindooDBAppUiPreferences, ck as MindooDBAppQueryResult, dj as MindooDBAppViewUpdateStats, a8 as MindooDBAppBridgePortMessage, aU as MindooDBAppDatabaseInfo, bk as MindooDBAppEmbedCloseReason, a3 as MindooDBAppBridgeErrorPayload, bV as MindooDBAppLaunchContext, b1 as MindooDBAppDocumentApi, de as MindooDBAppViewNavigatorOpenOptions, bB as MindooDBAppIdentityApi, d2 as MindooDBAppTimestampApi, a$ as MindooDBAppDirectoryApi, l as MindooDBAppDocument, bx as MindooDBAppFulltextSetup, bw as MindooDBAppExtractionSetup, cW as MindooDBAppSummarySetup, cf as MindooDBAppProposeAppResult, bL as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bi as MindooDBAppDragProfile, bK as MindooDBAppIncomingResult } from '../types-D0Bsbd1G.js';
 import * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 
+/** An embed the mock host currently shows, as tests and the test host page see it. */
+interface MockEmbedState {
+    embedId: string;
+    component: MindooDBAppComponentInfo;
+    databaseId: string;
+    docId: string;
+    intent: "edit" | "view";
+    rect: MindooDBAppEmbedRect;
+    visible: boolean;
+}
+/** How an app running as an embedded component finished (`session.embedding`). */
+interface MockEmbeddingFinish {
+    reason: "completed" | "cancelled";
+    result?: unknown;
+    message?: string;
+}
+
 type EvaluatingViewDocument = {
     origin: string;
     docId: string;
@@ -321,6 +338,10 @@ interface CreateMockMindooDBAppSessionOptions {
      * `methods.directory` still wins.
      */
     directoryUsers?: readonly string[];
+    /** What `session.components.list` offers; see `closeEmbed` on the controller. */
+    components?: MindooDBAppComponentInfo[];
+    /** Called whenever the app opens, moves or closes an embed. */
+    onEmbedChange?: (embeds: readonly MockEmbedState[]) => void;
 }
 /**
  * Test usernames in Haven's canonical form: `CN=Test User 001/O=Test`, …
@@ -366,7 +387,16 @@ interface MockMindooDBAppSessionController {
      * and resolves with the handler's result.
      */
     emitIncomingContent(input: MockIncomingContentInput): Promise<MindooDBAppIncomingResult>;
+    /** Embeds the app has open (`session.embeds.open`). */
+    listEmbeds(): MockEmbedState[];
+    /** Closes an embed as Haven does when the component finishes or the user closes it. */
+    closeEmbed(embedId: string, reason?: MindooDBAppEmbedCloseReason, result?: unknown): void;
+    /** Replaces what `session.components.list` offers. */
+    setComponents(components: MindooDBAppComponentInfo[]): void;
+    /** For an app under test that runs as a component: its `session.embedding` call. */
+    getEmbeddingFinish(): MockEmbeddingFinish | null;
 }
+
 /** Content for `emitIncomingContent`. */
 interface MockIncomingContentInput {
     acceptId?: string;
@@ -456,7 +486,13 @@ interface FakeBridgeHostController {
     /** See {@link CreateMockMindooDBAppSessionOptions.directoryUsers}. */
     setDirectoryUsers(users: readonly string[]): void;
     getDirectoryUsers(): string[];
+    /** Embeds the app has open (`session.embeds.open`). */
+    listEmbeds(): MockEmbedState[];
+    /** Closes an embed and pushes the `embed-event` to the app. */
+    closeEmbed(embedId: string, reason?: MindooDBAppEmbedCloseReason, result?: unknown): void;
+    /** For an app under test that runs as a component: its `session.embedding` call. */
+    getEmbeddingFinish(): MockEmbeddingFinish | null;
 }
 declare function createFakeBridgeHost(options?: CreateFakeBridgeHostOptions): FakeBridgeHostController;
 
-export { ALL_CAPABILITIES, type BrowserTestHost, type BrowserTestHostLog, type BrowserTestHostScan, type BrowserTestHostScanMode, type CreateBrowserTestHostOptions, type CreateFakeBridgeHostOptions, type CreateMockMindooDBAppSessionOptions, type EvaluatingViewDocument, type FakeBridgeHostController, type FakeBridgePortMessageHandler, type FakeBridgeRequestHandler, type FakeBridgeRpcResponse, type MockDatabaseOverride, type MockDatabasesFromDefinitionOptions, MockForbiddenError, type MockIncomingContentInput, type MockMindooDBAppDatabaseDefinition, type MockMindooDBAppSessionController, type MockSealedChannelOptions, type MockSeedDocument, type MountHavenTestHostOptions, TEST_HOST_LOCALES, type TestHostUrlSettings, capabilitiesForDefinitionPermissions, createBrowserTestHost, createEvaluatingViewNavigator, createFakeBridgeHost, createMemoryAttachments, createMockMindooDBAppBridge, createMockMindooDBAppSession, generateDirectoryUsers, loadMindoodbForTesting, mockDatabasesFromDefinition, mountHavenTestHost, previewJson, readTestHostUrlSettings };
+export { ALL_CAPABILITIES, type BrowserTestHost, type BrowserTestHostLog, type BrowserTestHostScan, type BrowserTestHostScanMode, type CreateBrowserTestHostOptions, type CreateFakeBridgeHostOptions, type CreateMockMindooDBAppSessionOptions, type EvaluatingViewDocument, type FakeBridgeHostController, type FakeBridgePortMessageHandler, type FakeBridgeRequestHandler, type FakeBridgeRpcResponse, type MockDatabaseOverride, type MockDatabasesFromDefinitionOptions, type MockEmbedState, type MockEmbeddingFinish, MockForbiddenError, type MockIncomingContentInput, type MockMindooDBAppDatabaseDefinition, type MockMindooDBAppSessionController, type MockSealedChannelOptions, type MockSeedDocument, type MountHavenTestHostOptions, TEST_HOST_LOCALES, type TestHostUrlSettings, capabilitiesForDefinitionPermissions, createBrowserTestHost, createEvaluatingViewNavigator, createFakeBridgeHost, createMemoryAttachments, createMockMindooDBAppBridge, createMockMindooDBAppSession, generateDirectoryUsers, loadMindoodbForTesting, mockDatabasesFromDefinition, mountHavenTestHost, previewJson, readTestHostUrlSettings };

package/dist/testing/index.js

@@ -1,9 +1,10 @@
 import {
   MINDOODB_APP_VALUE_TAG,
   assertValidMindooDBCreateIds,
+  mindooDBAppComponentFieldsMatch,
   pageUsers,
   releaseMindooDBAppBridgeSessions
-} from "../chunk-SKPP4T6S.js";
+} from "../chunk-HJUDYIPR.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
@@ -456,6 +457,172 @@ async function createEvaluatingViewNavigator(input, documents) {
   return wrapNavigator(input.definition, navigator);
 }
 
+// src/testing/mockEmbeds.ts
+function createMockEmbedHost(options, getDatabase) {
+  let components = [...options.components ?? []];
+  const embeds = /* @__PURE__ */ new Map();
+  const handles = /* @__PURE__ */ new Map();
+  const closedListeners = /* @__PURE__ */ new Set();
+  let embedCounter = 0;
+  let embeddingFinish = null;
+  function notifyChange() {
+    options.onEmbedChange?.([...embeds.values()].map((entry) => ({ ...entry, rect: { ...entry.rect } })));
+  }
+  async function openEmbed(input) {
+    const component = components.find((entry) => entry.key === input.componentKey);
+    if (!component) {
+      throw new Error(`Unknown component "${input.componentKey}".`);
+    }
+    const intent = input.intent ?? "edit";
+    if (!component.intents.includes(intent) && !(intent === "edit" && component.intents.includes("create"))) {
+      throw new Error(`Component "${component.label}" does not support "${intent}".`);
+    }
+    const document2 = await getDatabase(input.databaseId).documents.get(input.docId);
+    if (!document2) {
+      throw new Error(`Document ${input.docId} does not exist.`);
+    }
+    if (!mindooDBAppComponentFieldsMatch(component.match, document2.data)) {
+      throw new Error(`Document ${input.docId} is not a "${component.label}" document.`);
+    }
+    embedCounter += 1;
+    const embedId = `mock-embed-${embedCounter}`;
+    embeds.set(embedId, {
+      embedId,
+      component,
+      databaseId: input.databaseId,
+      docId: input.docId,
+      intent,
+      rect: { ...input.rect },
+      visible: input.visible !== false
+    });
+    notifyChange();
+    return embedId;
+  }
+  function closeEmbed(embedId, reason = "closed", result) {
+    if (!embeds.delete(embedId)) {
+      return;
+    }
+    const event = {
+      embedId,
+      reason,
+      ...result === void 0 ? {} : { result: JSON.parse(JSON.stringify(result)) }
+    };
+    handles.get(embedId)?.settle(event);
+    handles.delete(embedId);
+    closedListeners.forEach((listener) => listener(event));
+    notifyChange();
+  }
+  class MockEmbed {
+    constructor(embedId, componentKey, databaseId, docId) {
+      this.embedId = embedId;
+      this.componentKey = componentKey;
+      this.databaseId = databaseId;
+      this.docId = docId;
+      this.closed = new Promise((resolve) => {
+        this.resolve = resolve;
+      });
+    }
+    embedId;
+    componentKey;
+    databaseId;
+    docId;
+    closed;
+    resolve;
+    listeners = /* @__PURE__ */ new Set();
+    settled = null;
+    async setRect(rect) {
+      setRect(this.embedId, rect);
+    }
+    async setVisible(visible) {
+      setVisible(this.embedId, visible);
+    }
+    async close() {
+      closeEmbed(this.embedId, "closed");
+      return await this.closed;
+    }
+    onClosed(listener) {
+      if (this.settled) {
+        const event = this.settled;
+        queueMicrotask(() => listener(event));
+        return () => {
+        };
+      }
+      this.listeners.add(listener);
+      return () => {
+        this.listeners.delete(listener);
+      };
+    }
+    settle(event) {
+      this.settled = event;
+      this.resolve(event);
+      this.listeners.forEach((listener) => listener(event));
+      this.listeners.clear();
+    }
+  }
+  function setRect(embedId, rect) {
+    const entry = embeds.get(embedId);
+    if (entry) {
+      entry.rect = { ...rect };
+      notifyChange();
+    }
+  }
+  function setVisible(embedId, visible) {
+    const entry = embeds.get(embedId);
+    if (entry) {
+      entry.visible = visible;
+      notifyChange();
+    }
+  }
+  return {
+    components: {
+      async list(query) {
+        return components.filter((entry) => !query?.intent || entry.intents.includes(query.intent)).filter((entry) => !query?.document || mindooDBAppComponentFieldsMatch(entry.match, query.document)).map((entry) => structuredClone(entry));
+      }
+    },
+    embeds: {
+      async open(input) {
+        const embedId = await openEmbed(input);
+        const handle = new MockEmbed(embedId, input.componentKey, input.databaseId, input.docId);
+        handles.set(embedId, handle);
+        return handle;
+      }
+    },
+    embedding: {
+      async complete(result) {
+        embeddingFinish = {
+          reason: "completed",
+          ...result === void 0 ? {} : { result: JSON.parse(JSON.stringify(result)) }
+        };
+      },
+      async cancel(message) {
+        embeddingFinish = { reason: "cancelled", ...message ? { message } : {} };
+      }
+    },
+    openEmbed,
+    setRect,
+    setVisible,
+    closeEmbed,
+    listEmbeds() {
+      return [...embeds.values()].map((entry) => ({ ...entry, rect: { ...entry.rect } }));
+    },
+    setComponents(next) {
+      components = [...next];
+    },
+    getEmbeddingFinish() {
+      return embeddingFinish;
+    },
+    finishEmbedding(finish) {
+      embeddingFinish = finish;
+    },
+    onClosed(listener) {
+      closedListeners.add(listener);
+      return () => {
+        closedListeners.delete(listener);
+      };
+    }
+  };
+}
+
 // src/testing/capabilityGuard.ts
 var NONE = [];
 var READ = ["read"];
@@ -921,6 +1088,10 @@ var STYLE = `
 .htest{display:grid;grid-template-columns:minmax(0,1fr) 320px;height:100vh;margin:0;font:13px/1.45 system-ui,sans-serif;background:#eef1f7;color:#172033}
 .htest *{box-sizing:border-box}
 .htest__frame{width:100%;height:100%;border:0;background:#fff}
+.htest__stage{position:relative;min-width:0;height:100%;overflow:hidden}
+.htest__embed{position:absolute;display:flex;flex-direction:column;gap:8px;align-items:center;justify-content:center;border:2px dashed #6366f1;background:rgba(238,242,255,.94);color:#312e81;text-align:center;padding:12px;overflow:hidden}
+.htest__embed[hidden]{display:none}
+.htest__embed strong{font-size:14px}
 .htest__panel{border-left:1px solid #d7dce8;overflow:auto;padding:14px;background:#f8f9fc}
 .htest__badge{display:inline-block;padding:2px 8px;border-radius:999px;background:#fde68a;color:#713f12;font-weight:600;font-size:11px;letter-spacing:.04em}
 .htest h1{font-size:15px;margin:8px 0 12px}
@@ -1006,8 +1177,36 @@ function mountHavenTestHost(options) {
   frame.dataset.testid = "haven-test-app-frame";
   const panel = document.createElement("aside");
   panel.className = "htest__panel";
-  root.append(frame, panel);
+  const stage = document.createElement("div");
+  stage.className = "htest__stage";
+  const embedLayer = document.createElement("div");
+  stage.append(frame, embedLayer);
+  root.append(stage, panel);
   container.replaceChildren(root);
+  function renderEmbeds(embeds) {
+    embedLayer.replaceChildren(
+      ...embeds.map((embed) => {
+        const box = document.createElement("div");
+        box.className = "htest__embed";
+        box.dataset.testid = `haven-test-embed-${embed.embedId}`;
+        box.hidden = !embed.visible;
+        box.style.left = `${embed.rect.left}px`;
+        box.style.top = `${embed.rect.top}px`;
+        box.style.width = `${embed.rect.width}px`;
+        box.style.height = `${embed.rect.height}px`;
+        const name = document.createElement("strong");
+        name.textContent = `${embed.component.appLabel}: ${embed.component.label}`;
+        const row = document.createElement("div");
+        row.className = "htest__row";
+        row.append(
+          button("Done", () => testHost.host.closeEmbed(embed.embedId, "completed", { saved: true })),
+          button("Cancel", () => testHost.host.closeEmbed(embed.embedId, "cancelled"))
+        );
+        box.append(name, hint(`${embed.intent} \xB7 ${embed.databaseId}/${embed.docId}`), row);
+        return box;
+      })
+    );
+  }
   if (container === document.body) {
     document.body.style.margin = "0";
   }
@@ -1149,7 +1348,11 @@ function mountHavenTestHost(options) {
     enforceCapabilities: url.enforceCapabilities ?? hostOptions.enforceCapabilities,
     directoryUsers: url.directoryUserCount !== void 0 ? generateDirectoryUsers(url.directoryUserCount) : hostOptions.directoryUsers,
     frame,
-    onChange: render
+    onChange: render,
+    onEmbedChange(embeds) {
+      hostOptions.onEmbedChange?.(embeds);
+      renderEmbeds(embeds);
+    }
   });
   let currentLocale = url.locale;
   const badge = document.createElement("span");
@@ -2008,6 +2211,23 @@ function extractMockSummaryFields(data, setup) {
       });
     }
   }
+  if ((setup?.includeRecipients ?? true) && !isExcluded("_encryptFor")) {
+    const encryptFor = data._encryptFor;
+    if (encryptFor && typeof encryptFor === "object" && !Array.isArray(encryptFor)) {
+      const projected = {};
+      for (const [id, entry] of Object.entries(encryptFor)) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+        const raw = entry;
+        const info = { kind: raw.kind === "device" ? "device" : "user" };
+        if (typeof raw.label === "string") info.label = raw.label;
+        for (const key of ["addedAt", "removedAt"]) {
+          if (typeof raw[key] === "number" && Number.isFinite(raw[key])) info[key] = raw[key];
+        }
+        projected[id] = info;
+      }
+      if (Object.keys(projected).length > 0) fields._encryptFor = projected;
+    }
+  }
   return fields;
 }
 function mockSummaryDocument(data, setup) {
@@ -3289,6 +3509,13 @@ function createDatabaseHandle(definition, peers, directoryUsers = () => []) {
 }
 function createMockSessionState(options = {}) {
   let launchContext = createDefaultLaunchContext(options.launchContext);
+  const embedHost = createMockEmbedHost(options, (databaseId) => {
+    const database = databaseHandles.get(databaseId);
+    if (!database) {
+      throw new Error(`Unknown test database: ${databaseId}`);
+    }
+    return database;
+  });
   const themeListeners = /* @__PURE__ */ new Set();
   let incomingHandler = null;
   const pendingIncoming = [];
@@ -3561,6 +3788,9 @@ function createMockSessionState(options = {}) {
     },
     menus,
     drag,
+    components: embedHost.components,
+    embeds: embedHost.embeds,
+    embedding: embedHost.embedding,
     storage: {
       async snapshot(snapshotOptions) {
         const prefixes = snapshotOptions?.prefixes;
@@ -3683,6 +3913,7 @@ function createMockSessionState(options = {}) {
       directoryUsers = [...users];
     },
     getDirectoryUsers: () => [...directoryUsers],
+    embedHost,
     getDatabase(databaseId) {
       const database = databaseHandles.get(databaseId);
       if (!database) {
@@ -3816,12 +4047,17 @@ function createMockMindooDBAppSession(options = {}) {
     },
     resolveDrag: state.resolveDrag,
     getDragProfile: state.getDragProfile,
-    emitIncomingContent: state.emitIncomingContent
+    emitIncomingContent: state.emitIncomingContent,
+    listEmbeds: () => state.embedHost.listEmbeds(),
+    closeEmbed: (embedId, reason, result) => state.embedHost.closeEmbed(embedId, reason, result),
+    setComponents: (components) => state.embedHost.setComponents(components),
+    getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish()
   };
 }
 function createMockMindooDBAppBridge(options = {}) {
   return createMockMindooDBAppSession(options);
 }
+var NOT_HANDLED = /* @__PURE__ */ Symbol("not-handled");
 function createFakeBridgeHost(options = {}) {
   const state = createMockSessionState(options);
   const customRequestHandlers = new Map(
@@ -3829,6 +4065,11 @@ function createFakeBridgeHost(options = {}) {
   );
   const requests = [];
   const connectedPorts = /* @__PURE__ */ new Set();
+  state.embedHost.onClosed((event) => {
+    connectedPorts.forEach(
+      (port) => port.postMessage({ protocol: PROTOCOL, kind: "embed-event", event: { type: "closed", ...event } })
+    );
+  });
   const beforeCloseWaiters = /* @__PURE__ */ new Map();
   let beforeCloseCounter = 0;
   const viewSessions = /* @__PURE__ */ new Map();
@@ -4034,6 +4275,51 @@ function createFakeBridgeHost(options = {}) {
       case "menus.hide":
         await state.session.menus.hide();
         return { ok: true };
+      case "appStorage.snapshot":
+        return await state.session.storage.snapshot({
+          prefixes: Array.isArray(params.prefixes) ? params.prefixes.map(String) : void 0
+        });
+      case "appStorage.get":
+        return await state.session.storage.get(String(params.key));
+      case "appStorage.set":
+        await state.session.storage.set(String(params.key), String(params.value));
+        return null;
+      case "appStorage.remove":
+        await state.session.storage.remove(String(params.key));
+        return null;
+      case "appStorage.keys":
+        return await state.session.storage.keys({
+          prefix: typeof params.prefix === "string" ? params.prefix : void 0
+        });
+      case "appStorage.clear":
+        await state.session.storage.clear({
+          prefix: typeof params.prefix === "string" ? params.prefix : void 0
+        });
+        return null;
+      case "components.list":
+        return {
+          components: await state.session.components.list(
+            params.query ?? void 0
+          )
+        };
+      case "embeds.open":
+        return { embedId: await state.embedHost.openEmbed(params.input) };
+      case "embeds.setRect":
+        state.embedHost.setRect(String(params.embedId), params.rect);
+        return { ok: true };
+      case "embeds.setVisible":
+        state.embedHost.setVisible(String(params.embedId), params.visible === true);
+        return { ok: true };
+      case "embeds.close":
+        state.embedHost.closeEmbed(String(params.embedId), "closed");
+        return { ok: true };
+      case "embedding.finish":
+        state.embedHost.finishEmbedding({
+          reason: params.reason === "cancelled" ? "cancelled" : "completed",
+          ...params.result === void 0 ? {} : { result: params.result },
+          ...typeof params.message === "string" ? { message: params.message } : {}
+        });
+        return { ok: true };
       case "session.requestHostFocus":
         await state.session.requestHostFocus();
         return null;
@@ -4459,7 +4745,7 @@ function createFakeBridgeHost(options = {}) {
         return void 0;
       }
       default:
-        return void 0;
+        return NOT_HANDLED;
     }
   }
   async function handleStreamMessage(port, message) {
@@ -4581,7 +4867,7 @@ function createFakeBridgeHost(options = {}) {
           return;
         }
         const builtinResult = await handleBuiltinRequest(message);
-        if (builtinResult === void 0 && message.method !== "viewNavigators.dispose") {
+        if (builtinResult === NOT_HANDLED) {
           fail({
             code: "method-not-found",
             message: `No fake bridge handler is configured for ${message.method}.`
@@ -4638,6 +4924,9 @@ function createFakeBridgeHost(options = {}) {
     getEnforceCapabilities: state.getEnforceCapabilities,
     setDirectoryUsers: state.setDirectoryUsers,
     getDirectoryUsers: state.getDirectoryUsers,
+    listEmbeds: () => state.embedHost.listEmbeds(),
+    closeEmbed: (embedId, reason, result) => state.embedHost.closeEmbed(embedId, reason, result),
+    getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish(),
     dispose() {
       restoreWindow();
       connectedPorts.forEach((port) => {