@tearleads/client-sdk 0.1.61 → 0.1.63

package/workflows/container-contents/metadata/metadataMutationPreparation.js

@@ -0,0 +1,177 @@
+import { base64ToBytes } from "../../../internal/encoding/index.js";
+import { encodeVersionVector, exportUpdatesSince, importUpdates, } from "../../../internal/loro/index.js";
+import { getDefaultContainerName, readContainerMetadataValue, writeContainerMetadataValue, } from "../../../data/containers/containerMetadataDocument.js";
+import { documentSyncPullContinuationsEqual } from "../../../data/documents/shared/syncPagination.js";
+import { canWriteEffectiveAccessLevel } from "../../../data/keying/accessLevel.js";
+import { metadataSyncSecurityContextMatches, replaceSupersededMetadataIdentity, sameNullableMetadataValue, } from "./metadataSyncSettlement.js";
+export function currentMetadataPullContinuation(metadataState) {
+    return Object.hasOwn(metadataState, "pullContinuation")
+        ? (metadataState.pullContinuation ?? null)
+        : (metadataState.record.pullContinuation ?? null);
+}
+export function resolveMetadataSecurityContext(metadataState, patch) {
+    const currentDocumentId = metadataState.record.documentId ?? null;
+    const documentId = patch.documentId !== undefined ? patch.documentId : currentDocumentId;
+    const accessEpoch = patch.accessEpoch ?? metadataState.record.accessEpoch;
+    const documentIdChanged = documentId !== currentDocumentId;
+    return {
+        accessEpoch,
+        changed: documentIdChanged || accessEpoch !== metadataState.record.accessEpoch,
+        documentId,
+        documentIdChanged,
+    };
+}
+function mergeDurableMetadataCheckpoint(input) {
+    const { durableRecord, metadataState, securityContext } = input;
+    if (!durableRecord?.metadataUpdates ||
+        durableRecord.documentId !== metadataState.record.documentId ||
+        durableRecord.documentId !== securityContext.documentId ||
+        durableRecord.accessEpoch !== metadataState.record.accessEpoch ||
+        durableRecord.accessEpoch !== securityContext.accessEpoch) {
+        return;
+    }
+    importUpdates(metadataState.doc, [
+        base64ToBytes(durableRecord.metadataUpdates),
+    ]);
+}
+export async function loadAuthoritativeContainerMetadataState(input) {
+    const stored = await input.persistence.loadContainerMetadataState(input.execSql, input.containerId);
+    return stored?.record
+        ? { container: stored.container, record: stored.record }
+        : null;
+}
+function localMetadataWriteAccessWasRevoked(input) {
+    return (input.mutationInput.expectedSyncState === undefined &&
+        input.mutationInput.localUpdate !== undefined &&
+        canWriteEffectiveAccessLevel(input.mutationInput.metadataState.container.effectiveAccessLevel) &&
+        !canWriteEffectiveAccessLevel(input.authoritativeState.container.effectiveAccessLevel));
+}
+async function prepareRebasedLocalMetadataMutation(input) {
+    const { authoritativeState, metadataState, patch } = input;
+    const replacementVersion = encodeVersionVector(metadataState.doc);
+    const replacementMetadata = readContainerMetadataValue(metadataState.doc, getDefaultContainerName(authoritativeState.container.parentId));
+    writeContainerMetadataValue(metadataState.doc, {
+        ...replacementMetadata,
+        ...input.localMetadataPatch,
+    });
+    const rebasedMetadataState = {
+        ...metadataState,
+        container: authoritativeState.container,
+        pullContinuation: authoritativeState.record.pullContinuation ?? null,
+        record: authoritativeState.record,
+    };
+    return {
+        durableRecord: authoritativeState.record,
+        mutationContainer: authoritativeState.container,
+        mutationMetadataState: rebasedMetadataState,
+        mutationPatch: patch,
+        pendingLocalUpdate: exportUpdatesSince(metadataState.doc, replacementVersion),
+        pullContinuationSuperseded: false,
+        securityContext: resolveMetadataSecurityContext(rebasedMetadataState, patch),
+        securityContextMatches: true,
+    };
+}
+function resolveMetadataSettlementMatch(expectedSyncState, durableRecord) {
+    if (!expectedSyncState) {
+        return {
+            contentStateSuperseded: false,
+            pullContinuationSuperseded: false,
+            securityContextMatches: true,
+        };
+    }
+    const securityContextMatches = metadataSyncSecurityContextMatches(durableRecord, expectedSyncState.record);
+    const progressStateMatches = securityContextMatches &&
+        sameNullableMetadataValue(durableRecord?.lastCommitLsn, expectedSyncState.record.lastCommitLsn) &&
+        Boolean(durableRecord?.pullContinuationRecoveryRequired) ===
+            Boolean(expectedSyncState.record.pullContinuationRecoveryRequired) &&
+        documentSyncPullContinuationsEqual(durableRecord?.pullContinuation, expectedSyncState.pullContinuation);
+    const contentStateMatches = progressStateMatches &&
+        sameNullableMetadataValue(durableRecord?.metadataUpdates, expectedSyncState.record.metadataUpdates) &&
+        sameNullableMetadataValue(durableRecord?.snapshotEndVersion, expectedSyncState.record.snapshotEndVersion);
+    return {
+        contentStateSuperseded: progressStateMatches && !contentStateMatches,
+        pullContinuationSuperseded: !progressStateMatches,
+        securityContextMatches,
+    };
+}
+export async function prepareContainerMetadataMutation(input, execSql, patch) {
+    const { metadataState, persistence } = input;
+    const authoritativeState = await loadAuthoritativeContainerMetadataState({
+        containerId: metadataState.container.id,
+        execSql,
+        persistence,
+    });
+    if (!authoritativeState) {
+        return {
+            authoritativeState: null,
+            pullContinuationSuperseded: true,
+            securityContextMatches: false,
+        };
+    }
+    if (localMetadataWriteAccessWasRevoked({
+        authoritativeState,
+        mutationInput: input,
+    })) {
+        await replaceSupersededMetadataIdentity({
+            durableRecord: authoritativeState.record,
+            metadataState,
+        });
+        return {
+            authoritativeState,
+            pullContinuationSuperseded: true,
+            securityContextMatches: false,
+        };
+    }
+    const durableRecord = authoritativeState.record;
+    const mutationMetadataState = durableRecord
+        ? {
+            ...metadataState,
+            pullContinuation: durableRecord.pullContinuation ?? null,
+            record: durableRecord,
+        }
+        : metadataState;
+    const capturedSecurityContextMatches = durableRecord !== null &&
+        metadataSyncSecurityContextMatches(durableRecord, metadataState.record);
+    const { contentStateSuperseded, pullContinuationSuperseded, securityContextMatches, } = resolveMetadataSettlementMatch(input.expectedSyncState, durableRecord);
+    if (input.expectedSyncState === undefined &&
+        !capturedSecurityContextMatches) {
+        await replaceSupersededMetadataIdentity({
+            durableRecord: authoritativeState.record,
+            metadataState,
+        });
+        if (input.localUpdate === undefined) {
+            return {
+                authoritativeState,
+                pullContinuationSuperseded: true,
+                securityContextMatches: false,
+            };
+        }
+        return prepareRebasedLocalMetadataMutation({
+            authoritativeState,
+            localMetadataPatch: input.localMetadataPatch,
+            metadataState,
+            patch,
+        });
+    }
+    const mutationPatch = pullContinuationSuperseded ? {} : patch;
+    const securityContext = resolveMetadataSecurityContext(mutationMetadataState, mutationPatch);
+    if (securityContextMatches &&
+        (input.expectedSyncState === undefined || contentStateSuperseded)) {
+        mergeDurableMetadataCheckpoint({
+            durableRecord,
+            metadataState,
+            securityContext,
+        });
+    }
+    return {
+        durableRecord,
+        mutationContainer: authoritativeState.container,
+        mutationMetadataState,
+        mutationPatch,
+        pendingLocalUpdate: input.localUpdate,
+        pullContinuationSuperseded,
+        securityContext,
+        securityContextMatches,
+    };
+}
+//# sourceMappingURL=metadataMutationPreparation.js.map

