@tearleads/client-sdk 0.1.61 → 0.1.63

package/workflows/container-contents/documentQueries/documentStructure.js

@@ -0,0 +1,183 @@
+import { DEFAULT_DOCUMENT_ACCESS_EPOCH } from "../../../data/documents/documentConstants.js";
+import { addDocumentLinkLocally, removeDocumentLinkLocally, } from "../documentLinks/documentLinkIntent.js";
+import { relinkContainerDocumentLocally } from "../documentLinks/documentLocalRelink.js";
+import { moveRemoteDocumentLinkLocally } from "../documentMove/documentMoveIntent.js";
+export function canMutateDocumentLink(runtime) {
+    return (runtime.infra.dbStatus === "ready" &&
+        runtime.auth.isAuthenticated &&
+        runtime.state.online);
+}
+export function canMutateLocalDocumentLink(runtime) {
+    return runtime.infra.dbStatus === "ready";
+}
+async function openDocumentStoreForStructuralMutation({ host, note, requireDocumentId, runtime, }) {
+    if (requireDocumentId && !note.documentId) {
+        return null;
+    }
+    const documentStore = host.openDocumentStore({
+        containerId: note.containerId,
+        documentId: note.documentId,
+        localId: note.id,
+    });
+    if (!(await documentStore.ensureInitialized())) {
+        runtime.util.log(`Container contents: note ${note.id} is not ready to mutate locally`);
+        return null;
+    }
+    return documentStore;
+}
+export async function moveLocalDocumentLink(params) {
+    const { expandNode, host, note, runtime, targetContainerId } = params;
+    if (note.containerId === targetContainerId) {
+        return null;
+    }
+    const currentDocumentStore = await openDocumentStoreForStructuralMutation({
+        host,
+        note,
+        requireDocumentId: false,
+        runtime,
+    });
+    if (!currentDocumentStore) {
+        return null;
+    }
+    const movedNote = await relinkContainerDocumentLocally({
+        accessEpoch: DEFAULT_DOCUMENT_ACCESS_EPOCH,
+        currentDocumentStore,
+        host,
+        note,
+        requestSync: true,
+        runtime,
+        targetContainerId,
+    });
+    if (!movedNote) {
+        return null;
+    }
+    expandNode(targetContainerId);
+    runtime.util.log(`Container contents: moved local note ${movedNote.id} to ${targetContainerId}`);
+    return movedNote;
+}
+export async function moveDocumentLink(params) {
+    const { expandNode, host, note, replaceLinkedContainers, runtime, scheduleSync, setLinkedContainerIdsForDocument, targetContainerId, } = params;
+    if (note.containerId === targetContainerId) {
+        return { linksChanged: false, note: null };
+    }
+    if (!note.documentId) {
+        const movedNote = await moveLocalDocumentLink({
+            expandNode,
+            host,
+            note,
+            runtime,
+            targetContainerId,
+        });
+        return {
+            linksChanged: movedNote !== null,
+            note: movedNote,
+        };
+    }
+    const currentDocumentStore = await openDocumentStoreForStructuralMutation({
+        host,
+        note,
+        requireDocumentId: true,
+        runtime,
+    });
+    if (!currentDocumentStore) {
+        return { linksChanged: false, note: null };
+    }
+    const queuedMove = await moveRemoteDocumentLinkLocally({
+        currentDocumentStore,
+        expandNode,
+        host,
+        note: {
+            ...note,
+            documentId: note.documentId,
+        },
+        replaceLinkedContainers,
+        runtime,
+        scheduleSync,
+        setLinkedContainerIdsForDocument,
+        targetContainerId,
+    });
+    return queuedMove;
+}
+export async function addDocumentLink(params) {
+    const { host, note, runtime } = params;
+    if (!note.documentId || !note.containerId) {
+        return null;
+    }
+    const currentDocumentStore = await openDocumentStoreForStructuralMutation({
+        host,
+        note,
+        requireDocumentId: true,
+        runtime,
+    });
+    if (!currentDocumentStore) {
+        return null;
+    }
+    return addDocumentLinkLocally({
+        ...params,
+        currentDocumentStore,
+        note: {
+            ...note,
+            documentId: note.documentId,
+            containerId: note.containerId,
+        },
+    });
+}
+export async function removeDocumentLink(params) {
+    const { host, note, runtime } = params;
+    if (!note.documentId || !note.containerId) {
+        return null;
+    }
+    const currentDocumentStore = await openDocumentStoreForStructuralMutation({
+        host,
+        note,
+        requireDocumentId: true,
+        runtime,
+    });
+    if (!currentDocumentStore) {
+        return null;
+    }
+    // Keep the rotation preflight before accepting an unlink. Replay proves it
+    // again before publishing the signed key rotation from the durable intent.
+    await currentDocumentStore.assertCanRotateContentKey();
+    return removeDocumentLinkLocally({
+        ...params,
+        currentDocumentStore,
+        note: {
+            ...note,
+            documentId: note.documentId,
+            containerId: note.containerId,
+        },
+    });
+}
+export async function activateDocumentLink(params) {
+    const { host, note, runtime, targetContainerId } = params;
+    if (!note.documentId ||
+        !note.containerId ||
+        note.containerId === targetContainerId) {
+        return null;
+    }
+    const currentDocumentStore = await openDocumentStoreForStructuralMutation({
+        host,
+        note,
+        requireDocumentId: true,
+        runtime,
+    });
+    if (!currentDocumentStore) {
+        return null;
+    }
+    const relinkedNote = await relinkContainerDocumentLocally({
+        accessEpoch: DEFAULT_DOCUMENT_ACCESS_EPOCH,
+        currentDocumentStore,
+        host,
+        note,
+        requestSync: false,
+        runtime,
+        targetContainerId,
+    });
+    if (!relinkedNote) {
+        return null;
+    }
+    runtime.util.log(`Container contents: switched active note ${relinkedNote.id} to ${targetContainerId}`);
+    return relinkedNote;
+}
+//# sourceMappingURL=documentStructure.js.map

