@tearleads/client-sdk 0.0.0-stage → 0.1.13

package/data/persistence/container-contents/containerIntentPersistence.js

@@ -0,0 +1,207 @@
+import { and, asc, eq, inArray } from "drizzle-orm";
+import { containerCreateIntents, containerMoveIntents, } from "../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { CONTAINER_CREATE_INTENT_TYPE, CONTAINER_MOVE_INTENT_TYPE, } from "./containerContentsPersistenceTypes.js";
+import { settleContainerCreateIntentRevision } from "./containerCreateIntentSettlement.js";
+function parseCreateIntentSyncStatus(value) {
+    return value === "synced" ? "synced" : "pending";
+}
+function parseMoveIntentSyncStatus(value) {
+    return value === "blocked" ? "blocked" : "pending";
+}
+function mapContainerCreateIntentRecord(row) {
+    return {
+        id: String(row.id ?? ""),
+        containerId: row.containerId,
+        parentContainerId: row.parentContainerId,
+        intentType: CONTAINER_CREATE_INTENT_TYPE,
+        syncStatus: parseCreateIntentSyncStatus(row.syncStatus),
+        remoteContainerId: row.remoteContainerId,
+        remoteMetadataDocumentId: row.remoteMetadataDocumentId,
+        remoteMetadataAccessStateHash: row.remoteMetadataAccessStateHash,
+        lastError: row.lastError,
+        lastAttemptedAt: row.lastAttemptedAt,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+function mapContainerMoveIntentRecord(row) {
+    return {
+        id: String(row.id ?? ""),
+        containerId: row.containerId,
+        parentContainerId: row.parentContainerId,
+        previousParentContainerId: row.previousParentContainerId,
+        intentType: CONTAINER_MOVE_INTENT_TYPE,
+        syncStatus: parseMoveIntentSyncStatus(row.syncStatus),
+        lastError: row.lastError,
+        lastAttemptedAt: row.lastAttemptedAt,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+export async function saveContainerCreateIntent(input) {
+    const { containerId, createIntent, tx, updatedAt } = input;
+    const id = createIntent.id ?? crypto.randomUUID();
+    await tx
+        .insert(containerCreateIntents)
+        .values({
+        id,
+        containerId,
+        parentContainerId: createIntent.parentContainerId,
+        intentType: CONTAINER_CREATE_INTENT_TYPE,
+        syncStatus: "pending",
+        remoteContainerId: null,
+        remoteMetadataDocumentId: null,
+        remoteMetadataAccessStateHash: null,
+        lastError: null,
+        lastAttemptedAt: null,
+        createdAt: updatedAt,
+        updatedAt,
+    })
+        .onConflictDoUpdate({
+        target: containerCreateIntents.containerId,
+        set: {
+            // Timestamps can collide when a create is re-queued in one clock tick,
+            // so every enqueue owns a fresh revision token too.
+            id,
+            parentContainerId: createIntent.parentContainerId,
+            intentType: CONTAINER_CREATE_INTENT_TYPE,
+            syncStatus: "pending",
+            remoteContainerId: null,
+            remoteMetadataDocumentId: null,
+            remoteMetadataAccessStateHash: null,
+            lastError: null,
+            lastAttemptedAt: null,
+            updatedAt,
+        },
+    })
+        .run();
+}
+export class ContainerCreateIntentSupersededError extends Error {
+    constructor() {
+        super("Container create intent was superseded before local settlement");
+    }
+}
+export async function deleteContainerMoveIntentRevision(input) {
+    const deleted = await input.tx
+        .delete(containerMoveIntents)
+        .where(and(eq(containerMoveIntents.containerId, input.containerId), eq(containerMoveIntents.intentType, CONTAINER_MOVE_INTENT_TYPE), eq(containerMoveIntents.id, input.expectedIntentId), eq(containerMoveIntents.updatedAt, input.expectedUpdatedAt)))
+        .returning({ containerId: containerMoveIntents.containerId });
+    return deleted.length > 0;
+}
+async function recordCreateIntentErrorAttempt(execSql, input) {
+    const { containerId, expectedIntentId, expectedUpdatedAt, message, stillCurrent, } = input;
+    if (!message)
+        throw new Error("Container create intent error is required");
+    const runtime = getClientSQLitePersistenceRuntime(execSql);
+    const record = async (tx) => {
+        const updatedAt = new Date().toISOString();
+        await tx
+            .update(containerCreateIntents)
+            .set({
+            lastAttemptedAt: updatedAt,
+            lastError: message,
+            updatedAt,
+        })
+            .where(and(eq(containerCreateIntents.containerId, containerId), eq(containerCreateIntents.syncStatus, "pending"), eq(containerCreateIntents.intentType, CONTAINER_CREATE_INTENT_TYPE), eq(containerCreateIntents.id, expectedIntentId), eq(containerCreateIntents.updatedAt, expectedUpdatedAt)))
+            .run();
+    };
+    if (stillCurrent) {
+        await runtime.guardedTransaction(record, stillCurrent, {
+            behavior: "immediate",
+        });
+        return;
+    }
+    await runtime.transaction(record, { behavior: "immediate" });
+}
+async function markMoveIntentRevisionSynced(execSql, input) {
+    const outcome = await getClientSQLitePersistenceRuntime(execSql).guardedTransaction(async (tx) => {
+        return deleteContainerMoveIntentRevision({ ...input, tx });
+    }, input.stillCurrent, { behavior: "immediate" });
+    return outcome.committed && outcome.result === true;
+}
+async function markCreateIntentRevisionSynced(execSql, input) {
+    const outcome = await getClientSQLitePersistenceRuntime(execSql).guardedTransaction(async (tx) => settleContainerCreateIntentRevision({ ...input, tx }), input.stillCurrent, { behavior: "immediate" });
+    return outcome.committed && outcome.result !== "superseded";
+}
+export const containerIntentPersistence = {
+    async listPendingCreateIntents(execSql) {
+        const { db } = getClientSQLitePersistenceRuntime(execSql);
+        const rows = await db
+            .select({
+            id: containerCreateIntents.id,
+            containerId: containerCreateIntents.containerId,
+            parentContainerId: containerCreateIntents.parentContainerId,
+            syncStatus: containerCreateIntents.syncStatus,
+            remoteContainerId: containerCreateIntents.remoteContainerId,
+            remoteMetadataDocumentId: containerCreateIntents.remoteMetadataDocumentId,
+            remoteMetadataAccessStateHash: containerCreateIntents.remoteMetadataAccessStateHash,
+            lastError: containerCreateIntents.lastError,
+            lastAttemptedAt: containerCreateIntents.lastAttemptedAt,
+            createdAt: containerCreateIntents.createdAt,
+            updatedAt: containerCreateIntents.updatedAt,
+        })
+            .from(containerCreateIntents)
+            .where(and(eq(containerCreateIntents.syncStatus, "pending"), eq(containerCreateIntents.intentType, CONTAINER_CREATE_INTENT_TYPE)))
+            .orderBy(asc(containerCreateIntents.createdAt));
+        return rows.map((row) => mapContainerCreateIntentRecord(row));
+    },
+    async listUnsyncedMoveIntents(execSql) {
+        const { db } = getClientSQLitePersistenceRuntime(execSql);
+        // No status filter: markMoveIntentRevisionSynced deletes settled rows,
+        // so every surviving row is unsynced. Blocked intents replay too: "blocked"
+        // names the reason the last attempt could not proceed, not a terminal
+        // verdict — the missing container can appear via hydration, after which
+        // the move completes — and hydration must still not revert them.
+        const rows = await db
+            .select({
+            id: containerMoveIntents.id,
+            containerId: containerMoveIntents.containerId,
+            parentContainerId: containerMoveIntents.parentContainerId,
+            previousParentContainerId: containerMoveIntents.previousParentContainerId,
+            syncStatus: containerMoveIntents.syncStatus,
+            lastError: containerMoveIntents.lastError,
+            lastAttemptedAt: containerMoveIntents.lastAttemptedAt,
+            createdAt: containerMoveIntents.createdAt,
+            updatedAt: containerMoveIntents.updatedAt,
+        })
+            .from(containerMoveIntents)
+            .where(eq(containerMoveIntents.intentType, CONTAINER_MOVE_INTENT_TYPE))
+            .orderBy(asc(containerMoveIntents.createdAt));
+        return rows.map((row) => mapContainerMoveIntentRecord(row));
+    },
+    recordCreateIntentRevisionError: (execSql, input) => recordCreateIntentErrorAttempt(execSql, input),
+    async recordMoveIntentError(execSql, input) {
+        const runtime = getClientSQLitePersistenceRuntime(execSql);
+        const record = async (tx) => {
+            const updatedAt = new Date().toISOString();
+            await tx
+                .update(containerMoveIntents)
+                .set({
+                lastAttemptedAt: updatedAt,
+                lastError: input.message,
+                syncStatus: input.blocked ? "blocked" : "pending",
+                updatedAt,
+            })
+                .where(and(eq(containerMoveIntents.containerId, input.containerId), 
+            // Blocked rows stay updatable so a retried intent records its
+            // fresh outcome and a transient failure unblocks it.
+            inArray(containerMoveIntents.syncStatus, ["pending", "blocked"]), eq(containerMoveIntents.intentType, CONTAINER_MOVE_INTENT_TYPE), ...(input.expectedIntentId
+                ? [eq(containerMoveIntents.id, input.expectedIntentId)]
+                : []), ...(input.expectedUpdatedAt
+                ? [eq(containerMoveIntents.updatedAt, input.expectedUpdatedAt)]
+                : [])))
+                .run();
+        };
+        if (input.stillCurrent) {
+            await runtime.guardedTransaction(record, input.stillCurrent, {
+                behavior: "immediate",
+            });
+            return;
+        }
+        await runtime.transaction(record, { behavior: "immediate" });
+    },
+    markCreateIntentRevisionSynced,
+    markMoveIntentRevisionSynced,
+};
+//# sourceMappingURL=containerIntentPersistence.js.map

package/data/persistence/container-contents/containerIntentPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerIntentPersistence.js","sourceRoot":"","sources":["containerIntentPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, asc, eq, inArray } from \"drizzle-orm\";\nimport {\n  containerCreateIntents,\n  containerMoveIntents,\n} from \"../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../sqlite/sqlSchema\";\nimport {\n  CONTAINER_CREATE_INTENT_TYPE,\n  CONTAINER_MOVE_INTENT_TYPE,\n  type ContainerContentsPersistence,\n  type ContainerCreateIntentErrorInput,\n  type ContainerCreateIntentInput,\n  type ContainerCreateIntentRecord,\n  type ContainerCreateIntentRevisionInput,\n  type ContainerCreateIntentSyncStatus,\n  type ContainerMoveIntentRecord,\n  type ContainerMoveIntentRevisionInput,\n  type ContainerMoveIntentSyncStatus,\n} from \"./containerContentsPersistenceTypes\";\nimport { settleContainerCreateIntentRevision } from \"./containerCreateIntentSettlement\";\n\nfunction parseCreateIntentSyncStatus(\n  value: unknown,\n): ContainerCreateIntentSyncStatus {\n  return value === \"synced\" ? \"synced\" : \"pending\";\n}\n\nfunction parseMoveIntentSyncStatus(\n  value: unknown,\n): ContainerMoveIntentSyncStatus {\n  return value === \"blocked\" ? \"blocked\" : \"pending\";\n}\n\ninterface SelectedContainerCreateIntentRecord {\n  id: string | null;\n  containerId: string;\n  parentContainerId: string;\n  syncStatus: string;\n  remoteContainerId: string | null;\n  remoteMetadataDocumentId: string | null;\n  remoteMetadataAccessStateHash: string | null;\n  lastError: string | null;\n  lastAttemptedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\ninterface SelectedContainerMoveIntentRecord {\n  id: string | null;\n  containerId: string;\n  parentContainerId: string;\n  previousParentContainerId: string | null;\n  syncStatus: string;\n  lastError: string | null;\n  lastAttemptedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\nfunction mapContainerCreateIntentRecord(\n  row: SelectedContainerCreateIntentRecord,\n): ContainerCreateIntentRecord {\n  return {\n    id: String(row.id ?? \"\"),\n    containerId: row.containerId,\n    parentContainerId: row.parentContainerId,\n    intentType: CONTAINER_CREATE_INTENT_TYPE,\n    syncStatus: parseCreateIntentSyncStatus(row.syncStatus),\n    remoteContainerId: row.remoteContainerId,\n    remoteMetadataDocumentId: row.remoteMetadataDocumentId,\n    remoteMetadataAccessStateHash: row.remoteMetadataAccessStateHash,\n    lastError: row.lastError,\n    lastAttemptedAt: row.lastAttemptedAt,\n    createdAt: row.createdAt,\n    updatedAt: row.updatedAt,\n  };\n}\n\nfunction mapContainerMoveIntentRecord(\n  row: SelectedContainerMoveIntentRecord,\n): ContainerMoveIntentRecord {\n  return {\n    id: String(row.id ?? \"\"),\n    containerId: row.containerId,\n    parentContainerId: row.parentContainerId,\n    previousParentContainerId: row.previousParentContainerId,\n    intentType: CONTAINER_MOVE_INTENT_TYPE,\n    syncStatus: parseMoveIntentSyncStatus(row.syncStatus),\n    lastError: row.lastError,\n    lastAttemptedAt: row.lastAttemptedAt,\n    createdAt: row.createdAt,\n    updatedAt: row.updatedAt,\n  };\n}\n\nexport async function saveContainerCreateIntent(input: {\n  tx: ClientSQLiteTransactionScope;\n  containerId: string;\n  createIntent: ContainerCreateIntentInput;\n  updatedAt: string;\n}) {\n  const { containerId, createIntent, tx, updatedAt } = input;\n  const id = createIntent.id ?? crypto.randomUUID();\n  await tx\n    .insert(containerCreateIntents)\n    .values({\n      id,\n      containerId,\n      parentContainerId: createIntent.parentContainerId,\n      intentType: CONTAINER_CREATE_INTENT_TYPE,\n      syncStatus: \"pending\",\n      remoteContainerId: null,\n      remoteMetadataDocumentId: null,\n      remoteMetadataAccessStateHash: null,\n      lastError: null,\n      lastAttemptedAt: null,\n      createdAt: updatedAt,\n      updatedAt,\n    })\n    .onConflictDoUpdate({\n      target: containerCreateIntents.containerId,\n      set: {\n        // Timestamps can collide when a create is re-queued in one clock tick,\n        // so every enqueue owns a fresh revision token too.\n        id,\n        parentContainerId: createIntent.parentContainerId,\n        intentType: CONTAINER_CREATE_INTENT_TYPE,\n        syncStatus: \"pending\",\n        remoteContainerId: null,\n        remoteMetadataDocumentId: null,\n        remoteMetadataAccessStateHash: null,\n        lastError: null,\n        lastAttemptedAt: null,\n        updatedAt,\n      },\n    })\n    .run();\n}\n\nexport class ContainerCreateIntentSupersededError extends Error {\n  constructor() {\n    super(\"Container create intent was superseded before local settlement\");\n  }\n}\n\nexport async function deleteContainerMoveIntentRevision(input: {\n  containerId: string;\n  expectedIntentId: string;\n  expectedUpdatedAt: string;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<boolean> {\n  const deleted = await input.tx\n    .delete(containerMoveIntents)\n    .where(\n      and(\n        eq(containerMoveIntents.containerId, input.containerId),\n        eq(containerMoveIntents.intentType, CONTAINER_MOVE_INTENT_TYPE),\n        eq(containerMoveIntents.id, input.expectedIntentId),\n        eq(containerMoveIntents.updatedAt, input.expectedUpdatedAt),\n      ),\n    )\n    .returning({ containerId: containerMoveIntents.containerId });\n  return deleted.length > 0;\n}\n\nasync function recordCreateIntentErrorAttempt(\n  execSql: ExecSql,\n  input: ContainerCreateIntentErrorInput,\n): Promise<void> {\n  const {\n    containerId,\n    expectedIntentId,\n    expectedUpdatedAt,\n    message,\n    stillCurrent,\n  } = input;\n  if (!message) throw new Error(\"Container create intent error is required\");\n  const runtime = getClientSQLitePersistenceRuntime(execSql);\n  const record = async (tx: ClientSQLiteTransactionScope) => {\n    const updatedAt = new Date().toISOString();\n    await tx\n      .update(containerCreateIntents)\n      .set({\n        lastAttemptedAt: updatedAt,\n        lastError: message,\n        updatedAt,\n      })\n      .where(\n        and(\n          eq(containerCreateIntents.containerId, containerId),\n          eq(containerCreateIntents.syncStatus, \"pending\"),\n          eq(containerCreateIntents.intentType, CONTAINER_CREATE_INTENT_TYPE),\n          eq(containerCreateIntents.id, expectedIntentId),\n          eq(containerCreateIntents.updatedAt, expectedUpdatedAt),\n        ),\n      )\n      .run();\n  };\n  if (stillCurrent) {\n    await runtime.guardedTransaction(record, stillCurrent, {\n      behavior: \"immediate\",\n    });\n    return;\n  }\n  await runtime.transaction(record, { behavior: \"immediate\" });\n}\n\nasync function markMoveIntentRevisionSynced(\n  execSql: ExecSql,\n  input: ContainerMoveIntentRevisionInput,\n): Promise<boolean> {\n  const outcome = await getClientSQLitePersistenceRuntime(\n    execSql,\n  ).guardedTransaction(\n    async (tx) => {\n      return deleteContainerMoveIntentRevision({ ...input, tx });\n    },\n    input.stillCurrent,\n    { behavior: \"immediate\" },\n  );\n  return outcome.committed && outcome.result === true;\n}\n\nasync function markCreateIntentRevisionSynced(\n  execSql: ExecSql,\n  input: ContainerCreateIntentRevisionInput,\n): Promise<boolean> {\n  const outcome = await getClientSQLitePersistenceRuntime(\n    execSql,\n  ).guardedTransaction(\n    async (tx) => settleContainerCreateIntentRevision({ ...input, tx }),\n    input.stillCurrent,\n    { behavior: \"immediate\" },\n  );\n  return outcome.committed && outcome.result !== \"superseded\";\n}\n\ntype ContainerIntentPersistence = Pick<\n  ContainerContentsPersistence,\n  | \"listPendingCreateIntents\"\n  | \"listUnsyncedMoveIntents\"\n  | \"recordCreateIntentRevisionError\"\n  | \"recordMoveIntentError\"\n  | \"markCreateIntentRevisionSynced\"\n  | \"markMoveIntentRevisionSynced\"\n>;\n\nexport const containerIntentPersistence = {\n  async listPendingCreateIntents(execSql) {\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    const rows = await db\n      .select({\n        id: containerCreateIntents.id,\n        containerId: containerCreateIntents.containerId,\n        parentContainerId: containerCreateIntents.parentContainerId,\n        syncStatus: containerCreateIntents.syncStatus,\n        remoteContainerId: containerCreateIntents.remoteContainerId,\n        remoteMetadataDocumentId:\n          containerCreateIntents.remoteMetadataDocumentId,\n        remoteMetadataAccessStateHash:\n          containerCreateIntents.remoteMetadataAccessStateHash,\n        lastError: containerCreateIntents.lastError,\n        lastAttemptedAt: containerCreateIntents.lastAttemptedAt,\n        createdAt: containerCreateIntents.createdAt,\n        updatedAt: containerCreateIntents.updatedAt,\n      })\n      .from(containerCreateIntents)\n      .where(\n        and(\n          eq(containerCreateIntents.syncStatus, \"pending\"),\n          eq(containerCreateIntents.intentType, CONTAINER_CREATE_INTENT_TYPE),\n        ),\n      )\n      .orderBy(asc(containerCreateIntents.createdAt));\n\n    return rows.map((row) => mapContainerCreateIntentRecord(row));\n  },\n  async listUnsyncedMoveIntents(execSql) {\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    // No status filter: markMoveIntentRevisionSynced deletes settled rows,\n    // so every surviving row is unsynced. Blocked intents replay too: \"blocked\"\n    // names the reason the last attempt could not proceed, not a terminal\n    // verdict — the missing container can appear via hydration, after which\n    // the move completes — and hydration must still not revert them.\n    const rows = await db\n      .select({\n        id: containerMoveIntents.id,\n        containerId: containerMoveIntents.containerId,\n        parentContainerId: containerMoveIntents.parentContainerId,\n        previousParentContainerId:\n          containerMoveIntents.previousParentContainerId,\n        syncStatus: containerMoveIntents.syncStatus,\n        lastError: containerMoveIntents.lastError,\n        lastAttemptedAt: containerMoveIntents.lastAttemptedAt,\n        createdAt: containerMoveIntents.createdAt,\n        updatedAt: containerMoveIntents.updatedAt,\n      })\n      .from(containerMoveIntents)\n      .where(eq(containerMoveIntents.intentType, CONTAINER_MOVE_INTENT_TYPE))\n      .orderBy(asc(containerMoveIntents.createdAt));\n\n    return rows.map((row) => mapContainerMoveIntentRecord(row));\n  },\n  recordCreateIntentRevisionError: (execSql, input) =>\n    recordCreateIntentErrorAttempt(execSql, input),\n  async recordMoveIntentError(execSql, input) {\n    const runtime = getClientSQLitePersistenceRuntime(execSql);\n    const record = async (tx: ClientSQLiteTransactionScope) => {\n      const updatedAt = new Date().toISOString();\n      await tx\n        .update(containerMoveIntents)\n        .set({\n          lastAttemptedAt: updatedAt,\n          lastError: input.message,\n          syncStatus: input.blocked ? \"blocked\" : \"pending\",\n          updatedAt,\n        })\n        .where(\n          and(\n            eq(containerMoveIntents.containerId, input.containerId),\n            // Blocked rows stay updatable so a retried intent records its\n            // fresh outcome and a transient failure unblocks it.\n            inArray(containerMoveIntents.syncStatus, [\"pending\", \"blocked\"]),\n            eq(containerMoveIntents.intentType, CONTAINER_MOVE_INTENT_TYPE),\n            ...(input.expectedIntentId\n              ? [eq(containerMoveIntents.id, input.expectedIntentId)]\n              : []),\n            ...(input.expectedUpdatedAt\n              ? [eq(containerMoveIntents.updatedAt, input.expectedUpdatedAt)]\n              : []),\n          ),\n        )\n        .run();\n    };\n    if (input.stillCurrent) {\n      await runtime.guardedTransaction(record, input.stillCurrent, {\n        behavior: \"immediate\",\n      });\n      return;\n    }\n    await runtime.transaction(record, { behavior: \"immediate\" });\n  },\n  markCreateIntentRevisionSynced,\n  markMoveIntentRevisionSynced,\n} satisfies ContainerIntentPersistence;\n"]}

package/data/persistence/container-contents/containerMetadataMutationPersistence.js

@@ -0,0 +1,259 @@
+import { and, eq, inArray } from "drizzle-orm";
+import { assertHeldContainerBinding, heldContainerBinding, } from "../../containers/containerBinding.js";
+import { documentSyncPullContinuationsEqual } from "../../documents/shared/pullContinuation.js";
+import { enqueueDocumentPendingUpdate, } from "../../sqlite/documentPersistence.js";
+import { containerCreateIntents, containerMoveIntents, documentPendingUpdates, documentSyncFailures, } from "../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { runSerializedSqlMutation } from "../../sqlite/sqlSchema.js";
+import { loadContainerById, } from "../containers/containerPersistence.js";
+import { settleContainerCreateIntentRevision } from "./containerCreateIntentSettlement.js";
+import { ContainerCreateIntentSupersededError, deleteContainerMoveIntentRevision, } from "./containerIntentPersistence.js";
+import { getContainerMetadataScope, saveContainerContentsContainerRows, selectContainerMetadataRecord, } from "./containerMetadataRows.js";
+import { CONTAINER_METADATA_APP_KIND } from "./dormantContainerMetadata.js";
+function sameNullableValue(left, right) {
+    return (left ?? null) === (right ?? null);
+}
+function committedMetadataMutationResult(input) {
+    return {
+        committed: true,
+        container: input.container,
+        ...(input.createIntentSettled
+            ? { createIntentSettled: true }
+            : {}),
+        ...(input.moveIntentSettled ? { moveIntentSettled: true } : {}),
+    };
+}
+function sameMetadataSecurityIdentity(current, expected) {
+    return (current.id === expected.id &&
+        current.documentId === expected.documentId &&
+        current.accessEpoch === expected.accessEpoch &&
+        sameNullableValue(current.accessStateHash, expected.accessStateHash) &&
+        sameNullableValue(current.contentKeyBundle, expected.contentKeyBundle) &&
+        sameNullableValue(current.documentKekTargets, expected.documentKekTargets) &&
+        sameNullableValue(current.documentManifestBundle, expected.documentManifestBundle));
+}
+function sameMetadataRecord(current, expected) {
+    return (sameMetadataSecurityIdentity(current, expected) &&
+        sameNullableValue(current.lastCommitLsn, expected.lastCommitLsn) &&
+        current.metadataUpdates === expected.metadataUpdates &&
+        current.snapshotEndVersion === expected.snapshotEndVersion &&
+        documentSyncPullContinuationsEqual(current.pullContinuation, expected.pullContinuation) &&
+        Boolean(current.pullContinuationRecoveryRequired) ===
+            Boolean(expected.pullContinuationRecoveryRequired));
+}
+function sameContainerRecord(current, expected) {
+    return (current.id === expected.id &&
+        current.parentId === expected.parentId &&
+        current.organizationId === expected.organizationId &&
+        current.metadataDocumentId === expected.metadataDocumentId &&
+        (current.systemSlot ?? null) === (expected.systemSlot ?? null) &&
+        (current.effectiveAccessLevel ?? null) ===
+            (expected.effectiveAccessLevel ?? null) &&
+        (current.localUpdatedAt ?? null) === (expected.localUpdatedAt ?? null) &&
+        (current.serverCreatedAt ?? null) === (expected.serverCreatedAt ?? null) &&
+        (current.serverUpdatedAt ?? null) === (expected.serverUpdatedAt ?? null) &&
+        current.name === expected.name &&
+        (current.icon ?? null) === (expected.icon ?? null));
+}
+async function loadStoredContainerState(execSql, containerId) {
+    const container = await loadContainerById(execSql, containerId);
+    if (!container)
+        return null;
+    return {
+        container,
+        record: await selectContainerMetadataRecord(execSql, containerId),
+    };
+}
+async function deleteAcceptedPendingUpdates(tx, containerId, ids) {
+    const uniqueIds = [...new Set(ids)];
+    if (uniqueIds.length === 0)
+        return;
+    await tx
+        .delete(documentPendingUpdates)
+        .where(and(eq(documentPendingUpdates.appKind, CONTAINER_METADATA_APP_KIND), eq(documentPendingUpdates.localId, containerId), inArray(documentPendingUpdates.id, uniqueIds)))
+        .run();
+}
+async function clearSyncFailure(tx, containerId) {
+    await tx
+        .delete(documentSyncFailures)
+        .where(and(eq(documentSyncFailures.appKind, CONTAINER_METADATA_APP_KIND), eq(documentSyncFailures.localId, containerId)))
+        .run();
+}
+async function hasPendingUpdates(tx, containerId) {
+    const rows = await tx
+        .select({ id: documentPendingUpdates.id })
+        .from(documentPendingUpdates)
+        .where(and(eq(documentPendingUpdates.appKind, CONTAINER_METADATA_APP_KIND), eq(documentPendingUpdates.localId, containerId)))
+        .limit(1);
+    return rows.length > 0;
+}
+async function hasPendingStructuralIntent(tx, containerId) {
+    const pendingCreates = await tx
+        .select({ id: containerCreateIntents.id })
+        .from(containerCreateIntents)
+        .where(and(eq(containerCreateIntents.containerId, containerId), eq(containerCreateIntents.syncStatus, "pending")))
+        .limit(1);
+    if (pendingCreates.length > 0)
+        return true;
+    const unsyncedMoves = await tx
+        .select({ id: containerMoveIntents.id })
+        .from(containerMoveIntents)
+        .where(eq(containerMoveIntents.containerId, containerId))
+        .limit(1);
+    return unsyncedMoves.length > 0;
+}
+async function enqueuePendingUpdate(execSql, containerId, pendingUpdate) {
+    if (!pendingUpdate)
+        return;
+    await enqueueDocumentPendingUpdate(execSql, getContainerMetadataScope(containerId), pendingUpdate);
+}
+function staleServerMutationResult(currentState, input) {
+    const incomingServerUpdatedAt = input.saveOptions?.serverTimestamps?.updatedAt;
+    const hasOlderContainerTimestamp = incomingServerUpdatedAt != null &&
+        currentState?.container.serverUpdatedAt != null &&
+        currentState.container.serverUpdatedAt > incomingServerUpdatedAt;
+    const hasOlderMetadataAccessEpoch = currentState?.record != null &&
+        currentState.record.documentId === input.record.documentId &&
+        currentState.record.accessEpoch > input.record.accessEpoch;
+    return currentState?.record &&
+        (hasOlderContainerTimestamp || hasOlderMetadataAccessEpoch)
+        ? {
+            committed: false,
+            currentState,
+            staleServerState: true,
+        }
+        : null;
+}
+function metadataMutationStateMatches(currentState, input) {
+    return Boolean(currentState?.record &&
+        sameContainerRecord(currentState.container, input.expectedContainer) &&
+        sameMetadataRecord(currentState.record, input.expectedRecord));
+}
+async function rejectMetadataMutationConflict(input) {
+    const { currentState, mutation, tx } = input;
+    if (currentState?.record &&
+        mutation.settleAcceptedPendingOnConflict &&
+        sameMetadataSecurityIdentity(currentState.record, mutation.expectedRecord)) {
+        await deleteAcceptedPendingUpdates(tx, mutation.container.id, mutation.acceptedPendingUpdateIds);
+    }
+    return { committed: false, currentState };
+}
+async function prepareContainerMutationWrite(input) {
+    const { currentContainer, mutation, tx } = input;
+    const requestedLocalUpdatedAt = mutation.saveOptions?.localUpdatedAt ??
+        mutation.saveOptions?.updatedAt ??
+        new Date().toISOString();
+    const preserveDurableStructure = mutation.preserveDurableStructureWhenPending === true &&
+        (await hasPendingStructuralIntent(tx, mutation.container.id));
+    // Syncing metadata is not a local edit. Preserve the durable edit clock,
+    // including an edit another pane made while this request was in flight.
+    const localUpdatedAt = preserveDurableStructure || mutation.settleAcceptedPendingOnConflict
+        ? (currentContainer.localUpdatedAt ?? requestedLocalUpdatedAt)
+        : requestedLocalUpdatedAt;
+    const structurallyRebasedContainer = preserveDurableStructure
+        ? { ...mutation.container, parentId: currentContainer.parentId }
+        : mutation.container;
+    const didSettleOutgoing = mutation.acceptedPendingUpdateIds.length > 0 &&
+        !(await hasPendingUpdates(tx, mutation.container.id)) &&
+        !(await hasPendingStructuralIntent(tx, mutation.container.id));
+    // Only container responses establish the server's structural clock. A
+    // metadata acknowledgement supplies no such timestamp; marking it with our
+    // wall clock would make later valid listings appear stale forever.
+    return {
+        container: structurallyRebasedContainer,
+        localUpdatedAt: didSettleOutgoing
+            ? (currentContainer.serverUpdatedAt ?? localUpdatedAt)
+            : localUpdatedAt,
+    };
+}
+/** Server acknowledgements and listings cannot rebind a held folder. */
+function assertMutationKeepsHeldBinding(currentState, input) {
+    const recordDocumentIds = input.record.documentId === currentState.record.documentId
+        ? []
+        : [input.record.documentId];
+    assertHeldContainerBinding(heldContainerBinding(currentState), {
+        organizationId: input.container.organizationId,
+        metadataDocumentIds: [
+            input.container.metadataDocumentId,
+            ...recordDocumentIds,
+        ],
+    });
+}
+export async function commitStoredMetadataMutation(execSql, input) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        const outcome = await getClientSQLitePersistenceRuntime(lockedExecSql).guardedTransaction(async (tx) => {
+            const currentState = await loadStoredContainerState(lockedExecSql, input.container.id);
+            const staleServerResult = staleServerMutationResult(currentState, input);
+            if (staleServerResult)
+                return staleServerResult;
+            if (!metadataMutationStateMatches(currentState, input)) {
+                return rejectMetadataMutationConflict({
+                    currentState,
+                    mutation: input,
+                    tx,
+                });
+            }
+            assertMutationKeepsHeldBinding(currentState, input);
+            await enqueuePendingUpdate(lockedExecSql, input.container.id, input.pendingUpdate);
+            await deleteAcceptedPendingUpdates(tx, input.container.id, input.acceptedPendingUpdateIds);
+            if (input.clearSyncFailure) {
+                await clearSyncFailure(tx, input.container.id);
+            }
+            const { container, localUpdatedAt } = await prepareContainerMutationWrite({
+                currentContainer: currentState.container,
+                mutation: input,
+                tx,
+            });
+            const savedContainer = await saveContainerContentsContainerRows({
+                container,
+                createIntent: input.saveOptions?.createIntent,
+                localUpdatedAt,
+                moveIntent: input.saveOptions?.moveIntent,
+                record: input.record,
+                serverTimestamps: input.saveOptions?.serverTimestamps,
+                tx,
+            });
+            if (input.createIntentSettlement &&
+                (await settleContainerCreateIntentRevision({
+                    ...input.createIntentSettlement,
+                    tx,
+                })) === "superseded") {
+                throw new ContainerCreateIntentSupersededError();
+            }
+            if (input.moveIntentSettlement) {
+                if (!(await deleteContainerMoveIntentRevision({
+                    ...input.moveIntentSettlement,
+                    tx,
+                }))) {
+                    throw new Error("Container move intent was superseded before local settlement");
+                }
+            }
+            return committedMetadataMutationResult({
+                container: savedContainer,
+                createIntentSettled: input.createIntentSettlement !== undefined,
+                moveIntentSettled: input.moveIntentSettlement !== undefined,
+            });
+        }, () => !input.stillCurrent || input.stillCurrent(), { behavior: "immediate" });
+        if (outcome.committed && outcome.result) {
+            return outcome.result;
+        }
+        return {
+            committed: false,
+            currentState: await loadStoredContainerState(lockedExecSql, input.container.id),
+        };
+    });
+}
+export async function settleStoredMetadataPendingUpdates(execSql, input) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        const outcome = await getClientSQLitePersistenceRuntime(lockedExecSql).guardedTransaction(async (tx) => {
+            const currentState = await loadStoredContainerState(lockedExecSql, input.containerId);
+            if (currentState?.record &&
+                sameMetadataSecurityIdentity(currentState.record, input.expectedRecord)) {
+                await deleteAcceptedPendingUpdates(tx, input.containerId, input.pendingUpdateIds);
+            }
+            return currentState;
+        }, () => !input.stillCurrent || input.stillCurrent(), { behavior: "immediate" });
+        return outcome.committed ? outcome.result : null;
+    });
+}
+//# sourceMappingURL=containerMetadataMutationPersistence.js.map

