@tearleads/client-sdk 0.1.62 → 0.1.64

package/workflows/documents/create/index.d.ts

@@ -0,0 +1,56 @@
+import { type ContainerWriterProjectionResponse, type DocumentCreateResponse } from "../../../internal/validators/response/index.js";
+import type { CreateRemoteDocumentResult, DocumentCreateApi, DocumentCreateAuthor, MaterializedDocumentCreatePlan, ProjectionVerificationOptions } from "../../../data/documents/shared/types.js";
+import type { ProjectionUserKeyResolver, ReferencedPrincipalPolicyWarmer } from "../../../data/keyingProjectionVerification/index.js";
+import type { ExecSql } from "../../../data/sqlite/sqlSchema.js";
+import type { DocumentCreateTerminalFailureHandler } from "./createProjectionFetch.js";
+export declare function buildMaterializedDocumentCreatePlan(input: {
+    author: DocumentCreateAuthor;
+    containerProjection: ContainerWriterProjectionResponse;
+    contentKey?: Uint8Array | undefined;
+    contentKeyEpoch?: number | undefined;
+    documentId?: string | undefined;
+    eventId?: string | undefined;
+    execSql?: ExecSql | undefined;
+    knownContainerKeks?: ReadonlyMap<string, Uint8Array> | undefined;
+    persistVerificationCheckpoints?: boolean | undefined;
+    signedAt?: string | undefined;
+    targetSecretKey: Uint8Array;
+} & ProjectionVerificationOptions): Promise<MaterializedDocumentCreatePlan>;
+export { documentWriterProjectionFromCreateResponse } from "./createProjection.js";
+interface RemoteDocumentCreateInput {
+    apiClient: DocumentCreateApi;
+    author: DocumentCreateAuthor;
+    containerId: string;
+    containerProjection?: ContainerWriterProjectionResponse | undefined;
+    contentKey?: Uint8Array | undefined;
+    contentKeyEpoch?: number | undefined;
+    documentId?: string | undefined;
+    eventId?: string | undefined;
+    execSql: ExecSql;
+    expectedOrganizationId?: string | undefined;
+    isRemoteSyncBlocked?: ((organizationId: string) => boolean) | undefined;
+    knownContainerKeks?: ReadonlyMap<string, Uint8Array> | undefined;
+    /**
+     * Invoked when the create submission fails terminally (not a benign
+     * adopt/stale-target conflict) — e.g. the server denies the write. Callers
+     * persist the failure so the write queue can surface it.
+     */
+    onTerminalSubmitFailure?: DocumentCreateTerminalFailureHandler | undefined;
+    resolveProjectionUserKey: ProjectionUserKeyResolver;
+    signedAt?: string | undefined;
+    stillCurrent?: (() => boolean) | undefined;
+    targetSecretKey: Uint8Array;
+    warmReferencedPrincipalPolicies?: ReferencedPrincipalPolicyWarmer | undefined;
+}
+export declare function createRemoteDocument(input: RemoteDocumentCreateInput): Promise<CreateRemoteDocumentResult | null>;
+type DocumentCreateSubmission = {
+    readonly data: DocumentCreateResponse;
+    readonly ok: true;
+} | {
+    readonly code?: string | undefined;
+    readonly message: string;
+    readonly ok: false;
+    readonly report?: (() => void) | undefined;
+    readonly status: number | null;
+};
+export declare function isStaleDocumentCreateTargetConflict(submission: DocumentCreateSubmission): boolean;

package/workflows/documents/create/index.js

@@ -0,0 +1,258 @@
+import { DOCUMENT_SYNC_ERROR_CODES, } from "../../../internal/validators/response/index.js";
+import { assertContainerAuthorAccess } from "../../../data/containers/shared/authorAccess.js";
+import { buildDocumentCreatePlan } from "../../../data/documents/shared/events.js";
+import { wrapDocumentContentKeyForCreate } from "../../../data/documents/shared/projection.js";
+import { projectionVerificationOptions } from "../../../data/documents/shared/types.js";
+import { collectContainerWriterProjectionPrincipalPolicies, nullOnProjectionVerificationCancellation, requireProjectionUserKeyResolver, } from "../../../data/keyingProjectionVerification/index.js";
+import { isContainerCreatePending } from "../../../data/persistence/container-contents/pendingContainerCreate.js";
+import { recordDocumentAuthorAccessFailure } from "../authorAccessFailure.js";
+import { isDocumentManifestAlreadyExistsConflict, shouldRetryWithFreshProjection, } from "../syncFailures/syncFailureClassification.js";
+import { adoptExistingRemoteDocument } from "./createAdoption.js";
+import { fetchContainerWriterProjectionForCreate } from "./createProjectionFetch.js";
+import { acknowledgeRemoteDocumentCreate } from "./createResponse.js";
+export async function buildMaterializedDocumentCreatePlan(input) {
+    const contentKey = input.contentKey ?? crypto.getRandomValues(new Uint8Array(32));
+    if (contentKey.byteLength !== 32) {
+        throw new Error("Document content key must be 32 bytes");
+    }
+    // Resolved before wrapping: each envelope is sealed to its document and
+    // content-key epoch.
+    const documentId = input.documentId ?? crypto.randomUUID();
+    const contentKeyEpoch = input.contentKeyEpoch ?? 1;
+    const targetEnvelopes = await wrapDocumentContentKeyForCreate({
+        contentKey,
+        contentKeyEpoch,
+        documentId,
+        execSql: input.execSql,
+        knownContainerKeks: input.knownContainerKeks,
+        persistVerificationCheckpoints: input.persistVerificationCheckpoints,
+        projection: input.containerProjection,
+        secretKey: input.targetSecretKey,
+        ...projectionVerificationOptions(input),
+    });
+    if (input.resolveProjectionUserKey) {
+        const principalPolicies = await collectContainerWriterProjectionPrincipalPolicies({
+            ...projectionVerificationOptions(input),
+            execSql: input.execSql,
+            projection: input.containerProjection,
+            resolveUserKey: input.resolveProjectionUserKey,
+        });
+        assertContainerAuthorAccess({
+            // Document signing derives its organization from the verified target.
+            author: {
+                ...input.author,
+                organizationId: input.containerProjection.organizationId,
+            },
+            projection: input.containerProjection,
+            principalPolicies,
+            minimumAccess: "write",
+        });
+    }
+    // The explicit local-trust variant builds provisioning artifacts before
+    // their new principal policies exist remotely; remote creates cannot use it.
+    const plan = await buildDocumentCreatePlan({
+        author: input.author,
+        containerProjection: input.containerProjection,
+        contentKeyEpoch,
+        documentId,
+        ...(input.eventId === undefined ? {} : { eventId: input.eventId }),
+        ...(input.signedAt === undefined ? {} : { signedAt: input.signedAt }),
+        targetEnvelopes,
+    });
+    return {
+        contentKey,
+        plan,
+    };
+}
+export { documentWriterProjectionFromCreateResponse } from "./createProjection.js";
+async function buildMaterializedDocumentCreatePlanWithFreshProjection(input) {
+    const buildWithProjection = async (containerProjection) => {
+        if (containerProjection.containerId !== input.containerId ||
+            (input.expectedOrganizationId !== undefined &&
+                containerProjection.organizationId !== input.expectedOrganizationId)) {
+            throw new Error("Container writer projection belongs to another container or organization");
+        }
+        return {
+            containerProjection,
+            materializedPlan: await buildMaterializedDocumentCreatePlan({
+                author: input.author,
+                containerProjection,
+                contentKey: input.contentKey,
+                contentKeyEpoch: input.contentKeyEpoch,
+                documentId: input.documentId,
+                eventId: input.eventId,
+                execSql: input.execSql,
+                knownContainerKeks: input.knownContainerKeks,
+                persistVerificationCheckpoints: input.persistVerificationCheckpoints,
+                resolveProjectionUserKey: input.resolveProjectionUserKey,
+                signedAt: input.signedAt,
+                stillCurrent: input.stillCurrent,
+                targetSecretKey: input.targetSecretKey,
+                warmReferencedPrincipalPolicies: input.warmReferencedPrincipalPolicies,
+            }),
+        };
+    };
+    const containerProjection = input.containerProjection ??
+        (await fetchContainerWriterProjectionForCreate({
+            apiClient: input.apiClient,
+            containerId: input.containerId,
+            onTerminalSubmitFailure: input.onTerminalSubmitFailure,
+        }));
+    if (!containerProjection) {
+        return null;
+    }
+    try {
+        return await buildWithProjection(containerProjection);
+    }
+    catch (error) {
+        if (!shouldRetryWithFreshProjection(error, (message) => message.includes("could not be unwrapped"))) {
+            throw error;
+        }
+    }
+    // Only this container's projection was stale; evict just it rather than
+    // wiping every cached projection.
+    input.apiClient.evictContainerWriterProjection(input.containerId);
+    const refreshedProjection = await fetchContainerWriterProjectionForCreate({
+        apiClient: input.apiClient,
+        containerId: input.containerId,
+        onTerminalSubmitFailure: input.onTerminalSubmitFailure,
+    });
+    return refreshedProjection ? buildWithProjection(refreshedProjection) : null;
+}
+function isRemoteDocumentCreatePlanBlocked(input, createPlan) {
+    const organizationId = createPlan.containerProjection.organizationId;
+    return input.isRemoteSyncBlocked?.(organizationId) ?? false;
+}
+async function submitPlannedDocumentCreate(input, resolveProjectionUserKey) {
+    const verificationOptions = { stillCurrent: input.stillCurrent };
+    const warmReferencedPrincipalPolicies = input.warmReferencedPrincipalPolicies;
+    let createPlan = await buildMaterializedDocumentCreatePlanWithFreshProjection({
+        apiClient: input.apiClient,
+        author: input.author,
+        containerId: input.containerId,
+        containerProjection: input.containerProjection,
+        contentKey: input.contentKey,
+        contentKeyEpoch: input.contentKeyEpoch,
+        documentId: input.documentId,
+        eventId: input.eventId,
+        execSql: input.execSql,
+        expectedOrganizationId: input.expectedOrganizationId,
+        knownContainerKeks: input.knownContainerKeks,
+        onTerminalSubmitFailure: input.onTerminalSubmitFailure,
+        resolveProjectionUserKey,
+        signedAt: input.signedAt,
+        targetSecretKey: input.targetSecretKey,
+        warmReferencedPrincipalPolicies,
+        ...verificationOptions,
+    });
+    if (!createPlan) {
+        return null;
+    }
+    if (isRemoteDocumentCreatePlanBlocked(input, createPlan))
+        return null;
+    if (input.stillCurrent?.() === false)
+        return null;
+    let submission = await submitDocumentCreate(input.apiClient, createPlan.materializedPlan.plan.request, createPlan.containerProjection.organizationId);
+    if (isStaleDocumentCreateTargetConflict(submission)) {
+        if (input.stillCurrent?.() === false) {
+            return { createPlan, submission };
+        }
+        input.apiClient.evictContainerWriterProjection(input.containerId);
+        const firstPlan = createPlan.materializedPlan;
+        const refreshedPlan = await buildMaterializedDocumentCreatePlanWithFreshProjection({
+            apiClient: input.apiClient,
+            author: input.author,
+            containerId: input.containerId,
+            contentKey: firstPlan.contentKey,
+            contentKeyEpoch: firstPlan.plan.request.contentKeyBundle.contentKeyEpoch,
+            documentId: firstPlan.plan.documentId,
+            eventId: firstPlan.plan.event.eventId,
+            execSql: input.execSql,
+            expectedOrganizationId: input.expectedOrganizationId,
+            knownContainerKeks: input.knownContainerKeks,
+            onTerminalSubmitFailure: input.onTerminalSubmitFailure,
+            resolveProjectionUserKey,
+            signedAt: firstPlan.plan.event.signedAt,
+            targetSecretKey: input.targetSecretKey,
+            warmReferencedPrincipalPolicies,
+            ...verificationOptions,
+        });
+        if (!refreshedPlan) {
+            return null;
+        }
+        if (isRemoteDocumentCreatePlanBlocked(input, refreshedPlan))
+            return null;
+        createPlan = refreshedPlan;
+        if (input.stillCurrent?.() === false)
+            return null;
+        submission = await submitDocumentCreate(input.apiClient, createPlan.materializedPlan.plan.request, createPlan.containerProjection.organizationId);
+    }
+    return { createPlan, submission };
+}
+export async function createRemoteDocument(input) {
+    // The store retries once the folder's own create settles.
+    if (await isContainerCreatePending(input.execSql, input.containerId)) {
+        return null;
+    }
+    const resolveProjectionUserKey = requireProjectionUserKeyResolver(input.resolveProjectionUserKey, "Remote document create");
+    const plannedSubmission = await recordDocumentAuthorAccessFailure(() => nullOnProjectionVerificationCancellation(() => submitPlannedDocumentCreate(input, resolveProjectionUserKey)), input.onTerminalSubmitFailure);
+    if (!plannedSubmission) {
+        return null;
+    }
+    const { createPlan, submission } = plannedSubmission;
+    if (input.stillCurrent?.() === false)
+        return null;
+    if (submission.ok)
+        return acknowledgeRemoteDocumentCreate({
+            ...input,
+            ...createPlan,
+            resolveProjectionUserKey,
+            response: submission.data,
+        });
+    // A stable documentId means a retry after a lost create response re-submits
+    // the same id; the server then reports the manifest already exists. That is
+    // not a failure — the first attempt committed. Adopt the existing remote
+    // document instead of leaking a duplicate. Requires the stable id we sent, so
+    // we can fetch its projection back.
+    const stableDocumentId = input.documentId;
+    if (stableDocumentId && isDocumentManifestAlreadyExistsConflict(submission)) {
+        if (input.stillCurrent?.() === false)
+            return null;
+        const adopted = await nullOnProjectionVerificationCancellation(() => adoptExistingRemoteDocument({
+            apiClient: input.apiClient,
+            documentId: stableDocumentId,
+            execSql: input.execSql,
+            expectedContainerId: input.containerId,
+            expectedOrganizationId: input.expectedOrganizationId ??
+                createPlan.containerProjection.organizationId,
+            expectedSignerUserId: input.author.signerUserId,
+            resolveProjectionUserKey,
+            stillCurrent: input.stillCurrent,
+            targetSecretKey: input.targetSecretKey,
+            warmReferencedPrincipalPolicies: input.warmReferencedPrincipalPolicies,
+        }));
+        if (adopted) {
+            return adopted;
+        }
+        // A conflict is the expected, benign outcome of an idempotent retry after a
+        // lost create response. If adoption cannot complete yet (e.g. the writer
+        // projection fetch failed transiently), do not surface the conflict as a UI
+        // error — the sync engine retries and adopts it on a later tick.
+        return null;
+    }
+    submission.report?.();
+    await input.onTerminalSubmitFailure?.(submission);
+    return null;
+}
+export function isStaleDocumentCreateTargetConflict(submission) {
+    return (!submission.ok &&
+        submission.status === 409 &&
+        submission.code === DOCUMENT_SYNC_ERROR_CODES.stateStale);
+}
+async function submitDocumentCreate(apiClient, request, expectedOrganizationId) {
+    return apiClient.createDocumentResult(request, {
+        expectedPaymentRequiredOrganizationId: expectedOrganizationId,
+        reportErrors: false,
+    });
+}
+//# sourceMappingURL=index.js.map