package/workflows/container-contents/metadata/metadataMutationPreparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataMutationPreparation.js","sourceRoot":"","sources":["metadataMutationPreparation.ts"],"names":[],"mappings":"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","sourcesContent":["import { base64ToBytes } from \"@tearleads/encoding\";\nimport {\n  encodeVersionVector,\n  exportUpdatesSince,\n  importUpdates,\n} from \"@tearleads/loro\";\nimport {\n  getDefaultContainerName,\n  readContainerMetadataValue,\n  writeContainerMetadataValue,\n} from \"../../../data/containers/containerMetadataDocument\";\nimport { documentSyncPullContinuationsEqual } from \"../../../data/documents/shared/syncPagination\";\nimport { canWriteEffectiveAccessLevel } from \"../../../data/keying/accessLevel\";\nimport type { ContainerContentsPersistence } from \"../../../data/persistence/container-contents/containerContentsPersistence\";\nimport type { ExecSql } from \"../../../data/sqlite/sqlSchema\";\nimport type { ContainerDocumentRecord as DocumentRecord } from \"../containerPersistence\";\nimport {\n  type ExpectedContainerMetadataSyncState,\n  metadataSyncSecurityContextMatches,\n  replaceSupersededMetadataIdentity,\n  sameNullableMetadataValue,\n} from \"./metadataSyncSettlement\";\nimport type {\n  ContainerMetadataPatch,\n  ContainerMetadataState,\n} from \"./metadataTypes\";\n\nexport interface PersistContainerMetadataStateInput {\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  clearSyncFailure?: boolean | undefined;\n  execSql: ExecSql;\n  expectedSyncState?: ExpectedContainerMetadataSyncState | undefined;\n  localMetadataPatch?:\n    | Partial<Pick<ContainerMetadataPatch, \"icon\" | \"name\">>\n    | undefined;\n  localUpdate?: Uint8Array | undefined;\n  metadataState: ContainerMetadataState;\n  createIntentSettlement?: Parameters<\n    ContainerContentsPersistence[\"commitMetadataMutation\"]\n  >[1][\"createIntentSettlement\"];\n  moveIntentSettlement?: Parameters<\n    ContainerContentsPersistence[\"commitMetadataMutation\"]\n  >[1][\"moveIntentSettlement\"];\n  patch?: Partial<ContainerMetadataPatch> | undefined;\n  persistence: ContainerContentsPersistence;\n  preserveDurableStructureWhenPending?: boolean | undefined;\n  saveOptions?:\n    | Parameters<ContainerContentsPersistence[\"saveContainer\"]>[3]\n    | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n}\n\nexport function currentMetadataPullContinuation(\n  metadataState: ContainerMetadataState,\n) {\n  return Object.hasOwn(metadataState, \"pullContinuation\")\n    ? (metadataState.pullContinuation ?? null)\n    : (metadataState.record.pullContinuation ?? null);\n}\n\nexport function resolveMetadataSecurityContext(\n  metadataState: ContainerMetadataState,\n  patch: Partial<ContainerMetadataPatch>,\n) {\n  const currentDocumentId = metadataState.record.documentId ?? null;\n  const documentId =\n    patch.documentId !== undefined ? patch.documentId : currentDocumentId;\n  const accessEpoch = patch.accessEpoch ?? metadataState.record.accessEpoch;\n  const documentIdChanged = documentId !== currentDocumentId;\n\n  return {\n    accessEpoch,\n    changed:\n      documentIdChanged || accessEpoch !== metadataState.record.accessEpoch,\n    documentId,\n    documentIdChanged,\n  };\n}\n\nfunction mergeDurableMetadataCheckpoint(input: {\n  durableRecord: DocumentRecord | null;\n  metadataState: ContainerMetadataState;\n  securityContext: ReturnType<typeof resolveMetadataSecurityContext>;\n}): void {\n  const { durableRecord, metadataState, securityContext } = input;\n  if (\n    !durableRecord?.metadataUpdates ||\n    durableRecord.documentId !== metadataState.record.documentId ||\n    durableRecord.documentId !== securityContext.documentId ||\n    durableRecord.accessEpoch !== metadataState.record.accessEpoch ||\n    durableRecord.accessEpoch !== securityContext.accessEpoch\n  ) {\n    return;\n  }\n\n  importUpdates(metadataState.doc, [\n    base64ToBytes(durableRecord.metadataUpdates),\n  ]);\n}\n\nexport async function loadAuthoritativeContainerMetadataState(input: {\n  containerId: string;\n  execSql: ExecSql;\n  persistence: ContainerContentsPersistence;\n}) {\n  const stored = await input.persistence.loadContainerMetadataState(\n    input.execSql,\n    input.containerId,\n  );\n  return stored?.record\n    ? { container: stored.container, record: stored.record }\n    : null;\n}\n\nfunction localMetadataWriteAccessWasRevoked(input: {\n  authoritativeState: NonNullable<\n    Awaited<ReturnType<typeof loadAuthoritativeContainerMetadataState>>\n  >;\n  mutationInput: PersistContainerMetadataStateInput;\n}): boolean {\n  return (\n    input.mutationInput.expectedSyncState === undefined &&\n    input.mutationInput.localUpdate !== undefined &&\n    canWriteEffectiveAccessLevel(\n      input.mutationInput.metadataState.container.effectiveAccessLevel,\n    ) &&\n    !canWriteEffectiveAccessLevel(\n      input.authoritativeState.container.effectiveAccessLevel,\n    )\n  );\n}\n\nasync function prepareRebasedLocalMetadataMutation(input: {\n  authoritativeState: NonNullable<\n    Awaited<ReturnType<typeof loadAuthoritativeContainerMetadataState>>\n  >;\n  metadataState: ContainerMetadataState;\n  localMetadataPatch:\n    | Partial<Pick<ContainerMetadataPatch, \"icon\" | \"name\">>\n    | undefined;\n  patch: Partial<ContainerMetadataPatch>;\n}) {\n  const { authoritativeState, metadataState, patch } = input;\n  const replacementVersion = encodeVersionVector(metadataState.doc);\n  const replacementMetadata = readContainerMetadataValue(\n    metadataState.doc,\n    getDefaultContainerName(authoritativeState.container.parentId),\n  );\n  writeContainerMetadataValue(metadataState.doc, {\n    ...replacementMetadata,\n    ...input.localMetadataPatch,\n  });\n  const rebasedMetadataState = {\n    ...metadataState,\n    container: authoritativeState.container,\n    pullContinuation: authoritativeState.record.pullContinuation ?? null,\n    record: authoritativeState.record,\n  };\n  return {\n    durableRecord: authoritativeState.record,\n    mutationContainer: authoritativeState.container,\n    mutationMetadataState: rebasedMetadataState,\n    mutationPatch: patch,\n    pendingLocalUpdate: exportUpdatesSince(\n      metadataState.doc,\n      replacementVersion,\n    ),\n    pullContinuationSuperseded: false,\n    securityContext: resolveMetadataSecurityContext(\n      rebasedMetadataState,\n      patch,\n    ),\n    securityContextMatches: true,\n  };\n}\n\nfunction resolveMetadataSettlementMatch(\n  expectedSyncState: ExpectedContainerMetadataSyncState | undefined,\n  durableRecord: DocumentRecord | null,\n) {\n  if (!expectedSyncState) {\n    return {\n      contentStateSuperseded: false,\n      pullContinuationSuperseded: false,\n      securityContextMatches: true,\n    };\n  }\n  const securityContextMatches = metadataSyncSecurityContextMatches(\n    durableRecord,\n    expectedSyncState.record,\n  );\n  const progressStateMatches =\n    securityContextMatches &&\n    sameNullableMetadataValue(\n      durableRecord?.lastCommitLsn,\n      expectedSyncState.record.lastCommitLsn,\n    ) &&\n    Boolean(durableRecord?.pullContinuationRecoveryRequired) ===\n      Boolean(expectedSyncState.record.pullContinuationRecoveryRequired) &&\n    documentSyncPullContinuationsEqual(\n      durableRecord?.pullContinuation,\n      expectedSyncState.pullContinuation,\n    );\n  const contentStateMatches =\n    progressStateMatches &&\n    sameNullableMetadataValue(\n      durableRecord?.metadataUpdates,\n      expectedSyncState.record.metadataUpdates,\n    ) &&\n    sameNullableMetadataValue(\n      durableRecord?.snapshotEndVersion,\n      expectedSyncState.record.snapshotEndVersion,\n    );\n  return {\n    contentStateSuperseded: progressStateMatches && !contentStateMatches,\n    pullContinuationSuperseded: !progressStateMatches,\n    securityContextMatches,\n  };\n}\n\nexport async function prepareContainerMetadataMutation(\n  input: PersistContainerMetadataStateInput,\n  execSql: ExecSql,\n  patch: Partial<ContainerMetadataPatch>,\n) {\n  const { metadataState, persistence } = input;\n  const authoritativeState = await loadAuthoritativeContainerMetadataState({\n    containerId: metadataState.container.id,\n    execSql,\n    persistence,\n  });\n  if (!authoritativeState) {\n    return {\n      authoritativeState: null,\n      pullContinuationSuperseded: true,\n      securityContextMatches: false,\n    };\n  }\n  if (\n    localMetadataWriteAccessWasRevoked({\n      authoritativeState,\n      mutationInput: input,\n    })\n  ) {\n    await replaceSupersededMetadataIdentity({\n      durableRecord: authoritativeState.record,\n      metadataState,\n    });\n    return {\n      authoritativeState,\n      pullContinuationSuperseded: true,\n      securityContextMatches: false,\n    };\n  }\n  const durableRecord = authoritativeState.record;\n  const mutationMetadataState = durableRecord\n    ? {\n        ...metadataState,\n        pullContinuation: durableRecord.pullContinuation ?? null,\n        record: durableRecord,\n      }\n    : metadataState;\n  const capturedSecurityContextMatches =\n    durableRecord !== null &&\n    metadataSyncSecurityContextMatches(durableRecord, metadataState.record);\n  const {\n    contentStateSuperseded,\n    pullContinuationSuperseded,\n    securityContextMatches,\n  } = resolveMetadataSettlementMatch(input.expectedSyncState, durableRecord);\n\n  if (\n    input.expectedSyncState === undefined &&\n    !capturedSecurityContextMatches\n  ) {\n    await replaceSupersededMetadataIdentity({\n      durableRecord: authoritativeState.record,\n      metadataState,\n    });\n    if (input.localUpdate === undefined) {\n      return {\n        authoritativeState,\n        pullContinuationSuperseded: true,\n        securityContextMatches: false,\n      };\n    }\n    return prepareRebasedLocalMetadataMutation({\n      authoritativeState,\n      localMetadataPatch: input.localMetadataPatch,\n      metadataState,\n      patch,\n    });\n  }\n  const mutationPatch = pullContinuationSuperseded ? {} : patch;\n  const securityContext = resolveMetadataSecurityContext(\n    mutationMetadataState,\n    mutationPatch,\n  );\n  if (\n    securityContextMatches &&\n    (input.expectedSyncState === undefined || contentStateSuperseded)\n  ) {\n    mergeDurableMetadataCheckpoint({\n      durableRecord,\n      metadataState,\n      securityContext,\n    });\n  }\n  return {\n    durableRecord,\n    mutationContainer: authoritativeState.container,\n    mutationMetadataState,\n    mutationPatch,\n    pendingLocalUpdate: input.localUpdate,\n    pullContinuationSuperseded,\n    securityContext,\n    securityContextMatches,\n  };\n}\n"]}

