@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/workflows/container-contents/documentInfo.js

@@ -0,0 +1,306 @@
+import { bytesToBase64 } from "../../internal/encoding/index.js";
+import { exportFullHistorySnapshot } from "../../internal/loro/index.js";
+import { and, eq, isNull } from "drizzle-orm";
+import { DEFAULT_DOCUMENT_KIND } from "../../data/documents/documentConstants.js";
+import { summarizeDocumentContributors, } from "../../data/documents/editAttribution.js";
+import { reportAndRethrowKeyingVerificationError } from "../../data/keyingProjectionVerification/error.js";
+import { sqlDocumentsPersistence } from "../../data/persistence/documents/documentsPersistence.js";
+import { documentAttachmentBlobProjection, documentPendingAttachments, documentProjection, } from "../../data/sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime } from "../../data/sqlite/sqlitePersistenceRuntime.js";
+import { loadPersistedDocumentContent } from "../documents/historyContent.js";
+import { computeDocumentBlame } from "./documentCharacterBlame.js";
+import { computeFieldBlame } from "./documentFieldBlame.js";
+function readRecordString(value, key) {
+    if (!value || typeof value !== "object") {
+        return null;
+    }
+    const nextValue = Reflect.get(value, key);
+    return typeof nextValue === "string" && nextValue.length > 0
+        ? nextValue
+        : null;
+}
+function readRecordNumber(value, key) {
+    if (!value || typeof value !== "object") {
+        return null;
+    }
+    const nextValue = Reflect.get(value, key);
+    return typeof nextValue === "number" && Number.isFinite(nextValue)
+        ? nextValue
+        : null;
+}
+function readRecordArrayLength(value, key) {
+    if (!value || typeof value !== "object") {
+        return null;
+    }
+    const nextValue = Reflect.get(value, key);
+    return Array.isArray(nextValue) ? nextValue.length : null;
+}
+function readStoredManifestHash(value) {
+    if (!value) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        return readRecordString(parsed, "manifestHash");
+    }
+    catch {
+        return null;
+    }
+}
+function mapPendingAttachmentRow(row) {
+    return {
+        attachmentKind: "pending",
+        blobId: null,
+        byteLength: row.byteLength,
+        createdAt: row.createdAt,
+        localId: row.localId,
+        mimeType: row.mimeType,
+        name: row.name,
+        slotId: row.slotId,
+        storageKey: row.storageKey,
+        updatedAt: null,
+    };
+}
+function mapLocalAttachmentRow(row) {
+    return {
+        attachmentKind: "local",
+        blobId: row.blobId,
+        byteLength: row.byteLength,
+        createdAt: null,
+        localId: row.localId,
+        mimeType: row.mimeType,
+        name: null,
+        slotId: row.slotId,
+        storageKey: row.storageKey,
+        updatedAt: row.updatedAt,
+    };
+}
+async function loadDocumentInfoAttachments(input) {
+    const { db } = getClientSQLitePersistenceRuntime(input.execSql);
+    const [pendingRows, localRows] = await Promise.all([
+        db
+            .select({
+            byteLength: documentPendingAttachments.byteLength,
+            createdAt: documentPendingAttachments.createdAt,
+            localId: documentPendingAttachments.localId,
+            mimeType: documentPendingAttachments.mimeType,
+            name: documentPendingAttachments.name,
+            slotId: documentPendingAttachments.slotId,
+            storageKey: documentPendingAttachments.storageKey,
+        })
+            .from(documentPendingAttachments)
+            .where(eq(documentPendingAttachments.localId, input.localId))
+            .orderBy(documentPendingAttachments.createdAt, documentPendingAttachments.slotId),
+        db
+            .select({
+            blobId: documentAttachmentBlobProjection.blobId,
+            byteLength: documentAttachmentBlobProjection.byteLength,
+            localId: documentAttachmentBlobProjection.localId,
+            mimeType: documentAttachmentBlobProjection.mimeType,
+            slotId: documentAttachmentBlobProjection.slotId,
+            storageKey: documentAttachmentBlobProjection.storageKey,
+            updatedAt: documentAttachmentBlobProjection.updatedAt,
+        })
+            .from(documentAttachmentBlobProjection)
+            .where(and(eq(documentAttachmentBlobProjection.localId, input.localId), 
+        // Unlinked slots keep their row as a pending-detach marker; the
+        // document no longer has the attachment, so do not report it.
+        isNull(documentAttachmentBlobProjection.detachedAt)))
+            .orderBy(documentAttachmentBlobProjection.updatedAt, documentAttachmentBlobProjection.slotId),
+    ]);
+    return [
+        ...pendingRows.map(mapPendingAttachmentRow),
+        ...localRows.map(mapLocalAttachmentRow),
+    ];
+}
+async function loadLocalDocumentInfo(input) {
+    const fallback = {
+        attachments: [],
+        contentSnapshot: null,
+        local: {
+            accessEpoch: null,
+            accessStateHash: null,
+            containerId: null,
+            documentId: null,
+            documentKind: null,
+            hasContentKeyBundle: false,
+            hasDocumentKekTargets: false,
+            hasDocumentManifestBundle: false,
+            lastCommitLsn: null,
+            localDocumentManifestHash: null,
+            localId: input.localId,
+            pendingAttachmentByteLength: 0,
+            pendingAttachmentCount: 0,
+            pendingUpdateCount: 0,
+            title: null,
+            updatedAt: null,
+        },
+    };
+    if (!input.execSql) {
+        return fallback;
+    }
+    await sqlDocumentsPersistence.ensureSchema(input.execSql);
+    const { db } = getClientSQLitePersistenceRuntime(input.execSql);
+    const [document, pendingUpdates, attachments, projectionRows, contentDoc] = await Promise.all([
+        sqlDocumentsPersistence.loadDocument(input.execSql, input.localId),
+        sqlDocumentsPersistence.listPendingUpdates(input.execSql, input.localId),
+        loadDocumentInfoAttachments({
+            execSql: input.execSql,
+            localId: input.localId,
+        }),
+        db
+            .select({ updatedAt: documentProjection.updatedAt })
+            .from(documentProjection)
+            .where(eq(documentProjection.localId, input.localId))
+            .limit(1),
+        loadPersistedDocumentContent({
+            execSql: input.execSql,
+            localId: input.localId,
+            persistence: sqlDocumentsPersistence,
+        }).catch(() => null),
+    ]);
+    if (!document) {
+        return fallback;
+    }
+    const pendingAttachments = attachments.filter((attachment) => attachment.attachmentKind === "pending");
+    return {
+        attachments,
+        // Blame reads op-level provenance out of a serialized snapshot; export the
+        // durable-history content for it. Degrades to null (blame unavailable)
+        // rather than failing the Info panel.
+        contentSnapshot: contentDoc
+            ? bytesToBase64(exportFullHistorySnapshot(contentDoc))
+            : null,
+        local: {
+            accessEpoch: document.accessEpoch,
+            accessStateHash: document.accessStateHash ?? null,
+            containerId: document.containerId,
+            documentId: document.documentId,
+            documentKind: document.documentKind ?? DEFAULT_DOCUMENT_KIND,
+            hasContentKeyBundle: Boolean(document.contentKeyBundle),
+            hasDocumentKekTargets: Boolean(document.documentKekTargets),
+            hasDocumentManifestBundle: Boolean(document.documentManifestBundle),
+            lastCommitLsn: document.lastCommitLsn ?? null,
+            localDocumentManifestHash: readStoredManifestHash(document.documentManifestBundle),
+            localId: document.id,
+            pendingAttachmentByteLength: pendingAttachments.reduce((total, attachment) => total + attachment.byteLength, 0),
+            pendingAttachmentCount: pendingAttachments.length,
+            pendingUpdateCount: pendingUpdates.length,
+            title: document.title ?? null,
+            updatedAt: projectionRows[0]?.updatedAt ?? null,
+        },
+    };
+}
+function shouldLoadRemoteDocumentInfo(input) {
+    return input.remoteInfoMode !== "never" && Boolean(input.local.documentId);
+}
+function mapAttachmentBinding(binding) {
+    return {
+        bindingId: binding.bindingId,
+        blobId: binding.blobId,
+        slotId: binding.slotId,
+    };
+}
+function mapAuthorizingContainerPath(projection) {
+    const leafBundle = projection.path.at(-1);
+    const leafKek = projection.containerKeks.at(-1);
+    return {
+        containerId: projection.containerId,
+        containerKeyEpoch: leafKek?.containerKeyEpoch ?? null,
+        containerKeyEpochId: leafKek?.containerKeyEpochId ?? null,
+        leafManifestHash: leafBundle?.manifestHash ?? null,
+        organizationId: projection.organizationId,
+        pathLength: projection.path.length,
+    };
+}
+function getDocumentInfoRemoteDetails(input) {
+    const { attachmentBindings, attribution, blameRanges, characterBlame, contributors, fieldBlame, projection, } = input;
+    const manifestState = projection.documentManifest.state;
+    const manifest = projection.documentManifest.manifest;
+    return {
+        activeAttachmentBindings: attachmentBindings.map(mapAttachmentBinding),
+        attributionRevision: attribution?.attributionRevision ?? null,
+        attributionStatus: attribution
+            ? attribution.truncated
+                ? "truncated"
+                : "available"
+            : "unavailable",
+        attributionSegments: attribution?.segments ?? [],
+        authorizingContainerPaths: projection.authorizingContainerPaths.map(mapAuthorizingContainerPath),
+        blameRanges,
+        characterBlame,
+        fieldBlame,
+        contentKeyEpoch: projection.contentKeyBundle.contentKeyEpoch,
+        contentKeyTargetCount: projection.contentKeyBundle.targets.length,
+        contentKeyTargetHash: projection.contentKeyBundle.targetHash,
+        contributors,
+        currentManifestHash: projection.documentManifest.manifestHash,
+        documentContainerManifestHistoryCount: projection.documentContainerManifestHistory.length,
+        documentKekTargetCount: projection.documentKekTargets.targets.length,
+        documentKeyTargetHash: projection.documentKekTargets.documentKeyTargetHash,
+        documentManifestContainerPathCount: projection.documentManifestContainerPaths.length,
+        documentManifestHistoryCount: projection.documentManifestHistory.length,
+        linkedContainerKeyEpochCount: projection.documentKekTargets.linkedContainerKeyEpochIds.length,
+        linkedContainerManifestCount: projection.documentKekTargets.linkedContainerManifestHashes.length,
+        linkSetManifestHash: projection.documentKekTargets.linkSetManifestHash,
+        manifestEpoch: readRecordNumber(manifest, "epoch"),
+        previousManifestHash: readRecordString(manifestState, "previousManifestHash"),
+        referencedPrincipalCount: readRecordArrayLength(manifest, "referencedPrincipalHeads"),
+    };
+}
+export async function loadDocumentInfo(input) {
+    const { attachments, contentSnapshot, local } = await loadLocalDocumentInfo({
+        execSql: input.execSql ?? null,
+        localId: input.localId,
+    });
+    if (!shouldLoadRemoteDocumentInfo({
+        local,
+        remoteInfoMode: input.remoteInfoMode ?? "if-synced",
+    }) ||
+        !local.documentId) {
+        return { attachments, local, remoteInfo: null };
+    }
+    const attributionPromise = input.apiClient
+        .getDocumentEditAttribution(local.documentId, input.attributionRequestKey)
+        .catch(async (error) => {
+        await reportAndRethrowKeyingVerificationError(error, input.reportSecurityIncident, {
+            objectId: local.documentId ?? input.localId,
+            objectKind: "document",
+            operation: "document.info.attribution",
+        });
+        return null;
+    });
+    const [projection, attachmentBindings, attribution] = await Promise.all([
+        input.apiClient.getDocumentWriterProjection(local.documentId),
+        input.apiClient.listDocumentAttachments(local.documentId),
+        // Attribution is supplementary: a rejection (network/server) must not block
+        // the rest of the document-info load, so swallow it to null (no contributors).
+        attributionPromise,
+    ]);
+    if (!projection) {
+        throw new Error(`Document info projection was unavailable for local document ${input.localId} with remote document ${local.documentId}.`);
+    }
+    const attributionComplete = attribution && !attribution.truncated;
+    const attributionSegments = attribution?.segments ?? [];
+    const blame = attributionComplete
+        ? computeDocumentBlame(contentSnapshot, attributionSegments)
+        : null;
+    return {
+        attachments,
+        local,
+        remoteInfo: getDocumentInfoRemoteDetails({
+            attachmentBindings: attachmentBindings ?? [],
+            attribution,
+            blameRanges: blame?.blameRanges ?? null,
+            characterBlame: blame?.characterBlame ?? null,
+            contributors: attributionComplete
+                ? summarizeDocumentContributors(attributionSegments)
+                : [],
+            fieldBlame: attributionComplete
+                ? computeFieldBlame(contentSnapshot, attributionSegments)
+                : null,
+            projection,
+        }),
+    };
+}
+//# sourceMappingURL=documentInfo.js.map

