mindoodb-app-sdk 0.0.47 → 0.0.48

package/README.md

@@ -1084,6 +1084,43 @@ if (handled) {
 }
 ```
 
+**Nested lookups (`include`)** fetch related documents alongside the matching rows — from the same database or from any other database the app is mapped to. The host resolves a slot with **one scan per slot**, not one query per row, so a list with its related records is a single round trip:
+
+```ts
+const result = await db.documents.query<{
+  customer: MindooDBAppQueryRow | null;
+  lines: MindooDBAppQueryRow[];
+}>({
+  filter: 'v.eq(v.field("type"), "invoice")',
+  fields: ["total", "customerId"],
+  include: {
+    customer: {
+      databaseId: "customers",     // another mapped database; omit for this one
+      cardinality: "one",          // → a row or null
+      localKey: "customerId",      // this row's field holds the customer's id
+      fields: ["name"],
+    },
+    lines: {
+      cardinality: "many",         // → an array (possibly empty, never null)
+      filter: 'v.eq(v.field("invoiceId"), v.parentDocId())',
+      sortBy: [{ field: "position", direction: "ascending" }],
+      limit: 50,
+    },
+  },
+});
+
+for (const row of result.rows) {
+  console.log(row.fields.total, row.includes?.customer?.fields.name);
+  console.log(row.includes?.lines.length);
+}
+```
+
+- Related documents live under `row.includes[slot]`, never as sibling keys, so a slot name can never collide with `docId` / `fields` / `lastModified`. Pass the slot types to `query<TIncludes>()` to have them typed.
+- The join condition relates the related document to the parent row: `v.parentDocId()` for the parent's id, `v.parent("<path>")` for one of its fields. `localKey` is shorthand for "this row's field holds the related document's id" (an array value joins every element). Exactly one such equality is allowed per slot — further conditions may narrow the related documents but must not mention the parent.
+- Slots nest (`row.includes.customer.includes.address`) up to three levels.
+- `databaseId` is checked like any other database parameter: the app must be mapped to it with the `read` capability, at every level. Unmapped or view-only ids are rejected with `database-not-found`, a missing capability with `forbidden`.
+- Hydration happens after sorting and paging, so only the returned rows are joined and `total` stays the unpaged match count. Per-slot `limit` is capped at 1000, and a query may carry at most 10 slots in total.
+
 **Live queries** keep a query result up to date. The callback receives the initial result and runs again whenever the result actually changed — the host coalesces bursts of writes and fingerprints results, so you only hear about real changes:
 
 ```ts
@@ -1101,7 +1138,7 @@ await subscription.refresh();
 await subscription.dispose();
 ```
 
-Live query results are pushed from the host over the bridge port — no polling. Subscriptions are cleaned up automatically when the app disconnects, but dispose them explicitly when the UI that consumes them unmounts.
+Live query results are pushed from the host over the bridge port — no polling. Subscriptions are cleaned up automatically when the app disconnects, but dispose them explicitly when the UI that consumes them unmounts. A live query with `include` also watches every related database, so a change to a joined document delivers a new result too.
 
 ### Incremental sync
 
@@ -1638,8 +1675,8 @@ Host-kept key/value state, the only durable storage a hosted app has. See [Stora
 
 | Method                             | Returns                                      |
 | ---------------------------------- | -------------------------------------------- |
-| `query(query?)`                    | `Promise<MindooDBAppQueryResult>`            |
-| `liveQuery(query, onResult)`       | `Promise<MindooDBAppLiveQuerySubscription>`  |
+| `query<TIncludes>(query?)`         | `Promise<MindooDBAppQueryResult<TIncludes>>` |
+| `liveQuery<TIncludes>(query, onResult)` | `Promise<MindooDBAppLiveQuerySubscription>` |
 | `list(query?)`                     | `Promise<MindooDBAppDocumentListResult>`     |
 | `listInaccessible(query?)`         | `Promise<MindooDBAppInaccessibleDocumentListResult>` |
 | `get(docId)`                       | `Promise<MindooDBAppDocument \| null>`       |

package/TESTING.md

@@ -183,6 +183,41 @@ await db.documents.create({ set: { type: "invoice", total: 50 } });
 await sub.dispose();
 ```
 
+Nested lookups (`include`) work too, including slots that name another mocked
+database by its id, and they mirror the host's rules — one parent equality per
+slot, `cardinality: "one"` failing loudly when several documents match, per-slot
+`sortBy`/`limit`, and nesting. A write to a joined database re-fires the live
+queries that join it, so cross-database joins can be tested end to end:
+
+```ts
+const mock = createMockMindooDBAppBridge({
+  databases: [
+    {
+      info: { id: "billing", title: "Billing", capabilities: ["read", "create"] },
+      documents: [{ id: "inv_1", data: { type: "invoice", customerId: "cust_1" } }],
+    },
+    {
+      info: { id: "customers", title: "Customers", capabilities: ["read"] },
+      documents: [{ id: "cust_1", data: { name: "Acme" } }],
+    },
+  ],
+});
+
+const session = await mock.bridge.connect();
+const billing = await session.openDatabase("billing");
+
+const result = await billing.documents.query<{ customer: MindooDBAppQueryRow | null }>({
+  filter: 'v.eq(v.field("type"), "invoice")',
+  include: {
+    customer: { databaseId: "customers", cardinality: "one", localKey: "customerId" },
+  },
+});
+expect(result.rows[0].includes?.customer?.fields.name).toBe("Acme");
+```
+
+An include slot naming a database that was not seeded fails, the same way Haven
+rejects a database the app is not mapped to.
+
 ## Level 2 example
 
 This pattern keeps the real `createMindooDBAppBridge()` code path and replaces only the host side.

package/dist/{chunk-D662SK2G.js → chunk-TPYDERAK.js}

@@ -658,14 +658,28 @@ function normalizeDocumentQuery(query) {
   if (!query) {
     return {};
   }
-  const { filter, ...rest } = query;
+  const { filter, include, ...rest } = query;
   return {
     ...rest,
-    ...filter !== void 0 ? {
-      filter: typeof filter === "string" ? parseMindooDBFormulaBooleanExpression(filter) : filter
-    } : {}
+    ...filter !== void 0 ? { filter: normalizeQueryFilter(filter) } : {},
+    ...include !== void 0 ? { include: normalizeQueryIncludes(include) } : {}
   };
 }
