@tearleads/client-sdk 0.1.68 → 0.1.71

package/internal/validators/response/registration.d.ts

@@ -100,6 +100,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     };
     organizationMetadataContainerId: string;
@@ -141,6 +146,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     };
     rootMetadataDocumentId: string;
     systemContainers: {
@@ -239,6 +249,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     }[];
     userId: string;
@@ -277,6 +292,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     organizationProfileDocumentId?: string | undefined;
     rosterProfileContainer?: {
@@ -375,6 +395,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     } | undefined;
     rosterProfileContainerId?: string | undefined;
@@ -413,6 +438,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     rosterProfileDocumentId?: string | undefined;
 }, {
@@ -516,6 +546,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     };
     organizationMetadataContainerId: string;
@@ -557,6 +592,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     };
     rootMetadataDocumentId: string;
     systemContainers: {
@@ -655,6 +695,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     }[];
     userId: string;
@@ -693,6 +738,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     organizationProfileDocumentId?: string | undefined;
     rosterProfileContainer?: {
@@ -791,6 +841,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     } | undefined;
     rosterProfileContainerId?: string | undefined;
@@ -829,6 +884,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     rosterProfileDocumentId?: string | undefined;
 }, z.core.$ZodTypeInternals<{
@@ -932,6 +992,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     };
     organizationMetadataContainerId: string;
@@ -973,6 +1038,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     };
     rootMetadataDocumentId: string;
     systemContainers: {
@@ -1071,6 +1141,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     }[];
     userId: string;
@@ -1109,6 +1184,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     organizationProfileDocumentId?: string | undefined;
     rosterProfileContainer?: {
@@ -1207,6 +1287,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     } | undefined;
     rosterProfileContainerId?: string | undefined;
@@ -1245,6 +1330,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     rosterProfileDocumentId?: string | undefined;
 }, {
@@ -1348,6 +1438,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     };
     organizationMetadataContainerId: string;
@@ -1389,6 +1484,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     };
     rootMetadataDocumentId: string;
     systemContainers: {
@@ -1487,6 +1587,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     }[];
     userId: string;
@@ -1525,6 +1630,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     organizationProfileDocumentId?: string | undefined;
     rosterProfileContainer?: {
@@ -1623,6 +1733,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     } | undefined;
     rosterProfileContainerId?: string | undefined;
@@ -1661,6 +1776,11 @@ export declare const RegistrationResponseSchema: z.ZodType<{
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | undefined;
     rosterProfileDocumentId?: string | undefined;
 }>>;

package/internal/validators/util/containerLimits.d.ts

@@ -7,3 +7,11 @@ export declare const MAX_CONTAINER_PATH_LENGTH = 100;
  * bound keeps that capacity instead of letting a small body cite ~50x more.
  */
 export declare const MAX_CONTAINER_MANIFEST_HISTORY_REFS = 4096;
+/**
+ * Maximum number of principal policy heads one container mutation may cite.
+ * Each citation makes the server verify that principal's stored policy, so
+ * the bound keeps the capacity inline signed policies (about 9.8 KiB each)
+ * had under the 32 MiB request ceiling instead of letting a ~170-byte reference
+ * multiply that work.
+ */
+export declare const MAX_CONTAINER_PRINCIPAL_POLICY_REFS = 4096;

package/internal/validators/util/containerLimits.js

@@ -7,4 +7,12 @@ export const MAX_CONTAINER_PATH_LENGTH = 100;
  * bound keeps that capacity instead of letting a small body cite ~50x more.
  */
 export const MAX_CONTAINER_MANIFEST_HISTORY_REFS = 4096;
+/**
+ * Maximum number of principal policy heads one container mutation may cite.
+ * Each citation makes the server verify that principal's stored policy, so
+ * the bound keeps the capacity inline signed policies (about 9.8 KiB each)
+ * had under the 32 MiB request ceiling instead of letting a ~170-byte reference
+ * multiply that work.
+ */
+export const MAX_CONTAINER_PRINCIPAL_POLICY_REFS = 4096;
 //# sourceMappingURL=containerLimits.js.map

package/internal/validators/util/containerLimits.js.map

