@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/client/containerContents.js

@@ -0,0 +1,217 @@
+import { DEFAULT_DOCUMENT_KIND } from "../data/documents/documentConstants.js";
+import { getOrCreateContainerContentsStore, } from "../stores/container-contents/index.js";
+import { openDocumentStore } from "../stores/documents/index.js";
+import { relinkDocumentStoreWithCommitSideEffect } from "../stores/documents/documentStore/internalRelink.js";
+import { listBlobInfo, } from "../workflows/container-contents/blobInfo.js";
+import { loadContainerInfo, } from "../workflows/container-contents/containerInfo.js";
+import { loadDocumentAttributionRanges, } from "../workflows/container-contents/documentAttributionRanges.js";
+import { loadDocumentInfo, } from "../workflows/container-contents/documentInfo.js";
+import { purgeLocalContainerDocument, purgeRemoteContainerDocument, } from "../workflows/container-contents/documentPurge.js";
+import { createContainerDocumentQueriesFromRuntime, } from "../workflows/container-contents/documentQueries.js";
+import { activateDocumentLink, addDocumentLink, canMutateDocumentLink, canMutateLocalDocumentLink, moveDocumentLink, removeDocumentLink, } from "../workflows/container-contents/documentStructure.js";
+import { createContainerContentsDocumentProjectionUserKeyResolver } from "../workflows/container-contents/projectionKeys.js";
+import { createContainerContentsDocumentsRuntime, createContainerContentsStoreWorkflowRuntime, } from "../workflows/container-contents/runtime.js";
+import { createContainerDocumentObjectSyncState } from "../workflows/container-contents/syncState.js";
+import { discoverContainerDocumentsForRuntime } from "./containerDocumentDiscovery.js";
+import { createOrganizationReadModelCoordinator, } from "./organizations/organizationReadModels.js";
+export { createContainerDocumentObjectSyncState };
+export function createContainerContents(runtime) {
+    return new ContainerContentsService(runtime);
+}
+function createDocumentLinkHost(runtime, mergeDocumentSummary) {
+    return {
+        documentWorkflowRuntime: runtime.documentRuntime,
+        mergeDocumentSummary,
+        openDocumentStore: (input) => {
+            const store = runtime.openDocument({
+                containerId: input.containerId,
+                documentId: input.documentId,
+                localId: input.localId,
+            });
+            return {
+                ...store,
+                relink: ({ commitSideEffect, ...relinkInput }) => commitSideEffect
+                    ? relinkDocumentStoreWithCommitSideEffect(store, relinkInput, commitSideEffect)
+                    : store.relink(relinkInput),
+            };
+        },
+    };
+}
+function moveDocumentLinkNote(input) {
+    if (input.note.documentId &&
+        input.sourceContainerId &&
+        input.sourceContainerId !== input.note.containerId) {
+        return { ...input.note, containerId: input.sourceContainerId };
+    }
+    return input.note;
+}
+function readyExecSql(runtime) {
+    return runtime.infra.dbStatus === "ready" ? runtime.infra.execSql : null;
+}
+function isActiveContainerInfoOrganizationScope(runtime, scope) {
+    return (runtime.auth.isAuthenticated &&
+        runtime.auth.organizationId === scope.organizationId &&
+        runtime.auth.userId === scope.userId &&
+        runtime.state.domainScope === scope.domainScope);
+}
+function purgeDocumentFromLinks(input) {
+    const { note } = input.document;
+    if (!note.documentId) {
+        return purgeLocalContainerDocument({
+            noteId: note.id,
+            runtime: input.runtime,
+        });
+    }
+    return purgeRemoteContainerDocument({
+        documentId: note.documentId,
+        documentKind: note.documentKind ?? DEFAULT_DOCUMENT_KIND,
+        noteId: note.id,
+        resolveProjectionUserKey: input.resolveProjectionUserKey,
+        runtime: input.runtime,
+    });
+}
+class ContainerContentsService {
+    runtimeService;
+    organizationReadModels;
+    constructor(runtimeService) {
+        this.runtimeService = runtimeService;
+        this.organizationReadModels =
+            createOrganizationReadModelCoordinator(runtimeService);
+    }
+    openTree(options) {
+        const runtime = this.workflowRuntime();
+        const store = getOrCreateContainerContentsStore(runtime.state.domainScope, runtime, options);
+        return store;
+    }
+    documentQueries() {
+        return createContainerDocumentQueriesFromRuntime(this.workflowRuntime());
+    }
+    documentLinks() {
+        const runtime = this.workflowRuntime();
+        const resolveProjectionUserKey = createContainerContentsDocumentProjectionUserKeyResolver(runtime);
+        const documentRuntime = (containerId) => createContainerContentsDocumentsRuntime(runtime, containerId);
+        const openContainerDocument = (input) => openDocumentStore(runtime.state.domainScope, input.localId, documentRuntime(input.containerId), input.documentId ?? null, input.initialText, input.initialDocumentKind);
+        const documentLinks = {
+            ...runtime,
+            documentRuntime,
+            openDocument: openContainerDocument,
+            setActiveDocumentContainer: (input) => activateDocumentLink({
+                host: createDocumentLinkHost(documentLinks, input.mergeDocumentSummary),
+                note: input.note,
+                runtime: documentLinks,
+                targetContainerId: input.targetContainerId,
+            }),
+            canMutateDocumentLinks: canMutateDocumentLink(runtime),
+            canMutateUnsyncedDocumentLinks: canMutateLocalDocumentLink(runtime),
+            linkDocumentToContainer: (input) => addDocumentLink({
+                host: createDocumentLinkHost(documentLinks, input.mergeDocumentSummary),
+                note: input.note,
+                runtime: documentLinks,
+                scheduleSync: () => this.openTree().requestSync(),
+                setLinkedContainerIdsForDocument: input.setLinkedContainerIdsForDocument,
+                targetContainerId: input.targetContainerId,
+            }),
+            moveDocumentToContainer: (input) => moveDocumentLink({
+                expandNode: input.expandNode,
+                host: createDocumentLinkHost(documentLinks, input.mergeDocumentSummary),
+                note: moveDocumentLinkNote(input),
+                replaceLinkedContainers: input.replaceLinkedContainers,
+                runtime: documentLinks,
+                scheduleSync: () => this.openTree().requestSync(),
+                setLinkedContainerIdsForDocument: input.setLinkedContainerIdsForDocument,
+                targetContainerId: input.targetContainerId,
+            }),
+            purgeDocument: (document) => purgeDocumentFromLinks({
+                document,
+                resolveProjectionUserKey,
+                runtime: documentLinks,
+            }),
+            resolveProjectionUserKey,
+            unlinkDocumentFromContainer: (input) => removeDocumentLink({
+                host: createDocumentLinkHost(documentLinks, input.mergeDocumentSummary),
+                note: input.note,
+                removedContainerId: input.removedContainerId,
+                runtime: documentLinks,
+                scheduleSync: () => this.openTree().requestSync(),
+                setLinkedContainerIdsForDocument: input.setLinkedContainerIdsForDocument,
+            }),
+        };
+        return documentLinks;
+    }
+    discoverContainerDocuments(containerId) {
+        return discoverContainerDocumentsForRuntime({
+            containerId,
+            runtimeService: this.runtimeService,
+        });
+    }
+    pullDocumentContent(input) {
+        const runtime = this.workflowRuntime();
+        const store = openDocumentStore(runtime.state.domainScope, input.localId, createContainerContentsDocumentsRuntime(runtime, input.containerId), input.documentId ?? null);
+        store.requestRemoteSync();
+    }
+    loadContainerInfo(input) {
+        const runtime = this.runtimeService.workflowInput();
+        const organizationScope = runtime.auth.isAuthenticated &&
+            runtime.auth.organizationId &&
+            runtime.auth.userId
+            ? {
+                domainScope: runtime.state.domainScope,
+                organizationId: runtime.auth.organizationId,
+                userId: runtime.auth.userId,
+            }
+            : null;
+        const cachedContainerProjection = input.remoteInfoMode === "always"
+            ? null
+            : this.openTree().getCachedContainerWriterProjection(input.containerId);
+        return loadContainerInfo({
+            ...input,
+            apiClient: runtime.apiClient,
+            containerProjection: cachedContainerProjection,
+            execSql: readyExecSql(runtime),
+            loadOrganizationGroups: async () => {
+                if (!organizationScope ||
+                    !isActiveContainerInfoOrganizationScope(this.runtimeService.workflowInput(), organizationScope)) {
+                    return [];
+                }
+                // Organization groups are disposable presentation data. Container
+                // writer projections remain the authority for grants and access.
+                const projection = await this.organizationReadModels.loadLocal(organizationScope.organizationId);
+                return isActiveContainerInfoOrganizationScope(this.runtimeService.workflowInput(), organizationScope)
+                    ? (projection?.groups ?? [])
+                    : [];
+            },
+            parentId: input.parentId ?? null,
+        });
+    }
+    loadDocumentInfo(input) {
+        const runtime = this.runtimeService.workflowInput();
+        return loadDocumentInfo({
+            ...input,
+            apiClient: runtime.apiClient,
+            execSql: readyExecSql(runtime),
+            reportSecurityIncident: runtime.util.reportSecurityIncident,
+        });
+    }
+    loadDocumentEditAttribution(documentId) {
+        return this.runtimeService
+            .workflowInput()
+            .apiClient.getDocumentEditAttribution(documentId);
+    }
+    loadDocumentAttributionRanges(input) {
+        return loadDocumentAttributionRanges({
+            apiClient: this.runtimeService.workflowInput().apiClient,
+            query: input,
+        });
+    }
+    listBlobInfo(input = {}) {
+        const runtime = this.runtimeService.workflowInput();
+        return listBlobInfo({
+            ...input,
+            execSql: readyExecSql(runtime),
+        });
+    }
+    workflowRuntime() {
+        return createContainerContentsStoreWorkflowRuntime(this.runtimeService.workflowInput(), this.runtimeService.adoptRootContainer);
+    }
+}
+//# sourceMappingURL=containerContents.js.map

