@tearleads/client-sdk 0.1.111 → 0.1.112

package/data/sqlite/schema/index.js

@@ -222,13 +222,15 @@ export const documentPurgeCheckpoints = sqliteTable("document_purge_checkpoints"
     updatedAt: text("updated_at").notNull(),
 });
 /**
- * Durable trust-on-first-use pins for remote user identity bundles.
+ * Durable pins for user identity bundles.
  *
- * The first validated identity observed for a user in a configured API trust
+ * The first validated identity accepted for a user in a configured API trust
  * domain is inserted once. Later observations must match every suite, public
- * key, and fingerprint exactly; the persistence adapter never updates these
- * rows. `firstSeenAt` records when the local trust decision was made and is
- * likewise immutable.
+ * key, and fingerprint exactly; the persistence adapter never changes those
+ * columns. `firstSeenAt` records when the local trust decision was made and is
+ * likewise immutable. `provenance` (`self`, `link`, or `observed`) records how
+ * the pin was established; only `self` and `link` admit a user, and it only
+ * rises. A table without it is an obsolete local database.
  *
  * Indexes:
  * - `(identityTrustDomain, userId)` is the primary key and scopes a user pin to
@@ -253,6 +255,9 @@ export const trustedUserIdentityPins = sqliteTable("trusted_user_identity_pins",
     encapsulationPublicKey: text("encapsulation_public_key").notNull(),
     encapsulationKeyFingerprint: text("encapsulation_key_fingerprint").notNull(),
     firstSeenAt: text("first_seen_at").notNull(),
+    provenance: text("provenance", {
+        enum: ["self", "link", "observed"],
+    }).notNull(),
 }, (table) => [
     primaryKey({
         columns: [table.identityTrustDomain, table.userId],
@@ -426,7 +431,10 @@ export const keyingCheckpointTables = [
     defineSqlTableSchema(principalPolicyCheckpoints),
 ];
 export const trustedUserIdentityPinTables = [
-    defineSqlTableSchema(trustedUserIdentityPins),
+    {
+        ...defineSqlTableSchema(trustedUserIdentityPins),
+        requiredColumns: ["provenance"],
+    },
 ];
 const securityIncidentTables = [
     securityIncidentTable,

package/data/sqlite/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { sql } from \"drizzle-orm\";\nimport {\n  index,\n  integer,\n  primaryKey,\n  sqliteTable,\n  text,\n  uniqueIndex,\n} from \"drizzle-orm/sqlite-core\";\nimport { defineSqlTableSchema, type SqlTableSchema } from \"../sqlTableSchema\";\nimport { containerDocumentTombstoneHolds } from \"./containerDocumentTombstoneHoldSchema\";\nimport {\n  containerSQLiteSchema,\n  containerTableSchemas,\n} from \"./containerSchema\";\nimport {\n  documentAttachmentBlobProjection,\n  documentPendingAttachments,\n} from \"./documentAttachmentSchema\";\nimport {\n  documentDiscoveryHeads,\n  documentDiscoverySequence,\n  pendingDocumentDiscoveries,\n} from \"./documentDiscoveryEvidenceSchema\";\nimport {\n  documentOrphanBlobReclaims,\n  documentOrphanBlobReclaimTable,\n} from \"./documentOrphanBlobReclaimSchema\";\nimport { documentIntentLinkTargets } from \"./documentPlacementIntentSchema\";\nimport { localIntents } from \"./localIntentSchema\";\nimport * as organizationDataUsage from \"./organizationDataUsageSchema\";\nimport { organizationFounders } from \"./organizationFounderSchema\";\nimport * as provisioningAttempt from \"./organizationProvisioningAttemptSchema\";\nimport {\n  organizationReadModelSQLiteSchema,\n  organizationReadModelTables,\n} from \"./organizationReadModelTableRegistry\";\nimport * as organizationSyncPause from \"./organizationSyncPauseSchema\";\nimport { principalGrantRetirements } from \"./principalGrantRetirementSchema\";\nimport {\n  principalHistoryEntries,\n  principalHistoryEvidenceTables,\n  principalHistoryNodes,\n  principalHistoryPrefixes,\n} from \"./principalHistoryEvidenceSchema\";\nimport {\n  principalHistoryNodeReferences,\n  principalHistoryRootOwners,\n} from \"./principalHistoryNodeRetentionSchema\";\nimport { principalKeyEnvelopeArchive } from \"./principalHistoryRetentionSchema\";\nimport {\n  principalHistoryStages,\n  principalHistoryStageTables,\n} from \"./principalHistoryStageSchema\";\nimport {\n  principalMutationJournal,\n  principalMutationJournalTables,\n} from \"./principalMutationJournalSchema\";\nimport {\n  principalPolicies,\n  principalPolicyBundleHistory,\n  principalPolicyBundleReferences,\n  principalPolicyCheckpoints,\n  principalPolicyOrganizations,\n} from \"./principalPolicySchema\";\nimport {\n  securityIncidents,\n  securityIncidentTable,\n} from \"./securityIncidentSchema\";\nimport {\n  verifiedAccessManifestBundles,\n  verifiedManifestBundleTables,\n} from \"./verifiedManifestBundleSchema\";\n\nexport {\n  containerHydrationTombstones,\n  containers,\n  dormantContainerMetadata,\n  dormantMetadataSweepRequests,\n  supersededContainerBindings,\n} from \"./containerSchema\";\nexport {\n  documentAttachmentBlobProjection,\n  documentPendingAttachments,\n} from \"./documentAttachmentSchema\";\nexport {\n  inContainerIntentLanes,\n  inLocalIntentLane,\n  LOCAL_INTENT_LANES,\n  LOCAL_INTENT_SUBJECT,\n  localIntents,\n} from \"./localIntentSchema\";\nexport {\n  principalPolicies,\n  principalPolicyBundleHistory,\n  principalPolicyBundleReferences,\n  principalPolicyCheckpoints,\n  principalPolicyOrganizations,\n} from \"./principalPolicySchema\";\nexport { securityIncidents } from \"./securityIncidentSchema\";\nexport { containerDocumentTombstoneHolds, organizationReadModelTables };\n\nconst accessLevelColumn = \"effective_access_level\";\n\n/**\n * Durable Loro-backed document records shared by app features.\n *\n * This table stores encrypted document runtime state for multiple app domains.\n * `appKind` namespaces records for documents and container metadata. User-facing\n * list data is projected into feature-specific read models.\n *\n * Columns:\n * - `appKind`: Local domain namespace for the row, such as `documents` or\n *   `container-metadata`.\n * - `localId`: Stable local id inside `appKind`. It may be created before a\n *   server `documentId` exists.\n * - `documentId`: Server document id once the record is known remotely, or\n *   `null` while the document is local-only.\n * - `accessEpoch`: Latest access epoch persisted for the document. Defaults to\n *   the initial epoch.\n * - `accessStateHash`: Current document access/manifest state hash returned by\n *   sync, when known.\n * - `lastCommitLsn`: Last remote commit cursor applied to this local document.\n * - `documentManifestBundle`: Serialized document manifest bundle used for\n *   encrypted document sync.\n * - `contentKeyBundle`: Serialized content-key material needed to open the\n *   local document.\n * - `documentKekTargets`: Serialized KEK target state for document key wraps.\n * - `pendingBaseVersion`: Encoded oplog version through which every persisted\n *   op is already enqueued or synced. Persisted so a restart restores the\n *   outgoing-delta marker instead of re-seeding it past a device-first\n *   `deferRemoteSync` write's un-advanced op. `null` when unset.\n * - `snapshotEndVersion`: Encoded end version vector of the persisted content\n *   (which lives in the durable-history tables, never on this row), written on\n *   every content persist. Lets the pending-write queue's deferred-tail scan\n *   compare version coverage without loading content. Empty string when the\n *   document has never hydrated content, which readers treat as \"no deferred\n *   tail claimable\".\n * - `recoveryGeneration`: Atomic raw-history recovery writer fence.\n * - `recoveryDocumentId`: Former server id for cross-client post-purge recreation.\n * - `pullContinuation`: Durable progress for the next bounded remote pull.\n * - `syncFailureStatus`, `syncFailureMessage`, `syncFailureAttemptedAt`: The\n *   last terminal sync failure or quarantined incoming update for this scope.\n *   The durable write queue (queued rows of `documentHistoryUpdates`) has no\n *   status columns, so these let the write-queue view and footer explain why\n *   the document is blocked. `syncFailureMessage` is non-null exactly when a\n *   failure is recorded; a newer failure replaces the old, and a later fully\n *   validated sync pass, a remote reset, or the scope's teardown clears all\n *   three.\n * - `updatedAt`: Local timestamp for the last persisted runtime-state update.\n *\n * Indexes:\n * - `(appKind, localId)` is the primary key and scopes local document lookups.\n * - `(appKind, documentId) where documentId is not null` supports resolving a\n *   server document id back to the local row during discovery and relinking.\n */\nexport const documents = sqliteTable(\n  \"documents\",\n  {\n    appKind: text(\"app_kind\").notNull(),\n    localId: text(\"local_id\").notNull(),\n    documentId: text(\"document_id\"),\n    accessEpoch: integer(\"access_epoch\").notNull().default(1),\n    accessStateHash: text(\"access_state_hash\"),\n    effectiveAccessLevel: text(accessLevelColumn).notNull().default(\"read\"),\n    lastCommitLsn: text(\"last_commit_lsn\"),\n    documentManifestBundle: text(\"document_manifest_bundle\"),\n    contentKeyBundle: text(\"content_key_bundle\"),\n    documentKekTargets: text(\"document_kek_targets\"),\n    pendingBaseVersion: text(\"pending_base_version\"),\n    pullContinuation: text(\"pull_continuation\"),\n    recoveryGeneration: integer(\"recovery_generation\").notNull().default(0),\n    recoveryDocumentId: text(\"recovery_document_id\"),\n    snapshotEndVersion: text(\"snapshot_end_version\").notNull().default(\"\"),\n    syncFailureStatus: integer(\"sync_failure_status\"),\n    syncFailureMessage: text(\"sync_failure_message\"),\n    syncFailureAttemptedAt: text(\"sync_failure_attempted_at\"),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.appKind, table.localId] }),\n    index(\"documents_app_document_idx\")\n      .on(table.appKind, table.documentId)\n      .where(sql`${table.documentId} IS NOT NULL`),\n  ],\n);\n\n/**\n * Full-history persistence for local documents (checkpoint + tail) — the ONLY\n * durable content source. Record rows in `documents` carry runtime metadata\n * and the content frontier (`snapshotEndVersion`), never content. The\n * checkpoint holds a full-history snapshot refreshed only at compaction, and\n * the tail appends every update (local deltas and decrypted remote updates)\n * written since. Restore = import checkpoint + replay tail; compaction =\n * export full history from the live doc, replace the checkpoint, clear the\n * tail — all bounded and amortized. Container metadata stores its content (an\n * exported-updates blob) as its checkpoint row, with no tail.\n */\nexport const documentHistoryCheckpoints = sqliteTable(\n  \"document_history_checkpoints\",\n  {\n    appKind: text(\"app_kind\").notNull(),\n    localId: text(\"local_id\").notNull(),\n    snapshot: text(\"snapshot\").notNull(),\n    endVersionVector: text(\"end_version_vector\").notNull(),\n    revision: text(\"revision\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.appKind, table.localId] })],\n);\n\n/**\n * The local update log: one row per Loro update, serving as both the history\n * tail (restore = checkpoint + tail) and the outbound write queue.\n *\n * Every locally authored update is stored once. While it waits for sync it\n * carries an `updateId` (the id submitted to the server) and the version-vector\n * metadata the submission needs; settlement clears them, leaving the row as\n * ordinary tail history until compaction folds it into a checkpoint.\n *\n * Columns:\n * - `id`: Row id; tail compaction deletes by it.\n * - `appKind`, `localId`: Document scope matching `documents`.\n * - `updateData`: Serialized Loro update payload.\n * - `origin`: \"local\" (authored on this device) or \"remote\" (decrypted\n *   pulled update) for tail rows. Restores use it to advance the\n *   outgoing-delta marker across remote rows — their ops are already\n *   server-side — while a local row left behind by a crash stays below the\n *   marker so the next edit re-derives and sends it. \"outbox\" marks a queued\n *   update with no tail role (container metadata, whose content is its\n *   checkpoint, and full-state re-uploads after a remote reset); restores and\n *   compaction never see it and settlement deletes it.\n * - `createdAt`: Insertion timestamp; with `rowid`, deterministic replay order.\n * - `updateId`: Present exactly while the row is queued for sync; rekeyed\n *   after a lost acknowledgement poisons the submitted id.\n * - `partialStartVersionVector` / `partialEndVersionVector`: Version vectors\n *   around a queued partial update.\n * - `sourceVersionVector`: Present on a queued rotation baseline checkpoint.\n * - `rekeyCount`: Durable bound on rekeys of a queued row.\n *\n * Invariant: compaction never deletes a queued row, so a checkpoint can cover\n * a queued update's operations without removing it from the queue.\n */\nexport const documentHistoryUpdates = sqliteTable(\n  \"document_history_updates\",\n  {\n    id: text(\"id\"),\n    appKind: text(\"app_kind\").notNull(),\n    localId: text(\"local_id\").notNull(),\n    updateData: text(\"update_data\").notNull(),\n    origin: text(\"origin\").notNull(),\n    createdAt: text(\"created_at\").notNull(),\n    updateId: text(\"update_id\"),\n    partialStartVersionVector: text(\"partial_start_version_vector\"),\n    partialEndVersionVector: text(\"partial_end_version_vector\"),\n    sourceVersionVector: text(\"source_version_vector\"),\n    rekeyCount: integer(\"rekey_count\").notNull().default(0),\n  },\n  (table) => [\n    primaryKey({ columns: [table.id] }),\n    index(\"document_history_updates_scope_created_idx\").on(\n      table.appKind,\n      table.localId,\n      table.createdAt,\n    ),\n    uniqueIndex(\"document_history_updates_update_id_idx\")\n      .on(table.updateId)\n      .where(sql`${table.updateId} IS NOT NULL`),\n  ],\n);\n\n/**\n * Anti-rollback pin for verified access manifests.\n *\n * Records the highest access-manifest epoch this client has verified for each\n * object, so a later projection that serves an older epoch (rollback) or a\n * conflicting manifest at the same epoch (equivocation) is detected before any\n * key is unwrapped. Updated monotonically after a projection verifies cleanly.\n *\n * Columns:\n * - `objectKind`: Access object kind (`container`, `document`, ...).\n * - `organizationId`: Organization boundary that owns the object.\n * - `objectId`: Stable object id.\n * - `epoch`: Highest verified manifest epoch.\n * - `manifestHash`: Manifest hash pinned at that epoch.\n * - `updatedAt`: Local timestamp for the pin.\n *\n * Indexes:\n * - `(objectKind, organizationId, objectId)` is the primary key and gives one\n *   pin per object.\n */\nexport const accessManifestCheckpoints = sqliteTable(\n  \"access_manifest_checkpoints\",\n  {\n    objectKind: text(\"object_kind\").notNull(),\n    organizationId: text(\"organization_id\").notNull(),\n    objectId: text(\"object_id\").notNull(),\n    epoch: integer(\"epoch\").notNull(),\n    manifestHash: text(\"manifest_hash\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({\n      columns: [table.objectKind, table.organizationId, table.objectId],\n    }),\n  ],\n);\n\n/**\n * Durable terminal pins for documents whose signed purge proof was verified.\n * These survive remote-state resets so a dishonest API cannot later replay the\n * pre-purge writer projection and resurrect locally deleted content.\n */\nexport const documentPurgeCheckpoints = sqliteTable(\n  \"document_purge_checkpoints\",\n  {\n    documentId: text(\"document_id\").primaryKey(),\n    organizationId: text(\"organization_id\").notNull(),\n    documentManifestHash: text(\"document_manifest_hash\").notNull(),\n    purgeEventHash: text(\"purge_event_hash\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n);\n\n/**\n * Durable trust-on-first-use pins for remote user identity bundles.\n *\n * The first validated identity observed for a user in a configured API trust\n * domain is inserted once. Later observations must match every suite, public\n * key, and fingerprint exactly; the persistence adapter never updates these\n * rows. `firstSeenAt` records when the local trust decision was made and is\n * likewise immutable.\n *\n * Indexes:\n * - `(identityTrustDomain, userId)` is the primary key and scopes a user pin to\n *   the host-configured API authority that supplied it.\n * - `(identityTrustDomain, signingKeyFingerprint)` binds the reverse identity\n *   mapping durably, including across session recreation. There is no\n *   migration for a table that already violates it. Earlier builds pinned a\n *   registration's user id before the server confirmed it, so a device that\n *   ran one may hold two users on one key; deployments are greenfield, and\n *   such a device clears its local data, which recreates this table empty. A\n *   device that used an environment before a reset does the same (see\n *   docs/developer/greenfield-reset.md).\n */\nexport const trustedUserIdentityPins = sqliteTable(\n  \"trusted_user_identity_pins\",\n  {\n    identityTrustDomain: text(\"identity_trust_domain\").notNull(),\n    userId: text(\"user_id\").notNull(),\n    formatVersion: integer(\"format_version\").notNull(),\n    signingSuite: text(\"signing_suite\").notNull(),\n    signingPublicKey: text(\"signing_public_key\").notNull(),\n    signingKeyFingerprint: text(\"signing_key_fingerprint\").notNull(),\n    encapsulationSuite: text(\"encapsulation_suite\").notNull(),\n    encapsulationPublicKey: text(\"encapsulation_public_key\").notNull(),\n    encapsulationKeyFingerprint: text(\n      \"encapsulation_key_fingerprint\",\n    ).notNull(),\n    firstSeenAt: text(\"first_seen_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({\n      columns: [table.identityTrustDomain, table.userId],\n    }),\n    uniqueIndex(\"trusted_user_identity_pins_domain_signing_fingerprint_idx\").on(\n      table.identityTrustDomain,\n      table.signingKeyFingerprint,\n    ),\n  ],\n);\n\n/**\n * Local many-to-many projection between documents and containers.\n *\n * The document summary row stores one selected `containerId` for primary list\n * placement, while this table keeps the full set of linked containers returned\n * by container/document sync. Removing a container deletes its links and may\n * repair affected document summary rows to point at another remaining link.\n *\n * Columns:\n * - `documentId`: Server document id whose container links are projected.\n * - `containerId`: Linked container id.\n * - `updatedAt`: Local timestamp for the last replacement of the link set.\n *\n * Indexes:\n * - `(documentId, containerId)` is the primary key and prevents duplicate\n *   links for the same document/container pair.\n */\nexport const documentContainerProjection = sqliteTable(\n  \"document_container_projection\",\n  {\n    documentId: text(\"document_id\").notNull(),\n    containerId: text(\"container_id\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.documentId, table.containerId] })],\n);\n\n/**\n * Queryable document summary and detail projection.\n *\n * The durable Loro state lives in `documents`. This table stores the fields the\n * app needs for document lists, summaries, and fast detail hydration without\n * opening the full Loro snapshot on every read.\n *\n * Columns:\n * - `localId`: Stable local document id. This joins to `documents.localId` for\n *   rows where `documents.appKind = documents`.\n * - `documentId`: Server document id when known.\n * - `containerId`: Selected container for primary document placement, or\n *   `null` if the document is not currently linked to a visible container.\n * - `organizationId`: Last-known owning organization. Stamped from the\n *   container row when the document is detached because its container was\n *   removed locally (e.g. access to a shared org was revoked and the container\n *   tombstoned), so pending writes keep their org attribution after the\n *   `containers` join source disappears. Read as a fallback only — a live\n *   container join always wins.\n * - `documentKind`: Stored document kind. Defaults to `note`.\n * - `title`: Plain projected title. Defaults to the note fallback title.\n * - `updatedAt`: Timestamp used for document list ordering.\n *\n * The projected full text lives in `documentProjectionText`, keyed by the same\n * `localId`. Keeping it out of this row keeps list/window scans narrow: the\n * sidebar and summary queries read titles and placement from rows whose size\n * does not grow with document content.\n *\n * Indexes:\n * - `localId` is the primary key for document projection lookups.\n * - `(containerId) where containerId is not null` serves container-scoped\n *   window/count scans without walking the whole table.\n * - `(organizationId) where containerId is null` serves the orphan-recovery\n *   existence and window scans.\n * - `(documentId) where documentId is not null` serves the linked-placement\n *   join from `documentContainerProjection` and server-id lookups.\n */\nexport const documentProjection = sqliteTable(\n  \"document_projection\",\n  {\n    localId: text(\"local_id\"),\n    documentId: text(\"document_id\"),\n    containerId: text(\"container_id\"),\n    organizationId: text(\"organization_id\"),\n    documentKind: text(\"document_kind\").notNull().default(\"note\"),\n    title: text(\"title\").notNull().default(\"Untitled note\"),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.localId] }),\n    index(\"document_projection_container_idx\")\n      .on(table.containerId)\n      .where(sql`${table.containerId} IS NOT NULL`),\n    index(\"document_projection_orphan_organization_idx\")\n      .on(table.organizationId)\n      .where(sql`${table.containerId} IS NULL`),\n    index(\"document_projection_document_idx\")\n      .on(table.documentId)\n      .where(sql`${table.documentId} IS NOT NULL`),\n  ],\n);\n\n/**\n * Projected document text, split from `documentProjection` so content size\n * never bloats the rows that list/window queries scan. Loaded only by detail\n * reads (`loadDocument`) and the save-timestamp change check.\n *\n * Columns:\n * - `localId`: Stable local document id, matching `documentProjection.localId`.\n * - `text`: Plain projected text used to rebuild summaries/details.\n */\nexport const documentProjectionText = sqliteTable(\n  \"document_projection_text\",\n  {\n    localId: text(\"local_id\"),\n    text: text(\"text\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.localId] })],\n);\n\n/**\n * Per-lane sync state for container data: the server cursor and the local\n * freshness marker share one row per lane.\n *\n * Container sync is split into lanes, such as a parent-container child lane or\n * a container-document membership lane. The cursor lets the next request\n * resume without replaying the entire tree. The freshness marker records the\n * last fully drained check independently of the cursor: empty server\n * responses do not always carry a new watermark, but startup still needs to\n * know that it recently checked the lane before polling again.\n *\n * Columns:\n * - `laneKind`: Sync lane category, such as `container_parent` or\n *   `container_documents`.\n * - `laneId`: Lane identity. Root parent sync uses `root`, child sync uses a\n *   parent-prefixed container id, and document lanes use the container id.\n * - `watermarkUpdatedAt`: Server `updatedAt` value for the stored watermark;\n *   null until a watermark is saved.\n * - `watermarkId`: Server id tie-breaker for the stored watermark; null\n *   exactly when `watermarkUpdatedAt` is.\n * - `updatedAt`: Local timestamp for when the cursor was saved.\n * - `checkedAt`: Local timestamp for the most recent fully drained lane check;\n *   null until one completes.\n *\n * Indexes:\n * - `(laneKind, laneId)` is the primary key and stores one row per lane.\n */\nexport const containerSyncWatermarks = sqliteTable(\n  \"container_sync_watermarks\",\n  {\n    laneKind: text(\"lane_kind\").notNull(),\n    laneId: text(\"lane_id\").notNull(),\n    watermarkUpdatedAt: text(\"watermark_updated_at\"),\n    watermarkId: text(\"watermark_id\"),\n    updatedAt: text(\"updated_at\"),\n    checkedAt: text(\"checked_at\"),\n  },\n  (table) => [primaryKey({ columns: [table.laneKind, table.laneId] })],\n);\n\nexport const documentTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(documents),\n    requiredColumns: [\n      \"pull_continuation\",\n      \"recovery_generation\",\n      \"recovery_document_id\",\n      \"sync_failure_status\",\n      \"sync_failure_message\",\n      \"sync_failure_attempted_at\",\n    ],\n  },\n  defineSqlTableSchema(documentHistoryCheckpoints),\n  {\n    ...defineSqlTableSchema(documentHistoryUpdates),\n    requiredColumns: [\"update_id\"],\n  },\n];\n\nexport const principalPolicyTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(principalPolicies),\n    requiredColumns: [\"current_grants_json\"],\n  },\n  {\n    ...defineSqlTableSchema(principalPolicyBundleHistory),\n    requiredColumns: [\"current_grants_json\"],\n  },\n  defineSqlTableSchema(principalPolicyBundleReferences),\n  defineSqlTableSchema(principalPolicyOrganizations),\n  ...principalHistoryStageTables,\n  ...principalHistoryEvidenceTables,\n];\n\nexport const keyingCheckpointTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(organizationFounders),\n  defineSqlTableSchema(accessManifestCheckpoints),\n  defineSqlTableSchema(principalGrantRetirements),\n  defineSqlTableSchema(documentPurgeCheckpoints),\n  defineSqlTableSchema(principalPolicyCheckpoints),\n];\n\nexport const trustedUserIdentityPinTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(trustedUserIdentityPins),\n];\n\nconst securityIncidentTables: ReadonlyArray<SqlTableSchema> = [\n  securityIncidentTable,\n];\n\nexport const containerTables = containerTableSchemas;\n\nexport const documentContainerProjectionTables: ReadonlyArray<SqlTableSchema> =\n  [\n    defineSqlTableSchema(documentContainerProjection),\n    {\n      ...defineSqlTableSchema(containerDocumentTombstoneHolds),\n      requiredColumns: [\"hidden\"],\n    },\n    defineSqlTableSchema(pendingDocumentDiscoveries),\n    {\n      ...defineSqlTableSchema(documentDiscoveryHeads),\n      requiredColumns: [\"organization_id\"],\n    },\n    defineSqlTableSchema(documentDiscoverySequence),\n  ];\n\nexport const localIntentTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(localIntents),\n];\n\nexport const documentPlacementIntentTables: ReadonlyArray<SqlTableSchema> = [\n  ...localIntentTables,\n  defineSqlTableSchema(documentIntentLinkTargets),\n];\n\nexport const documentProjectionTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(documentProjection),\n  defineSqlTableSchema(documentProjectionText),\n  {\n    ...defineSqlTableSchema(documentPendingAttachments),\n    requiredColumns: [\"content_sha256\"],\n  },\n  {\n    ...defineSqlTableSchema(documentAttachmentBlobProjection),\n    requiredColumns: [\"content_sha256\"],\n  },\n  documentOrphanBlobReclaimTable,\n];\n\nexport const containerSyncWatermarkTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(containerSyncWatermarks),\n    requiredColumns: [\"checked_at\"],\n  },\n];\n\nexport const clientSqlTables: ReadonlyArray<SqlTableSchema> = [\n  ...principalMutationJournalTables,\n  ...documentTables,\n  ...principalPolicyTables,\n  ...keyingCheckpointTables,\n  ...verifiedManifestBundleTables,\n  ...trustedUserIdentityPinTables,\n  ...securityIncidentTables,\n  ...containerTables,\n  ...documentContainerProjectionTables,\n  ...documentPlacementIntentTables,\n  ...documentProjectionTables,\n  ...containerSyncWatermarkTables,\n  ...organizationReadModelTables,\n  ...organizationDataUsage.organizationDataUsageTables,\n  ...provisioningAttempt.organizationProvisioningAttemptTables,\n  ...organizationSyncPause.organizationSyncPauseTables,\n];\n\nexport const clientSQLiteSchema = {\n  principalHistoryNodeReferences,\n  principalHistoryRootOwners,\n  principalKeyEnvelopeArchive,\n  principalMutationJournal,\n  principalHistoryEntries,\n  principalHistoryNodes,\n  principalHistoryPrefixes,\n  principalHistoryStages,\n  organizationFounders,\n  principalGrantRetirements,\n  documents,\n  principalPolicies,\n  principalPolicyBundleHistory,\n  principalPolicyBundleReferences,\n  principalPolicyOrganizations,\n  accessManifestCheckpoints,\n  documentPurgeCheckpoints,\n  principalPolicyCheckpoints,\n  verifiedAccessManifestBundles,\n  trustedUserIdentityPins,\n  securityIncidents,\n  ...containerSQLiteSchema,\n  documentContainerProjection,\n  localIntents,\n  documentIntentLinkTargets,\n  documentProjection,\n  documentPendingAttachments,\n  documentAttachmentBlobProjection,\n  documentOrphanBlobReclaims: documentOrphanBlobReclaims,\n  containerSyncWatermarks,\n  ...organizationReadModelSQLiteSchema,\n  ...organizationDataUsage.organizationDataUsageSQLiteSchema,\n  ...provisioningAttempt.organizationProvisioningAttemptSQLiteSchema,\n  ...organizationSyncPause.organizationSyncPauseSQLiteSchema,\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { sql } from \"drizzle-orm\";\nimport {\n  index,\n  integer,\n  primaryKey,\n  sqliteTable,\n  text,\n  uniqueIndex,\n} from \"drizzle-orm/sqlite-core\";\nimport { defineSqlTableSchema, type SqlTableSchema } from \"../sqlTableSchema\";\nimport { containerDocumentTombstoneHolds } from \"./containerDocumentTombstoneHoldSchema\";\nimport {\n  containerSQLiteSchema,\n  containerTableSchemas,\n} from \"./containerSchema\";\nimport {\n  documentAttachmentBlobProjection,\n  documentPendingAttachments,\n} from \"./documentAttachmentSchema\";\nimport {\n  documentDiscoveryHeads,\n  documentDiscoverySequence,\n  pendingDocumentDiscoveries,\n} from \"./documentDiscoveryEvidenceSchema\";\nimport {\n  documentOrphanBlobReclaims,\n  documentOrphanBlobReclaimTable,\n} from \"./documentOrphanBlobReclaimSchema\";\nimport { documentIntentLinkTargets } from \"./documentPlacementIntentSchema\";\nimport { localIntents } from \"./localIntentSchema\";\nimport * as organizationDataUsage from \"./organizationDataUsageSchema\";\nimport { organizationFounders } from \"./organizationFounderSchema\";\nimport * as provisioningAttempt from \"./organizationProvisioningAttemptSchema\";\nimport {\n  organizationReadModelSQLiteSchema,\n  organizationReadModelTables,\n} from \"./organizationReadModelTableRegistry\";\nimport * as organizationSyncPause from \"./organizationSyncPauseSchema\";\nimport { principalGrantRetirements } from \"./principalGrantRetirementSchema\";\nimport {\n  principalHistoryEntries,\n  principalHistoryEvidenceTables,\n  principalHistoryNodes,\n  principalHistoryPrefixes,\n} from \"./principalHistoryEvidenceSchema\";\nimport {\n  principalHistoryNodeReferences,\n  principalHistoryRootOwners,\n} from \"./principalHistoryNodeRetentionSchema\";\nimport { principalKeyEnvelopeArchive } from \"./principalHistoryRetentionSchema\";\nimport {\n  principalHistoryStages,\n  principalHistoryStageTables,\n} from \"./principalHistoryStageSchema\";\nimport {\n  principalMutationJournal,\n  principalMutationJournalTables,\n} from \"./principalMutationJournalSchema\";\nimport {\n  principalPolicies,\n  principalPolicyBundleHistory,\n  principalPolicyBundleReferences,\n  principalPolicyCheckpoints,\n  principalPolicyOrganizations,\n} from \"./principalPolicySchema\";\nimport {\n  securityIncidents,\n  securityIncidentTable,\n} from \"./securityIncidentSchema\";\nimport {\n  verifiedAccessManifestBundles,\n  verifiedManifestBundleTables,\n} from \"./verifiedManifestBundleSchema\";\n\nexport {\n  containerHydrationTombstones,\n  containers,\n  dormantContainerMetadata,\n  dormantMetadataSweepRequests,\n  supersededContainerBindings,\n} from \"./containerSchema\";\nexport {\n  documentAttachmentBlobProjection,\n  documentPendingAttachments,\n} from \"./documentAttachmentSchema\";\nexport {\n  inContainerIntentLanes,\n  inLocalIntentLane,\n  LOCAL_INTENT_LANES,\n  LOCAL_INTENT_SUBJECT,\n  localIntents,\n} from \"./localIntentSchema\";\nexport {\n  principalPolicies,\n  principalPolicyBundleHistory,\n  principalPolicyBundleReferences,\n  principalPolicyCheckpoints,\n  principalPolicyOrganizations,\n} from \"./principalPolicySchema\";\nexport { securityIncidents } from \"./securityIncidentSchema\";\nexport { containerDocumentTombstoneHolds, organizationReadModelTables };\n\nconst accessLevelColumn = \"effective_access_level\";\n\n/**\n * Durable Loro-backed document records shared by app features.\n *\n * This table stores encrypted document runtime state for multiple app domains.\n * `appKind` namespaces records for documents and container metadata. User-facing\n * list data is projected into feature-specific read models.\n *\n * Columns:\n * - `appKind`: Local domain namespace for the row, such as `documents` or\n *   `container-metadata`.\n * - `localId`: Stable local id inside `appKind`. It may be created before a\n *   server `documentId` exists.\n * - `documentId`: Server document id once the record is known remotely, or\n *   `null` while the document is local-only.\n * - `accessEpoch`: Latest access epoch persisted for the document. Defaults to\n *   the initial epoch.\n * - `accessStateHash`: Current document access/manifest state hash returned by\n *   sync, when known.\n * - `lastCommitLsn`: Last remote commit cursor applied to this local document.\n * - `documentManifestBundle`: Serialized document manifest bundle used for\n *   encrypted document sync.\n * - `contentKeyBundle`: Serialized content-key material needed to open the\n *   local document.\n * - `documentKekTargets`: Serialized KEK target state for document key wraps.\n * - `pendingBaseVersion`: Encoded oplog version through which every persisted\n *   op is already enqueued or synced. Persisted so a restart restores the\n *   outgoing-delta marker instead of re-seeding it past a device-first\n *   `deferRemoteSync` write's un-advanced op. `null` when unset.\n * - `snapshotEndVersion`: Encoded end version vector of the persisted content\n *   (which lives in the durable-history tables, never on this row), written on\n *   every content persist. Lets the pending-write queue's deferred-tail scan\n *   compare version coverage without loading content. Empty string when the\n *   document has never hydrated content, which readers treat as \"no deferred\n *   tail claimable\".\n * - `recoveryGeneration`: Atomic raw-history recovery writer fence.\n * - `recoveryDocumentId`: Former server id for cross-client post-purge recreation.\n * - `pullContinuation`: Durable progress for the next bounded remote pull.\n * - `syncFailureStatus`, `syncFailureMessage`, `syncFailureAttemptedAt`: The\n *   last terminal sync failure or quarantined incoming update for this scope.\n *   The durable write queue (queued rows of `documentHistoryUpdates`) has no\n *   status columns, so these let the write-queue view and footer explain why\n *   the document is blocked. `syncFailureMessage` is non-null exactly when a\n *   failure is recorded; a newer failure replaces the old, and a later fully\n *   validated sync pass, a remote reset, or the scope's teardown clears all\n *   three.\n * - `updatedAt`: Local timestamp for the last persisted runtime-state update.\n *\n * Indexes:\n * - `(appKind, localId)` is the primary key and scopes local document lookups.\n * - `(appKind, documentId) where documentId is not null` supports resolving a\n *   server document id back to the local row during discovery and relinking.\n */\nexport const documents = sqliteTable(\n  \"documents\",\n  {\n    appKind: text(\"app_kind\").notNull(),\n    localId: text(\"local_id\").notNull(),\n    documentId: text(\"document_id\"),\n    accessEpoch: integer(\"access_epoch\").notNull().default(1),\n    accessStateHash: text(\"access_state_hash\"),\n    effectiveAccessLevel: text(accessLevelColumn).notNull().default(\"read\"),\n    lastCommitLsn: text(\"last_commit_lsn\"),\n    documentManifestBundle: text(\"document_manifest_bundle\"),\n    contentKeyBundle: text(\"content_key_bundle\"),\n    documentKekTargets: text(\"document_kek_targets\"),\n    pendingBaseVersion: text(\"pending_base_version\"),\n    pullContinuation: text(\"pull_continuation\"),\n    recoveryGeneration: integer(\"recovery_generation\").notNull().default(0),\n    recoveryDocumentId: text(\"recovery_document_id\"),\n    snapshotEndVersion: text(\"snapshot_end_version\").notNull().default(\"\"),\n    syncFailureStatus: integer(\"sync_failure_status\"),\n    syncFailureMessage: text(\"sync_failure_message\"),\n    syncFailureAttemptedAt: text(\"sync_failure_attempted_at\"),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.appKind, table.localId] }),\n    index(\"documents_app_document_idx\")\n      .on(table.appKind, table.documentId)\n      .where(sql`${table.documentId} IS NOT NULL`),\n  ],\n);\n\n/**\n * Full-history persistence for local documents (checkpoint + tail) — the ONLY\n * durable content source. Record rows in `documents` carry runtime metadata\n * and the content frontier (`snapshotEndVersion`), never content. The\n * checkpoint holds a full-history snapshot refreshed only at compaction, and\n * the tail appends every update (local deltas and decrypted remote updates)\n * written since. Restore = import checkpoint + replay tail; compaction =\n * export full history from the live doc, replace the checkpoint, clear the\n * tail — all bounded and amortized. Container metadata stores its content (an\n * exported-updates blob) as its checkpoint row, with no tail.\n */\nexport const documentHistoryCheckpoints = sqliteTable(\n  \"document_history_checkpoints\",\n  {\n    appKind: text(\"app_kind\").notNull(),\n    localId: text(\"local_id\").notNull(),\n    snapshot: text(\"snapshot\").notNull(),\n    endVersionVector: text(\"end_version_vector\").notNull(),\n    revision: text(\"revision\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.appKind, table.localId] })],\n);\n\n/**\n * The local update log: one row per Loro update, serving as both the history\n * tail (restore = checkpoint + tail) and the outbound write queue.\n *\n * Every locally authored update is stored once. While it waits for sync it\n * carries an `updateId` (the id submitted to the server) and the version-vector\n * metadata the submission needs; settlement clears them, leaving the row as\n * ordinary tail history until compaction folds it into a checkpoint.\n *\n * Columns:\n * - `id`: Row id; tail compaction deletes by it.\n * - `appKind`, `localId`: Document scope matching `documents`.\n * - `updateData`: Serialized Loro update payload.\n * - `origin`: \"local\" (authored on this device) or \"remote\" (decrypted\n *   pulled update) for tail rows. Restores use it to advance the\n *   outgoing-delta marker across remote rows — their ops are already\n *   server-side — while a local row left behind by a crash stays below the\n *   marker so the next edit re-derives and sends it. \"outbox\" marks a queued\n *   update with no tail role (container metadata, whose content is its\n *   checkpoint, and full-state re-uploads after a remote reset); restores and\n *   compaction never see it and settlement deletes it.\n * - `createdAt`: Insertion timestamp; with `rowid`, deterministic replay order.\n * - `updateId`: Present exactly while the row is queued for sync; rekeyed\n *   after a lost acknowledgement poisons the submitted id.\n * - `partialStartVersionVector` / `partialEndVersionVector`: Version vectors\n *   around a queued partial update.\n * - `sourceVersionVector`: Present on a queued rotation baseline checkpoint.\n * - `rekeyCount`: Durable bound on rekeys of a queued row.\n *\n * Invariant: compaction never deletes a queued row, so a checkpoint can cover\n * a queued update's operations without removing it from the queue.\n */\nexport const documentHistoryUpdates = sqliteTable(\n  \"document_history_updates\",\n  {\n    id: text(\"id\"),\n    appKind: text(\"app_kind\").notNull(),\n    localId: text(\"local_id\").notNull(),\n    updateData: text(\"update_data\").notNull(),\n    origin: text(\"origin\").notNull(),\n    createdAt: text(\"created_at\").notNull(),\n    updateId: text(\"update_id\"),\n    partialStartVersionVector: text(\"partial_start_version_vector\"),\n    partialEndVersionVector: text(\"partial_end_version_vector\"),\n    sourceVersionVector: text(\"source_version_vector\"),\n    rekeyCount: integer(\"rekey_count\").notNull().default(0),\n  },\n  (table) => [\n    primaryKey({ columns: [table.id] }),\n    index(\"document_history_updates_scope_created_idx\").on(\n      table.appKind,\n      table.localId,\n      table.createdAt,\n    ),\n    uniqueIndex(\"document_history_updates_update_id_idx\")\n      .on(table.updateId)\n      .where(sql`${table.updateId} IS NOT NULL`),\n  ],\n);\n\n/**\n * Anti-rollback pin for verified access manifests.\n *\n * Records the highest access-manifest epoch this client has verified for each\n * object, so a later projection that serves an older epoch (rollback) or a\n * conflicting manifest at the same epoch (equivocation) is detected before any\n * key is unwrapped. Updated monotonically after a projection verifies cleanly.\n *\n * Columns:\n * - `objectKind`: Access object kind (`container`, `document`, ...).\n * - `organizationId`: Organization boundary that owns the object.\n * - `objectId`: Stable object id.\n * - `epoch`: Highest verified manifest epoch.\n * - `manifestHash`: Manifest hash pinned at that epoch.\n * - `updatedAt`: Local timestamp for the pin.\n *\n * Indexes:\n * - `(objectKind, organizationId, objectId)` is the primary key and gives one\n *   pin per object.\n */\nexport const accessManifestCheckpoints = sqliteTable(\n  \"access_manifest_checkpoints\",\n  {\n    objectKind: text(\"object_kind\").notNull(),\n    organizationId: text(\"organization_id\").notNull(),\n    objectId: text(\"object_id\").notNull(),\n    epoch: integer(\"epoch\").notNull(),\n    manifestHash: text(\"manifest_hash\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({\n      columns: [table.objectKind, table.organizationId, table.objectId],\n    }),\n  ],\n);\n\n/**\n * Durable terminal pins for documents whose signed purge proof was verified.\n * These survive remote-state resets so a dishonest API cannot later replay the\n * pre-purge writer projection and resurrect locally deleted content.\n */\nexport const documentPurgeCheckpoints = sqliteTable(\n  \"document_purge_checkpoints\",\n  {\n    documentId: text(\"document_id\").primaryKey(),\n    organizationId: text(\"organization_id\").notNull(),\n    documentManifestHash: text(\"document_manifest_hash\").notNull(),\n    purgeEventHash: text(\"purge_event_hash\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n);\n\n/**\n * Durable pins for user identity bundles.\n *\n * The first validated identity accepted for a user in a configured API trust\n * domain is inserted once. Later observations must match every suite, public\n * key, and fingerprint exactly; the persistence adapter never changes those\n * columns. `firstSeenAt` records when the local trust decision was made and is\n * likewise immutable. `provenance` (`self`, `link`, or `observed`) records how\n * the pin was established; only `self` and `link` admit a user, and it only\n * rises. A table without it is an obsolete local database.\n *\n * Indexes:\n * - `(identityTrustDomain, userId)` is the primary key and scopes a user pin to\n *   the host-configured API authority that supplied it.\n * - `(identityTrustDomain, signingKeyFingerprint)` binds the reverse identity\n *   mapping durably, including across session recreation. There is no\n *   migration for a table that already violates it. Earlier builds pinned a\n *   registration's user id before the server confirmed it, so a device that\n *   ran one may hold two users on one key; deployments are greenfield, and\n *   such a device clears its local data, which recreates this table empty. A\n *   device that used an environment before a reset does the same (see\n *   docs/developer/greenfield-reset.md).\n */\nexport const trustedUserIdentityPins = sqliteTable(\n  \"trusted_user_identity_pins\",\n  {\n    identityTrustDomain: text(\"identity_trust_domain\").notNull(),\n    userId: text(\"user_id\").notNull(),\n    formatVersion: integer(\"format_version\").notNull(),\n    signingSuite: text(\"signing_suite\").notNull(),\n    signingPublicKey: text(\"signing_public_key\").notNull(),\n    signingKeyFingerprint: text(\"signing_key_fingerprint\").notNull(),\n    encapsulationSuite: text(\"encapsulation_suite\").notNull(),\n    encapsulationPublicKey: text(\"encapsulation_public_key\").notNull(),\n    encapsulationKeyFingerprint: text(\n      \"encapsulation_key_fingerprint\",\n    ).notNull(),\n    firstSeenAt: text(\"first_seen_at\").notNull(),\n    provenance: text(\"provenance\", {\n      enum: [\"self\", \"link\", \"observed\"],\n    }).notNull(),\n  },\n  (table) => [\n    primaryKey({\n      columns: [table.identityTrustDomain, table.userId],\n    }),\n    uniqueIndex(\"trusted_user_identity_pins_domain_signing_fingerprint_idx\").on(\n      table.identityTrustDomain,\n      table.signingKeyFingerprint,\n    ),\n  ],\n);\n\n/**\n * Local many-to-many projection between documents and containers.\n *\n * The document summary row stores one selected `containerId` for primary list\n * placement, while this table keeps the full set of linked containers returned\n * by container/document sync. Removing a container deletes its links and may\n * repair affected document summary rows to point at another remaining link.\n *\n * Columns:\n * - `documentId`: Server document id whose container links are projected.\n * - `containerId`: Linked container id.\n * - `updatedAt`: Local timestamp for the last replacement of the link set.\n *\n * Indexes:\n * - `(documentId, containerId)` is the primary key and prevents duplicate\n *   links for the same document/container pair.\n */\nexport const documentContainerProjection = sqliteTable(\n  \"document_container_projection\",\n  {\n    documentId: text(\"document_id\").notNull(),\n    containerId: text(\"container_id\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.documentId, table.containerId] })],\n);\n\n/**\n * Queryable document summary and detail projection.\n *\n * The durable Loro state lives in `documents`. This table stores the fields the\n * app needs for document lists, summaries, and fast detail hydration without\n * opening the full Loro snapshot on every read.\n *\n * Columns:\n * - `localId`: Stable local document id. This joins to `documents.localId` for\n *   rows where `documents.appKind = documents`.\n * - `documentId`: Server document id when known.\n * - `containerId`: Selected container for primary document placement, or\n *   `null` if the document is not currently linked to a visible container.\n * - `organizationId`: Last-known owning organization. Stamped from the\n *   container row when the document is detached because its container was\n *   removed locally (e.g. access to a shared org was revoked and the container\n *   tombstoned), so pending writes keep their org attribution after the\n *   `containers` join source disappears. Read as a fallback only — a live\n *   container join always wins.\n * - `documentKind`: Stored document kind. Defaults to `note`.\n * - `title`: Plain projected title. Defaults to the note fallback title.\n * - `updatedAt`: Timestamp used for document list ordering.\n *\n * The projected full text lives in `documentProjectionText`, keyed by the same\n * `localId`. Keeping it out of this row keeps list/window scans narrow: the\n * sidebar and summary queries read titles and placement from rows whose size\n * does not grow with document content.\n *\n * Indexes:\n * - `localId` is the primary key for document projection lookups.\n * - `(containerId) where containerId is not null` serves container-scoped\n *   window/count scans without walking the whole table.\n * - `(organizationId) where containerId is null` serves the orphan-recovery\n *   existence and window scans.\n * - `(documentId) where documentId is not null` serves the linked-placement\n *   join from `documentContainerProjection` and server-id lookups.\n */\nexport const documentProjection = sqliteTable(\n  \"document_projection\",\n  {\n    localId: text(\"local_id\"),\n    documentId: text(\"document_id\"),\n    containerId: text(\"container_id\"),\n    organizationId: text(\"organization_id\"),\n    documentKind: text(\"document_kind\").notNull().default(\"note\"),\n    title: text(\"title\").notNull().default(\"Untitled note\"),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.localId] }),\n    index(\"document_projection_container_idx\")\n      .on(table.containerId)\n      .where(sql`${table.containerId} IS NOT NULL`),\n    index(\"document_projection_orphan_organization_idx\")\n      .on(table.organizationId)\n      .where(sql`${table.containerId} IS NULL`),\n    index(\"document_projection_document_idx\")\n      .on(table.documentId)\n      .where(sql`${table.documentId} IS NOT NULL`),\n  ],\n);\n\n/**\n * Projected document text, split from `documentProjection` so content size\n * never bloats the rows that list/window queries scan. Loaded only by detail\n * reads (`loadDocument`) and the save-timestamp change check.\n *\n * Columns:\n * - `localId`: Stable local document id, matching `documentProjection.localId`.\n * - `text`: Plain projected text used to rebuild summaries/details.\n */\nexport const documentProjectionText = sqliteTable(\n  \"document_projection_text\",\n  {\n    localId: text(\"local_id\"),\n    text: text(\"text\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.localId] })],\n);\n\n/**\n * Per-lane sync state for container data: the server cursor and the local\n * freshness marker share one row per lane.\n *\n * Container sync is split into lanes, such as a parent-container child lane or\n * a container-document membership lane. The cursor lets the next request\n * resume without replaying the entire tree. The freshness marker records the\n * last fully drained check independently of the cursor: empty server\n * responses do not always carry a new watermark, but startup still needs to\n * know that it recently checked the lane before polling again.\n *\n * Columns:\n * - `laneKind`: Sync lane category, such as `container_parent` or\n *   `container_documents`.\n * - `laneId`: Lane identity. Root parent sync uses `root`, child sync uses a\n *   parent-prefixed container id, and document lanes use the container id.\n * - `watermarkUpdatedAt`: Server `updatedAt` value for the stored watermark;\n *   null until a watermark is saved.\n * - `watermarkId`: Server id tie-breaker for the stored watermark; null\n *   exactly when `watermarkUpdatedAt` is.\n * - `updatedAt`: Local timestamp for when the cursor was saved.\n * - `checkedAt`: Local timestamp for the most recent fully drained lane check;\n *   null until one completes.\n *\n * Indexes:\n * - `(laneKind, laneId)` is the primary key and stores one row per lane.\n */\nexport const containerSyncWatermarks = sqliteTable(\n  \"container_sync_watermarks\",\n  {\n    laneKind: text(\"lane_kind\").notNull(),\n    laneId: text(\"lane_id\").notNull(),\n    watermarkUpdatedAt: text(\"watermark_updated_at\"),\n    watermarkId: text(\"watermark_id\"),\n    updatedAt: text(\"updated_at\"),\n    checkedAt: text(\"checked_at\"),\n  },\n  (table) => [primaryKey({ columns: [table.laneKind, table.laneId] })],\n);\n\nexport const documentTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(documents),\n    requiredColumns: [\n      \"pull_continuation\",\n      \"recovery_generation\",\n      \"recovery_document_id\",\n      \"sync_failure_status\",\n      \"sync_failure_message\",\n      \"sync_failure_attempted_at\",\n    ],\n  },\n  defineSqlTableSchema(documentHistoryCheckpoints),\n  {\n    ...defineSqlTableSchema(documentHistoryUpdates),\n    requiredColumns: [\"update_id\"],\n  },\n];\n\nexport const principalPolicyTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(principalPolicies),\n    requiredColumns: [\"current_grants_json\"],\n  },\n  {\n    ...defineSqlTableSchema(principalPolicyBundleHistory),\n    requiredColumns: [\"current_grants_json\"],\n  },\n  defineSqlTableSchema(principalPolicyBundleReferences),\n  defineSqlTableSchema(principalPolicyOrganizations),\n  ...principalHistoryStageTables,\n  ...principalHistoryEvidenceTables,\n];\n\nexport const keyingCheckpointTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(organizationFounders),\n  defineSqlTableSchema(accessManifestCheckpoints),\n  defineSqlTableSchema(principalGrantRetirements),\n  defineSqlTableSchema(documentPurgeCheckpoints),\n  defineSqlTableSchema(principalPolicyCheckpoints),\n];\n\nexport const trustedUserIdentityPinTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(trustedUserIdentityPins),\n    requiredColumns: [\"provenance\"],\n  },\n];\n\nconst securityIncidentTables: ReadonlyArray<SqlTableSchema> = [\n  securityIncidentTable,\n];\n\nexport const containerTables = containerTableSchemas;\n\nexport const documentContainerProjectionTables: ReadonlyArray<SqlTableSchema> =\n  [\n    defineSqlTableSchema(documentContainerProjection),\n    {\n      ...defineSqlTableSchema(containerDocumentTombstoneHolds),\n      requiredColumns: [\"hidden\"],\n    },\n    defineSqlTableSchema(pendingDocumentDiscoveries),\n    {\n      ...defineSqlTableSchema(documentDiscoveryHeads),\n      requiredColumns: [\"organization_id\"],\n    },\n    defineSqlTableSchema(documentDiscoverySequence),\n  ];\n\nexport const localIntentTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(localIntents),\n];\n\nexport const documentPlacementIntentTables: ReadonlyArray<SqlTableSchema> = [\n  ...localIntentTables,\n  defineSqlTableSchema(documentIntentLinkTargets),\n];\n\nexport const documentProjectionTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(documentProjection),\n  defineSqlTableSchema(documentProjectionText),\n  {\n    ...defineSqlTableSchema(documentPendingAttachments),\n    requiredColumns: [\"content_sha256\"],\n  },\n  {\n    ...defineSqlTableSchema(documentAttachmentBlobProjection),\n    requiredColumns: [\"content_sha256\"],\n  },\n  documentOrphanBlobReclaimTable,\n];\n\nexport const containerSyncWatermarkTables: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(containerSyncWatermarks),\n    requiredColumns: [\"checked_at\"],\n  },\n];\n\nexport const clientSqlTables: ReadonlyArray<SqlTableSchema> = [\n  ...principalMutationJournalTables,\n  ...documentTables,\n  ...principalPolicyTables,\n  ...keyingCheckpointTables,\n  ...verifiedManifestBundleTables,\n  ...trustedUserIdentityPinTables,\n  ...securityIncidentTables,\n  ...containerTables,\n  ...documentContainerProjectionTables,\n  ...documentPlacementIntentTables,\n  ...documentProjectionTables,\n  ...containerSyncWatermarkTables,\n  ...organizationReadModelTables,\n  ...organizationDataUsage.organizationDataUsageTables,\n  ...provisioningAttempt.organizationProvisioningAttemptTables,\n  ...organizationSyncPause.organizationSyncPauseTables,\n];\n\nexport const clientSQLiteSchema = {\n  principalHistoryNodeReferences,\n  principalHistoryRootOwners,\n  principalKeyEnvelopeArchive,\n  principalMutationJournal,\n  principalHistoryEntries,\n  principalHistoryNodes,\n  principalHistoryPrefixes,\n  principalHistoryStages,\n  organizationFounders,\n  principalGrantRetirements,\n  documents,\n  principalPolicies,\n  principalPolicyBundleHistory,\n  principalPolicyBundleReferences,\n  principalPolicyOrganizations,\n  accessManifestCheckpoints,\n  documentPurgeCheckpoints,\n  principalPolicyCheckpoints,\n  verifiedAccessManifestBundles,\n  trustedUserIdentityPins,\n  securityIncidents,\n  ...containerSQLiteSchema,\n  documentContainerProjection,\n  localIntents,\n  documentIntentLinkTargets,\n  documentProjection,\n  documentPendingAttachments,\n  documentAttachmentBlobProjection,\n  documentOrphanBlobReclaims: documentOrphanBlobReclaims,\n  containerSyncWatermarks,\n  ...organizationReadModelSQLiteSchema,\n  ...organizationDataUsage.organizationDataUsageSQLiteSchema,\n  ...provisioningAttempt.organizationProvisioningAttemptSQLiteSchema,\n  ...organizationSyncPause.organizationSyncPauseSQLiteSchema,\n};\n"]}