package/workflows/container-contents/documentInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentInfo.js","sourceRoot":"","sources":["documentInfo.ts"],"names":[],"mappings":"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","sourcesContent":["import { bytesToBase64 } from \"@tearleads/encoding\";\nimport { exportFullHistorySnapshot } from \"@tearleads/loro\";\nimport type {\n  BlobAttachmentSummary,\n  ContainerKeyingPathResponse,\n  DocumentEditAttributionResponse,\n  DocumentWriterProjectionResponse,\n  ListDocumentAttachmentsResponse,\n} from \"@tearleads/validators/response\";\nimport { and, eq, isNull } from \"drizzle-orm\";\nimport { DEFAULT_DOCUMENT_KIND } from \"../../data/documents/documentConstants\";\nimport {\n  type DocumentBlameRange,\n  type DocumentCharacterBlameSummary,\n  type DocumentContributor,\n  type DocumentFieldBlame,\n  summarizeDocumentContributors,\n} from \"../../data/documents/editAttribution\";\nimport { reportAndRethrowKeyingVerificationError } from \"../../data/keyingProjectionVerification/error\";\nimport { sqlDocumentsPersistence } from \"../../data/persistence/documents/documentsPersistence\";\nimport type { SecurityIncidentReporter } from \"../../data/securityIncidents\";\nimport {\n  documentAttachmentBlobProjection,\n  documentPendingAttachments,\n  documentProjection,\n} from \"../../data/sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../data/sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../data/sqlite/sqlSchema\";\nimport { loadPersistedDocumentContent } from \"../documents/historyContent\";\nimport { computeDocumentBlame } from \"./documentCharacterBlame\";\nimport { computeFieldBlame } from \"./documentFieldBlame\";\nimport type {\n  DocumentInfo,\n  DocumentInfoAttachment,\n  DocumentInfoAuthorizingContainerPath,\n  DocumentInfoLocalDetails,\n  DocumentInfoRemoteAttachmentBinding,\n  DocumentInfoRemoteDetails,\n  DocumentInfoRemoteMode,\n} from \"./documentInfoTypes\";\n\nexport type {\n  DocumentInfo,\n  DocumentInfoAttachment,\n  DocumentInfoAuthorizingContainerPath,\n  DocumentInfoLocalDetails,\n  DocumentInfoRemoteAttachmentBinding,\n  DocumentInfoRemoteDetails,\n  DocumentInfoRemoteMode,\n} from \"./documentInfoTypes\";\n\ninterface DocumentInfoApi {\n  getDocumentEditAttribution: (\n    documentId: string,\n    requestKey?: string,\n  ) => Promise<DocumentEditAttributionResponse | null>;\n  getDocumentWriterProjection: (\n    documentId: string,\n  ) => Promise<DocumentWriterProjectionResponse | null>;\n  listDocumentAttachments: (\n    documentId: string,\n  ) => Promise<ListDocumentAttachmentsResponse | null>;\n}\n\ninterface PendingAttachmentInfoRow {\n  byteLength: number;\n  createdAt: string;\n  localId: string;\n  mimeType: string | null;\n  name: string;\n  slotId: string;\n  storageKey: string;\n}\n\ninterface LocalAttachmentInfoRow {\n  blobId: string | null;\n  byteLength: number;\n  localId: string;\n  mimeType: string | null;\n  slotId: string;\n  storageKey: string;\n  updatedAt: string;\n}\n\nfunction readRecordString(value: unknown, key: string): string | null {\n  if (!value || typeof value !== \"object\") {\n    return null;\n  }\n\n  const nextValue = Reflect.get(value, key);\n  return typeof nextValue === \"string\" && nextValue.length > 0\n    ? nextValue\n    : null;\n}\n\nfunction readRecordNumber(value: unknown, key: string): number | null {\n  if (!value || typeof value !== \"object\") {\n    return null;\n  }\n\n  const nextValue = Reflect.get(value, key);\n  return typeof nextValue === \"number\" && Number.isFinite(nextValue)\n    ? nextValue\n    : null;\n}\n\nfunction readRecordArrayLength(value: unknown, key: string): number | null {\n  if (!value || typeof value !== \"object\") {\n    return null;\n  }\n\n  const nextValue = Reflect.get(value, key);\n  return Array.isArray(nextValue) ? nextValue.length : null;\n}\n\nfunction readStoredManifestHash(\n  value: string | null | undefined,\n): string | null {\n  if (!value) {\n    return null;\n  }\n\n  try {\n    const parsed: unknown = JSON.parse(value);\n    return readRecordString(parsed, \"manifestHash\");\n  } catch {\n    return null;\n  }\n}\n\nfunction mapPendingAttachmentRow(\n  row: PendingAttachmentInfoRow,\n): DocumentInfoAttachment {\n  return {\n    attachmentKind: \"pending\",\n    blobId: null,\n    byteLength: row.byteLength,\n    createdAt: row.createdAt,\n    localId: row.localId,\n    mimeType: row.mimeType,\n    name: row.name,\n    slotId: row.slotId,\n    storageKey: row.storageKey,\n    updatedAt: null,\n  };\n}\n\nfunction mapLocalAttachmentRow(\n  row: LocalAttachmentInfoRow,\n): DocumentInfoAttachment {\n  return {\n    attachmentKind: \"local\",\n    blobId: row.blobId,\n    byteLength: row.byteLength,\n    createdAt: null,\n    localId: row.localId,\n    mimeType: row.mimeType,\n    name: null,\n    slotId: row.slotId,\n    storageKey: row.storageKey,\n    updatedAt: row.updatedAt,\n  };\n}\n\nasync function loadDocumentInfoAttachments(input: {\n  execSql: ExecSql;\n  localId: string;\n}): Promise<DocumentInfoAttachment[]> {\n  const { db } = getClientSQLitePersistenceRuntime(input.execSql);\n  const [pendingRows, localRows] = await Promise.all([\n    db\n      .select({\n        byteLength: documentPendingAttachments.byteLength,\n        createdAt: documentPendingAttachments.createdAt,\n        localId: documentPendingAttachments.localId,\n        mimeType: documentPendingAttachments.mimeType,\n        name: documentPendingAttachments.name,\n        slotId: documentPendingAttachments.slotId,\n        storageKey: documentPendingAttachments.storageKey,\n      })\n      .from(documentPendingAttachments)\n      .where(eq(documentPendingAttachments.localId, input.localId))\n      .orderBy(\n        documentPendingAttachments.createdAt,\n        documentPendingAttachments.slotId,\n      ),\n    db\n      .select({\n        blobId: documentAttachmentBlobProjection.blobId,\n        byteLength: documentAttachmentBlobProjection.byteLength,\n        localId: documentAttachmentBlobProjection.localId,\n        mimeType: documentAttachmentBlobProjection.mimeType,\n        slotId: documentAttachmentBlobProjection.slotId,\n        storageKey: documentAttachmentBlobProjection.storageKey,\n        updatedAt: documentAttachmentBlobProjection.updatedAt,\n      })\n      .from(documentAttachmentBlobProjection)\n      .where(\n        and(\n          eq(documentAttachmentBlobProjection.localId, input.localId),\n          // Unlinked slots keep their row as a pending-detach marker; the\n          // document no longer has the attachment, so do not report it.\n          isNull(documentAttachmentBlobProjection.detachedAt),\n        ),\n      )\n      .orderBy(\n        documentAttachmentBlobProjection.updatedAt,\n        documentAttachmentBlobProjection.slotId,\n      ),\n  ]);\n\n  return [\n    ...pendingRows.map(mapPendingAttachmentRow),\n    ...localRows.map(mapLocalAttachmentRow),\n  ];\n}\n\nasync function loadLocalDocumentInfo(input: {\n  execSql: ExecSql | null;\n  localId: string;\n}): Promise<{\n  attachments: DocumentInfoAttachment[];\n  contentSnapshot: string | null;\n  local: DocumentInfoLocalDetails;\n}> {\n  const fallback = {\n    attachments: [],\n    contentSnapshot: null,\n    local: {\n      accessEpoch: null,\n      accessStateHash: null,\n      containerId: null,\n      documentId: null,\n      documentKind: null,\n      hasContentKeyBundle: false,\n      hasDocumentKekTargets: false,\n      hasDocumentManifestBundle: false,\n      lastCommitLsn: null,\n      localDocumentManifestHash: null,\n      localId: input.localId,\n      pendingAttachmentByteLength: 0,\n      pendingAttachmentCount: 0,\n      pendingUpdateCount: 0,\n      title: null,\n      updatedAt: null,\n    },\n  };\n\n  if (!input.execSql) {\n    return fallback;\n  }\n\n  await sqlDocumentsPersistence.ensureSchema(input.execSql);\n  const { db } = getClientSQLitePersistenceRuntime(input.execSql);\n  const [document, pendingUpdates, attachments, projectionRows, contentDoc] =\n    await Promise.all([\n      sqlDocumentsPersistence.loadDocument(input.execSql, input.localId),\n      sqlDocumentsPersistence.listPendingUpdates(input.execSql, input.localId),\n      loadDocumentInfoAttachments({\n        execSql: input.execSql,\n        localId: input.localId,\n      }),\n      db\n        .select({ updatedAt: documentProjection.updatedAt })\n        .from(documentProjection)\n        .where(eq(documentProjection.localId, input.localId))\n        .limit(1),\n      loadPersistedDocumentContent({\n        execSql: input.execSql,\n        localId: input.localId,\n        persistence: sqlDocumentsPersistence,\n      }).catch(() => null),\n    ]);\n\n  if (!document) {\n    return fallback;\n  }\n\n  const pendingAttachments = attachments.filter(\n    (attachment) => attachment.attachmentKind === \"pending\",\n  );\n\n  return {\n    attachments,\n    // Blame reads op-level provenance out of a serialized snapshot; export the\n    // durable-history content for it. Degrades to null (blame unavailable)\n    // rather than failing the Info panel.\n    contentSnapshot: contentDoc\n      ? bytesToBase64(exportFullHistorySnapshot(contentDoc))\n      : null,\n    local: {\n      accessEpoch: document.accessEpoch,\n      accessStateHash: document.accessStateHash ?? null,\n      containerId: document.containerId,\n      documentId: document.documentId,\n      documentKind: document.documentKind ?? DEFAULT_DOCUMENT_KIND,\n      hasContentKeyBundle: Boolean(document.contentKeyBundle),\n      hasDocumentKekTargets: Boolean(document.documentKekTargets),\n      hasDocumentManifestBundle: Boolean(document.documentManifestBundle),\n      lastCommitLsn: document.lastCommitLsn ?? null,\n      localDocumentManifestHash: readStoredManifestHash(\n        document.documentManifestBundle,\n      ),\n      localId: document.id,\n      pendingAttachmentByteLength: pendingAttachments.reduce(\n        (total, attachment) => total + attachment.byteLength,\n        0,\n      ),\n      pendingAttachmentCount: pendingAttachments.length,\n      pendingUpdateCount: pendingUpdates.length,\n      title: document.title ?? null,\n      updatedAt: projectionRows[0]?.updatedAt ?? null,\n    },\n  };\n}\n\nfunction shouldLoadRemoteDocumentInfo(input: {\n  local: DocumentInfoLocalDetails;\n  remoteInfoMode: DocumentInfoRemoteMode;\n}): boolean {\n  return input.remoteInfoMode !== \"never\" && Boolean(input.local.documentId);\n}\n\nfunction mapAttachmentBinding(\n  binding: BlobAttachmentSummary,\n): DocumentInfoRemoteAttachmentBinding {\n  return {\n    bindingId: binding.bindingId,\n    blobId: binding.blobId,\n    slotId: binding.slotId,\n  };\n}\n\nfunction mapAuthorizingContainerPath(\n  projection: ContainerKeyingPathResponse,\n): DocumentInfoAuthorizingContainerPath {\n  const leafBundle = projection.path.at(-1);\n  const leafKek = projection.containerKeks.at(-1);\n\n  return {\n    containerId: projection.containerId,\n    containerKeyEpoch: leafKek?.containerKeyEpoch ?? null,\n    containerKeyEpochId: leafKek?.containerKeyEpochId ?? null,\n    leafManifestHash: leafBundle?.manifestHash ?? null,\n    organizationId: projection.organizationId,\n    pathLength: projection.path.length,\n  };\n}\n\nfunction getDocumentInfoRemoteDetails(input: {\n  attachmentBindings: ReadonlyArray<BlobAttachmentSummary>;\n  attribution: DocumentEditAttributionResponse | null;\n  blameRanges: DocumentBlameRange[] | null;\n  characterBlame: DocumentCharacterBlameSummary | null;\n  contributors: DocumentContributor[];\n  fieldBlame: DocumentFieldBlame[] | null;\n  projection: DocumentWriterProjectionResponse;\n}): DocumentInfoRemoteDetails {\n  const {\n    attachmentBindings,\n    attribution,\n    blameRanges,\n    characterBlame,\n    contributors,\n    fieldBlame,\n    projection,\n  } = input;\n  const manifestState = projection.documentManifest.state;\n  const manifest = projection.documentManifest.manifest;\n\n  return {\n    activeAttachmentBindings: attachmentBindings.map(mapAttachmentBinding),\n    attributionRevision: attribution?.attributionRevision ?? null,\n    attributionStatus: attribution\n      ? attribution.truncated\n        ? \"truncated\"\n        : \"available\"\n      : \"unavailable\",\n    attributionSegments: attribution?.segments ?? [],\n    authorizingContainerPaths: projection.authorizingContainerPaths.map(\n      mapAuthorizingContainerPath,\n    ),\n    blameRanges,\n    characterBlame,\n    fieldBlame,\n    contentKeyEpoch: projection.contentKeyBundle.contentKeyEpoch,\n    contentKeyTargetCount: projection.contentKeyBundle.targets.length,\n    contentKeyTargetHash: projection.contentKeyBundle.targetHash,\n    contributors,\n    currentManifestHash: projection.documentManifest.manifestHash,\n    documentContainerManifestHistoryCount:\n      projection.documentContainerManifestHistory.length,\n    documentKekTargetCount: projection.documentKekTargets.targets.length,\n    documentKeyTargetHash: projection.documentKekTargets.documentKeyTargetHash,\n    documentManifestContainerPathCount:\n      projection.documentManifestContainerPaths.length,\n    documentManifestHistoryCount: projection.documentManifestHistory.length,\n    linkedContainerKeyEpochCount:\n      projection.documentKekTargets.linkedContainerKeyEpochIds.length,\n    linkedContainerManifestCount:\n      projection.documentKekTargets.linkedContainerManifestHashes.length,\n    linkSetManifestHash: projection.documentKekTargets.linkSetManifestHash,\n    manifestEpoch: readRecordNumber(manifest, \"epoch\"),\n    previousManifestHash: readRecordString(\n      manifestState,\n      \"previousManifestHash\",\n    ),\n    referencedPrincipalCount: readRecordArrayLength(\n      manifest,\n      \"referencedPrincipalHeads\",\n    ),\n  };\n}\n\nexport async function loadDocumentInfo(input: {\n  apiClient: DocumentInfoApi;\n  attributionRequestKey?: string | undefined;\n  execSql?: ExecSql | null;\n  localId: string;\n  reportSecurityIncident: SecurityIncidentReporter;\n  remoteInfoMode?: DocumentInfoRemoteMode | undefined;\n}): Promise<DocumentInfo> {\n  const { attachments, contentSnapshot, local } = await loadLocalDocumentInfo({\n    execSql: input.execSql ?? null,\n    localId: input.localId,\n  });\n\n  if (\n    !shouldLoadRemoteDocumentInfo({\n      local,\n      remoteInfoMode: input.remoteInfoMode ?? \"if-synced\",\n    }) ||\n    !local.documentId\n  ) {\n    return { attachments, local, remoteInfo: null };\n  }\n\n  const attributionPromise = input.apiClient\n    .getDocumentEditAttribution(local.documentId, input.attributionRequestKey)\n    .catch(async (error: unknown) => {\n      await reportAndRethrowKeyingVerificationError(\n        error,\n        input.reportSecurityIncident,\n        {\n          objectId: local.documentId ?? input.localId,\n          objectKind: \"document\",\n          operation: \"document.info.attribution\",\n        },\n      );\n      return null;\n    });\n  const [projection, attachmentBindings, attribution] = await Promise.all([\n    input.apiClient.getDocumentWriterProjection(local.documentId),\n    input.apiClient.listDocumentAttachments(local.documentId),\n    // Attribution is supplementary: a rejection (network/server) must not block\n    // the rest of the document-info load, so swallow it to null (no contributors).\n    attributionPromise,\n  ]);\n\n  if (!projection) {\n    throw new Error(\n      `Document info projection was unavailable for local document ${input.localId} with remote document ${local.documentId}.`,\n    );\n  }\n\n  const attributionComplete = attribution && !attribution.truncated;\n  const attributionSegments = attribution?.segments ?? [];\n  const blame = attributionComplete\n    ? computeDocumentBlame(contentSnapshot, attributionSegments)\n    : null;\n  return {\n    attachments,\n    local,\n    remoteInfo: getDocumentInfoRemoteDetails({\n      attachmentBindings: attachmentBindings ?? [],\n      attribution,\n      blameRanges: blame?.blameRanges ?? null,\n      characterBlame: blame?.characterBlame ?? null,\n      contributors: attributionComplete\n        ? summarizeDocumentContributors(attributionSegments)\n        : [],\n      fieldBlame: attributionComplete\n        ? computeFieldBlame(contentSnapshot, attributionSegments)\n        : null,\n      projection,\n    }),\n  };\n}\n"]}