package/client/containerContents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerContents.js","sourceRoot":"","sources":["containerContents.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_DOCUMENT_KIND } from \"../data/documents/documentConstants\";\nimport type { DocumentSummary } from \"../data/documents/documentSummary\";\nimport {\n  type ContainerContentsStore,\n  type ContainerContentsStoreOptions,\n  getOrCreateContainerContentsStore,\n} from \"../stores/container-contents\";\nimport { openDocumentStore } from \"../stores/documents\";\nimport { relinkDocumentStoreWithCommitSideEffect } from \"../stores/documents/documentStore/internalRelink\";\nimport {\n  type BlobInfoInput,\n  type BlobInfoList,\n  listBlobInfo,\n} from \"../workflows/container-contents/blobInfo\";\nimport {\n  type ContainerInfo,\n  loadContainerInfo,\n} from \"../workflows/container-contents/containerInfo\";\nimport {\n  type DocumentAttributionRangesInput,\n  type DocumentAttributionRangesPage,\n  loadDocumentAttributionRanges,\n} from \"../workflows/container-contents/documentAttributionRanges\";\nimport {\n  type DocumentInfo,\n  loadDocumentInfo,\n} from \"../workflows/container-contents/documentInfo\";\nimport {\n  purgeLocalContainerDocument,\n  purgeRemoteContainerDocument,\n} from \"../workflows/container-contents/documentPurge\";\nimport {\n  type ContainerDocumentQueries,\n  createContainerDocumentQueriesFromRuntime,\n} from \"../workflows/container-contents/documentQueries\";\nimport {\n  activateDocumentLink,\n  addDocumentLink,\n  canMutateDocumentLink,\n  canMutateLocalDocumentLink,\n  type DocumentStructuralMutationHost,\n  moveDocumentLink,\n  removeDocumentLink,\n} from \"../workflows/container-contents/documentStructure\";\nimport { createContainerContentsDocumentProjectionUserKeyResolver } from \"../workflows/container-contents/projectionKeys\";\nimport {\n  type ContainerContentsStoreWorkflowRuntime,\n  createContainerContentsDocumentsRuntime,\n  createContainerContentsStoreWorkflowRuntime,\n} from \"../workflows/container-contents/runtime\";\nimport { createContainerDocumentObjectSyncState } from \"../workflows/container-contents/syncState\";\nimport type { DocumentsWorkflowRuntime } from \"../workflows/documents\";\nimport type {\n  ContainerContents,\n  ContainerDocumentLinks,\n  ContainerInfoInput,\n  DocumentInfoInput,\n  MergeDocumentSummary,\n  MoveDocumentToContainerInput,\n  OpenContainerDocumentInput,\n} from \"./containerContentsTypes\";\nimport { discoverContainerDocumentsForRuntime } from \"./containerDocumentDiscovery\";\nimport {\n  createOrganizationReadModelCoordinator,\n  type OrganizationReadModelCoordinator,\n} from \"./organizations/organizationReadModels\";\nimport type {\n  InternalRuntime,\n  InternalWorkflowRuntimeInput,\n} from \"./workflowRuntime\";\n\nexport type {\n  ContainerContentsContextValue,\n  ContainerContentsStore,\n  ContainerContentsStoreOptions,\n  ContainerNode,\n} from \"../stores/container-contents\";\nexport type {\n  BlobInfo,\n  BlobInfoAttachmentKind,\n  BlobInfoDocumentReference,\n  BlobInfoInput,\n  BlobInfoList,\n  BlobInfoSort,\n  BlobInfoSortDirection,\n  BlobInfoSortKey,\n} from \"../workflows/container-contents/blobInfo\";\nexport type {\n  ContainerInfo,\n  ContainerShareAccessLevel,\n} from \"../workflows/container-contents/containerInfo\";\nexport type {\n  DocumentAttributionRangesInput,\n  DocumentAttributionRangesPage,\n} from \"../workflows/container-contents/documentAttributionRanges\";\nexport type { DocumentInfo } from \"../workflows/container-contents/documentInfo\";\nexport type {\n  ContainerDocumentQueries,\n  ContainerDocumentSidebarRow,\n  ContainerItemRow,\n  ContainerItemSort,\n  ContainerItemSortDirection,\n  ContainerItemSortKey,\n} from \"../workflows/container-contents/documentQueries\";\nexport type { SetLinkedContainerIdsForDocument } from \"../workflows/container-contents/documentStructure\";\nexport type {\n  PendingWriteQueueItem,\n  PendingWriteQueueItemStatus,\n  PendingWriteQueueObjectKind,\n  PendingWriteQueueOperation,\n  PendingWriteQueueOperationKind,\n  PendingWriteQueueOperationStatus,\n} from \"../workflows/container-contents/pendingWrites\";\nexport type {\n  ContainerDocumentObjectSyncState,\n  ContainerDocumentObjectSyncStatus,\n} from \"../workflows/container-contents/syncState\";\nexport type {\n  ContainerContents,\n  ContainerDocumentLinkInput,\n  ContainerDocumentLinks,\n  ContainerInfoInput,\n  DocumentInfoInput,\n  LinkDocumentToContainerInput,\n  MergeDocumentSummary,\n  MoveDocumentToContainerInput,\n  OpenContainerDocumentInput,\n  PurgeDocumentInput,\n  PurgeDocumentResult,\n  SetActiveDocumentContainerInput,\n  UnlinkDocumentFromContainerInput,\n} from \"./containerContentsTypes\";\n\nexport { createContainerDocumentObjectSyncState };\n\nexport function createContainerContents(\n  runtime: InternalRuntime,\n): ContainerContents {\n  return new ContainerContentsService(runtime);\n}\n\nfunction createDocumentLinkHost(\n  runtime: ContainerDocumentLinks,\n  mergeDocumentSummary: MergeDocumentSummary,\n): DocumentStructuralMutationHost<DocumentsWorkflowRuntime> {\n  return {\n    documentWorkflowRuntime: runtime.documentRuntime,\n    mergeDocumentSummary,\n    openDocumentStore: (input) => {\n      const store = runtime.openDocument({\n        containerId: input.containerId,\n        documentId: input.documentId,\n        localId: input.localId,\n      });\n      return {\n        ...store,\n        relink: ({ commitSideEffect, ...relinkInput }) =>\n          commitSideEffect\n            ? relinkDocumentStoreWithCommitSideEffect(\n                store,\n                relinkInput,\n                commitSideEffect,\n              )\n            : store.relink(relinkInput),\n      };\n    },\n  };\n}\n\nfunction moveDocumentLinkNote(\n  input: Pick<MoveDocumentToContainerInput, \"note\" | \"sourceContainerId\">,\n): DocumentSummary {\n  if (\n    input.note.documentId &&\n    input.sourceContainerId &&\n    input.sourceContainerId !== input.note.containerId\n  ) {\n    return { ...input.note, containerId: input.sourceContainerId };\n  }\n\n  return input.note;\n}\n\ninterface ContainerInfoOrganizationScope {\n  readonly domainScope: InternalWorkflowRuntimeInput[\"state\"][\"domainScope\"];\n  readonly organizationId: string;\n  readonly userId: string;\n}\n\nfunction readyExecSql(\n  runtime: InternalWorkflowRuntimeInput,\n): InternalWorkflowRuntimeInput[\"infra\"][\"execSql\"] | null {\n  return runtime.infra.dbStatus === \"ready\" ? runtime.infra.execSql : null;\n}\n\nfunction isActiveContainerInfoOrganizationScope(\n  runtime: InternalWorkflowRuntimeInput,\n  scope: ContainerInfoOrganizationScope,\n): boolean {\n  return (\n    runtime.auth.isAuthenticated &&\n    runtime.auth.organizationId === scope.organizationId &&\n    runtime.auth.userId === scope.userId &&\n    runtime.state.domainScope === scope.domainScope\n  );\n}\n\nfunction purgeDocumentFromLinks(input: {\n  readonly document: Parameters<ContainerDocumentLinks[\"purgeDocument\"]>[0];\n  readonly resolveProjectionUserKey: ContainerDocumentLinks[\"resolveProjectionUserKey\"];\n  readonly runtime: ContainerDocumentLinks;\n}) {\n  const { note } = input.document;\n  if (!note.documentId) {\n    return purgeLocalContainerDocument({\n      noteId: note.id,\n      runtime: input.runtime,\n    });\n  }\n  return purgeRemoteContainerDocument({\n    documentId: note.documentId,\n    documentKind: note.documentKind ?? DEFAULT_DOCUMENT_KIND,\n    noteId: note.id,\n    resolveProjectionUserKey: input.resolveProjectionUserKey,\n    runtime: input.runtime,\n  });\n}\n\nclass ContainerContentsService implements ContainerContents {\n  private readonly organizationReadModels: OrganizationReadModelCoordinator;\n\n  constructor(private readonly runtimeService: InternalRuntime) {\n    this.organizationReadModels =\n      createOrganizationReadModelCoordinator(runtimeService);\n  }\n\n  openTree(\n    options?: ContainerContentsStoreOptions | undefined,\n  ): ContainerContentsStore {\n    const runtime = this.workflowRuntime();\n    const store = getOrCreateContainerContentsStore(\n      runtime.state.domainScope,\n      runtime,\n      options,\n    );\n    return store;\n  }\n\n  documentQueries(): ContainerDocumentQueries {\n    return createContainerDocumentQueriesFromRuntime(this.workflowRuntime());\n  }\n\n  documentLinks(): ContainerDocumentLinks {\n    const runtime = this.workflowRuntime();\n    const resolveProjectionUserKey =\n      createContainerContentsDocumentProjectionUserKeyResolver(runtime);\n    const documentRuntime = (containerId: string | null) =>\n      createContainerContentsDocumentsRuntime(runtime, containerId);\n    const openContainerDocument = (input: OpenContainerDocumentInput) =>\n      openDocumentStore(\n        runtime.state.domainScope,\n        input.localId,\n        documentRuntime(input.containerId),\n        input.documentId ?? null,\n        input.initialText,\n        input.initialDocumentKind,\n      );\n    const documentLinks: ContainerDocumentLinks = {\n      ...runtime,\n      documentRuntime,\n      openDocument: openContainerDocument,\n      setActiveDocumentContainer: (input) =>\n        activateDocumentLink({\n          host: createDocumentLinkHost(\n            documentLinks,\n            input.mergeDocumentSummary,\n          ),\n          note: input.note,\n          runtime: documentLinks,\n          targetContainerId: input.targetContainerId,\n        }),\n      canMutateDocumentLinks: canMutateDocumentLink(runtime),\n      canMutateUnsyncedDocumentLinks: canMutateLocalDocumentLink(runtime),\n      linkDocumentToContainer: (input) =>\n        addDocumentLink({\n          host: createDocumentLinkHost(\n            documentLinks,\n            input.mergeDocumentSummary,\n          ),\n          note: input.note,\n          runtime: documentLinks,\n          scheduleSync: () => this.openTree().requestSync(),\n          setLinkedContainerIdsForDocument:\n            input.setLinkedContainerIdsForDocument,\n          targetContainerId: input.targetContainerId,\n        }),\n      moveDocumentToContainer: (input) =>\n        moveDocumentLink({\n          expandNode: input.expandNode,\n          host: createDocumentLinkHost(\n            documentLinks,\n            input.mergeDocumentSummary,\n          ),\n          note: moveDocumentLinkNote(input),\n          replaceLinkedContainers: input.replaceLinkedContainers,\n          runtime: documentLinks,\n          scheduleSync: () => this.openTree().requestSync(),\n          setLinkedContainerIdsForDocument:\n            input.setLinkedContainerIdsForDocument,\n          targetContainerId: input.targetContainerId,\n        }),\n      purgeDocument: (document) =>\n        purgeDocumentFromLinks({\n          document,\n          resolveProjectionUserKey,\n          runtime: documentLinks,\n        }),\n      resolveProjectionUserKey,\n      unlinkDocumentFromContainer: (input) =>\n        removeDocumentLink({\n          host: createDocumentLinkHost(\n            documentLinks,\n            input.mergeDocumentSummary,\n          ),\n          note: input.note,\n          removedContainerId: input.removedContainerId,\n          runtime: documentLinks,\n          scheduleSync: () => this.openTree().requestSync(),\n          setLinkedContainerIdsForDocument:\n            input.setLinkedContainerIdsForDocument,\n        }),\n    };\n\n    return documentLinks;\n  }\n\n  discoverContainerDocuments(\n    containerId: string,\n  ): Promise<ReadonlyArray<DocumentSummary> | null> {\n    return discoverContainerDocumentsForRuntime({\n      containerId,\n      runtimeService: this.runtimeService,\n    });\n  }\n\n  pullDocumentContent(input: {\n    containerId: string;\n    localId: string;\n    documentId?: string | null | undefined;\n  }): void {\n    const runtime = this.workflowRuntime();\n    const store = openDocumentStore(\n      runtime.state.domainScope,\n      input.localId,\n      createContainerContentsDocumentsRuntime(runtime, input.containerId),\n      input.documentId ?? null,\n    );\n    store.requestRemoteSync();\n  }\n\n  loadContainerInfo(input: ContainerInfoInput): Promise<ContainerInfo> {\n    const runtime = this.runtimeService.workflowInput();\n    const organizationScope =\n      runtime.auth.isAuthenticated &&\n      runtime.auth.organizationId &&\n      runtime.auth.userId\n        ? {\n            domainScope: runtime.state.domainScope,\n            organizationId: runtime.auth.organizationId,\n            userId: runtime.auth.userId,\n          }\n        : null;\n    const cachedContainerProjection =\n      input.remoteInfoMode === \"always\"\n        ? null\n        : this.openTree().getCachedContainerWriterProjection(input.containerId);\n    return loadContainerInfo({\n      ...input,\n      apiClient: runtime.apiClient,\n      containerProjection: cachedContainerProjection,\n      execSql: readyExecSql(runtime),\n      loadOrganizationGroups: async () => {\n        if (\n          !organizationScope ||\n          !isActiveContainerInfoOrganizationScope(\n            this.runtimeService.workflowInput(),\n            organizationScope,\n          )\n        ) {\n          return [];\n        }\n        // Organization groups are disposable presentation data. Container\n        // writer projections remain the authority for grants and access.\n        const projection = await this.organizationReadModels.loadLocal(\n          organizationScope.organizationId,\n        );\n        return isActiveContainerInfoOrganizationScope(\n          this.runtimeService.workflowInput(),\n          organizationScope,\n        )\n          ? (projection?.groups ?? [])\n          : [];\n      },\n      parentId: input.parentId ?? null,\n    });\n  }\n\n  loadDocumentInfo(input: DocumentInfoInput): Promise<DocumentInfo> {\n    const runtime = this.runtimeService.workflowInput();\n    return loadDocumentInfo({\n      ...input,\n      apiClient: runtime.apiClient,\n      execSql: readyExecSql(runtime),\n      reportSecurityIncident: runtime.util.reportSecurityIncident,\n    });\n  }\n\n  loadDocumentEditAttribution(\n    documentId: string,\n  ): ReturnType<ContainerContents[\"loadDocumentEditAttribution\"]> {\n    return this.runtimeService\n      .workflowInput()\n      .apiClient.getDocumentEditAttribution(documentId);\n  }\n\n  loadDocumentAttributionRanges(\n    input: DocumentAttributionRangesInput,\n  ): Promise<DocumentAttributionRangesPage> {\n    return loadDocumentAttributionRanges({\n      apiClient: this.runtimeService.workflowInput().apiClient,\n      query: input,\n    });\n  }\n\n  listBlobInfo(input: BlobInfoInput = {}): Promise<BlobInfoList> {\n    const runtime = this.runtimeService.workflowInput();\n    return listBlobInfo({\n      ...input,\n      execSql: readyExecSql(runtime),\n    });\n  }\n\n  workflowRuntime(): ContainerContentsStoreWorkflowRuntime {\n    return createContainerContentsStoreWorkflowRuntime(\n      this.runtimeService.workflowInput(),\n      this.runtimeService.adoptRootContainer,\n    );\n  }\n}\n"]}