+function normalizeQueryFilter(filter) {
+  return typeof filter === "string" ? parseMindooDBFormulaBooleanExpression(filter) : filter;
+}
+function normalizeQueryIncludes(includes) {
+  const normalized = {};
+  for (const [slot, include] of Object.entries(includes)) {
+    const { filter, include: nested, ...rest } = include;
+    normalized[slot] = {
+      ...rest,
+      ...filter !== void 0 ? { filter: normalizeQueryFilter(filter) } : {},
+      ...nested !== void 0 ? { include: normalizeQueryIncludes(nested) } : {}
+    };
+  }
+  return normalized;
+}
 function isThemeChangedMessage(message) {
   return message.kind === "theme-changed";
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppHostShortcutBinding, g as MindooDBAppHostShortcutAction, h as MindooDBAppHostingMode, i as MindooDBAppDatabase, j as MindooDBAppDocument, k as MindooDBAppRichTextSpan, l as MindooDBAppRichTextSnapshot } from './types-C2WDj-Tv.js';
-export { m as MINDOODB_APP_DEFINITION_FILE_NAME, n as MINDOODB_APP_DEFINITION_FORMAT, o as MINDOODB_APP_DEFINITION_PERMISSIONS, p as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, q as MINDOODB_APP_DEFINITION_VERSION, r as MINDOODB_APP_SEAL_SIGNING_DOMAIN, s as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, t as MindooDBAppAccessDecision, u as MindooDBAppAccessTier, v as MindooDBAppAttachmentApi, w as MindooDBAppAttachmentChunk, x as MindooDBAppAttachmentInfo, y as MindooDBAppAttachmentPreviewOptions, z as MindooDBAppAttachmentPreviewSession, A as MindooDBAppAutomergeChangesPatch, B as MindooDBAppAutomergeChangesSince, C as MindooDBAppAutomergeGetOptions, D as MindooDBAppAutomergePatchResult, E as MindooDBAppAutomergeSnapshot, F as MindooDBAppBridgeBeforeCloseAck, G as MindooDBAppBridgeBeforeCloseMessage, H as MindooDBAppBridgeConnectMessage, I as MindooDBAppBridgeConnectOptions, J as MindooDBAppBridgeConnectedMessage, K as MindooDBAppBridgeDragDropMessage, L as MindooDBAppBridgeDragLeaveMessage, N as MindooDBAppBridgeDragOverMessage, O as MindooDBAppBridgeErrorPayload, P as MindooDBAppBridgeHandshakeErrorMessage, Q as MindooDBAppBridgeLocaleChangedMessage, R as MindooDBAppBridgePortMessage, S as MindooDBAppBridgeQueryResultMessage, T as MindooDBAppBridgeRpcError, U as MindooDBAppBridgeRpcMessage, V as MindooDBAppBridgeRpcRequest, W as MindooDBAppBridgeRpcSuccess, X as MindooDBAppBridgeShortcutInvokedMessage, Y as MindooDBAppBridgeShortcutsChangedMessage, Z as MindooDBAppBridgeStreamAbortRequest, _ as MindooDBAppBridgeStreamAck, $ as MindooDBAppBridgeStreamCloseRequest, a0 as MindooDBAppBridgeStreamError, a1 as MindooDBAppBridgeStreamMessage, a2 as MindooDBAppBridgeStreamOpenResult, a3 as MindooDBAppBridgeStreamReadRequest, a4 as MindooDBAppBridgeStreamWriteRequest, a5 as MindooDBAppBridgeThemeChangedMessage, a6 as MindooDBAppBridgeUiPreferencesChangedMessage, a7 as MindooDBAppBridgeViewChangedMessage, a8 as MindooDBAppBridgeViewportChangedMessage, a9 as MindooDBAppCapability, aa as MindooDBAppConfiguredViewCategorizationStyle, ab as MindooDBAppConfiguredViewColumn, ac as MindooDBAppConfiguredViewColumnRole, ad as MindooDBAppConfiguredViewExpressionMode, ae as MindooDBAppConfiguredViewFieldExpression, af as MindooDBAppConfiguredViewFilterDefinition, ag as MindooDBAppConfiguredViewFilterMode, ah as MindooDBAppConfiguredViewFilterRule, ai as MindooDBAppConfiguredViewFormulaExpression, aj as MindooDBAppConfiguredViewFormulaFilterDefinition, ak as MindooDBAppConfiguredViewPreviewMode, al as MindooDBAppConfiguredViewRuleFilterDefinition, am as MindooDBAppConfiguredViewRuleMatchMode, an as MindooDBAppConfiguredViewRuleOperator, ao as MindooDBAppConfiguredViewValueExpression, ap as MindooDBAppCreateDocumentInput, aq as MindooDBAppCreateKeyInfo, ar as MindooDBAppCreateViewInput, as as MindooDBAppCreateViewNavigatorInput, at as MindooDBAppDatabaseInfo, au as MindooDBAppDefinition, av as MindooDBAppDefinitionDatabase, aw as MindooDBAppDefinitionPermission, ax as MindooDBAppDefinitionRegistrationPermission, ay as MindooDBAppDefinitionValidation, az as MindooDBAppDirectoryApi, aA as MindooDBAppDirectoryEntry, aB as MindooDBAppDocumentApi, aC as MindooDBAppDocumentHeadCursorResult, aD as MindooDBAppDocumentHistoryEntry, aE as MindooDBAppDocumentListQuery, aF as MindooDBAppDocumentListResult, aG as MindooDBAppDocumentQuery, aH as MindooDBAppDocumentRevisionId, aI as MindooDBAppDocumentScanPreset, aJ as MindooDBAppDocumentSummary, aK as MindooDBAppDragApi, aL as MindooDBAppDragCancelReason, aM as MindooDBAppDragDropEvent, aN as MindooDBAppDragEffect, aO as MindooDBAppDragHoverResult, aP as MindooDBAppDragOffer, aQ as MindooDBAppDragOverEvent, aR as MindooDBAppDragPointer, aS as MindooDBAppDragProfile, aT as MindooDBAppEntryAttachmentRef, aU as MindooDBAppEntryProvenance, aV as MindooDBAppExtractDocumentTextInput, aW as MindooDBAppExtractDocumentTextResult, aX as MindooDBAppExtractTextFormat, aY as MindooDBAppExtractionSetup, aZ as MindooDBAppFulltextSetup, a_ as MindooDBAppHistoricalDocument, a$ as MindooDBAppHistoryQuery, b0 as MindooDBAppHostTheme, b1 as MindooDBAppIdentityApi, b2 as MindooDBAppInaccessibleDocument, b3 as MindooDBAppInaccessibleDocumentListQuery, b4 as MindooDBAppInaccessibleDocumentListResult, b5 as MindooDBAppJsonListDeletePatch, b6 as MindooDBAppJsonListInsertPatch, b7 as MindooDBAppJsonPatch, b8 as MindooDBAppJsonSetPatch, b9 as MindooDBAppJsonTextMarkPatch, ba as MindooDBAppJsonTextSplicePatch, bb as MindooDBAppJsonTextUnmarkPatch, bc as MindooDBAppJsonUnsetPatch, bd as MindooDBAppLaunchContext, be as MindooDBAppLiveQuerySubscription, bf as MindooDBAppMenuAnchor, bg as MindooDBAppMenuApi, bh as MindooDBAppMenuCommandItem, bi as MindooDBAppMenuDismissReason, bj as MindooDBAppMenuDismissedResult, bk as MindooDBAppMenuItem, bl as MindooDBAppMenuKind, bm as MindooDBAppMenuPlacement, bn as MindooDBAppMenuPointAnchor, bo as MindooDBAppMenuRect, bp as MindooDBAppMenuRectAnchor, bq as MindooDBAppMenuSelectionResult, br as MindooDBAppMenuSeparatorItem, bs as MindooDBAppProposeAppInput, bt as MindooDBAppProposeAppResult, bu as MindooDBAppQueryCoverage, bv as MindooDBAppQueryResult, bw as MindooDBAppQueryRow, bx as MindooDBAppQuerySortKey, by as MindooDBAppQueryTextClause, bz as MindooDBAppReadableAttachmentStream, bA as MindooDBAppRecipientOptions, bB as MindooDBAppResolvedViewDefinition, bC as MindooDBAppResolvedViewSource, bD as MindooDBAppRevisionPhase, bE as MindooDBAppRevisionVerification, bF as MindooDBAppRichTextBlockSpan, bG as MindooDBAppRichTextGetOptions, bH as MindooDBAppRichTextImmutableString, bI as MindooDBAppRichTextMarkRange, bJ as MindooDBAppRichTextMaterializeValue, bK as MindooDBAppRichTextPatch, bL as MindooDBAppRichTextScalar, bM as MindooDBAppRichTextSpliceStep, bN as MindooDBAppRichTextStep, bO as MindooDBAppRichTextStepPatch, bP as MindooDBAppRichTextTextSpan, bQ as MindooDBAppRuntime, bR as MindooDBAppScanAttachmentOptions, bS as MindooDBAppScanAttachmentResult, bT as MindooDBAppScopedDocId, bU as MindooDBAppScopedDocumentSummary, bV as MindooDBAppSealIntent, bW as MindooDBAppSealedChannelOpenInput, bX as MindooDBAppSealedChannelOpenResult, bY as MindooDBAppSealedChannelRequestInput, bZ as MindooDBAppSession, b_ as MindooDBAppShowMenuInput, b$ as MindooDBAppShowMenuResult, c0 as MindooDBAppSignPreview, c1 as MindooDBAppSignPreviewScope, c2 as MindooDBAppSignStatementInput, c3 as MindooDBAppSignStatementResult, c4 as MindooDBAppStorageApi, c5 as MindooDBAppTextEdit, c6 as MindooDBAppTextPatch, c7 as MindooDBAppThemeMode, c8 as MindooDBAppTimestampApi, c9 as MindooDBAppTimestampInput, ca as MindooDBAppTimestampProvider, cb as MindooDBAppTimestampResult, cc as MindooDBAppUiPreferences, cd as MindooDBAppUpdateDocumentInput, ce as MindooDBAppViewCursorDocumentListResult, cf as MindooDBAppViewCursorResult, cg as MindooDBAppViewEntry, ch as MindooDBAppViewEntryKind, ci as MindooDBAppViewNavigator, cj as MindooDBAppViewNavigatorExpansionState, ck as MindooDBAppViewNavigatorOpenOptions, cl as MindooDBAppViewNavigatorPageOptions, cm as MindooDBAppViewNavigatorPageResult, cn as MindooDBAppViewNavigatorRangeQuery, co as MindooDBAppViewNavigatorSelectionState, cp as MindooDBAppViewUpdateStats, cq as MindooDBAppViewport, cr as MindooDBAppWellKnownDragType, cs as MindooDBAppWritableAttachmentStream, ct as resolveMindooDBAppDefinitionUrl, cu as validateMindooDBAppDefinition } from './types-C2WDj-Tv.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppHostShortcutBinding, g as MindooDBAppHostShortcutAction, h as MindooDBAppHostingMode, i as MindooDBAppDatabase, j as MindooDBAppDocument, k as MindooDBAppRichTextSpan, l as MindooDBAppRichTextSnapshot } from './types-C-eyC839.js';
+export { m as MINDOODB_APP_DEFINITION_FILE_NAME, n as MINDOODB_APP_DEFINITION_FORMAT, o as MINDOODB_APP_DEFINITION_PERMISSIONS, p as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, q as MINDOODB_APP_DEFINITION_VERSION, r as MINDOODB_APP_SEAL_SIGNING_DOMAIN, s as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, t as MindooDBAppAccessDecision, u as MindooDBAppAccessTier, v as MindooDBAppAttachmentApi, w as MindooDBAppAttachmentChunk, x as MindooDBAppAttachmentInfo, y as MindooDBAppAttachmentPreviewOptions, z as MindooDBAppAttachmentPreviewSession, A as MindooDBAppAutomergeChangesPatch, B as MindooDBAppAutomergeChangesSince, C as MindooDBAppAutomergeGetOptions, D as MindooDBAppAutomergePatchResult, E as MindooDBAppAutomergeSnapshot, F as MindooDBAppBridgeBeforeCloseAck, G as MindooDBAppBridgeBeforeCloseMessage, H as MindooDBAppBridgeConnectMessage, I as MindooDBAppBridgeConnectOptions, J as MindooDBAppBridgeConnectedMessage, K as MindooDBAppBridgeDragDropMessage, L as MindooDBAppBridgeDragLeaveMessage, N as MindooDBAppBridgeDragOverMessage, O as MindooDBAppBridgeErrorPayload, P as MindooDBAppBridgeHandshakeErrorMessage, Q as MindooDBAppBridgeLocaleChangedMessage, R as MindooDBAppBridgePortMessage, S as MindooDBAppBridgeQueryResultMessage, T as MindooDBAppBridgeRpcError, U as MindooDBAppBridgeRpcMessage, V as MindooDBAppBridgeRpcRequest, W as MindooDBAppBridgeRpcSuccess, X as MindooDBAppBridgeShortcutInvokedMessage, Y as MindooDBAppBridgeShortcutsChangedMessage, Z as MindooDBAppBridgeStreamAbortRequest, _ as MindooDBAppBridgeStreamAck, $ as MindooDBAppBridgeStreamCloseRequest, a0 as MindooDBAppBridgeStreamError, a1 as MindooDBAppBridgeStreamMessage, a2 as MindooDBAppBridgeStreamOpenResult, a3 as MindooDBAppBridgeStreamReadRequest, a4 as MindooDBAppBridgeStreamWriteRequest, a5 as MindooDBAppBridgeThemeChangedMessage, a6 as MindooDBAppBridgeUiPreferencesChangedMessage, a7 as MindooDBAppBridgeViewChangedMessage, a8 as MindooDBAppBridgeViewportChangedMessage, a9 as MindooDBAppCapability, aa as MindooDBAppConfiguredViewCategorizationStyle, ab as MindooDBAppConfiguredViewColumn, ac as MindooDBAppConfiguredViewColumnRole, ad as MindooDBAppConfiguredViewExpressionMode, ae as MindooDBAppConfiguredViewFieldExpression, af as MindooDBAppConfiguredViewFilterDefinition, ag as MindooDBAppConfiguredViewFilterMode, ah as MindooDBAppConfiguredViewFilterRule, ai as MindooDBAppConfiguredViewFormulaExpression, aj as MindooDBAppConfiguredViewFormulaFilterDefinition, ak as MindooDBAppConfiguredViewPreviewMode, al as MindooDBAppConfiguredViewRuleFilterDefinition, am as MindooDBAppConfiguredViewRuleMatchMode, an as MindooDBAppConfiguredViewRuleOperator, ao as MindooDBAppConfiguredViewValueExpression, ap as MindooDBAppCreateDocumentInput, aq as MindooDBAppCreateKeyInfo, ar as MindooDBAppCreateViewInput, as as MindooDBAppCreateViewNavigatorInput, at as MindooDBAppDatabaseInfo, au as MindooDBAppDefinition, av as MindooDBAppDefinitionDatabase, aw as MindooDBAppDefinitionPermission, ax as MindooDBAppDefinitionRegistrationPermission, ay as MindooDBAppDefinitionValidation, az as MindooDBAppDirectoryApi, aA as MindooDBAppDirectoryEntry, aB as MindooDBAppDocumentApi, aC as MindooDBAppDocumentHeadCursorResult, aD as MindooDBAppDocumentHistoryEntry, aE as MindooDBAppDocumentListQuery, aF as MindooDBAppDocumentListResult, aG as MindooDBAppDocumentQuery, aH as MindooDBAppDocumentRevisionId, aI as MindooDBAppDocumentScanPreset, aJ as MindooDBAppDocumentSummary, aK as MindooDBAppDragApi, aL as MindooDBAppDragCancelReason, aM as MindooDBAppDragDropEvent, aN as MindooDBAppDragEffect, aO as MindooDBAppDragHoverResult, aP as MindooDBAppDragOffer, aQ as MindooDBAppDragOverEvent, aR as MindooDBAppDragPointer, aS as MindooDBAppDragProfile, aT as MindooDBAppEntryAttachmentRef, aU as MindooDBAppEntryProvenance, aV as MindooDBAppExtractDocumentTextInput, aW as MindooDBAppExtractDocumentTextResult, aX as MindooDBAppExtractTextFormat, aY as MindooDBAppExtractionSetup, aZ as MindooDBAppFulltextSetup, a_ as MindooDBAppHistoricalDocument, a$ as MindooDBAppHistoryQuery, b0 as MindooDBAppHostTheme, b1 as MindooDBAppIdentityApi, b2 as MindooDBAppInaccessibleDocument, b3 as MindooDBAppInaccessibleDocumentListQuery, b4 as MindooDBAppInaccessibleDocumentListResult, b5 as MindooDBAppJsonListDeletePatch, b6 as MindooDBAppJsonListInsertPatch, b7 as MindooDBAppJsonPatch, b8 as MindooDBAppJsonSetPatch, b9 as MindooDBAppJsonTextMarkPatch, ba as MindooDBAppJsonTextSplicePatch, bb as MindooDBAppJsonTextUnmarkPatch, bc as MindooDBAppJsonUnsetPatch, bd as MindooDBAppLaunchContext, be as MindooDBAppLiveQuerySubscription, bf as MindooDBAppMenuAnchor, bg as MindooDBAppMenuApi, bh as MindooDBAppMenuCommandItem, bi as MindooDBAppMenuDismissReason, bj as MindooDBAppMenuDismissedResult, bk as MindooDBAppMenuItem, bl as MindooDBAppMenuKind, bm as MindooDBAppMenuPlacement, bn as MindooDBAppMenuPointAnchor, bo as MindooDBAppMenuRect, bp as MindooDBAppMenuRectAnchor, bq as MindooDBAppMenuSelectionResult, br as MindooDBAppMenuSeparatorItem, bs as MindooDBAppProposeAppInput, bt as MindooDBAppProposeAppResult, bu as MindooDBAppQueryCoverage, bv as MindooDBAppQueryInclude, bw as MindooDBAppQueryIncludeCardinality, bx as MindooDBAppQueryIncludeSlots, by as MindooDBAppQueryResult, bz as MindooDBAppQueryRow, bA as MindooDBAppQuerySortKey, bB as MindooDBAppQueryTextClause, bC as MindooDBAppReadableAttachmentStream, bD as MindooDBAppRecipientOptions, bE as MindooDBAppResolvedViewDefinition, bF as MindooDBAppResolvedViewSource, bG as MindooDBAppRevisionPhase, bH as MindooDBAppRevisionVerification, bI as MindooDBAppRichTextBlockSpan, bJ as MindooDBAppRichTextGetOptions, bK as MindooDBAppRichTextImmutableString, bL as MindooDBAppRichTextMarkRange, bM as MindooDBAppRichTextMaterializeValue, bN as MindooDBAppRichTextPatch, bO as MindooDBAppRichTextScalar, bP as MindooDBAppRichTextSpliceStep, bQ as MindooDBAppRichTextStep, bR as MindooDBAppRichTextStepPatch, bS as MindooDBAppRichTextTextSpan, bT as MindooDBAppRuntime, bU as MindooDBAppScanAttachmentOptions, bV as MindooDBAppScanAttachmentResult, bW as MindooDBAppScopedDocId, bX as MindooDBAppScopedDocumentSummary, bY as MindooDBAppSealIntent, bZ as MindooDBAppSealedChannelOpenInput, b_ as MindooDBAppSealedChannelOpenResult, b$ as MindooDBAppSealedChannelRequestInput, c0 as MindooDBAppSession, c1 as MindooDBAppShowMenuInput, c2 as MindooDBAppShowMenuResult, c3 as MindooDBAppSignPreview, c4 as MindooDBAppSignPreviewScope, c5 as MindooDBAppSignStatementInput, c6 as MindooDBAppSignStatementResult, c7 as MindooDBAppStorageApi, c8 as MindooDBAppTextEdit, c9 as MindooDBAppTextPatch, ca as MindooDBAppThemeMode, cb as MindooDBAppTimestampApi, cc as MindooDBAppTimestampInput, cd as MindooDBAppTimestampProvider, ce as MindooDBAppTimestampResult, cf as MindooDBAppUiPreferences, cg as MindooDBAppUpdateDocumentInput, ch as MindooDBAppViewCursorDocumentListResult, ci as MindooDBAppViewCursorResult, cj as MindooDBAppViewEntry, ck as MindooDBAppViewEntryKind, cl as MindooDBAppViewNavigator, cm as MindooDBAppViewNavigatorExpansionState, cn as MindooDBAppViewNavigatorOpenOptions, co as MindooDBAppViewNavigatorPageOptions, cp as MindooDBAppViewNavigatorPageResult, cq as MindooDBAppViewNavigatorRangeQuery, cr as MindooDBAppViewNavigatorSelectionState, cs as MindooDBAppViewUpdateStats, ct as MindooDBAppViewport, cu as MindooDBAppWellKnownDragType, cv as MindooDBAppWritableAttachmentStream, cw as resolveMindooDBAppDefinitionUrl, cx as validateMindooDBAppDefinition } from './types-C-eyC839.js';
 export { M as MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME, a as MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME, b as MINDOODB_APP_BUNDLE_MANIFEST_FORMAT, c as MINDOODB_APP_BUNDLE_MANIFEST_VERSION, d as MindooDBAppBundleArchive, e as MindooDBAppBundleFileEntry, f as MindooDBAppBundleHash, g as MindooDBAppBundleManifest, h as MindooDBAppBundleManifestValidation, i as buildMindooDBAppBundleContentHashInput, j as isMindooDBAppBundleHash, n as normalizeMindooDBAppBundlePath, v as validateMindooDBAppBundleManifest } from './appBundleManifest-B0xfpaXG.js';
 import { MindooDBAppBooleanExpression } from 'mindoodb-view-language';
 export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterDefinition, MindooDBAppViewCategoryChildrenPageRequest, MindooDBAppViewColumn, MindooDBAppViewColumnRole, MindooDBAppViewDefinition, MindooDBAppViewExpansionState, MindooDBAppViewExpressionBase, MindooDBAppViewExpressionDatePart, MindooDBAppViewExpressionOperation, MindooDBAppViewFieldExpression, MindooDBAppViewIfExpression, MindooDBAppViewLetExpression, MindooDBAppViewLiteralExpression, MindooDBAppViewLookupByPath, MindooDBAppViewOperationExpression, MindooDBAppViewOriginExpression, MindooDBAppViewPageRequest, MindooDBAppViewPageResult, MindooDBAppViewRow, MindooDBAppViewSortDirection, MindooDBAppViewTotalMode, MindooDBAppViewValueExpressionRef, MindooDBAppViewVariableExpression, createViewLanguage } from 'mindoodb-view-language';