package/workflows/container-contents/documentInfoTypes.d.ts

@@ -0,0 +1,92 @@
+import type { DocumentEditAttributionResponse } from "../../internal/validators/response/index.js";
+import type { StoredDocumentKind } from "../../data/documents/documentKinds.js";
+import type { DocumentBlameRange, DocumentCharacterBlameSummary, DocumentContributor, DocumentFieldBlame } from "../../data/documents/editAttribution.js";
+export type DocumentInfoRemoteMode = "if-synced" | "never";
+export interface DocumentInfoLocalDetails {
+    accessEpoch: number | null;
+    accessStateHash: string | null;
+    containerId: string | null;
+    documentId: string | null;
+    documentKind: StoredDocumentKind | null;
+    hasContentKeyBundle: boolean;
+    hasDocumentKekTargets: boolean;
+    hasDocumentManifestBundle: boolean;
+    lastCommitLsn: string | null;
+    localDocumentManifestHash: string | null;
+    localId: string;
+    pendingAttachmentByteLength: number;
+    pendingAttachmentCount: number;
+    pendingUpdateCount: number;
+    title: string | null;
+    updatedAt: string | null;
+}
+export interface DocumentInfoAttachment {
+    attachmentKind: "local" | "pending";
+    blobId: string | null;
+    byteLength: number;
+    createdAt: string | null;
+    localId: string;
+    mimeType: string | null;
+    name: string | null;
+    slotId: string;
+    storageKey: string;
+    updatedAt: string | null;
+}
+export interface DocumentInfoRemoteAttachmentBinding {
+    bindingId: string;
+    blobId: string;
+    slotId: string;
+}
+export interface DocumentInfoAuthorizingContainerPath {
+    containerId: string;
+    containerKeyEpoch: number | null;
+    containerKeyEpochId: string | null;
+    leafManifestHash: string | null;
+    organizationId: string;
+    pathLength: number;
+}
+export interface DocumentInfoRemoteDetails {
+    activeAttachmentBindings: DocumentInfoRemoteAttachmentBinding[];
+    attributionRevision: number | null;
+    attributionStatus: "available" | "truncated" | "unavailable";
+    attributionSegments: DocumentEditAttributionResponse["segments"];
+    authorizingContainerPaths: DocumentInfoAuthorizingContainerPath[];
+    /**
+     * Contiguous per-writer runs of the current prose — the read-only "blame"
+     * view that tints each phrase by who wrote it. Shares its `null` conditions
+     * (and its single snapshot reconstruction) with {@link characterBlame}.
+     */
+    blameRanges: DocumentBlameRange[] | null;
+    /**
+     * Per-writer live-character blame, or `null` when it could not be computed —
+     * the document has no local snapshot, the snapshot is too large to extract
+     * op ids from cheaply, or the snapshot was unreadable.
+     */
+    characterBlame: DocumentCharacterBlameSummary | null;
+    /**
+     * Per-field blame for a structured document (who last set each field), or
+     * `null` when it could not be computed. A note yields `[]` (no fields).
+     */
+    fieldBlame: DocumentFieldBlame[] | null;
+    contentKeyEpoch: number;
+    contentKeyTargetCount: number;
+    contentKeyTargetHash: string;
+    contributors: DocumentContributor[];
+    currentManifestHash: string;
+    documentContainerManifestHistoryCount: number;
+    documentKekTargetCount: number;
+    documentKeyTargetHash: string;
+    documentManifestContainerPathCount: number;
+    documentManifestHistoryCount: number;
+    linkedContainerKeyEpochCount: number;
+    linkedContainerManifestCount: number;
+    linkSetManifestHash: string;
+    manifestEpoch: number | null;
+    previousManifestHash: string | null;
+    referencedPrincipalCount: number | null;
+}
+export interface DocumentInfo {
+    attachments: DocumentInfoAttachment[];
+    local: DocumentInfoLocalDetails;
+    remoteInfo: DocumentInfoRemoteDetails | null;
+}