package/client/containerContentsTypes.d.ts

@@ -0,0 +1,230 @@
+import type { DocumentEditAttributionResponse } from "../internal/validators/response/index.js";
+import type { StoredDocumentKind } from "../data/documents/documentKinds.js";
+import type { DocumentSummary } from "../data/documents/documentSummary.js";
+import type { ContainerContentsStore, ContainerContentsStoreOptions, ContainerContentsStoreRuntime } from "../stores/container-contents/index.js";
+import type { DocumentStore } from "../stores/documents/index.js";
+import type { BlobInfoInput, BlobInfoList } from "../workflows/container-contents/blobInfo.js";
+import type { ContainerInfo, ContainerInfoRemoteMode } from "../workflows/container-contents/containerInfo.js";
+import type { DocumentAttributionRangesInput, DocumentAttributionRangesPage } from "../workflows/container-contents/documentAttributionRanges.js";
+import type { DocumentInfo, DocumentInfoRemoteMode } from "../workflows/container-contents/documentInfo.js";
+import type { ContainerDocumentQueries } from "../workflows/container-contents/documentQueries.js";
+import type { SetLinkedContainerIdsForDocument } from "../workflows/container-contents/documentStructure.js";
+import type { ContainerContentsProjectionUserKeyResolver } from "../workflows/container-contents/projectionKeys.js";
+import type { ContainerContentsWorkflowRuntime } from "../workflows/container-contents/runtime.js";
+import type { DocumentsWorkflowRuntime } from "../workflows/documents/index.js";
+/**
+ * Selects the container to inspect.
+ *
+ * Container info combines local SQLite timestamps with optional remote writer
+ * projection details. Remote details include direct and inherited grants,
+ * organization groups, security-path metadata, and sync watermarks for the
+ * parent, child-container, and document lanes.
+ *
+ * Fields:
+ * - `containerId`: Container id to inspect.
+ * - `parentId`: Known parent id used when the container has not been synced
+ *   locally yet. Synced local state wins when available.
+ * - `remoteInfoMode`: Controls whether remote projection details are fetched.
+ */
+export interface ContainerInfoInput {
+    containerId: string;
+    parentId?: string | null | undefined;
+    remoteInfoMode?: ContainerInfoRemoteMode | undefined;
+}
+/**
+ * Selects the document to inspect.
+ *
+ * Document info combines local document state, local and pending attachment
+ * rows, and optional remote writer projection details.
+ *
+ * Fields:
+ * - `attributionRequestKey`: Optional freshness generation used to coalesce
+ *   duplicate attribution reads without joining requests across invalidation.
+ * - `localId`: Local document id stored in the client database.
+ * - `remoteInfoMode`: Controls whether remote projection details are fetched.
+ */
+export interface DocumentInfoInput {
+    attributionRequestKey?: string | undefined;
+    localId: string;
+    remoteInfoMode?: DocumentInfoRemoteMode | undefined;
+}
+export type MergeDocumentSummary = (nextDocument: DocumentSummary) => void;
+export interface OpenContainerDocumentInput {
+    readonly containerId: string | null;
+    readonly documentId?: string | null | undefined;
+    readonly initialDocumentKind?: StoredDocumentKind | undefined;
+    readonly initialText?: string | undefined;
+    readonly localId: string;
+}
+export interface ContainerDocumentLinkInput {
+    readonly mergeDocumentSummary: MergeDocumentSummary;
+    readonly note: DocumentSummary;
+}
+export interface MoveDocumentToContainerInput extends ContainerDocumentLinkInput {
+    readonly expandNode: (nodeId: string) => void;
+    readonly replaceLinkedContainers?: boolean | undefined;
+    readonly setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;
+    readonly sourceContainerId?: string | null | undefined;
+    readonly targetContainerId: string;
+}
+export interface LinkDocumentToContainerInput extends ContainerDocumentLinkInput {
+    readonly setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;
+    readonly targetContainerId: string;
+}
+export interface UnlinkDocumentFromContainerInput extends ContainerDocumentLinkInput {
+    readonly removedContainerId: string;
+    readonly setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;
+}
+export interface SetActiveDocumentContainerInput extends ContainerDocumentLinkInput {
+    readonly targetContainerId: string;
+}
+export interface PurgeDocumentInput {
+    /** The current local summary of the document to destroy. */
+    readonly note: DocumentSummary;
+}
+export interface PurgeDocumentResult {
+    readonly documentId: string;
+    readonly purgedAt: string;
+    readonly reclaimedBlobStorageKeys: ReadonlyArray<string>;
+}
+export interface ContainerDocumentLinks extends ContainerContentsWorkflowRuntime {
+    documentRuntime(containerId: string | null): DocumentsWorkflowRuntime;
+    openDocument(input: OpenContainerDocumentInput): DocumentStore;
+    setActiveDocumentContainer(input: SetActiveDocumentContainerInput): Promise<DocumentSummary | null>;
+    readonly canMutateDocumentLinks: boolean;
+    readonly canMutateUnsyncedDocumentLinks: boolean;
+    linkDocumentToContainer(input: LinkDocumentToContainerInput): Promise<DocumentSummary | null>;
+    moveDocumentToContainer(input: MoveDocumentToContainerInput): Promise<{
+        linksChanged: boolean;
+        note: DocumentSummary | null;
+    }>;
+    /**
+     * Permanently destroy a local-only document, or submit and verify a signed
+     * terminal purge for a remote document. Remote purge requires exactly one
+     * remaining container link and returns null on refusal or verification
+     * failure.
+     */
+    purgeDocument(input: PurgeDocumentInput): Promise<PurgeDocumentResult | null>;
+    readonly resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;
+    unlinkDocumentFromContainer(input: UnlinkDocumentFromContainerInput): Promise<DocumentSummary | null>;
+}
+/**
+ * High-level container-content service for tree state, document lists, document
+ * links, discovery, and diagnostics.
+ *
+ * The facade owns the normal SDK protocol: it supplies the API client,
+ * referenced-principal policy cache, local document query helpers, link
+ * projection, tombstone handling, and sync watermarks. Consumers that need a
+ * custom persistence protocol can call the lower-level workflows directly from
+ * `@tearleads/client-sdk`.
+ */
+export interface ContainerContents {
+    /**
+     * Open the container tree state store for the current SDK runtime.
+     *
+     * The store is cached per domain scope and created from the current runtime
+     * snapshot. Long-lived hosts should call `updateRuntime` after runtime
+     * changes, such as from a React effect.
+     */
+    openTree(options?: ContainerContentsStoreOptions | undefined): ContainerContentsStore;
+    /**
+     * Create local document query helpers for container contents.
+     *
+     * The facade is bound to the current SDK runtime snapshot, including the
+     * active SQLite executor. Recreate it when the SDK runtime version changes.
+     */
+    documentQueries(): ContainerDocumentQueries;
+    /**
+     * Create the default document-link workflow helper.
+     *
+     * The returned object includes the current container-contents runtime,
+     * the document projection-key resolver, mutation readiness, document store
+     * priming, and container document-link mutations. Product stores can pass
+     * this bundle around without rebuilding SDK runtime plumbing themselves.
+     */
+    documentLinks(): ContainerDocumentLinks;
+    /**
+     * Discover remote documents linked to one container.
+     *
+     * The method pages the remote container-document lane, writes discovered
+     * document summaries into local SQLite, replaces the local link projection for
+     * each discovered document, applies applicable tombstones, caches referenced
+     * principal policies needed by newly visible documents, and advances the
+     * container-document watermark after the local apply completes.
+     *
+     * One call verifies a bounded batch. Pending evidence is durable; a later
+     * explicit call or background reconciliation resumes it.
+     *
+     * Returns the summaries touched by the apply, or `null` when the database or
+     * listing is unavailable, a trust reset cancels the pass, or all evidence is
+     * pending. Pending evidence may advance the watermark after durable staging.
+     *
+     * Parameters:
+     * - `containerId`: Remote container id whose document lane should be listed.
+     */
+    discoverContainerDocuments(containerId: string): Promise<ReadonlyArray<DocumentSummary> | null>;
+    /**
+     * Sync the content of a single document that no mini-app has opened.
+     *
+     * Discovery only records a document's metadata + an empty content shell, and a
+     * document's locally authored content is only pushed once its store syncs; both
+     * normally happen lazily when a mini-app opens the document. Some documents are
+     * never opened yet still need to sync — notably the organization profile
+     * document, which lives in an org's Members-granted metadata container and
+     * holds the org display name. This opens a transient document store (registered
+     * under the container's keys, so it can decrypt) and schedules a remote sync
+     * pass. The pass both pushes the store's pending updates and merges + persists
+     * any remote body, so the same call lets an owning device publish its profile
+     * content and a member device pull it. `documentId` may be omitted; the store
+     * then resolves it from the persisted record (the owning device keys the
+     * document under a local alias, not its server id).
+     */
+    pullDocumentContent(input: {
+        containerId: string;
+        localId: string;
+        documentId?: string | null | undefined;
+    }): void;
+    /**
+     * Load diagnostic information for one local document.
+     *
+     * Local details are available when SQLite is ready. Remote details are loaded
+     * from the document writer projection according to `remoteInfoMode`; the
+     * default is `"if-synced"`.
+     */
+    loadDocumentInfo(input: DocumentInfoInput): Promise<DocumentInfo>;
+    /**
+     * Fetch a synced document's compact edit-attribution segments (peer -> writer
+     * intervals) on their own, without the writer-projection/attachment work
+     * `loadDocumentInfo` also does. Resolves to `null` on any request failure.
+     * Callers must ignore the segments when `truncated` is set — a truncated
+     * interval list can drop a peer's segments and mis-resolve it.
+     */
+    loadDocumentEditAttribution(documentId: string): Promise<DocumentEditAttributionResponse | null>;
+    /** Load one revision-bound page of detailed per-upload edit attribution. */
+    loadDocumentAttributionRanges(input: DocumentAttributionRangesInput): Promise<DocumentAttributionRangesPage>;
+    /**
+     * List local blob projections and pending attachment bytes grouped by blob.
+     *
+     * This is a reverse lookup query: callers can search by server blob id,
+     * local storage key, document id/title, attachment slot, or MIME metadata and
+     * then traverse matching blobs back to their owning local documents.
+     */
+    listBlobInfo(input?: BlobInfoInput | undefined): Promise<BlobInfoList>;
+    /**
+     * Load diagnostic information for one container.
+     *
+     * Local details include synced timestamps. Remote details are loaded from the
+     * container writer projection according to `remoteInfoMode`; the default is
+     * `"always"`. Pass `parentId` when inspecting a container before its local row
+     * has been synced.
+     */
+    loadContainerInfo(input: ContainerInfoInput): Promise<ContainerInfo>;
+    /**
+     * Create a workflow runtime for advanced container-content workflows.
+     *
+     * Prefer the high-level methods on this service for the default SDK protocol.
+     * Use this when constructing lower-level stores or custom workflows that need
+     * access to the current runtime snapshot.
+     */
+    workflowRuntime(): ContainerContentsStoreRuntime;
+}

