@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/workflows/container-contents/containerEvents.js

@@ -0,0 +1,112 @@
+import { isContainerProjectionInvalidationHint } from "../../data/documents/documentSync.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function readNullableString(value) {
+    if (value === null) {
+        return null;
+    }
+    return readNonEmptyString(value) ?? undefined;
+}
+function addHydrationParentId(parentIds, parentId) {
+    parentIds.set(parentId ?? "root", parentId);
+}
+function shouldHydrateRootLane(input) {
+    return (input.parentId === null ||
+        input.previousParentId === null ||
+        input.eventType !== "container.create");
+}
+/**
+ * Containers whose cached writer projections a batch of hints invalidates: the
+ * container a `container_mutation_created` hint names, and every held
+ * dependent a gateway `container_path_changed` or `resync_required` frame names.
+ * A `container_children_changed` frame names parents; consumers conservatively
+ * drop each parent and its known subtree because the changed child is hidden.
+ * Grant, rekey, and
+ * recite no longer evict subscribers, so these hints are the only signal that
+ * a projection's manifest head or cited ancestor path moved under a cached copy.
+ */
+export function listContainerProjectionInvalidationIds(events) {
+    const containerIds = new Set();
+    for (const event of events) {
+        if (!isRecord(event) || !isContainerProjectionInvalidationHint(event))
+            continue;
+        if (event.type === "container_mutation_created") {
+            const containerId = readNonEmptyString(event.containerId);
+            if (containerId)
+                containerIds.add(containerId);
+        }
+        else if ((event.type === "container_path_changed" ||
+            event.type === "container_children_changed" ||
+            event.type === "resync_required") &&
+            Array.isArray(event.containerIds)) {
+            for (const containerId of event.containerIds) {
+                const id = readNonEmptyString(containerId);
+                if (id)
+                    containerIds.add(id);
+            }
+        }
+    }
+    return [...containerIds];
+}
+function addMutationHydrationLanes(event, parentIds) {
+    // Do NOT suppress by signer. A container mutation from any session of this
+    // identity — including this client's own authoring session — must be
+    // reconciled: the authoring session is already excluded server-side via the
+    // event's `origin` (mirroring document mutations), and every OTHER
+    // same-identity peer only learns of a new/moved container by re-listing the
+    // affected parent lane here. Filtering by the identity signing fingerprint
+    // dropped a sibling peer's create outright — both peers derive the same
+    // signing key from the shared seed phrase — leaving new folders invisible on
+    // the other peer until a manual refresh.
+    const containerId = readNonEmptyString(event.containerId);
+    const eventType = readNonEmptyString(event.eventType);
+    if (!containerId || !eventType) {
+        return;
+    }
+    // The server scopes each hint to the recipient's own interest: a parent or
+    // previous parent this client is not subscribed to is withheld entirely
+    // (undefined), while null still names the root. Hydrate only the lanes the
+    // hint names; the container's own lane resolves its current parent.
+    const parentId = readNullableString(event.parentId);
+    const previousParentId = readNullableString(event.previousParentId);
+    if (shouldHydrateRootLane({ eventType, parentId, previousParentId })) {
+        addHydrationParentId(parentIds, null);
+    }
+    if (parentId !== undefined) {
+        addHydrationParentId(parentIds, parentId);
+    }
+    addHydrationParentId(parentIds, containerId);
+    if (previousParentId !== undefined) {
+        addHydrationParentId(parentIds, previousParentId);
+    }
+}
+export function listContainerParentIdsForEventHydration(events) {
+    const parentIds = new Map();
+    for (const event of events) {
+        if (!isRecord(event))
+            continue;
+        if (event.type === "container_children_changed") {
+            // A known child may not yet have confirmed interest, so it receives no
+            // eviction resync on a move. Refresh root as well to discover a root move.
+            if (Array.isArray(event.containerIds)) {
+                for (const value of event.containerIds) {
+                    const parentId = readNonEmptyString(value);
+                    if (parentId) {
+                        addHydrationParentId(parentIds, null);
+                        addHydrationParentId(parentIds, parentId);
+                    }
+                }
+            }
+            continue;
+        }
+        if (event.type !== "container_mutation_created")
+            continue;
+        addMutationHydrationLanes(event, parentIds);
+    }
+    return Array.from(parentIds.values());
+}
+//# sourceMappingURL=containerEvents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"containerEvents.js","sourceRoot":"","sources":["containerEvents.ts"],"names":[],"mappings":"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","sourcesContent":["import { isContainerProjectionInvalidationHint } from \"../../data/documents/documentSync\";\n\ninterface ContainerMutationEventCandidate {\n  readonly containerId?: unknown;\n  readonly containerIds?: unknown;\n  readonly eventType?: unknown;\n  readonly parentId?: unknown;\n  readonly previousParentId?: unknown;\n  readonly type?: unknown;\n}\n\nfunction isRecord(value: unknown): value is ContainerMutationEventCandidate {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readNonEmptyString(value: unknown): string | null {\n  return typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\nfunction readNullableString(value: unknown): string | null | undefined {\n  if (value === null) {\n    return null;\n  }\n\n  return readNonEmptyString(value) ?? undefined;\n}\n\nfunction addHydrationParentId(\n  parentIds: Map<string, string | null>,\n  parentId: string | null,\n) {\n  parentIds.set(parentId ?? \"root\", parentId);\n}\n\nfunction shouldHydrateRootLane(input: {\n  eventType: string;\n  parentId: string | null | undefined;\n  previousParentId: string | null | undefined;\n}): boolean {\n  return (\n    input.parentId === null ||\n    input.previousParentId === null ||\n    input.eventType !== \"container.create\"\n  );\n}\n\n/**\n * Containers whose cached writer projections a batch of hints invalidates: the\n * container a `container_mutation_created` hint names, and every held\n * dependent a gateway `container_path_changed` or `resync_required` frame names.\n * A `container_children_changed` frame names parents; consumers conservatively\n * drop each parent and its known subtree because the changed child is hidden.\n * Grant, rekey, and\n * recite no longer evict subscribers, so these hints are the only signal that\n * a projection's manifest head or cited ancestor path moved under a cached copy.\n */\nexport function listContainerProjectionInvalidationIds(\n  events: ReadonlyArray<unknown>,\n): string[] {\n  const containerIds = new Set<string>();\n  for (const event of events) {\n    if (!isRecord(event) || !isContainerProjectionInvalidationHint(event))\n      continue;\n    if (event.type === \"container_mutation_created\") {\n      const containerId = readNonEmptyString(event.containerId);\n      if (containerId) containerIds.add(containerId);\n    } else if (\n      (event.type === \"container_path_changed\" ||\n        event.type === \"container_children_changed\" ||\n        event.type === \"resync_required\") &&\n      Array.isArray(event.containerIds)\n    ) {\n      for (const containerId of event.containerIds) {\n        const id = readNonEmptyString(containerId);\n        if (id) containerIds.add(id);\n      }\n    }\n  }\n  return [...containerIds];\n}\n\nfunction addMutationHydrationLanes(\n  event: ContainerMutationEventCandidate,\n  parentIds: Map<string, string | null>,\n): void {\n  // Do NOT suppress by signer. A container mutation from any session of this\n  // identity — including this client's own authoring session — must be\n  // reconciled: the authoring session is already excluded server-side via the\n  // event's `origin` (mirroring document mutations), and every OTHER\n  // same-identity peer only learns of a new/moved container by re-listing the\n  // affected parent lane here. Filtering by the identity signing fingerprint\n  // dropped a sibling peer's create outright — both peers derive the same\n  // signing key from the shared seed phrase — leaving new folders invisible on\n  // the other peer until a manual refresh.\n  const containerId = readNonEmptyString(event.containerId);\n  const eventType = readNonEmptyString(event.eventType);\n  if (!containerId || !eventType) {\n    return;\n  }\n\n  // The server scopes each hint to the recipient's own interest: a parent or\n  // previous parent this client is not subscribed to is withheld entirely\n  // (undefined), while null still names the root. Hydrate only the lanes the\n  // hint names; the container's own lane resolves its current parent.\n  const parentId = readNullableString(event.parentId);\n  const previousParentId = readNullableString(event.previousParentId);\n  if (shouldHydrateRootLane({ eventType, parentId, previousParentId })) {\n    addHydrationParentId(parentIds, null);\n  }\n  if (parentId !== undefined) {\n    addHydrationParentId(parentIds, parentId);\n  }\n  addHydrationParentId(parentIds, containerId);\n\n  if (previousParentId !== undefined) {\n    addHydrationParentId(parentIds, previousParentId);\n  }\n}\n\nexport function listContainerParentIdsForEventHydration(\n  events: ReadonlyArray<unknown>,\n): Array<string | null> {\n  const parentIds = new Map<string, string | null>();\n\n  for (const event of events) {\n    if (!isRecord(event)) continue;\n    if (event.type === \"container_children_changed\") {\n      // A known child may not yet have confirmed interest, so it receives no\n      // eviction resync on a move. Refresh root as well to discover a root move.\n      if (Array.isArray(event.containerIds)) {\n        for (const value of event.containerIds) {\n          const parentId = readNonEmptyString(value);\n          if (parentId) {\n            addHydrationParentId(parentIds, null);\n            addHydrationParentId(parentIds, parentId);\n          }\n        }\n      }\n      continue;\n    }\n    if (event.type !== \"container_mutation_created\") continue;\n\n    addMutationHydrationLanes(event, parentIds);\n  }\n\n  return Array.from(parentIds.values());\n}\n"]}

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