package/workflows/documents/create/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DocumentCreateRequest } from \"@tearleads/validators/request\";\nimport {\n  type ContainerWriterProjectionResponse,\n  DOCUMENT_SYNC_ERROR_CODES,\n  type DocumentCreateResponse,\n} from \"@tearleads/validators/response\";\nimport { assertContainerAuthorAccess } from \"../../../data/containers/shared/authorAccess\";\nimport { buildDocumentCreatePlan } from \"../../../data/documents/shared/events\";\nimport { wrapDocumentContentKeyForCreate } from \"../../../data/documents/shared/projection\";\nimport type {\n  CreateRemoteDocumentResult,\n  DocumentCreateApi,\n  DocumentCreateAuthor,\n  MaterializedDocumentCreatePlan,\n  ProjectionVerificationOptions,\n} from \"../../../data/documents/shared/types\";\nimport { projectionVerificationOptions } from \"../../../data/documents/shared/types\";\nimport type {\n  ProjectionUserKeyResolver,\n  ReferencedPrincipalPolicyWarmer,\n} from \"../../../data/keyingProjectionVerification\";\nimport {\n  collectContainerWriterProjectionPrincipalPolicies,\n  nullOnProjectionVerificationCancellation,\n  requireProjectionUserKeyResolver,\n} from \"../../../data/keyingProjectionVerification\";\nimport { isContainerCreatePending } from \"../../../data/persistence/container-contents/pendingContainerCreate\";\nimport type { ExecSql } from \"../../../data/sqlite/sqlSchema\";\nimport { recordDocumentAuthorAccessFailure } from \"../authorAccessFailure\";\nimport {\n  isDocumentManifestAlreadyExistsConflict,\n  shouldRetryWithFreshProjection,\n} from \"../syncFailures/syncFailureClassification\";\nimport { adoptExistingRemoteDocument } from \"./createAdoption\";\nimport type { DocumentCreateTerminalFailureHandler } from \"./createProjectionFetch\";\nimport { fetchContainerWriterProjectionForCreate } from \"./createProjectionFetch\";\nimport { acknowledgeRemoteDocumentCreate } from \"./createResponse\";\n\nexport async function buildMaterializedDocumentCreatePlan(\n  input: {\n    author: DocumentCreateAuthor;\n    containerProjection: ContainerWriterProjectionResponse;\n    contentKey?: Uint8Array | undefined;\n    contentKeyEpoch?: number | undefined;\n    documentId?: string | undefined;\n    eventId?: string | undefined;\n    execSql?: ExecSql | undefined;\n    knownContainerKeks?: ReadonlyMap<string, Uint8Array> | undefined;\n    persistVerificationCheckpoints?: boolean | undefined;\n    signedAt?: string | undefined;\n    targetSecretKey: Uint8Array;\n  } & ProjectionVerificationOptions,\n): Promise<MaterializedDocumentCreatePlan> {\n  const contentKey =\n    input.contentKey ?? crypto.getRandomValues(new Uint8Array(32));\n  if (contentKey.byteLength !== 32) {\n    throw new Error(\"Document content key must be 32 bytes\");\n  }\n  // Resolved before wrapping: each envelope is sealed to its document and\n  // content-key epoch.\n  const documentId = input.documentId ?? crypto.randomUUID();\n  const contentKeyEpoch = input.contentKeyEpoch ?? 1;\n  const targetEnvelopes = await wrapDocumentContentKeyForCreate({\n    contentKey,\n    contentKeyEpoch,\n    documentId,\n    execSql: input.execSql,\n    knownContainerKeks: input.knownContainerKeks,\n    persistVerificationCheckpoints: input.persistVerificationCheckpoints,\n    projection: input.containerProjection,\n    secretKey: input.targetSecretKey,\n    ...projectionVerificationOptions(input),\n  });\n  if (input.resolveProjectionUserKey) {\n    const principalPolicies =\n      await collectContainerWriterProjectionPrincipalPolicies({\n        ...projectionVerificationOptions(input),\n        execSql: input.execSql,\n        projection: input.containerProjection,\n        resolveUserKey: input.resolveProjectionUserKey,\n      });\n    assertContainerAuthorAccess({\n      // Document signing derives its organization from the verified target.\n      author: {\n        ...input.author,\n        organizationId: input.containerProjection.organizationId,\n      },\n      projection: input.containerProjection,\n      principalPolicies,\n      minimumAccess: \"write\",\n    });\n  }\n  // The explicit local-trust variant builds provisioning artifacts before\n  // their new principal policies exist remotely; remote creates cannot use it.\n  const plan = await buildDocumentCreatePlan({\n    author: input.author,\n    containerProjection: input.containerProjection,\n    contentKeyEpoch,\n    documentId,\n    ...(input.eventId === undefined ? {} : { eventId: input.eventId }),\n    ...(input.signedAt === undefined ? {} : { signedAt: input.signedAt }),\n    targetEnvelopes,\n  });\n\n  return {\n    contentKey,\n    plan,\n  };\n}\n\nexport { documentWriterProjectionFromCreateResponse } from \"./createProjection\";\n\ninterface MaterializedDocumentCreatePlanWithProjection {\n  readonly containerProjection: ContainerWriterProjectionResponse;\n  readonly materializedPlan: MaterializedDocumentCreatePlan;\n}\n\nasync function buildMaterializedDocumentCreatePlanWithFreshProjection(input: {\n  apiClient: DocumentCreateApi;\n  author: DocumentCreateAuthor;\n  containerId: string;\n  containerProjection?: ContainerWriterProjectionResponse | undefined;\n  contentKey?: Uint8Array | undefined;\n  contentKeyEpoch?: number | undefined;\n  documentId?: string | undefined;\n  eventId?: string | undefined;\n  execSql: ExecSql;\n  expectedOrganizationId?: string | undefined;\n  knownContainerKeks?: ReadonlyMap<string, Uint8Array> | undefined;\n  onTerminalSubmitFailure?: DocumentCreateTerminalFailureHandler | undefined;\n  persistVerificationCheckpoints?: boolean | undefined;\n  resolveProjectionUserKey: ProjectionUserKeyResolver;\n  signedAt?: string | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n  targetSecretKey: Uint8Array;\n  warmReferencedPrincipalPolicies?: ReferencedPrincipalPolicyWarmer | undefined;\n}): Promise<MaterializedDocumentCreatePlanWithProjection | null> {\n  const buildWithProjection = async (\n    containerProjection: ContainerWriterProjectionResponse,\n  ) => {\n    if (\n      containerProjection.containerId !== input.containerId ||\n      (input.expectedOrganizationId !== undefined &&\n        containerProjection.organizationId !== input.expectedOrganizationId)\n    ) {\n      throw new Error(\n        \"Container writer projection belongs to another container or organization\",\n      );\n    }\n    return {\n      containerProjection,\n      materializedPlan: await buildMaterializedDocumentCreatePlan({\n        author: input.author,\n        containerProjection,\n        contentKey: input.contentKey,\n        contentKeyEpoch: input.contentKeyEpoch,\n        documentId: input.documentId,\n        eventId: input.eventId,\n        execSql: input.execSql,\n        knownContainerKeks: input.knownContainerKeks,\n        persistVerificationCheckpoints: input.persistVerificationCheckpoints,\n        resolveProjectionUserKey: input.resolveProjectionUserKey,\n        signedAt: input.signedAt,\n        stillCurrent: input.stillCurrent,\n        targetSecretKey: input.targetSecretKey,\n        warmReferencedPrincipalPolicies: input.warmReferencedPrincipalPolicies,\n      }),\n    };\n  };\n\n  const containerProjection =\n    input.containerProjection ??\n    (await fetchContainerWriterProjectionForCreate({\n      apiClient: input.apiClient,\n      containerId: input.containerId,\n      onTerminalSubmitFailure: input.onTerminalSubmitFailure,\n    }));\n  if (!containerProjection) {\n    return null;\n  }\n\n  try {\n    return await buildWithProjection(containerProjection);\n  } catch (error) {\n    if (\n      !shouldRetryWithFreshProjection(error, (message) =>\n        message.includes(\"could not be unwrapped\"),\n      )\n    ) {\n      throw error;\n    }\n  }\n\n  // Only this container's projection was stale; evict just it rather than\n  // wiping every cached projection.\n  input.apiClient.evictContainerWriterProjection(input.containerId);\n  const refreshedProjection = await fetchContainerWriterProjectionForCreate({\n    apiClient: input.apiClient,\n    containerId: input.containerId,\n    onTerminalSubmitFailure: input.onTerminalSubmitFailure,\n  });\n  return refreshedProjection ? buildWithProjection(refreshedProjection) : null;\n}\n\ninterface RemoteDocumentCreateInput {\n  apiClient: DocumentCreateApi;\n  author: DocumentCreateAuthor;\n  containerId: string;\n  containerProjection?: ContainerWriterProjectionResponse | undefined;\n  contentKey?: Uint8Array | undefined;\n  contentKeyEpoch?: number | undefined;\n  documentId?: string | undefined;\n  eventId?: string | undefined;\n  execSql: ExecSql;\n  expectedOrganizationId?: string | undefined;\n  isRemoteSyncBlocked?: ((organizationId: string) => boolean) | undefined;\n  knownContainerKeks?: ReadonlyMap<string, Uint8Array> | undefined;\n  /**\n   * Invoked when the create submission fails terminally (not a benign\n   * adopt/stale-target conflict) — e.g. the server denies the write. Callers\n   * persist the failure so the write queue can surface it.\n   */\n  onTerminalSubmitFailure?: DocumentCreateTerminalFailureHandler | undefined;\n  resolveProjectionUserKey: ProjectionUserKeyResolver;\n  signedAt?: string | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n  targetSecretKey: Uint8Array;\n  warmReferencedPrincipalPolicies?: ReferencedPrincipalPolicyWarmer | undefined;\n}\n\nfunction isRemoteDocumentCreatePlanBlocked(\n  input: RemoteDocumentCreateInput,\n  createPlan: MaterializedDocumentCreatePlanWithProjection,\n): boolean {\n  const organizationId = createPlan.containerProjection.organizationId;\n  return input.isRemoteSyncBlocked?.(organizationId) ?? false;\n}\n\nasync function submitPlannedDocumentCreate(\n  input: RemoteDocumentCreateInput,\n  resolveProjectionUserKey: ProjectionUserKeyResolver,\n): Promise<{\n  readonly createPlan: MaterializedDocumentCreatePlanWithProjection;\n  readonly submission: DocumentCreateSubmission;\n} | null> {\n  const verificationOptions = { stillCurrent: input.stillCurrent };\n  const warmReferencedPrincipalPolicies = input.warmReferencedPrincipalPolicies;\n  let createPlan = await buildMaterializedDocumentCreatePlanWithFreshProjection(\n    {\n      apiClient: input.apiClient,\n      author: input.author,\n      containerId: input.containerId,\n      containerProjection: input.containerProjection,\n      contentKey: input.contentKey,\n      contentKeyEpoch: input.contentKeyEpoch,\n      documentId: input.documentId,\n      eventId: input.eventId,\n      execSql: input.execSql,\n      expectedOrganizationId: input.expectedOrganizationId,\n      knownContainerKeks: input.knownContainerKeks,\n      onTerminalSubmitFailure: input.onTerminalSubmitFailure,\n      resolveProjectionUserKey,\n      signedAt: input.signedAt,\n      targetSecretKey: input.targetSecretKey,\n      warmReferencedPrincipalPolicies,\n      ...verificationOptions,\n    },\n  );\n  if (!createPlan) {\n    return null;\n  }\n  if (isRemoteDocumentCreatePlanBlocked(input, createPlan)) return null;\n  if (input.stillCurrent?.() === false) return null;\n  let submission = await submitDocumentCreate(\n    input.apiClient,\n    createPlan.materializedPlan.plan.request,\n    createPlan.containerProjection.organizationId,\n  );\n  if (isStaleDocumentCreateTargetConflict(submission)) {\n    if (input.stillCurrent?.() === false) {\n      return { createPlan, submission };\n    }\n    input.apiClient.evictContainerWriterProjection(input.containerId);\n    const firstPlan = createPlan.materializedPlan;\n    const refreshedPlan =\n      await buildMaterializedDocumentCreatePlanWithFreshProjection({\n        apiClient: input.apiClient,\n        author: input.author,\n        containerId: input.containerId,\n        contentKey: firstPlan.contentKey,\n        contentKeyEpoch:\n          firstPlan.plan.request.contentKeyBundle.contentKeyEpoch,\n        documentId: firstPlan.plan.documentId,\n        eventId: firstPlan.plan.event.eventId,\n        execSql: input.execSql,\n        expectedOrganizationId: input.expectedOrganizationId,\n        knownContainerKeks: input.knownContainerKeks,\n        onTerminalSubmitFailure: input.onTerminalSubmitFailure,\n        resolveProjectionUserKey,\n        signedAt: firstPlan.plan.event.signedAt,\n        targetSecretKey: input.targetSecretKey,\n        warmReferencedPrincipalPolicies,\n        ...verificationOptions,\n      });\n    if (!refreshedPlan) {\n      return null;\n    }\n    if (isRemoteDocumentCreatePlanBlocked(input, refreshedPlan)) return null;\n    createPlan = refreshedPlan;\n    if (input.stillCurrent?.() === false) return null;\n    submission = await submitDocumentCreate(\n      input.apiClient,\n      createPlan.materializedPlan.plan.request,\n      createPlan.containerProjection.organizationId,\n    );\n  }\n  return { createPlan, submission };\n}\n\nexport async function createRemoteDocument(\n  input: RemoteDocumentCreateInput,\n): Promise<CreateRemoteDocumentResult | null> {\n  // The store retries once the folder's own create settles.\n  if (await isContainerCreatePending(input.execSql, input.containerId)) {\n    return null;\n  }\n  const resolveProjectionUserKey = requireProjectionUserKeyResolver(\n    input.resolveProjectionUserKey,\n    \"Remote document create\",\n  );\n  const plannedSubmission = await recordDocumentAuthorAccessFailure(\n    () =>\n      nullOnProjectionVerificationCancellation(() =>\n        submitPlannedDocumentCreate(input, resolveProjectionUserKey),\n      ),\n    input.onTerminalSubmitFailure,\n  );\n  if (!plannedSubmission) {\n    return null;\n  }\n  const { createPlan, submission } = plannedSubmission;\n  if (input.stillCurrent?.() === false) return null;\n  if (submission.ok)\n    return acknowledgeRemoteDocumentCreate({\n      ...input,\n      ...createPlan,\n      resolveProjectionUserKey,\n      response: submission.data,\n    });\n\n  // A stable documentId means a retry after a lost create response re-submits\n  // the same id; the server then reports the manifest already exists. That is\n  // not a failure — the first attempt committed. Adopt the existing remote\n  // document instead of leaking a duplicate. Requires the stable id we sent, so\n  // we can fetch its projection back.\n  const stableDocumentId = input.documentId;\n  if (stableDocumentId && isDocumentManifestAlreadyExistsConflict(submission)) {\n    if (input.stillCurrent?.() === false) return null;\n    const adopted = await nullOnProjectionVerificationCancellation(() =>\n      adoptExistingRemoteDocument({\n        apiClient: input.apiClient,\n        documentId: stableDocumentId,\n        execSql: input.execSql,\n        expectedContainerId: input.containerId,\n        expectedOrganizationId:\n          input.expectedOrganizationId ??\n          createPlan.containerProjection.organizationId,\n        expectedSignerUserId: input.author.signerUserId,\n        resolveProjectionUserKey,\n        stillCurrent: input.stillCurrent,\n        targetSecretKey: input.targetSecretKey,\n        warmReferencedPrincipalPolicies: input.warmReferencedPrincipalPolicies,\n      }),\n    );\n    if (adopted) {\n      return adopted;\n    }\n    // A conflict is the expected, benign outcome of an idempotent retry after a\n    // lost create response. If adoption cannot complete yet (e.g. the writer\n    // projection fetch failed transiently), do not surface the conflict as a UI\n    // error — the sync engine retries and adopts it on a later tick.\n    return null;\n  }\n\n  submission.report?.();\n  await input.onTerminalSubmitFailure?.(submission);\n  return null;\n}\n\ntype DocumentCreateSubmission =\n  | {\n      readonly data: DocumentCreateResponse;\n      readonly ok: true;\n    }\n  | {\n      readonly code?: string | undefined;\n      readonly message: string;\n      readonly ok: false;\n      readonly report?: (() => void) | undefined;\n      readonly status: number | null;\n    };\n\nexport function isStaleDocumentCreateTargetConflict(\n  submission: DocumentCreateSubmission,\n): boolean {\n  return (\n    !submission.ok &&\n    submission.status === 409 &&\n    submission.code === DOCUMENT_SYNC_ERROR_CODES.stateStale\n  );\n}\n\nasync function submitDocumentCreate(\n  apiClient: DocumentCreateApi,\n  request: DocumentCreateRequest,\n  expectedOrganizationId: string,\n): Promise<DocumentCreateSubmission> {\n  return apiClient.createDocumentResult(request, {\n    expectedPaymentRequiredOrganizationId: expectedOrganizationId,\n    reportErrors: false,\n  });\n}\n"]}