package/data/persistence/container-contents/containerMetadataMutationPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerMetadataMutationPersistence.js","sourceRoot":"","sources":["containerMetadataMutationPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EACL,4BAA4B,GAE7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,iCAAiC,GAClC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAEL,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAM5C,OAAO,EAAE,mCAAmC,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EACL,oCAAoC,EACpC,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,kCAAkC,EAClC,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,SAAS,iBAAiB,CACxB,IAA+B,EAC/B,KAAgC;IAEhC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,+BAA+B,CAAC,KAIxC;IACC,OAAO;QACL,SAAS,EAAE,IAAa;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,mBAAmB;YAC3B,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAa,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,OAAgC,EAChC,QAAiC;IAEjC,OAAO,CACL,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE;QAC1B,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;QAC1C,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;QAC5C,iBAAiB,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC;QACpE,iBAAiB,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC;QACtE,iBAAiB,CACf,OAAO,CAAC,kBAAkB,EAC1B,QAAQ,CAAC,kBAAkB,CAC5B;QACD,iBAAiB,CACf,OAAO,CAAC,sBAAsB,EAC9B,QAAQ,CAAC,sBAAsB,CAChC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAgC,EAChC,QAAiC;IAEjC,OAAO,CACL,4BAA4B,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/C,iBAAiB,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC;QAChE,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,eAAe;QACpD,OAAO,CAAC,kBAAkB,KAAK,QAAQ,CAAC,kBAAkB;QAC1D,kCAAkC,CAChC,OAAO,CAAC,gBAAgB,EACxB,QAAQ,CAAC,gBAAgB,CAC1B;QACD,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC;YAC/C,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CACrD,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAAwB,EACxB,QAAyB;IAEzB,OAAO,CACL,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE;QAC1B,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QACtC,OAAO,CAAC,cAAc,KAAK,QAAQ,CAAC,cAAc;QAClD,OAAO,CAAC,kBAAkB,KAAK,QAAQ,CAAC,kBAAkB;QAC1D,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,CAAC;QAC9D,CAAC,OAAO,CAAC,oBAAoB,IAAI,IAAI,CAAC;YACpC,CAAC,QAAQ,CAAC,oBAAoB,IAAI,IAAI,CAAC;QACzC,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI,CAAC;QACtE,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,IAAI,IAAI,CAAC;QACxE,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,IAAI,IAAI,CAAC;QACxE,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;QAC9B,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,CACnD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,OAEI,EACJ,WAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAChE,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO;QACL,SAAS;QACT,MAAM,EAAE,MAAM,6BAA6B,CAAC,OAAO,EAAE,WAAW,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,EAAgC,EAChC,WAAmB,EACnB,GAAsB;IAEtB,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACnC,MAAM,EAAE;SACL,MAAM,CAAC,sBAAsB,CAAC;SAC9B,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,2BAA2B,CAAC,EAC/D,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,WAAW,CAAC,EAC/C,OAAO,CAAC,sBAAsB,CAAC,EAAE,EAAE,SAAS,CAAC,CAC9C,CACF;SACA,GAAG,EAAE,CAAC;AACX,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,EAAgC,EAChC,WAAmB;IAEnB,MAAM,EAAE;SACL,MAAM,CAAC,oBAAoB,CAAC;SAC5B,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,CAAC,EAC7D,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAC9C,CACF;SACA,GAAG,EAAE,CAAC;AACX,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,EAAgC,EAChC,WAAmB;IAEnB,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,MAAM,CAAC,EAAE,EAAE,EAAE,sBAAsB,CAAC,EAAE,EAAE,CAAC;SACzC,IAAI,CAAC,sBAAsB,CAAC;SAC5B,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,2BAA2B,CAAC,EAC/D,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,WAAW,CAAC,CAChD,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,EAAgC,EAChC,WAAmB;IAEnB,MAAM,cAAc,GAAG,MAAM,EAAE;SAC5B,MAAM,CAAC,EAAE,EAAE,EAAE,sBAAsB,CAAC,EAAE,EAAE,CAAC;SACzC,IAAI,CAAC,sBAAsB,CAAC;SAC5B,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,EACnD,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,CAAC,CACjD,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,aAAa,GAAG,MAAM,EAAE;SAC3B,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,CAAC,EAAE,EAAE,CAAC;SACvC,IAAI,CAAC,oBAAoB,CAAC;SAC1B,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;SACxD,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,OAEI,EACJ,WAAmB,EACnB,aAA8C;IAE9C,IAAI,CAAC,aAAa;QAAE,OAAO;IAC3B,MAAM,4BAA4B,CAChC,OAAO,EACP,yBAAyB,CAAC,WAAW,CAAC,EACtC,aAAa,CACd,CAAC;AACJ,CAAC;AAMD,SAAS,yBAAyB,CAChC,YAAyC,EACzC,KAAkC;IAElC,MAAM,uBAAuB,GAC3B,KAAK,CAAC,WAAW,EAAE,gBAAgB,EAAE,SAAS,CAAC;IACjD,MAAM,0BAA0B,GAC9B,uBAAuB,IAAI,IAAI;QAC/B,YAAY,EAAE,SAAS,CAAC,eAAe,IAAI,IAAI;QAC/C,YAAY,CAAC,SAAS,CAAC,eAAe,GAAG,uBAAuB,CAAC;IACnE,MAAM,2BAA2B,GAC/B,YAAY,EAAE,MAAM,IAAI,IAAI;QAC5B,YAAY,CAAC,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,MAAM,CAAC,UAAU;QAC1D,YAAY,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;IAC7D,OAAO,YAAY,EAAE,MAAM;QACzB,CAAC,0BAA0B,IAAI,2BAA2B,CAAC;QAC3D,CAAC,CAAC;YACE,SAAS,EAAE,KAAc;YACzB,YAAY;YACZ,gBAAgB,EAAE,IAAa;SAChC;QACH,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,4BAA4B,CACnC,YAAyC,EACzC,KAAkC;IAIlC,OAAO,OAAO,CACZ,YAAY,EAAE,MAAM;QAClB,mBAAmB,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,iBAAiB,CAAC;QACpE,kBAAkB,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,KAI7C;IACC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC;IAC7C,IACE,YAAY,EAAE,MAAM;QACpB,QAAQ,CAAC,+BAA+B;QACxC,4BAA4B,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC1E,CAAC;QACD,MAAM,4BAA4B,CAChC,EAAE,EACF,QAAQ,CAAC,SAAS,CAAC,EAAE,EACrB,QAAQ,CAAC,wBAAwB,CAClC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAc,EAAE,YAAY,EAAE,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,6BAA6B,CAAC,KAI5C;IACC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,uBAAuB,GAC3B,QAAQ,CAAC,WAAW,EAAE,cAAc;QACpC,QAAQ,CAAC,WAAW,EAAE,SAAS;QAC/B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3B,MAAM,wBAAwB,GAC5B,QAAQ,CAAC,mCAAmC,KAAK,IAAI;QACrD,CAAC,MAAM,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,yEAAyE;IACzE,wEAAwE;IACxE,MAAM,cAAc,GAClB,wBAAwB,IAAI,QAAQ,CAAC,+BAA+B;QAClE,CAAC,CAAC,CAAC,gBAAgB,CAAC,cAAc,IAAI,uBAAuB,CAAC;QAC9D,CAAC,CAAC,uBAAuB,CAAC;IAC9B,MAAM,4BAA4B,GAAG,wBAAwB;QAC3D,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE;QAChE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IACvB,MAAM,iBAAiB,GACrB,QAAQ,CAAC,wBAAwB,CAAC,MAAM,GAAG,CAAC;QAC5C,CAAC,CAAC,MAAM,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,MAAM,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,sEAAsE;IACtE,2EAA2E;IAC3E,mEAAmE;IACnE,OAAO;QACL,SAAS,EAAE,4BAA4B;QACvC,cAAc,EAAE,iBAAiB;YAC/B,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAAe,IAAI,cAAc,CAAC;YACtD,CAAC,CAAC,cAAc;KACnB,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,SAAS,8BAA8B,CACrC,YAAwE,EACxE,KAAkC;IAElC,MAAM,iBAAiB,GACrB,KAAK,CAAC,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,MAAM,CAAC,UAAU;QACxD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,0BAA0B,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE;QAC7D,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc;QAC9C,mBAAmB,EAAE;YACnB,KAAK,CAAC,SAAS,CAAC,kBAAkB;YAClC,GAAG,iBAAiB;SACrB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAEI,EACJ,KAA4E;IAE5E,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC/D,MAAM,OAAO,GAAG,MAAM,iCAAiC,CACrD,aAAa,CACd,CAAC,kBAAkB,CAClB,KAAK,EAAE,EAAE,EAAE,EAAE;YACX,MAAM,YAAY,GAAG,MAAM,wBAAwB,CACjD,aAAa,EACb,KAAK,CAAC,SAAS,CAAC,EAAE,CACnB,CAAC;YACF,MAAM,iBAAiB,GAAG,yBAAyB,CACjD,YAAY,EACZ,KAAK,CACN,CAAC;YACF,IAAI,iBAAiB;gBAAE,OAAO,iBAAiB,CAAC;YAChD,IAAI,CAAC,4BAA4B,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;gBACvD,OAAO,8BAA8B,CAAC;oBACpC,YAAY;oBACZ,QAAQ,EAAE,KAAK;oBACf,EAAE;iBACH,CAAC,CAAC;YACL,CAAC;YACD,8BAA8B,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAEpD,MAAM,oBAAoB,CACxB,aAAa,EACb,KAAK,CAAC,SAAS,CAAC,EAAE,EAClB,KAAK,CAAC,aAAa,CACpB,CAAC;YACF,MAAM,4BAA4B,CAChC,EAAE,EACF,KAAK,CAAC,SAAS,CAAC,EAAE,EAClB,KAAK,CAAC,wBAAwB,CAC/B,CAAC;YACF,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBAC3B,MAAM,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GACjC,MAAM,6BAA6B,CAAC;gBAClC,gBAAgB,EAAE,YAAY,CAAC,SAAS;gBACxC,QAAQ,EAAE,KAAK;gBACf,EAAE;aACH,CAAC,CAAC;YACL,MAAM,cAAc,GAAG,MAAM,kCAAkC,CAAC;gBAC9D,SAAS;gBACT,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE,YAAY;gBAC7C,cAAc;gBACd,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU;gBACzC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,gBAAgB,EAAE,KAAK,CAAC,WAAW,EAAE,gBAAgB;gBACrD,EAAE;aACH,CAAC,CAAC;YACH,IACE,KAAK,CAAC,sBAAsB;gBAC5B,CAAC,MAAM,mCAAmC,CAAC;oBACzC,GAAG,KAAK,CAAC,sBAAsB;oBAC/B,EAAE;iBACH,CAAC,CAAC,KAAK,YAAY,EACpB,CAAC;gBACD,MAAM,IAAI,oCAAoC,EAAE,CAAC;YACnD,CAAC;YACD,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBAC/B,IACE,CAAC,CAAC,MAAM,iCAAiC,CAAC;oBACxC,GAAG,KAAK,CAAC,oBAAoB;oBAC7B,EAAE;iBACH,CAAC,CAAC,EACH,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,+BAA+B,CAAC;gBACrC,SAAS,EAAE,cAAc;gBACzB,mBAAmB,EAAE,KAAK,CAAC,sBAAsB,KAAK,SAAS;gBAC/D,iBAAiB,EAAE,KAAK,CAAC,oBAAoB,KAAK,SAAS;aAC5D,CAAC,CAAC;QACL,CAAC,EACD,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,EAAE,EACjD,EAAE,QAAQ,EAAE,WAAW,EAAE,CAC1B,CAAC;QACF,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAc;YACzB,YAAY,EAAE,MAAM,wBAAwB,CAC1C,aAAa,EACb,KAAK,CAAC,SAAS,CAAC,EAAE,CACnB;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,OAEI,EACJ,KAEI;IAEJ,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC/D,MAAM,OAAO,GAAG,MAAM,iCAAiC,CACrD,aAAa,CACd,CAAC,kBAAkB,CAClB,KAAK,EAAE,EAAE,EAAE,EAAE;YACX,MAAM,YAAY,GAAG,MAAM,wBAAwB,CACjD,aAAa,EACb,KAAK,CAAC,WAAW,CAClB,CAAC;YACF,IACE,YAAY,EAAE,MAAM;gBACpB,4BAA4B,CAC1B,YAAY,CAAC,MAAM,EACnB,KAAK,CAAC,cAAc,CACrB,EACD,CAAC;gBACD,MAAM,4BAA4B,CAChC,EAAE,EACF,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,gBAAgB,CACvB,CAAC;YACJ,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC,EACD,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,EAAE,EACjD,EAAE,QAAQ,EAAE,WAAW,EAAE,CAC1B,CAAC;QACF,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { and, eq, inArray } from \"drizzle-orm\";\nimport {\n  assertHeldContainerBinding,\n  heldContainerBinding,\n} from \"../../containers/containerBinding\";\nimport { documentSyncPullContinuationsEqual } from \"../../documents/shared/pullContinuation\";\nimport {\n  enqueueDocumentPendingUpdate,\n  type PendingUpdateFields,\n} from \"../../sqlite/documentPersistence\";\nimport {\n  containerCreateIntents,\n  containerMoveIntents,\n  documentPendingUpdates,\n  documentSyncFailures,\n} from \"../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { runSerializedSqlMutation } from \"../../sqlite/sqlSchema\";\nimport {\n  type ContainerRecord,\n  loadContainerById,\n} from \"../containers/containerPersistence\";\nimport type {\n  ContainerContentsPersistence,\n  ContainerMetadataRecord,\n  StoredContainerState,\n} from \"./containerContentsPersistenceTypes\";\nimport { settleContainerCreateIntentRevision } from \"./containerCreateIntentSettlement\";\nimport {\n  ContainerCreateIntentSupersededError,\n  deleteContainerMoveIntentRevision,\n} from \"./containerIntentPersistence\";\nimport {\n  getContainerMetadataScope,\n  saveContainerContentsContainerRows,\n  selectContainerMetadataRecord,\n} from \"./containerMetadataRows\";\nimport { CONTAINER_METADATA_APP_KIND } from \"./dormantContainerMetadata\";\n\nfunction sameNullableValue(\n  left: string | null | undefined,\n  right: string | null | undefined,\n): boolean {\n  return (left ?? null) === (right ?? null);\n}\n\nfunction committedMetadataMutationResult(input: {\n  container: ContainerRecord;\n  createIntentSettled: boolean;\n  moveIntentSettled: boolean;\n}) {\n  return {\n    committed: true as const,\n    container: input.container,\n    ...(input.createIntentSettled\n      ? { createIntentSettled: true as const }\n      : {}),\n    ...(input.moveIntentSettled ? { moveIntentSettled: true as const } : {}),\n  };\n}\n\nfunction sameMetadataSecurityIdentity(\n  current: ContainerMetadataRecord,\n  expected: ContainerMetadataRecord,\n): boolean {\n  return (\n    current.id === expected.id &&\n    current.documentId === expected.documentId &&\n    current.accessEpoch === expected.accessEpoch &&\n    sameNullableValue(current.accessStateHash, expected.accessStateHash) &&\n    sameNullableValue(current.contentKeyBundle, expected.contentKeyBundle) &&\n    sameNullableValue(\n      current.documentKekTargets,\n      expected.documentKekTargets,\n    ) &&\n    sameNullableValue(\n      current.documentManifestBundle,\n      expected.documentManifestBundle,\n    )\n  );\n}\n\nfunction sameMetadataRecord(\n  current: ContainerMetadataRecord,\n  expected: ContainerMetadataRecord,\n): boolean {\n  return (\n    sameMetadataSecurityIdentity(current, expected) &&\n    sameNullableValue(current.lastCommitLsn, expected.lastCommitLsn) &&\n    current.metadataUpdates === expected.metadataUpdates &&\n    current.snapshotEndVersion === expected.snapshotEndVersion &&\n    documentSyncPullContinuationsEqual(\n      current.pullContinuation,\n      expected.pullContinuation,\n    ) &&\n    Boolean(current.pullContinuationRecoveryRequired) ===\n      Boolean(expected.pullContinuationRecoveryRequired)\n  );\n}\n\nfunction sameContainerRecord(\n  current: ContainerRecord,\n  expected: ContainerRecord,\n): boolean {\n  return (\n    current.id === expected.id &&\n    current.parentId === expected.parentId &&\n    current.organizationId === expected.organizationId &&\n    current.metadataDocumentId === expected.metadataDocumentId &&\n    (current.systemSlot ?? null) === (expected.systemSlot ?? null) &&\n    (current.effectiveAccessLevel ?? null) ===\n      (expected.effectiveAccessLevel ?? null) &&\n    (current.localUpdatedAt ?? null) === (expected.localUpdatedAt ?? null) &&\n    (current.serverCreatedAt ?? null) === (expected.serverCreatedAt ?? null) &&\n    (current.serverUpdatedAt ?? null) === (expected.serverUpdatedAt ?? null) &&\n    current.name === expected.name &&\n    (current.icon ?? null) === (expected.icon ?? null)\n  );\n}\n\nasync function loadStoredContainerState(\n  execSql: Parameters<\n    ContainerContentsPersistence[\"loadContainerMetadataState\"]\n  >[0],\n  containerId: string,\n): Promise<StoredContainerState | null> {\n  const container = await loadContainerById(execSql, containerId);\n  if (!container) return null;\n  return {\n    container,\n    record: await selectContainerMetadataRecord(execSql, containerId),\n  };\n}\n\nasync function deleteAcceptedPendingUpdates(\n  tx: ClientSQLiteTransactionScope,\n  containerId: string,\n  ids: readonly string[],\n): Promise<void> {\n  const uniqueIds = [...new Set(ids)];\n  if (uniqueIds.length === 0) return;\n  await tx\n    .delete(documentPendingUpdates)\n    .where(\n      and(\n        eq(documentPendingUpdates.appKind, CONTAINER_METADATA_APP_KIND),\n        eq(documentPendingUpdates.localId, containerId),\n        inArray(documentPendingUpdates.id, uniqueIds),\n      ),\n    )\n    .run();\n}\n\nasync function clearSyncFailure(\n  tx: ClientSQLiteTransactionScope,\n  containerId: string,\n): Promise<void> {\n  await tx\n    .delete(documentSyncFailures)\n    .where(\n      and(\n        eq(documentSyncFailures.appKind, CONTAINER_METADATA_APP_KIND),\n        eq(documentSyncFailures.localId, containerId),\n      ),\n    )\n    .run();\n}\n\nasync function hasPendingUpdates(\n  tx: ClientSQLiteTransactionScope,\n  containerId: string,\n): Promise<boolean> {\n  const rows = await tx\n    .select({ id: documentPendingUpdates.id })\n    .from(documentPendingUpdates)\n    .where(\n      and(\n        eq(documentPendingUpdates.appKind, CONTAINER_METADATA_APP_KIND),\n        eq(documentPendingUpdates.localId, containerId),\n      ),\n    )\n    .limit(1);\n  return rows.length > 0;\n}\n\nasync function hasPendingStructuralIntent(\n  tx: ClientSQLiteTransactionScope,\n  containerId: string,\n): Promise<boolean> {\n  const pendingCreates = await tx\n    .select({ id: containerCreateIntents.id })\n    .from(containerCreateIntents)\n    .where(\n      and(\n        eq(containerCreateIntents.containerId, containerId),\n        eq(containerCreateIntents.syncStatus, \"pending\"),\n      ),\n    )\n    .limit(1);\n  if (pendingCreates.length > 0) return true;\n\n  const unsyncedMoves = await tx\n    .select({ id: containerMoveIntents.id })\n    .from(containerMoveIntents)\n    .where(eq(containerMoveIntents.containerId, containerId))\n    .limit(1);\n  return unsyncedMoves.length > 0;\n}\n\nasync function enqueuePendingUpdate(\n  execSql: Parameters<\n    ContainerContentsPersistence[\"commitMetadataMutation\"]\n  >[0],\n  containerId: string,\n  pendingUpdate: PendingUpdateFields | undefined,\n): Promise<void> {\n  if (!pendingUpdate) return;\n  await enqueueDocumentPendingUpdate(\n    execSql,\n    getContainerMetadataScope(containerId),\n    pendingUpdate,\n  );\n}\n\ntype CommitMetadataMutationInput = Parameters<\n  ContainerContentsPersistence[\"commitMetadataMutation\"]\n>[1];\n\nfunction staleServerMutationResult(\n  currentState: StoredContainerState | null,\n  input: CommitMetadataMutationInput,\n) {\n  const incomingServerUpdatedAt =\n    input.saveOptions?.serverTimestamps?.updatedAt;\n  const hasOlderContainerTimestamp =\n    incomingServerUpdatedAt != null &&\n    currentState?.container.serverUpdatedAt != null &&\n    currentState.container.serverUpdatedAt > incomingServerUpdatedAt;\n  const hasOlderMetadataAccessEpoch =\n    currentState?.record != null &&\n    currentState.record.documentId === input.record.documentId &&\n    currentState.record.accessEpoch > input.record.accessEpoch;\n  return currentState?.record &&\n    (hasOlderContainerTimestamp || hasOlderMetadataAccessEpoch)\n    ? {\n        committed: false as const,\n        currentState,\n        staleServerState: true as const,\n      }\n    : null;\n}\n\nfunction metadataMutationStateMatches(\n  currentState: StoredContainerState | null,\n  input: CommitMetadataMutationInput,\n): currentState is StoredContainerState & {\n  record: ContainerMetadataRecord;\n} {\n  return Boolean(\n    currentState?.record &&\n      sameContainerRecord(currentState.container, input.expectedContainer) &&\n      sameMetadataRecord(currentState.record, input.expectedRecord),\n  );\n}\n\nasync function rejectMetadataMutationConflict(input: {\n  currentState: StoredContainerState | null;\n  mutation: CommitMetadataMutationInput;\n  tx: ClientSQLiteTransactionScope;\n}) {\n  const { currentState, mutation, tx } = input;\n  if (\n    currentState?.record &&\n    mutation.settleAcceptedPendingOnConflict &&\n    sameMetadataSecurityIdentity(currentState.record, mutation.expectedRecord)\n  ) {\n    await deleteAcceptedPendingUpdates(\n      tx,\n      mutation.container.id,\n      mutation.acceptedPendingUpdateIds,\n    );\n  }\n  return { committed: false as const, currentState };\n}\n\nasync function prepareContainerMutationWrite(input: {\n  currentContainer: ContainerRecord;\n  mutation: CommitMetadataMutationInput;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<{ container: ContainerRecord; localUpdatedAt: string }> {\n  const { currentContainer, mutation, tx } = input;\n  const requestedLocalUpdatedAt =\n    mutation.saveOptions?.localUpdatedAt ??\n    mutation.saveOptions?.updatedAt ??\n    new Date().toISOString();\n  const preserveDurableStructure =\n    mutation.preserveDurableStructureWhenPending === true &&\n    (await hasPendingStructuralIntent(tx, mutation.container.id));\n  // Syncing metadata is not a local edit. Preserve the durable edit clock,\n  // including an edit another pane made while this request was in flight.\n  const localUpdatedAt =\n    preserveDurableStructure || mutation.settleAcceptedPendingOnConflict\n      ? (currentContainer.localUpdatedAt ?? requestedLocalUpdatedAt)\n      : requestedLocalUpdatedAt;\n  const structurallyRebasedContainer = preserveDurableStructure\n    ? { ...mutation.container, parentId: currentContainer.parentId }\n    : mutation.container;\n  const didSettleOutgoing =\n    mutation.acceptedPendingUpdateIds.length > 0 &&\n    !(await hasPendingUpdates(tx, mutation.container.id)) &&\n    !(await hasPendingStructuralIntent(tx, mutation.container.id));\n  // Only container responses establish the server's structural clock. A\n  // metadata acknowledgement supplies no such timestamp; marking it with our\n  // wall clock would make later valid listings appear stale forever.\n  return {\n    container: structurallyRebasedContainer,\n    localUpdatedAt: didSettleOutgoing\n      ? (currentContainer.serverUpdatedAt ?? localUpdatedAt)\n      : localUpdatedAt,\n  };\n}\n\n/** Server acknowledgements and listings cannot rebind a held folder. */\nfunction assertMutationKeepsHeldBinding(\n  currentState: StoredContainerState & { record: ContainerMetadataRecord },\n  input: CommitMetadataMutationInput,\n): void {\n  const recordDocumentIds =\n    input.record.documentId === currentState.record.documentId\n      ? []\n      : [input.record.documentId];\n  assertHeldContainerBinding(heldContainerBinding(currentState), {\n    organizationId: input.container.organizationId,\n    metadataDocumentIds: [\n      input.container.metadataDocumentId,\n      ...recordDocumentIds,\n    ],\n  });\n}\n\nexport async function commitStoredMetadataMutation(\n  execSql: Parameters<\n    ContainerContentsPersistence[\"commitMetadataMutation\"]\n  >[0],\n  input: Parameters<ContainerContentsPersistence[\"commitMetadataMutation\"]>[1],\n) {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    const outcome = await getClientSQLitePersistenceRuntime(\n      lockedExecSql,\n    ).guardedTransaction(\n      async (tx) => {\n        const currentState = await loadStoredContainerState(\n          lockedExecSql,\n          input.container.id,\n        );\n        const staleServerResult = staleServerMutationResult(\n          currentState,\n          input,\n        );\n        if (staleServerResult) return staleServerResult;\n        if (!metadataMutationStateMatches(currentState, input)) {\n          return rejectMetadataMutationConflict({\n            currentState,\n            mutation: input,\n            tx,\n          });\n        }\n        assertMutationKeepsHeldBinding(currentState, input);\n\n        await enqueuePendingUpdate(\n          lockedExecSql,\n          input.container.id,\n          input.pendingUpdate,\n        );\n        await deleteAcceptedPendingUpdates(\n          tx,\n          input.container.id,\n          input.acceptedPendingUpdateIds,\n        );\n        if (input.clearSyncFailure) {\n          await clearSyncFailure(tx, input.container.id);\n        }\n        const { container, localUpdatedAt } =\n          await prepareContainerMutationWrite({\n            currentContainer: currentState.container,\n            mutation: input,\n            tx,\n          });\n        const savedContainer = await saveContainerContentsContainerRows({\n          container,\n          createIntent: input.saveOptions?.createIntent,\n          localUpdatedAt,\n          moveIntent: input.saveOptions?.moveIntent,\n          record: input.record,\n          serverTimestamps: input.saveOptions?.serverTimestamps,\n          tx,\n        });\n        if (\n          input.createIntentSettlement &&\n          (await settleContainerCreateIntentRevision({\n            ...input.createIntentSettlement,\n            tx,\n          })) === \"superseded\"\n        ) {\n          throw new ContainerCreateIntentSupersededError();\n        }\n        if (input.moveIntentSettlement) {\n          if (\n            !(await deleteContainerMoveIntentRevision({\n              ...input.moveIntentSettlement,\n              tx,\n            }))\n          ) {\n            throw new Error(\n              \"Container move intent was superseded before local settlement\",\n            );\n          }\n        }\n        return committedMetadataMutationResult({\n          container: savedContainer,\n          createIntentSettled: input.createIntentSettlement !== undefined,\n          moveIntentSettled: input.moveIntentSettlement !== undefined,\n        });\n      },\n      () => !input.stillCurrent || input.stillCurrent(),\n      { behavior: \"immediate\" },\n    );\n    if (outcome.committed && outcome.result) {\n      return outcome.result;\n    }\n    return {\n      committed: false as const,\n      currentState: await loadStoredContainerState(\n        lockedExecSql,\n        input.container.id,\n      ),\n    };\n  });\n}\n\nexport async function settleStoredMetadataPendingUpdates(\n  execSql: Parameters<\n    ContainerContentsPersistence[\"settleAcceptedMetadataPendingUpdates\"]\n  >[0],\n  input: Parameters<\n    ContainerContentsPersistence[\"settleAcceptedMetadataPendingUpdates\"]\n  >[1],\n) {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    const outcome = await getClientSQLitePersistenceRuntime(\n      lockedExecSql,\n    ).guardedTransaction(\n      async (tx) => {\n        const currentState = await loadStoredContainerState(\n          lockedExecSql,\n          input.containerId,\n        );\n        if (\n          currentState?.record &&\n          sameMetadataSecurityIdentity(\n            currentState.record,\n            input.expectedRecord,\n          )\n        ) {\n          await deleteAcceptedPendingUpdates(\n            tx,\n            input.containerId,\n            input.pendingUpdateIds,\n          );\n        }\n        return currentState;\n      },\n      () => !input.stillCurrent || input.stillCurrent(),\n      { behavior: \"immediate\" },\n    );\n    return outcome.committed ? outcome.result : null;\n  });\n}\n"]}