package/workflows/container-contents/documentQueries/documentStructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentStructure.js","sourceRoot":"","sources":["documentStructure.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_DOCUMENT_ACCESS_EPOCH } from \"../../../data/documents/documentConstants\";\nimport type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport {\n  addDocumentLinkLocally,\n  removeDocumentLinkLocally,\n} from \"../documentLinks/documentLinkIntent\";\nimport { relinkContainerDocumentLocally } from \"../documentLinks/documentLocalRelink\";\nimport { moveRemoteDocumentLinkLocally } from \"../documentMove/documentMoveIntent\";\nimport type {\n  DocumentStructuralMutationHost,\n  DocumentStructuralMutationRuntime,\n  SetLinkedContainerIdsForDocument,\n} from \"./documentStructureTypes\";\n\nexport type {\n  DocumentStructuralMutationHost,\n  DocumentStructuralMutationRelinkInput,\n  DocumentStructuralMutationRuntime,\n  MergeDocumentSummary,\n  SetLinkedContainerIdsForDocument,\n} from \"./documentStructureTypes\";\n\ninterface DocumentStructuralMutationInput<TRuntime> {\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary;\n  requireDocumentId: boolean;\n  runtime: DocumentStructuralMutationRuntime;\n}\n\nexport function canMutateDocumentLink(runtime: {\n  readonly auth: Pick<\n    DocumentStructuralMutationRuntime[\"auth\"],\n    \"isAuthenticated\"\n  >;\n  readonly infra: Pick<DocumentStructuralMutationRuntime[\"infra\"], \"dbStatus\">;\n  readonly state: Pick<DocumentStructuralMutationRuntime[\"state\"], \"online\">;\n}): boolean {\n  return (\n    runtime.infra.dbStatus === \"ready\" &&\n    runtime.auth.isAuthenticated &&\n    runtime.state.online\n  );\n}\n\nexport function canMutateLocalDocumentLink(runtime: {\n  readonly infra: Pick<DocumentStructuralMutationRuntime[\"infra\"], \"dbStatus\">;\n}): boolean {\n  return runtime.infra.dbStatus === \"ready\";\n}\n\nasync function openDocumentStoreForStructuralMutation<TRuntime>({\n  host,\n  note,\n  requireDocumentId,\n  runtime,\n}: DocumentStructuralMutationInput<TRuntime>) {\n  if (requireDocumentId && !note.documentId) {\n    return null;\n  }\n\n  const documentStore = host.openDocumentStore({\n    containerId: note.containerId,\n    documentId: note.documentId,\n    localId: note.id,\n  });\n  if (!(await documentStore.ensureInitialized())) {\n    runtime.util.log(\n      `Container contents: note ${note.id} is not ready to mutate locally`,\n    );\n    return null;\n  }\n\n  return documentStore;\n}\n\nexport async function moveLocalDocumentLink<TRuntime>(params: {\n  expandNode: (nodeId: string) => void;\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary;\n  runtime: DocumentStructuralMutationRuntime;\n  targetContainerId: string;\n}): Promise<DocumentSummary | null> {\n  const { expandNode, host, note, runtime, targetContainerId } = params;\n  if (note.containerId === targetContainerId) {\n    return null;\n  }\n\n  const currentDocumentStore = await openDocumentStoreForStructuralMutation({\n    host,\n    note,\n    requireDocumentId: false,\n    runtime,\n  });\n  if (!currentDocumentStore) {\n    return null;\n  }\n\n  const movedNote = await relinkContainerDocumentLocally({\n    accessEpoch: DEFAULT_DOCUMENT_ACCESS_EPOCH,\n    currentDocumentStore,\n    host,\n    note,\n    requestSync: true,\n    runtime,\n    targetContainerId,\n  });\n  if (!movedNote) {\n    return null;\n  }\n\n  expandNode(targetContainerId);\n  runtime.util.log(\n    `Container contents: moved local note ${movedNote.id} to ${targetContainerId}`,\n  );\n  return movedNote;\n}\n\nexport async function moveDocumentLink<TRuntime>(params: {\n  expandNode: (nodeId: string) => void;\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary;\n  replaceLinkedContainers?: boolean | undefined;\n  runtime: DocumentStructuralMutationRuntime;\n  scheduleSync?: (() => void) | undefined;\n  setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n  targetContainerId: string;\n}): Promise<{ linksChanged: boolean; note: DocumentSummary | null }> {\n  const {\n    expandNode,\n    host,\n    note,\n    replaceLinkedContainers,\n    runtime,\n    scheduleSync,\n    setLinkedContainerIdsForDocument,\n    targetContainerId,\n  } = params;\n  if (note.containerId === targetContainerId) {\n    return { linksChanged: false, note: null };\n  }\n  if (!note.documentId) {\n    const movedNote = await moveLocalDocumentLink({\n      expandNode,\n      host,\n      note,\n      runtime,\n      targetContainerId,\n    });\n    return {\n      linksChanged: movedNote !== null,\n      note: movedNote,\n    };\n  }\n\n  const currentDocumentStore = await openDocumentStoreForStructuralMutation({\n    host,\n    note,\n    requireDocumentId: true,\n    runtime,\n  });\n  if (!currentDocumentStore) {\n    return { linksChanged: false, note: null };\n  }\n\n  const queuedMove = await moveRemoteDocumentLinkLocally({\n    currentDocumentStore,\n    expandNode,\n    host,\n    note: {\n      ...note,\n      documentId: note.documentId,\n    },\n    replaceLinkedContainers,\n    runtime,\n    scheduleSync,\n    setLinkedContainerIdsForDocument,\n    targetContainerId,\n  });\n  return queuedMove;\n}\n\nexport async function addDocumentLink<TRuntime>(params: {\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary;\n  runtime: DocumentStructuralMutationRuntime;\n  scheduleSync?: (() => void) | undefined;\n  setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n  targetContainerId: string;\n}): Promise<DocumentSummary | null> {\n  const { host, note, runtime } = params;\n  if (!note.documentId || !note.containerId) {\n    return null;\n  }\n\n  const currentDocumentStore = await openDocumentStoreForStructuralMutation({\n    host,\n    note,\n    requireDocumentId: true,\n    runtime,\n  });\n  if (!currentDocumentStore) {\n    return null;\n  }\n\n  return addDocumentLinkLocally({\n    ...params,\n    currentDocumentStore,\n    note: {\n      ...note,\n      documentId: note.documentId,\n      containerId: note.containerId,\n    },\n  });\n}\n\nexport async function removeDocumentLink<TRuntime>(params: {\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary;\n  removedContainerId: string;\n  runtime: DocumentStructuralMutationRuntime;\n  scheduleSync?: (() => void) | undefined;\n  setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n}): Promise<DocumentSummary | null> {\n  const { host, note, runtime } = params;\n  if (!note.documentId || !note.containerId) {\n    return null;\n  }\n\n  const currentDocumentStore = await openDocumentStoreForStructuralMutation({\n    host,\n    note,\n    requireDocumentId: true,\n    runtime,\n  });\n  if (!currentDocumentStore) {\n    return null;\n  }\n\n  // Keep the rotation preflight before accepting an unlink. Replay proves it\n  // again before publishing the signed key rotation from the durable intent.\n  await currentDocumentStore.assertCanRotateContentKey();\n  return removeDocumentLinkLocally({\n    ...params,\n    currentDocumentStore,\n    note: {\n      ...note,\n      documentId: note.documentId,\n      containerId: note.containerId,\n    },\n  });\n}\n\nexport async function activateDocumentLink<TRuntime>(params: {\n  host: DocumentStructuralMutationHost<TRuntime>;\n  note: DocumentSummary;\n  runtime: DocumentStructuralMutationRuntime;\n  targetContainerId: string;\n}): Promise<DocumentSummary | null> {\n  const { host, note, runtime, targetContainerId } = params;\n  if (\n    !note.documentId ||\n    !note.containerId ||\n    note.containerId === targetContainerId\n  ) {\n    return null;\n  }\n\n  const currentDocumentStore = await openDocumentStoreForStructuralMutation({\n    host,\n    note,\n    requireDocumentId: true,\n    runtime,\n  });\n  if (!currentDocumentStore) {\n    return null;\n  }\n\n  const relinkedNote = await relinkContainerDocumentLocally({\n    accessEpoch: DEFAULT_DOCUMENT_ACCESS_EPOCH,\n    currentDocumentStore,\n    host,\n    note,\n    requestSync: false,\n    runtime,\n    targetContainerId,\n  });\n  if (!relinkedNote) {\n    return null;\n  }\n\n  runtime.util.log(\n    `Container contents: switched active note ${relinkedNote.id} to ${targetContainerId}`,\n  );\n  return relinkedNote;\n}\n"]}