package/workflows/documents/documentMutationCommit.js

@@ -1,7 +1,7 @@
 import { getTextValue } from "../../internal/loro/index.js";
 import { DEFAULT_DOCUMENT_ACCESS_EPOCH, DEFAULT_DOCUMENT_KIND, } from "../../data/documents/documentConstants.js";
 import { readStoredDocumentState, } from "../../data/documents/documentKinds.js";
-import { createInitialDocumentRows } from "./documentCreationPersistence.js";
+import { createInitialDocumentRows } from "./create/documentCreationPersistence.js";
 import { documentSyncSecurityContextMatches, prepareDocumentMutation, } from "./documentMutationPreparation.js";
 import { refuseDeletedDocumentPersist } from "./documentPersistGuards.js";
 const MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS = 8;

package/workflows/documents/documentMutationCommit.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentMutationCommit.js","sourceRoot":"","sources":["documentMutationCommit.ts"],"names":[],"mappings":"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","sourcesContent":["import { type encodeVersionVector, getTextValue } from \"@tearleads/loro\";\nimport {\n  DEFAULT_DOCUMENT_ACCESS_EPOCH,\n  DEFAULT_DOCUMENT_KIND,\n} from \"../../data/documents/documentConstants\";\nimport {\n  type DocumentProjectorRegistry,\n  type DocumentProjectorRegistryInput,\n  readStoredDocumentState,\n} from \"../../data/documents/documentKinds\";\nimport type {\n  DocumentsPersistence,\n  StoredDocumentRecord,\n} from \"../../data/persistence/documents/documentsPersistence\";\nimport type { PendingUpdateFields } from \"../../data/sqlite/documentPersistence\";\nimport type { ExecSql } from \"../../data/sqlite/sqlSchema\";\nimport { createInitialDocumentRows } from \"./documentCreationPersistence\";\nimport {\n  documentSyncSecurityContextMatches,\n  type PrepareDocumentMutationInput,\n  prepareDocumentMutation,\n} from \"./documentMutationPreparation\";\nimport { refuseDeletedDocumentPersist } from \"./documentPersistGuards\";\n\ntype DocumentContentState = Parameters<typeof encodeVersionVector>[0];\ntype NullableDocumentRuntimeField =\n  | \"accessStateHash\"\n  | \"lastCommitLsn\"\n  | \"contentKeyBundle\"\n  | \"documentKekTargets\"\n  | \"documentManifestBundle\";\n\nconst MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS = 8;\n\nexport interface PersistedDocumentState {\n  creationSuperseded?: true;\n  historyRestoreState?:\n    | Awaited<ReturnType<DocumentsPersistence[\"loadHistoryRestoreState\"]>>\n    | undefined;\n  pullContinuationSuperseded?: true;\n  record: StoredDocumentRecord;\n  syncIdentitySuperseded?: true;\n  updatedAt?: string | undefined;\n}\n\nexport interface PersistDocumentStateInput\n  extends PrepareDocumentMutationInput {\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  attachmentRemoval?:\n    | Parameters<\n        DocumentsPersistence[\"commitDocumentMutation\"]\n      >[1][\"attachmentRemoval\"]\n    | undefined;\n  attachmentStaging?:\n    | Parameters<\n        DocumentsPersistence[\"commitDocumentMutation\"]\n      >[1][\"attachmentStaging\"]\n    | undefined;\n  canStartDurableMutation?: (() => boolean) | undefined;\n  clearSyncFailure?: boolean | undefined;\n  commitSideEffect?: (transactionExecSql: ExecSql) => Promise<void>;\n  containerId?: string | null | undefined;\n  documentProjectors: DocumentProjectorRegistryInput;\n  execSql: ExecSql;\n  patch?: Partial<StoredDocumentRecord> | undefined;\n  pendingUpdate?: PendingUpdateFields | undefined;\n}\n\nasync function loadSupersededPersistedDocumentState(input: {\n  creationSuperseded: boolean;\n  execSql: ExecSql;\n  localId: string;\n  persistence: DocumentsPersistence;\n  record: StoredDocumentRecord;\n  syncIdentitySuperseded: boolean;\n}): Promise<PersistedDocumentState | null> {\n  const { document, historyRestoreState } =\n    await input.persistence.loadDocumentWithHistoryRestoreState(\n      input.execSql,\n      input.localId,\n    );\n  if (!document) return null;\n  const syncIdentitySuperseded =\n    input.syncIdentitySuperseded ||\n    !documentSyncSecurityContextMatches(document, input.record);\n  return {\n    ...(input.creationSuperseded ? { creationSuperseded: true as const } : {}),\n    historyRestoreState,\n    pullContinuationSuperseded: true,\n    record: document,\n    ...(syncIdentitySuperseded\n      ? { syncIdentitySuperseded: true as const }\n      : {}),\n  };\n}\n\nfunction resolveNullableDocumentRuntimeField(\n  patch: Partial<StoredDocumentRecord>,\n  key: NullableDocumentRuntimeField,\n  currentValue: string | null | undefined,\n  resetWhenUnpatched = false,\n): string | null {\n  if (Object.hasOwn(patch, key)) return patch[key] ?? null;\n  return resetWhenUnpatched ? null : (currentValue ?? null);\n}\n\nfunction resolveStoredDocumentContainerId(input: {\n  containerId?: string | null | undefined;\n  currentRecord: StoredDocumentRecord | null;\n  patch: Partial<StoredDocumentRecord>;\n}): string | null {\n  if (Object.hasOwn(input.patch, \"containerId\")) {\n    return input.patch.containerId ?? null;\n  }\n  return input.currentRecord?.containerId ?? input.containerId ?? null;\n}\n\nfunction resolveStoredDocumentPullState(input: {\n  currentRecord: StoredDocumentRecord | null;\n  patch: Partial<StoredDocumentRecord>;\n  securityContextChanged: boolean;\n}): Pick<\n  StoredDocumentRecord,\n  \"pullContinuation\" | \"pullContinuationRecoveryRequired\"\n> {\n  if (Object.hasOwn(input.patch, \"pullContinuation\")) {\n    return { pullContinuation: input.patch.pullContinuation ?? null };\n  }\n  if (input.securityContextChanged) return { pullContinuation: null };\n  if (input.currentRecord?.pullContinuationRecoveryRequired) {\n    return { pullContinuationRecoveryRequired: true };\n  }\n  return { pullContinuation: input.currentRecord?.pullContinuation ?? null };\n}\n\nfunction buildStoredDocumentRecord(input: {\n  containerId?: string | null | undefined;\n  currentDoc: DocumentContentState;\n  currentRecord: StoredDocumentRecord | null;\n  documentProjectors: DocumentProjectorRegistry;\n  localId: string;\n  patch: Partial<StoredDocumentRecord>;\n}) {\n  const { currentDoc, currentRecord, documentProjectors, localId, patch } =\n    input;\n  const currentDocumentId = currentRecord?.documentId ?? null;\n  const nextDocumentId = patch.documentId ?? currentDocumentId;\n  const documentIdChanged = nextDocumentId !== currentDocumentId;\n  const currentAccessEpoch =\n    currentRecord?.accessEpoch ?? DEFAULT_DOCUMENT_ACCESS_EPOCH;\n  const nextAccessEpoch = patch.accessEpoch ?? currentAccessEpoch;\n  const securityContextChanged =\n    documentIdChanged || nextAccessEpoch !== currentAccessEpoch;\n  const documentState = readStoredDocumentState(currentDoc, documentProjectors);\n  const record: StoredDocumentRecord = {\n    id: currentRecord?.id ?? localId,\n    accessEpoch: nextAccessEpoch,\n    accessStateHash: resolveNullableDocumentRuntimeField(\n      patch,\n      \"accessStateHash\",\n      currentRecord?.accessStateHash,\n      securityContextChanged,\n    ),\n    containerId: resolveStoredDocumentContainerId({\n      containerId: input.containerId,\n      currentRecord,\n      patch,\n    }),\n    contentKeyBundle: resolveNullableDocumentRuntimeField(\n      patch,\n      \"contentKeyBundle\",\n      currentRecord?.contentKeyBundle,\n      securityContextChanged,\n    ),\n    documentId: nextDocumentId,\n    effectiveAccessLevel:\n      patch.effectiveAccessLevel ?? currentRecord?.effectiveAccessLevel ?? null,\n    documentKekTargets: resolveNullableDocumentRuntimeField(\n      patch,\n      \"documentKekTargets\",\n      currentRecord?.documentKekTargets,\n      securityContextChanged,\n    ),\n    documentKind: patch.documentKind ?? documentState.documentKind,\n    documentManifestBundle: resolveNullableDocumentRuntimeField(\n      patch,\n      \"documentManifestBundle\",\n      currentRecord?.documentManifestBundle,\n      securityContextChanged,\n    ),\n    lastCommitLsn: resolveNullableDocumentRuntimeField(\n      patch,\n      \"lastCommitLsn\",\n      currentRecord?.lastCommitLsn,\n      documentIdChanged,\n    ),\n    snapshotEndVersion:\n      patch.snapshotEndVersion ?? currentRecord?.snapshotEndVersion ?? \"\",\n    pendingBaseVersion:\n      patch.pendingBaseVersion !== undefined\n        ? patch.pendingBaseVersion\n        : (currentRecord?.pendingBaseVersion ?? null),\n    recoveryGeneration:\n      patch.recoveryGeneration ?? currentRecord?.recoveryGeneration ?? 0,\n    ...resolveStoredDocumentPullState({\n      currentRecord,\n      patch,\n      securityContextChanged,\n    }),\n    text: patch.text ?? getTextValue(currentDoc),\n    title: patch.title ?? documentState.title,\n  };\n  return { documentState, record };\n}\n\nasync function saveDocumentClientProjection(input: {\n  currentRecord: StoredDocumentRecord | null;\n  documentProjectors: DocumentProjectorRegistry;\n  documentState: ReturnType<typeof readStoredDocumentState>;\n  execSql: ExecSql;\n  localId: string;\n  record: StoredDocumentRecord;\n  updatedAt: string;\n}): Promise<void> {\n  const previousKind =\n    input.currentRecord?.documentKind ?? DEFAULT_DOCUMENT_KIND;\n  const nextKind = input.record.documentKind ?? DEFAULT_DOCUMENT_KIND;\n  if (previousKind !== nextKind) {\n    await input.documentProjectors.deleteStoredDocumentClientProjection({\n      documentKind: previousKind,\n      execSql: input.execSql,\n      localId: input.localId,\n    });\n  }\n  await input.documentProjectors.saveStoredDocumentClientProjection({\n    containerId: input.record.containerId,\n    documentId: input.record.documentId,\n    documentKind: nextKind,\n    execSql: input.execSql,\n    localId: input.record.id,\n    structuredFields: input.documentState.structuredFields,\n    text: input.record.text,\n    title: input.record.title ?? input.documentState.title,\n    updatedAt: input.updatedAt,\n  });\n}\n\nasync function settleSupersededDocumentMutation(input: {\n  acceptedPendingUpdateIds: readonly string[];\n  lockedExecSql: ExecSql;\n  mutation: Awaited<ReturnType<typeof prepareDocumentMutation>>;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState | null> {\n  const { mutation, persistInput } = input;\n  if (!mutation.mutationCurrentRecord) return null;\n  const authoritativeRecord = persistInput.expectedSyncState\n    ? await persistInput.persistence.settleAcceptedPendingUpdates(\n        input.lockedExecSql,\n        {\n          expectedRecord: persistInput.expectedSyncState.record,\n          pendingUpdateIds: input.acceptedPendingUpdateIds,\n        },\n      )\n    : mutation.mutationCurrentRecord;\n  if (!authoritativeRecord) return null;\n  return loadSupersededPersistedDocumentState({\n    creationSuperseded: mutation.creationSuperseded,\n    execSql: input.lockedExecSql,\n    localId: persistInput.localId,\n    persistence: persistInput.persistence,\n    record: authoritativeRecord,\n    syncIdentitySuperseded: !mutation.securityContextMatches,\n  });\n}\n\nasync function loadConcurrentCreationWinner(input: {\n  execSql: ExecSql;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState> {\n  const winningRecord = await input.persistInput.persistence.loadDocument(\n    input.execSql,\n    input.persistInput.localId,\n  );\n  if (!winningRecord) {\n    throw new Error(\"Concurrent document creation lost without a winner\");\n  }\n  const winner = await loadSupersededPersistedDocumentState({\n    creationSuperseded: true,\n    execSql: input.execSql,\n    localId: input.persistInput.localId,\n    persistence: input.persistInput.persistence,\n    record: winningRecord,\n    syncIdentitySuperseded: true,\n  });\n  if (!winner) {\n    throw new Error(\"Concurrent document creation winner disappeared\");\n  }\n  return winner;\n}\n\nasync function resolveInitialDocumentCreation(input: {\n  execSql: ExecSql;\n  persistInput: PersistDocumentStateInput;\n  record: StoredDocumentRecord;\n  savedAt: string | null;\n}): Promise<PersistedDocumentState | null> {\n  if (input.savedAt !== null) {\n    return { record: input.record, updatedAt: input.savedAt };\n  }\n  if (\n    input.persistInput.canStartDurableMutation &&\n    !input.persistInput.canStartDurableMutation()\n  ) {\n    return null;\n  }\n  return loadConcurrentCreationWinner({\n    execSql: input.execSql,\n    persistInput: input.persistInput,\n  });\n}\n\nasync function resolveDocumentMutationCommit(input: {\n  committed: Awaited<\n    ReturnType<DocumentsPersistence[\"commitDocumentMutation\"]>\n  >;\n  lockedExecSql: ExecSql;\n  persistInput: PersistDocumentStateInput;\n  record: StoredDocumentRecord;\n}): Promise<PersistedDocumentState | null | \"retry\"> {\n  const { committed, persistInput, record } = input;\n  if (\n    persistInput.canStartDurableMutation &&\n    !persistInput.canStartDurableMutation()\n  ) {\n    return null;\n  }\n  if (committed.committed) return { record, updatedAt: committed.updatedAt };\n  if (!committed.currentRecord) return null;\n  if (persistInput.expectedSyncState === undefined) return \"retry\";\n  return loadSupersededPersistedDocumentState({\n    creationSuperseded: false,\n    execSql: input.lockedExecSql,\n    localId: persistInput.localId,\n    persistence: persistInput.persistence,\n    record: committed.currentRecord,\n    syncIdentitySuperseded: !documentSyncSecurityContextMatches(\n      committed.currentRecord,\n      persistInput.expectedSyncState.record,\n    ),\n  });\n}\n\nasync function commitOnePreparedDocumentMutation(input: {\n  acceptedPendingUpdateIds: readonly string[];\n  documentProjectors: DocumentProjectorRegistry;\n  lockedExecSql: ExecSql;\n  mutation: Exclude<\n    Awaited<ReturnType<typeof prepareDocumentMutation>>,\n    { pullContinuationSuperseded: true }\n  >;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState | null | \"retry\"> {\n  const { mutation, persistInput } = input;\n  const { documentState, record } = buildStoredDocumentRecord({\n    containerId: persistInput.containerId,\n    currentDoc: persistInput.currentDoc,\n    currentRecord: mutation.mutationCurrentRecord,\n    documentProjectors: input.documentProjectors,\n    localId: persistInput.localId,\n    patch: mutation.resolvedPatch,\n  });\n  if (!mutation.mutationCurrentRecord) {\n    const savedAt = await createInitialDocumentRows({\n      currentDoc: persistInput.currentDoc,\n      execSql: input.lockedExecSql,\n      pendingUpdate: persistInput.pendingUpdate,\n      persistence: persistInput.persistence,\n      record,\n      stillCurrent: persistInput.canStartDurableMutation,\n      saveClientProjection: (transactionExecSql, updatedAt) =>\n        saveDocumentClientProjection({\n          currentRecord: null,\n          documentProjectors: input.documentProjectors,\n          documentState,\n          execSql: transactionExecSql,\n          localId: persistInput.localId,\n          record,\n          updatedAt,\n        }),\n    });\n    return resolveInitialDocumentCreation({\n      execSql: input.lockedExecSql,\n      persistInput,\n      record,\n      savedAt,\n    });\n  }\n\n  const committed = await persistInput.persistence.commitDocumentMutation(\n    input.lockedExecSql,\n    {\n      acceptedPendingUpdateIds: input.acceptedPendingUpdateIds,\n      clearSyncFailure: persistInput.clearSyncFailure,\n      ...(persistInput.attachmentRemoval\n        ? { attachmentRemoval: persistInput.attachmentRemoval }\n        : {}),\n      ...(persistInput.attachmentStaging\n        ? { attachmentStaging: persistInput.attachmentStaging }\n        : {}),\n      document: record,\n      expectedRecord: mutation.mutationCurrentRecord,\n      ...(persistInput.historyCheckpoint\n        ? { historyCheckpoint: persistInput.historyCheckpoint }\n        : {}),\n      ...(persistInput.historyUpdateOrigin\n        ? { historyUpdateOrigin: persistInput.historyUpdateOrigin }\n        : {}),\n      ...(persistInput.historyUpdates\n        ? { historyUpdates: persistInput.historyUpdates }\n        : {}),\n      ...(persistInput.pendingUpdate\n        ? { pendingUpdate: persistInput.pendingUpdate }\n        : {}),\n      settleAcceptedPendingOnConflict:\n        persistInput.expectedSyncState !== undefined,\n      ...(persistInput.canStartDurableMutation\n        ? { stillCurrent: persistInput.canStartDurableMutation }\n        : {}),\n    },\n    async (transactionExecSql, updatedAt) => {\n      await saveDocumentClientProjection({\n        currentRecord: mutation.mutationCurrentRecord,\n        documentProjectors: input.documentProjectors,\n        documentState,\n        execSql: transactionExecSql,\n        localId: persistInput.localId,\n        record,\n        updatedAt,\n      });\n      await persistInput.commitSideEffect?.(transactionExecSql);\n    },\n  );\n  return resolveDocumentMutationCommit({\n    committed,\n    lockedExecSql: input.lockedExecSql,\n    persistInput,\n    record,\n  });\n}\n\nexport async function commitPreparedDocumentState(input: {\n  documentProjectors: DocumentProjectorRegistry;\n  lockedExecSql: ExecSql;\n  patch: Partial<StoredDocumentRecord>;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState | null> {\n  const { lockedExecSql, persistInput } = input;\n  if (\n    await refuseDeletedDocumentPersist({\n      currentRecord: persistInput.currentRecord,\n      documentProjectors: input.documentProjectors,\n      execSql: lockedExecSql,\n      localId: persistInput.localId,\n      persistence: persistInput.persistence,\n    })\n  ) {\n    return null;\n  }\n  const acceptedPendingUpdateIds = persistInput.acceptedPendingUpdateIds ?? [];\n  for (\n    let attempt = 0;\n    attempt < MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS;\n    attempt += 1\n  ) {\n    const mutation = await prepareDocumentMutation(\n      persistInput,\n      lockedExecSql,\n      input.patch,\n    );\n    if (mutation.pullContinuationSuperseded) {\n      return settleSupersededDocumentMutation({\n        acceptedPendingUpdateIds,\n        lockedExecSql,\n        mutation,\n        persistInput,\n      });\n    }\n    const result = await commitOnePreparedDocumentMutation({\n      acceptedPendingUpdateIds,\n      documentProjectors: input.documentProjectors,\n      lockedExecSql,\n      mutation,\n      persistInput,\n    });\n    if (result !== \"retry\") return result;\n  }\n  throw new Error(\n    `Document mutation commit gave up after ${MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS} concurrent conflicts`,\n  );\n}\n"]}
+{"version":3,"file":"documentMutationCommit.js","sourceRoot":"","sources":["documentMutationCommit.ts"],"names":[],"mappings":"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","sourcesContent":["import { type encodeVersionVector, getTextValue } from \"@tearleads/loro\";\nimport {\n  DEFAULT_DOCUMENT_ACCESS_EPOCH,\n  DEFAULT_DOCUMENT_KIND,\n} from \"../../data/documents/documentConstants\";\nimport {\n  type DocumentProjectorRegistry,\n  type DocumentProjectorRegistryInput,\n  readStoredDocumentState,\n} from \"../../data/documents/documentKinds\";\nimport type {\n  DocumentsPersistence,\n  StoredDocumentRecord,\n} from \"../../data/persistence/documents/documentsPersistence\";\nimport type { PendingUpdateFields } from \"../../data/sqlite/documentPersistence\";\nimport type { ExecSql } from \"../../data/sqlite/sqlSchema\";\nimport { createInitialDocumentRows } from \"./create/documentCreationPersistence\";\nimport {\n  documentSyncSecurityContextMatches,\n  type PrepareDocumentMutationInput,\n  prepareDocumentMutation,\n} from \"./documentMutationPreparation\";\nimport { refuseDeletedDocumentPersist } from \"./documentPersistGuards\";\n\ntype DocumentContentState = Parameters<typeof encodeVersionVector>[0];\ntype NullableDocumentRuntimeField =\n  | \"accessStateHash\"\n  | \"lastCommitLsn\"\n  | \"contentKeyBundle\"\n  | \"documentKekTargets\"\n  | \"documentManifestBundle\";\n\nconst MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS = 8;\n\nexport interface PersistedDocumentState {\n  creationSuperseded?: true;\n  historyRestoreState?:\n    | Awaited<ReturnType<DocumentsPersistence[\"loadHistoryRestoreState\"]>>\n    | undefined;\n  pullContinuationSuperseded?: true;\n  record: StoredDocumentRecord;\n  syncIdentitySuperseded?: true;\n  updatedAt?: string | undefined;\n}\n\nexport interface PersistDocumentStateInput\n  extends PrepareDocumentMutationInput {\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  attachmentRemoval?:\n    | Parameters<\n        DocumentsPersistence[\"commitDocumentMutation\"]\n      >[1][\"attachmentRemoval\"]\n    | undefined;\n  attachmentStaging?:\n    | Parameters<\n        DocumentsPersistence[\"commitDocumentMutation\"]\n      >[1][\"attachmentStaging\"]\n    | undefined;\n  canStartDurableMutation?: (() => boolean) | undefined;\n  clearSyncFailure?: boolean | undefined;\n  commitSideEffect?: (transactionExecSql: ExecSql) => Promise<void>;\n  containerId?: string | null | undefined;\n  documentProjectors: DocumentProjectorRegistryInput;\n  execSql: ExecSql;\n  patch?: Partial<StoredDocumentRecord> | undefined;\n  pendingUpdate?: PendingUpdateFields | undefined;\n}\n\nasync function loadSupersededPersistedDocumentState(input: {\n  creationSuperseded: boolean;\n  execSql: ExecSql;\n  localId: string;\n  persistence: DocumentsPersistence;\n  record: StoredDocumentRecord;\n  syncIdentitySuperseded: boolean;\n}): Promise<PersistedDocumentState | null> {\n  const { document, historyRestoreState } =\n    await input.persistence.loadDocumentWithHistoryRestoreState(\n      input.execSql,\n      input.localId,\n    );\n  if (!document) return null;\n  const syncIdentitySuperseded =\n    input.syncIdentitySuperseded ||\n    !documentSyncSecurityContextMatches(document, input.record);\n  return {\n    ...(input.creationSuperseded ? { creationSuperseded: true as const } : {}),\n    historyRestoreState,\n    pullContinuationSuperseded: true,\n    record: document,\n    ...(syncIdentitySuperseded\n      ? { syncIdentitySuperseded: true as const }\n      : {}),\n  };\n}\n\nfunction resolveNullableDocumentRuntimeField(\n  patch: Partial<StoredDocumentRecord>,\n  key: NullableDocumentRuntimeField,\n  currentValue: string | null | undefined,\n  resetWhenUnpatched = false,\n): string | null {\n  if (Object.hasOwn(patch, key)) return patch[key] ?? null;\n  return resetWhenUnpatched ? null : (currentValue ?? null);\n}\n\nfunction resolveStoredDocumentContainerId(input: {\n  containerId?: string | null | undefined;\n  currentRecord: StoredDocumentRecord | null;\n  patch: Partial<StoredDocumentRecord>;\n}): string | null {\n  if (Object.hasOwn(input.patch, \"containerId\")) {\n    return input.patch.containerId ?? null;\n  }\n  return input.currentRecord?.containerId ?? input.containerId ?? null;\n}\n\nfunction resolveStoredDocumentPullState(input: {\n  currentRecord: StoredDocumentRecord | null;\n  patch: Partial<StoredDocumentRecord>;\n  securityContextChanged: boolean;\n}): Pick<\n  StoredDocumentRecord,\n  \"pullContinuation\" | \"pullContinuationRecoveryRequired\"\n> {\n  if (Object.hasOwn(input.patch, \"pullContinuation\")) {\n    return { pullContinuation: input.patch.pullContinuation ?? null };\n  }\n  if (input.securityContextChanged) return { pullContinuation: null };\n  if (input.currentRecord?.pullContinuationRecoveryRequired) {\n    return { pullContinuationRecoveryRequired: true };\n  }\n  return { pullContinuation: input.currentRecord?.pullContinuation ?? null };\n}\n\nfunction buildStoredDocumentRecord(input: {\n  containerId?: string | null | undefined;\n  currentDoc: DocumentContentState;\n  currentRecord: StoredDocumentRecord | null;\n  documentProjectors: DocumentProjectorRegistry;\n  localId: string;\n  patch: Partial<StoredDocumentRecord>;\n}) {\n  const { currentDoc, currentRecord, documentProjectors, localId, patch } =\n    input;\n  const currentDocumentId = currentRecord?.documentId ?? null;\n  const nextDocumentId = patch.documentId ?? currentDocumentId;\n  const documentIdChanged = nextDocumentId !== currentDocumentId;\n  const currentAccessEpoch =\n    currentRecord?.accessEpoch ?? DEFAULT_DOCUMENT_ACCESS_EPOCH;\n  const nextAccessEpoch = patch.accessEpoch ?? currentAccessEpoch;\n  const securityContextChanged =\n    documentIdChanged || nextAccessEpoch !== currentAccessEpoch;\n  const documentState = readStoredDocumentState(currentDoc, documentProjectors);\n  const record: StoredDocumentRecord = {\n    id: currentRecord?.id ?? localId,\n    accessEpoch: nextAccessEpoch,\n    accessStateHash: resolveNullableDocumentRuntimeField(\n      patch,\n      \"accessStateHash\",\n      currentRecord?.accessStateHash,\n      securityContextChanged,\n    ),\n    containerId: resolveStoredDocumentContainerId({\n      containerId: input.containerId,\n      currentRecord,\n      patch,\n    }),\n    contentKeyBundle: resolveNullableDocumentRuntimeField(\n      patch,\n      \"contentKeyBundle\",\n      currentRecord?.contentKeyBundle,\n      securityContextChanged,\n    ),\n    documentId: nextDocumentId,\n    effectiveAccessLevel:\n      patch.effectiveAccessLevel ?? currentRecord?.effectiveAccessLevel ?? null,\n    documentKekTargets: resolveNullableDocumentRuntimeField(\n      patch,\n      \"documentKekTargets\",\n      currentRecord?.documentKekTargets,\n      securityContextChanged,\n    ),\n    documentKind: patch.documentKind ?? documentState.documentKind,\n    documentManifestBundle: resolveNullableDocumentRuntimeField(\n      patch,\n      \"documentManifestBundle\",\n      currentRecord?.documentManifestBundle,\n      securityContextChanged,\n    ),\n    lastCommitLsn: resolveNullableDocumentRuntimeField(\n      patch,\n      \"lastCommitLsn\",\n      currentRecord?.lastCommitLsn,\n      documentIdChanged,\n    ),\n    snapshotEndVersion:\n      patch.snapshotEndVersion ?? currentRecord?.snapshotEndVersion ?? \"\",\n    pendingBaseVersion:\n      patch.pendingBaseVersion !== undefined\n        ? patch.pendingBaseVersion\n        : (currentRecord?.pendingBaseVersion ?? null),\n    recoveryGeneration:\n      patch.recoveryGeneration ?? currentRecord?.recoveryGeneration ?? 0,\n    ...resolveStoredDocumentPullState({\n      currentRecord,\n      patch,\n      securityContextChanged,\n    }),\n    text: patch.text ?? getTextValue(currentDoc),\n    title: patch.title ?? documentState.title,\n  };\n  return { documentState, record };\n}\n\nasync function saveDocumentClientProjection(input: {\n  currentRecord: StoredDocumentRecord | null;\n  documentProjectors: DocumentProjectorRegistry;\n  documentState: ReturnType<typeof readStoredDocumentState>;\n  execSql: ExecSql;\n  localId: string;\n  record: StoredDocumentRecord;\n  updatedAt: string;\n}): Promise<void> {\n  const previousKind =\n    input.currentRecord?.documentKind ?? DEFAULT_DOCUMENT_KIND;\n  const nextKind = input.record.documentKind ?? DEFAULT_DOCUMENT_KIND;\n  if (previousKind !== nextKind) {\n    await input.documentProjectors.deleteStoredDocumentClientProjection({\n      documentKind: previousKind,\n      execSql: input.execSql,\n      localId: input.localId,\n    });\n  }\n  await input.documentProjectors.saveStoredDocumentClientProjection({\n    containerId: input.record.containerId,\n    documentId: input.record.documentId,\n    documentKind: nextKind,\n    execSql: input.execSql,\n    localId: input.record.id,\n    structuredFields: input.documentState.structuredFields,\n    text: input.record.text,\n    title: input.record.title ?? input.documentState.title,\n    updatedAt: input.updatedAt,\n  });\n}\n\nasync function settleSupersededDocumentMutation(input: {\n  acceptedPendingUpdateIds: readonly string[];\n  lockedExecSql: ExecSql;\n  mutation: Awaited<ReturnType<typeof prepareDocumentMutation>>;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState | null> {\n  const { mutation, persistInput } = input;\n  if (!mutation.mutationCurrentRecord) return null;\n  const authoritativeRecord = persistInput.expectedSyncState\n    ? await persistInput.persistence.settleAcceptedPendingUpdates(\n        input.lockedExecSql,\n        {\n          expectedRecord: persistInput.expectedSyncState.record,\n          pendingUpdateIds: input.acceptedPendingUpdateIds,\n        },\n      )\n    : mutation.mutationCurrentRecord;\n  if (!authoritativeRecord) return null;\n  return loadSupersededPersistedDocumentState({\n    creationSuperseded: mutation.creationSuperseded,\n    execSql: input.lockedExecSql,\n    localId: persistInput.localId,\n    persistence: persistInput.persistence,\n    record: authoritativeRecord,\n    syncIdentitySuperseded: !mutation.securityContextMatches,\n  });\n}\n\nasync function loadConcurrentCreationWinner(input: {\n  execSql: ExecSql;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState> {\n  const winningRecord = await input.persistInput.persistence.loadDocument(\n    input.execSql,\n    input.persistInput.localId,\n  );\n  if (!winningRecord) {\n    throw new Error(\"Concurrent document creation lost without a winner\");\n  }\n  const winner = await loadSupersededPersistedDocumentState({\n    creationSuperseded: true,\n    execSql: input.execSql,\n    localId: input.persistInput.localId,\n    persistence: input.persistInput.persistence,\n    record: winningRecord,\n    syncIdentitySuperseded: true,\n  });\n  if (!winner) {\n    throw new Error(\"Concurrent document creation winner disappeared\");\n  }\n  return winner;\n}\n\nasync function resolveInitialDocumentCreation(input: {\n  execSql: ExecSql;\n  persistInput: PersistDocumentStateInput;\n  record: StoredDocumentRecord;\n  savedAt: string | null;\n}): Promise<PersistedDocumentState | null> {\n  if (input.savedAt !== null) {\n    return { record: input.record, updatedAt: input.savedAt };\n  }\n  if (\n    input.persistInput.canStartDurableMutation &&\n    !input.persistInput.canStartDurableMutation()\n  ) {\n    return null;\n  }\n  return loadConcurrentCreationWinner({\n    execSql: input.execSql,\n    persistInput: input.persistInput,\n  });\n}\n\nasync function resolveDocumentMutationCommit(input: {\n  committed: Awaited<\n    ReturnType<DocumentsPersistence[\"commitDocumentMutation\"]>\n  >;\n  lockedExecSql: ExecSql;\n  persistInput: PersistDocumentStateInput;\n  record: StoredDocumentRecord;\n}): Promise<PersistedDocumentState | null | \"retry\"> {\n  const { committed, persistInput, record } = input;\n  if (\n    persistInput.canStartDurableMutation &&\n    !persistInput.canStartDurableMutation()\n  ) {\n    return null;\n  }\n  if (committed.committed) return { record, updatedAt: committed.updatedAt };\n  if (!committed.currentRecord) return null;\n  if (persistInput.expectedSyncState === undefined) return \"retry\";\n  return loadSupersededPersistedDocumentState({\n    creationSuperseded: false,\n    execSql: input.lockedExecSql,\n    localId: persistInput.localId,\n    persistence: persistInput.persistence,\n    record: committed.currentRecord,\n    syncIdentitySuperseded: !documentSyncSecurityContextMatches(\n      committed.currentRecord,\n      persistInput.expectedSyncState.record,\n    ),\n  });\n}\n\nasync function commitOnePreparedDocumentMutation(input: {\n  acceptedPendingUpdateIds: readonly string[];\n  documentProjectors: DocumentProjectorRegistry;\n  lockedExecSql: ExecSql;\n  mutation: Exclude<\n    Awaited<ReturnType<typeof prepareDocumentMutation>>,\n    { pullContinuationSuperseded: true }\n  >;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState | null | \"retry\"> {\n  const { mutation, persistInput } = input;\n  const { documentState, record } = buildStoredDocumentRecord({\n    containerId: persistInput.containerId,\n    currentDoc: persistInput.currentDoc,\n    currentRecord: mutation.mutationCurrentRecord,\n    documentProjectors: input.documentProjectors,\n    localId: persistInput.localId,\n    patch: mutation.resolvedPatch,\n  });\n  if (!mutation.mutationCurrentRecord) {\n    const savedAt = await createInitialDocumentRows({\n      currentDoc: persistInput.currentDoc,\n      execSql: input.lockedExecSql,\n      pendingUpdate: persistInput.pendingUpdate,\n      persistence: persistInput.persistence,\n      record,\n      stillCurrent: persistInput.canStartDurableMutation,\n      saveClientProjection: (transactionExecSql, updatedAt) =>\n        saveDocumentClientProjection({\n          currentRecord: null,\n          documentProjectors: input.documentProjectors,\n          documentState,\n          execSql: transactionExecSql,\n          localId: persistInput.localId,\n          record,\n          updatedAt,\n        }),\n    });\n    return resolveInitialDocumentCreation({\n      execSql: input.lockedExecSql,\n      persistInput,\n      record,\n      savedAt,\n    });\n  }\n\n  const committed = await persistInput.persistence.commitDocumentMutation(\n    input.lockedExecSql,\n    {\n      acceptedPendingUpdateIds: input.acceptedPendingUpdateIds,\n      clearSyncFailure: persistInput.clearSyncFailure,\n      ...(persistInput.attachmentRemoval\n        ? { attachmentRemoval: persistInput.attachmentRemoval }\n        : {}),\n      ...(persistInput.attachmentStaging\n        ? { attachmentStaging: persistInput.attachmentStaging }\n        : {}),\n      document: record,\n      expectedRecord: mutation.mutationCurrentRecord,\n      ...(persistInput.historyCheckpoint\n        ? { historyCheckpoint: persistInput.historyCheckpoint }\n        : {}),\n      ...(persistInput.historyUpdateOrigin\n        ? { historyUpdateOrigin: persistInput.historyUpdateOrigin }\n        : {}),\n      ...(persistInput.historyUpdates\n        ? { historyUpdates: persistInput.historyUpdates }\n        : {}),\n      ...(persistInput.pendingUpdate\n        ? { pendingUpdate: persistInput.pendingUpdate }\n        : {}),\n      settleAcceptedPendingOnConflict:\n        persistInput.expectedSyncState !== undefined,\n      ...(persistInput.canStartDurableMutation\n        ? { stillCurrent: persistInput.canStartDurableMutation }\n        : {}),\n    },\n    async (transactionExecSql, updatedAt) => {\n      await saveDocumentClientProjection({\n        currentRecord: mutation.mutationCurrentRecord,\n        documentProjectors: input.documentProjectors,\n        documentState,\n        execSql: transactionExecSql,\n        localId: persistInput.localId,\n        record,\n        updatedAt,\n      });\n      await persistInput.commitSideEffect?.(transactionExecSql);\n    },\n  );\n  return resolveDocumentMutationCommit({\n    committed,\n    lockedExecSql: input.lockedExecSql,\n    persistInput,\n    record,\n  });\n}\n\nexport async function commitPreparedDocumentState(input: {\n  documentProjectors: DocumentProjectorRegistry;\n  lockedExecSql: ExecSql;\n  patch: Partial<StoredDocumentRecord>;\n  persistInput: PersistDocumentStateInput;\n}): Promise<PersistedDocumentState | null> {\n  const { lockedExecSql, persistInput } = input;\n  if (\n    await refuseDeletedDocumentPersist({\n      currentRecord: persistInput.currentRecord,\n      documentProjectors: input.documentProjectors,\n      execSql: lockedExecSql,\n      localId: persistInput.localId,\n      persistence: persistInput.persistence,\n    })\n  ) {\n    return null;\n  }\n  const acceptedPendingUpdateIds = persistInput.acceptedPendingUpdateIds ?? [];\n  for (\n    let attempt = 0;\n    attempt < MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS;\n    attempt += 1\n  ) {\n    const mutation = await prepareDocumentMutation(\n      persistInput,\n      lockedExecSql,\n      input.patch,\n    );\n    if (mutation.pullContinuationSuperseded) {\n      return settleSupersededDocumentMutation({\n        acceptedPendingUpdateIds,\n        lockedExecSql,\n        mutation,\n        persistInput,\n      });\n    }\n    const result = await commitOnePreparedDocumentMutation({\n      acceptedPendingUpdateIds,\n      documentProjectors: input.documentProjectors,\n      lockedExecSql,\n      mutation,\n      persistInput,\n    });\n    if (result !== \"retry\") return result;\n  }\n  throw new Error(\n    `Document mutation commit gave up after ${MAX_DOCUMENT_MUTATION_COMMIT_ATTEMPTS} concurrent conflicts`,\n  );\n}\n"]}