package/data/persistence/container-contents/containerMetadataPullContinuationPersistence.js

@@ -0,0 +1,32 @@
+import { invalidateDocumentSyncPullContinuation } from "../../sqlite/documentPersistence.js";
+import { getClientSQLitePersistenceRuntime } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { runSerializedSqlMutation } from "../../sqlite/sqlSchema.js";
+import { selectContainerMetadataRecord } from "./containerMetadataRows.js";
+import { CONTAINER_METADATA_APP_KIND } from "./dormantContainerMetadata.js";
+export const containerMetadataPullContinuationPersistence = {
+    async invalidateMetadataPullContinuation(execSql, input) {
+        return runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+            const runtime = getClientSQLitePersistenceRuntime(lockedExecSql);
+            const invalidate = async () => {
+                await invalidateDocumentSyncPullContinuation(lockedExecSql, {
+                    accessEpoch: input.accessEpoch,
+                    accessStateHash: input.accessStateHash,
+                    appKind: CONTAINER_METADATA_APP_KIND,
+                    continuation: input.continuation,
+                    contentKeyBundle: input.contentKeyBundle,
+                    documentId: input.documentId,
+                    documentKekTargets: input.documentKekTargets,
+                    documentManifestBundle: input.documentManifestBundle,
+                    lastCommitLsn: input.lastCommitLsn,
+                    localId: input.containerId,
+                });
+                return selectContainerMetadataRecord(lockedExecSql, input.containerId);
+            };
+            if (!input.stillCurrent)
+                return runtime.transaction(invalidate);
+            const outcome = await runtime.guardedTransaction(invalidate, input.stillCurrent);
+            return outcome.result;
+        });
+    },
+};
+//# sourceMappingURL=containerMetadataPullContinuationPersistence.js.map