package/workflows/container-contents/documentQueries/documentStructureTypes.d.ts

@@ -0,0 +1,32 @@
+import type { DocumentSummary } from "../../../data/documents/documentSummary.js";
+import type { ExecSql, RelinkPersistedDocumentInput } from "../../documents/index.js";
+import type { ContainerContentsProjectionUserKeyResolver } from "../projectionKeys.js";
+import type { ContainerContentsWorkflowRuntime } from "../runtime.js";
+export type MergeDocumentSummary = (nextDocument: DocumentSummary) => void;
+export type SetLinkedContainerIdsForDocument = (documentId: string, linkedContainerIds: ReadonlyArray<string>) => void;
+export type DocumentStructuralMutationRuntime = ContainerContentsWorkflowRuntime & {
+    resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;
+};
+export interface DocumentStructuralMutationRelinkInput extends RelinkPersistedDocumentInput {
+    commitSideEffect?: ((transactionExecSql: ExecSql) => Promise<void>) | undefined;
+    contentKeyBundle?: string | null | undefined;
+    documentKekTargets?: string | null | undefined;
+    documentManifestBundle?: string | null | undefined;
+    stillCurrent?: (() => boolean) | undefined;
+}
+export interface DocumentStructuralMutationLocalStore<TRuntime> {
+    assertCanRotateContentKey: () => Promise<Uint8Array>;
+    ensureInitialized: () => Promise<boolean>;
+    relink: (input: DocumentStructuralMutationRelinkInput) => Promise<DocumentSummary | null>;
+    requestSync: () => void;
+    updateRuntime: (runtime: TRuntime) => void;
+}
+export interface DocumentStructuralMutationHost<TRuntime> {
+    documentWorkflowRuntime: (containerId: string | null) => TRuntime;
+    mergeDocumentSummary: MergeDocumentSummary;
+    openDocumentStore: (input: {
+        containerId: string | null;
+        documentId: string | null;
+        localId: string;
+    }) => DocumentStructuralMutationLocalStore<TRuntime>;
+}

