@tearleads/client-sdk 0.1.61 → 0.1.63

package/workflows/container-contents/containerDocumentListing.js

@@ -1,106 +0,0 @@
-import { DEFAULT_CONTAINER_DOCUMENT_LANE_PAGE_LIMIT, MAX_CONTAINER_DOCUMENT_LANE_PAGE_TOTAL, MAX_CONTAINER_DOCUMENT_LANES, } from "../../internal/validators/request/index.js";
-/**
- * Rows each lane may return so a full batch stays within the single-page
- * maximum; a lone lane keeps the ordinary page size.
- */
-function laneLimit(laneCount) {
-    return Math.max(1, Math.min(DEFAULT_CONTAINER_DOCUMENT_LANE_PAGE_LIMIT, Math.floor(MAX_CONTAINER_DOCUMENT_LANE_PAGE_TOTAL / laneCount)));
-}
-/**
- * Lists one page per requested lane in a single batched request. A lane the
- * server rejected yields `null` for that lane only; a failed request yields
- * `null` for the batch.
- */
-export async function listContainerDocumentLanesFromApi(apiClient, lanes, reportErrors = true) {
-    const limit = laneLimit(lanes.length);
-    const requested = lanes.map((lane, index) => ({
-        containerId: lane.containerId,
-        laneId: `lane-${index}`,
-        limit,
-        watermark: lane.watermark,
-    }));
-    const response = await apiClient.listContainerDocumentLanes({ lanes: requested }, { reportErrors });
-    if (!response)
-        return null;
-    const resultsByLaneId = new Map(response.results.map((result) => [result.laneId, result]));
-    return requested.map(({ laneId }) => {
-        const result = resultsByLaneId.get(laneId);
-        return result && "page" in result ? result.page : null;
-    });
-}
-/**
- * Pages every lane to exhaustion, batching first pages and continuations
- * alike. Each container keeps its own watermark, so one lane's failure or
- * continuation never changes another lane's result.
- */
-export async function listAllContainerDocumentLanes(input) {
-    const listed = new Map();
-    const pending = [];
-    const queued = new Set();
-    for (const { containerId, watermark } of input.lanes) {
-        if (queued.has(containerId))
-            continue;
-        queued.add(containerId);
-        pending.push({
-            containerId,
-            isFullListing: watermark === null,
-            items: [],
-            tombstones: [],
-            watermark,
-        });
-    }
-    while (pending.length > 0) {
-        const batch = pending.splice(0, MAX_CONTAINER_DOCUMENT_LANES);
-        const pages = await input.listContainerDocumentLanes(batch.map(({ containerId, watermark }) => ({ containerId, watermark })));
-        batch.forEach((lane, index) => {
-            const page = pages?.[index] ?? null;
-            if (!page) {
-                listed.set(lane.containerId, null);
-                return;
-            }
-            lane.items.push(...page.items);
-            lane.tombstones.push(...page.tombstones);
-            lane.watermark = page.nextWatermark;
-            if (!page.hasMore) {
-                listed.set(lane.containerId, {
-                    isFullListing: lane.isFullListing,
-                    items: lane.items,
-                    nextWatermark: lane.watermark,
-                    tombstones: lane.tombstones,
-                });
-            }
-            else if (lane.watermark) {
-                pending.push(lane);
-            }
-            else {
-                listed.set(lane.containerId, null);
-            }
-        });
-    }
-    return listed;
-}
-/** Lists the authoritative current ids by deliberately starting at no watermark. */
-export async function listAllContainerDocumentIdsFromApi(input) {
-    const listed = (await listAllContainerDocumentLanes({
-        lanes: [{ containerId: input.containerId, watermark: null }],
-        listContainerDocumentLanes: (lanes) => listContainerDocumentLanesFromApi(input.apiClient, lanes, input.reportErrors),
-    })).get(input.containerId);
-    return listed
-        ? Array.from(new Set(listed.items.map((document) => document.id)))
-        : null;
-}
-/** Loads each lane's persisted watermark, then lists every lane in batches. */
-export async function listContainerDocumentsFromWatermarks(input) {
-    const lanes = [];
-    for (const containerId of new Set(input.containerIds)) {
-        lanes.push({
-            containerId,
-            watermark: await input.loadContainerDocumentWatermark(containerId),
-        });
-    }
-    return listAllContainerDocumentLanes({
-        lanes,
-        listContainerDocumentLanes: input.listContainerDocumentLanes,
-    });
-}
-//# sourceMappingURL=containerDocumentListing.js.map

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

@@ -1,77 +0,0 @@
-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

@@ -1,200 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/deferredDocumentLinks.js

@@ -1,9 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,26 +0,0 @@
-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/documentCharacterBlame.js

@@ -1,33 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"]}

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

@@ -1,12 +0,0 @@
-import type { DocumentSummary } from "../../data/documents/documentSummary.js";
-import type { ContainerDocumentDiscoveryApi, DiscoverAllContainerDocumentsOptions, DiscoverContainerDocumentsOptions, RefreshAllContainerDocumentsFromApiOptions } from "./documentDiscoveryTypes.js";
-export type { RefreshAllContainerDocumentsFromApiOptions } from "./documentDiscoveryTypes.js";
-export declare function hasUndiscoveredDocumentUpdateEvent(events: ReadonlyArray<unknown>, knownDocumentIds: ReadonlySet<string>): boolean;
-export declare function listAllRemoteContainerIds(listContainerParentLanes: ContainerDocumentDiscoveryApi["listContainerParentLanes"]): Promise<ReadonlyArray<string> | null>;
-export declare function listAllRemoteContainerIdsFromApi(apiClient: Pick<ContainerDocumentDiscoveryApi, "listContainerParentLanes">): Promise<ReadonlyArray<string> | null>;
-export declare function discoverContainerDocuments({ beginDocumentDiscovery, listContainerDocumentLanes, loadContainerDocumentWatermark, ...lane }: DiscoverContainerDocumentsOptions): Promise<ReadonlyArray<DocumentSummary> | null>;
-export declare function discoverContainerDocumentsFromApi({ apiClient, ...input }: Omit<DiscoverContainerDocumentsOptions, "listContainerDocumentLanes"> & {
-    readonly apiClient: Pick<ContainerDocumentDiscoveryApi, "listContainerDocumentLanes">;
-}): Promise<ReadonlyArray<DocumentSummary> | null>;
-export declare function discoverAllContainerDocuments(options: DiscoverAllContainerDocumentsOptions): Promise<ReadonlyArray<DocumentSummary> | null>;
-export declare function refreshAllContainerDocumentsFromApi({ apiClient, ...input }: RefreshAllContainerDocumentsFromApiOptions): Promise<ReadonlyArray<DocumentSummary> | null>;