package/workflows/container-contents/documentInfoTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documentInfoTypes.js.map

package/workflows/container-contents/documentInfoTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentInfoTypes.js","sourceRoot":"","sources":["documentInfoTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentEditAttributionResponse } from \"@tearleads/validators/response\";\nimport type { StoredDocumentKind } from \"../../data/documents/documentKinds\";\nimport type {\n  DocumentBlameRange,\n  DocumentCharacterBlameSummary,\n  DocumentContributor,\n  DocumentFieldBlame,\n} from \"../../data/documents/editAttribution\";\n\nexport type DocumentInfoRemoteMode = \"if-synced\" | \"never\";\n\nexport interface DocumentInfoLocalDetails {\n  accessEpoch: number | null;\n  accessStateHash: string | null;\n  containerId: string | null;\n  documentId: string | null;\n  documentKind: StoredDocumentKind | null;\n  hasContentKeyBundle: boolean;\n  hasDocumentKekTargets: boolean;\n  hasDocumentManifestBundle: boolean;\n  lastCommitLsn: string | null;\n  localDocumentManifestHash: string | null;\n  localId: string;\n  pendingAttachmentByteLength: number;\n  pendingAttachmentCount: number;\n  pendingUpdateCount: number;\n  title: string | null;\n  updatedAt: string | null;\n}\n\nexport interface DocumentInfoAttachment {\n  attachmentKind: \"local\" | \"pending\";\n  blobId: string | null;\n  byteLength: number;\n  createdAt: string | null;\n  localId: string;\n  mimeType: string | null;\n  name: string | null;\n  slotId: string;\n  storageKey: string;\n  updatedAt: string | null;\n}\n\nexport interface DocumentInfoRemoteAttachmentBinding {\n  bindingId: string;\n  blobId: string;\n  slotId: string;\n}\n\nexport interface DocumentInfoAuthorizingContainerPath {\n  containerId: string;\n  containerKeyEpoch: number | null;\n  containerKeyEpochId: string | null;\n  leafManifestHash: string | null;\n  organizationId: string;\n  pathLength: number;\n}\n\nexport interface DocumentInfoRemoteDetails {\n  activeAttachmentBindings: DocumentInfoRemoteAttachmentBinding[];\n  attributionRevision: number | null;\n  attributionStatus: \"available\" | \"truncated\" | \"unavailable\";\n  attributionSegments: DocumentEditAttributionResponse[\"segments\"];\n  authorizingContainerPaths: DocumentInfoAuthorizingContainerPath[];\n  /**\n   * Contiguous per-writer runs of the current prose — the read-only \"blame\"\n   * view that tints each phrase by who wrote it. Shares its `null` conditions\n   * (and its single snapshot reconstruction) with {@link characterBlame}.\n   */\n  blameRanges: DocumentBlameRange[] | null;\n  /**\n   * Per-writer live-character blame, or `null` when it could not be computed —\n   * the document has no local snapshot, the snapshot is too large to extract\n   * op ids from cheaply, or the snapshot was unreadable.\n   */\n  characterBlame: DocumentCharacterBlameSummary | null;\n  /**\n   * Per-field blame for a structured document (who last set each field), or\n   * `null` when it could not be computed. A note yields `[]` (no fields).\n   */\n  fieldBlame: DocumentFieldBlame[] | null;\n  contentKeyEpoch: number;\n  contentKeyTargetCount: number;\n  contentKeyTargetHash: string;\n  contributors: DocumentContributor[];\n  currentManifestHash: string;\n  documentContainerManifestHistoryCount: number;\n  documentKekTargetCount: number;\n  documentKeyTargetHash: string;\n  documentManifestContainerPathCount: number;\n  documentManifestHistoryCount: number;\n  linkedContainerKeyEpochCount: number;\n  linkedContainerManifestCount: number;\n  linkSetManifestHash: string;\n  manifestEpoch: number | null;\n  previousManifestHash: string | null;\n  referencedPrincipalCount: number | null;\n}\n\nexport interface DocumentInfo {\n  attachments: DocumentInfoAttachment[];\n  local: DocumentInfoLocalDetails;\n  remoteInfo: DocumentInfoRemoteDetails | null;\n}\n"]}