package/workflows/container-contents/documentQueries/documentStructureTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentStructureTypes.js","sourceRoot":"","sources":["documentStructureTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport type { ExecSql, RelinkPersistedDocumentInput } from \"../../documents\";\nimport type { ContainerContentsProjectionUserKeyResolver } from \"../projectionKeys\";\nimport type { ContainerContentsWorkflowRuntime } from \"../runtime\";\n\nexport type MergeDocumentSummary = (nextDocument: DocumentSummary) => void;\nexport type SetLinkedContainerIdsForDocument = (\n  documentId: string,\n  linkedContainerIds: ReadonlyArray<string>,\n) => void;\n\nexport type DocumentStructuralMutationRuntime =\n  ContainerContentsWorkflowRuntime & {\n    resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;\n  };\n\nexport interface DocumentStructuralMutationRelinkInput\n  extends RelinkPersistedDocumentInput {\n  commitSideEffect?:\n    | ((transactionExecSql: ExecSql) => Promise<void>)\n    | undefined;\n  contentKeyBundle?: string | null | undefined;\n  documentKekTargets?: string | null | undefined;\n  documentManifestBundle?: string | null | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n}\n\nexport interface DocumentStructuralMutationLocalStore<TRuntime> {\n  assertCanRotateContentKey: () => Promise<Uint8Array>;\n  ensureInitialized: () => Promise<boolean>;\n  relink: (\n    input: DocumentStructuralMutationRelinkInput,\n  ) => Promise<DocumentSummary | null>;\n  requestSync: () => void;\n  updateRuntime: (runtime: TRuntime) => void;\n}\n\nexport interface DocumentStructuralMutationHost<TRuntime> {\n  documentWorkflowRuntime: (containerId: string | null) => TRuntime;\n  mergeDocumentSummary: MergeDocumentSummary;\n  openDocumentStore: (input: {\n    containerId: string | null;\n    documentId: string | null;\n    localId: string;\n  }) => DocumentStructuralMutationLocalStore<TRuntime>;\n}\n"]}

package/workflows/container-contents/documentQueries/documentSubtreeQueries.js