package/workflows/documents/index.d.ts

@@ -9,27 +9,27 @@ export type { ExecSql } from "../../data/sqlite/sqlSchema.js";
 export { selectDocumentSyncOutgoingBatch } from "../../data/sync/documentSyncOutgoingBatch.js";
 export { settleOutgoingPassAndDecideReArm } from "../../data/sync/outgoingUpdateSettlement.js";
 export { didRegainSyncPrerequisites, isDatabaseUnavailableError, } from "../../data/sync/syncCoordinator.js";
-export { deleteLocalDocumentAttachment, deletePendingDocumentAttachment, markLocalDocumentAttachmentDetached, saveLocalDocumentAttachments, savePendingDocumentAttachment, } from "./attachmentPersistence.js";
+export { deleteLocalDocumentAttachment, deletePendingDocumentAttachment, markLocalDocumentAttachmentDetached, saveLocalDocumentAttachments, savePendingDocumentAttachment, } from "./attachments/attachmentPersistence.js";
+export { runSerializedDocumentBlobMutation } from "./attachments/blobMutationLock.js";
+export { reclaimDocumentOrphanBlobs } from "./attachments/orphanBlobReclaims.js";
 export { resolveDocumentCreateAuthor } from "./author.js";
-export { runSerializedDocumentBlobMutation } from "./blobMutationLock.js";
-export { buildMaterializedDocumentCreatePlan, createRemoteDocument, documentWriterProjectionFromCreateResponse, } from "./create.js";
+export { buildMaterializedDocumentCreatePlan, createRemoteDocument, documentWriterProjectionFromCreateResponse, } from "./create/index.js";
 export { importDocumentHistoryTailUpdates, loadPersistedDocumentContent, mergePersistedDocumentHistory, } from "./historyContent.js";