package/client/containerContentsTypes.js

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

package/client/containerContentsTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerContentsTypes.js","sourceRoot":"","sources":["containerContentsTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentEditAttributionResponse } from \"@tearleads/validators/response\";\nimport type { StoredDocumentKind } from \"../data/documents/documentKinds\";\nimport type { DocumentSummary } from \"../data/documents/documentSummary\";\nimport type {\n  ContainerContentsStore,\n  ContainerContentsStoreOptions,\n  ContainerContentsStoreRuntime,\n} from \"../stores/container-contents\";\nimport type { DocumentStore } from \"../stores/documents\";\nimport type {\n  BlobInfoInput,\n  BlobInfoList,\n} from \"../workflows/container-contents/blobInfo\";\nimport type {\n  ContainerInfo,\n  ContainerInfoRemoteMode,\n} from \"../workflows/container-contents/containerInfo\";\nimport type {\n  DocumentAttributionRangesInput,\n  DocumentAttributionRangesPage,\n} from \"../workflows/container-contents/documentAttributionRanges\";\nimport type {\n  DocumentInfo,\n  DocumentInfoRemoteMode,\n} from \"../workflows/container-contents/documentInfo\";\nimport type { ContainerDocumentQueries } from \"../workflows/container-contents/documentQueries\";\nimport type { SetLinkedContainerIdsForDocument } from \"../workflows/container-contents/documentStructure\";\nimport type { ContainerContentsProjectionUserKeyResolver } from \"../workflows/container-contents/projectionKeys\";\nimport type { ContainerContentsWorkflowRuntime } from \"../workflows/container-contents/runtime\";\nimport type { DocumentsWorkflowRuntime } from \"../workflows/documents\";\n\n/**\n * Selects the container to inspect.\n *\n * Container info combines local SQLite timestamps with optional remote writer\n * projection details. Remote details include direct and inherited grants,\n * organization groups, security-path metadata, and sync watermarks for the\n * parent, child-container, and document lanes.\n *\n * Fields:\n * - `containerId`: Container id to inspect.\n * - `parentId`: Known parent id used when the container has not been synced\n *   locally yet. Synced local state wins when available.\n * - `remoteInfoMode`: Controls whether remote projection details are fetched.\n */\nexport interface ContainerInfoInput {\n  containerId: string;\n  parentId?: string | null | undefined;\n  remoteInfoMode?: ContainerInfoRemoteMode | undefined;\n}\n\n/**\n * Selects the document to inspect.\n *\n * Document info combines local document state, local and pending attachment\n * rows, and optional remote writer projection details.\n *\n * Fields:\n * - `attributionRequestKey`: Optional freshness generation used to coalesce\n *   duplicate attribution reads without joining requests across invalidation.\n * - `localId`: Local document id stored in the client database.\n * - `remoteInfoMode`: Controls whether remote projection details are fetched.\n */\nexport interface DocumentInfoInput {\n  attributionRequestKey?: string | undefined;\n  localId: string;\n  remoteInfoMode?: DocumentInfoRemoteMode | undefined;\n}\n\nexport type MergeDocumentSummary = (nextDocument: DocumentSummary) => void;\n\nexport interface OpenContainerDocumentInput {\n  readonly containerId: string | null;\n  readonly documentId?: string | null | undefined;\n  readonly initialDocumentKind?: StoredDocumentKind | undefined;\n  readonly initialText?: string | undefined;\n  readonly localId: string;\n}\n\nexport interface ContainerDocumentLinkInput {\n  readonly mergeDocumentSummary: MergeDocumentSummary;\n  readonly note: DocumentSummary;\n}\n\nexport interface MoveDocumentToContainerInput\n  extends ContainerDocumentLinkInput {\n  readonly expandNode: (nodeId: string) => void;\n  readonly replaceLinkedContainers?: boolean | undefined;\n  readonly setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n  readonly sourceContainerId?: string | null | undefined;\n  readonly targetContainerId: string;\n}\n\nexport interface LinkDocumentToContainerInput\n  extends ContainerDocumentLinkInput {\n  readonly setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n  readonly targetContainerId: string;\n}\n\nexport interface UnlinkDocumentFromContainerInput\n  extends ContainerDocumentLinkInput {\n  readonly removedContainerId: string;\n  readonly setLinkedContainerIdsForDocument: SetLinkedContainerIdsForDocument;\n}\n\nexport interface SetActiveDocumentContainerInput\n  extends ContainerDocumentLinkInput {\n  readonly targetContainerId: string;\n}\n\nexport interface PurgeDocumentInput {\n  /** The current local summary of the document to destroy. */\n  readonly note: DocumentSummary;\n}\n\nexport interface PurgeDocumentResult {\n  readonly documentId: string;\n  readonly purgedAt: string;\n  readonly reclaimedBlobStorageKeys: ReadonlyArray<string>;\n}\n\nexport interface ContainerDocumentLinks\n  extends ContainerContentsWorkflowRuntime {\n  documentRuntime(containerId: string | null): DocumentsWorkflowRuntime;\n  openDocument(input: OpenContainerDocumentInput): DocumentStore;\n  setActiveDocumentContainer(\n    input: SetActiveDocumentContainerInput,\n  ): Promise<DocumentSummary | null>;\n  readonly canMutateDocumentLinks: boolean;\n  readonly canMutateUnsyncedDocumentLinks: boolean;\n  linkDocumentToContainer(\n    input: LinkDocumentToContainerInput,\n  ): Promise<DocumentSummary | null>;\n  moveDocumentToContainer(\n    input: MoveDocumentToContainerInput,\n  ): Promise<{ linksChanged: boolean; note: DocumentSummary | null }>;\n  /**\n   * Permanently destroy a local-only document, or submit and verify a signed\n   * terminal purge for a remote document. Remote purge requires exactly one\n   * remaining container link and returns null on refusal or verification\n   * failure.\n   */\n  purgeDocument(input: PurgeDocumentInput): Promise<PurgeDocumentResult | null>;\n  readonly resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;\n  unlinkDocumentFromContainer(\n    input: UnlinkDocumentFromContainerInput,\n  ): Promise<DocumentSummary | null>;\n}\n\n/**\n * High-level container-content service for tree state, document lists, document\n * links, discovery, and diagnostics.\n *\n * The facade owns the normal SDK protocol: it supplies the API client,\n * referenced-principal policy cache, local document query helpers, link\n * projection, tombstone handling, and sync watermarks. Consumers that need a\n * custom persistence protocol can call the lower-level workflows directly from\n * `@tearleads/client-sdk`.\n */\nexport interface ContainerContents {\n  /**\n   * Open the container tree state store for the current SDK runtime.\n   *\n   * The store is cached per domain scope and created from the current runtime\n   * snapshot. Long-lived hosts should call `updateRuntime` after runtime\n   * changes, such as from a React effect.\n   */\n  openTree(\n    options?: ContainerContentsStoreOptions | undefined,\n  ): ContainerContentsStore;\n\n  /**\n   * Create local document query helpers for container contents.\n   *\n   * The facade is bound to the current SDK runtime snapshot, including the\n   * active SQLite executor. Recreate it when the SDK runtime version changes.\n   */\n  documentQueries(): ContainerDocumentQueries;\n\n  /**\n   * Create the default document-link workflow helper.\n   *\n   * The returned object includes the current container-contents runtime,\n   * the document projection-key resolver, mutation readiness, document store\n   * priming, and container document-link mutations. Product stores can pass\n   * this bundle around without rebuilding SDK runtime plumbing themselves.\n   */\n  documentLinks(): ContainerDocumentLinks;\n\n  /**\n   * Discover remote documents linked to one container.\n   *\n   * The method pages the remote container-document lane, writes discovered\n   * document summaries into local SQLite, replaces the local link projection for\n   * each discovered document, applies applicable tombstones, caches referenced\n   * principal policies needed by newly visible documents, and advances the\n   * container-document watermark after the local apply completes.\n   *\n   * One call verifies a bounded batch. Pending evidence is durable; a later\n   * explicit call or background reconciliation resumes it.\n   *\n   * Returns the summaries touched by the apply, or `null` when the database or\n   * listing is unavailable, a trust reset cancels the pass, or all evidence is\n   * pending. Pending evidence may advance the watermark after durable staging.\n   *\n   * Parameters:\n   * - `containerId`: Remote container id whose document lane should be listed.\n   */\n  discoverContainerDocuments(\n    containerId: string,\n  ): Promise<ReadonlyArray<DocumentSummary> | null>;\n\n  /**\n   * Sync the content of a single document that no mini-app has opened.\n   *\n   * Discovery only records a document's metadata + an empty content shell, and a\n   * document's locally authored content is only pushed once its store syncs; both\n   * normally happen lazily when a mini-app opens the document. Some documents are\n   * never opened yet still need to sync — notably the organization profile\n   * document, which lives in an org's Members-granted metadata container and\n   * holds the org display name. This opens a transient document store (registered\n   * under the container's keys, so it can decrypt) and schedules a remote sync\n   * pass. The pass both pushes the store's pending updates and merges + persists\n   * any remote body, so the same call lets an owning device publish its profile\n   * content and a member device pull it. `documentId` may be omitted; the store\n   * then resolves it from the persisted record (the owning device keys the\n   * document under a local alias, not its server id).\n   */\n  pullDocumentContent(input: {\n    containerId: string;\n    localId: string;\n    documentId?: string | null | undefined;\n  }): void;\n\n  /**\n   * Load diagnostic information for one local document.\n   *\n   * Local details are available when SQLite is ready. Remote details are loaded\n   * from the document writer projection according to `remoteInfoMode`; the\n   * default is `\"if-synced\"`.\n   */\n  loadDocumentInfo(input: DocumentInfoInput): Promise<DocumentInfo>;\n\n  /**\n   * Fetch a synced document's compact edit-attribution segments (peer -> writer\n   * intervals) on their own, without the writer-projection/attachment work\n   * `loadDocumentInfo` also does. Resolves to `null` on any request failure.\n   * Callers must ignore the segments when `truncated` is set — a truncated\n   * interval list can drop a peer's segments and mis-resolve it.\n   */\n  loadDocumentEditAttribution(\n    documentId: string,\n  ): Promise<DocumentEditAttributionResponse | null>;\n\n  /** Load one revision-bound page of detailed per-upload edit attribution. */\n  loadDocumentAttributionRanges(\n    input: DocumentAttributionRangesInput,\n  ): Promise<DocumentAttributionRangesPage>;\n\n  /**\n   * List local blob projections and pending attachment bytes grouped by blob.\n   *\n   * This is a reverse lookup query: callers can search by server blob id,\n   * local storage key, document id/title, attachment slot, or MIME metadata and\n   * then traverse matching blobs back to their owning local documents.\n   */\n  listBlobInfo(input?: BlobInfoInput | undefined): Promise<BlobInfoList>;\n\n  /**\n   * Load diagnostic information for one container.\n   *\n   * Local details include synced timestamps. Remote details are loaded from the\n   * container writer projection according to `remoteInfoMode`; the default is\n   * `\"always\"`. Pass `parentId` when inspecting a container before its local row\n   * has been synced.\n   */\n  loadContainerInfo(input: ContainerInfoInput): Promise<ContainerInfo>;\n\n  /**\n   * Create a workflow runtime for advanced container-content workflows.\n   *\n   * Prefer the high-level methods on this service for the default SDK protocol.\n   * Use this when constructing lower-level stores or custom workflows that need\n   * access to the current runtime snapshot.\n   */\n  workflowRuntime(): ContainerContentsStoreRuntime;\n}\n"]}