package/data/trustedUserIdentity/admission.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Refuses to admit a user (contact, roster, group member, or share recipient)
+ * whose pin was not established by a verified identity link or by this
+ * device's own keys. A pin observed on first sight cannot stand in for a link.
+ */
+export declare class UnverifiedUserIdentityError extends Error {
+    readonly code = "user_identity_unverified";
+    readonly userId: string;
+    constructor(userId: string);
+}

package/data/trustedUserIdentity/admission.js

@@ -0,0 +1,15 @@
+/**
+ * Refuses to admit a user (contact, roster, group member, or share recipient)
+ * whose pin was not established by a verified identity link or by this
+ * device's own keys. A pin observed on first sight cannot stand in for a link.
+ */
+export class UnverifiedUserIdentityError extends Error {
+    code = "user_identity_unverified";
+    userId;
+    constructor(userId) {
+        super("Ask this person for their identity link and verify it before adding them.");
+        this.name = "UnverifiedUserIdentityError";
+        this.userId = userId;
+    }
+}
+//# sourceMappingURL=admission.js.map

package/data/trustedUserIdentity/admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.js","sourceRoot":"","sources":["admission.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,GAAG,0BAA0B,CAAC;IAClC,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CACH,2EAA2E,CAC5E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF","sourcesContent":["/**\n * Refuses to admit a user (contact, roster, group member, or share recipient)\n * whose pin was not established by a verified identity link or by this\n * device's own keys. A pin observed on first sight cannot stand in for a link.\n */\nexport class UnverifiedUserIdentityError extends Error {\n  readonly code = \"user_identity_unverified\";\n  readonly userId: string;\n\n  constructor(userId: string) {\n    super(\n      \"Ask this person for their identity link and verify it before adding them.\",\n    );\n    this.name = \"UnverifiedUserIdentityError\";\n    this.userId = userId;\n  }\n}\n"]}