@@ -0,0 +1,77 @@
+import type { ContainerAccessLevel, ContainerGrantSubjectType } from "../../internal/crypto/index.js";
+import type { ContainerWriterProjectionResponse } from "../../internal/validators/response/index.js";
+import type { ExecSql } from "../../data/sqlite/sqlSchema.js";
+import type { OrganizationGroupSummary } from "../organizations/readModel.js";
+export type ContainerShareAccessLevel = ContainerAccessLevel;
+export interface ContainerInfoGrant {
+    accessLevel: ContainerAccessLevel;
+    subjectId: string;
+    subjectType: ContainerGrantSubjectType;
+}
+export interface ContainerInfoGrantRow extends ContainerInfoGrant {
+    inherited: boolean;
+    sourceContainerId: string;
+}
+export interface ContainerInfoSyncCursor {
+    label: string;
+    laneId: string;
+    laneKind: string;
+    savedAt: string | null;
+    watermarkId: string | null;
+    watermarkUpdatedAt: string | null;
+}
+export interface ContainerInfoPathEntry {
+    containerId: string;
+    containerKeyEpoch: number;
+    containerKeyEpochId: string;
+    directGrantCount: number;
+    eventHash: string;
+    keyEpochHash: string;
+    keyTargetHash: string;
+    manifestHash: string;
+    manifestHistoryCount: number;
+    parentContainerId: string | null;
+    parentManifestHash: string | null;
+    recipientTargetCount: number;
+    referencedPrincipalCount: number;
+    wrapCount: number;
+}
+export interface ContainerInfoSecurityDetails {
+    currentContainerKeyEpoch: number;
+    currentContainerKeyEpochId: string;
+    currentManifestHash: string;
+    currentManifestHistoryCount: number;
+    currentParentContainerKeyEpochId: string | null;
+    currentReferencedPrincipalCount: number;
+    path: ContainerInfoPathEntry[];
+    pathLength: number;
+}
+export interface ContainerInfoRemoteDetails {
+    grantRows: ContainerInfoGrantRow[];
+    grants: ContainerInfoGrant[];
+    groups: OrganizationGroupSummary[];
+    security?: ContainerInfoSecurityDetails;
+    syncCursors: ContainerInfoSyncCursor[];
+}
+export interface ContainerInfoLocalDetails {
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface ContainerInfo {
+    local: ContainerInfoLocalDetails;
+    remoteInfo: ContainerInfoRemoteDetails | null;
+}
+interface ContainerInfoApi {
+    getContainerWriterProjection: (containerId: string) => Promise<ContainerWriterProjectionResponse | null>;
+}
+export type ContainerInfoRemoteMode = "always" | "if-synced" | "never";
+export declare function loadContainerInfo(input: {
+    apiClient: ContainerInfoApi;
+    containerId: string;
+    containerProjection?: ContainerWriterProjectionResponse | null | undefined;
+    execSql?: ExecSql | null;
+    loadOrganizationGroups: () => Promise<ReadonlyArray<OrganizationGroupSummary>>;
+    parentId?: string | null;
+    remoteInfoMode?: ContainerInfoRemoteMode | undefined;
+}): Promise<ContainerInfo>;
+export {};

package/workflows/container-contents/containerInfo.js

@@ -0,0 +1,200 @@
+import { eq } from "drizzle-orm";
+import { getTargetContainerContext, readContainerState, } from "../../data/containers/shared/projection.js";
+import { ensureContainerTables } from "../../data/persistence/containers/containerPersistence.js";
+import { containerContentsSyncLane, containerParentSyncLane, containerSyncWatermarkLaneKey, sqlContainerSyncWatermarkPersistence, } from "../../data/persistence/containers/containerSyncWatermarkPersistence.js";
+import { containers } from "../../data/sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime } from "../../data/sqlite/sqlitePersistenceRuntime.js";
+function sortContainerInfoGrants(grants) {
+    return [...grants].sort((left, right) => `${left.subjectType}:${left.subjectId}`.localeCompare(`${right.subjectType}:${right.subjectId}`));
+}
+function toContainerInfoGrant(grant) {
+    return {
+        accessLevel: grant.accessLevel,
+        subjectId: grant.subjectId,
+        subjectType: grant.subjectType,
+    };
+}
+function getContainerInfoGrantRows(projection) {
+    const rows = projection.path.flatMap((bundle) => {
+        const state = readContainerState(bundle);
+        return state.directGrants.map((grant) => ({
+            ...toContainerInfoGrant(grant),
+            inherited: state.containerId !== projection.containerId,
+            sourceContainerId: state.containerId,
+        }));
+    });
+    return sortContainerInfoGrants(rows);
+}
+function getContainerInfoPathEntries(projection) {
+    return projection.path.map((bundle, index) => {
+        const state = readContainerState(bundle);
+        const kek = projection.containerKeks[index];
+        if (!kek) {
+            throw new Error("Container projection path and KEKs are inconsistent");
+        }
+        return {
+            containerId: state.containerId,
+            containerKeyEpoch: kek.containerKeyEpoch,
+            containerKeyEpochId: kek.containerKeyEpochId,
+            directGrantCount: state.directGrants.length,
+            eventHash: state.eventHash,
+            keyEpochHash: kek.keyEpochHash,
+            keyTargetHash: kek.keyTargetHash,
+            manifestHash: bundle.manifestHash,
+            manifestHistoryCount: kek.containerManifestHistory.length,
+            parentContainerId: state.parentContainerId,
+            parentManifestHash: state.parentManifestHash,
+            recipientTargetCount: kek.recipientTargets.length,
+            referencedPrincipalCount: state.referencedPrincipalHeads.length,
+            wrapCount: kek.wraps.length,
+        };
+    });
+}
+function getContainerInfoSecurityDetails(projection) {
+    const path = getContainerInfoPathEntries(projection);
+    const targetPathEntry = path.at(-1);
+    const targetKek = projection.containerKeks.at(-1);
+    if (!targetPathEntry || !targetKek) {
+        throw new Error("Container projection is empty");
+    }
+    return {
+        currentContainerKeyEpoch: targetPathEntry.containerKeyEpoch,
+        currentContainerKeyEpochId: targetPathEntry.containerKeyEpochId,
+        currentManifestHash: targetPathEntry.manifestHash,
+        currentManifestHistoryCount: targetPathEntry.manifestHistoryCount,
+        currentParentContainerKeyEpochId: targetKek.parentContainerKeyEpochId,
+        currentReferencedPrincipalCount: targetPathEntry.referencedPrincipalCount,
+        path,
+        pathLength: path.length,
+    };
+}
+function getContainerSyncCursorDefinitions(input) {
+    return [
+        {
+            label: "Parent Listing",
+            lane: containerParentSyncLane(input.parentId),
+        },
+        {
+            label: "Child Containers",
+            lane: containerParentSyncLane(input.containerId),
+        },
+        {
+            label: "Documents",
+            lane: containerContentsSyncLane(input.containerId),
+        },
+    ];
+}
+async function loadContainerSyncCursors(input) {
+    const cursorDefinitions = getContainerSyncCursorDefinitions(input);
+    let records = [];
+    if (input.execSql) {
+        await sqlContainerSyncWatermarkPersistence.ensureSchema(input.execSql);
+        records = await sqlContainerSyncWatermarkPersistence.loadWatermarkRecords(input.execSql, cursorDefinitions.map(({ lane }) => lane));
+    }
+    return cursorDefinitions.map((definition, index) => {
+        const { laneId, laneKind } = containerSyncWatermarkLaneKey(definition.lane);
+        const record = records[index] ?? null;
+        return {
+            label: definition.label,
+            laneId,
+            laneKind,
+            savedAt: record?.updatedAt ?? null,
+            watermarkId: record?.watermark.id ?? null,
+            watermarkUpdatedAt: record?.watermark.updatedAt ?? null,
+        };
+    });
+}
+async function loadLocalContainerInfoRecord(input) {
+    const fallback = {
+        hasSyncedContainer: false,
+        localCreatedAt: null,
+        localUpdatedAt: null,
+        organizationId: null,
+        parentId: input.parentId,
+    };
+    if (!input.execSql) {
+        return fallback;
+    }
+    await ensureContainerTables(input.execSql);
+    const { db } = getClientSQLitePersistenceRuntime(input.execSql);
+    const rows = await db
+        .select({
+        localCreatedAt: containers.localCreatedAt,
+        localUpdatedAt: containers.localUpdatedAt,
+        metadataDocumentId: containers.metadataDocumentId,
+        organizationId: containers.organizationId,
+        parentId: containers.parentId,
+    })
+        .from(containers)
+        .where(eq(containers.id, input.containerId))
+        .limit(1);
+    const row = rows[0];
+    if (!row) {
+        return fallback;
+    }
+    return {
+        hasSyncedContainer: typeof row.metadataDocumentId === "string" &&
+            row.metadataDocumentId.length > 0,
+        localCreatedAt: row.localCreatedAt,
+        localUpdatedAt: row.localUpdatedAt,
+        organizationId: row.organizationId,
+        parentId: row.parentId,
+    };
+}
+function shouldLoadRemoteContainerInfo(input) {
+    switch (input.remoteInfoMode) {
+        case "always":
+            return true;
+        case "if-synced":
+            return input.localContainerInfo.hasSyncedContainer;
+        case "never":
+            return false;
+    }
+}
+export async function loadContainerInfo(input) {
+    const localContainerInfo = await loadLocalContainerInfoRecord({
+        containerId: input.containerId,
+        execSql: input.execSql ?? null,
+        parentId: input.parentId ?? null,
+    });
+    const local = {
+        createdAt: localContainerInfo.localCreatedAt,
+        updatedAt: localContainerInfo.localUpdatedAt,
+    };
+    if (!shouldLoadRemoteContainerInfo({
+        localContainerInfo,
+        remoteInfoMode: input.remoteInfoMode ?? "always",
+    })) {
+        return {
+            local,
+            remoteInfo: null,
+        };
+    }
+    const [projection, groups, syncCursors] = await Promise.all([
+        input.containerProjection
+            ? Promise.resolve(input.containerProjection)
+            : input.apiClient.getContainerWriterProjection(input.containerId),
+        input.loadOrganizationGroups(),
+        loadContainerSyncCursors({
+            containerId: input.containerId,
+            execSql: input.execSql ?? null,
+            parentId: localContainerInfo.parentId,
+        }),
+    ]);
+    if (!projection) {
+        throw new Error("Container info could not be loaded.");
+    }
+    const target = getTargetContainerContext(projection);
+    const state = readContainerState(target.manifest);
+    return {
+        local,
+        remoteInfo: {
+            grantRows: getContainerInfoGrantRows(projection),
+            grants: sortContainerInfoGrants(state.directGrants.map(toContainerInfoGrant)),
+            groups: [...groups],
+            security: getContainerInfoSecurityDetails(projection),
+            syncCursors,
+        },
+    };
+}
+//# sourceMappingURL=containerInfo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"containerInfo.js","sourceRoot":"","sources":["containerInfo.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ContainerAccessLevel,\n  ContainerGrantSubjectType,\n} from \"@tearleads/crypto\";\nimport type { ContainerWriterProjectionResponse } from \"@tearleads/validators/response\";\nimport { eq } from \"drizzle-orm\";\nimport {\n  getTargetContainerContext,\n  readContainerState,\n} from \"../../data/containers/shared/projection\";\nimport { ensureContainerTables } from \"../../data/persistence/containers/containerPersistence\";\nimport {\n  type ContainerSyncWatermarkLane,\n  containerContentsSyncLane,\n  containerParentSyncLane,\n  containerSyncWatermarkLaneKey,\n  sqlContainerSyncWatermarkPersistence,\n} from \"../../data/persistence/containers/containerSyncWatermarkPersistence\";\nimport { containers } from \"../../data/sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../data/sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../data/sqlite/sqlSchema\";\nimport type { OrganizationGroupSummary } from \"../organizations/readModel\";\n\nexport type ContainerShareAccessLevel = ContainerAccessLevel;\n\nexport interface ContainerInfoGrant {\n  accessLevel: ContainerAccessLevel;\n  subjectId: string;\n  subjectType: ContainerGrantSubjectType;\n}\n\nexport interface ContainerInfoGrantRow extends ContainerInfoGrant {\n  inherited: boolean;\n  sourceContainerId: string;\n}\n\nexport interface ContainerInfoSyncCursor {\n  label: string;\n  laneId: string;\n  laneKind: string;\n  savedAt: string | null;\n  watermarkId: string | null;\n  watermarkUpdatedAt: string | null;\n}\n\nexport interface ContainerInfoPathEntry {\n  containerId: string;\n  containerKeyEpoch: number;\n  containerKeyEpochId: string;\n  directGrantCount: number;\n  eventHash: string;\n  keyEpochHash: string;\n  keyTargetHash: string;\n  manifestHash: string;\n  manifestHistoryCount: number;\n  parentContainerId: string | null;\n  parentManifestHash: string | null;\n  recipientTargetCount: number;\n  referencedPrincipalCount: number;\n  wrapCount: number;\n}\n\nexport interface ContainerInfoSecurityDetails {\n  currentContainerKeyEpoch: number;\n  currentContainerKeyEpochId: string;\n  currentManifestHash: string;\n  currentManifestHistoryCount: number;\n  currentParentContainerKeyEpochId: string | null;\n  currentReferencedPrincipalCount: number;\n  path: ContainerInfoPathEntry[];\n  pathLength: number;\n}\n\nexport interface ContainerInfoRemoteDetails {\n  grantRows: ContainerInfoGrantRow[];\n  grants: ContainerInfoGrant[];\n  groups: OrganizationGroupSummary[];\n  security?: ContainerInfoSecurityDetails;\n  syncCursors: ContainerInfoSyncCursor[];\n}\n\nexport interface ContainerInfoLocalDetails {\n  createdAt: string | null;\n  updatedAt: string | null;\n}\n\nexport interface ContainerInfo {\n  local: ContainerInfoLocalDetails;\n  remoteInfo: ContainerInfoRemoteDetails | null;\n}\n\ninterface ContainerInfoApi {\n  getContainerWriterProjection: (\n    containerId: string,\n  ) => Promise<ContainerWriterProjectionResponse | null>;\n}\n\nexport type ContainerInfoRemoteMode = \"always\" | \"if-synced\" | \"never\";\n\ninterface LocalContainerInfoRecord {\n  hasSyncedContainer: boolean;\n  localCreatedAt: string | null;\n  localUpdatedAt: string | null;\n  organizationId: string | null;\n  parentId: string | null;\n}\n\nfunction sortContainerInfoGrants<T extends ContainerInfoGrant>(\n  grants: readonly T[],\n): T[] {\n  return [...grants].sort((left, right) =>\n    `${left.subjectType}:${left.subjectId}`.localeCompare(\n      `${right.subjectType}:${right.subjectId}`,\n    ),\n  );\n}\n\nfunction toContainerInfoGrant(grant: ContainerInfoGrant): ContainerInfoGrant {\n  return {\n    accessLevel: grant.accessLevel,\n    subjectId: grant.subjectId,\n    subjectType: grant.subjectType,\n  };\n}\n\nfunction getContainerInfoGrantRows(\n  projection: ContainerWriterProjectionResponse,\n): ContainerInfoGrantRow[] {\n  const rows = projection.path.flatMap((bundle) => {\n    const state = readContainerState(bundle);\n\n    return state.directGrants.map((grant) => ({\n      ...toContainerInfoGrant(grant),\n      inherited: state.containerId !== projection.containerId,\n      sourceContainerId: state.containerId,\n    }));\n  });\n\n  return sortContainerInfoGrants(rows);\n}\n\nfunction getContainerInfoPathEntries(\n  projection: ContainerWriterProjectionResponse,\n): ContainerInfoPathEntry[] {\n  return projection.path.map((bundle, index) => {\n    const state = readContainerState(bundle);\n    const kek = projection.containerKeks[index];\n    if (!kek) {\n      throw new Error(\"Container projection path and KEKs are inconsistent\");\n    }\n\n    return {\n      containerId: state.containerId,\n      containerKeyEpoch: kek.containerKeyEpoch,\n      containerKeyEpochId: kek.containerKeyEpochId,\n      directGrantCount: state.directGrants.length,\n      eventHash: state.eventHash,\n      keyEpochHash: kek.keyEpochHash,\n      keyTargetHash: kek.keyTargetHash,\n      manifestHash: bundle.manifestHash,\n      manifestHistoryCount: kek.containerManifestHistory.length,\n      parentContainerId: state.parentContainerId,\n      parentManifestHash: state.parentManifestHash,\n      recipientTargetCount: kek.recipientTargets.length,\n      referencedPrincipalCount: state.referencedPrincipalHeads.length,\n      wrapCount: kek.wraps.length,\n    };\n  });\n}\n\nfunction getContainerInfoSecurityDetails(\n  projection: ContainerWriterProjectionResponse,\n): ContainerInfoSecurityDetails {\n  const path = getContainerInfoPathEntries(projection);\n  const targetPathEntry = path.at(-1);\n  const targetKek = projection.containerKeks.at(-1);\n  if (!targetPathEntry || !targetKek) {\n    throw new Error(\"Container projection is empty\");\n  }\n\n  return {\n    currentContainerKeyEpoch: targetPathEntry.containerKeyEpoch,\n    currentContainerKeyEpochId: targetPathEntry.containerKeyEpochId,\n    currentManifestHash: targetPathEntry.manifestHash,\n    currentManifestHistoryCount: targetPathEntry.manifestHistoryCount,\n    currentParentContainerKeyEpochId: targetKek.parentContainerKeyEpochId,\n    currentReferencedPrincipalCount: targetPathEntry.referencedPrincipalCount,\n    path,\n    pathLength: path.length,\n  };\n}\n\ninterface ContainerInfoSyncCursorDefinition {\n  label: string;\n  lane: ContainerSyncWatermarkLane;\n}\n\nfunction getContainerSyncCursorDefinitions(input: {\n  containerId: string;\n  parentId: string | null;\n}): ContainerInfoSyncCursorDefinition[] {\n  return [\n    {\n      label: \"Parent Listing\",\n      lane: containerParentSyncLane(input.parentId),\n    },\n    {\n      label: \"Child Containers\",\n      lane: containerParentSyncLane(input.containerId),\n    },\n    {\n      label: \"Documents\",\n      lane: containerContentsSyncLane(input.containerId),\n    },\n  ];\n}\n\nasync function loadContainerSyncCursors(input: {\n  containerId: string;\n  execSql: ExecSql | null;\n  parentId: string | null;\n}): Promise<ContainerInfoSyncCursor[]> {\n  const cursorDefinitions = getContainerSyncCursorDefinitions(input);\n  let records: Awaited<\n    ReturnType<typeof sqlContainerSyncWatermarkPersistence.loadWatermarkRecords>\n  > = [];\n  if (input.execSql) {\n    await sqlContainerSyncWatermarkPersistence.ensureSchema(input.execSql);\n    records = await sqlContainerSyncWatermarkPersistence.loadWatermarkRecords(\n      input.execSql,\n      cursorDefinitions.map(({ lane }) => lane),\n    );\n  }\n\n  return cursorDefinitions.map((definition, index) => {\n    const { laneId, laneKind } = containerSyncWatermarkLaneKey(definition.lane);\n    const record = records[index] ?? null;\n\n    return {\n      label: definition.label,\n      laneId,\n      laneKind,\n      savedAt: record?.updatedAt ?? null,\n      watermarkId: record?.watermark.id ?? null,\n      watermarkUpdatedAt: record?.watermark.updatedAt ?? null,\n    };\n  });\n}\n\nasync function loadLocalContainerInfoRecord(input: {\n  containerId: string;\n  execSql: ExecSql | null;\n  parentId: string | null;\n}): Promise<LocalContainerInfoRecord> {\n  const fallback: LocalContainerInfoRecord = {\n    hasSyncedContainer: false,\n    localCreatedAt: null,\n    localUpdatedAt: null,\n    organizationId: null,\n    parentId: input.parentId,\n  };\n\n  if (!input.execSql) {\n    return fallback;\n  }\n\n  await ensureContainerTables(input.execSql);\n\n  const { db } = getClientSQLitePersistenceRuntime(input.execSql);\n  const rows = await db\n    .select({\n      localCreatedAt: containers.localCreatedAt,\n      localUpdatedAt: containers.localUpdatedAt,\n      metadataDocumentId: containers.metadataDocumentId,\n      organizationId: containers.organizationId,\n      parentId: containers.parentId,\n    })\n    .from(containers)\n    .where(eq(containers.id, input.containerId))\n    .limit(1);\n  const row = rows[0];\n\n  if (!row) {\n    return fallback;\n  }\n\n  return {\n    hasSyncedContainer:\n      typeof row.metadataDocumentId === \"string\" &&\n      row.metadataDocumentId.length > 0,\n    localCreatedAt: row.localCreatedAt,\n    localUpdatedAt: row.localUpdatedAt,\n    organizationId: row.organizationId,\n    parentId: row.parentId,\n  };\n}\n\nfunction shouldLoadRemoteContainerInfo(input: {\n  localContainerInfo: LocalContainerInfoRecord;\n  remoteInfoMode: ContainerInfoRemoteMode;\n}): boolean {\n  switch (input.remoteInfoMode) {\n    case \"always\":\n      return true;\n    case \"if-synced\":\n      return input.localContainerInfo.hasSyncedContainer;\n    case \"never\":\n      return false;\n  }\n}\n\nexport async function loadContainerInfo(input: {\n  apiClient: ContainerInfoApi;\n  containerId: string;\n  containerProjection?: ContainerWriterProjectionResponse | null | undefined;\n  execSql?: ExecSql | null;\n  loadOrganizationGroups: () => Promise<\n    ReadonlyArray<OrganizationGroupSummary>\n  >;\n  parentId?: string | null;\n  remoteInfoMode?: ContainerInfoRemoteMode | undefined;\n}): Promise<ContainerInfo> {\n  const localContainerInfo = await loadLocalContainerInfoRecord({\n    containerId: input.containerId,\n    execSql: input.execSql ?? null,\n    parentId: input.parentId ?? null,\n  });\n  const local = {\n    createdAt: localContainerInfo.localCreatedAt,\n    updatedAt: localContainerInfo.localUpdatedAt,\n  };\n\n  if (\n    !shouldLoadRemoteContainerInfo({\n      localContainerInfo,\n      remoteInfoMode: input.remoteInfoMode ?? \"always\",\n    })\n  ) {\n    return {\n      local,\n      remoteInfo: null,\n    };\n  }\n\n  const [projection, groups, syncCursors] = await Promise.all([\n    input.containerProjection\n      ? Promise.resolve(input.containerProjection)\n      : input.apiClient.getContainerWriterProjection(input.containerId),\n    input.loadOrganizationGroups(),\n    loadContainerSyncCursors({\n      containerId: input.containerId,\n      execSql: input.execSql ?? null,\n      parentId: localContainerInfo.parentId,\n    }),\n  ]);\n\n  if (!projection) {\n    throw new Error(\"Container info could not be loaded.\");\n  }\n\n  const target = getTargetContainerContext(projection);\n  const state = readContainerState(target.manifest);\n\n  return {\n    local,\n    remoteInfo: {\n      grantRows: getContainerInfoGrantRows(projection),\n      grants: sortContainerInfoGrants(\n        state.directGrants.map(toContainerInfoGrant),\n      ),\n      groups: [...groups],\n      security: getContainerInfoSecurityDetails(projection),\n      syncCursors,\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,21 @@
+import type { SyncWatermark } from "../../internal/validators/response/index.js";
+import type { ContainerContentsPersistence } from "../../data/persistence/container-contents/containerContentsPersistence.js";
+import { type ContainerSyncLaneCheckRecord, type ContainerSyncWatermarkLane } from "../../data/persistence/containers/containerSyncWatermarkPersistence.js";
+import type { ExecSql } from "../../data/sqlite/sqlSchema.js";
+export type { ContainerContentsPersistence, ContainerCreateIntentRecord, ContainerHydrationTombstone, ContainerMetadataRecord, ContainerMetadataRecord as ContainerDocumentRecord, ContainerMoveIntentRecord, LocalRootDescendantReparentInput, StoredContainerState, } from "../../data/persistence/container-contents/containerContentsPersistence.js";
+export { sqlContainerContentsPersistence as defaultContainerContentsPersistence } from "../../data/persistence/container-contents/containerContentsPersistence.js";
+export type { ContainerRecord } from "../../data/persistence/containers/containerPersistence.js";
+export type { ContainerSyncWatermarkLane } from "../../data/persistence/containers/containerSyncWatermarkPersistence.js";
+export declare function enqueuePendingContainerUpdate(execSql: ExecSql, persistence: ContainerContentsPersistence, params: {
+    containerId: string;
+    sourceVersionVector?: string | null | undefined;
+    update: Uint8Array;
+}): Promise<string | null>;
+export declare function createContainerParentSyncLane(parentId: string | null): ContainerSyncWatermarkLane;
+export declare function createContainerContentsSyncLane(containerId: string): ContainerSyncWatermarkLane;
+export declare function loadContainerSyncWatermark(execSql: ExecSql, syncLane: ContainerSyncWatermarkLane): Promise<SyncWatermark | null>;
+export declare function saveContainerSyncWatermark(execSql: ExecSql, syncLane: ContainerSyncWatermarkLane, watermark: SyncWatermark): Promise<void>;
+export declare function saveContainerSyncWatermarkIfCurrent(execSql: ExecSql, syncLane: ContainerSyncWatermarkLane, watermark: SyncWatermark, stillCurrent?: (() => boolean) | undefined): Promise<boolean>;
+export declare function loadContainerSyncLaneCheckRecords(execSql: ExecSql, syncLanes: ReadonlyArray<ContainerSyncWatermarkLane>): Promise<Array<ContainerSyncLaneCheckRecord | null>>;
+export declare function markContainerSyncLaneChecked(execSql: ExecSql, syncLane: ContainerSyncWatermarkLane): Promise<void>;
+export declare function markContainerSyncLaneCheckedIfCurrent(execSql: ExecSql, syncLane: ContainerSyncWatermarkLane, stillCurrent?: (() => boolean) | undefined): Promise<boolean>;

package/workflows/container-contents/containerPersistence.js

@@ -0,0 +1,40 @@
+import { createPendingUpdateFields } from "../../data/documents/documentSync.js";
+import { containerContentsSyncLane, containerParentSyncLane, sqlContainerSyncWatermarkPersistence, } from "../../data/persistence/containers/containerSyncWatermarkPersistence.js";
+export { sqlContainerContentsPersistence as defaultContainerContentsPersistence } from "../../data/persistence/container-contents/containerContentsPersistence.js";
+export async function enqueuePendingContainerUpdate(execSql, persistence, params) {
+    const pendingUpdateFields = createPendingUpdateFields(params.update, params.sourceVersionVector);
+    if (!pendingUpdateFields) {
+        return null;
+    }
+    return persistence.enqueuePendingUpdate(execSql, {
+        containerId: params.containerId,
+        ...pendingUpdateFields,
+    });
+}
+export function createContainerParentSyncLane(parentId) {
+    return containerParentSyncLane(parentId);
+}
+export function createContainerContentsSyncLane(containerId) {
+    return containerContentsSyncLane(containerId);
+}
+export async function loadContainerSyncWatermark(execSql, syncLane) {
+    return sqlContainerSyncWatermarkPersistence.loadWatermark(execSql, syncLane);
+}
+export async function saveContainerSyncWatermark(execSql, syncLane, watermark) {
+    await sqlContainerSyncWatermarkPersistence.saveWatermark(execSql, syncLane, watermark);
+}
+export async function saveContainerSyncWatermarkIfCurrent(execSql, syncLane, watermark, stillCurrent) {
+    return sqlContainerSyncWatermarkPersistence.saveWatermark(execSql, syncLane, watermark, { stillCurrent });
+}
+export async function loadContainerSyncLaneCheckRecords(execSql, syncLanes) {
+    return sqlContainerSyncWatermarkPersistence.loadCheckRecords(execSql, syncLanes);
+}
+export async function markContainerSyncLaneChecked(execSql, syncLane) {
+    await sqlContainerSyncWatermarkPersistence.markChecked(execSql, syncLane);
+}
+export async function markContainerSyncLaneCheckedIfCurrent(execSql, syncLane, stillCurrent) {
+    return sqlContainerSyncWatermarkPersistence.markChecked(execSql, syncLane, {
+        stillCurrent,
+    });
+}
+//# sourceMappingURL=containerPersistence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"containerPersistence.js","sourceRoot":"","sources":["containerPersistence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,EAGL,yBAAyB,EACzB,uBAAuB,EACvB,oCAAoC,GACrC,MAAM,qEAAqE,CAAC;AAa7E,OAAO,EAAE,+BAA+B,IAAI,mCAAmC,EAAE,MAAM,wEAAwE,CAAC;AAIhK,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAgB,EAChB,WAAyC,EACzC,MAIC;IAED,MAAM,mBAAmB,GAAG,yBAAyB,CACnD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,mBAAmB,CAC3B,CAAC;IACF,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,WAAW,CAAC,oBAAoB,CAAC,OAAO,EAAE;QAC/C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,mBAAmB;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,QAAuB;IAEvB,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,WAAmB;IAEnB,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAgB,EAChB,QAAoC;IAEpC,OAAO,oCAAoC,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAgB,EAChB,QAAoC,EACpC,SAAwB;IAExB,MAAM,oCAAoC,CAAC,aAAa,CACtD,OAAO,EACP,QAAQ,EACR,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,OAAgB,EAChB,QAAoC,EACpC,SAAwB,EACxB,YAA0C;IAE1C,OAAO,oCAAoC,CAAC,aAAa,CACvD,OAAO,EACP,QAAQ,EACR,SAAS,EACT,EAAE,YAAY,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,OAAgB,EAChB,SAAoD;IAEpD,OAAO,oCAAoC,CAAC,gBAAgB,CAC1D,OAAO,EACP,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAgB,EAChB,QAAoC;IAEpC,MAAM,oCAAoC,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,OAAgB,EAChB,QAAoC,EACpC,YAA0C;IAE1C,OAAO,oCAAoC,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE;QACzE,YAAY;KACb,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { SyncWatermark } from \"@tearleads/validators/response\";\nimport { createPendingUpdateFields } from \"../../data/documents/documentSync\";\nimport type { ContainerContentsPersistence } from \"../../data/persistence/container-contents/containerContentsPersistence\";\nimport {\n  type ContainerSyncLaneCheckRecord,\n  type ContainerSyncWatermarkLane,\n  containerContentsSyncLane,\n  containerParentSyncLane,\n  sqlContainerSyncWatermarkPersistence,\n} from \"../../data/persistence/containers/containerSyncWatermarkPersistence\";\nimport type { ExecSql } from \"../../data/sqlite/sqlSchema\";\n\nexport type {\n  ContainerContentsPersistence,\n  ContainerCreateIntentRecord,\n  ContainerHydrationTombstone,\n  ContainerMetadataRecord,\n  ContainerMetadataRecord as ContainerDocumentRecord,\n  ContainerMoveIntentRecord,\n  LocalRootDescendantReparentInput,\n  StoredContainerState,\n} from \"../../data/persistence/container-contents/containerContentsPersistence\";\nexport { sqlContainerContentsPersistence as defaultContainerContentsPersistence } from \"../../data/persistence/container-contents/containerContentsPersistence\";\nexport type { ContainerRecord } from \"../../data/persistence/containers/containerPersistence\";\nexport type { ContainerSyncWatermarkLane } from \"../../data/persistence/containers/containerSyncWatermarkPersistence\";\n\nexport async function enqueuePendingContainerUpdate(\n  execSql: ExecSql,\n  persistence: ContainerContentsPersistence,\n  params: {\n    containerId: string;\n    sourceVersionVector?: string | null | undefined;\n    update: Uint8Array;\n  },\n): Promise<string | null> {\n  const pendingUpdateFields = createPendingUpdateFields(\n    params.update,\n    params.sourceVersionVector,\n  );\n  if (!pendingUpdateFields) {\n    return null;\n  }\n\n  return persistence.enqueuePendingUpdate(execSql, {\n    containerId: params.containerId,\n    ...pendingUpdateFields,\n  });\n}\n\nexport function createContainerParentSyncLane(\n  parentId: string | null,\n): ContainerSyncWatermarkLane {\n  return containerParentSyncLane(parentId);\n}\n\nexport function createContainerContentsSyncLane(\n  containerId: string,\n): ContainerSyncWatermarkLane {\n  return containerContentsSyncLane(containerId);\n}\n\nexport async function loadContainerSyncWatermark(\n  execSql: ExecSql,\n  syncLane: ContainerSyncWatermarkLane,\n): Promise<SyncWatermark | null> {\n  return sqlContainerSyncWatermarkPersistence.loadWatermark(execSql, syncLane);\n}\n\nexport async function saveContainerSyncWatermark(\n  execSql: ExecSql,\n  syncLane: ContainerSyncWatermarkLane,\n  watermark: SyncWatermark,\n): Promise<void> {\n  await sqlContainerSyncWatermarkPersistence.saveWatermark(\n    execSql,\n    syncLane,\n    watermark,\n  );\n}\n\nexport async function saveContainerSyncWatermarkIfCurrent(\n  execSql: ExecSql,\n  syncLane: ContainerSyncWatermarkLane,\n  watermark: SyncWatermark,\n  stillCurrent?: (() => boolean) | undefined,\n): Promise<boolean> {\n  return sqlContainerSyncWatermarkPersistence.saveWatermark(\n    execSql,\n    syncLane,\n    watermark,\n    { stillCurrent },\n  );\n}\n\nexport async function loadContainerSyncLaneCheckRecords(\n  execSql: ExecSql,\n  syncLanes: ReadonlyArray<ContainerSyncWatermarkLane>,\n): Promise<Array<ContainerSyncLaneCheckRecord | null>> {\n  return sqlContainerSyncWatermarkPersistence.loadCheckRecords(\n    execSql,\n    syncLanes,\n  );\n}\n\nexport async function markContainerSyncLaneChecked(\n  execSql: ExecSql,\n  syncLane: ContainerSyncWatermarkLane,\n): Promise<void> {\n  await sqlContainerSyncWatermarkPersistence.markChecked(execSql, syncLane);\n}\n\nexport async function markContainerSyncLaneCheckedIfCurrent(\n  execSql: ExecSql,\n  syncLane: ContainerSyncWatermarkLane,\n  stillCurrent?: (() => boolean) | undefined,\n): Promise<boolean> {\n  return sqlContainerSyncWatermarkPersistence.markChecked(execSql, syncLane, {\n    stillCurrent,\n  });\n}\n"]}

package/workflows/container-contents/deferredDocumentLinks.js

@@ -0,0 +1,9 @@
+import { deriveStableDocumentId } from "../../data/documents/shared/stableDocumentId.js";
+/** A deferred create keeps its intended links until its signed adoption verifies. */
+export async function withoutDeferredDocumentLinks(links, summaries) {
+    const deferredIds = new Set(await Promise.all(summaries
+        .filter((summary) => summary.documentId === null)
+        .map((summary) => deriveStableDocumentId(summary.id))));
+    return links.filter((link) => !deferredIds.has(link.documentId));
+}
+//# sourceMappingURL=deferredDocumentLinks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deferredDocumentLinks.js","sourceRoot":"","sources":["deferredDocumentLinks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAEtF,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAGhD,KAAmB,EACnB,SAAqC;IAErC,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM,OAAO,CAAC,GAAG,CACf,SAAS;SACN,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC;SAChD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CACxD,CACF,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import type { DocumentSummary } from \"../../data/documents/documentSummary\";\nimport { deriveStableDocumentId } from \"../../data/documents/shared/stableDocumentId\";\n\n/** A deferred create keeps its intended links until its signed adoption verifies. */\nexport async function withoutDeferredDocumentLinks<\n  T extends { documentId: string; containerIds: readonly string[] },\n>(\n  links: readonly T[],\n  summaries: readonly DocumentSummary[],\n): Promise<readonly T[]> {\n  const deferredIds = new Set(\n    await Promise.all(\n      summaries\n        .filter((summary) => summary.documentId === null)\n        .map((summary) => deriveStableDocumentId(summary.id)),\n    ),\n  );\n  return links.filter((link) => !deferredIds.has(link.documentId));\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { DocumentEditAttributionRangeResponse, ListDocumentEditAttributionRangesResponse } from "../../internal/validators/response/index.js";
+export interface DocumentAttributionRangesInput {
+    readonly cursor?: string | null | undefined;
+    readonly documentId: string;
+    readonly expectedRevision?: number | undefined;
+    readonly limit?: number | undefined;
+}
+export interface DocumentAttributionRangesPage {
+    readonly attributionRevision: number;
+    readonly documentId: string;
+    readonly hasMore: boolean;
+    readonly items: DocumentEditAttributionRangeResponse[];
+    readonly nextCursor: string | null;
+}
+interface DocumentAttributionRangesApi {
+    listDocumentEditAttributionRanges(documentId: string, options?: {
+        readonly cursor?: string | null | undefined;
+        readonly expectedRevision?: number | undefined;
+        readonly limit?: number | undefined;
+    }): Promise<ListDocumentEditAttributionRangesResponse | null>;
+}
+export declare function loadDocumentAttributionRanges(input: {
+    readonly apiClient: DocumentAttributionRangesApi;
+    readonly query: DocumentAttributionRangesInput;
+}): Promise<DocumentAttributionRangesPage>;
+export {};

package/workflows/container-contents/documentAttributionRanges.js

@@ -0,0 +1,15 @@
+export async function loadDocumentAttributionRanges(input) {
+    const page = await input.apiClient.listDocumentEditAttributionRanges(input.query.documentId, {
+        cursor: input.query.cursor,
+        expectedRevision: input.query.expectedRevision,
+        limit: input.query.limit,
+    });
+    if (!page) {
+        throw new Error(`Edit attribution ranges were unavailable for document ${input.query.documentId}.`);
+    }
+    if (page.documentId !== input.query.documentId) {
+        throw new Error(`Edit attribution ranges belonged to document ${page.documentId}, not ${input.query.documentId}.`);
+    }
+    return page;
+}
+//# sourceMappingURL=documentAttributionRanges.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentAttributionRanges.js","sourceRoot":"","sources":["documentAttributionRanges.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,KAGnD;IACC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,iCAAiC,CAClE,KAAK,CAAC,KAAK,CAAC,UAAU,EACtB;QACE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAC1B,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,gBAAgB;QAC9C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;KACzB,CACF,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,yDAAyD,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CACnF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,gDAAgD,IAAI,CAAC,UAAU,SAAS,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type {\n  DocumentEditAttributionRangeResponse,\n  ListDocumentEditAttributionRangesResponse,\n} from \"@tearleads/validators/response\";\n\nexport interface DocumentAttributionRangesInput {\n  readonly cursor?: string | null | undefined;\n  readonly documentId: string;\n  readonly expectedRevision?: number | undefined;\n  readonly limit?: number | undefined;\n}\n\nexport interface DocumentAttributionRangesPage {\n  readonly attributionRevision: number;\n  readonly documentId: string;\n  readonly hasMore: boolean;\n  readonly items: DocumentEditAttributionRangeResponse[];\n  readonly nextCursor: string | null;\n}\n\ninterface DocumentAttributionRangesApi {\n  listDocumentEditAttributionRanges(\n    documentId: string,\n    options?: {\n      readonly cursor?: string | null | undefined;\n      readonly expectedRevision?: number | undefined;\n      readonly limit?: number | undefined;\n    },\n  ): Promise<ListDocumentEditAttributionRangesResponse | null>;\n}\n\nexport async function loadDocumentAttributionRanges(input: {\n  readonly apiClient: DocumentAttributionRangesApi;\n  readonly query: DocumentAttributionRangesInput;\n}): Promise<DocumentAttributionRangesPage> {\n  const page = await input.apiClient.listDocumentEditAttributionRanges(\n    input.query.documentId,\n    {\n      cursor: input.query.cursor,\n      expectedRevision: input.query.expectedRevision,\n      limit: input.query.limit,\n    },\n  );\n  if (!page) {\n    throw new Error(\n      `Edit attribution ranges were unavailable for document ${input.query.documentId}.`,\n    );\n  }\n  if (page.documentId !== input.query.documentId) {\n    throw new Error(\n      `Edit attribution ranges belonged to document ${page.documentId}, not ${input.query.documentId}.`,\n    );\n  }\n  return page;\n}\n"]}

package/workflows/container-contents/documentCharacterBlame.js

@@ -0,0 +1,33 @@
+import { base64ToBytes } from "../../internal/encoding/index.js";
+import { listSnapshotCharBlameSource } from "../../internal/loro/index.js";
+import { summarizeDocumentBlame, } from "../../data/documents/editAttribution.js";
+// Op-id extraction is linear (~1.8µs/char — ~90ms for a 50k snapshot, flat per
+// char), so this cap is a soft guard against pathologically large prose, not a
+// quadratic cliff: above it blame surfaces null rather than doing unbounded
+// synchronous work when the Info panel opens.
+const MAX_BLAME_CHARACTER_COUNT = 50_000;
+/**
+ * Rebuild the document's per-character op ids from the locally persisted
+ * content snapshot and resolve them against the attribution segments — in a
+ * single snapshot reconstruction — into both the per-writer blame summary and
+ * the coalesced per-writer ranges. Returns null when blame can't be produced:
+ * no local snapshot, a snapshot too large to scan cheaply, or an unreadable
+ * snapshot — blame is supplementary and must never block (or blank) the rest
+ * of the Info panel, mirroring the attribution fetch's degrade-to-null.
+ */
+export function computeDocumentBlame(contentSnapshot, segments) {
+    if (!contentSnapshot || contentSnapshot.length === 0) {
+        return null;
+    }
+    try {
+        const source = listSnapshotCharBlameSource(base64ToBytes(contentSnapshot), MAX_BLAME_CHARACTER_COUNT);
+        if (source === null) {
+            return null;
+        }
+        return summarizeDocumentBlame(source, segments);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=documentCharacterBlame.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentCharacterBlame.js","sourceRoot":"","sources":["documentCharacterBlame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAGL,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAE9C,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,8CAA8C;AAC9C,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,eAA8B,EAC9B,QAAqD;IAOrD,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,2BAA2B,CACxC,aAAa,CAAC,eAAe,CAAC,EAC9B,yBAAyB,CAC1B,CAAC;QACF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import { base64ToBytes } from \"@tearleads/encoding\";\nimport { listSnapshotCharBlameSource } from \"@tearleads/loro\";\nimport type { DocumentEditAttributionResponse } from \"@tearleads/validators/response\";\nimport {\n  type DocumentBlameRange,\n  type DocumentCharacterBlameSummary,\n  summarizeDocumentBlame,\n} from \"../../data/documents/editAttribution\";\n\n// Op-id extraction is linear (~1.8µs/char — ~90ms for a 50k snapshot, flat per\n// char), so this cap is a soft guard against pathologically large prose, not a\n// quadratic cliff: above it blame surfaces null rather than doing unbounded\n// synchronous work when the Info panel opens.\nconst MAX_BLAME_CHARACTER_COUNT = 50_000;\n\n/**\n * Rebuild the document's per-character op ids from the locally persisted\n * content snapshot and resolve them against the attribution segments — in a\n * single snapshot reconstruction — into both the per-writer blame summary and\n * the coalesced per-writer ranges. Returns null when blame can't be produced:\n * no local snapshot, a snapshot too large to scan cheaply, or an unreadable\n * snapshot — blame is supplementary and must never block (or blank) the rest\n * of the Info panel, mirroring the attribution fetch's degrade-to-null.\n */\nexport function computeDocumentBlame(\n  contentSnapshot: string | null,\n  segments: DocumentEditAttributionResponse[\"segments\"],\n): {\n  /** Per-writer live-character counts (the Contributors-style rollup). */\n  characterBlame: DocumentCharacterBlameSummary;\n  /** Contiguous per-writer runs of the current prose (the read-only blame view). */\n  blameRanges: DocumentBlameRange[];\n} | null {\n  if (!contentSnapshot || contentSnapshot.length === 0) {\n    return null;\n  }\n  try {\n    const source = listSnapshotCharBlameSource(\n      base64ToBytes(contentSnapshot),\n      MAX_BLAME_CHARACTER_COUNT,\n    );\n    if (source === null) {\n      return null;\n    }\n    return summarizeDocumentBlame(source, segments);\n  } catch {\n    return null;\n  }\n}\n"]}