package/client/containerDocumentDiscovery.js

@@ -0,0 +1,48 @@
+import { sqlContainerContentsPersistence } from "../data/persistence/container-contents/containerContentsPersistence.js";
+import { holdContainerDocumentTombstones, listKnownContainerDocumentPlacements, listRetryableHeldContainerDocumentTombstones, loadLocalDocumentAccessEpoch, refuteContainerDocumentTombstoneHolds, } from "../data/persistence/documents/containerDocumentTombstoneHoldsPersistence.js";
+import { createDocumentDiscoveryEvidenceStore } from "../data/persistence/documents/documentDiscoveryEvidencePersistence.js";
+import { discoverContainerDocumentsFromApi } from "../workflows/container-contents/documentDiscovery.js";
+import { createDiscoveredDocumentVerifier } from "../workflows/container-contents/documentDiscoveryEvidence.js";
+import { createContainerDocumentQueriesFromRuntime } from "../workflows/container-contents/documentQueries.js";
+import { createContainerDocumentTombstoneVerifier, createDocumentHeadLinkSetLoader, } from "../workflows/container-contents/documentTombstoneEvidence.js";
+import { createContainerContentsWorkflowRuntime } from "../workflows/container-contents/runtime.js";
+import { createRuntimePrincipalPolicyWarmer } from "../workflows/principals/runtimePolicyWarmer.js";
+/** Internal adapter shared by explicit discovery and background reconciliation. */
+export async function discoverContainerDocumentsForRuntime({ containerId, onFullListing, onPendingDiscovery, runtimeService, }) {
+    const input = runtimeService.workflowInput();
+    if (input.infra.dbStatus !== "ready") {
+        return null;
+    }
+    const runtime = createContainerContentsWorkflowRuntime(input);
+    const evidenceStore = createDocumentDiscoveryEvidenceStore(input.infra.execSql);
+    // Capture the reset fence before reading scope, so a reset between this read
+    // and listing cannot publish old-organization evidence into its replacement.
+    const generation = await evidenceStore.begin();
+    const stored = await sqlContainerContentsPersistence.loadContainerMetadataState(input.infra.execSql, containerId);
+    if (!stored)
+        return null;
+    const containerOrganizationId = stored.container.organizationId;
+    const warmReferencedPrincipalPolicies = createRuntimePrincipalPolicyWarmer(runtime);
+    const loadHead = createDocumentHeadLinkSetLoader(runtime);
+    const loadEpoch = (documentId) => loadLocalDocumentAccessEpoch(input.infra.execSql, documentId);
+    return discoverContainerDocumentsFromApi({
+        ...createContainerDocumentQueriesFromRuntime(runtime),
+        apiClient: runtime.apiClient,
+        beginDocumentDiscovery: async () => generation,
+        cacheReferencedPrincipalPolicies: (references) => containerOrganizationId
+            ? warmReferencedPrincipalPolicies({
+                organizationId: containerOrganizationId,
+                references,
+            })
+            : Promise.resolve(),
+        containerId,
+        holdContainerDocumentTombstones: (tombstones) => holdContainerDocumentTombstones(input.infra.execSql, tombstones),
+        listHeldContainerDocumentTombstones: (containerIds) => listRetryableHeldContainerDocumentTombstones(input.infra.execSql, containerIds),
+        listKnownContainerDocumentPlacements: (placements) => listKnownContainerDocumentPlacements(input.infra.execSql, placements),
+        onFullListing,
+        refuteContainerDocumentTombstoneHolds: (placements) => refuteContainerDocumentTombstoneHolds(input.infra.execSql, placements),
+        verifyContainerDocumentTombstones: createContainerDocumentTombstoneVerifier(containerOrganizationId, loadHead, loadEpoch),
+        verifyDiscoveredDocuments: createDiscoveredDocumentVerifier(containerOrganizationId, loadHead, loadEpoch, evidenceStore, onPendingDiscovery),
+    });
+}
+//# sourceMappingURL=containerDocumentDiscovery.js.map