package/workflows/container-contents/metadata/metadataPersistence.d.ts

@@ -0,0 +1,34 @@
+import type { ContainerContentsPersistence } from "../../../data/persistence/container-contents/containerContentsPersistence.js";
+import type { ContainerContentsWorkflowSqlRuntime } from "../runtime.js";
+import { currentMetadataPullContinuation, type PersistContainerMetadataStateInput } from "./metadataMutationPreparation.js";
+import { type ExpectedContainerMetadataSyncState } from "./metadataSyncSettlement.js";
+import type { ContainerMetadataState, PersistedContainerMetadataState } from "./metadataTypes.js";
+type ContainerMetadataPersistenceRuntime = ContainerContentsWorkflowSqlRuntime;
+export { hasCurrentContainerMetadataReadState } from "./metadataReadState.js";
+export { installContainerMetadataRecord } from "./metadataStateInstallation.js";
+export { currentMetadataPullContinuation };
+type PersistContainerMetadataStateRuntimeInput = Omit<PersistContainerMetadataStateInput, "execSql"> & {
+    onDurableStateNeedsReload?: (() => void) | undefined;
+    persistence: ContainerContentsPersistence;
+    runtime: ContainerMetadataPersistenceRuntime;
+};
+export declare function persistContainerMetadataStateFromRuntime(input: PersistContainerMetadataStateRuntimeInput & {
+    expectedSyncState: ExpectedContainerMetadataSyncState;
+}): Promise<PersistedContainerMetadataState | null>;
+export declare function persistContainerMetadataStateFromRuntime(input: PersistContainerMetadataStateRuntimeInput & {
+    expectedSyncState?: undefined;
+}): Promise<PersistedContainerMetadataState | null>;
+export declare function renameContainerMetadataStateFromRuntime(input: {
+    metadataState: ContainerMetadataState;
+    name: string;
+    persistence: ContainerContentsPersistence;
+    runtime: ContainerMetadataPersistenceRuntime;
+    stillCurrent?: (() => boolean) | undefined;
+}): Promise<PersistedContainerMetadataState | null>;
+export declare function setContainerIconMetadataStateFromRuntime(input: {
+    icon: string | null;
+    metadataState: ContainerMetadataState;
+    persistence: ContainerContentsPersistence;
+    runtime: ContainerMetadataPersistenceRuntime;
+    stillCurrent?: (() => boolean) | undefined;
+}): Promise<PersistedContainerMetadataState | null>;