-export { buildMaterializedDocumentLinkSetMutationPlan } from "./linkSet.js";
-export { relinkRemoteDocument } from "./linkSetRemote.js";
-export { reclaimDocumentOrphanBlobs } from "./orphanBlobReclaims.js";
+export { buildMaterializedDocumentLinkSetMutationPlan } from "./linkSet/index.js";
+export { relinkRemoteDocument } from "./linkSet/linkSetRemote.js";
 export { enqueuePendingDocumentUpdate, listPendingDocumentUpdates, } from "./pendingUpdatePersistence.js";
-export { type DiscardedDocumentShellResult, deletePersistedDocument, discardPersistedDocumentToShell, } from "./persistedDocumentRemoval.js";
 export { type AttachmentRemovalRows, type AttachmentStagingRows, DOCUMENTS_APP_KIND, type DocumentRecord, type DocumentsPersistence, defaultDocumentsPersistence, type LocalAttachmentRecord, loadPersistedDocumentStoreState, type PendingAttachmentRecord, type PendingAttachmentUploadIdentity, type PendingUpdateInsert, type PendingUpdateRecord, persistDocumentState, type RelinkPersistedDocumentInput, runSerializedSqlMutation, } from "./persistence.js";
 export { createDocumentProjectionUserKeyResolver, type DocumentProjectionKeyRuntime, type DocumentProjectionUserKeyResolver, didDocumentProjectionKeyRuntimeChange, } from "./projectionKeys.js";
