mindoodb-app-sdk 0.0.40 → 0.0.42

package/dist/chunk-LT4FK6LU.js

@@ -0,0 +1,146 @@
+// src/appBundleManifest.ts
+var MINDOODB_APP_BUNDLE_MANIFEST_FORMAT = "mindoodb.app.bundle";
+var MINDOODB_APP_BUNDLE_MANIFEST_VERSION = 1;
+var MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME = "haven-bundle.json";
+var MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME = "haven-bundle.zip";
+var SHA256_PATTERN = /^sha256-[0-9a-f]{64}$/;
+function isMindooDBAppBundleHash(value) {
+  return typeof value === "string" && SHA256_PATTERN.test(value);
+}
+function hasUnsafePathSegments(path) {
+  return path.split("/").some((segment) => segment === ".." || segment === "." || segment.length === 0);
+}
+function normalizeMindooDBAppBundlePath(rawPath) {
+  if (typeof rawPath !== "string") {
+    return null;
+  }
+  const normalized = rawPath.replace(/\\/g, "/").replace(/^\/+/, "").trim();
+  if (!normalized || hasUnsafePathSegments(normalized)) {
+    return null;
+  }
+  return normalized;
+}
+function buildMindooDBAppBundleContentHashInput(files) {
+  return [...files].map((file) => `${file.path}\0${file.hash}`).sort().join("\n");
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateSize(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function validateMindooDBAppBundleManifest(raw) {
+  const errors = [];
+  if (!isPlainObject(raw)) {
+    return { manifest: null, errors: ["Bundle manifest must be a JSON object."] };
+  }
+  if (raw.format !== MINDOODB_APP_BUNDLE_MANIFEST_FORMAT) {
+    errors.push(
+      `Bundle manifest format must be "${MINDOODB_APP_BUNDLE_MANIFEST_FORMAT}", received ${JSON.stringify(raw.format)}.`
+    );
+  }
+  if (raw.formatVersion !== MINDOODB_APP_BUNDLE_MANIFEST_VERSION) {
+    errors.push(
+      `Unsupported bundle manifest version ${JSON.stringify(raw.formatVersion)}, expected ${MINDOODB_APP_BUNDLE_MANIFEST_VERSION}.`
+    );
+  }
+  if (typeof raw.appId !== "string" || !raw.appId.trim()) {
+    errors.push("Bundle manifest is missing a non-empty appId.");
+  }
+  if (typeof raw.version !== "string" || !raw.version.trim()) {
+    errors.push("Bundle manifest is missing a non-empty version.");
+  }
+  if (!isMindooDBAppBundleHash(raw.contentHash)) {
+    errors.push("Bundle manifest contentHash must be a sha256-<hex> digest.");
+  }
+  if (typeof raw.generatedAt !== "string" || Number.isNaN(Date.parse(raw.generatedAt))) {
+    errors.push("Bundle manifest generatedAt must be an ISO timestamp.");
+  }
+  const archive = raw.archive;
+  if (!isPlainObject(archive)) {
+    errors.push("Bundle manifest is missing an archive descriptor.");
+  } else {
+    if (!normalizeMindooDBAppBundlePath(archive.path)) {
+      errors.push(`Bundle manifest archive path ${JSON.stringify(archive.path)} is not a safe relative path.`);
+    }
+    if (!isMindooDBAppBundleHash(archive.hash)) {
+      errors.push("Bundle manifest archive hash must be a sha256-<hex> digest.");
+    }
+    if (!validateSize(archive.size)) {
+      errors.push("Bundle manifest archive size must be a non-negative integer.");
+    }
+  }
+  const files = raw.files;
+  const normalizedFiles = [];
+  if (!Array.isArray(files) || files.length === 0) {
+    errors.push("Bundle manifest must list at least one file.");
+  } else {
+    const seen = /* @__PURE__ */ new Set();
+    files.forEach((file, index) => {
+      if (!isPlainObject(file)) {
+        errors.push(`Bundle manifest file #${index} must be an object.`);
+        return;
+      }
+      const path = normalizeMindooDBAppBundlePath(file.path);
+      if (!path) {
+        errors.push(`Bundle manifest file #${index} has an unsafe path ${JSON.stringify(file.path)}.`);
+        return;
+      }
+      if (seen.has(path)) {
+        errors.push(`Bundle manifest lists "${path}" more than once.`);
+        return;
+      }
+      if (!isMindooDBAppBundleHash(file.hash)) {
+        errors.push(`Bundle manifest file "${path}" must carry a sha256-<hex> digest.`);
+        return;
+      }
+      if (!validateSize(file.size)) {
+        errors.push(`Bundle manifest file "${path}" must carry a non-negative integer size.`);
+        return;
+      }
+      seen.add(path);
+      normalizedFiles.push({ path, hash: file.hash, size: file.size });
+    });
+  }
+  const entry = normalizeMindooDBAppBundlePath(raw.entry);
+  if (!entry) {
+    errors.push(`Bundle manifest entry ${JSON.stringify(raw.entry)} is not a safe relative path.`);
+  } else if (!entry.toLowerCase().endsWith(".html")) {
+    errors.push(`Bundle manifest entry "${entry}" must be an HTML file.`);
+  } else if (normalizedFiles.length && !normalizedFiles.some((file) => file.path === entry)) {
+    errors.push(`Bundle manifest entry "${entry}" is not part of the file list.`);
+  }
+  if (errors.length) {
+    return { manifest: null, errors };
+  }
+  const validated = raw;
+  return {
+    manifest: {
+      format: MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
+      formatVersion: MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
+      appId: validated.appId.trim(),
+      version: validated.version.trim(),
+      entry,
+      archive: {
+        path: normalizeMindooDBAppBundlePath(archive.path),
+        hash: archive.hash,
+        size: archive.size
+      },
+      contentHash: validated.contentHash,
+      generatedAt: validated.generatedAt,
+      files: normalizedFiles
+    },
+    errors: []
+  };
+}
+
+export {
+  MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
+  MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
+  MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
+  MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
+  isMindooDBAppBundleHash,
+  normalizeMindooDBAppBundlePath,
+  buildMindooDBAppBundleContentHashInput,
+  validateMindooDBAppBundleManifest
+};

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge, b as MindooDBAppDatabase, c as MindooDBAppDocument, d as MindooDBAppRichTextSpan, e as MindooDBAppRichTextSnapshot } from './types-DlZpHkfb.js';
-export { f as MINDOODB_APP_SEAL_SIGNING_DOMAIN, g as MindooDBAppAccessDecision, h as MindooDBAppAccessTier, i as MindooDBAppAttachmentApi, j as MindooDBAppAttachmentChunk, k as MindooDBAppAttachmentInfo, l as MindooDBAppAttachmentPreviewOptions, m as MindooDBAppAttachmentPreviewSession, n as MindooDBAppAutomergeChangesPatch, o as MindooDBAppAutomergeChangesSince, p as MindooDBAppAutomergeGetOptions, q as MindooDBAppAutomergePatchResult, r as MindooDBAppAutomergeSnapshot, s as MindooDBAppBridgeConnectMessage, t as MindooDBAppBridgeConnectOptions, u as MindooDBAppBridgeConnectedMessage, v as MindooDBAppBridgeErrorPayload, w as MindooDBAppBridgeHandshakeErrorMessage, x as MindooDBAppBridgeLocaleChangedMessage, y as MindooDBAppBridgePortMessage, z as MindooDBAppBridgeQueryResultMessage, A as MindooDBAppBridgeRpcError, B as MindooDBAppBridgeRpcMessage, C as MindooDBAppBridgeRpcRequest, D as MindooDBAppBridgeRpcSuccess, E as MindooDBAppBridgeStreamAbortRequest, F as MindooDBAppBridgeStreamAck, G as MindooDBAppBridgeStreamCloseRequest, H as MindooDBAppBridgeStreamError, I as MindooDBAppBridgeStreamMessage, J as MindooDBAppBridgeStreamOpenResult, K as MindooDBAppBridgeStreamReadRequest, L as MindooDBAppBridgeStreamWriteRequest, N as MindooDBAppBridgeThemeChangedMessage, O as MindooDBAppBridgeUiPreferencesChangedMessage, P as MindooDBAppBridgeViewChangedMessage, Q as MindooDBAppBridgeViewportChangedMessage, R as MindooDBAppCapability, S as MindooDBAppConfiguredViewCategorizationStyle, T as MindooDBAppConfiguredViewColumn, U as MindooDBAppConfiguredViewColumnRole, V as MindooDBAppConfiguredViewExpressionMode, W as MindooDBAppConfiguredViewFieldExpression, X as MindooDBAppConfiguredViewFilterDefinition, Y as MindooDBAppConfiguredViewFilterMode, Z as MindooDBAppConfiguredViewFilterRule, _ as MindooDBAppConfiguredViewFormulaExpression, $ as MindooDBAppConfiguredViewFormulaFilterDefinition, a0 as MindooDBAppConfiguredViewPreviewMode, a1 as MindooDBAppConfiguredViewRuleFilterDefinition, a2 as MindooDBAppConfiguredViewRuleMatchMode, a3 as MindooDBAppConfiguredViewRuleOperator, a4 as MindooDBAppConfiguredViewValueExpression, a5 as MindooDBAppCreateDocumentInput, a6 as MindooDBAppCreateKeyInfo, a7 as MindooDBAppCreateViewInput, a8 as MindooDBAppCreateViewNavigatorInput, a9 as MindooDBAppDatabaseInfo, aa as MindooDBAppDirectoryApi, ab as MindooDBAppDirectoryEntry, ac as MindooDBAppDocumentApi, ad as MindooDBAppDocumentHeadCursorResult, ae as MindooDBAppDocumentHistoryEntry, af as MindooDBAppDocumentListQuery, ag as MindooDBAppDocumentListResult, ah as MindooDBAppDocumentQuery, ai as MindooDBAppDocumentRevisionId, aj as MindooDBAppDocumentScanPreset, ak as MindooDBAppDocumentSummary, al as MindooDBAppEntryAttachmentRef, am as MindooDBAppEntryProvenance, an as MindooDBAppExtractDocumentTextInput, ao as MindooDBAppExtractDocumentTextResult, ap as MindooDBAppExtractTextFormat, aq as MindooDBAppExtractionSetup, ar as MindooDBAppFulltextSetup, as as MindooDBAppHistoricalDocument, at as MindooDBAppHistoryQuery, au as MindooDBAppHostTheme, av as MindooDBAppIdentityApi, aw as MindooDBAppInaccessibleDocument, ax as MindooDBAppInaccessibleDocumentListQuery, ay as MindooDBAppInaccessibleDocumentListResult, az as MindooDBAppJsonListDeletePatch, aA as MindooDBAppJsonListInsertPatch, aB as MindooDBAppJsonPatch, aC as MindooDBAppJsonSetPatch, aD as MindooDBAppJsonTextMarkPatch, aE as MindooDBAppJsonTextSplicePatch, aF as MindooDBAppJsonTextUnmarkPatch, aG as MindooDBAppJsonUnsetPatch, aH as MindooDBAppLaunchContext, aI as MindooDBAppLiveQuerySubscription, aJ as MindooDBAppMenuAnchor, aK as MindooDBAppMenuApi, aL as MindooDBAppMenuCommandItem, aM as MindooDBAppMenuDismissReason, aN as MindooDBAppMenuDismissedResult, aO as MindooDBAppMenuItem, aP as MindooDBAppMenuKind, aQ as MindooDBAppMenuPlacement, aR as MindooDBAppMenuPointAnchor, aS as MindooDBAppMenuRect, aT as MindooDBAppMenuRectAnchor, aU as MindooDBAppMenuSelectionResult, aV as MindooDBAppMenuSeparatorItem, aW as MindooDBAppQueryCoverage, aX as MindooDBAppQueryResult, aY as MindooDBAppQueryRow, aZ as MindooDBAppQuerySortKey, a_ as MindooDBAppQueryTextClause, a$ as MindooDBAppReadableAttachmentStream, b0 as MindooDBAppRecipientOptions, b1 as MindooDBAppResolvedViewDefinition, b2 as MindooDBAppResolvedViewSource, b3 as MindooDBAppRevisionPhase, b4 as MindooDBAppRevisionVerification, b5 as MindooDBAppRichTextBlockSpan, b6 as MindooDBAppRichTextGetOptions, b7 as MindooDBAppRichTextImmutableString, b8 as MindooDBAppRichTextMarkRange, b9 as MindooDBAppRichTextMaterializeValue, ba as MindooDBAppRichTextPatch, bb as MindooDBAppRichTextScalar, bc as MindooDBAppRichTextSpliceStep, bd as MindooDBAppRichTextStep, be as MindooDBAppRichTextStepPatch, bf as MindooDBAppRichTextTextSpan, bg as MindooDBAppRuntime, bh as MindooDBAppScanAttachmentOptions, bi as MindooDBAppScanAttachmentResult, bj as MindooDBAppScopedDocId, bk as MindooDBAppScopedDocumentSummary, bl as MindooDBAppSealIntent, bm as MindooDBAppSealedChannelOpenInput, bn as MindooDBAppSealedChannelOpenResult, bo as MindooDBAppSealedChannelRequestInput, bp as MindooDBAppSession, bq as MindooDBAppShowMenuInput, br as MindooDBAppShowMenuResult, bs as MindooDBAppSignPreview, bt as MindooDBAppSignPreviewScope, bu as MindooDBAppSignStatementInput, bv as MindooDBAppSignStatementResult, bw as MindooDBAppTextEdit, bx as MindooDBAppTextPatch, by as MindooDBAppThemeMode, bz as MindooDBAppTimestampApi, bA as MindooDBAppTimestampInput, bB as MindooDBAppTimestampProvider, bC as MindooDBAppTimestampResult, bD as MindooDBAppUiPreferences, bE as MindooDBAppUpdateDocumentInput, bF as MindooDBAppViewCursorDocumentListResult, bG as MindooDBAppViewCursorResult, bH as MindooDBAppViewEntry, bI as MindooDBAppViewEntryKind, bJ as MindooDBAppViewNavigator, bK as MindooDBAppViewNavigatorExpansionState, bL as MindooDBAppViewNavigatorOpenOptions, bM as MindooDBAppViewNavigatorPageOptions, bN as MindooDBAppViewNavigatorPageResult, bO as MindooDBAppViewNavigatorRangeQuery, bP as MindooDBAppViewNavigatorSelectionState, bQ as MindooDBAppViewUpdateStats, bR as MindooDBAppViewport, bS as MindooDBAppWritableAttachmentStream } from './types-DlZpHkfb.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge, b as MindooDBAppHostingMode, c as MindooDBAppDatabase, d as MindooDBAppDocument, e as MindooDBAppRichTextSpan, f as MindooDBAppRichTextSnapshot } from './types-DxnCg5IW.js';
+export { g as MINDOODB_APP_SEAL_SIGNING_DOMAIN, h as MindooDBAppAccessDecision, i as MindooDBAppAccessTier, j as MindooDBAppAttachmentApi, k as MindooDBAppAttachmentChunk, l as MindooDBAppAttachmentInfo, m as MindooDBAppAttachmentPreviewOptions, n as MindooDBAppAttachmentPreviewSession, o as MindooDBAppAutomergeChangesPatch, p as MindooDBAppAutomergeChangesSince, q as MindooDBAppAutomergeGetOptions, r as MindooDBAppAutomergePatchResult, s as MindooDBAppAutomergeSnapshot, t as MindooDBAppBridgeBeforeCloseAck, u as MindooDBAppBridgeBeforeCloseMessage, v as MindooDBAppBridgeConnectMessage, w as MindooDBAppBridgeConnectOptions, x as MindooDBAppBridgeConnectedMessage, y as MindooDBAppBridgeErrorPayload, z as MindooDBAppBridgeHandshakeErrorMessage, A as MindooDBAppBridgeLocaleChangedMessage, B as MindooDBAppBridgePortMessage, C as MindooDBAppBridgeQueryResultMessage, D as MindooDBAppBridgeRpcError, E as MindooDBAppBridgeRpcMessage, F as MindooDBAppBridgeRpcRequest, G as MindooDBAppBridgeRpcSuccess, H as MindooDBAppBridgeStreamAbortRequest, I as MindooDBAppBridgeStreamAck, J as MindooDBAppBridgeStreamCloseRequest, K as MindooDBAppBridgeStreamError, L as MindooDBAppBridgeStreamMessage, N as MindooDBAppBridgeStreamOpenResult, O as MindooDBAppBridgeStreamReadRequest, P as MindooDBAppBridgeStreamWriteRequest, Q as MindooDBAppBridgeThemeChangedMessage, R as MindooDBAppBridgeUiPreferencesChangedMessage, S as MindooDBAppBridgeViewChangedMessage, T as MindooDBAppBridgeViewportChangedMessage, U as MindooDBAppCapability, V as MindooDBAppConfiguredViewCategorizationStyle, W as MindooDBAppConfiguredViewColumn, X as MindooDBAppConfiguredViewColumnRole, Y as MindooDBAppConfiguredViewExpressionMode, Z as MindooDBAppConfiguredViewFieldExpression, _ as MindooDBAppConfiguredViewFilterDefinition, $ as MindooDBAppConfiguredViewFilterMode, a0 as MindooDBAppConfiguredViewFilterRule, a1 as MindooDBAppConfiguredViewFormulaExpression, a2 as MindooDBAppConfiguredViewFormulaFilterDefinition, a3 as MindooDBAppConfiguredViewPreviewMode, a4 as MindooDBAppConfiguredViewRuleFilterDefinition, a5 as MindooDBAppConfiguredViewRuleMatchMode, a6 as MindooDBAppConfiguredViewRuleOperator, a7 as MindooDBAppConfiguredViewValueExpression, a8 as MindooDBAppCreateDocumentInput, a9 as MindooDBAppCreateKeyInfo, aa as MindooDBAppCreateViewInput, ab as MindooDBAppCreateViewNavigatorInput, ac as MindooDBAppDatabaseInfo, ad as MindooDBAppDirectoryApi, ae as MindooDBAppDirectoryEntry, af as MindooDBAppDocumentApi, ag as MindooDBAppDocumentHeadCursorResult, ah as MindooDBAppDocumentHistoryEntry, ai as MindooDBAppDocumentListQuery, aj as MindooDBAppDocumentListResult, ak as MindooDBAppDocumentQuery, al as MindooDBAppDocumentRevisionId, am as MindooDBAppDocumentScanPreset, an as MindooDBAppDocumentSummary, ao as MindooDBAppEntryAttachmentRef, ap as MindooDBAppEntryProvenance, aq as MindooDBAppExtractDocumentTextInput, ar as MindooDBAppExtractDocumentTextResult, as as MindooDBAppExtractTextFormat, at as MindooDBAppExtractionSetup, au as MindooDBAppFulltextSetup, av as MindooDBAppHistoricalDocument, aw as MindooDBAppHistoryQuery, ax as MindooDBAppHostTheme, ay as MindooDBAppIdentityApi, az as MindooDBAppInaccessibleDocument, aA as MindooDBAppInaccessibleDocumentListQuery, aB as MindooDBAppInaccessibleDocumentListResult, aC as MindooDBAppJsonListDeletePatch, aD as MindooDBAppJsonListInsertPatch, aE as MindooDBAppJsonPatch, aF as MindooDBAppJsonSetPatch, aG as MindooDBAppJsonTextMarkPatch, aH as MindooDBAppJsonTextSplicePatch, aI as MindooDBAppJsonTextUnmarkPatch, aJ as MindooDBAppJsonUnsetPatch, aK as MindooDBAppLaunchContext, aL as MindooDBAppLiveQuerySubscription, aM as MindooDBAppMenuAnchor, aN as MindooDBAppMenuApi, aO as MindooDBAppMenuCommandItem, aP as MindooDBAppMenuDismissReason, aQ as MindooDBAppMenuDismissedResult, aR as MindooDBAppMenuItem, aS as MindooDBAppMenuKind, aT as MindooDBAppMenuPlacement, aU as MindooDBAppMenuPointAnchor, aV as MindooDBAppMenuRect, aW as MindooDBAppMenuRectAnchor, aX as MindooDBAppMenuSelectionResult, aY as MindooDBAppMenuSeparatorItem, aZ as MindooDBAppQueryCoverage, a_ as MindooDBAppQueryResult, a$ as MindooDBAppQueryRow, b0 as MindooDBAppQuerySortKey, b1 as MindooDBAppQueryTextClause, b2 as MindooDBAppReadableAttachmentStream, b3 as MindooDBAppRecipientOptions, b4 as MindooDBAppResolvedViewDefinition, b5 as MindooDBAppResolvedViewSource, b6 as MindooDBAppRevisionPhase, b7 as MindooDBAppRevisionVerification, b8 as MindooDBAppRichTextBlockSpan, b9 as MindooDBAppRichTextGetOptions, ba as MindooDBAppRichTextImmutableString, bb as MindooDBAppRichTextMarkRange, bc as MindooDBAppRichTextMaterializeValue, bd as MindooDBAppRichTextPatch, be as MindooDBAppRichTextScalar, bf as MindooDBAppRichTextSpliceStep, bg as MindooDBAppRichTextStep, bh as MindooDBAppRichTextStepPatch, bi as MindooDBAppRichTextTextSpan, bj as MindooDBAppRuntime, bk as MindooDBAppScanAttachmentOptions, bl as MindooDBAppScanAttachmentResult, bm as MindooDBAppScopedDocId, bn as MindooDBAppScopedDocumentSummary, bo as MindooDBAppSealIntent, bp as MindooDBAppSealedChannelOpenInput, bq as MindooDBAppSealedChannelOpenResult, br as MindooDBAppSealedChannelRequestInput, bs as MindooDBAppSession, bt as MindooDBAppShowMenuInput, bu as MindooDBAppShowMenuResult, bv as MindooDBAppSignPreview, bw as MindooDBAppSignPreviewScope, bx as MindooDBAppSignStatementInput, by as MindooDBAppSignStatementResult, bz as MindooDBAppStorageApi, bA as MindooDBAppTextEdit, bB as MindooDBAppTextPatch, bC as MindooDBAppThemeMode, bD as MindooDBAppTimestampApi, bE as MindooDBAppTimestampInput, bF as MindooDBAppTimestampProvider, bG as MindooDBAppTimestampResult, bH as MindooDBAppUiPreferences, bI as MindooDBAppUpdateDocumentInput, bJ as MindooDBAppViewCursorDocumentListResult, bK as MindooDBAppViewCursorResult, bL as MindooDBAppViewEntry, bM as MindooDBAppViewEntryKind, bN as MindooDBAppViewNavigator, bO as MindooDBAppViewNavigatorExpansionState, bP as MindooDBAppViewNavigatorOpenOptions, bQ as MindooDBAppViewNavigatorPageOptions, bR as MindooDBAppViewNavigatorPageResult, bS as MindooDBAppViewNavigatorRangeQuery, bT as MindooDBAppViewNavigatorSelectionState, bU as MindooDBAppViewUpdateStats, bV as MindooDBAppViewport, bW as MindooDBAppWritableAttachmentStream } from './types-DxnCg5IW.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';
 import { MindooDB, MindooQuerySortKey, MindooQueryOptions, MindooQueryResult } from 'mindoodb';
@@ -30,15 +31,102 @@ declare function abbreviateCanonicalName(value: string): string;
  */
 declare function expandAbbreviatedName(value: string): string;
 
+/**
+ * Drops memoised sessions so the next `connect()` performs a fresh handshake.
+ *
+ * A real app never needs this: its document dies together with the host. Test harnesses
+ * do, because they stand up several hosts under the same launch id inside one JavaScript
+ * realm, and a cached session would still point at the previous host's port.
+ *
+ * @param launchId Release only this launch. Omit to release all of them.
+ */
+declare function releaseMindooDBAppBridgeSessions(launchId?: string): void;
 /**
  * Creates the browser-side bridge entry point used by MindooDB apps.
  *
  * The returned object performs the initial postMessage handshake with the
  * Haven host and exposes a session with document, view, and attachment
  * APIs over a dedicated `MessagePort`.
+ *
+ * `connect()` is memoised per launch id: repeated calls resolve to the same session, and
+ * concurrent calls share a single in-flight handshake. The entry is released when the
+ * session disconnects or the handshake fails, so a later `connect()` can retry.
  */
 declare function createMindooDBAppBridge(): MindooDBAppBridge;
 
+/**
+ * Query parameter the host appends to the app URL so the app can tell how it is being
+ * delivered before any asynchronous work has happened.
+ */
+declare const MINDOODB_APP_HOSTING_QUERY_PARAM = "mindoodbAppHosting";
+/**
+ * Reads the hosting mode synchronously from the current URL.
+ *
+ * Boot-time decisions — registering a service worker, installing the storage shim —
+ * happen long before the bridge handshake completes, so they cannot wait for
+ * {@link MindooDBAppSession.getLaunchContext}. Unknown or missing values resolve to
+ * `"external"`, which is the behaviour every app had before hosted bundles existed.
+ *
+ * @param search Optional query string, defaults to `window.location.search`.
+ */
+declare function readMindooDBAppHostingMode(search?: string): MindooDBAppHostingMode;
+/**
+ * True when the app runs from a host-served bundle in an opaque origin.
+ *
+ * In that mode `localStorage`, `sessionStorage`, IndexedDB and
+ * `navigator.serviceWorker.register()` are unavailable — note that they *exist* on the
+ * global object and only throw when touched, so feature-detecting with `typeof` gives
+ * the wrong answer. Branch on this helper instead.
+ */
+declare function isHostedBundleRuntime(search?: string): boolean;
+
+interface InstallHavenStorageShimOptions {
+    /**
+     * Key prefixes whose values are written through to the host and restored on the next
+     * launch. Keys outside these prefixes stay in memory for the lifetime of the document.
+     */
+    persistPrefixes?: string[];
+    /** Give up waiting for the host and boot with empty storage. Defaults to 2000 ms. */
+    timeoutMs?: number;
+    /** Debounce window for write-through. Defaults to 200 ms. */
+    coalesceMs?: number;
+    /** Total budget for persisted keys, matching the host. Defaults to 256 KiB. */
+    quotaBytes?: number;
+    /** Largest single persisted value, matching the host. Defaults to 64 KiB. */
+    maxValueBytes?: number;
+    /** Also replace `sessionStorage` with an in-memory shim. Defaults to `true`. */
+    shimSessionStorage?: boolean;
+    /** Overrides the hosting mode detected from the URL. Intended for tests. */
+    hosting?: MindooDBAppHostingMode;
+    /** Overrides the bridge used to reach the host. Intended for tests. */
+    bridge?: MindooDBAppBridge;
+    /** Forwarded to `bridge.connect()` when the URL carries no launch id. */
+    launchId?: string;
+}
+interface HavenStorageShimHandle {
+    /** False when the app is not running hosted; nothing was replaced in that case. */
+    installed: boolean;
+    /** True once storage was hydrated from the host. False after a boot timeout. */
+    connected: boolean;
+    /** Writes out everything still pending. Resolves once the host has acknowledged. */
+    flush(): Promise<void>;
+    /** Restores the original globals. Pending writes are flushed first. */
+    uninstall(): Promise<void>;
+}
+/**
+ * Installs the storage shim when the app runs from a host-served bundle.
+ *
+ * Call this during boot, before any app module touches `localStorage`, and await it:
+ *
+ * ```ts
+ * await installHavenStorageShim({ persistPrefixes: ["my-app-"] });
+ * await import("./main");
+ * ```
+ *
+ * Outside hosted mode this is a no-op and the real `localStorage` stays in place.
+ */
+declare function installHavenStorageShim(options?: InstallHavenStorageShimOptions): Promise<HavenStorageShimHandle>;
+
 interface CreateMindooDBRichTextHandleOptions {
     database: MindooDBAppDatabase;
     document: MindooDBAppDocument;
@@ -186,4 +274,4 @@ declare function createMindooDBTextBuffer(options: CreateMindooDBTextBufferOptio
  */
 declare function queryDocuments(db: Pick<MindooDB, "query">, filter: MindooDBAppBooleanExpression | string, sortBy?: MindooQuerySortKey[], options?: MindooQueryOptions): Promise<MindooQueryResult>;
 
-export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, MindooDBAppDatabase, MindooDBAppDocument, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, abbreviateCanonicalName, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, queryDocuments };
+export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, MINDOODB_APP_HOSTING_QUERY_PARAM, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, MindooDBAppDatabase, MindooDBAppDocument, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, abbreviateCanonicalName, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, installHavenStorageShim, isHostedBundleRuntime, queryDocuments, readMindooDBAppHostingMode, releaseMindooDBAppBridgeSessions };