@@ -0,0 +1,169 @@
+import { sqlDocumentContainerProjectionPersistence } from "../../../data/persistence/containers/documentContainerProjectionPersistence.js";
+import { containerDocumentPlacementKey, listContainerDocumentTombstoneHoldsForDocuments, } from "../../../data/persistence/documents/containerDocumentTombstoneHoldsPersistence.js";
+import { sqlDocumentsPersistence } from "../../../data/persistence/documents/documentsPersistence.js";
+import { compareContainerContentsDocumentSummaries } from "./rows.js";
+import { listContainerContentsSqlIdBatches } from "./sql.js";
+function addContainerContentsDocumentSummaries(documentSummariesById, documentSummaries) {
+    for (const documentSummary of documentSummaries) {
+        documentSummariesById.set(documentSummary.id, documentSummary);
+    }
+}
+async function listContainerContentsDocumentIdsByContainerIds(execSql, containerIds) {
+    const documentIds = new Set();
+    for (const containerIdBatch of listContainerContentsSqlIdBatches(containerIds)) {
+        const batchDocumentIds = await sqlDocumentContainerProjectionPersistence.listDocumentIdsByContainerIds(execSql, containerIdBatch);
+        for (const documentId of batchDocumentIds) {
+            documentIds.add(documentId);
+        }
+    }
+    return Array.from(documentIds).sort();
+}
+async function listContainerContentsDocumentSummariesByContainerIdsOrDocumentIds(execSql, input) {
+    const documentSummariesById = new Map();
+    for (const containerIdBatch of listContainerContentsSqlIdBatches(input.containerIds)) {
+        addContainerContentsDocumentSummaries(documentSummariesById, await sqlDocumentsPersistence.listDocumentsByContainerIdsOrDocumentIds(execSql, {
+            containerIds: containerIdBatch,
+            documentIds: [],
+        }));
+    }
+    for (const documentIdBatch of listContainerContentsSqlIdBatches(input.documentIds)) {
+        addContainerContentsDocumentSummaries(documentSummariesById, await sqlDocumentsPersistence.listDocumentsByContainerIdsOrDocumentIds(execSql, {
+            containerIds: [],
+            documentIds: documentIdBatch,
+        }));
+    }
+    const documentSummaries = Array.from(documentSummariesById.values());
+    return input.sortDocumentSummaries
+        ? documentSummaries.sort(compareContainerContentsDocumentSummaries)
+        : documentSummaries;
+}
+function heldPlacementKey(documentId, containerId) {
+    return containerDocumentPlacementKey({
+        containerId,
+        documentId: documentId ?? "",
+    });
+}
+function withoutHeldPlacements(linkedContainerIdsByDocumentId, holds) {
+    const held = new Set(holds.map((hold) => heldPlacementKey(hold.documentId, hold.containerId)));
+    if (held.size === 0) {
+        return { held, links: linkedContainerIdsByDocumentId };
+    }
+    return {
+        held,
+        links: new Map(Array.from(linkedContainerIdsByDocumentId, ([documentId, ids]) => [
+            documentId,
+            ids.filter((id) => !held.has(heldPlacementKey(documentId, id))),
+        ])),
+    };
+}
+/**
+ * Shared batched read pipeline for a flat set of container ids: linked
+ * document ids → document summaries → linked container ids per document.
+ * Sorting is optional so device-first projection reads can skip it.
+ */
+export async function listContainerContentsDocumentsForContainers(execSql, containerIds, options) {
+    await sqlDocumentsPersistence.ensureSchema(execSql);
+    const linkedDocumentIds = await listContainerContentsDocumentIdsByContainerIds(execSql, containerIds);
+    const documentSummaries = await listContainerContentsDocumentSummariesByContainerIdsOrDocumentIds(execSql, {
+        containerIds,
+        documentIds: linkedDocumentIds,
+        sortDocumentSummaries: options.sortDocumentSummaries,
+    });
+    const documentIds = Array.from(new Set(documentSummaries.flatMap((documentSummary) => documentSummary.documentId ? [documentSummary.documentId] : [])));
+    const linkedContainerIdsByDocumentId = withoutHeldPlacements(await sqlDocumentContainerProjectionPersistence.listLinkedContainerIdsByDocumentIds(execSql, documentIds), await listContainerDocumentTombstoneHoldsForDocuments(execSql, documentIds));
+    // An earlier link-id read can race a move. Recheck membership against the
+    // summaries and final link read so a fresh trash summary cannot ride stale
+    // root ids into the root view. Notification fences reject older summaries.
+    // A held placement (a listing tombstone awaiting signed evidence) is not a
+    // membership here either, matching the container item and sidebar views.
+    const requestedIds = new Set(containerIds);
+    return {
+        documentSummaries: documentSummaries.filter((summary) => (summary.containerId !== null &&
+            requestedIds.has(summary.containerId) &&
+            !linkedContainerIdsByDocumentId.held.has(heldPlacementKey(summary.documentId, summary.containerId))) ||
+            (summary.documentId !== null &&
+                linkedContainerIdsByDocumentId.links
+                    .get(summary.documentId)
+                    ?.some((id) => requestedIds.has(id)))),
+        linkedContainerIdsByDocumentId: linkedContainerIdsByDocumentId.links,
+    };
+}
+function listContainerContentsContainerSubtreeIds(containersById, rootContainerId) {
+    const childrenByParentId = new Map();
+    for (const containerState of containersById.values()) {
+        const parentId = containerState.container.parentId;
+        if (parentId === null) {
+            continue;
+        }
+        const children = childrenByParentId.get(parentId);
+        if (children) {
+            children.push(containerState.container.id);
+        }
+        else {
+            childrenByParentId.set(parentId, [containerState.container.id]);
+        }
+    }
+    const subtreeIds = [];
+    const stack = [rootContainerId];
+    const visited = new Set();
+    while (stack.length > 0) {
+        const containerId = stack.pop();
+        if (containerId === undefined || visited.has(containerId)) {
+            continue;
+        }
+        visited.add(containerId);
+        if (containersById.has(containerId)) {
+            subtreeIds.push(containerId);
+        }
+        const children = childrenByParentId.get(containerId);
+        if (children) {
+            stack.push(...children);
+        }
+    }
+    return subtreeIds;
+}
+function resolveContainerContentsDocumentRuntimeContainerId(params) {
+    const { documentSummary, linkedContainerIdsByDocumentId, sharedContainerIds, } = params;
+    if (documentSummary.containerId &&
+        sharedContainerIds.has(documentSummary.containerId)) {
+        return documentSummary.containerId;
+    }
+    if (!documentSummary.documentId) {
+        return null;
+    }
+    return (linkedContainerIdsByDocumentId
+        .get(documentSummary.documentId)
+        ?.find((containerId) => sharedContainerIds.has(containerId)) ?? null);
+}
+async function listDocumentRuntimeTargetsForContainerSubtree(input) {
+    const { containersById, execSql, rootContainerId } = input;
+    const sharedContainerIds = new Set(listContainerContentsContainerSubtreeIds(containersById, rootContainerId));
+    if (sharedContainerIds.size === 0) {
+        return [];
+    }
+    const { documentSummaries, linkedContainerIdsByDocumentId } = await listContainerContentsDocumentsForContainers(execSql, Array.from(sharedContainerIds), { sortDocumentSummaries: true });
+    return documentSummaries.flatMap((documentSummary) => {
+        const runtimeContainerId = resolveContainerContentsDocumentRuntimeContainerId({
+            documentSummary,
+            linkedContainerIdsByDocumentId,
+            sharedContainerIds,
+        });
+        if (!runtimeContainerId) {
+            return [];
+        }
+        return [
+            {
+                documentId: documentSummary.documentId,
+                localId: documentSummary.id,
+                runtimeContainerId,
+            },
+        ];
+    });
+}
+export function listDocumentRuntimeTargetsForContainerSubtreeFromRuntime({ runtime, ...input }) {
+    return listDocumentRuntimeTargetsForContainerSubtree({
+        ...input,
+        execSql: runtime.infra.execSql,
+    });
+}
+//# sourceMappingURL=documentSubtreeQueries.js.map