package/dist/index.js

@@ -21,7 +21,7 @@ import {
   releaseMindooDBAppBridgeSessions,
   sanitizeHostShortcutBindings,
   snapshotElementToPng
-} from "./chunk-D662SK2G.js";
+} from "./chunk-TPYDERAK.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { as as MindooDBAppCreateViewNavigatorInput, ci as MindooDBAppViewNavigator, bd as MindooDBAppLaunchContext, at as MindooDBAppDatabaseInfo, aB as MindooDBAppDocumentApi, ck as MindooDBAppViewNavigatorOpenOptions, v as MindooDBAppAttachmentApi, b1 as MindooDBAppIdentityApi, c8 as MindooDBAppTimestampApi, az as MindooDBAppDirectoryApi, j as MindooDBAppDocument, aZ as MindooDBAppFulltextSetup, aY as MindooDBAppExtractionSetup, bs as MindooDBAppProposeAppInput, bt as MindooDBAppProposeAppResult, e as MindooDBAppBridge, bZ as MindooDBAppSession, V as MindooDBAppBridgeRpcRequest, b0 as MindooDBAppHostTheme, cq as MindooDBAppViewport, cc as MindooDBAppUiPreferences, bv as MindooDBAppQueryResult, cp as MindooDBAppViewUpdateStats, R as MindooDBAppBridgePortMessage, c as MindooDBAppDragStartResult, aS as MindooDBAppDragProfile } from '../types-C2WDj-Tv.js';
+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 * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 

package/dist/testing/index.js

@@ -1,11 +1,12 @@
 import {
   releaseMindooDBAppBridgeSessions
-} from "../chunk-D662SK2G.js";
+} from "../chunk-TPYDERAK.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
 import {
   evaluateExpression as evaluateExpression2,
+  formatMindooDBFormulaExpression,
   parseMindooDBFormulaBooleanExpression
 } from "mindoodb-view-language";
 