package/workflows/container-contents/metadata/metadataPersistence.js

@@ -0,0 +1,254 @@
+import { encodeVersionVector, exportUpdatesSince } from "../../../internal/loro/index.js";
+import { getDefaultContainerName, readContainerMetadataValue, writeContainerMetadataValue, } from "../../../data/containers/containerMetadataDocument.js";
+import { createPendingUpdateFields } from "../../../data/documents/documentSync.js";
+import { runSerializedSqlMutation, } from "../../../data/sqlite/sqlSchema.js";
+import { currentMetadataPullContinuation, loadAuthoritativeContainerMetadataState, prepareContainerMetadataMutation, } from "./metadataMutationPreparation.js";
+import { buildContainerMetadataRecord, resolveContainerSystemSlot, resolveMetadataDocumentId, } from "./metadataRecord.js";
+import { installContainerMetadataRecord } from "./metadataStateInstallation.js";
+import { metadataSyncSecurityContextMatches, replaceSupersededMetadataIdentity, } from "./metadataSyncSettlement.js";
+const MAX_METADATA_MUTATION_COMMIT_ATTEMPTS = 8;
+export { hasCurrentContainerMetadataReadState } from "./metadataReadState.js";
+export { installContainerMetadataRecord } from "./metadataStateInstallation.js";
+export { currentMetadataPullContinuation };
+function invalidateMetadataWriterProjection(metadataState, securityContextChanged) {
+    if (securityContextChanged) {
+        metadataState.metadataWriterProjection = null;
+    }
+}
+async function settleSupersededMetadataMutation(input) {
+    const { metadataState, persistence, prepared } = input;
+    const settledState = input.expectedRecord
+        ? await persistence.settleAcceptedMetadataPendingUpdates(input.execSql, {
+            containerId: metadataState.container.id,
+            expectedRecord: input.expectedRecord,
+            pendingUpdateIds: input.acceptedPendingUpdateIds ?? [],
+            stillCurrent: input.stillCurrent,
+        })
+        : undefined;
+    if ("authoritativeState" in prepared) {
+        const authoritativeState = settledState ?? prepared.authoritativeState;
+        if (!authoritativeState?.record)
+            return null;
+        metadataState.container = authoritativeState.container;
+        installContainerMetadataRecord(metadataState, authoritativeState.record);
+        return {
+            container: authoritativeState.container,
+            pullContinuationSuperseded: true,
+            record: authoritativeState.record,
+            syncIdentitySuperseded: true,
+        };
+    }
+    const authoritativeState = settledState ??
+        (await loadAuthoritativeContainerMetadataState({
+            containerId: metadataState.container.id,
+            execSql: input.execSql,
+            persistence,
+        }));
+    if (!authoritativeState?.record)
+        return null;
+    // The rejected response may already have mutated the live Loro document.
+    // Rebuild from the authoritative durable snapshot instead of merging into
+    // that losing document, which would retain non-overlapping rejected fields.
+    await replaceSupersededMetadataIdentity({
+        durableRecord: authoritativeState.record,
+        metadataState,
+    });
+    metadataState.container = authoritativeState.container;
+    installContainerMetadataRecord(metadataState, authoritativeState.record);
+    return {
+        container: authoritativeState.container,
+        pullContinuationSuperseded: true,
+        record: authoritativeState.record,
+        ...(!prepared.securityContextMatches
+            ? { syncIdentitySuperseded: true }
+            : {}),
+    };
+}
+async function persistPreparedMetadataMutation(input) {
+    const { metadataState, persistence, prepared } = input;
+    const metadata = readContainerMetadataValue(metadataState.doc, getDefaultContainerName(prepared.mutationContainer.parentId));
+    const nextContainer = {
+        ...prepared.mutationContainer,
+        ...(prepared.mutationPatch.effectiveAccessLevel !== undefined
+            ? {
+                effectiveAccessLevel: prepared.mutationPatch.effectiveAccessLevel,
+            }
+            : {}),
+        organizationId: prepared.mutationPatch.organizationId ??
+            prepared.mutationContainer.organizationId,
+        parentId: prepared.mutationPatch.parentId ?? prepared.mutationContainer.parentId,
+        metadataDocumentId: resolveMetadataDocumentId(prepared.mutationPatch, prepared.mutationContainer),
+        systemSlot: resolveContainerSystemSlot(prepared.mutationPatch, prepared.mutationContainer),
+        name: prepared.mutationPatch.name ?? metadata.name,
+        icon: prepared.mutationPatch.icon !== undefined
+            ? prepared.mutationPatch.icon
+            : metadata.icon,
+    };
+    const nextRecord = buildContainerMetadataRecord({
+        metadataState: prepared.mutationMetadataState,
+        patch: prepared.mutationPatch,
+        securityContext: prepared.securityContext,
+    });
+    const pendingUpdate = prepared.pendingLocalUpdate
+        ? (createPendingUpdateFields(prepared.pendingLocalUpdate) ?? undefined)
+        : undefined;
+    const committed = await persistence.commitMetadataMutation(input.execSql, {
+        acceptedPendingUpdateIds: input.acceptedPendingUpdateIds ?? [],
+        clearSyncFailure: input.clearSyncFailure,
+        container: nextContainer,
+        createIntentSettlement: input.createIntentSettlement,
+        expectedContainer: prepared.mutationContainer,
+        expectedRecord: prepared.durableRecord,
+        moveIntentSettlement: input.moveIntentSettlement,
+        pendingUpdate,
+        preserveDurableStructureWhenPending: input.preserveDurableStructureWhenPending,
+        record: nextRecord,
+        saveOptions: input.saveOptions,
+        settleAcceptedPendingOnConflict: input.acceptedPendingUpdateIds !== undefined,
+        stillCurrent: input.stillCurrent,
+    });
+    if (!committed.committed) {
+        return {
+            conflict: true,
+            currentState: committed.currentState,
+            ...(committed.staleServerState
+                ? { staleServerState: true }
+                : {}),
+        };
+    }
+    invalidateMetadataWriterProjection(metadataState, prepared.securityContext.changed);
+    return {
+        container: committed.container,
+        record: nextRecord,
+        ...(committed.createIntentSettled
+            ? { createIntentSettled: true }
+            : {}),
+        ...(committed.moveIntentSettled
+            ? { moveIntentSettled: true }
+            : {}),
+    };
+}
+async function adoptMetadataCommitConflict(input) {
+    if (!input.staleServerState && input.expectedSyncState === undefined) {
+        return "retry";
+    }
+    if (!input.currentState?.record)
+        return null;
+    await replaceSupersededMetadataIdentity({
+        durableRecord: input.currentState.record,
+        metadataState: input.metadataState,
+    });
+    input.metadataState.container = input.currentState.container;
+    installContainerMetadataRecord(input.metadataState, input.currentState.record);
+    return {
+        container: input.currentState.container,
+        pullContinuationSuperseded: true,
+        record: input.currentState.record,
+        ...(input.staleServerState ? { mutationSuperseded: true } : {}),
+        ...(!metadataSyncSecurityContextMatches(input.currentState.record, input.expectedSyncState?.record ?? input.expectedRecord)
+            ? { syncIdentitySuperseded: true }
+            : {}),
+    };
+}
+async function persistContainerMetadataState(input) {
+    const patch = input.patch ?? {};
+    const prepareMutation = prepareContainerMetadataMutation;
+    return runSerializedSqlMutation(input.execSql, async (lockedExecSql) => {
+        for (let attempt = 0; attempt < MAX_METADATA_MUTATION_COMMIT_ATTEMPTS; attempt += 1) {
+            const prepared = await prepareMutation(input, lockedExecSql, patch);
+            if (input.stillCurrent?.() === false)
+                return null;
+            if ("authoritativeState" in prepared ||
+                prepared.pullContinuationSuperseded) {
+                return settleSupersededMetadataMutation({
+                    acceptedPendingUpdateIds: input.acceptedPendingUpdateIds,
+                    execSql: lockedExecSql,
+                    expectedRecord: input.expectedSyncState?.record,
+                    metadataState: input.metadataState,
+                    persistence: input.persistence,
+                    prepared,
+                    stillCurrent: input.stillCurrent,
+                });
+            }
+            const persisted = await persistPreparedMetadataMutation({
+                acceptedPendingUpdateIds: input.acceptedPendingUpdateIds,
+                clearSyncFailure: input.clearSyncFailure,
+                createIntentSettlement: input.createIntentSettlement,
+                execSql: lockedExecSql,
+                metadataState: input.metadataState,
+                moveIntentSettlement: input.moveIntentSettlement,
+                persistence: input.persistence,
+                prepared,
+                preserveDurableStructureWhenPending: input.preserveDurableStructureWhenPending,
+                saveOptions: input.saveOptions,
+                stillCurrent: input.stillCurrent,
+            });
+            if (input.stillCurrent?.() === false)
+                return null;
+            if (!("conflict" in persisted))
+                return persisted;
+            const conflict = await adoptMetadataCommitConflict({
+                currentState: persisted.currentState,
+                expectedRecord: prepared.durableRecord,
+                expectedSyncState: input.expectedSyncState,
+                metadataState: input.metadataState,
+                staleServerState: persisted.staleServerState,
+            });
+            if (conflict !== "retry")
+                return conflict;
+        }
+        throw new Error(`Container metadata mutation commit gave up after ${MAX_METADATA_MUTATION_COMMIT_ATTEMPTS} concurrent conflicts`);
+    });
+}
+export async function persistContainerMetadataStateFromRuntime(input) {
+    const { onDurableStateNeedsReload, runtime, ...persistenceInput } = input;
+    const execSql = runtime.infra.execSql;
+    const persisted = await persistContainerMetadataState({
+        ...persistenceInput,
+        execSql,
+    });
+    if (input.stillCurrent?.() === false) {
+        onDurableStateNeedsReload?.();
+        return null;
+    }
+    return persisted;
+}
+async function writeContainerMetadataPatch(input) {
+    const { execSql, metadataState, patch, persistence } = input;
+    const metadata = readContainerMetadataValue(metadataState.doc, getDefaultContainerName(metadataState.container.parentId));
+    const previousVersion = encodeVersionVector(metadataState.doc);
+    writeContainerMetadataValue(metadataState.doc, { ...metadata, ...patch });
+    const update = exportUpdatesSince(metadataState.doc, previousVersion);
+    return persistContainerMetadataState({
+        execSql,
+        localMetadataPatch: patch,
+        localUpdate: update,
+        metadataState,
+        patch,
+        persistence,
+        stillCurrent: input.stillCurrent,
+    });
+}
+export async function renameContainerMetadataStateFromRuntime(input) {
+    const trimmedName = input.name.trim();
+    if (!trimmedName) {
+        return null;
+    }
+    return writeContainerMetadataPatch({
+        execSql: input.runtime.infra.execSql,
+        metadataState: input.metadataState,
+        patch: { name: trimmedName },
+        persistence: input.persistence,
+        stillCurrent: input.stillCurrent,
+    });
+}
+export async function setContainerIconMetadataStateFromRuntime(input) {
+    return writeContainerMetadataPatch({
+        execSql: input.runtime.infra.execSql,
+        metadataState: input.metadataState,
+        patch: { icon: input.icon?.trim() || null },
+        persistence: input.persistence,
+        stillCurrent: input.stillCurrent,
+    });
+}
+//# sourceMappingURL=metadataPersistence.js.map