@@ -1 +1 @@
-{"version":3,"file":"containerLimits.js","sourceRoot":"","sources":["containerLimits.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,CAAC","sourcesContent":["/** Maximum number of containers in a root-to-leaf path, including both ends. */\nexport const MAX_CONTAINER_PATH_LENGTH = 100;\n\n/**\n * Maximum number of stored manifests one container mutation may cite as the\n * mutated container's history. Inline bundles (8-14 KiB each) fit about this\n * many under the 32 MiB request ceiling; a reference is ~150 bytes, so the\n * bound keeps that capacity instead of letting a small body cite ~50x more.\n */\nexport const MAX_CONTAINER_MANIFEST_HISTORY_REFS = 4096;\n"]}
+{"version":3,"file":"containerLimits.js","sourceRoot":"","sources":["containerLimits.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,CAAC","sourcesContent":["/** Maximum number of containers in a root-to-leaf path, including both ends. */\nexport const MAX_CONTAINER_PATH_LENGTH = 100;\n\n/**\n * Maximum number of stored manifests one container mutation may cite as the\n * mutated container's history. Inline bundles (8-14 KiB each) fit about this\n * many under the 32 MiB request ceiling; a reference is ~150 bytes, so the\n * bound keeps that capacity instead of letting a small body cite ~50x more.\n */\nexport const MAX_CONTAINER_MANIFEST_HISTORY_REFS = 4096;\n\n/**\n * Maximum number of principal policy heads one container mutation may cite.\n * Each citation makes the server verify that principal's stored policy, so\n * the bound keeps the capacity inline signed policies (about 9.8 KiB each)\n * had under the 32 MiB request ceiling instead of letting a ~170-byte reference\n * multiply that work.\n */\nexport const MAX_CONTAINER_PRINCIPAL_POLICY_REFS = 4096;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tearleads/client-sdk",
-  "version": "0.1.68",
+  "version": "0.1.71",
   "description": "React-free Tearleads client runtime: local SQLite persistence, keys, sync, encrypted blobs, and domain workflows.",
   "license": "UNLICENSED",
   "repository": {

package/stores/container-contents/containerState/containerStatePersistence.js

@@ -4,6 +4,8 @@ import { removeMissingContainerState } from "./missingContainerState.js";
 export async function persistContainerState(state, containerState, options = {}) {
     const { expectedStateWhenMissing, isCurrent, updateView = true } = options;
     const persisted = await persistContainerMetadataStateFromRuntime({
+        acceptedPendingUpdateIds: options.acceptedPendingUpdateIds,
+        clearSyncFailure: options.clearSyncFailure,
         metadataState: containerState,
         localMetadataPatch: options.localMetadataPatch,
         localUpdate: options.localUpdate,

package/stores/container-contents/containerState/containerStatePersistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"containerStatePersistence.js","sourceRoot":"","sources":["containerStatePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,wCAAwC,GACzC,MAAM,gDAAgD,CAAC;AAExD,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAsBtE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkC,EAClC,cAA8B,EAC9B,UAAwC,EAAE;IAE1C,MAAM,EAAE,wBAAwB,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3E,MAAM,SAAS,GAAG,MAAM,wCAAwC,CAAC;QAC/D,aAAa,EAAE,cAAc;QAC7B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,mCAAmC,EACjC,OAAO,CAAC,mCAAmC;QAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC;IACH,IAAI,SAAS,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,2BAA2B,CACzB,KAAK,EACL,wBAAwB,IAAI,cAAc,CAC3C,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IACD,cAAc,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IAC/C,8BAA8B,CAAC,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,SAAS,CAAC,kBAAkB,IAAI,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACrE,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,WAAW,IAAI,WAAW,KAAK,cAAc,EAAE,CAAC;YAClD,WAAW,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC;YACjD,WAAW,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC;YACrC,WAAW,CAAC,wBAAwB;gBAClC,cAAc,CAAC,wBAAwB,CAAC;YAC1C,8BAA8B,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;QACD,sEAAsE;QACtE,2EAA2E;QAC3E,2EAA2E;QAC3E,+BAA+B,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,MAAM,EAAE,WAAW;QACnB,GAAG,CAAC,SAAS,CAAC,mBAAmB;YAC/B,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAa,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,iBAAiB;YAC7B,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAa,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC","sourcesContent":["import {\n  installContainerMetadataRecord,\n  persistContainerMetadataStateFromRuntime,\n} from \"../../../workflows/container-contents/metadata\";\nimport type { PersistContainerStateResult } from \"../../../workflows/container-contents/remoteHydration\";\nimport { updateContainerContentsSnapshot } from \"../state\";\nimport type { ContainerState } from \"../syncAgent\";\nimport type { ContainerContentsStoreState } from \"../types\";\nimport { removeMissingContainerState } from \"./missingContainerState\";\n\ntype MetadataPersistenceInput = Parameters<\n  typeof persistContainerMetadataStateFromRuntime\n>[0];\n\ninterface PersistContainerStateOptions\n  extends Pick<\n    MetadataPersistenceInput,\n    | \"patch\"\n    | \"saveOptions\"\n    | \"localMetadataPatch\"\n    | \"localUpdate\"\n    | \"createIntentSettlement\"\n    | \"moveIntentSettlement\"\n    | \"preserveDurableStructureWhenPending\"\n  > {\n  expectedStateWhenMissing?: ContainerState | undefined;\n  isCurrent?: (() => boolean) | undefined;\n  updateView?: boolean | undefined;\n}\n\nexport async function persistContainerState(\n  state: ContainerContentsStoreState,\n  containerState: ContainerState,\n  options: PersistContainerStateOptions = {},\n): Promise<PersistContainerStateResult> {\n  const { expectedStateWhenMissing, isCurrent, updateView = true } = options;\n  const persisted = await persistContainerMetadataStateFromRuntime({\n    metadataState: containerState,\n    localMetadataPatch: options.localMetadataPatch,\n    localUpdate: options.localUpdate,\n    patch: options.patch ?? {},\n    persistence: state.persistence,\n    createIntentSettlement: options.createIntentSettlement,\n    moveIntentSettlement: options.moveIntentSettlement,\n    preserveDurableStructureWhenPending:\n      options.preserveDurableStructureWhenPending,\n    runtime: state.runtime,\n    saveOptions: options.saveOptions,\n    stillCurrent: isCurrent,\n  });\n  if (isCurrent?.() === false) {\n    return { status: \"stale-generation\" };\n  }\n  if (!persisted) {\n    removeMissingContainerState(\n      state,\n      expectedStateWhenMissing ?? containerState,\n    );\n    return { status: \"missing\" };\n  }\n  containerState.container = persisted.container;\n  installContainerMetadataRecord(containerState, persisted.record);\n  if (persisted.mutationSuperseded || persisted.syncIdentitySuperseded) {\n    const cachedState = state.containersById.get(containerState.container.id);\n    if (cachedState && cachedState !== containerState) {\n      cachedState.container = containerState.container;\n      cachedState.doc = containerState.doc;\n      cachedState.metadataWriterProjection =\n        containerState.metadataWriterProjection;\n      installContainerMetadataRecord(cachedState, persisted.record);\n    }\n    // The requested structural mutation was not applied. Refresh from the\n    // authoritative state installed above, but make the caller fail explicitly\n    // so it cannot schedule sync or report the dropped mutation as successful.\n    updateContainerContentsSnapshot(state);\n    return { record: persisted.record, status: \"identity-superseded\" };\n  }\n  if (updateView) {\n    updateContainerContentsSnapshot(state);\n  }\n  return {\n    record: persisted.record,\n    status: \"persisted\",\n    ...(persisted.createIntentSettled\n      ? { createIntentSettled: true as const }\n      : {}),\n    ...(persisted.moveIntentSettled\n      ? { moveIntentSettled: true as const }\n      : {}),\n  };\n}\n"]}
+{"version":3,"file":"containerStatePersistence.js","sourceRoot":"","sources":["containerStatePersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  installContainerMetadataRecord,\n  persistContainerMetadataStateFromRuntime,\n} from \"../../../workflows/container-contents/metadata\";\nimport type { PersistContainerStateResult } from \"../../../workflows/container-contents/remoteHydration\";\nimport { updateContainerContentsSnapshot } from \"../state\";\nimport type { ContainerState } from \"../syncAgent\";\nimport type { ContainerContentsStoreState } from \"../types\";\nimport { removeMissingContainerState } from \"./missingContainerState\";\n\ntype MetadataPersistenceInput = Parameters<\n  typeof persistContainerMetadataStateFromRuntime\n>[0];\n\ninterface PersistContainerStateOptions\n  extends Pick<\n    MetadataPersistenceInput,\n    | \"acceptedPendingUpdateIds\"\n    | \"clearSyncFailure\"\n    | \"patch\"\n    | \"saveOptions\"\n    | \"localMetadataPatch\"\n    | \"localUpdate\"\n    | \"createIntentSettlement\"\n    | \"moveIntentSettlement\"\n    | \"preserveDurableStructureWhenPending\"\n  > {\n  expectedStateWhenMissing?: ContainerState | undefined;\n  isCurrent?: (() => boolean) | undefined;\n  updateView?: boolean | undefined;\n}\n\nexport async function persistContainerState(\n  state: ContainerContentsStoreState,\n  containerState: ContainerState,\n  options: PersistContainerStateOptions = {},\n): Promise<PersistContainerStateResult> {\n  const { expectedStateWhenMissing, isCurrent, updateView = true } = options;\n  const persisted = await persistContainerMetadataStateFromRuntime({\n    acceptedPendingUpdateIds: options.acceptedPendingUpdateIds,\n    clearSyncFailure: options.clearSyncFailure,\n    metadataState: containerState,\n    localMetadataPatch: options.localMetadataPatch,\n    localUpdate: options.localUpdate,\n    patch: options.patch ?? {},\n    persistence: state.persistence,\n    createIntentSettlement: options.createIntentSettlement,\n    moveIntentSettlement: options.moveIntentSettlement,\n    preserveDurableStructureWhenPending:\n      options.preserveDurableStructureWhenPending,\n    runtime: state.runtime,\n    saveOptions: options.saveOptions,\n    stillCurrent: isCurrent,\n  });\n  if (isCurrent?.() === false) {\n    return { status: \"stale-generation\" };\n  }\n  if (!persisted) {\n    removeMissingContainerState(\n      state,\n      expectedStateWhenMissing ?? containerState,\n    );\n    return { status: \"missing\" };\n  }\n  containerState.container = persisted.container;\n  installContainerMetadataRecord(containerState, persisted.record);\n  if (persisted.mutationSuperseded || persisted.syncIdentitySuperseded) {\n    const cachedState = state.containersById.get(containerState.container.id);\n    if (cachedState && cachedState !== containerState) {\n      cachedState.container = containerState.container;\n      cachedState.doc = containerState.doc;\n      cachedState.metadataWriterProjection =\n        containerState.metadataWriterProjection;\n      installContainerMetadataRecord(cachedState, persisted.record);\n    }\n    // The requested structural mutation was not applied. Refresh from the\n    // authoritative state installed above, but make the caller fail explicitly\n    // so it cannot schedule sync or report the dropped mutation as successful.\n    updateContainerContentsSnapshot(state);\n    return { record: persisted.record, status: \"identity-superseded\" };\n  }\n  if (updateView) {\n    updateContainerContentsSnapshot(state);\n  }\n  return {\n    record: persisted.record,\n    status: \"persisted\",\n    ...(persisted.createIntentSettled\n      ? { createIntentSettled: true as const }\n      : {}),\n    ...(persisted.moveIntentSettled\n      ? { moveIntentSettled: true as const }\n      : {}),\n  };\n}\n"]}

package/stores/container-contents/remoteEvents/remoteEventSync.js

@@ -26,7 +26,7 @@ export function handleContainerContentsRemoteEvents(input) {
     if (addedHydrationLane) {
         observeContainerBackgroundHydration(state, requestHydration());
     }
-    const metadataDocumentIds = listContainerMetadataDocumentUpdateIds(nextEvents, state.containersById.values(), state.locallyAcceptedMetadataUpdateIds);
+    const metadataDocumentIds = listContainerMetadataDocumentUpdateIds(nextEvents, state.containersById.values(), state.locallyAcceptedMetadataUpdateIds, state.plannedMetadataDocumentIds);
     for (const metadataDocumentId of metadataDocumentIds) {
         state.metadataDocumentIdsNeedingSync.add(metadataDocumentId);
         bumpMetadataSyncSeq(state.metadataSyncSignalSeqById, metadataDocumentId);

package/stores/container-contents/remoteEvents/remoteEventSync.js.map

@@ -1 +1 @@
-{"version":3,"file":"remoteEventSync.js","sourceRoot":"","sources":["remoteEventSync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uCAAuC,EACvC,sCAAsC,GACvC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;AACxG,OAAO,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,UAAU,mCAAmC,CAAC,KAInD;IACC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxD,4EAA4E;IAC5E,2EAA2E;IAC3E,uEAAuE;IACvE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1E,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACzD,2EAA2E;IAC3E,sDAAsD;IACtD,2BAA2B,CACzB,KAAK,EACL,sCAAsC,CAAC,UAAU,CAAC,CACnD,CAAC;IACF,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,uCAAuC,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,mCAAmC,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,mBAAmB,GAAG,sCAAsC,CAChE,UAAU,EACV,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,EAC7B,KAAK,CAAC,gCAAgC,CACvC,CAAC;IACF,KAAK,MAAM,kBAAkB,IAAI,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,8BAA8B,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC7D,mBAAmB,CAAC,KAAK,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC","sourcesContent":["import {\n  listContainerParentIdsForEventHydration,\n  listContainerProjectionInvalidationIds,\n} from \"../../../workflows/container-contents/containerEvents\";\nimport { listContainerMetadataDocumentUpdateIds } from \"../../../workflows/container-contents/metadata\";\nimport { observeContainerBackgroundHydration } from \"../hydration/backgroundHydration\";\nimport { bumpMetadataSyncSeq } from \"../syncAgent/metadataSyncSignal\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\nimport { invalidateCachedProjections } from \"./remoteEventProjectionInvalidation\";\n\nexport function handleContainerContentsRemoteEvents(input: {\n  requestHydration: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}): void {\n  const { requestHydration, scheduleSync, state } = input;\n  // Metadata events are classified through the initialized container records.\n  // Do not consume the cursor while a replacement database is still loading;\n  // initialization calls this handler again once those identities exist.\n  if (!state.initialized) {\n    return;\n  }\n  const nextEvents = state.runtime.state.events.slice(state.lastEventCount);\n  state.lastEventCount = state.runtime.state.events.length;\n  // A peer's grant, rekey, or recite changed a manifest this client's cached\n  // projections cite, without evicting this subscriber.\n  invalidateCachedProjections(\n    state,\n    listContainerProjectionInvalidationIds(nextEvents),\n  );\n  let addedHydrationLane = false;\n  for (const parentId of listContainerParentIdsForEventHydration(nextEvents)) {\n    if (!state.containerParentIdsNeedingHydration.has(parentId)) {\n      addedHydrationLane = true;\n    }\n    state.containerParentIdsNeedingHydration.add(parentId);\n  }\n  if (addedHydrationLane) {\n    observeContainerBackgroundHydration(state, requestHydration());\n  }\n\n  const metadataDocumentIds = listContainerMetadataDocumentUpdateIds(\n    nextEvents,\n    state.containersById.values(),\n    state.locallyAcceptedMetadataUpdateIds,\n  );\n  for (const metadataDocumentId of metadataDocumentIds) {\n    state.metadataDocumentIdsNeedingSync.add(metadataDocumentId);\n    bumpMetadataSyncSeq(state.metadataSyncSignalSeqById, metadataDocumentId);\n  }\n  if (metadataDocumentIds.length > 0) {\n    scheduleSync();\n  }\n}\n"]}
+{"version":3,"file":"remoteEventSync.js","sourceRoot":"","sources":["remoteEventSync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uCAAuC,EACvC,sCAAsC,GACvC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;AACxG,OAAO,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,UAAU,mCAAmC,CAAC,KAInD;IACC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxD,4EAA4E;IAC5E,2EAA2E;IAC3E,uEAAuE;IACvE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1E,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACzD,2EAA2E;IAC3E,sDAAsD;IACtD,2BAA2B,CACzB,KAAK,EACL,sCAAsC,CAAC,UAAU,CAAC,CACnD,CAAC;IACF,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,uCAAuC,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,mCAAmC,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,mBAAmB,GAAG,sCAAsC,CAChE,UAAU,EACV,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,EAC7B,KAAK,CAAC,gCAAgC,EACtC,KAAK,CAAC,0BAA0B,CACjC,CAAC;IACF,KAAK,MAAM,kBAAkB,IAAI,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,8BAA8B,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC7D,mBAAmB,CAAC,KAAK,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC","sourcesContent":["import {\n  listContainerParentIdsForEventHydration,\n  listContainerProjectionInvalidationIds,\n} from \"../../../workflows/container-contents/containerEvents\";\nimport { listContainerMetadataDocumentUpdateIds } from \"../../../workflows/container-contents/metadata\";\nimport { observeContainerBackgroundHydration } from \"../hydration/backgroundHydration\";\nimport { bumpMetadataSyncSeq } from \"../syncAgent/metadataSyncSignal\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\nimport { invalidateCachedProjections } from \"./remoteEventProjectionInvalidation\";\n\nexport function handleContainerContentsRemoteEvents(input: {\n  requestHydration: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}): void {\n  const { requestHydration, scheduleSync, state } = input;\n  // Metadata events are classified through the initialized container records.\n  // Do not consume the cursor while a replacement database is still loading;\n  // initialization calls this handler again once those identities exist.\n  if (!state.initialized) {\n    return;\n  }\n  const nextEvents = state.runtime.state.events.slice(state.lastEventCount);\n  state.lastEventCount = state.runtime.state.events.length;\n  // A peer's grant, rekey, or recite changed a manifest this client's cached\n  // projections cite, without evicting this subscriber.\n  invalidateCachedProjections(\n    state,\n    listContainerProjectionInvalidationIds(nextEvents),\n  );\n  let addedHydrationLane = false;\n  for (const parentId of listContainerParentIdsForEventHydration(nextEvents)) {\n    if (!state.containerParentIdsNeedingHydration.has(parentId)) {\n      addedHydrationLane = true;\n    }\n    state.containerParentIdsNeedingHydration.add(parentId);\n  }\n  if (addedHydrationLane) {\n    observeContainerBackgroundHydration(state, requestHydration());\n  }\n\n  const metadataDocumentIds = listContainerMetadataDocumentUpdateIds(\n    nextEvents,\n    state.containersById.values(),\n    state.locallyAcceptedMetadataUpdateIds,\n    state.plannedMetadataDocumentIds,\n  );\n  for (const metadataDocumentId of metadataDocumentIds) {\n    state.metadataDocumentIdsNeedingSync.add(metadataDocumentId);\n    bumpMetadataSyncSeq(state.metadataSyncSignalSeqById, metadataDocumentId);\n  }\n  if (metadataDocumentIds.length > 0) {\n    scheduleSync();\n  }\n}\n"]}

package/stores/container-contents/state.js

@@ -63,6 +63,7 @@ export function createContainerContentsStoreState(initialRuntime, persistence, l
         metadataDocumentIdsNeedingSync: new Set(),
         metadataSyncSignalSeqById: new Map(),
         persistence,
+        plannedMetadataDocumentIds: new Set(),
         remoteHydrationPromise: null,
         remoteHydrationGeneration: null,
         remoteHydrationStructuralGeneration: null,
@@ -118,6 +119,7 @@ function resetContainerContentsStore(state) {
     state.locallyAcceptedMetadataUpdateIds = new Set();
     state.metadataDocumentIdsNeedingSync = new Set();
     state.metadataSyncSignalSeqById = new Map();
+    state.plannedMetadataDocumentIds = new Set();
     state.rootLaneHydrated = false;
     state.writeChain = Promise.resolve(null);
     setContainerContentsSnapshot(state, {

package/stores/container-contents/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gDAAgD,EAChD,8CAA8C,GAC/C,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAUhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,SAAS,kBAAkB,CACzB,IAAgC,EAChC,KAAiC;IAEjC,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,sBAAsB,KAAK,KAAK,CAAC,sBAAsB;QAC5D,IAAI,CAAC,sBAAsB,KAAK,KAAK,CAAC,sBAAsB;QAC5D,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB;QACpD,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAC7B,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAkC,EAClC,KAAmC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACpC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CACL,SAAS,KAAK,SAAS;YACvB,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS;YAC1C,QAAQ,CAAC,oBAAoB,KAAK,SAAS,CAAC,oBAAoB;YAChE,QAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE;YAC5B,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAChC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAChC,QAAQ,CAAC,kBAAkB,KAAK,SAAS,CAAC,kBAAkB;YAC5D,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,aAAa;YAClD,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAChC,QAAQ,CAAC,cAAc,KAAK,SAAS,CAAC,cAAc;YACpD,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;YACxC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC;YAC3D,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU;YAC5C,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,CAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CACjC,eAA8C,EAC9C,WAA0C;IAE1C,yEAAyE;IACzE,gEAAgE;IAChE,OAAO,CACL,8BAA8B,CAAC,eAAe,EAAE,WAAW,CAAC;QAC5D,eAAe,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,KAAK,CAAC,MAAM;QACzD,eAAe,CAAC,KAAK,CAAC,SAAS,KAAK,WAAW,CAAC,KAAK,CAAC,SAAS;QAC/D,eAAe,CAAC,KAAK,CAAC,gCAAgC;YACpD,WAAW,CAAC,KAAK,CAAC,gCAAgC;QACpD,eAAe,CAAC,IAAI,CAAC,mBAAmB;YACtC,WAAW,CAAC,IAAI,CAAC,mBAAmB,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,cAA6C,EAC7C,WAAyC,EACzC,QAA6B;IAE7B,OAAO;QACL,cAAc,EAAE,IAAI,iBAAiB,EAAE;QACvC,kCAAkC,EAAE,IAAI,GAAG,EAAE;QAC7C,yBAAyB,EAAE,IAAI;QAC/B,oBAAoB,EAAE,IAAI;QAC1B,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,KAAK;QAClB,4BAA4B,EAAE,IAAI;QAClC,+BAA+B,EAAE,IAAI;QACrC,yCAAyC,EAAE,IAAI;QAC/C,0BAA0B,EAAE,KAAK;QACjC,mBAAmB,EAAE,CAAC;QACtB,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,gCAAgC,EAAE,IAAI,GAAG,EAAE;QAC3C,QAAQ;QACR,8BAA8B,EAAE,IAAI,GAAG,EAAE;QACzC,yBAAyB,EAAE,IAAI,GAAG,EAAE;QACpC,WAAW;QACX,sBAAsB,EAAE,IAAI;QAC5B,yBAAyB,EAAE,IAAI;QAC/B,mCAAmC,EAAE,IAAI;QACzC,6BAA6B,EAAE,KAAK;QACpC,wBAAwB,EACtB,gDAAgD,CAAC,cAAc,CAAC;QAClE,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,KAAK;SACb;QACD,QAAQ,EAAE,IAAI;QACd,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAuB,IAAI,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAkC;IACpE,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,KAAkC,EAClC,IAA+B;IAE/B,IACE,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,CAAC,KAAK;QACnC,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EACvD,CAAC;QACD,OAAO;IACT,CAAC;IAED,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACtB,0BAA0B,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAkC;IAElC,4BAA4B,CAAC,KAAK,EAAE;QAClC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC;QAC7C,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAkC;IACrE,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAC/B,KAAK,CAAC,cAAc,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC/C,KAAK,CAAC,kCAAkC,GAAG,IAAI,GAAG,EAAE,CAAC;IACrD,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;IAC1B,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC;IACzC,uEAAuE;IACvE,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;IACzB,oEAAoE;IACpE,yEAAyE;IACzE,2DAA2D;IAC3D,sDAAsD;IACtD,KAAK,CAAC,gCAAgC,GAAG,IAAI,GAAG,EAAE,CAAC;IACnD,KAAK,CAAC,8BAA8B,GAAG,IAAI,GAAG,EAAE,CAAC;IACjD,KAAK,CAAC,yBAAyB,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5C,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAC/B,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAuB,IAAI,CAAC,CAAC;IAC/D,4BAA4B,CAAC,KAAK,EAAE;QAClC,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAkC,EAClC,QAAoB;IAEpB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,KAAkC,EAClC,WAA0C,EAC1C,SAA0C;IAE1C,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC;IACtC,MAAM,eAAe,GAAG,0BAA0B,CAChD,eAAe,EACf,WAAW,CACZ,CAAC;IACF,IAAI,8BAA8B,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,gBAAgB,GACpB,eAAe,CAAC,KAAK,CAAC,OAAO,KAAK,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9D,MAAM,6BAA6B,GACjC,eAAe,CAAC,KAAK,CAAC,gCAAgC;QACtD,WAAW,CAAC,KAAK,CAAC,gCAAgC,CAAC;IACrD,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAChC,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,MAAM,cAAc,GAClB,eAAe,CAAC,IAAI,CAAC,cAAc,KAAK,WAAW,CAAC,IAAI,CAAC,cAAc;QACvE,eAAe,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;IACtE,IACE,8CAA8C,CAAC,eAAe,EAAE,WAAW,CAAC,EAC5E,CAAC;QACD,KAAK,CAAC,wBAAwB;YAC5B,gDAAgD,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,OAAO,GAAG,WAAW,CAAC;IAC5B,IAAI,6BAA6B,EAAE,CAAC;QAClC,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC7C,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACzE,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,uEAAuE;QACvE,wEAAwE;QACxE,+CAA+C;QAC/C,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACnC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAC9B,SAAS,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,wEAAwE;IACxE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,8BAA8B;IAC9B,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK;QACpB,CAAC,cAAc,IAAI,0BAA0B,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,EAC5E,CAAC;QACD,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC;QACvC,KAAK,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACxC,qEAAqE;QACrE,mEAAmE;QACnE,SAAS,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAE9B,SAAS,CAAC,kBAAkB,EAAE,CAAC;IAE/B,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACxC,SAAS,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;IAED,+CAA+C,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1E,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK;QACpB,0BAA0B,CAAC,eAAe,EAAE,WAAW,CAAC,EACxD,CAAC;QACD,2EAA2E;QAC3E,yEAAyE;QACzE,oEAAoE;QACpE,SAAS,CAAC,YAAY,EAAE,CAAC;QACzB,SAAS,CAAC,uBAAuB,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,KAGC,EACD,OAA+B;IAE/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,6BAA6B;QAAE,OAAO;IAC1E,KAAK,CAAC,6BAA6B,GAAG,KAAK,CAAC;IAC5C,KAAK,OAAO,EAAE,CAAC,IAAI,CACjB,CAAC,SAAS,EAAE,EAAE;QACZ,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC7D,CAAC,EACD,GAAG,EAAE;QACH,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC7C,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,KAAkC,EAClC,eAA6C,EAC7C,SAA0C;IAE1C,IAAI,KAAK,CAAC,WAAW,KAAK,eAAe,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC;IACpC,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;IAC3B,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACnC,SAAS,CAAC,iBAAiB,EAAE,CAAC;AAChC,CAAC","sourcesContent":["import type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport {\n  createContainerContentsProjectionUserKeyResolver,\n  didContainerContentsProjectionKeyRuntimeChange,\n} from \"../../workflows/container-contents/projectionKeys\";\nimport { didRegainSyncPrerequisites } from \"../../workflows/container-contents/syncLane\";\nimport { ContainerStateMap } from \"./containerState/containerStateMap\";\nimport { didContainerWriteRuntimeChange } from \"./remoteWrites/writeGeneration\";\nimport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncAgent,\n} from \"./syncAgent/syncAgentTypes\";\nimport type {\n  ContainerContentsSnapshot,\n  ContainerContentsStoreState,\n  ContainerNode,\n} from \"./types\";\nimport { getSnapshotNodes } from \"./utils\";\n\nfunction areSyncStatesEqual(\n  left: ContainerNode[\"syncState\"],\n  right: ContainerNode[\"syncState\"],\n): boolean {\n  return (\n    left.lastError === right.lastError &&\n    left.pendingAttachmentBytes === right.pendingAttachmentBytes &&\n    left.pendingAttachmentCount === right.pendingAttachmentCount &&\n    left.pendingUpdateCount === right.pendingUpdateCount &&\n    left.status === right.status\n  );\n}\n\nfunction areSnapshotNodesEqual(\n  left: ReadonlyArray<ContainerNode>,\n  right: ReadonlyArray<ContainerNode>,\n): boolean {\n  if (left.length !== right.length) {\n    return false;\n  }\n\n  return left.every((leftNode, index) => {\n    const rightNode = right[index];\n    return (\n      rightNode !== undefined &&\n      leftNode.createdAt === rightNode.createdAt &&\n      leftNode.effectiveAccessLevel === rightNode.effectiveAccessLevel &&\n      leftNode.id === rightNode.id &&\n      leftNode.icon === rightNode.icon &&\n      leftNode.kind === rightNode.kind &&\n      leftNode.metadataDocumentId === rightNode.metadataDocumentId &&\n      leftNode.metadataReady === rightNode.metadataReady &&\n      leftNode.name === rightNode.name &&\n      leftNode.organizationId === rightNode.organizationId &&\n      leftNode.parentId === rightNode.parentId &&\n      areSyncStatesEqual(leftNode.syncState, rightNode.syncState) &&\n      leftNode.systemSlot === rightNode.systemSlot &&\n      leftNode.updatedAt === rightNode.updatedAt\n    );\n  });\n}\n\nfunction didStructuralRuntimeChange(\n  previousRuntime: ContainerContentsStoreRuntime,\n  nextRuntime: ContainerContentsStoreRuntime,\n): boolean {\n  // Structural sync also depends on connectivity and event delivery. Local\n  // writes use only the identity and storage checks shared below.\n  return (\n    didContainerWriteRuntimeChange(previousRuntime, nextRuntime) ||\n    previousRuntime.state.online !== nextRuntime.state.online ||\n    previousRuntime.state.peerScope !== nextRuntime.state.peerScope ||\n    previousRuntime.state.serverEventsConnectionGeneration !==\n      nextRuntime.state.serverEventsConnectionGeneration ||\n    previousRuntime.util.isRemoteSyncBlocked !==\n      nextRuntime.util.isRemoteSyncBlocked\n  );\n}\n\nexport function createContainerContentsStoreState(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence,\n  logLabel?: string | undefined,\n): ContainerContentsStoreState {\n  return {\n    containersById: new ContainerStateMap(),\n    containerParentIdsNeedingHydration: new Set(),\n    documentStoresNeedPriming: true,\n    initializeGeneration: null,\n    initializePromise: null,\n    initialized: false,\n    localContainerRefreshPromise: null,\n    localContainerRefreshGeneration: null,\n    localContainerRefreshStructuralGeneration: null,\n    localContainersNeedRefresh: false,\n    lifecycleGeneration: 0,\n    lastEventCount: 0,\n    listeners: new Set(),\n    locallyAcceptedMetadataUpdateIds: new Set(),\n    logLabel,\n    metadataDocumentIdsNeedingSync: new Set(),\n    metadataSyncSignalSeqById: new Map(),\n    persistence,\n    remoteHydrationPromise: null,\n    remoteHydrationGeneration: null,\n    remoteHydrationStructuralGeneration: null,\n    remoteReconnectRefreshPending: false,\n    resolveProjectionUserKey:\n      createContainerContentsProjectionUserKeyResolver(initialRuntime),\n    rootLaneHydrated: false,\n    runtime: initialRuntime,\n    snapshot: {\n      nodes: [],\n      ready: false,\n    },\n    syncLane: null,\n    structuralGeneration: 0,\n    writeGeneration: 0,\n    writeChain: Promise.resolve<ContainerNode | null>(null),\n  };\n}\n\nfunction emitContainerContentsStore(state: ContainerContentsStoreState) {\n  for (const listener of state.listeners) {\n    listener();\n  }\n}\n\nfunction setContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n  next: ContainerContentsSnapshot,\n) {\n  if (\n    next.ready === state.snapshot.ready &&\n    areSnapshotNodesEqual(next.nodes, state.snapshot.nodes)\n  ) {\n    return;\n  }\n\n  state.snapshot = next;\n  emitContainerContentsStore(state);\n}\n\nexport function updateContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n) {\n  setContainerContentsSnapshot(state, {\n    nodes: getSnapshotNodes(state.containersById),\n    ready: true,\n  });\n}\n\nfunction resetContainerContentsStore(state: ContainerContentsStoreState) {\n  state.lifecycleGeneration += 1;\n  state.containersById = new ContainerStateMap();\n  state.containerParentIdsNeedingHydration = new Set();\n  state.documentStoresNeedPriming = true;\n  state.initialized = false;\n  state.localContainersNeedRefresh = false;\n  // Runtime events are snapshots, not a destructive queue. A replacement\n  // executor or persistence adapter has not observed any of them, even when\n  // their effects were already applied to the previous database. Replay the\n  // snapshot after replacement initialization rebuilds metadata identities.\n  state.lastEventCount = 0;\n  // Accepted-echo suppression state must not survive a reset: after a\n  // database loss the tree rehydrates from remote, and a retained id would\n  // suppress the next matching remote update signal. Mirrors\n  // clearDocumentStoreState in the document store lane.\n  state.locallyAcceptedMetadataUpdateIds = new Set();\n  state.metadataDocumentIdsNeedingSync = new Set();\n  state.metadataSyncSignalSeqById = new Map();\n  state.rootLaneHydrated = false;\n  state.writeChain = Promise.resolve<ContainerNode | null>(null);\n  setContainerContentsSnapshot(state, {\n    nodes: [],\n    ready: false,\n  });\n}\n\nexport function subscribeToContainerContentsStore(\n  state: ContainerContentsStoreState,\n  listener: () => void,\n) {\n  state.listeners.add(listener);\n  return () => state.listeners.delete(listener);\n}\n\nexport function updateContainerContentsStoreRuntime(\n  state: ContainerContentsStoreState,\n  nextRuntime: ContainerContentsStoreRuntime,\n  syncAgent: ContainerContentsStoreSyncAgent,\n) {\n  const previousRuntime = state.runtime;\n  const runtimeReplaced = didStructuralRuntimeChange(\n    previousRuntime,\n    nextRuntime,\n  );\n  if (didContainerWriteRuntimeChange(previousRuntime, nextRuntime)) {\n    state.writeGeneration += 1;\n  }\n  const executorReplaced =\n    previousRuntime.infra.execSql !== nextRuntime.infra.execSql;\n  const serverEventsConnectionChanged =\n    previousRuntime.state.serverEventsConnectionGeneration !==\n    nextRuntime.state.serverEventsConnectionGeneration;\n  if (runtimeReplaced) {\n    state.structuralGeneration += 1;\n    state.localContainersNeedRefresh = true;\n  }\n  const contextChanged =\n    previousRuntime.auth.organizationId !== nextRuntime.auth.organizationId ||\n    previousRuntime.state.containerId !== nextRuntime.state.containerId;\n  if (\n    didContainerContentsProjectionKeyRuntimeChange(previousRuntime, nextRuntime)\n  ) {\n    state.resolveProjectionUserKey =\n      createContainerContentsProjectionUserKeyResolver(nextRuntime);\n  }\n  state.runtime = nextRuntime;\n  if (serverEventsConnectionChanged) {\n    state.remoteReconnectRefreshPending = true;\n  }\n\n  if (nextRuntime.infra.dbStatus !== \"ready\") {\n    if (state.snapshot.ready || state.initialized || state.initializePromise) {\n      resetContainerContentsStore(state);\n    }\n    return;\n  }\n\n  if (executorReplaced) {\n    // The in-memory tree and lane markers belong to the previous executor.\n    // Rebuild them from the replacement database before any remote sync can\n    // observe or persist the old database's state.\n    resetContainerContentsStore(state);\n    syncAgent.ensureInitialized();\n    syncAgent.handleRemoteEvents();\n    return;\n  }\n\n  // Gaining authentication within a domain scope does not change identity\n  // (the scope is keyed on the signing fingerprint), so the locally-loaded\n  // tree stays valid. Reconcile it in place instead of resetting — resetting\n  // here is what blanked Explorer and forced a re-read on first open after\n  // register. Identity/storage changes are handled by scope rotation and the\n  // dbStatus-loss branch above.\n  if (\n    state.snapshot.ready &&\n    (contextChanged || didRegainSyncPrerequisites(previousRuntime, nextRuntime))\n  ) {\n    state.localContainersNeedRefresh = true;\n    state.documentStoresNeedPriming = true;\n    void syncAgent.refreshLocalContainers();\n    // The refresh alone does not run the sync lane; schedule it so newly\n    // eligible documents (e.g. this organization's orphans) prime now.\n    syncAgent.scheduleSync();\n  }\n\n  syncAgent.ensureInitialized();\n\n  syncAgent.handleRemoteEvents();\n\n  if (runtimeReplaced) {\n    void syncAgent.refreshLocalContainers();\n    syncAgent.scheduleSync();\n  }\n\n  consumePendingContainerContentsReconnectRefresh(state, syncAgent.refresh);\n\n  if (\n    state.snapshot.ready &&\n    didRegainSyncPrerequisites(previousRuntime, nextRuntime)\n  ) {\n    // A pass blocked by missing prerequisites consumes its lane request before\n    // returning early. Re-arm it directly when they return even if hydration\n    // finds no remote delta; this also primes unopened document stores.\n    syncAgent.scheduleSync();\n    syncAgent.scheduleRemoteHydration();\n  }\n}\n\nexport function consumePendingContainerContentsReconnectRefresh(\n  state: {\n    remoteReconnectRefreshPending: boolean;\n    snapshot: { ready: boolean };\n  },\n  refresh: () => Promise<boolean>,\n): void {\n  if (!state.snapshot.ready || !state.remoteReconnectRefreshPending) return;\n  state.remoteReconnectRefreshPending = false;\n  void refresh().then(\n    (refreshed) => {\n      if (!refreshed) state.remoteReconnectRefreshPending = true;\n    },\n    () => {\n      state.remoteReconnectRefreshPending = true;\n    },\n  );\n}\n\nexport function updateContainerContentsStorePersistence(\n  state: ContainerContentsStoreState,\n  nextPersistence: ContainerContentsPersistence,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): void {\n  if (state.persistence === nextPersistence) {\n    return;\n  }\n  state.persistence = nextPersistence;\n  state.structuralGeneration += 1;\n  state.writeGeneration += 1;\n  // Persistence replacement changes the authoritative local data source even\n  // when the SQLite executor itself is stable. Clear storage-backed state and\n  // let initialization load the replacement before scheduling remote work.\n  resetContainerContentsStore(state);\n  syncAgent.ensureInitialized();\n}\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport {\n  createContainerContentsProjectionUserKeyResolver,\n  didContainerContentsProjectionKeyRuntimeChange,\n} from \"../../workflows/container-contents/projectionKeys\";\nimport { didRegainSyncPrerequisites } from \"../../workflows/container-contents/syncLane\";\nimport { ContainerStateMap } from \"./containerState/containerStateMap\";\nimport { didContainerWriteRuntimeChange } from \"./remoteWrites/writeGeneration\";\nimport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncAgent,\n} from \"./syncAgent/syncAgentTypes\";\nimport type {\n  ContainerContentsSnapshot,\n  ContainerContentsStoreState,\n  ContainerNode,\n} from \"./types\";\nimport { getSnapshotNodes } from \"./utils\";\n\nfunction areSyncStatesEqual(\n  left: ContainerNode[\"syncState\"],\n  right: ContainerNode[\"syncState\"],\n): boolean {\n  return (\n    left.lastError === right.lastError &&\n    left.pendingAttachmentBytes === right.pendingAttachmentBytes &&\n    left.pendingAttachmentCount === right.pendingAttachmentCount &&\n    left.pendingUpdateCount === right.pendingUpdateCount &&\n    left.status === right.status\n  );\n}\n\nfunction areSnapshotNodesEqual(\n  left: ReadonlyArray<ContainerNode>,\n  right: ReadonlyArray<ContainerNode>,\n): boolean {\n  if (left.length !== right.length) {\n    return false;\n  }\n\n  return left.every((leftNode, index) => {\n    const rightNode = right[index];\n    return (\n      rightNode !== undefined &&\n      leftNode.createdAt === rightNode.createdAt &&\n      leftNode.effectiveAccessLevel === rightNode.effectiveAccessLevel &&\n      leftNode.id === rightNode.id &&\n      leftNode.icon === rightNode.icon &&\n      leftNode.kind === rightNode.kind &&\n      leftNode.metadataDocumentId === rightNode.metadataDocumentId &&\n      leftNode.metadataReady === rightNode.metadataReady &&\n      leftNode.name === rightNode.name &&\n      leftNode.organizationId === rightNode.organizationId &&\n      leftNode.parentId === rightNode.parentId &&\n      areSyncStatesEqual(leftNode.syncState, rightNode.syncState) &&\n      leftNode.systemSlot === rightNode.systemSlot &&\n      leftNode.updatedAt === rightNode.updatedAt\n    );\n  });\n}\n\nfunction didStructuralRuntimeChange(\n  previousRuntime: ContainerContentsStoreRuntime,\n  nextRuntime: ContainerContentsStoreRuntime,\n): boolean {\n  // Structural sync also depends on connectivity and event delivery. Local\n  // writes use only the identity and storage checks shared below.\n  return (\n    didContainerWriteRuntimeChange(previousRuntime, nextRuntime) ||\n    previousRuntime.state.online !== nextRuntime.state.online ||\n    previousRuntime.state.peerScope !== nextRuntime.state.peerScope ||\n    previousRuntime.state.serverEventsConnectionGeneration !==\n      nextRuntime.state.serverEventsConnectionGeneration ||\n    previousRuntime.util.isRemoteSyncBlocked !==\n      nextRuntime.util.isRemoteSyncBlocked\n  );\n}\n\nexport function createContainerContentsStoreState(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence,\n  logLabel?: string | undefined,\n): ContainerContentsStoreState {\n  return {\n    containersById: new ContainerStateMap(),\n    containerParentIdsNeedingHydration: new Set(),\n    documentStoresNeedPriming: true,\n    initializeGeneration: null,\n    initializePromise: null,\n    initialized: false,\n    localContainerRefreshPromise: null,\n    localContainerRefreshGeneration: null,\n    localContainerRefreshStructuralGeneration: null,\n    localContainersNeedRefresh: false,\n    lifecycleGeneration: 0,\n    lastEventCount: 0,\n    listeners: new Set(),\n    locallyAcceptedMetadataUpdateIds: new Set(),\n    logLabel,\n    metadataDocumentIdsNeedingSync: new Set(),\n    metadataSyncSignalSeqById: new Map(),\n    persistence,\n    plannedMetadataDocumentIds: new Set(),\n    remoteHydrationPromise: null,\n    remoteHydrationGeneration: null,\n    remoteHydrationStructuralGeneration: null,\n    remoteReconnectRefreshPending: false,\n    resolveProjectionUserKey:\n      createContainerContentsProjectionUserKeyResolver(initialRuntime),\n    rootLaneHydrated: false,\n    runtime: initialRuntime,\n    snapshot: {\n      nodes: [],\n      ready: false,\n    },\n    syncLane: null,\n    structuralGeneration: 0,\n    writeGeneration: 0,\n    writeChain: Promise.resolve<ContainerNode | null>(null),\n  };\n}\n\nfunction emitContainerContentsStore(state: ContainerContentsStoreState) {\n  for (const listener of state.listeners) {\n    listener();\n  }\n}\n\nfunction setContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n  next: ContainerContentsSnapshot,\n) {\n  if (\n    next.ready === state.snapshot.ready &&\n    areSnapshotNodesEqual(next.nodes, state.snapshot.nodes)\n  ) {\n    return;\n  }\n\n  state.snapshot = next;\n  emitContainerContentsStore(state);\n}\n\nexport function updateContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n) {\n  setContainerContentsSnapshot(state, {\n    nodes: getSnapshotNodes(state.containersById),\n    ready: true,\n  });\n}\n\nfunction resetContainerContentsStore(state: ContainerContentsStoreState) {\n  state.lifecycleGeneration += 1;\n  state.containersById = new ContainerStateMap();\n  state.containerParentIdsNeedingHydration = new Set();\n  state.documentStoresNeedPriming = true;\n  state.initialized = false;\n  state.localContainersNeedRefresh = false;\n  // Runtime events are snapshots, not a destructive queue. A replacement\n  // executor or persistence adapter has not observed any of them, even when\n  // their effects were already applied to the previous database. Replay the\n  // snapshot after replacement initialization rebuilds metadata identities.\n  state.lastEventCount = 0;\n  // Accepted-echo suppression state must not survive a reset: after a\n  // database loss the tree rehydrates from remote, and a retained id would\n  // suppress the next matching remote update signal. Mirrors\n  // clearDocumentStoreState in the document store lane.\n  state.locallyAcceptedMetadataUpdateIds = new Set();\n  state.metadataDocumentIdsNeedingSync = new Set();\n  state.metadataSyncSignalSeqById = new Map();\n  state.plannedMetadataDocumentIds = new Set();\n  state.rootLaneHydrated = false;\n  state.writeChain = Promise.resolve<ContainerNode | null>(null);\n  setContainerContentsSnapshot(state, {\n    nodes: [],\n    ready: false,\n  });\n}\n\nexport function subscribeToContainerContentsStore(\n  state: ContainerContentsStoreState,\n  listener: () => void,\n) {\n  state.listeners.add(listener);\n  return () => state.listeners.delete(listener);\n}\n\nexport function updateContainerContentsStoreRuntime(\n  state: ContainerContentsStoreState,\n  nextRuntime: ContainerContentsStoreRuntime,\n  syncAgent: ContainerContentsStoreSyncAgent,\n) {\n  const previousRuntime = state.runtime;\n  const runtimeReplaced = didStructuralRuntimeChange(\n    previousRuntime,\n    nextRuntime,\n  );\n  if (didContainerWriteRuntimeChange(previousRuntime, nextRuntime)) {\n    state.writeGeneration += 1;\n  }\n  const executorReplaced =\n    previousRuntime.infra.execSql !== nextRuntime.infra.execSql;\n  const serverEventsConnectionChanged =\n    previousRuntime.state.serverEventsConnectionGeneration !==\n    nextRuntime.state.serverEventsConnectionGeneration;\n  if (runtimeReplaced) {\n    state.structuralGeneration += 1;\n    state.localContainersNeedRefresh = true;\n  }\n  const contextChanged =\n    previousRuntime.auth.organizationId !== nextRuntime.auth.organizationId ||\n    previousRuntime.state.containerId !== nextRuntime.state.containerId;\n  if (\n    didContainerContentsProjectionKeyRuntimeChange(previousRuntime, nextRuntime)\n  ) {\n    state.resolveProjectionUserKey =\n      createContainerContentsProjectionUserKeyResolver(nextRuntime);\n  }\n  state.runtime = nextRuntime;\n  if (serverEventsConnectionChanged) {\n    state.remoteReconnectRefreshPending = true;\n  }\n\n  if (nextRuntime.infra.dbStatus !== \"ready\") {\n    if (state.snapshot.ready || state.initialized || state.initializePromise) {\n      resetContainerContentsStore(state);\n    }\n    return;\n  }\n\n  if (executorReplaced) {\n    // The in-memory tree and lane markers belong to the previous executor.\n    // Rebuild them from the replacement database before any remote sync can\n    // observe or persist the old database's state.\n    resetContainerContentsStore(state);\n    syncAgent.ensureInitialized();\n    syncAgent.handleRemoteEvents();\n    return;\n  }\n\n  // Gaining authentication within a domain scope does not change identity\n  // (the scope is keyed on the signing fingerprint), so the locally-loaded\n  // tree stays valid. Reconcile it in place instead of resetting — resetting\n  // here is what blanked Explorer and forced a re-read on first open after\n  // register. Identity/storage changes are handled by scope rotation and the\n  // dbStatus-loss branch above.\n  if (\n    state.snapshot.ready &&\n    (contextChanged || didRegainSyncPrerequisites(previousRuntime, nextRuntime))\n  ) {\n    state.localContainersNeedRefresh = true;\n    state.documentStoresNeedPriming = true;\n    void syncAgent.refreshLocalContainers();\n    // The refresh alone does not run the sync lane; schedule it so newly\n    // eligible documents (e.g. this organization's orphans) prime now.\n    syncAgent.scheduleSync();\n  }\n\n  syncAgent.ensureInitialized();\n\n  syncAgent.handleRemoteEvents();\n\n  if (runtimeReplaced) {\n    void syncAgent.refreshLocalContainers();\n    syncAgent.scheduleSync();\n  }\n\n  consumePendingContainerContentsReconnectRefresh(state, syncAgent.refresh);\n\n  if (\n    state.snapshot.ready &&\n    didRegainSyncPrerequisites(previousRuntime, nextRuntime)\n  ) {\n    // A pass blocked by missing prerequisites consumes its lane request before\n    // returning early. Re-arm it directly when they return even if hydration\n    // finds no remote delta; this also primes unopened document stores.\n    syncAgent.scheduleSync();\n    syncAgent.scheduleRemoteHydration();\n  }\n}\n\nexport function consumePendingContainerContentsReconnectRefresh(\n  state: {\n    remoteReconnectRefreshPending: boolean;\n    snapshot: { ready: boolean };\n  },\n  refresh: () => Promise<boolean>,\n): void {\n  if (!state.snapshot.ready || !state.remoteReconnectRefreshPending) return;\n  state.remoteReconnectRefreshPending = false;\n  void refresh().then(\n    (refreshed) => {\n      if (!refreshed) state.remoteReconnectRefreshPending = true;\n    },\n    () => {\n      state.remoteReconnectRefreshPending = true;\n    },\n  );\n}\n\nexport function updateContainerContentsStorePersistence(\n  state: ContainerContentsStoreState,\n  nextPersistence: ContainerContentsPersistence,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): void {\n  if (state.persistence === nextPersistence) {\n    return;\n  }\n  state.persistence = nextPersistence;\n  state.structuralGeneration += 1;\n  state.writeGeneration += 1;\n  // Persistence replacement changes the authoritative local data source even\n  // when the SQLite executor itself is stable. Clear storage-backed state and\n  // let initialization load the replacement before scheduling remote work.\n  resetContainerContentsStore(state);\n  syncAgent.ensureInitialized();\n}\n"]}

package/stores/container-contents/syncAgent/syncAgentTypes.d.ts

@@ -64,6 +64,11 @@ export interface ContainerContentsStoreSyncState {
      * `clearMetadataSyncQueueIfUnchanged`.
      */
     metadataSyncSignalSeqById: Map<string, number>;
+    /**
+     * Metadata document ids of folder creates in flight. A remote hint for one
+     * queues the folder's first read before the create response installs the id.
+     */
+    plannedMetadataDocumentIds: Set<string>;
     containerParentIdsNeedingHydration: Set<string | null>;
     persistence: ContainerContentsPersistence;
     remoteHydrationPromise: Promise<void> | null;

package/stores/container-contents/syncAgent/syncAgentTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"syncAgentTypes.js","sourceRoot":"","sources":["syncAgentTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { ContainerContentsPersistence } from \"../../../workflows/container-contents/containerPersistence\";\nimport type { ContainerContentsProjectionUserKeyResolver } from \"../../../workflows/container-contents/projectionKeys\";\nimport type {\n  ContainerState,\n  RemoteContainer,\n} from \"../../../workflows/container-contents/remoteHydration\";\nimport type { ContainerContentsStoreWorkflowRuntime } from \"../../../workflows/container-contents/runtime\";\nimport type { ContainerContentsSyncLane } from \"../../../workflows/container-contents/syncLane\";\n\nexport type ContainerContentsStoreRuntime =\n  ContainerContentsStoreWorkflowRuntime;\n\nexport interface RefreshRootLaneOptions {\n  readonly includeActiveRootChildLane?: boolean | undefined;\n  // Extra parent lanes to re-list alongside the root lane. Used by the\n  // resync_required handler to re-list affected containers' parent lanes so a\n  // tombstone only visible there is still applied without the full crawl.\n  readonly parentIds?: ReadonlyArray<string | null> | undefined;\n}\n\nexport interface ContainerContentsStoreSyncAgent {\n  ensureInitialized: () => void;\n  handleRemoteEvents: () => void;\n  ingestRemoteContainer: (remoteContainer: RemoteContainer) => Promise<void>;\n  primeDocumentsForSharedSubtree: (\n    rootContainerId: string,\n    isCurrent?: (() => boolean) | undefined,\n  ) => Promise<void>;\n  refreshLocalContainers: () => Promise<void>;\n  refresh: (options?: { resetAllLaneWatermarks?: boolean }) => Promise<boolean>;\n  refreshRootLane: (options?: RefreshRootLaneOptions) => Promise<boolean>;\n  requestRemoteHydration: (options?: {\n    followDiscoveredParentLanes?: boolean | undefined;\n    parentIds?: ReadonlyArray<string | null> | undefined;\n    resetAllLaneWatermarks?: boolean | undefined;\n  }) => Promise<void>;\n  scheduleRemoteHydration: () => void;\n  scheduleSync: () => void;\n}\n\nexport interface ContainerContentsStoreSyncState {\n  containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  initializeGeneration: number | null;\n  initializePromise: Promise<void> | null;\n  initialized: boolean;\n  localContainerRefreshPromise: Promise<void> | null;\n  localContainerRefreshGeneration: number | null;\n  localContainerRefreshStructuralGeneration: number | null;\n  localContainersNeedRefresh: boolean;\n  /** Invalidates asynchronous hydration work when this store is reset. */\n  lifecycleGeneration: number;\n  /** Invalidates structural work when its runtime or persistence is replaced. */\n  structuralGeneration: number;\n  /** Invalidates writes across write-relevant runtime ABA transitions. */\n  writeGeneration: number;\n  lastEventCount: number;\n  /**\n   * Update ids this client sent for container metadata documents, registered\n   * before the network await of each metadata sync pass. The author's own\n   * `document_update_created` echo consumes its ids here instead of arming a\n   * redundant forced read-sync; a genuine peer update always carries unknown\n   * ids and still forces one. Shared across all metadata docs in the store —\n   * update ids are globally unique.\n   */\n  locallyAcceptedMetadataUpdateIds: Set<string>;\n  logLabel?: string | undefined;\n  metadataDocumentIdsNeedingSync: Set<string>;\n  /**\n   * Per-metadata-document enqueue sequence. Bumped for a specific id whenever a\n   * remote event re-queues it in {@link metadataDocumentIdsNeedingSync}. A sync\n   * pass snapshots the id's sequence before its GET and only clears the id if it\n   * is unchanged at pass end, so a mid-pass re-queue of THIS container is not\n   * erased. Keyed per id (not a single global counter) so a remote event for an\n   * unrelated container does not force a redundant re-sync of this one. See\n   * `clearMetadataSyncQueueIfUnchanged`.\n   */\n  metadataSyncSignalSeqById: Map<string, number>;\n  containerParentIdsNeedingHydration: Set<string | null>;\n  persistence: ContainerContentsPersistence;\n  remoteHydrationPromise: Promise<void> | null;\n  remoteHydrationGeneration: number | null;\n  remoteHydrationStructuralGeneration: number | null;\n  remoteReconnectRefreshPending: boolean;\n  resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;\n  /** True after this store has fully applied an authoritative root lane. */\n  rootLaneHydrated: boolean;\n  runtime: ContainerContentsStoreRuntime;\n  snapshot: { ready: boolean };\n  syncLane: ContainerContentsSyncLane | null;\n}\n"]}
+{"version":3,"file":"syncAgentTypes.js","sourceRoot":"","sources":["syncAgentTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { ContainerContentsPersistence } from \"../../../workflows/container-contents/containerPersistence\";\nimport type { ContainerContentsProjectionUserKeyResolver } from \"../../../workflows/container-contents/projectionKeys\";\nimport type {\n  ContainerState,\n  RemoteContainer,\n} from \"../../../workflows/container-contents/remoteHydration\";\nimport type { ContainerContentsStoreWorkflowRuntime } from \"../../../workflows/container-contents/runtime\";\nimport type { ContainerContentsSyncLane } from \"../../../workflows/container-contents/syncLane\";\n\nexport type ContainerContentsStoreRuntime =\n  ContainerContentsStoreWorkflowRuntime;\n\nexport interface RefreshRootLaneOptions {\n  readonly includeActiveRootChildLane?: boolean | undefined;\n  // Extra parent lanes to re-list alongside the root lane. Used by the\n  // resync_required handler to re-list affected containers' parent lanes so a\n  // tombstone only visible there is still applied without the full crawl.\n  readonly parentIds?: ReadonlyArray<string | null> | undefined;\n}\n\nexport interface ContainerContentsStoreSyncAgent {\n  ensureInitialized: () => void;\n  handleRemoteEvents: () => void;\n  ingestRemoteContainer: (remoteContainer: RemoteContainer) => Promise<void>;\n  primeDocumentsForSharedSubtree: (\n    rootContainerId: string,\n    isCurrent?: (() => boolean) | undefined,\n  ) => Promise<void>;\n  refreshLocalContainers: () => Promise<void>;\n  refresh: (options?: { resetAllLaneWatermarks?: boolean }) => Promise<boolean>;\n  refreshRootLane: (options?: RefreshRootLaneOptions) => Promise<boolean>;\n  requestRemoteHydration: (options?: {\n    followDiscoveredParentLanes?: boolean | undefined;\n    parentIds?: ReadonlyArray<string | null> | undefined;\n    resetAllLaneWatermarks?: boolean | undefined;\n  }) => Promise<void>;\n  scheduleRemoteHydration: () => void;\n  scheduleSync: () => void;\n}\n\nexport interface ContainerContentsStoreSyncState {\n  containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  initializeGeneration: number | null;\n  initializePromise: Promise<void> | null;\n  initialized: boolean;\n  localContainerRefreshPromise: Promise<void> | null;\n  localContainerRefreshGeneration: number | null;\n  localContainerRefreshStructuralGeneration: number | null;\n  localContainersNeedRefresh: boolean;\n  /** Invalidates asynchronous hydration work when this store is reset. */\n  lifecycleGeneration: number;\n  /** Invalidates structural work when its runtime or persistence is replaced. */\n  structuralGeneration: number;\n  /** Invalidates writes across write-relevant runtime ABA transitions. */\n  writeGeneration: number;\n  lastEventCount: number;\n  /**\n   * Update ids this client sent for container metadata documents, registered\n   * before the network await of each metadata sync pass. The author's own\n   * `document_update_created` echo consumes its ids here instead of arming a\n   * redundant forced read-sync; a genuine peer update always carries unknown\n   * ids and still forces one. Shared across all metadata docs in the store —\n   * update ids are globally unique.\n   */\n  locallyAcceptedMetadataUpdateIds: Set<string>;\n  logLabel?: string | undefined;\n  metadataDocumentIdsNeedingSync: Set<string>;\n  /**\n   * Per-metadata-document enqueue sequence. Bumped for a specific id whenever a\n   * remote event re-queues it in {@link metadataDocumentIdsNeedingSync}. A sync\n   * pass snapshots the id's sequence before its GET and only clears the id if it\n   * is unchanged at pass end, so a mid-pass re-queue of THIS container is not\n   * erased. Keyed per id (not a single global counter) so a remote event for an\n   * unrelated container does not force a redundant re-sync of this one. See\n   * `clearMetadataSyncQueueIfUnchanged`.\n   */\n  metadataSyncSignalSeqById: Map<string, number>;\n  /**\n   * Metadata document ids of folder creates in flight. A remote hint for one\n   * queues the folder's first read before the create response installs the id.\n   */\n  plannedMetadataDocumentIds: Set<string>;\n  containerParentIdsNeedingHydration: Set<string | null>;\n  persistence: ContainerContentsPersistence;\n  remoteHydrationPromise: Promise<void> | null;\n  remoteHydrationGeneration: number | null;\n  remoteHydrationStructuralGeneration: number | null;\n  remoteReconnectRefreshPending: boolean;\n  resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;\n  /** True after this store has fully applied an authoritative root lane. */\n  rootLaneHydrated: boolean;\n  runtime: ContainerContentsStoreRuntime;\n  snapshot: { ready: boolean };\n  syncLane: ContainerContentsSyncLane | null;\n}\n"]}

package/stores/documents/documentStore/sync/createdDocumentPersistence.js

@@ -0,0 +1,71 @@
+import { mergeVersionVectors } from "../../../../internal/loro/index.js";
+import { persistDocument } from "../persistence.js";
+/**
+ * How a create that committed `seedUpdate` settles it: the row is accepted,
+ * the commit position is the one its first sync would have recorded, and the
+ * outgoing marker and frontier advance over it as the coverage pass would
+ * have (see `prepareDocumentOutgoingCoverage`). Null when the create did not
+ * commit the seed (a plain fallback or an adoption): the row stays queued and
+ * syncs as before.
+ */
+function committedSeedSettlement(input) {
+    const { seedUpdate } = input;
+    const seed = input.created.response?.initialSync;
+    if (!seedUpdate ||
+        input.pendingBaseVersion === null ||
+        !seed?.acceptedOutgoingUpdateIds.includes(seedUpdate.id)) {
+        return null;
+    }
+    const baseVersion = mergeVersionVectors([
+        input.pendingBaseVersion,
+        seedUpdate.partialEndVersionVector,
+    ]);
+    const liveFrontier = input.liveRecord?.snapshotEndVersion ?? "";
+    return {
+        baseVersion,
+        options: {
+            acceptedPendingUpdateIds: [seedUpdate.id],
+            clearSyncFailure: true,
+            pendingBaseVersionOverride: baseVersion,
+        },
+        patch: {
+            lastCommitLsn: seed.commitLsn,
+            snapshotEndVersion: mergeVersionVectors([
+                ...(liveFrontier.length > 0 ? [liveFrontier] : []),
+                baseVersion,
+            ]),
+        },
+    };
+}
+/**
+ * Persists a just-created remote identity (documentId and content keys), and
+ * settles the create's seed when it committed. Preserves the optimistic
+ * snapshot fields: the user may have kept typing during the round trip.
+ */
+export async function persistCreatedRemoteDocument(input) {
+    const { state } = input;
+    const settlement = committedSeedSettlement({
+        created: input.created,
+        liveRecord: state.record,
+        pendingBaseVersion: state.pendingBaseVersion,
+        seedUpdate: input.seed?.update,
+    });
+    const persisted = await persistDocument(state, input.currentDoc, { ...input.created.persistedState, ...settlement?.patch }, {
+        ...settlement?.options,
+        preserveSnapshotStructuredFields: true,
+        preserveSnapshotText: true,
+    }, input.generation);
+    if (persisted && settlement) {
+        // As the coverage pass does: merge, so a concurrent local write that
+        // advanced the in-memory marker is never moved backwards.
+        if (state.pendingBaseVersion !== null) {
+            state.pendingBaseVersion = mergeVersionVectors([
+                state.pendingBaseVersion,
+                settlement.baseVersion,
+            ]);
+        }
+        input.seed?.onCommitted();
+    }
+    return persisted;
+}
+//# sourceMappingURL=createdDocumentPersistence.js.map

package/stores/documents/documentStore/sync/createdDocumentPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createdDocumentPersistence.js","sourceRoot":"","sources":["createdDocumentPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAMtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAmBjD;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAAC,KAKhC;IAKC,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC;IACjD,IACE,CAAC,UAAU;QACX,KAAK,CAAC,kBAAkB,KAAK,IAAI;QACjC,CAAC,IAAI,EAAE,yBAAyB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EACxD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,WAAW,GAAG,mBAAmB,CAAC;QACtC,KAAK,CAAC,kBAAkB;QACxB,UAAU,CAAC,uBAAuB;KACnC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,EAAE,kBAAkB,IAAI,EAAE,CAAC;IAChE,OAAO;QACL,WAAW;QACX,OAAO,EAAE;YACP,wBAAwB,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,gBAAgB,EAAE,IAAI;YACtB,0BAA0B,EAAE,WAAW;SACxC;QACD,KAAK,EAAE;YACL,aAAa,EAAE,IAAI,CAAC,SAAS;YAC7B,kBAAkB,EAAE,mBAAmB,CAAC;gBACtC,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,WAAW;aACZ,CAAC;SACH;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,KAMlD;IACC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,uBAAuB,CAAC;QACzC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM;KAC/B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,eAAe,CACrC,KAAK,EACL,KAAK,CAAC,UAAU,EAChB,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,EACzD;QACE,GAAG,UAAU,EAAE,OAAO;QACtB,gCAAgC,EAAE,IAAI;QACtC,oBAAoB,EAAE,IAAI;KAC3B,EACD,KAAK,CAAC,UAAU,CACjB,CAAC;IACF,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;QAC5B,qEAAqE;QACrE,0DAA0D;QAC1D,IAAI,KAAK,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;YACtC,KAAK,CAAC,kBAAkB,GAAG,mBAAmB,CAAC;gBAC7C,KAAK,CAAC,kBAAkB;gBACxB,UAAU,CAAC,WAAW;aACvB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { mergeVersionVectors } from \"@tearleads/loro\";\nimport type {\n  createRemoteDocument,\n  DocumentRecord,\n  PendingUpdateRecord,\n} from \"../../../../workflows/documents\";\nimport { persistDocument } from \"../persistence\";\nimport type {\n  DocumentState,\n  DocumentStoreState,\n  PersistedDocumentRecord,\n  SaveDocumentRecordOptions,\n} from \"../state\";\nimport type { DocumentStoreSyncGeneration } from \"./syncGeneration\";\n\ntype CreatedRemoteDocument = NonNullable<\n  Awaited<ReturnType<typeof createRemoteDocument>>\n>;\n\n/** A create's seed; `onCommitted` runs once its settlement persists. */\nexport interface CreateSeed {\n  readonly onCommitted: () => void;\n  readonly update: PendingUpdateRecord;\n}\n\n/**\n * How a create that committed `seedUpdate` settles it: the row is accepted,\n * the commit position is the one its first sync would have recorded, and the\n * outgoing marker and frontier advance over it as the coverage pass would\n * have (see `prepareDocumentOutgoingCoverage`). Null when the create did not\n * commit the seed (a plain fallback or an adoption): the row stays queued and\n * syncs as before.\n */\nfunction committedSeedSettlement(input: {\n  readonly created: CreatedRemoteDocument;\n  readonly liveRecord: DocumentRecord | null;\n  readonly pendingBaseVersion: string | null;\n  readonly seedUpdate: PendingUpdateRecord | undefined;\n}): {\n  readonly baseVersion: string;\n  readonly options: SaveDocumentRecordOptions;\n  readonly patch: Partial<DocumentRecord>;\n} | null {\n  const { seedUpdate } = input;\n  const seed = input.created.response?.initialSync;\n  if (\n    !seedUpdate ||\n    input.pendingBaseVersion === null ||\n    !seed?.acceptedOutgoingUpdateIds.includes(seedUpdate.id)\n  ) {\n    return null;\n  }\n  const baseVersion = mergeVersionVectors([\n    input.pendingBaseVersion,\n    seedUpdate.partialEndVersionVector,\n  ]);\n  const liveFrontier = input.liveRecord?.snapshotEndVersion ?? \"\";\n  return {\n    baseVersion,\n    options: {\n      acceptedPendingUpdateIds: [seedUpdate.id],\n      clearSyncFailure: true,\n      pendingBaseVersionOverride: baseVersion,\n    },\n    patch: {\n      lastCommitLsn: seed.commitLsn,\n      snapshotEndVersion: mergeVersionVectors([\n        ...(liveFrontier.length > 0 ? [liveFrontier] : []),\n        baseVersion,\n      ]),\n    },\n  };\n}\n\n/**\n * Persists a just-created remote identity (documentId and content keys), and\n * settles the create's seed when it committed. Preserves the optimistic\n * snapshot fields: the user may have kept typing during the round trip.\n */\nexport async function persistCreatedRemoteDocument(input: {\n  readonly created: CreatedRemoteDocument;\n  readonly currentDoc: DocumentState;\n  readonly generation: DocumentStoreSyncGeneration | undefined;\n  readonly seed: CreateSeed | undefined;\n  readonly state: DocumentStoreState;\n}): Promise<PersistedDocumentRecord | null> {\n  const { state } = input;\n  const settlement = committedSeedSettlement({\n    created: input.created,\n    liveRecord: state.record,\n    pendingBaseVersion: state.pendingBaseVersion,\n    seedUpdate: input.seed?.update,\n  });\n  const persisted = await persistDocument(\n    state,\n    input.currentDoc,\n    { ...input.created.persistedState, ...settlement?.patch },\n    {\n      ...settlement?.options,\n      preserveSnapshotStructuredFields: true,\n      preserveSnapshotText: true,\n    },\n    input.generation,\n  );\n  if (persisted && settlement) {\n    // As the coverage pass does: merge, so a concurrent local write that\n    // advanced the in-memory marker is never moved backwards.\n    if (state.pendingBaseVersion !== null) {\n      state.pendingBaseVersion = mergeVersionVectors([\n        state.pendingBaseVersion,\n        settlement.baseVersion,\n      ]);\n    }\n    input.seed?.onCommitted();\n  }\n  return persisted;\n}\n"]}