package/client/containerDocumentDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerDocumentDiscovery.js","sourceRoot":"","sources":["containerDocumentDiscovery.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DocumentSummary } from \"../data/documents/documentSummary\";\nimport { sqlContainerContentsPersistence } from \"../data/persistence/container-contents/containerContentsPersistence\";\nimport {\n  holdContainerDocumentTombstones,\n  listKnownContainerDocumentPlacements,\n  listRetryableHeldContainerDocumentTombstones,\n  loadLocalDocumentAccessEpoch,\n  refuteContainerDocumentTombstoneHolds,\n} from \"../data/persistence/documents/containerDocumentTombstoneHoldsPersistence\";\nimport { createDocumentDiscoveryEvidenceStore } from \"../data/persistence/documents/documentDiscoveryEvidencePersistence\";\nimport { discoverContainerDocumentsFromApi } from \"../workflows/container-contents/documentDiscovery\";\nimport { createDiscoveredDocumentVerifier } from \"../workflows/container-contents/documentDiscoveryEvidence\";\nimport { createContainerDocumentQueriesFromRuntime } from \"../workflows/container-contents/documentQueries\";\nimport {\n  createContainerDocumentTombstoneVerifier,\n  createDocumentHeadLinkSetLoader,\n} from \"../workflows/container-contents/documentTombstoneEvidence\";\nimport { createContainerContentsWorkflowRuntime } from \"../workflows/container-contents/runtime\";\nimport { createRuntimePrincipalPolicyWarmer } from \"../workflows/principals/runtimePolicyWarmer\";\nimport type { InternalRuntime } from \"./workflowRuntime\";\n\n/** Internal adapter shared by explicit discovery and background reconciliation. */\nexport async function discoverContainerDocumentsForRuntime({\n  containerId,\n  onFullListing,\n  onPendingDiscovery,\n  runtimeService,\n}: {\n  containerId: string;\n  onFullListing?: ((documentIds: ReadonlyArray<string>) => void) | undefined;\n  onPendingDiscovery?: ((delayMs: number) => void) | undefined;\n  runtimeService: InternalRuntime;\n}): Promise<ReadonlyArray<DocumentSummary> | null> {\n  const input = runtimeService.workflowInput();\n  if (input.infra.dbStatus !== \"ready\") {\n    return null;\n  }\n  const runtime = createContainerContentsWorkflowRuntime(input);\n  const evidenceStore = createDocumentDiscoveryEvidenceStore(\n    input.infra.execSql,\n  );\n  // Capture the reset fence before reading scope, so a reset between this read\n  // and listing cannot publish old-organization evidence into its replacement.\n  const generation = await evidenceStore.begin();\n  const stored =\n    await sqlContainerContentsPersistence.loadContainerMetadataState(\n      input.infra.execSql,\n      containerId,\n    );\n  if (!stored) return null;\n  const containerOrganizationId = stored.container.organizationId;\n  const warmReferencedPrincipalPolicies =\n    createRuntimePrincipalPolicyWarmer(runtime);\n  const loadHead = createDocumentHeadLinkSetLoader(runtime);\n  const loadEpoch = (documentId: string) =>\n    loadLocalDocumentAccessEpoch(input.infra.execSql, documentId);\n  return discoverContainerDocumentsFromApi({\n    ...createContainerDocumentQueriesFromRuntime(runtime),\n    apiClient: runtime.apiClient,\n    beginDocumentDiscovery: async () => generation,\n    cacheReferencedPrincipalPolicies: (references) =>\n      containerOrganizationId\n        ? warmReferencedPrincipalPolicies({\n            organizationId: containerOrganizationId,\n            references,\n          })\n        : Promise.resolve(),\n    containerId,\n    holdContainerDocumentTombstones: (tombstones) =>\n      holdContainerDocumentTombstones(input.infra.execSql, tombstones),\n    listHeldContainerDocumentTombstones: (containerIds) =>\n      listRetryableHeldContainerDocumentTombstones(\n        input.infra.execSql,\n        containerIds,\n      ),\n    listKnownContainerDocumentPlacements: (placements) =>\n      listKnownContainerDocumentPlacements(input.infra.execSql, placements),\n    onFullListing,\n    refuteContainerDocumentTombstoneHolds: (placements) =>\n      refuteContainerDocumentTombstoneHolds(input.infra.execSql, placements),\n    verifyContainerDocumentTombstones: createContainerDocumentTombstoneVerifier(\n      containerOrganizationId,\n      loadHead,\n      loadEpoch,\n    ),\n    verifyDiscoveredDocuments: createDiscoveredDocumentVerifier(\n      containerOrganizationId,\n      loadHead,\n      loadEpoch,\n      evidenceStore,\n      onPendingDiscovery,\n    ),\n  });\n}\n"]}