package/workflows/container-contents/metadata/metadataPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataPersistence.js","sourceRoot":"","sources":["metadataPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector, exportUpdatesSince } from \"@tearleads/loro\";\nimport {\n  getDefaultContainerName,\n  readContainerMetadataValue,\n  writeContainerMetadataValue,\n} from \"../../../data/containers/containerMetadataDocument\";\nimport { createPendingUpdateFields } from \"../../../data/documents/documentSync\";\nimport type { ContainerContentsPersistence } from \"../../../data/persistence/container-contents/containerContentsPersistence\";\nimport type { ContainerRecord } from \"../../../data/persistence/containers/containerPersistence\";\nimport {\n  type ExecSql,\n  runSerializedSqlMutation,\n} from \"../../../data/sqlite/sqlSchema\";\nimport type { ContainerDocumentRecord as DocumentRecord } from \"../containerPersistence\";\nimport type { ContainerContentsWorkflowSqlRuntime } from \"../runtime\";\nimport {\n  currentMetadataPullContinuation,\n  loadAuthoritativeContainerMetadataState,\n  type PersistContainerMetadataStateInput,\n  prepareContainerMetadataMutation,\n} from \"./metadataMutationPreparation\";\nimport {\n  buildContainerMetadataRecord,\n  resolveContainerSystemSlot,\n  resolveMetadataDocumentId,\n} from \"./metadataRecord\";\nimport { installContainerMetadataRecord } from \"./metadataStateInstallation\";\nimport {\n  type ExpectedContainerMetadataSyncState,\n  metadataSyncSecurityContextMatches,\n  replaceSupersededMetadataIdentity,\n} from \"./metadataSyncSettlement\";\nimport type {\n  ContainerMetadataPatch,\n  ContainerMetadataState,\n  PersistedContainerMetadataState,\n} from \"./metadataTypes\";\n\ntype ContainerMetadataPersistenceRuntime = ContainerContentsWorkflowSqlRuntime;\nconst MAX_METADATA_MUTATION_COMMIT_ATTEMPTS = 8;\ntype SaveContainerOptions = Parameters<\n  ContainerContentsPersistence[\"saveContainer\"]\n>[3];\n\nexport { hasCurrentContainerMetadataReadState } from \"./metadataReadState\";\nexport { installContainerMetadataRecord } from \"./metadataStateInstallation\";\nexport { currentMetadataPullContinuation };\n\nfunction invalidateMetadataWriterProjection(\n  metadataState: ContainerMetadataState,\n  securityContextChanged: boolean,\n): void {\n  if (securityContextChanged) {\n    metadataState.metadataWriterProjection = null;\n  }\n}\ntype PreparedContainerMetadataMutation = Awaited<\n  ReturnType<typeof prepareContainerMetadataMutation>\n>;\ntype ApplicableContainerMetadataMutation = Exclude<\n  PreparedContainerMetadataMutation,\n  { authoritativeState: unknown }\n>;\nasync function settleSupersededMetadataMutation(input: {\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  execSql: ExecSql;\n  expectedRecord?: DocumentRecord | undefined;\n  metadataState: ContainerMetadataState;\n  persistence: ContainerContentsPersistence;\n  prepared: PreparedContainerMetadataMutation;\n  stillCurrent?: (() => boolean) | undefined;\n}): Promise<PersistedContainerMetadataState | null> {\n  const { metadataState, persistence, prepared } = input;\n  const settledState = input.expectedRecord\n    ? await persistence.settleAcceptedMetadataPendingUpdates(input.execSql, {\n        containerId: metadataState.container.id,\n        expectedRecord: input.expectedRecord,\n        pendingUpdateIds: input.acceptedPendingUpdateIds ?? [],\n        stillCurrent: input.stillCurrent,\n      })\n    : undefined;\n  if (\"authoritativeState\" in prepared) {\n    const authoritativeState = settledState ?? prepared.authoritativeState;\n    if (!authoritativeState?.record) return null;\n    metadataState.container = authoritativeState.container;\n    installContainerMetadataRecord(metadataState, authoritativeState.record);\n    return {\n      container: authoritativeState.container,\n      pullContinuationSuperseded: true,\n      record: authoritativeState.record,\n      syncIdentitySuperseded: true,\n    };\n  }\n  const authoritativeState =\n    settledState ??\n    (await loadAuthoritativeContainerMetadataState({\n      containerId: metadataState.container.id,\n      execSql: input.execSql,\n      persistence,\n    }));\n  if (!authoritativeState?.record) return null;\n  // The rejected response may already have mutated the live Loro document.\n  // Rebuild from the authoritative durable snapshot instead of merging into\n  // that losing document, which would retain non-overlapping rejected fields.\n  await replaceSupersededMetadataIdentity({\n    durableRecord: authoritativeState.record,\n    metadataState,\n  });\n  metadataState.container = authoritativeState.container;\n  installContainerMetadataRecord(metadataState, authoritativeState.record);\n  return {\n    container: authoritativeState.container,\n    pullContinuationSuperseded: true,\n    record: authoritativeState.record,\n    ...(!prepared.securityContextMatches\n      ? { syncIdentitySuperseded: true as const }\n      : {}),\n  };\n}\nasync function persistPreparedMetadataMutation(input: {\n  clearSyncFailure?: boolean | undefined;\n  createIntentSettlement?: Parameters<\n    ContainerContentsPersistence[\"commitMetadataMutation\"]\n  >[1][\"createIntentSettlement\"];\n  execSql: ExecSql;\n  metadataState: ContainerMetadataState;\n  moveIntentSettlement?: Parameters<\n    ContainerContentsPersistence[\"commitMetadataMutation\"]\n  >[1][\"moveIntentSettlement\"];\n  persistence: ContainerContentsPersistence;\n  prepared: ApplicableContainerMetadataMutation;\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  preserveDurableStructureWhenPending?: boolean | undefined;\n  saveOptions?: SaveContainerOptions;\n  stillCurrent?: (() => boolean) | undefined;\n}): Promise<\n  | PersistedContainerMetadataState\n  | {\n      conflict: true;\n      currentState: Awaited<\n        ReturnType<ContainerContentsPersistence[\"loadContainerMetadataState\"]>\n      >;\n      staleServerState?: true;\n    }\n> {\n  const { metadataState, persistence, prepared } = input;\n  const metadata = readContainerMetadataValue(\n    metadataState.doc,\n    getDefaultContainerName(prepared.mutationContainer.parentId),\n  );\n  const nextContainer: ContainerRecord = {\n    ...prepared.mutationContainer,\n    ...(prepared.mutationPatch.effectiveAccessLevel !== undefined\n      ? {\n          effectiveAccessLevel: prepared.mutationPatch.effectiveAccessLevel,\n        }\n      : {}),\n    organizationId:\n      prepared.mutationPatch.organizationId ??\n      prepared.mutationContainer.organizationId,\n    parentId:\n      prepared.mutationPatch.parentId ?? prepared.mutationContainer.parentId,\n    metadataDocumentId: resolveMetadataDocumentId(\n      prepared.mutationPatch,\n      prepared.mutationContainer,\n    ),\n    systemSlot: resolveContainerSystemSlot(\n      prepared.mutationPatch,\n      prepared.mutationContainer,\n    ),\n    name: prepared.mutationPatch.name ?? metadata.name,\n    icon:\n      prepared.mutationPatch.icon !== undefined\n        ? prepared.mutationPatch.icon\n        : metadata.icon,\n  };\n  const nextRecord = buildContainerMetadataRecord({\n    metadataState: prepared.mutationMetadataState,\n    patch: prepared.mutationPatch,\n    securityContext: prepared.securityContext,\n  });\n  const pendingUpdate = prepared.pendingLocalUpdate\n    ? (createPendingUpdateFields(prepared.pendingLocalUpdate) ?? undefined)\n    : undefined;\n  const committed = await persistence.commitMetadataMutation(input.execSql, {\n    acceptedPendingUpdateIds: input.acceptedPendingUpdateIds ?? [],\n    clearSyncFailure: input.clearSyncFailure,\n    container: nextContainer,\n    createIntentSettlement: input.createIntentSettlement,\n    expectedContainer: prepared.mutationContainer,\n    expectedRecord: prepared.durableRecord,\n    moveIntentSettlement: input.moveIntentSettlement,\n    pendingUpdate,\n    preserveDurableStructureWhenPending:\n      input.preserveDurableStructureWhenPending,\n    record: nextRecord,\n    saveOptions: input.saveOptions,\n    settleAcceptedPendingOnConflict:\n      input.acceptedPendingUpdateIds !== undefined,\n    stillCurrent: input.stillCurrent,\n  });\n  if (!committed.committed) {\n    return {\n      conflict: true,\n      currentState: committed.currentState,\n      ...(committed.staleServerState\n        ? { staleServerState: true as const }\n        : {}),\n    };\n  }\n  invalidateMetadataWriterProjection(\n    metadataState,\n    prepared.securityContext.changed,\n  );\n  return {\n    container: committed.container,\n    record: nextRecord,\n    ...(committed.createIntentSettled\n      ? { createIntentSettled: true as const }\n      : {}),\n    ...(committed.moveIntentSettled\n      ? { moveIntentSettled: true as const }\n      : {}),\n  };\n}\nasync function adoptMetadataCommitConflict(input: {\n  currentState: Awaited<\n    ReturnType<ContainerContentsPersistence[\"loadContainerMetadataState\"]>\n  >;\n  expectedRecord: DocumentRecord;\n  expectedSyncState?: ExpectedContainerMetadataSyncState | undefined;\n  metadataState: ContainerMetadataState;\n  staleServerState?: true | undefined;\n}): Promise<PersistedContainerMetadataState | null | \"retry\"> {\n  if (!input.staleServerState && input.expectedSyncState === undefined) {\n    return \"retry\";\n  }\n  if (!input.currentState?.record) return null;\n  await replaceSupersededMetadataIdentity({\n    durableRecord: input.currentState.record,\n    metadataState: input.metadataState,\n  });\n  input.metadataState.container = input.currentState.container;\n  installContainerMetadataRecord(\n    input.metadataState,\n    input.currentState.record,\n  );\n  return {\n    container: input.currentState.container,\n    pullContinuationSuperseded: true,\n    record: input.currentState.record,\n    ...(input.staleServerState ? { mutationSuperseded: true as const } : {}),\n    ...(!metadataSyncSecurityContextMatches(\n      input.currentState.record,\n      input.expectedSyncState?.record ?? input.expectedRecord,\n    )\n      ? { syncIdentitySuperseded: true as const }\n      : {}),\n  };\n}\nasync function persistContainerMetadataState(\n  input: PersistContainerMetadataStateInput,\n): Promise<PersistedContainerMetadataState | null> {\n  const patch = input.patch ?? {};\n  const prepareMutation = prepareContainerMetadataMutation;\n  return runSerializedSqlMutation(input.execSql, async (lockedExecSql) => {\n    for (\n      let attempt = 0;\n      attempt < MAX_METADATA_MUTATION_COMMIT_ATTEMPTS;\n      attempt += 1\n    ) {\n      const prepared = await prepareMutation(input, lockedExecSql, patch);\n      if (input.stillCurrent?.() === false) return null;\n      if (\n        \"authoritativeState\" in prepared ||\n        prepared.pullContinuationSuperseded\n      ) {\n        return settleSupersededMetadataMutation({\n          acceptedPendingUpdateIds: input.acceptedPendingUpdateIds,\n          execSql: lockedExecSql,\n          expectedRecord: input.expectedSyncState?.record,\n          metadataState: input.metadataState,\n          persistence: input.persistence,\n          prepared,\n          stillCurrent: input.stillCurrent,\n        });\n      }\n      const persisted = await persistPreparedMetadataMutation({\n        acceptedPendingUpdateIds: input.acceptedPendingUpdateIds,\n        clearSyncFailure: input.clearSyncFailure,\n        createIntentSettlement: input.createIntentSettlement,\n        execSql: lockedExecSql,\n        metadataState: input.metadataState,\n        moveIntentSettlement: input.moveIntentSettlement,\n        persistence: input.persistence,\n        prepared,\n        preserveDurableStructureWhenPending:\n          input.preserveDurableStructureWhenPending,\n        saveOptions: input.saveOptions,\n        stillCurrent: input.stillCurrent,\n      });\n      if (input.stillCurrent?.() === false) return null;\n      if (!(\"conflict\" in persisted)) return persisted;\n      const conflict = await adoptMetadataCommitConflict({\n        currentState: persisted.currentState,\n        expectedRecord: prepared.durableRecord,\n        expectedSyncState: input.expectedSyncState,\n        metadataState: input.metadataState,\n        staleServerState: persisted.staleServerState,\n      });\n      if (conflict !== \"retry\") return conflict;\n    }\n    throw new Error(\n      `Container metadata mutation commit gave up after ${MAX_METADATA_MUTATION_COMMIT_ATTEMPTS} concurrent conflicts`,\n    );\n  });\n}\ntype PersistContainerMetadataStateRuntimeInput = Omit<\n  PersistContainerMetadataStateInput,\n  \"execSql\"\n> & {\n  onDurableStateNeedsReload?: (() => void) | undefined;\n  persistence: ContainerContentsPersistence;\n  runtime: ContainerMetadataPersistenceRuntime;\n};\n\nexport function persistContainerMetadataStateFromRuntime(\n  input: PersistContainerMetadataStateRuntimeInput & {\n    expectedSyncState: ExpectedContainerMetadataSyncState;\n  },\n): Promise<PersistedContainerMetadataState | null>;\nexport function persistContainerMetadataStateFromRuntime(\n  input: PersistContainerMetadataStateRuntimeInput & {\n    expectedSyncState?: undefined;\n  },\n): Promise<PersistedContainerMetadataState | null>;\nexport async function persistContainerMetadataStateFromRuntime(\n  input: PersistContainerMetadataStateRuntimeInput,\n): Promise<PersistedContainerMetadataState | null> {\n  const { onDurableStateNeedsReload, runtime, ...persistenceInput } = input;\n  const execSql = runtime.infra.execSql;\n  const persisted = await persistContainerMetadataState({\n    ...persistenceInput,\n    execSql,\n  });\n  if (input.stillCurrent?.() === false) {\n    onDurableStateNeedsReload?.();\n    return null;\n  }\n  return persisted;\n}\n\nasync function writeContainerMetadataPatch(input: {\n  execSql: ExecSql;\n  metadataState: ContainerMetadataState;\n  patch: Partial<Pick<ContainerMetadataPatch, \"icon\" | \"name\">>;\n  persistence: ContainerContentsPersistence;\n  stillCurrent?: (() => boolean) | undefined;\n}): Promise<PersistedContainerMetadataState | null> {\n  const { execSql, metadataState, patch, persistence } = input;\n  const metadata = readContainerMetadataValue(\n    metadataState.doc,\n    getDefaultContainerName(metadataState.container.parentId),\n  );\n  const previousVersion = encodeVersionVector(metadataState.doc);\n  writeContainerMetadataValue(metadataState.doc, { ...metadata, ...patch });\n  const update = exportUpdatesSince(metadataState.doc, previousVersion);\n\n  return persistContainerMetadataState({\n    execSql,\n    localMetadataPatch: patch,\n    localUpdate: update,\n    metadataState,\n    patch,\n    persistence,\n    stillCurrent: input.stillCurrent,\n  });\n}\n\nexport async function renameContainerMetadataStateFromRuntime(input: {\n  metadataState: ContainerMetadataState;\n  name: string;\n  persistence: ContainerContentsPersistence;\n  runtime: ContainerMetadataPersistenceRuntime;\n  stillCurrent?: (() => boolean) | undefined;\n}): Promise<PersistedContainerMetadataState | null> {\n  const trimmedName = input.name.trim();\n  if (!trimmedName) {\n    return null;\n  }\n\n  return writeContainerMetadataPatch({\n    execSql: input.runtime.infra.execSql,\n    metadataState: input.metadataState,\n    patch: { name: trimmedName },\n    persistence: input.persistence,\n    stillCurrent: input.stillCurrent,\n  });\n}\n\nexport async function setContainerIconMetadataStateFromRuntime(input: {\n  icon: string | null;\n  metadataState: ContainerMetadataState;\n  persistence: ContainerContentsPersistence;\n  runtime: ContainerMetadataPersistenceRuntime;\n  stillCurrent?: (() => boolean) | undefined;\n}): Promise<PersistedContainerMetadataState | null> {\n  return writeContainerMetadataPatch({\n    execSql: input.runtime.infra.execSql,\n    metadataState: input.metadataState,\n    patch: { icon: input.icon?.trim() || null },\n    persistence: input.persistence,\n    stillCurrent: input.stillCurrent,\n  });\n}\n"]}