package/data/persistence/container-contents/containerMetadataPullContinuationPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerMetadataPullContinuationPersistence.js","sourceRoot":"","sources":["containerMetadataPullContinuationPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,iCAAiC,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAOzE,MAAM,CAAC,MAAM,4CAA4C,GACvD;IACE,KAAK,CAAC,kCAAkC,CAAC,OAAO,EAAE,KAAK;QACrD,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAC/D,MAAM,OAAO,GAAG,iCAAiC,CAAC,aAAa,CAAC,CAAC;YACjE,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;gBAC5B,MAAM,sCAAsC,CAAC,aAAa,EAAE;oBAC1D,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;oBACtC,OAAO,EAAE,2BAA2B;oBACpC,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;oBACxC,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;oBAC5C,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;oBACpD,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,OAAO,EAAE,KAAK,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH,OAAO,6BAA6B,CAClC,aAAa,EACb,KAAK,CAAC,WAAW,CAClB,CAAC;YACJ,CAAC,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,YAAY;gBAAE,OAAO,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAC9C,UAAU,EACV,KAAK,CAAC,YAAY,CACnB,CAAC;YACF,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC","sourcesContent":["import { invalidateDocumentSyncPullContinuation } from \"../../sqlite/documentPersistence\";\nimport { getClientSQLitePersistenceRuntime } from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { runSerializedSqlMutation } from \"../../sqlite/sqlSchema\";\nimport type { ContainerContentsPersistence } from \"./containerContentsPersistenceTypes\";\nimport { selectContainerMetadataRecord } from \"./containerMetadataRows\";\nimport { CONTAINER_METADATA_APP_KIND } from \"./dormantContainerMetadata\";\n\ntype MetadataPullContinuationPersistence = Pick<\n  ContainerContentsPersistence,\n  \"invalidateMetadataPullContinuation\"\n>;\n\nexport const containerMetadataPullContinuationPersistence: MetadataPullContinuationPersistence =\n  {\n    async invalidateMetadataPullContinuation(execSql, input) {\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n        const runtime = getClientSQLitePersistenceRuntime(lockedExecSql);\n        const invalidate = async () => {\n          await invalidateDocumentSyncPullContinuation(lockedExecSql, {\n            accessEpoch: input.accessEpoch,\n            accessStateHash: input.accessStateHash,\n            appKind: CONTAINER_METADATA_APP_KIND,\n            continuation: input.continuation,\n            contentKeyBundle: input.contentKeyBundle,\n            documentId: input.documentId,\n            documentKekTargets: input.documentKekTargets,\n            documentManifestBundle: input.documentManifestBundle,\n            lastCommitLsn: input.lastCommitLsn,\n            localId: input.containerId,\n          });\n          return selectContainerMetadataRecord(\n            lockedExecSql,\n            input.containerId,\n          );\n        };\n        if (!input.stillCurrent) return runtime.transaction(invalidate);\n        const outcome = await runtime.guardedTransaction(\n          invalidate,\n          input.stillCurrent,\n        );\n        return outcome.result;\n      });\n    },\n  };\n"]}