package/workflows/container-contents/documentQueries/documentSubtreeQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentSubtreeQueries.js","sourceRoot":"","sources":["documentSubtreeQueries.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport { sqlDocumentContainerProjectionPersistence } from \"../../../data/persistence/containers/documentContainerProjectionPersistence\";\nimport {\n  containerDocumentPlacementKey,\n  listContainerDocumentTombstoneHoldsForDocuments,\n} from \"../../../data/persistence/documents/containerDocumentTombstoneHoldsPersistence\";\nimport { sqlDocumentsPersistence } from \"../../../data/persistence/documents/documentsPersistence\";\nimport type { ExecSql } from \"../../../data/sqlite/sqlSchema\";\nimport { compareContainerContentsDocumentSummaries } from \"./rows\";\nimport { listContainerContentsSqlIdBatches } from \"./sql\";\nimport type {\n  ContainerContentsContainerSubtreeState,\n  ContainerContentsDocumentRuntimeTarget,\n  ContainerContentsSharedDocumentSummaries,\n  ContainerDocumentQueriesRuntime,\n} from \"./types\";\n\nfunction addContainerContentsDocumentSummaries(\n  documentSummariesById: Map<string, DocumentSummary>,\n  documentSummaries: ReadonlyArray<DocumentSummary>,\n): void {\n  for (const documentSummary of documentSummaries) {\n    documentSummariesById.set(documentSummary.id, documentSummary);\n  }\n}\n\nasync function listContainerContentsDocumentIdsByContainerIds(\n  execSql: ExecSql,\n  containerIds: ReadonlyArray<string>,\n): Promise<string[]> {\n  const documentIds = new Set<string>();\n\n  for (const containerIdBatch of listContainerContentsSqlIdBatches(\n    containerIds,\n  )) {\n    const batchDocumentIds =\n      await sqlDocumentContainerProjectionPersistence.listDocumentIdsByContainerIds(\n        execSql,\n        containerIdBatch,\n      );\n    for (const documentId of batchDocumentIds) {\n      documentIds.add(documentId);\n    }\n  }\n\n  return Array.from(documentIds).sort();\n}\n\nasync function listContainerContentsDocumentSummariesByContainerIdsOrDocumentIds(\n  execSql: ExecSql,\n  input: {\n    containerIds: ReadonlyArray<string>;\n    documentIds: ReadonlyArray<string>;\n    sortDocumentSummaries: boolean;\n  },\n): Promise<DocumentSummary[]> {\n  const documentSummariesById = new Map<string, DocumentSummary>();\n\n  for (const containerIdBatch of listContainerContentsSqlIdBatches(\n    input.containerIds,\n  )) {\n    addContainerContentsDocumentSummaries(\n      documentSummariesById,\n      await sqlDocumentsPersistence.listDocumentsByContainerIdsOrDocumentIds(\n        execSql,\n        {\n          containerIds: containerIdBatch,\n          documentIds: [],\n        },\n      ),\n    );\n  }\n\n  for (const documentIdBatch of listContainerContentsSqlIdBatches(\n    input.documentIds,\n  )) {\n    addContainerContentsDocumentSummaries(\n      documentSummariesById,\n      await sqlDocumentsPersistence.listDocumentsByContainerIdsOrDocumentIds(\n        execSql,\n        {\n          containerIds: [],\n          documentIds: documentIdBatch,\n        },\n      ),\n    );\n  }\n\n  const documentSummaries = Array.from(documentSummariesById.values());\n  return input.sortDocumentSummaries\n    ? documentSummaries.sort(compareContainerContentsDocumentSummaries)\n    : documentSummaries;\n}\n\nfunction heldPlacementKey(\n  documentId: string | null,\n  containerId: string,\n): string {\n  return containerDocumentPlacementKey({\n    containerId,\n    documentId: documentId ?? \"\",\n  });\n}\n\nfunction withoutHeldPlacements(\n  linkedContainerIdsByDocumentId: ReadonlyMap<string, ReadonlyArray<string>>,\n  holds: ReadonlyArray<{ containerId: string; documentId: string }>,\n): {\n  held: ReadonlySet<string>;\n  links: ReadonlyMap<string, ReadonlyArray<string>>;\n} {\n  const held = new Set(\n    holds.map((hold) => heldPlacementKey(hold.documentId, hold.containerId)),\n  );\n  if (held.size === 0) {\n    return { held, links: linkedContainerIdsByDocumentId };\n  }\n  return {\n    held,\n    links: new Map(\n      Array.from(linkedContainerIdsByDocumentId, ([documentId, ids]) => [\n        documentId,\n        ids.filter((id) => !held.has(heldPlacementKey(documentId, id))),\n      ]),\n    ),\n  };\n}\n\n/**\n * Shared batched read pipeline for a flat set of container ids: linked\n * document ids → document summaries → linked container ids per document.\n * Sorting is optional so device-first projection reads can skip it.\n */\nexport async function listContainerContentsDocumentsForContainers(\n  execSql: ExecSql,\n  containerIds: ReadonlyArray<string>,\n  options: { sortDocumentSummaries: boolean },\n): Promise<ContainerContentsSharedDocumentSummaries> {\n  await sqlDocumentsPersistence.ensureSchema(execSql);\n  const linkedDocumentIds =\n    await listContainerContentsDocumentIdsByContainerIds(execSql, containerIds);\n  const documentSummaries =\n    await listContainerContentsDocumentSummariesByContainerIdsOrDocumentIds(\n      execSql,\n      {\n        containerIds,\n        documentIds: linkedDocumentIds,\n        sortDocumentSummaries: options.sortDocumentSummaries,\n      },\n    );\n  const documentIds = Array.from(\n    new Set(\n      documentSummaries.flatMap((documentSummary) =>\n        documentSummary.documentId ? [documentSummary.documentId] : [],\n      ),\n    ),\n  );\n  const linkedContainerIdsByDocumentId = withoutHeldPlacements(\n    await sqlDocumentContainerProjectionPersistence.listLinkedContainerIdsByDocumentIds(\n      execSql,\n      documentIds,\n    ),\n    await listContainerDocumentTombstoneHoldsForDocuments(execSql, documentIds),\n  );\n\n  // An earlier link-id read can race a move. Recheck membership against the\n  // summaries and final link read so a fresh trash summary cannot ride stale\n  // root ids into the root view. Notification fences reject older summaries.\n  // A held placement (a listing tombstone awaiting signed evidence) is not a\n  // membership here either, matching the container item and sidebar views.\n  const requestedIds = new Set(containerIds);\n  return {\n    documentSummaries: documentSummaries.filter(\n      (summary) =>\n        (summary.containerId !== null &&\n          requestedIds.has(summary.containerId) &&\n          !linkedContainerIdsByDocumentId.held.has(\n            heldPlacementKey(summary.documentId, summary.containerId),\n          )) ||\n        (summary.documentId !== null &&\n          linkedContainerIdsByDocumentId.links\n            .get(summary.documentId)\n            ?.some((id) => requestedIds.has(id))),\n    ),\n    linkedContainerIdsByDocumentId: linkedContainerIdsByDocumentId.links,\n  };\n}\n\nfunction listContainerContentsContainerSubtreeIds(\n  containersById: ReadonlyMap<string, ContainerContentsContainerSubtreeState>,\n  rootContainerId: string,\n): string[] {\n  const childrenByParentId = new Map<string, string[]>();\n  for (const containerState of containersById.values()) {\n    const parentId = containerState.container.parentId;\n    if (parentId === null) {\n      continue;\n    }\n\n    const children = childrenByParentId.get(parentId);\n    if (children) {\n      children.push(containerState.container.id);\n    } else {\n      childrenByParentId.set(parentId, [containerState.container.id]);\n    }\n  }\n\n  const subtreeIds: string[] = [];\n  const stack = [rootContainerId];\n  const visited = new Set<string>();\n  while (stack.length > 0) {\n    const containerId = stack.pop();\n    if (containerId === undefined || visited.has(containerId)) {\n      continue;\n    }\n    visited.add(containerId);\n\n    if (containersById.has(containerId)) {\n      subtreeIds.push(containerId);\n    }\n\n    const children = childrenByParentId.get(containerId);\n    if (children) {\n      stack.push(...children);\n    }\n  }\n\n  return subtreeIds;\n}\n\nfunction resolveContainerContentsDocumentRuntimeContainerId(params: {\n  documentSummary: Pick<DocumentSummary, \"containerId\" | \"documentId\">;\n  linkedContainerIdsByDocumentId: ReadonlyMap<string, ReadonlyArray<string>>;\n  sharedContainerIds: ReadonlySet<string>;\n}): string | null {\n  const {\n    documentSummary,\n    linkedContainerIdsByDocumentId,\n    sharedContainerIds,\n  } = params;\n  if (\n    documentSummary.containerId &&\n    sharedContainerIds.has(documentSummary.containerId)\n  ) {\n    return documentSummary.containerId;\n  }\n\n  if (!documentSummary.documentId) {\n    return null;\n  }\n\n  return (\n    linkedContainerIdsByDocumentId\n      .get(documentSummary.documentId)\n      ?.find((containerId) => sharedContainerIds.has(containerId)) ?? null\n  );\n}\n\nasync function listDocumentRuntimeTargetsForContainerSubtree(input: {\n  containersById: ReadonlyMap<string, ContainerContentsContainerSubtreeState>;\n  execSql: ExecSql;\n  rootContainerId: string;\n}): Promise<ContainerContentsDocumentRuntimeTarget[]> {\n  const { containersById, execSql, rootContainerId } = input;\n  const sharedContainerIds = new Set(\n    listContainerContentsContainerSubtreeIds(containersById, rootContainerId),\n  );\n  if (sharedContainerIds.size === 0) {\n    return [];\n  }\n\n  const { documentSummaries, linkedContainerIdsByDocumentId } =\n    await listContainerContentsDocumentsForContainers(\n      execSql,\n      Array.from(sharedContainerIds),\n      { sortDocumentSummaries: true },\n    );\n\n  return documentSummaries.flatMap((documentSummary) => {\n    const runtimeContainerId =\n      resolveContainerContentsDocumentRuntimeContainerId({\n        documentSummary,\n        linkedContainerIdsByDocumentId,\n        sharedContainerIds,\n      });\n    if (!runtimeContainerId) {\n      return [];\n    }\n\n    return [\n      {\n        documentId: documentSummary.documentId,\n        localId: documentSummary.id,\n        runtimeContainerId,\n      },\n    ];\n  });\n}\n\nexport function listDocumentRuntimeTargetsForContainerSubtreeFromRuntime({\n  runtime,\n  ...input\n}: Omit<\n  Parameters<typeof listDocumentRuntimeTargetsForContainerSubtree>[0],\n  \"execSql\"\n> & {\n  runtime: ContainerDocumentQueriesRuntime;\n}): ReturnType<typeof listDocumentRuntimeTargetsForContainerSubtree> {\n  return listDocumentRuntimeTargetsForContainerSubtree({\n    ...input,\n    execSql: runtime.infra.execSql,\n  });\n}\n"]}