package/data/trustedUserIdentity/index.d.ts

@@ -1,3 +1,4 @@
+export { UnverifiedUserIdentityError } from "./admission.js";
 export { createApiUserIdentitySource } from "./apiAdapter.js";
 export { parseIdentityLink } from "./identityLink.js";
 export { requireTrustedUserIdentityResolver } from "./requiredResolver.js";

package/data/trustedUserIdentity/index.js

@@ -1,3 +1,4 @@
+export { UnverifiedUserIdentityError } from "./admission.js";
 export { createApiUserIdentitySource } from "./apiAdapter.js";
 export { parseIdentityLink } from "./identityLink.js";
 export { requireTrustedUserIdentityResolver } from "./requiredResolver.js";

package/data/trustedUserIdentity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAO3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { createApiUserIdentitySource } from \"./apiAdapter\";\nexport { parseIdentityLink } from \"./identityLink\";\nexport { requireTrustedUserIdentityResolver } from \"./requiredResolver\";\nexport {\n  createTrustedUserIdentityService,\n  loadPinnedUserIdentity,\n} from \"./service\";\nexport { resolveIdentityTrustDomain } from \"./trustDomain\";\nexport type {\n  LocalUserIdentityCandidate,\n  TrustedUserIdentity,\n  TrustedUserIdentityResolver,\n  TrustedUserIdentityService,\n} from \"./types\";\nexport { validateUserIdentityKeys } from \"./validation\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAO3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { UnverifiedUserIdentityError } from \"./admission\";\nexport { createApiUserIdentitySource } from \"./apiAdapter\";\nexport { parseIdentityLink } from \"./identityLink\";\nexport { requireTrustedUserIdentityResolver } from \"./requiredResolver\";\nexport {\n  createTrustedUserIdentityService,\n  loadPinnedUserIdentity,\n} from \"./service\";\nexport { resolveIdentityTrustDomain } from \"./trustDomain\";\nexport type {\n  LocalUserIdentityCandidate,\n  TrustedUserIdentity,\n  TrustedUserIdentityResolver,\n  TrustedUserIdentityService,\n} from \"./types\";\nexport { validateUserIdentityKeys } from \"./validation\";\n"]}