-export { buildDocumentPurgeRequest, purgeRemoteDocument, } from "./purge.js";
-export type { SyncRemoteDocumentInput } from "./readOnlySync.js";
+export { buildDocumentPurgeRequest, purgeRemoteDocument, } from "./purge/index.js";
+export { type DiscardedDocumentShellResult, deletePersistedDocument, discardPersistedDocumentToShell, } from "./purge/persistedDocumentRemoval.js";
 export { createDocumentsWorkflowRuntime, type DocumentsWorkflowRuntime, type DocumentsWorkflowRuntimeGroups, type DocumentsWorkflowRuntimeInfra, type DocumentsWorkflowRuntimeInput, type DocumentsWorkflowRuntimeInputGroups, } from "./runtime.js";
-export { hasDocumentUpdateEvent, syncRemoteDocument, } from "./sync.js";
-export type { DocumentSyncContainerRekeyBuilder } from "./syncAttemptState.js";
-export { DocumentRawHistoryUnavailableError } from "./syncContentKeys.js";
-export { describeDocumentRevalidationFailure, describeDocumentSyncSubmitFailure, type TerminalSubmitFailureHandler, } from "./syncFailureClassification.js";
-export { shouldClearDocumentSyncFailureAfterPass } from "./syncFailureClearance.js";
-export { type DocumentSyncLane, registerDocumentSyncLane, requestDocumentSyncLaneAndWait, } from "./syncLane.js";
-export type { RekeyPendingUpdate } from "./syncRecoveryRekey.js";
-export { DOCUMENT_SYNC_TRACE_FRAGMENT, DOCUMENT_SYNC_TRACE_PATTERN, } from "./syncTrace.js";
+export { hasDocumentUpdateEvent, syncRemoteDocument, } from "./sync/index.js";
+export type { SyncRemoteDocumentInput } from "./sync/readOnlySync.js";
+export type { DocumentSyncContainerRekeyBuilder } from "./sync/syncAttemptState.js";
+export { type DocumentSyncLane, registerDocumentSyncLane, requestDocumentSyncLaneAndWait, } from "./sync/syncLane.js";
+export { DOCUMENT_SYNC_TRACE_FRAGMENT, DOCUMENT_SYNC_TRACE_PATTERN, } from "./sync/syncTrace.js";
+export { describeDocumentRevalidationFailure, describeDocumentSyncSubmitFailure, type TerminalSubmitFailureHandler, } from "./syncFailures/syncFailureClassification.js";
+export { shouldClearDocumentSyncFailureAfterPass } from "./syncFailures/syncFailureClearance.js";
+export { DocumentRawHistoryUnavailableError } from "./syncPlan/syncContentKeys.js";
+export type { RekeyPendingUpdate } from "./syncRekeys/syncRecoveryRekey.js";
 export { createDocumentWriterPublicKeyResolver } from "./writerKeys.js";