package/workflows/container-contents/documentQueries/index.d.ts

@@ -0,0 +1,62 @@
+import type { ContainerSystemSlot } from "../../../internal/validators/containerSystemSlot.js";
+import type { SyncWatermark } from "../../../internal/validators/response/index.js";
+import type { DiscoveredDocumentInput, DocumentSummary } from "../../../data/documents/documentSummary.js";
+import { type PendingWriteQueueItem } from "../pendingWrites/index.js";
+import { type RecoveryFolder } from "../recovery/folderRecovery.js";
+import type { ContainerDocumentObjectSyncState } from "../syncState.js";
+import { type PendingDownloadQueueItem } from "./pendingDownloads.js";
+import type { ContainerDocumentLinkInput, ContainerDocumentQueriesRuntime, ContainerDocumentSidebarWindow, ContainerDocumentTombstone, ContainerItemSort, ContainerItemWindow } from "./types.js";
+export type { ContainerDocumentLinkInput, ContainerDocumentSidebarRow, ContainerDocumentTombstone, ContainerItemRow, ContainerItemSort, ContainerItemSortDirection, ContainerItemSortKey, } from "./types.js";
+interface ListContainerItemWindowInput {
+    /** Null selects the virtual orphaned-documents recovery collection. */
+    containerId: string | null;
+    currentOrganizationId?: string | null | undefined;
+    limit: number;
+    offset: number;
+    sort: ContainerItemSort;
+    visibleForeignSystemContainerNames?: ReadonlyArray<string> | undefined;
+    visibleSystemSlots?: ReadonlyArray<ContainerSystemSlot> | undefined;
+}
+export interface ContainerDocumentQueries {
+    listRecoveryFolderMoveIds(input: {
+        currentOrganizationId: string | null;
+    }): Promise<string[]>;
+    listRecoveryFolders(input: {
+        currentOrganizationId: string | null;
+    }): Promise<RecoveryFolder[]>;
+    discardRecoveryFolder(input: Pick<RecoveryFolder, "containerId" | "organizationId" | "revision">): Promise<boolean>;
+    applyContainerDocumentTombstones(tombstones: ReadonlyArray<ContainerDocumentTombstone>): Promise<ReadonlyArray<DocumentSummary>>;
+    hasOrphanedDocuments(input: {
+        currentOrganizationId: string | null;
+    }): Promise<boolean>;
+    listContainerDocumentSidebarWindow(input: {
+        /** Null selects the virtual orphaned-documents recovery collection. */
+        containerId: string | null;
+        currentOrganizationId?: string | null | undefined;
+        limit: number;
+        offset: number;
+    }): Promise<ContainerDocumentSidebarWindow>;
+    listContainerItemWindow(input: ListContainerItemWindowInput): Promise<ContainerItemWindow>;
+    loadDocumentSyncState(localId: string): Promise<ContainerDocumentObjectSyncState | null>;
+    loadDocumentSummary(localId: string, options?: {
+        requireHydrated?: boolean;
+    }): Promise<DocumentSummary | null>;
+    loadOrphanedDocumentSummary(input: {
+        requireHydrated?: boolean;
+        currentOrganizationId: string | null;
+        localId: string;
+    }): Promise<DocumentSummary | null>;
+    loadContainerDocumentWatermark(containerId: string): Promise<SyncWatermark | null>;
+    listLinkedContainerIdsByDocumentIds(documentIds: ReadonlyArray<string>): Promise<ReadonlyMap<string, ReadonlyArray<string>>>;
+    listPendingDownloads(): Promise<ReadonlyArray<PendingDownloadQueueItem>>;
+    listPendingWrites(): Promise<ReadonlyArray<PendingWriteQueueItem>>;
+    retryPendingWriteItem(input: {
+        localId: string;
+        namespace: string | null;
+        objectKind: PendingWriteQueueItem["objectKind"];
+    }): Promise<void>;
+    replaceDocumentLinksBatch(inputs: ReadonlyArray<ContainerDocumentLinkInput>): Promise<void>;
+    saveContainerDocumentWatermark(containerId: string, watermark: SyncWatermark): Promise<void>;
+    upsertDiscoveredDocuments(inputs: ReadonlyArray<DiscoveredDocumentInput>): Promise<ReadonlyArray<DocumentSummary>>;
+}
+export declare function createContainerDocumentQueriesFromRuntime(runtime: ContainerDocumentQueriesRuntime): ContainerDocumentQueries;