package/data/trustedUserIdentity/service.d.ts

@@ -1,10 +1,6 @@
 import type { ExecSql } from "../sqlite/sqlSchema.js";
 import { type TrustedUserIdentity, type TrustedUserIdentityService, type TrustedUserIdentityServiceDependencies } from "./types.js";
-/**
- * Read-only: the identity this trust store already pins for `userId`, or null.
- * The stored keys must still match their stored fingerprints. Never inserts,
- * compares against or replaces a pin.
- */
+/** Read-only: the pinned identity for `userId` of any provenance, or null. */
 export declare function loadPinnedUserIdentity(input: {
     readonly execSql: ExecSql;
     readonly identityTrustDomain: string;

package/data/trustedUserIdentity/service.js

@@ -3,6 +3,7 @@ import { base64ToBytes, bytesToBase64 } from "../../internal/encoding/index.js";
 import { compareOrInsertTrustedUserIdentityPin, loadTrustedUserIdentityPin, loadTrustedUserIdForSigningKey, TrustedUserIdentityPinCorruptError, TrustedUserIdentityPinMismatchError, } from "../persistence/trustedUserIdentityPinPersistence.js";
 import { TrustedUserIdentityPinContentionError } from "../persistence/trustedUserIdentityPinTransaction.js";
 import { DatabaseUnavailableError } from "../sync/databaseUnavailable.js";
+import { UnverifiedUserIdentityError } from "./admission.js";
 import { assertIdentityLinkMatches, createIdentityLink, parseIdentityLink, } from "./identityLink.js";
 import { brandTrustedUserIdentity, TRUSTED_USER_IDENTITY_ENCAPSULATION_SUITE, TRUSTED_USER_IDENTITY_FORMAT_VERSION, TRUSTED_USER_IDENTITY_SIGNING_SUITE, } from "./types.js";
 import { assertTrustedUserIdentityUserId, validateLocalUserIdentity, validateRemoteUserIdentity, validateUserIdentityKeys, } from "./validation.js";
@@ -34,6 +35,7 @@ async function compareWithDurablePin(input) {
                 encapsulationPublicKey: bytesToBase64(input.identity.encapsulationPublicKey),
                 encapsulationSuite: TRUSTED_USER_IDENTITY_ENCAPSULATION_SUITE,
                 firstSeenAt: input.firstSeenAt,
+                provenance: input.provenance,
                 formatVersion: TRUSTED_USER_IDENTITY_FORMAT_VERSION,
                 identityTrustDomain: input.identity.identityTrustDomain,
                 signingKeyFingerprint: input.identity.signingKeyFingerprint,
@@ -60,6 +62,11 @@ async function compareWithDurablePin(input) {
         throw error;
     }
 }
+/**
+ * The candidate for `userId` and where it came from: this device's own keys
+ * (`self`) or the identity endpoint (`observed`). Provenance follows the
+ * source, never the account that happens to be active once a lookup returns.
+ */
 async function resolveCandidate(dependencies, userId, identityTrustDomain) {
     const localUserId = dependencies.getLocalUserId();
     if (userId === localUserId) {
@@ -67,35 +74,49 @@ async function resolveCandidate(dependencies, userId, identityTrustDomain) {
         if (!localIdentity) {
             throw new KeyingVerificationError("missing_dependency", "Authoritative local identity keys are unavailable");
         }
-        return validateLocalUserIdentity({
-            candidate: localIdentity,
-            identityTrustDomain,
-            userId,
-        });
+        return {
+            identity: await validateLocalUserIdentity({
+                candidate: localIdentity,
+                identityTrustDomain,
+                userId,
+            }),
+            source: "self",
+        };
     }
     const remoteIdentity = await dependencies.remoteSource.load(userId);
     return remoteIdentity
-        ? validateRemoteUserIdentity({
-            candidate: remoteIdentity,
-            identityTrustDomain,
-            requestedUserId: userId,
-        })
+        ? {
+            identity: await validateRemoteUserIdentity({
+                candidate: remoteIdentity,
+                identityTrustDomain,
+                requestedUserId: userId,
+            }),
+            source: "observed",
+        }
         : null;
 }
+/** The trust store and account a lookup started under must still be active. */
+function assertResolutionScope(dependencies, scope, message) {
+    if (dependencies.getExecSql() !== scope.execSql ||
+        dependencies.getLocalUserId() !== scope.localUserId) {
+        throw new DatabaseUnavailableError(message);
+    }
+}
 async function pinIdentity(input) {
     await compareWithDurablePin({
         execSql: input.execSql,
         firstSeenAt: (input.dependencies.now?.() ?? new Date()).toISOString(),
         identity: input.identity,
+        provenance: input.provenance,
     });
     return brandTrustedUserIdentity(input.identity);
 }
 /**
- * Read-only: the identity this trust store already pins for `userId`, or null.
- * The stored keys must still match their stored fingerprints. Never inserts,
- * compares against or replaces a pin.
+ * Read-only: the identity this trust store already pins for `userId` and how
+ * it was established, or null. The stored keys must still match their stored
+ * fingerprints. Never inserts, compares against or replaces a pin.
  */
-export async function loadPinnedUserIdentity(input) {
+async function loadPin(input) {
     assertTrustedUserIdentityUserId(input.userId);
     const pin = await loadTrustedUserIdentityPin(input);
     if (!pin)
@@ -108,11 +129,72 @@ export async function loadPinnedUserIdentity(input) {
         },
         encapsulationKeyFingerprint: pin.encapsulationKeyFingerprint,
     });
-    return brandTrustedUserIdentity({
-        ...keys,
-        identityTrustDomain: input.identityTrustDomain,
-        userId: input.userId,
-    });
+    return {
+        identity: brandTrustedUserIdentity({
+            ...keys,
+            identityTrustDomain: input.identityTrustDomain,
+            userId: input.userId,
+        }),
+        provenance: pin.provenance,
+    };
+}
+/** Read-only: the pinned identity for `userId` of any provenance, or null. */
+export async function loadPinnedUserIdentity(input) {
+    return (await loadPin(input))?.identity ?? null;
+}
+/** Compares an independently received link before pinning it as `link`. */
+async function verifyIdentityLink(dependencies, link) {
+    const expectation = parseIdentityLink(link);
+    const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
+    if (expectation.identityTrustDomain !== identityTrustDomain) {
+        throw new Error("This identity link belongs to a different Tearleads service.");
+    }
+    const localUserId = dependencies.getLocalUserId();
+    try {
+        const candidate = await resolveCandidate(dependencies, expectation.userId, identityTrustDomain);
+        if (!candidate)
+            throw new Error("The identity in this link is unavailable.");
+        await assertIdentityLinkMatches(expectation, candidate.identity);
+        assertResolutionScope(dependencies, { execSql, localUserId }, "The active identity changed. Open the identity link again.");
+        return await pinIdentity({
+            dependencies,
+            execSql,
+            identity: candidate.identity,
+            provenance: candidate.source === "self" ? "self" : "link",
+        });
+    }
+    catch (error) {
+        dependencies.remoteSource.invalidate(expectation.userId);
+        throw error;
+    }
+}
+function admissionScopeChanged() {
+    return new DatabaseUnavailableError("The active database changed while admitting this user. Try again.");
+}
+/** Reads that admit a user: only `self` and `link` pins qualify. */
+function verifiedPinReaders(dependencies) {
+    const resolveVerified = async (userId) => {
+        const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
+        const pin = await loadPin({ execSql, identityTrustDomain, userId });
+        if (dependencies.getExecSql() !== execSql)
+            throw admissionScopeChanged();
+        return pin && pin.provenance !== "observed" ? pin.identity : null;
+    };
+    return {
+        resolveVerified,
+        async requireVerified(userId, admittingExecSql) {
+            const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
+            if (execSql !== admittingExecSql)
+                throw admissionScopeChanged();
+            const pin = await loadPin({ execSql, identityTrustDomain, userId });
+            if (dependencies.getExecSql() !== execSql)
+                throw admissionScopeChanged();
+            if (!pin || pin.provenance === "observed") {
+                throw new UnverifiedUserIdentityError(userId);
+            }
+            return pin.identity;
+        },
+    };
 }
 export function createTrustedUserIdentityService(dependencies) {
     return {
@@ -120,6 +202,7 @@ export function createTrustedUserIdentityService(dependencies) {
             const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
             return loadPinnedUserIdentity({ execSql, identityTrustDomain, userId });
         },
+        ...verifiedPinReaders(dependencies),
         async createLink(appUrl) {
             const identityTrustDomain = requireTrustDomain(dependencies);
             const userId = dependencies.getLocalUserId();
@@ -134,29 +217,7 @@ export function createTrustedUserIdentityService(dependencies) {
             });
             return createIdentityLink(identity, appUrl);
         },
-        async verifyLink(link) {
-            const expectation = parseIdentityLink(link);
-            const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
-            if (expectation.identityTrustDomain !== identityTrustDomain) {
-                throw new Error("This identity link belongs to a different Tearleads service.");
-            }
-            const localUserId = dependencies.getLocalUserId();
-            try {
-                const identity = await resolveCandidate(dependencies, expectation.userId, identityTrustDomain);
-                if (!identity)
-                    throw new Error("The identity in this link is unavailable.");
-                await assertIdentityLinkMatches(expectation, identity);
-                if (dependencies.getExecSql() !== execSql ||
-                    dependencies.getLocalUserId() !== localUserId) {
-                    throw new DatabaseUnavailableError("The active identity changed. Open the identity link again.");
-                }
-                return await pinIdentity({ dependencies, execSql, identity });
-            }
-            catch (error) {
-                dependencies.remoteSource.invalidate(expectation.userId);
-                throw error;
-            }
-        },
+        verifyLink: (link) => verifyIdentityLink(dependencies, link),
         async boundUserId(signingKeyFingerprint) {
             const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
             return loadTrustedUserIdForSigningKey({
@@ -173,17 +234,29 @@ export function createTrustedUserIdentityService(dependencies) {
                 identityTrustDomain,
                 userId,
             });
-            return pinIdentity({ dependencies, execSql, identity });
+            return pinIdentity({
+                dependencies,
+                execSql,
+                identity,
+                provenance: "self",
+            });
         },
         async resolve(userId) {
             assertTrustedUserIdentityUserId(userId);
             const { execSql, identityTrustDomain } = requireTrustStore(dependencies);
+            const localUserId = dependencies.getLocalUserId();
             try {
-                const identity = await resolveCandidate(dependencies, userId, identityTrustDomain);
-                if (!identity) {
+                const candidate = await resolveCandidate(dependencies, userId, identityTrustDomain);
+                if (!candidate) {
                     return null;
                 }
-                return await pinIdentity({ dependencies, execSql, identity });
+                assertResolutionScope(dependencies, { execSql, localUserId }, "The active identity changed while resolving this user.");
+                return await pinIdentity({
+                    dependencies,
+                    execSql,
+                    identity: candidate.identity,
+                    provenance: candidate.source,
+                });
             }
             catch (error) {
                 dependencies.remoteSource.invalidate(userId);