package/workflows/container-contents/documentLinkIntent.js

@@ -0,0 +1,82 @@
+import { uniqueSortedStrings } from "../../data/documents/shared/readers.js";
+import { sqlDocumentMoveIntentPersistence } from "../../data/persistence/container-contents/documentMoveIntentPersistence.js";
+import { sqlDocumentContainerProjectionPersistence as links } from "../../data/persistence/containers/documentContainerProjectionPersistence.js";
+import { defaultDocumentsPersistence } from "../documents/index.js";
+import { relinkContainerDocumentLocally } from "./documentLocalRelink.js";
+export async function addDocumentLinkLocally(input) {
+    const { note, runtime, targetContainerId } = input;
+    const persisted = await defaultDocumentsPersistence.loadDocument(runtime.infra.execSql, note.id);
+    if (!persisted)
+        return null;
+    const intentId = crypto.randomUUID();
+    let linkedContainerIds = [];
+    const linkedNote = await relinkContainerDocumentLocally({
+        ...input,
+        accessEpoch: persisted.accessEpoch,
+        requestSync: false,
+        targetContainerId: note.containerId,
+        commitSideEffect: async (execSql) => {
+            const currentLinks = await links.listLinkedContainerIds(execSql, note.documentId);
+            linkedContainerIds = uniqueSortedStrings([
+                ...currentLinks,
+                note.containerId,
+                targetContainerId,
+            ]);
+            await sqlDocumentMoveIntentPersistence.enqueueLinkIntent(execSql, {
+                id: intentId,
+                documentId: note.documentId,
+                localId: note.id,
+                sourceContainerId: note.containerId,
+                targetContainerId,
+            });
+            await links.replaceDocumentLinks(execSql, note.documentId, linkedContainerIds, { moveIntentId: intentId });
+        },
+    });
+    if (!linkedNote)
+        return null;
+    input.setLinkedContainerIdsForDocument(note.documentId, linkedContainerIds);
+    input.scheduleSync?.();
+    runtime.util.log(`Container contents: queued note ${note.id} link to ${targetContainerId}`);
+    return linkedNote;
+}
+export async function removeDocumentLinkLocally(input) {
+    const { note, runtime, removedContainerId } = input;
+    const execSql = runtime.infra.execSql;
+    const persisted = await defaultDocumentsPersistence.loadDocument(execSql, note.id);
+    if (!persisted)
+        return null;
+    const currentLinks = await links.listLinkedContainerIds(execSql, note.documentId);
+    const remaining = currentLinks.filter((id) => id !== removedContainerId);
+    const nextContainerId = remaining.includes(note.containerId)
+        ? note.containerId
+        : remaining[0];
+    if (!nextContainerId || !currentLinks.includes(removedContainerId))
+        return null;
+    const intentId = crypto.randomUUID();
+    let linkedContainerIds = [];
+    const unlinkedNote = await relinkContainerDocumentLocally({
+        ...input,
+        accessEpoch: persisted.accessEpoch,
+        requestSync: false,
+        targetContainerId: nextContainerId,
+        commitSideEffect: async (transactionExecSql) => {
+            linkedContainerIds = (await links.listLinkedContainerIds(transactionExecSql, note.documentId)).filter((id) => id !== removedContainerId);
+            if (!linkedContainerIds.includes(nextContainerId))
+                throw new Error("Document placement changed before unlink");
+            await sqlDocumentMoveIntentPersistence.enqueueUnlinkIntent(transactionExecSql, {
+                id: intentId,
+                documentId: note.documentId,
+                localId: note.id,
+                removedContainerId,
+                targetContainerId: nextContainerId,
+            });
+            await links.replaceDocumentLinks(transactionExecSql, note.documentId, linkedContainerIds, { moveIntentId: intentId });
+        },
+    });
+    if (!unlinkedNote)
+        return null;
+    input.setLinkedContainerIdsForDocument(note.documentId, linkedContainerIds);
+    input.scheduleSync?.();
+    return unlinkedNote;
+}
+//# sourceMappingURL=documentLinkIntent.js.map