package/workflows/documents/index.js

@@ -7,25 +7,25 @@ export { clearDocumentSyncFailure, invalidateDocumentSyncPullContinuation, recor
 export { selectDocumentSyncOutgoingBatch } from "../../data/sync/documentSyncOutgoingBatch.js";
 export { settleOutgoingPassAndDecideReArm } from "../../data/sync/outgoingUpdateSettlement.js";
 export { didRegainSyncPrerequisites, isDatabaseUnavailableError, } from "../../data/sync/syncCoordinator.js";
-export { deleteLocalDocumentAttachment, deletePendingDocumentAttachment, markLocalDocumentAttachmentDetached, saveLocalDocumentAttachments, savePendingDocumentAttachment, } from "./attachmentPersistence.js";
+export { deleteLocalDocumentAttachment, deletePendingDocumentAttachment, markLocalDocumentAttachmentDetached, saveLocalDocumentAttachments, savePendingDocumentAttachment, } from "./attachments/attachmentPersistence.js";
+export { runSerializedDocumentBlobMutation } from "./attachments/blobMutationLock.js";
+export { reclaimDocumentOrphanBlobs } from "./attachments/orphanBlobReclaims.js";
 export { resolveDocumentCreateAuthor } from "./author.js";
-export { runSerializedDocumentBlobMutation } from "./blobMutationLock.js";
-export { buildMaterializedDocumentCreatePlan, createRemoteDocument, documentWriterProjectionFromCreateResponse, } from "./create.js";
+export { buildMaterializedDocumentCreatePlan, createRemoteDocument, documentWriterProjectionFromCreateResponse, } from "./create/index.js";
 export { importDocumentHistoryTailUpdates, loadPersistedDocumentContent, mergePersistedDocumentHistory, } from "./historyContent.js";
-export { buildMaterializedDocumentLinkSetMutationPlan } from "./linkSet.js";
-export { relinkRemoteDocument } from "./linkSetRemote.js";
-export { reclaimDocumentOrphanBlobs } from "./orphanBlobReclaims.js";
+export { buildMaterializedDocumentLinkSetMutationPlan } from "./linkSet/index.js";
+export { relinkRemoteDocument } from "./linkSet/linkSetRemote.js";
 export { enqueuePendingDocumentUpdate, listPendingDocumentUpdates, } from "./pendingUpdatePersistence.js";
-export { deletePersistedDocument, discardPersistedDocumentToShell, } from "./persistedDocumentRemoval.js";
 export { DOCUMENTS_APP_KIND, defaultDocumentsPersistence, loadPersistedDocumentStoreState, persistDocumentState, runSerializedSqlMutation, } from "./persistence.js";
 export { createDocumentProjectionUserKeyResolver, didDocumentProjectionKeyRuntimeChange, } from "./projectionKeys.js";
-export { buildDocumentPurgeRequest, purgeRemoteDocument, } from "./purge.js";
+export { buildDocumentPurgeRequest, purgeRemoteDocument, } from "./purge/index.js";
+export { deletePersistedDocument, discardPersistedDocumentToShell, } from "./purge/persistedDocumentRemoval.js";
 export { createDocumentsWorkflowRuntime, } from "./runtime.js";
-export { hasDocumentUpdateEvent, syncRemoteDocument, } from "./sync.js";
-export { DocumentRawHistoryUnavailableError } from "./syncContentKeys.js";
-export { describeDocumentRevalidationFailure, describeDocumentSyncSubmitFailure, } from "./syncFailureClassification.js";
-export { shouldClearDocumentSyncFailureAfterPass } from "./syncFailureClearance.js";
-export { registerDocumentSyncLane, requestDocumentSyncLaneAndWait, } from "./syncLane.js";
-export { DOCUMENT_SYNC_TRACE_FRAGMENT, DOCUMENT_SYNC_TRACE_PATTERN, } from "./syncTrace.js";
+export { hasDocumentUpdateEvent, syncRemoteDocument, } from "./sync/index.js";
+export { registerDocumentSyncLane, requestDocumentSyncLaneAndWait, } from "./sync/syncLane.js";
+export { DOCUMENT_SYNC_TRACE_FRAGMENT, DOCUMENT_SYNC_TRACE_PATTERN, } from "./sync/syncTrace.js";
+export { describeDocumentRevalidationFailure, describeDocumentSyncSubmitFailure, } from "./syncFailures/syncFailureClassification.js";
+export { shouldClearDocumentSyncFailureAfterPass } from "./syncFailures/syncFailureClearance.js";
+export { DocumentRawHistoryUnavailableError } from "./syncPlan/syncContentKeys.js";
 export { createDocumentWriterPublicKeyResolver } from "./writerKeys.js";
 //# sourceMappingURL=index.js.map