package/workflows/container-contents/metadata/metadataPullContinuationInvalidation.js

@@ -0,0 +1,65 @@
+import { base64ToBytes } from "../../../internal/encoding/index.js";
+import { importUpdates } from "../../../internal/loro/index.js";
+import { documentSyncPullContinuationsEqual, } from "../../../data/documents/shared/syncPagination.js";
+import { runSerializedSqlMutation } from "../../../data/sqlite/sqlSchema.js";
+import { currentMetadataPullContinuation } from "./metadataPersistence.js";
+function metadataInvalidationStateMatches(input) {
+    const { accessEpoch, continuation, documentId, durableRecord, metadataState, } = input;
+    return (metadataState.record.documentId === documentId &&
+        metadataState.record.accessEpoch === accessEpoch &&
+        durableRecord.documentId === documentId &&
+        durableRecord.accessEpoch === accessEpoch &&
+        (durableRecord.accessStateHash ?? null) ===
+            (metadataState.record.accessStateHash ?? null) &&
+        (durableRecord.contentKeyBundle ?? null) ===
+            (metadataState.record.contentKeyBundle ?? null) &&
+        (durableRecord.documentKekTargets ?? null) ===
+            (metadataState.record.documentKekTargets ?? null) &&
+        (durableRecord.documentManifestBundle ?? null) ===
+            (metadataState.record.documentManifestBundle ?? null) &&
+        documentSyncPullContinuationsEqual(currentMetadataPullContinuation(metadataState), continuation));
+}
+export async function invalidateContainerMetadataPullContinuation(input) {
+    const { continuation, metadataState, runtime } = input;
+    if (input.isCurrent?.() === false)
+        return;
+    const { accessEpoch, documentId } = metadataState.record;
+    if (!documentId)
+        return;
+    await runSerializedSqlMutation(runtime.infra.execSql, async (lockedExecSql) => {
+        if (input.isCurrent?.() === false)
+            return;
+        const durableRecord = await input.persistence.invalidateMetadataPullContinuation(lockedExecSql, {
+            accessEpoch,
+            accessStateHash: metadataState.record.accessStateHash ?? null,
+            continuation,
+            containerId: metadataState.container.id,
+            contentKeyBundle: metadataState.record.contentKeyBundle ?? null,
+            documentId,
+            documentKekTargets: metadataState.record.documentKekTargets ?? null,
+            documentManifestBundle: metadataState.record.documentManifestBundle ?? null,
+            lastCommitLsn: metadataState.record.lastCommitLsn ?? null,
+            stillCurrent: input.isCurrent,
+        });
+        if (input.isCurrent?.() === false ||
+            !durableRecord ||
+            !metadataInvalidationStateMatches({
+                accessEpoch,
+                continuation,
+                documentId,
+                durableRecord,
+                metadataState,
+            })) {
+            return;
+        }
+        if (durableRecord.metadataUpdates) {
+            importUpdates(metadataState.doc, [
+                base64ToBytes(durableRecord.metadataUpdates),
+            ]);
+        }
+        const { pullContinuation: _stalePullContinuation, pullContinuationRecoveryRequired: _staleRecoveryMarker, ...liveRecord } = metadataState.record;
+        metadataState.record = { ...liveRecord, ...durableRecord };
+        metadataState.pullContinuation = durableRecord.pullContinuation ?? null;
+    });
+}
+//# sourceMappingURL=metadataPullContinuationInvalidation.js.map