package/workflows/container-contents/documentLinkIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentLinkIntent.js","sourceRoot":"","sources":["documentLinkIntent.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DocumentSummary } from \"../../data/documents/documentSummary\";\nimport { uniqueSortedStrings } from \"../../data/documents/shared/readers\";\nimport { sqlDocumentMoveIntentPersistence } from \"../../data/persistence/container-contents/documentMoveIntentPersistence\";\nimport { sqlDocumentContainerProjectionPersistence as links } from \"../../data/persistence/containers/documentContainerProjectionPersistence\";\nimport { defaultDocumentsPersistence } from \"../documents\";\nimport { relinkContainerDocumentLocally } from \"./documentLocalRelink\";\nimport type {\n  DocumentStructuralMutationHost,\n  DocumentStructuralMutationLocalStore,\n  DocumentStructuralMutationRuntime,\n  SetLinkedContainerIdsForDocument,\n} from \"./documentStructureTypes\";\n\nexport async function addDocumentLinkLocally<TRuntime>(input: {\n  currentDocumentStore: DocumentStructuralMutationLocalStore<TRuntime>;\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary & { documentId: string; containerId: string };\n  runtime: DocumentStructuralMutationRuntime;\n  scheduleSync?: (() => void) | undefined;\n  setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n  targetContainerId: string;\n}): Promise<DocumentSummary | null> {\n  const { note, runtime, targetContainerId } = input;\n  const persisted = await defaultDocumentsPersistence.loadDocument(\n    runtime.infra.execSql,\n    note.id,\n  );\n  if (!persisted) return null;\n  const intentId = crypto.randomUUID();\n  let linkedContainerIds: readonly string[] = [];\n  const linkedNote = await relinkContainerDocumentLocally({\n    ...input,\n    accessEpoch: persisted.accessEpoch,\n    requestSync: false,\n    targetContainerId: note.containerId,\n    commitSideEffect: async (execSql) => {\n      const currentLinks = await links.listLinkedContainerIds(\n        execSql,\n        note.documentId,\n      );\n      linkedContainerIds = uniqueSortedStrings([\n        ...currentLinks,\n        note.containerId,\n        targetContainerId,\n      ]);\n      await sqlDocumentMoveIntentPersistence.enqueueLinkIntent(execSql, {\n        id: intentId,\n        documentId: note.documentId,\n        localId: note.id,\n        sourceContainerId: note.containerId,\n        targetContainerId,\n      });\n      await links.replaceDocumentLinks(\n        execSql,\n        note.documentId,\n        linkedContainerIds,\n        { moveIntentId: intentId },\n      );\n    },\n  });\n  if (!linkedNote) return null;\n  input.setLinkedContainerIdsForDocument(note.documentId, linkedContainerIds);\n  input.scheduleSync?.();\n  runtime.util.log(\n    `Container contents: queued note ${note.id} link to ${targetContainerId}`,\n  );\n  return linkedNote;\n}\n\nexport async function removeDocumentLinkLocally<TRuntime>(\n  input: Omit<\n    Parameters<typeof addDocumentLinkLocally<TRuntime>>[0],\n    \"targetContainerId\"\n  > & { removedContainerId: string },\n): Promise<DocumentSummary | null> {\n  const { note, runtime, removedContainerId } = input;\n  const execSql = runtime.infra.execSql;\n  const persisted = await defaultDocumentsPersistence.loadDocument(\n    execSql,\n    note.id,\n  );\n  if (!persisted) return null;\n  const currentLinks = await links.listLinkedContainerIds(\n    execSql,\n    note.documentId,\n  );\n  const remaining = currentLinks.filter((id) => id !== removedContainerId);\n  const nextContainerId = remaining.includes(note.containerId)\n    ? note.containerId\n    : remaining[0];\n  if (!nextContainerId || !currentLinks.includes(removedContainerId))\n    return null;\n  const intentId = crypto.randomUUID();\n  let linkedContainerIds: readonly string[] = [];\n  const unlinkedNote = await relinkContainerDocumentLocally({\n    ...input,\n    accessEpoch: persisted.accessEpoch,\n    requestSync: false,\n    targetContainerId: nextContainerId,\n    commitSideEffect: async (transactionExecSql) => {\n      linkedContainerIds = (\n        await links.listLinkedContainerIds(transactionExecSql, note.documentId)\n      ).filter((id) => id !== removedContainerId);\n      if (!linkedContainerIds.includes(nextContainerId))\n        throw new Error(\"Document placement changed before unlink\");\n      await sqlDocumentMoveIntentPersistence.enqueueUnlinkIntent(\n        transactionExecSql,\n        {\n          id: intentId,\n          documentId: note.documentId,\n          localId: note.id,\n          removedContainerId,\n          targetContainerId: nextContainerId,\n        },\n      );\n      await links.replaceDocumentLinks(\n        transactionExecSql,\n        note.documentId,\n        linkedContainerIds,\n        { moveIntentId: intentId },\n      );\n    },\n  });\n  if (!unlinkedNote) return null;\n  input.setLinkedContainerIdsForDocument(note.documentId, linkedContainerIds);\n  input.scheduleSync?.();\n  return unlinkedNote;\n}\n"]}