package/client/database.d.ts

@@ -0,0 +1,32 @@
+import { type ExecSql, type ExecSqlClientLike } from "../data/sqlite/sqlSchema.js";
+export type DatabaseStatus = "idle" | "ready" | "error" | "terminated";
+export interface DatabaseSnapshot {
+    client: ExecSqlClientLike | null;
+    execSql: ExecSql | null;
+    id: string | null;
+    status: DatabaseStatus;
+}
+export type DatabaseListener = () => void;
+export interface DatabaseOptions {
+    client?: ExecSqlClientLike | null | undefined;
+    execSql?: ExecSql | null | undefined;
+    id?: string | null | undefined;
+    status?: DatabaseStatus | undefined;
+}
+export declare class Database {
+    private readonly listeners;
+    private snapshotValue;
+    constructor(options?: DatabaseOptions | undefined);
+    get client(): ExecSqlClientLike | null;
+    get execSql(): ExecSql | null;
+    get id(): string | null;
+    get snapshot(): DatabaseSnapshot;
+    get status(): DatabaseStatus;
+    clear(status?: DatabaseStatus): void;
+    configure(options: DatabaseOptions): void;
+    requireExecSql(operation?: string): ExecSql;
+    setClient(client: ExecSqlClientLike, options?: Omit<DatabaseOptions, "client" | "execSql">): void;
+    setExecSql(execSql: ExecSql, options?: Omit<DatabaseOptions, "client" | "execSql">): void;
+    subscribe: (listener: DatabaseListener) => (() => void);
+    private setSnapshot;
+}