package/workflows/container-contents/metadata/metadataPullContinuationInvalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataPullContinuationInvalidation.js","sourceRoot":"","sources":["metadataPullContinuationInvalidation.ts"],"names":[],"mappings":"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","sourcesContent":["import { base64ToBytes } from \"@tearleads/encoding\";\nimport { importUpdates } from \"@tearleads/loro\";\nimport {\n  type DocumentSyncPullContinuation,\n  documentSyncPullContinuationsEqual,\n} from \"../../../data/documents/shared/syncPagination\";\nimport type { ContainerContentsPersistence } from \"../../../data/persistence/container-contents/containerContentsPersistence\";\nimport { runSerializedSqlMutation } from \"../../../data/sqlite/sqlSchema\";\nimport type { ContainerContentsWorkflowSqlRuntime } from \"../runtime\";\nimport { currentMetadataPullContinuation } from \"./metadataPersistence\";\nimport type { ContainerMetadataState } from \"./metadataTypes\";\n\nfunction metadataInvalidationStateMatches(input: {\n  accessEpoch: number;\n  continuation: DocumentSyncPullContinuation;\n  documentId: string;\n  durableRecord: NonNullable<\n    Awaited<\n      ReturnType<ContainerContentsPersistence[\"loadContainerMetadataRecord\"]>\n    >\n  >;\n  metadataState: ContainerMetadataState;\n}): boolean {\n  const {\n    accessEpoch,\n    continuation,\n    documentId,\n    durableRecord,\n    metadataState,\n  } = input;\n  return (\n    metadataState.record.documentId === documentId &&\n    metadataState.record.accessEpoch === accessEpoch &&\n    durableRecord.documentId === documentId &&\n    durableRecord.accessEpoch === accessEpoch &&\n    (durableRecord.accessStateHash ?? null) ===\n      (metadataState.record.accessStateHash ?? null) &&\n    (durableRecord.contentKeyBundle ?? null) ===\n      (metadataState.record.contentKeyBundle ?? null) &&\n    (durableRecord.documentKekTargets ?? null) ===\n      (metadataState.record.documentKekTargets ?? null) &&\n    (durableRecord.documentManifestBundle ?? null) ===\n      (metadataState.record.documentManifestBundle ?? null) &&\n    documentSyncPullContinuationsEqual(\n      currentMetadataPullContinuation(metadataState),\n      continuation,\n    )\n  );\n}\n\nexport async function invalidateContainerMetadataPullContinuation(input: {\n  continuation: DocumentSyncPullContinuation;\n  isCurrent?: (() => boolean) | undefined;\n  metadataState: ContainerMetadataState;\n  persistence: ContainerContentsPersistence;\n  runtime: ContainerContentsWorkflowSqlRuntime;\n}): Promise<void> {\n  const { continuation, metadataState, runtime } = input;\n  if (input.isCurrent?.() === false) return;\n  const { accessEpoch, documentId } = metadataState.record;\n  if (!documentId) return;\n\n  await runSerializedSqlMutation(\n    runtime.infra.execSql,\n    async (lockedExecSql) => {\n      if (input.isCurrent?.() === false) return;\n      const durableRecord =\n        await input.persistence.invalidateMetadataPullContinuation(\n          lockedExecSql,\n          {\n            accessEpoch,\n            accessStateHash: metadataState.record.accessStateHash ?? null,\n            continuation,\n            containerId: metadataState.container.id,\n            contentKeyBundle: metadataState.record.contentKeyBundle ?? null,\n            documentId,\n            documentKekTargets: metadataState.record.documentKekTargets ?? null,\n            documentManifestBundle:\n              metadataState.record.documentManifestBundle ?? null,\n            lastCommitLsn: metadataState.record.lastCommitLsn ?? null,\n            stillCurrent: input.isCurrent,\n          },\n        );\n      if (\n        input.isCurrent?.() === false ||\n        !durableRecord ||\n        !metadataInvalidationStateMatches({\n          accessEpoch,\n          continuation,\n          documentId,\n          durableRecord,\n          metadataState,\n        })\n      ) {\n        return;\n      }\n      if (durableRecord.metadataUpdates) {\n        importUpdates(metadataState.doc, [\n          base64ToBytes(durableRecord.metadataUpdates),\n        ]);\n      }\n      const {\n        pullContinuation: _stalePullContinuation,\n        pullContinuationRecoveryRequired: _staleRecoveryMarker,\n        ...liveRecord\n      } = metadataState.record;\n      metadataState.record = { ...liveRecord, ...durableRecord };\n      metadataState.pullContinuation = durableRecord.pullContinuation ?? null;\n    },\n  );\n}\n"]}

package/workflows/container-contents/metadata/metadataReadState.d.ts

@@ -0,0 +1,2 @@
+import type { ContainerDocumentRecord as DocumentRecord } from "../containerPersistence.js";
+export declare function hasCurrentContainerMetadataReadState(record: Pick<DocumentRecord, "contentKeyBundle" | "documentKekTargets" | "documentManifestBundle" | "lastCommitLsn">): boolean;