package/workflows/container-contents/documentLinks.d.ts

@@ -0,0 +1,59 @@
+import type { ProjectionUserKeyResolver } from "../../data/keyingProjectionVerification.js";
+import type { ExecSql } from "../../data/sqlite/sqlSchema.js";
+import { type DocumentLinkSetFailureHandler, type RelinkRemoteDocumentResult, relinkRemoteDocument } from "../documents/index.js";
+import type { ContainerContentsWorkflowRuntime } from "./runtime.js";
+type ContainerDocumentLinkApi = Parameters<typeof relinkRemoteDocument>[0]["apiClient"];
+type ContainerDocumentLinkOperation = Parameters<typeof relinkRemoteDocument>[0]["operation"];
+type RemoteDocumentPersistedState = RelinkRemoteDocumentResult["persistedState"];
+interface ContainerDocumentLinkRuntime extends Pick<ContainerContentsWorkflowRuntime, "auth" | "crypto" | "infra" | "resolveTrustedUserIdentity" | "state" | "util"> {
+    apiClient: ContainerDocumentLinkApi & Pick<ContainerContentsWorkflowRuntime["apiClient"], "getCurrentPrincipalPolicy">;
+}
+type MoveRemoteContainerDocumentStatus = "complete" | "partial";
+interface MoveRemoteContainerDocumentResult {
+    accessEpoch: number | null;
+    accessStateHash: string | null;
+    linkedContainerIds: readonly string[];
+    nextContainerId: string;
+    remoteState: RemoteDocumentPersistedState | null;
+    status: MoveRemoteContainerDocumentStatus;
+}
+export type { RemoteDocumentPersistedState };
+export declare function initializeDocumentLinksSchema(execSql: ExecSql): Promise<void>;
+export declare function listDocumentLinkedContainerIds(execSql: ExecSql, documentId: string): Promise<ReadonlyArray<string>>;
+export declare function replaceDocumentLinks(execSql: ExecSql, documentId: string, containerIds: ReadonlyArray<string>): Promise<void>;
+export declare function relinkRemoteContainerDocument(input: {
+    documentId: string;
+    isCurrent?: (() => boolean) | undefined;
+    noteId: string;
+    onFailure?: DocumentLinkSetFailureHandler | undefined;
+    operation: ContainerDocumentLinkOperation;
+    resolveProjectionUserKey: ProjectionUserKeyResolver;
+    rotationSnapshot?: Uint8Array | undefined;
+    runtime: ContainerDocumentLinkRuntime;
+    targetContainerId: string;
+}): Promise<RelinkRemoteDocumentResult | null>;
+export declare function unlinkRemoteContainerDocument(input: {
+    documentId: string;
+    isCurrent?: (() => boolean) | undefined;
+    noteId: string;
+    onFailure?: DocumentLinkSetFailureHandler | undefined;
+    resolveProjectionUserKey: ProjectionUserKeyResolver;
+    rotationSnapshot: Uint8Array;
+    runtime: ContainerDocumentLinkRuntime;
+    targetContainerId: string;
+}): Promise<RelinkRemoteDocumentResult | null>;
+export declare function moveRemoteContainerDocument(input: {
+    linkOnly?: boolean | undefined;
+    additionalLinkContainerIds?: readonly string[] | undefined;
+    removedLinkContainerIds?: readonly string[] | undefined;
+    currentContainerId: string;
+    documentId: string;
+    isCurrent?: (() => boolean) | undefined;
+    noteId: string;
+    onFailure?: DocumentLinkSetFailureHandler | undefined;
+    replaceLinkedContainers?: boolean | undefined;
+    resolveProjectionUserKey: ProjectionUserKeyResolver;
+    rotationSnapshot: Uint8Array;
+    runtime: ContainerDocumentLinkRuntime;
+    targetContainerId: string;
+}): Promise<MoveRemoteContainerDocumentResult | null>;