@@ -27,14 +28,16 @@ function toFormulaBoolean(value) {
   }
   return Boolean(value);
 }
-function matchesFilter(mindoodb, definition, doc, origin, createdAt, lastModifiedAt, witnessed, awaitingWitness) {
+function matchesFilter(mindoodb, definition, document) {
   void mindoodb;
   if (!definition.filter) return true;
+  const { data: doc, origin, docId, createdAt, lastModifiedAt, witnessed, awaitingWitness } = document;
   return toFormulaBoolean(
     evaluateExpression(definition.filter.expression, {
       doc,
       values: doc,
       origin,
+      docId,
       createdAt,
       lastModifiedAt,
       witnessed,
@@ -43,7 +46,8 @@ function matchesFilter(mindoodb, definition, doc, origin, createdAt, lastModifie
     })
   );
 }
-function computeColumnValues(definition, doc, origin, createdAt, lastModifiedAt, witnessed, awaitingWitness) {
+function computeColumnValues(definition, document) {
+  const { data: doc, origin, docId, createdAt, lastModifiedAt, witnessed, awaitingWitness } = document;
   const values = {};
   for (const [key, value] of Object.entries(doc)) {
     if (!key.startsWith("_")) values[key] = value;
@@ -54,6 +58,7 @@ function computeColumnValues(definition, doc, origin, createdAt, lastModifiedAt,
       doc,
       values,
       origin,
+      docId,
       createdAt,
       lastModifiedAt,
       witnessed,
@@ -167,31 +172,11 @@ async function buildVirtualView(mindoodb, definition, documents, categorizationS
   const view = await builder.build();
   const changes = /* @__PURE__ */ new Map();
   for (const document of documents) {
-    if (!matchesFilter(
-      mindoodb,
-      definition,
-      document.data,
-      document.origin,
-      document.createdAt,
-      document.lastModifiedAt,
-      document.witnessed,
-      document.awaitingWitness
-    )) {
+    if (!matchesFilter(mindoodb, definition, document)) {
       continue;
     }
     const change = changes.get(document.origin) ?? new mindoodb.VirtualViewDataChange(document.origin);
-    change.addEntry(
-      document.docId,
-      computeColumnValues(
-        definition,
-        document.data,
-        document.origin,
-        document.createdAt,
-        document.lastModifiedAt,
-        document.witnessed,
-        document.awaitingWitness
-      )
-    );
+    change.addEntry(document.docId, computeColumnValues(definition, document));
     changes.set(document.origin, change);
   }
   for (const change of changes.values()) {
@@ -951,7 +936,7 @@ function computeMockTextScore(document, clause) {
   const matches = combineWith === "AND" ? matchedTerms === terms.length : matchedTerms > 0;
   return matches ? score : void 0;
 }
-function runMockDocumentQuery(storedDocuments, databaseId, query) {
+function runMockDocumentQuery(storedDocuments, databaseId, query, resolveDatabase) {
   const filter = typeof query?.filter === "string" ? parseMindooDBFormulaBooleanExpression(query.filter) : query?.filter;
   const sortBy = query?.sortBy && query.sortBy.length > 0 ? query.sortBy : query?.text ? [{ special: "textScore", direction: "descending" }] : [];
   const matches = [];
@@ -970,6 +955,7 @@ function runMockDocumentQuery(storedDocuments, databaseId, query) {
       doc: document.data,
       values: {},
       origin: databaseId,
+      docId: document.id,
       variables: {}
     };
     if (filter && !mockExpressionToBoolean(evaluateExpression2(filter, context))) {
@@ -1001,19 +987,343 @@ function runMockDocumentQuery(storedDocuments, databaseId, query) {
   }
   const offset = Math.max(0, query?.offset ?? 0);
   const limit = Math.max(1, query?.limit ?? 200);
-  const rows = matches.slice(offset, offset + limit).map(({ document, textScore }) => ({
+  const page = matches.slice(offset, offset + limit);
+  const rows = page.map(({ document, textScore }) => ({
     docId: document.id,
-    fields: query?.fields ? Object.fromEntries(
-      query.fields.map((field) => [
-        field,
-        getFieldValue2(document.data, field)
-      ])
-    ) : structuredClone(document.data),
-    lastModified: document.updatedAt ? Date.parse(document.updatedAt) || 0 : 0,
+    fields: projectMockFields(document.data, query?.fields),
+    lastModified: mockLastModified(document),
     ...textScore === void 0 ? {} : { textScore }
   }));
+  if (query?.include) {
+    hydrateMockIncludes({
+      includes: query.include,
+      parents: page.map(({ document }, index) => ({
+        row: rows[index],
+        docId: document.id,
+        data: document.data
+      })),
+      parentDatabaseId: databaseId,
+      parentDocuments: storedDocuments,
+      resolveDatabase,
+      depth: 1,
+      slotPath: ""
+    });
+  }
   return { rows, total: matches.length, coverage: "full" };
 }
+function projectMockFields(data, fields) {
+  return fields ? Object.fromEntries(fields.map((field) => [field, getFieldValue2(data, field)])) : structuredClone(data);
+}
+function mockLastModified(document) {
+  return document.updatedAt ? Date.parse(document.updatedAt) || 0 : 0;
+}
+var MOCK_MAX_INCLUDE_DEPTH = 3;
+var MOCK_DEFAULT_INCLUDE_LIMIT = 200;
+function mockIncludeFilter(include) {
+  return typeof include.filter === "string" ? parseMindooDBFormulaBooleanExpression(include.filter) : include.filter;
+}
+function flattenMockConjuncts(expression) {
+  return expression.kind === "operation" && expression.op === "and" ? expression.args.flatMap((arg) => flattenMockConjuncts(arg)) : [expression];
+}
+function mockReferencesParent(expression) {
+  if (expression.kind === "parent") {
+    return true;
+  }
+  if (expression.kind === "operation") {
+    return expression.op === "parentDocId" || expression.args.some((arg) => mockReferencesParent(arg));
+  }
+  if (expression.kind === "if") {
+    return [expression.condition, expression.whenTrue, expression.whenFalse].some(
+      (part) => mockReferencesParent(part)
+    );
+  }
+  if (expression.kind === "let") {
+    return Object.values(expression.bindings).some((value) => mockReferencesParent(value)) || mockReferencesParent(expression.result);
+  }
+  return false;
+}
+function mockChildJoinSide(expression) {
+  if (expression.kind === "field") {
+    return { kind: "field", path: expression.path };
+  }
+  if (expression.kind === "operation" && expression.op === "docId") {
+    return { kind: "docId" };
+  }
+  return null;
+}
+function mockParentJoinSide(expression) {
+  if (expression.kind === "parent") {
+    return { kind: "field", path: expression.path };
+  }
+  if (expression.kind === "operation" && expression.op === "parentDocId") {
+    return { kind: "docId" };
+  }
+  return null;
+}
+function combineMockConjuncts(conjuncts) {
+  if (conjuncts.length === 0) {
+    return null;
+  }
+  if (conjuncts.length === 1) {
+    return conjuncts[0];
+  }
+  return {
+    kind: "operation",
+    op: "and",
+    args: conjuncts
+  };
+}
+function planMockInclude(label, include, filter) {
+  if (include.localKey !== void 0) {
+    if (filter && mockReferencesParent(filter)) {
+      throw new Error(
+        `Include "${label}" combines localKey with a filter that also references the parent document. Use either localKey or a parent join condition, not both.`
+      );
+    }
+    return {
+      child: { kind: "docId" },
+      parent: { kind: "field", path: include.localKey },
+      residualFilter: filter ?? null
+    };
+  }
+  const conjuncts = flattenMockConjuncts(filter);
+  const parentConjuncts = conjuncts.filter((conjunct) => mockReferencesParent(conjunct));
+  const parentFree = conjuncts.filter((conjunct) => !mockReferencesParent(conjunct));
+  if (parentConjuncts.length === 0) {
+    throw new Error(
+      `Include "${label}" cannot be joined because it does not reference the parent document. Add the join condition v.eq(v.field("<child field>"), v.parentDocId()) (or use localKey).`
+    );
+  }
+  if (parentConjuncts.length > 1) {
+    throw new Error(
+      `Include "${label}" cannot be joined because it references the parent document in ${parentConjuncts.length} separate conditions. Exactly one parent equality can be used as the join key.`
+    );
+  }
+  const join = parentConjuncts[0];
+  if (join.kind !== "operation" || join.op !== "eq" || join.args.length !== 2) {
+    throw new Error(
+      `Include "${label}" cannot be joined because the condition referencing the parent is not an equality: ${formatMindooDBFormulaExpression(join)}. Only v.eq(v.field("<child field>"), v.parentDocId()) and friends can be used as the join key.`
+    );
+  }
+  const [left, right] = join.args;
+  const sides = mockJoinSides(left, right) ?? mockJoinSides(right, left) ?? null;
+  if (!sides) {
+    throw new Error(
+      `Include "${label}" cannot be joined because the join equality compares ${formatMindooDBFormulaExpression(join)}. One side must read the related document (v.field(...) or v.docId()), the other the parent (v.parent(...) or v.parentDocId()).`
+    );
+  }
+  return { ...sides, residualFilter: combineMockConjuncts(parentFree) };
+}
+function mockJoinSides(childCandidate, parentCandidate) {
+  const child = mockChildJoinSide(childCandidate);
+  const parent = mockParentJoinSide(parentCandidate);
+  return child && parent ? { child, parent } : null;
+}
+function mockJoinValues(value) {
+  if (value === void 0 || value === null) {
+    return [];
+  }
+  return (Array.isArray(value) ? value : [value]).filter(
+    (item) => item !== void 0 && item !== null
+  );
+}
+function validateMockInclude(slot, label, include, depth) {
+  if (slot.trim() === "") {
+    throw new Error("Include slot names must not be empty.");
+  }
+  if (depth > MOCK_MAX_INCLUDE_DEPTH) {
+    throw new Error(
+      `Include "${label}" nests ${depth} levels deep, more than the maximum of ${MOCK_MAX_INCLUDE_DEPTH}.`
+    );
+  }
+  if (include.cardinality !== "one" && include.cardinality !== "many") {
+    throw new Error(
+      `Include "${label}" needs an explicit cardinality of "one" or "many" (got ${JSON.stringify(include.cardinality)}).`
+    );
+  }
+  if (include.localKey === void 0 && include.filter === void 0) {
+    throw new Error(
+      `Include "${label}" needs a localKey or a filter to relate documents to the parent row.`
+    );
+  }
+  if (include.localKey !== void 0 && include.localKey.trim() === "") {
+    throw new Error(`Include "${label}" has an empty localKey.`);
+  }
+  if (include.cardinality === "one") {
+    if (include.sortBy !== void 0) {
+      throw new Error(
+        `Include "${label}" has cardinality "one", which resolves to a single row \u2014 sortBy is meaningless there.`
+      );
+    }
+    if (include.limit !== void 0) {
+      throw new Error(
+        `Include "${label}" has cardinality "one", which resolves to a single row \u2014 limit is meaningless there.`
+      );
+    }
+  }
+  if (include.limit !== void 0 && (!Number.isFinite(include.limit) || include.limit < 0)) {
+    throw new Error(`Include "${label}" has an invalid limit (${include.limit}).`);
+  }
+  for (const sortKey of include.sortBy ?? []) {
+    if (sortKey.special === "textScore") {
+      throw new Error(
+        `Include "${label}" sorts by textScore, but includes have no text clause to score against.`
+      );
+    }
+  }
+}
+function hydrateMockIncludes(params) {
+  const { includes, parents, parentDocuments, resolveDatabase, depth, slotPath } = params;
+  for (const [slot, include] of Object.entries(includes)) {
+    const label = slotPath ? `${slotPath}.${slot}` : slot;
+    validateMockInclude(slot, label, include, depth);
+    const filter = mockIncludeFilter(include);
+    const plan = planMockInclude(label, include, filter);
+    const childDatabaseId = include.databaseId ?? params.parentDatabaseId;
+    let childDocuments = parentDocuments;
+    if (include.databaseId !== void 0) {
+      const resolved = resolveDatabase?.(include.databaseId);
+      if (!resolved) {
+        throw new Error(
+          `Include "${label}" refers to the database "${include.databaseId}", which this app is not mapped to.`
+        );
+      }
+      childDocuments = resolved;
+    }
+    if (parents.length === 0) {
+      continue;
+    }
+    const parentsByKey = /* @__PURE__ */ new Map();
+    for (const parent of parents) {
+      const parentValue = plan.parent.kind === "docId" ? parent.docId : getFieldValue2(parent.data, plan.parent.path);
+      for (const key of mockJoinValues(parentValue)) {
+        const bucket = parentsByKey.get(key);
+        if (bucket) {
+          bucket.push(parent);
+        } else {
+          parentsByKey.set(key, [parent]);
+        }
+      }
+    }
+    const sortBy = include.sortBy ?? [];
+    const childrenByKey = /* @__PURE__ */ new Map();
+    if (parentsByKey.size > 0) {
+      for (const document of childDocuments.values()) {
+        if (document.isDeleted || document.inaccessible) {
+          continue;
+        }
+        const childValue = plan.child.kind === "docId" ? document.id : getFieldValue2(document.data, plan.child.path);
+        const matchedKeys = mockJoinValues(childValue).filter((key) => parentsByKey.has(key));
+        if (matchedKeys.length === 0) {
+          continue;
+        }
+        const context = {
+          doc: document.data,
+          values: {},
+          origin: childDatabaseId,
+          docId: document.id,
+          variables: {}
+        };
+        if (plan.residualFilter && !mockExpressionToBoolean(evaluateExpression2(plan.residualFilter, context))) {
+          continue;
+        }
+        const candidate = {
+          docId: document.id,
+          data: document.data,
+          row: {
+            docId: document.id,
+            fields: projectMockFields(document.data, include.fields),
+            lastModified: mockLastModified(document)
+          },
+          sortValues: sortBy.map(
+            (key) => key.expression ? evaluateExpression2(key.expression, context) : getFieldValue2(document.data, key.field ?? "")
+          )
+        };
+        for (const key of matchedKeys) {
+          const bucket = childrenByKey.get(key);
+          if (bucket) {
+            bucket.push(candidate);
+          } else {
+            childrenByKey.set(key, [candidate]);
+          }
+        }
+      }
+    }
+    const childParents = attachMockIncludeSlot(
+      slot,
+      label,
+      include,
+      plan,
+      parents,
+      childrenByKey,
+      sortBy
+    );
+    if (include.include && childParents.length > 0) {
+      hydrateMockIncludes({
+        includes: include.include,
+        parents: childParents,
+        parentDatabaseId: childDatabaseId,
+        parentDocuments: childDocuments,
+        resolveDatabase,
+        depth: depth + 1,
+        slotPath: label
+      });
+    }
+  }
+}
+function attachMockIncludeSlot(slot, label, include, plan, parents, childrenByKey, sortBy) {
+  const limit = include.limit ?? MOCK_DEFAULT_INCLUDE_LIMIT;
+  const nextParents = [];
+  for (const parent of parents) {
+    const parentValue = plan.parent.kind === "docId" ? parent.docId : getFieldValue2(parent.data, plan.parent.path);
+    const seen = /* @__PURE__ */ new Set();
+    const matches = [];
+    for (const key of mockJoinValues(parentValue)) {
+      for (const candidate of childrenByKey.get(key) ?? []) {
+        if (seen.has(candidate.docId)) {
+          continue;
+        }
+        seen.add(candidate.docId);
+        matches.push(candidate);
+      }
+    }
+    const slots = parent.row.includes ??= {};
+    if (include.cardinality === "one") {
+      if (matches.length > 1) {
+        const sample = matches.slice(0, 3).map((match2) => match2.docId).join(", ");
+        throw new Error(
+          `Include "${label}" has cardinality "one", but document "${parent.docId}" matched ${matches.length} related documents (${sample}${matches.length > 3 ? ", \u2026" : ""}). Use cardinality "many" if several matches are expected.`
+        );
+      }
+      if (matches.length === 0) {
+        slots[slot] = null;
+        continue;
+      }
+      const match = matches[0];
+      const row = structuredClone(match.row);
+      slots[slot] = row;
+      nextParents.push({ row, docId: match.docId, data: match.data });
+      continue;
+    }
+    matches.sort((left, right) => {
+      for (let i = 0; i < sortBy.length; i++) {
+        const result = compareMockQueryValues(left.sortValues[i], right.sortValues[i]);
+        if (result !== 0) {
+          return sortBy[i].direction === "descending" ? -result : result;
+        }
+      }
+      return left.docId.localeCompare(right.docId);
+    });
+    const rows = [];
+    for (const candidate of matches.slice(0, limit)) {
+      const row = structuredClone(candidate.row);
+      rows.push(row);
+      nextParents.push({ row, docId: candidate.docId, data: candidate.data });
+    }
+    slots[slot] = rows;
+  }
+  return nextParents;
+}
 function createDefaultViewNavigator() {
   const definition = {
     title: "Mock View",
@@ -1230,7 +1540,7 @@ async function mockSha256Hex(value) {
   const digest = await subtle.digest("SHA-256", new TextEncoder().encode(value));
   return Array.from(new Uint8Array(digest)).map((byte) => byte.toString(16).padStart(2, "0")).join("");
 }
-function createDatabaseHandle(definition) {
+function createDatabaseHandle(definition, peers) {
   let createCounter = 0;
   let changeCounter = 0;
   const defaultViewFactory = async () => createDefaultViewNavigator();
@@ -1250,12 +1560,13 @@ function createDatabaseHandle(definition) {
     });
   }
   const liveQuerySubscriptions = /* @__PURE__ */ new Set();
-  const notifyLiveQueries = () => {
+  const refreshLiveQueries = () => {
     for (const subscription of liveQuerySubscriptions) {
       const result = runMockDocumentQuery(
         storedDocuments,
         definition.info.id,
-        subscription.query
+        subscription.query,
+        peers.getDocuments
       );
       const resultJson = JSON.stringify(result);
       if (resultJson !== subscription.lastResultJson) {
@@ -1264,6 +1575,9 @@ function createDatabaseHandle(definition) {
       }
     }
   };
+  const notifyLiveQueries = () => {
+    peers.refreshAllLiveQueries();
+  };
   function mockEncryptForMap(names) {
     const encryptFor = {};
     for (const name of names) {
@@ -1304,13 +1618,19 @@ function createDatabaseHandle(definition) {
   }
   const defaultDocuments = {
     async query(query) {
-      return runMockDocumentQuery(storedDocuments, definition.info.id, query);
+      return runMockDocumentQuery(
+        storedDocuments,
+        definition.info.id,
+        query,
+        peers.getDocuments
+      );
     },
     async liveQuery(query, onResult) {
       const initial = runMockDocumentQuery(
         storedDocuments,
         definition.info.id,
-        query
+        query,
+        peers.getDocuments
       );
       const subscription = {
         query,
@@ -1327,7 +1647,8 @@ function createDatabaseHandle(definition) {
           const result = runMockDocumentQuery(
             storedDocuments,
             definition.info.id,
-            query
+            query,
+            peers.getDocuments
           );
           subscription.lastResultJson = JSON.stringify(result);
           onResult(result);
@@ -1845,7 +2166,9 @@ function createDatabaseHandle(definition) {
       docId: document.id,
       data: structuredClone(document.data),
       createdAt: document.updatedAt ?? null
-    }))
+    })),
+    documents: storedDocuments,
+    notifyLiveQueries: refreshLiveQueries
   };
 }
 function createMockSessionState(options = {}) {
@@ -1857,6 +2180,16 @@ function createMockSessionState(options = {}) {
   const beforeCloseListeners = /* @__PURE__ */ new Set();
   const databaseHandles = /* @__PURE__ */ new Map();
   const databaseViewDocumentLists = /* @__PURE__ */ new Map();
+  const databaseDocumentStores = /* @__PURE__ */ new Map();
+  const databaseLiveQueryRefreshers = /* @__PURE__ */ new Map();
+  const databasePeers = {
+    getDocuments: (databaseId) => databaseDocumentStores.get(databaseId),
+    refreshAllLiveQueries: () => {
+      for (const refresh of databaseLiveQueryRefreshers.values()) {
+        refresh();
+      }
+    }
+  };
   const databaseViewApis = /* @__PURE__ */ new Map();
   const sessionViews = /* @__PURE__ */ new Map();
   let activeMenuResolve = null;
@@ -1931,14 +2264,18 @@ function createMockSessionState(options = {}) {
     databaseHandles.clear();
     databaseViewDocumentLists.clear();
     databaseViewApis.clear();
+    databaseDocumentStores.clear();
+    databaseLiveQueryRefreshers.clear();
     databaseInfos = definitions.map((definition) => ({
       ...definition.info,
       capabilities: [...definition.info.capabilities]
     }));
     for (const definition of definitions) {
-      const created = createDatabaseHandle(definition);
+      const created = createDatabaseHandle(definition, databasePeers);
       databaseHandles.set(definition.info.id, created.handle);
       databaseViewDocumentLists.set(definition.info.id, created.listViewDocuments);
+      databaseDocumentStores.set(definition.info.id, created.documents);
+      databaseLiveQueryRefreshers.set(definition.info.id, created.notifyLiveQueries);
       databaseViewApis.set(definition.info.id, {
         async create(input) {
           const documents = input.databaseIds.flatMap((databaseId) => {

package/dist/{types-C2WDj-Tv.d.ts → types-C-eyC839.d.ts}

@@ -1450,8 +1450,80 @@ interface MindooDBAppExtractionSetup {
  * `'v.and(v.eq(v.field("type"), "invoice"), v.gt(v.field("total"), 100))'`),
  * which the SDK parses locally; only JSON travels across the bridge.
  */
+/**
+ * Cardinality of a {@link MindooDBAppQueryInclude}: whether the slot
+ * resolves to a single related document or a list of them. Always
+ * explicit — a lookup that silently picks the first of several matches is
+ * a bug waiting to happen.
+ */
+type MindooDBAppQueryIncludeCardinality = "one" | "many";
+/**
+ * One nested lookup ("join") of a {@link MindooDBAppDocumentQuery}: the
+ * related documents are fetched alongside the matching rows and attached
+ * under {@link MindooDBAppQueryRow.includes}.
+ *
+ * Mirrors mindoodb's `MindooQueryInclude` with one substitution: core
+ * takes a live `MindooDB` instance, which cannot cross the bridge, so a
+ * related database is named by its logical {@link databaseId} instead.
+ *
+ * ```typescript
+ * await database.documents.query({
+ *   filter: 'v.eq(v.field("type"), "invoice")',
+ *   include: {
+ *     customer: { databaseId: "customers", cardinality: "one", localKey: "customerId" },
+ *     lines: { cardinality: "many", filter: 'v.eq(v.field("invoiceId"), v.parentDocId())' },
+ *   },
+ * });
+ * ```
+ */
+interface MindooDBAppQueryInclude {
+    /**
+     * The database the related documents live in, addressed by the same
+     * logical id `openDatabase()` takes. Omit for the database the query
+     * itself runs against. The app must be mapped to it with read access.
+     */
+    databaseId?: string;
+    cardinality: MindooDBAppQueryIncludeCardinality;
+    /**
+     * Field of the PARENT document holding the related document's id —
+     * sugar for `v.eq(v.docId(), v.parent("<localKey>"))`. An array value
+     * joins every element.
+     */
+    localKey?: string;
+    /**
+     * Join condition, as an expression or formula source text. Exactly one
+     * equality must relate the related document to the parent row
+     * (`v.parentDocId()` for the parent's id, `v.parent(path)` for one of
+     * its fields); any further conditions narrow the related documents.
+     */
+    filter?: MindooDBAppBooleanExpression | string;
+    /** Projection for the related rows. Defaults to all summary fields. */
+    fields?: string[];
+    /** Ordering of the related rows. Only valid for `cardinality: "many"`. */
+    sortBy?: MindooDBAppQuerySortKey[];
+    /**
+     * Maximum number of related rows per parent row. Only valid for
+     * `cardinality: "many"`; the host enforces a cap.
+     */
+    limit?: number;
+    /** Nested lookups on the related documents. */
+    include?: Record<string, MindooDBAppQueryInclude>;
+}
+/**
+ * The related documents attached to a row, keyed by include slot name: a
+ * single row (or `null`) for `cardinality: "one"`, an array — possibly
+ * empty, never `null` — for `"many"`.
+ */
+type MindooDBAppQueryIncludeSlots = Record<string, MindooDBAppQueryRow | MindooDBAppQueryRow[] | null>;
 interface MindooDBAppDocumentQuery {
     filter?: MindooDBAppBooleanExpression | string;
+    /**
+     * Nested lookups, keyed by the slot name the related documents appear
+     * under in {@link MindooDBAppQueryRow.includes}. Resolved for the
+     * returned page only, at one scan per slot rather than one query per
+     * row.
+     */
+    include?: Record<string, MindooDBAppQueryInclude>;
     /**
      * Full-text clause: additionally require documents to match this
      * full-text search (combined with `filter` as a logical AND). Adds a
@@ -1474,7 +1546,7 @@ interface MindooDBAppDocumentQuery {
     fields?: string[];
 }
 /** One result row of a summary-backed document query. */
-interface MindooDBAppQueryRow {
+interface MindooDBAppQueryRow<TIncludes extends MindooDBAppQueryIncludeSlots = MindooDBAppQueryIncludeSlots> {
     docId: string;
     fields: Record<string, unknown>;
     lastModified: number;
@@ -1483,6 +1555,15 @@ interface MindooDBAppQueryRow {
      * Only present when the query had a `text` clause.
      */
     textScore?: number;
+    /**
+     * Related documents fetched through the query's `include` clause, keyed
+     * by slot name. Absent when the query carried no `include`, so results
+     * of plain queries keep exactly the shape they always had.
+     *
+     * Included rows are ordinary rows, so a nested lookup reads as
+     * `row.includes.customer.includes.address`.
+     */
+    includes?: TIncludes;
 }
 /**
  * Which data answered the query: `"full"` when the summary buffer is
@@ -1490,9 +1571,22 @@ interface MindooDBAppQueryRow {
  * be incomplete), `"full-scan"` when documents were materialized.
  */
 type MindooDBAppQueryCoverage = "full" | "rebuilding" | "full-scan";
-/** Result of a summary-backed document query. */
-interface MindooDBAppQueryResult {
-    rows: MindooDBAppQueryRow[];
+/**
+ * Result of a summary-backed document query.
+ *
+ * Slot types of an `include` clause are not inferred from the query
+ * object; callers who want them pass them explicitly:
+ *
+ * ```typescript
+ * const result = await database.documents.query<{
+ *   customer: MindooDBAppQueryRow | null;
+ *   lines: MindooDBAppQueryRow[];
+ * }>({ ... });
+ * result.rows[0]?.includes?.lines[0]?.fields.amount;
+ * ```
+ */
+interface MindooDBAppQueryResult<TIncludes extends MindooDBAppQueryIncludeSlots = MindooDBAppQueryIncludeSlots> {
+    rows: MindooDBAppQueryRow<TIncludes>[];
     /** Number of matching documents before `offset`/`limit` were applied. */
     total: number;
     coverage: MindooDBAppQueryCoverage;
@@ -1523,15 +1617,22 @@ interface MindooDBAppDocumentApi {
      * `query-not-supported` error. A `text` clause requires full-text
      * indexing to be enabled for the database, otherwise the query is
      * rejected with `fulltext-not-enabled`.
+     *
+     * An `include` clause additionally fetches related documents, from this
+     * or another mapped database; pass the slot types as `TIncludes` to
+     * type `row.includes`.
      */
-    query(query?: MindooDBAppDocumentQuery): Promise<MindooDBAppQueryResult>;
+    query<TIncludes extends MindooDBAppQueryIncludeSlots = MindooDBAppQueryIncludeSlots>(query?: MindooDBAppDocumentQuery): Promise<MindooDBAppQueryResult<TIncludes>>;
     /**
      * Live variant of {@link query}: delivers the initial result, then keeps
      * watching the database and calls `onResult` again whenever the result
      * actually changed (membership, order, or row content). Updates are
      * coalesced on the host, so bursts of writes produce a single push.
+     *
+     * With an `include` clause the subscription also watches every related
+     * database, so a change to a joined document pushes a new result too.
      */
-    liveQuery(query: MindooDBAppDocumentQuery, onResult: (result: MindooDBAppQueryResult) => void): Promise<MindooDBAppLiveQuerySubscription>;
+    liveQuery<TIncludes extends MindooDBAppQueryIncludeSlots = MindooDBAppQueryIncludeSlots>(query: MindooDBAppDocumentQuery, onResult: (result: MindooDBAppQueryResult<TIncludes>) => void): Promise<MindooDBAppLiveQuerySubscription>;
     /**
      * Page through the database's changefeed. Pass the returned `nextCursor`
      * back in to resume — this is the primitive for incremental sync and
@@ -2549,4 +2650,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppBridgeStreamCloseRequest as $, type MindooDBAppAutomergeChangesPatch as A, type MindooDBAppAutomergeChangesSince as B, type MindooDBAppAutomergeGetOptions as C, type MindooDBAppAutomergePatchResult as D, type MindooDBAppAutomergeSnapshot as E, type MindooDBAppBridgeBeforeCloseAck as F, type MindooDBAppBridgeBeforeCloseMessage as G, type MindooDBAppBridgeConnectMessage as H, type MindooDBAppBridgeConnectOptions as I, type MindooDBAppBridgeConnectedMessage as J, type MindooDBAppBridgeDragDropMessage as K, type MindooDBAppBridgeDragLeaveMessage as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppBridgeDragOverMessage as N, type MindooDBAppBridgeErrorPayload as O, type MindooDBAppBridgeHandshakeErrorMessage as P, type MindooDBAppBridgeLocaleChangedMessage as Q, type MindooDBAppBridgePortMessage as R, type MindooDBAppBridgeQueryResultMessage as S, type MindooDBAppBridgeRpcError as T, type MindooDBAppBridgeRpcMessage as U, type MindooDBAppBridgeRpcRequest as V, type MindooDBAppBridgeRpcSuccess as W, type MindooDBAppBridgeShortcutInvokedMessage as X, type MindooDBAppBridgeShortcutsChangedMessage as Y, type MindooDBAppBridgeStreamAbortRequest as Z, type MindooDBAppBridgeStreamAck as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppHistoryQuery as a$, type MindooDBAppBridgeStreamError as a0, type MindooDBAppBridgeStreamMessage as a1, type MindooDBAppBridgeStreamOpenResult as a2, type MindooDBAppBridgeStreamReadRequest as a3, type MindooDBAppBridgeStreamWriteRequest as a4, type MindooDBAppBridgeThemeChangedMessage as a5, type MindooDBAppBridgeUiPreferencesChangedMessage as a6, type MindooDBAppBridgeViewChangedMessage as a7, type MindooDBAppBridgeViewportChangedMessage as a8, type MindooDBAppCapability as a9, type MindooDBAppDirectoryEntry as aA, type MindooDBAppDocumentApi as aB, type MindooDBAppDocumentHeadCursorResult as aC, type MindooDBAppDocumentHistoryEntry as aD, type MindooDBAppDocumentListQuery as aE, type MindooDBAppDocumentListResult as aF, type MindooDBAppDocumentQuery as aG, type MindooDBAppDocumentRevisionId as aH, type MindooDBAppDocumentScanPreset as aI, type MindooDBAppDocumentSummary as aJ, type MindooDBAppDragApi as aK, type MindooDBAppDragCancelReason as aL, type MindooDBAppDragDropEvent as aM, type MindooDBAppDragEffect as aN, type MindooDBAppDragHoverResult as aO, type MindooDBAppDragOffer as aP, type MindooDBAppDragOverEvent as aQ, type MindooDBAppDragPointer as aR, type MindooDBAppDragProfile as aS, type MindooDBAppEntryAttachmentRef as aT, type MindooDBAppEntryProvenance as aU, type MindooDBAppExtractDocumentTextInput as aV, type MindooDBAppExtractDocumentTextResult as aW, type MindooDBAppExtractTextFormat as aX, type MindooDBAppExtractionSetup as aY, type MindooDBAppFulltextSetup as aZ, type MindooDBAppHistoricalDocument as a_, type MindooDBAppConfiguredViewCategorizationStyle as aa, type MindooDBAppConfiguredViewColumn as ab, type MindooDBAppConfiguredViewColumnRole as ac, type MindooDBAppConfiguredViewExpressionMode as ad, type MindooDBAppConfiguredViewFieldExpression as ae, type MindooDBAppConfiguredViewFilterDefinition as af, type MindooDBAppConfiguredViewFilterMode as ag, type MindooDBAppConfiguredViewFilterRule as ah, type MindooDBAppConfiguredViewFormulaExpression as ai, type MindooDBAppConfiguredViewFormulaFilterDefinition as aj, type MindooDBAppConfiguredViewPreviewMode as ak, type MindooDBAppConfiguredViewRuleFilterDefinition as al, type MindooDBAppConfiguredViewRuleMatchMode as am, type MindooDBAppConfiguredViewRuleOperator as an, type MindooDBAppConfiguredViewValueExpression as ao, type MindooDBAppCreateDocumentInput as ap, type MindooDBAppCreateKeyInfo as aq, type MindooDBAppCreateViewInput as ar, type MindooDBAppCreateViewNavigatorInput as as, type MindooDBAppDatabaseInfo as at, type MindooDBAppDefinition as au, type MindooDBAppDefinitionDatabase as av, type MindooDBAppDefinitionPermission as aw, type MindooDBAppDefinitionRegistrationPermission as ax, type MindooDBAppDefinitionValidation as ay, type MindooDBAppDirectoryApi as az, type MindooDBAppDragStartInput as b, type MindooDBAppShowMenuResult as b$, type MindooDBAppHostTheme as b0, type MindooDBAppIdentityApi as b1, type MindooDBAppInaccessibleDocument as b2, type MindooDBAppInaccessibleDocumentListQuery as b3, type MindooDBAppInaccessibleDocumentListResult as b4, type MindooDBAppJsonListDeletePatch as b5, type MindooDBAppJsonListInsertPatch as b6, type MindooDBAppJsonPatch as b7, type MindooDBAppJsonSetPatch as b8, type MindooDBAppJsonTextMarkPatch as b9, type MindooDBAppRecipientOptions as bA, type MindooDBAppResolvedViewDefinition as bB, type MindooDBAppResolvedViewSource as bC, type MindooDBAppRevisionPhase as bD, type MindooDBAppRevisionVerification as bE, type MindooDBAppRichTextBlockSpan as bF, type MindooDBAppRichTextGetOptions as bG, type MindooDBAppRichTextImmutableString as bH, type MindooDBAppRichTextMarkRange as bI, type MindooDBAppRichTextMaterializeValue as bJ, type MindooDBAppRichTextPatch as bK, type MindooDBAppRichTextScalar as bL, type MindooDBAppRichTextSpliceStep as bM, type MindooDBAppRichTextStep as bN, type MindooDBAppRichTextStepPatch as bO, type MindooDBAppRichTextTextSpan as bP, type MindooDBAppRuntime as bQ, type MindooDBAppScanAttachmentOptions as bR, type MindooDBAppScanAttachmentResult as bS, type MindooDBAppScopedDocId as bT, type MindooDBAppScopedDocumentSummary as bU, type MindooDBAppSealIntent as bV, type MindooDBAppSealedChannelOpenInput as bW, type MindooDBAppSealedChannelOpenResult as bX, type MindooDBAppSealedChannelRequestInput as bY, type MindooDBAppSession as bZ, type MindooDBAppShowMenuInput as b_, type MindooDBAppJsonTextSplicePatch as ba, type MindooDBAppJsonTextUnmarkPatch as bb, type MindooDBAppJsonUnsetPatch as bc, type MindooDBAppLaunchContext as bd, type MindooDBAppLiveQuerySubscription as be, type MindooDBAppMenuAnchor as bf, type MindooDBAppMenuApi as bg, type MindooDBAppMenuCommandItem as bh, type MindooDBAppMenuDismissReason as bi, type MindooDBAppMenuDismissedResult as bj, type MindooDBAppMenuItem as bk, type MindooDBAppMenuKind as bl, type MindooDBAppMenuPlacement as bm, type MindooDBAppMenuPointAnchor as bn, type MindooDBAppMenuRect as bo, type MindooDBAppMenuRectAnchor as bp, type MindooDBAppMenuSelectionResult as bq, type MindooDBAppMenuSeparatorItem as br, type MindooDBAppProposeAppInput as bs, type MindooDBAppProposeAppResult as bt, type MindooDBAppQueryCoverage as bu, type MindooDBAppQueryResult as bv, type MindooDBAppQueryRow as bw, type MindooDBAppQuerySortKey as bx, type MindooDBAppQueryTextClause as by, type MindooDBAppReadableAttachmentStream as bz, type MindooDBAppDragStartResult as c, type MindooDBAppSignPreview as c0, type MindooDBAppSignPreviewScope as c1, type MindooDBAppSignStatementInput as c2, type MindooDBAppSignStatementResult as c3, type MindooDBAppStorageApi as c4, type MindooDBAppTextEdit as c5, type MindooDBAppTextPatch as c6, type MindooDBAppThemeMode as c7, type MindooDBAppTimestampApi as c8, type MindooDBAppTimestampInput as c9, type MindooDBAppTimestampProvider as ca, type MindooDBAppTimestampResult as cb, type MindooDBAppUiPreferences as cc, type MindooDBAppUpdateDocumentInput as cd, type MindooDBAppViewCursorDocumentListResult as ce, type MindooDBAppViewCursorResult as cf, type MindooDBAppViewEntry as cg, type MindooDBAppViewEntryKind as ch, type MindooDBAppViewNavigator as ci, type MindooDBAppViewNavigatorExpansionState as cj, type MindooDBAppViewNavigatorOpenOptions as ck, type MindooDBAppViewNavigatorPageOptions as cl, type MindooDBAppViewNavigatorPageResult as cm, type MindooDBAppViewNavigatorRangeQuery as cn, type MindooDBAppViewNavigatorSelectionState as co, type MindooDBAppViewUpdateStats as cp, type MindooDBAppViewport as cq, type MindooDBAppWellKnownDragType as cr, type MindooDBAppWritableAttachmentStream as cs, resolveMindooDBAppDefinitionUrl as ct, validateMindooDBAppDefinition as cu, type MindooDBAppDragPreview as d, type MindooDBAppBridge as e, type MindooDBAppHostShortcutBinding as f, type MindooDBAppHostShortcutAction as g, type MindooDBAppHostingMode as h, type MindooDBAppDatabase as i, type MindooDBAppDocument as j, type MindooDBAppRichTextSpan as k, type MindooDBAppRichTextSnapshot as l, MINDOODB_APP_DEFINITION_FILE_NAME as m, MINDOODB_APP_DEFINITION_FORMAT as n, MINDOODB_APP_DEFINITION_PERMISSIONS as o, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as p, MINDOODB_APP_DEFINITION_VERSION as q, MINDOODB_APP_SEAL_SIGNING_DOMAIN as r, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as s, type MindooDBAppAccessDecision as t, type MindooDBAppAccessTier as u, type MindooDBAppAttachmentApi as v, type MindooDBAppAttachmentChunk as w, type MindooDBAppAttachmentInfo as x, type MindooDBAppAttachmentPreviewOptions as y, type MindooDBAppAttachmentPreviewSession as z };
+export { type MindooDBAppBridgeStreamCloseRequest as $, type MindooDBAppAutomergeChangesPatch as A, type MindooDBAppAutomergeChangesSince as B, type MindooDBAppAutomergeGetOptions as C, type MindooDBAppAutomergePatchResult as D, type MindooDBAppAutomergeSnapshot as E, type MindooDBAppBridgeBeforeCloseAck as F, type MindooDBAppBridgeBeforeCloseMessage as G, type MindooDBAppBridgeConnectMessage as H, type MindooDBAppBridgeConnectOptions as I, type MindooDBAppBridgeConnectedMessage as J, type MindooDBAppBridgeDragDropMessage as K, type MindooDBAppBridgeDragLeaveMessage as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppBridgeDragOverMessage as N, type MindooDBAppBridgeErrorPayload as O, type MindooDBAppBridgeHandshakeErrorMessage as P, type MindooDBAppBridgeLocaleChangedMessage as Q, type MindooDBAppBridgePortMessage as R, type MindooDBAppBridgeQueryResultMessage as S, type MindooDBAppBridgeRpcError as T, type MindooDBAppBridgeRpcMessage as U, type MindooDBAppBridgeRpcRequest as V, type MindooDBAppBridgeRpcSuccess as W, type MindooDBAppBridgeShortcutInvokedMessage as X, type MindooDBAppBridgeShortcutsChangedMessage as Y, type MindooDBAppBridgeStreamAbortRequest as Z, type MindooDBAppBridgeStreamAck as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppHistoryQuery as a$, type MindooDBAppBridgeStreamError as a0, type MindooDBAppBridgeStreamMessage as a1, type MindooDBAppBridgeStreamOpenResult as a2, type MindooDBAppBridgeStreamReadRequest as a3, type MindooDBAppBridgeStreamWriteRequest as a4, type MindooDBAppBridgeThemeChangedMessage as a5, type MindooDBAppBridgeUiPreferencesChangedMessage as a6, type MindooDBAppBridgeViewChangedMessage as a7, type MindooDBAppBridgeViewportChangedMessage as a8, type MindooDBAppCapability as a9, type MindooDBAppDirectoryEntry as aA, type MindooDBAppDocumentApi as aB, type MindooDBAppDocumentHeadCursorResult as aC, type MindooDBAppDocumentHistoryEntry as aD, type MindooDBAppDocumentListQuery as aE, type MindooDBAppDocumentListResult as aF, type MindooDBAppDocumentQuery as aG, type MindooDBAppDocumentRevisionId as aH, type MindooDBAppDocumentScanPreset as aI, type MindooDBAppDocumentSummary as aJ, type MindooDBAppDragApi as aK, type MindooDBAppDragCancelReason as aL, type MindooDBAppDragDropEvent as aM, type MindooDBAppDragEffect as aN, type MindooDBAppDragHoverResult as aO, type MindooDBAppDragOffer as aP, type MindooDBAppDragOverEvent as aQ, type MindooDBAppDragPointer as aR, type MindooDBAppDragProfile as aS, type MindooDBAppEntryAttachmentRef as aT, type MindooDBAppEntryProvenance as aU, type MindooDBAppExtractDocumentTextInput as aV, type MindooDBAppExtractDocumentTextResult as aW, type MindooDBAppExtractTextFormat as aX, type MindooDBAppExtractionSetup as aY, type MindooDBAppFulltextSetup as aZ, type MindooDBAppHistoricalDocument as a_, type MindooDBAppConfiguredViewCategorizationStyle as aa, type MindooDBAppConfiguredViewColumn as ab, type MindooDBAppConfiguredViewColumnRole as ac, type MindooDBAppConfiguredViewExpressionMode as ad, type MindooDBAppConfiguredViewFieldExpression as ae, type MindooDBAppConfiguredViewFilterDefinition as af, type MindooDBAppConfiguredViewFilterMode as ag, type MindooDBAppConfiguredViewFilterRule as ah, type MindooDBAppConfiguredViewFormulaExpression as ai, type MindooDBAppConfiguredViewFormulaFilterDefinition as aj, type MindooDBAppConfiguredViewPreviewMode as ak, type MindooDBAppConfiguredViewRuleFilterDefinition as al, type MindooDBAppConfiguredViewRuleMatchMode as am, type MindooDBAppConfiguredViewRuleOperator as an, type MindooDBAppConfiguredViewValueExpression as ao, type MindooDBAppCreateDocumentInput as ap, type MindooDBAppCreateKeyInfo as aq, type MindooDBAppCreateViewInput as ar, type MindooDBAppCreateViewNavigatorInput as as, type MindooDBAppDatabaseInfo as at, type MindooDBAppDefinition as au, type MindooDBAppDefinitionDatabase as av, type MindooDBAppDefinitionPermission as aw, type MindooDBAppDefinitionRegistrationPermission as ax, type MindooDBAppDefinitionValidation as ay, type MindooDBAppDirectoryApi as az, type MindooDBAppDragStartInput as b, type MindooDBAppSealedChannelRequestInput as b$, type MindooDBAppHostTheme as b0, type MindooDBAppIdentityApi as b1, type MindooDBAppInaccessibleDocument as b2, type MindooDBAppInaccessibleDocumentListQuery as b3, type MindooDBAppInaccessibleDocumentListResult as b4, type MindooDBAppJsonListDeletePatch as b5, type MindooDBAppJsonListInsertPatch as b6, type MindooDBAppJsonPatch as b7, type MindooDBAppJsonSetPatch as b8, type MindooDBAppJsonTextMarkPatch as b9, type MindooDBAppQuerySortKey as bA, type MindooDBAppQueryTextClause as bB, type MindooDBAppReadableAttachmentStream as bC, type MindooDBAppRecipientOptions as bD, type MindooDBAppResolvedViewDefinition as bE, type MindooDBAppResolvedViewSource as bF, type MindooDBAppRevisionPhase as bG, type MindooDBAppRevisionVerification as bH, type MindooDBAppRichTextBlockSpan as bI, type MindooDBAppRichTextGetOptions as bJ, type MindooDBAppRichTextImmutableString as bK, type MindooDBAppRichTextMarkRange as bL, type MindooDBAppRichTextMaterializeValue as bM, type MindooDBAppRichTextPatch as bN, type MindooDBAppRichTextScalar as bO, type MindooDBAppRichTextSpliceStep as bP, type MindooDBAppRichTextStep as bQ, type MindooDBAppRichTextStepPatch as bR, type MindooDBAppRichTextTextSpan as bS, type MindooDBAppRuntime as bT, type MindooDBAppScanAttachmentOptions as bU, type MindooDBAppScanAttachmentResult as bV, type MindooDBAppScopedDocId as bW, type MindooDBAppScopedDocumentSummary as bX, type MindooDBAppSealIntent as bY, type MindooDBAppSealedChannelOpenInput as bZ, type MindooDBAppSealedChannelOpenResult as b_, type MindooDBAppJsonTextSplicePatch as ba, type MindooDBAppJsonTextUnmarkPatch as bb, type MindooDBAppJsonUnsetPatch as bc, type MindooDBAppLaunchContext as bd, type MindooDBAppLiveQuerySubscription as be, type MindooDBAppMenuAnchor as bf, type MindooDBAppMenuApi as bg, type MindooDBAppMenuCommandItem as bh, type MindooDBAppMenuDismissReason as bi, type MindooDBAppMenuDismissedResult as bj, type MindooDBAppMenuItem as bk, type MindooDBAppMenuKind as bl, type MindooDBAppMenuPlacement as bm, type MindooDBAppMenuPointAnchor as bn, type MindooDBAppMenuRect as bo, type MindooDBAppMenuRectAnchor as bp, type MindooDBAppMenuSelectionResult as bq, type MindooDBAppMenuSeparatorItem as br, type MindooDBAppProposeAppInput as bs, type MindooDBAppProposeAppResult as bt, type MindooDBAppQueryCoverage as bu, type MindooDBAppQueryInclude as bv, type MindooDBAppQueryIncludeCardinality as bw, type MindooDBAppQueryIncludeSlots as bx, type MindooDBAppQueryResult as by, type MindooDBAppQueryRow as bz, type MindooDBAppDragStartResult as c, type MindooDBAppSession as c0, type MindooDBAppShowMenuInput as c1, type MindooDBAppShowMenuResult as c2, type MindooDBAppSignPreview as c3, type MindooDBAppSignPreviewScope as c4, type MindooDBAppSignStatementInput as c5, type MindooDBAppSignStatementResult as c6, type MindooDBAppStorageApi as c7, type MindooDBAppTextEdit as c8, type MindooDBAppTextPatch as c9, type MindooDBAppThemeMode as ca, type MindooDBAppTimestampApi as cb, type MindooDBAppTimestampInput as cc, type MindooDBAppTimestampProvider as cd, type MindooDBAppTimestampResult as ce, type MindooDBAppUiPreferences as cf, type MindooDBAppUpdateDocumentInput as cg, type MindooDBAppViewCursorDocumentListResult as ch, type MindooDBAppViewCursorResult as ci, type MindooDBAppViewEntry as cj, type MindooDBAppViewEntryKind as ck, type MindooDBAppViewNavigator as cl, type MindooDBAppViewNavigatorExpansionState as cm, type MindooDBAppViewNavigatorOpenOptions as cn, type MindooDBAppViewNavigatorPageOptions as co, type MindooDBAppViewNavigatorPageResult as cp, type MindooDBAppViewNavigatorRangeQuery as cq, type MindooDBAppViewNavigatorSelectionState as cr, type MindooDBAppViewUpdateStats as cs, type MindooDBAppViewport as ct, type MindooDBAppWellKnownDragType as cu, type MindooDBAppWritableAttachmentStream as cv, resolveMindooDBAppDefinitionUrl as cw, validateMindooDBAppDefinition as cx, type MindooDBAppDragPreview as d, type MindooDBAppBridge as e, type MindooDBAppHostShortcutBinding as f, type MindooDBAppHostShortcutAction as g, type MindooDBAppHostingMode as h, type MindooDBAppDatabase as i, type MindooDBAppDocument as j, type MindooDBAppRichTextSpan as k, type MindooDBAppRichTextSnapshot as l, MINDOODB_APP_DEFINITION_FILE_NAME as m, MINDOODB_APP_DEFINITION_FORMAT as n, MINDOODB_APP_DEFINITION_PERMISSIONS as o, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as p, MINDOODB_APP_DEFINITION_VERSION as q, MINDOODB_APP_SEAL_SIGNING_DOMAIN as r, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as s, type MindooDBAppAccessDecision as t, type MindooDBAppAccessTier as u, type MindooDBAppAttachmentApi as v, type MindooDBAppAttachmentChunk as w, type MindooDBAppAttachmentInfo as x, type MindooDBAppAttachmentPreviewOptions as y, type MindooDBAppAttachmentPreviewSession as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.47",
+  "version": "0.0.48",
   "engines": {
     "node": ">=22.13.0"
   },
@@ -41,11 +41,11 @@
     }
   },
   "dependencies": {
-    "mindoodb-view-language": "0.0.16"
+    "mindoodb-view-language": "0.0.18"
   },
   "peerDependencies": {
     "@automerge/automerge": "^3.3.2",
-    "mindoodb": ">=0.0.58"
+    "mindoodb": ">=0.0.64"
   },
   "peerDependenciesMeta": {
     "@automerge/automerge": {
@@ -57,7 +57,7 @@
   },
   "devDependencies": {
     "@automerge/automerge": "^3.3.2",
-    "mindoodb": "^0.0.58",
+    "mindoodb": "^0.0.64",
     "@types/node": "25.5.0",
     "jsdom": "^29.0.1",
     "tsup": "^8.5.1",