emdash 0.37.0 → 0.38.0

package/dist/{content-repair-Czdp7jz5.mjs → content-repair-CIMt5C0U.mjs}

@@ -1,7 +1,7 @@
 import { t as validateIdentifier } from "./validate-BpwoDOgt.mjs";
-import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-C4szrD8o.mjs";
-import { f as withContentUsageCollectionLock, g as MediaUsageFieldDiscoveryError, h as buildContentMediaUsageSourceKey, m as MEDIA_USAGE_CONTENT_SOURCE_VARIANTS, n as CONTENT_MEDIA_USAGE_COLLECTION_SCOPE, p as loadContentMediaUsageSnapshots, t as CONTENT_MEDIA_USAGE_ADAPTER_ID, v as loadContentMediaUsageFields, x as CONTENT_SOURCE_SCHEMA_VERSION, y as MediaUsageRepository } from "./content-refresh-Bwp-8yGy.mjs";
-import { t as MediaUsageWorkRepository } from "./media-usage-work-D6D9sMCA.mjs";
+import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-VG_tyqnP.mjs";
+import { f as withContentUsageCollectionLock, g as MediaUsageFieldDiscoveryError, h as buildContentMediaUsageSourceKey, m as MEDIA_USAGE_CONTENT_SOURCE_VARIANTS, n as CONTENT_MEDIA_USAGE_COLLECTION_SCOPE, p as loadContentMediaUsageSnapshots, t as CONTENT_MEDIA_USAGE_ADAPTER_ID, v as loadContentMediaUsageFields, x as CONTENT_SOURCE_SCHEMA_VERSION, y as MediaUsageRepository } from "./content-refresh-GTMyi2Xy.mjs";
+import { t as MediaUsageWorkRepository } from "./media-usage-work-C5B1zT1c.mjs";
 import { sql } from "kysely";
 import { ulid } from "ulidx";
 
@@ -437,4 +437,4 @@ function getContentTableName(collectionSlug) {
 
 //#endregion
 export { repairContentMediaUsageCollection as n, repairContentMediaUsageAll as t };
-//# sourceMappingURL=content-repair-Czdp7jz5.mjs.map
+//# sourceMappingURL=content-repair-CIMt5C0U.mjs.map

package/dist/{content-repair-Czdp7jz5.mjs.map → content-repair-CIMt5C0U.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"content-repair-Czdp7jz5.mjs","names":[],"sources":["../src/media/usage/content-repair.ts"],"sourcesContent":["import { sql, type Kysely } from \"kysely\";\nimport { ulid } from \"ulidx\";\n\nimport { MediaUsageWorkRepository } from \"../../database/repositories/media-usage-work.js\";\nimport {\n\tMediaUsageRepository,\n\ttype MediaUsageSource,\n} from \"../../database/repositories/media-usage.js\";\nimport type { Database } from \"../../database/types.js\";\nimport { validateIdentifier } from \"../../database/validate.js\";\nimport { chunks, SQL_BATCH_SIZE } from \"../../utils/chunks.js\";\nimport {\n\tloadContentMediaUsageFields,\n\tMediaUsageFieldDiscoveryError,\n\ttype ContentMediaUsageFieldDiscovery,\n} from \"./content-fields.js\";\nimport {\n\tCONTENT_MEDIA_USAGE_ADAPTER_ID,\n\tCONTENT_MEDIA_USAGE_COLLECTION_SCOPE,\n\twithContentUsageCollectionLock,\n} from \"./content-refresh.js\";\nimport {\n\tCONTENT_SOURCE_SCHEMA_VERSION,\n\ttype ContentMediaUsageSnapshot,\n\tloadContentMediaUsageSnapshots,\n} from \"./content-snapshots.js\";\nimport {\n\tbuildContentMediaUsageSourceKey,\n\tMEDIA_USAGE_CONTENT_SOURCE_VARIANTS,\n} from \"./source-key.js\";\n\nexport type ContentMediaUsageRepairStatus = \"complete\" | \"partial\" | \"failed\" | \"stale\";\n\nexport const CONTENT_MEDIA_USAGE_REPAIR_ERROR = {\n\tCOLLECTION_NOT_FOUND: \"COLLECTION_NOT_FOUND\",\n\tCONTENT_NOT_FOUND: \"CONTENT_NOT_FOUND\",\n\tDRAFT_REVISION_NOT_FOUND: \"DRAFT_REVISION_NOT_FOUND\",\n\tDRAFT_REVISION_MISMATCH: \"DRAFT_REVISION_MISMATCH\",\n\tDRAFT_REVISION_INVALID: \"DRAFT_REVISION_INVALID\",\n\tCONTENT_USAGE_REPAIR_ERROR: \"CONTENT_USAGE_REPAIR_ERROR\",\n\tCONTENT_USAGE_REPAIR_CONFLICT: \"CONTENT_USAGE_REPAIR_CONFLICT\",\n\tINVALID_REPEATER_VALIDATION: \"INVALID_REPEATER_VALIDATION\",\n} as const;\n\nexport type ContentMediaUsageRepairErrorCode =\n\t(typeof CONTENT_MEDIA_USAGE_REPAIR_ERROR)[keyof typeof CONTENT_MEDIA_USAGE_REPAIR_ERROR];\n\nexport interface ContentMediaUsageRepairCollectionInput {\n\tcollectionSlug: string;\n}\n\nexport interface ContentMediaUsageRepairScope {\n\tadapterId: typeof CONTENT_MEDIA_USAGE_ADAPTER_ID;\n\tscopeType: typeof CONTENT_MEDIA_USAGE_COLLECTION_SCOPE;\n\tscopeKey: string;\n}\n\nexport interface ContentMediaUsageRepairCollectionResult {\n\tscope: ContentMediaUsageRepairScope;\n\tstatus: ContentMediaUsageRepairStatus;\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tlastErrorCode: string | null;\n\tstartedAt: string;\n\tcompletedAt: string | null;\n}\n\nexport interface ContentMediaUsageRepairAllResult {\n\tstatus: ContentMediaUsageRepairStatus;\n\tcollections: ContentMediaUsageRepairCollectionResult[];\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n}\n\nexport interface ContentMediaUsageCollectionScan {\n\tcollectionSlug: string;\n\tcontentIds: string[];\n}\n\ninterface ContentMediaUsageCollectionRecord {\n\tid: string;\n\tslug: string;\n}\n\ninterface ContentMediaUsageInitialCollectionResult {\n\tcollection: ContentMediaUsageCollectionRecord;\n\tresult: ContentMediaUsageRepairCollectionResult;\n}\n\ninterface ContentMediaUsageRepairExecution {\n\tcollectionId: string;\n\tstartingEpoch: number | string;\n}\n\nexport async function repairContentMediaUsageAll(\n\tdb: Kysely<Database>,\n): Promise<ContentMediaUsageRepairAllResult> {\n\tconst collections = await loadContentMediaUsageCollectionRecords(db);\n\tconst results: ContentMediaUsageInitialCollectionResult[] = [];\n\n\tfor (const collection of collections) {\n\t\tresults.push({\n\t\t\tcollection,\n\t\t\tresult: await repairContentMediaUsageCollectionSafely(db, collection),\n\t\t});\n\t}\n\n\treturn aggregateContentMediaUsageRepairAll(\n\t\tawait filterExistingContentMediaUsageCollectionResults(db, results),\n\t);\n}\n\nexport async function scanContentMediaUsageCollection(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n\texpectedCollectionId?: string,\n): Promise<ContentMediaUsageCollectionScan | null> {\n\tvalidateIdentifier(collectionSlug, \"collection slug\");\n\tlet collectionQuery = db\n\t\t.selectFrom(\"_emdash_collections\")\n\t\t.select(\"id\")\n\t\t.where(\"slug\", \"=\", collectionSlug);\n\tif (expectedCollectionId !== undefined) {\n\t\tcollectionQuery = collectionQuery.where(\"id\", \"=\", expectedCollectionId);\n\t}\n\tconst collection = await collectionQuery.executeTakeFirst();\n\tif (!collection) return null;\n\n\tconst tableName = getContentTableName(collectionSlug);\n\tconst rows = await sql<{ id: string }>`\n\t\tSELECT content.id\n\t\tFROM ${sql.ref(tableName)} AS content\n\t\tWHERE EXISTS (\n\t\t\tSELECT 1\n\t\t\tFROM _emdash_collections AS collection\n\t\t\tWHERE collection.id = ${collection.id}\n\t\t\t\tAND collection.slug = ${collectionSlug}\n\t\t)\n\t\tORDER BY content.id ASC\n\t`.execute(db);\n\n\treturn {\n\t\tcollectionSlug,\n\t\tcontentIds: rows.rows.map((row) => row.id),\n\t};\n}\n\nexport async function repairContentMediaUsageCollection(\n\tdb: Kysely<Database>,\n\tinput: ContentMediaUsageRepairCollectionInput,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\tvalidateIdentifier(input.collectionSlug, \"collection slug\");\n\treturn withContentUsageCollectionLock(input.collectionSlug, () =>\n\t\trepairContentMediaUsageCollectionUnlocked(db, input.collectionSlug),\n\t);\n}\n\nasync function loadContentMediaUsageCollectionRecords(\n\tdb: Kysely<Database>,\n): Promise<ContentMediaUsageCollectionRecord[]> {\n\treturn db\n\t\t.selectFrom(\"_emdash_collections\")\n\t\t.select([\"id\", \"slug\"])\n\t\t.orderBy(\"slug\", \"asc\")\n\t\t.execute();\n}\n\nasync function repairContentMediaUsageCollectionSafely(\n\tdb: Kysely<Database>,\n\tcollection: ContentMediaUsageCollectionRecord,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\ttry {\n\t\treturn await withContentUsageCollectionLock(collection.slug, () =>\n\t\t\trepairContentMediaUsageCollectionUnlocked(db, collection.slug, collection.id),\n\t\t);\n\t} catch (error) {\n\t\tconsole.error(`[media-usage] Failed to repair collection ${collection.slug}:`, error);\n\t\tconst now = new Date().toISOString();\n\t\treturn {\n\t\t\tscope: contentMediaUsageCollectionScope(collection.slug),\n\t\t\tstatus: \"failed\",\n\t\t\tindexedSourceCount: 0,\n\t\t\tfailedSourceCount: 0,\n\t\t\tskippedSourceCount: 0,\n\t\t\tdeletedSourceCount: 0,\n\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_ERROR,\n\t\t\tstartedAt: now,\n\t\t\tcompletedAt: now,\n\t\t};\n\t}\n}\n\nasync function filterExistingContentMediaUsageCollectionResults(\n\tdb: Kysely<Database>,\n\tresults: readonly ContentMediaUsageInitialCollectionResult[],\n): Promise<ContentMediaUsageRepairCollectionResult[]> {\n\tconst identityBound = await isIncrementalCaptureActive(db);\n\tconst currentCollections = await loadContentMediaUsageCollectionRecordsSafely(db);\n\tconst currentIdsBySlug = new Map(\n\t\tcurrentCollections.map((collection) => [collection.slug, collection.id]),\n\t);\n\tconst includedResults: ContentMediaUsageRepairCollectionResult[] = [];\n\tconst excludedResults: ContentMediaUsageInitialCollectionResult[] = [];\n\n\tfor (const { collection, result } of results) {\n\t\tif (currentIdsBySlug.get(collection.slug) === collection.id) {\n\t\t\tincludedResults.push(result);\n\t\t} else {\n\t\t\texcludedResults.push({ collection, result });\n\t\t}\n\t}\n\n\tif (excludedResults.length > 0) {\n\t\tconst repo = new MediaUsageRepository(db);\n\t\tfor (const excluded of excludedResults) {\n\t\t\tawait repo.deleteIndexStatus(\n\t\t\t\texcluded.result.scope,\n\t\t\t\tidentityBound ? excluded.collection.id : undefined,\n\t\t\t);\n\t\t}\n\t}\n\n\treturn includedResults;\n}\n\nasync function loadContentMediaUsageCollectionRecordsSafely(\n\tdb: Kysely<Database>,\n): Promise<ContentMediaUsageCollectionRecord[]> {\n\ttry {\n\t\treturn await loadContentMediaUsageCollectionRecords(db);\n\t} catch {\n\t\t// Retry once before failing; returning unpruned results can over-report deleted collections.\n\t}\n\n\ttry {\n\t\treturn await loadContentMediaUsageCollectionRecords(db);\n\t} catch (error) {\n\t\tconsole.error(\"[media-usage] Failed to reconcile all-content repair collections:\", error);\n\t\tthrow error;\n\t}\n}\n\nfunction aggregateContentMediaUsageRepairAll(\n\tcollections: readonly ContentMediaUsageRepairCollectionResult[],\n): ContentMediaUsageRepairAllResult {\n\treturn {\n\t\tstatus: determineRepairAllStatus(collections),\n\t\tcollections: [...collections],\n\t\tindexedSourceCount: sumCollectionRepairCount(collections, \"indexedSourceCount\"),\n\t\tfailedSourceCount: sumCollectionRepairCount(collections, \"failedSourceCount\"),\n\t\tskippedSourceCount: sumCollectionRepairCount(collections, \"skippedSourceCount\"),\n\t\tdeletedSourceCount: sumCollectionRepairCount(collections, \"deletedSourceCount\"),\n\t};\n}\n\nfunction determineRepairAllStatus(\n\tcollections: readonly ContentMediaUsageRepairCollectionResult[],\n): ContentMediaUsageRepairStatus {\n\tif (collections.length === 0) return \"complete\";\n\tif (collections.every((collection) => collection.status === \"complete\")) return \"complete\";\n\tif (collections.some((collection) => collection.status === \"stale\")) return \"stale\";\n\tif (collections.some((collection) => collection.status === \"partial\")) return \"partial\";\n\tif (collections.every((collection) => collection.status === \"failed\")) return \"failed\";\n\treturn \"partial\";\n}\n\nfunction sumCollectionRepairCount(\n\tcollections: readonly ContentMediaUsageRepairCollectionResult[],\n\tkey: \"indexedSourceCount\" | \"failedSourceCount\" | \"skippedSourceCount\" | \"deletedSourceCount\",\n): number {\n\treturn collections.reduce((sum, collection) => sum + collection[key], 0);\n}\n\nasync function repairContentMediaUsageCollectionUnlocked(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n\texpectedCollectionId?: string,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\tconst requestedAt = new Date().toISOString();\n\tconst scope = contentMediaUsageCollectionScope(collectionSlug);\n\tconst identityBound = await isIncrementalCaptureActive(db);\n\tconst collection = await loadContentMediaUsageCollectionRecord(db, collectionSlug);\n\tif (\n\t\t!collection ||\n\t\t(identityBound && expectedCollectionId && collection.id !== expectedCollectionId)\n\t) {\n\t\treturn {\n\t\t\tscope,\n\t\t\tstatus: \"failed\",\n\t\t\tindexedSourceCount: 0,\n\t\t\tfailedSourceCount: 0,\n\t\t\tskippedSourceCount: 0,\n\t\t\tdeletedSourceCount: 0,\n\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.COLLECTION_NOT_FOUND,\n\t\t\tstartedAt: requestedAt,\n\t\t\tcompletedAt: requestedAt,\n\t\t};\n\t}\n\n\tconst repo = new MediaUsageRepository(db);\n\tconst runToken = ulid();\n\tlet startedAt = requestedAt;\n\tlet execution: ContentMediaUsageRepairExecution | undefined;\n\tif (identityBound) {\n\t\tconst run = await repo.beginIndexStatusRepairAtCurrentEpoch({\n\t\t\t...scope,\n\t\t\tcollectionId: collection.id,\n\t\t\trunToken,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t});\n\t\tif (!run) {\n\t\t\treturn {\n\t\t\t\tscope,\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tindexedSourceCount: 0,\n\t\t\t\tfailedSourceCount: 0,\n\t\t\t\tskippedSourceCount: 0,\n\t\t\t\tdeletedSourceCount: 0,\n\t\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_ERROR,\n\t\t\t\tstartedAt,\n\t\t\t\tcompletedAt: requestedAt,\n\t\t\t};\n\t\t}\n\t\tstartedAt = run.startedAt;\n\t\texecution = { collectionId: collection.id, startingEpoch: run.changeEpoch };\n\t} else {\n\t\tawait repo.beginIndexStatusRepair({\n\t\t\t...scope,\n\t\t\trunToken,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t\tstartedAt,\n\t\t});\n\t}\n\n\ttry {\n\t\tconst scan = await scanContentMediaUsageCollection(db, collectionSlug, execution?.collectionId);\n\t\tif (!scan) {\n\t\t\tconst completedAt = new Date().toISOString();\n\t\t\treturn await finalizeRepairStatus(db, repo, {\n\t\t\t\t...scope,\n\t\t\t\trunToken,\n\t\t\t\tcounts: {\n\t\t\t\t\tindexedSourceCount: 0,\n\t\t\t\t\tfailedSourceCount: 0,\n\t\t\t\t\tskippedSourceCount: 0,\n\t\t\t\t\tdeletedSourceCount: 0,\n\t\t\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.COLLECTION_NOT_FOUND,\n\t\t\t\t\tmissingContentIds: new Set(),\n\t\t\t\t},\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tstartedAt,\n\t\t\t\tcompletedAt,\n\t\t\t\texecution,\n\t\t\t});\n\t\t}\n\t\tconst counts = await repairScannedContentSources(db, repo, scan, execution?.collectionId);\n\t\tconst finalScan = await scanContentMediaUsageCollection(\n\t\t\tdb,\n\t\t\tcollectionSlug,\n\t\t\texecution?.collectionId,\n\t\t);\n\t\tif (!finalScan) {\n\t\t\tcounts.failedSourceCount++;\n\t\t\tcounts.lastErrorCode = CONTENT_MEDIA_USAGE_REPAIR_ERROR.COLLECTION_NOT_FOUND;\n\t\t} else if (!sameContentIds(repairedContentIds(scan.contentIds, counts), finalScan.contentIds)) {\n\t\t\tmarkRepairConflict(counts);\n\t\t}\n\t\tconst completedAt = new Date().toISOString();\n\t\tconst status = determineRepairStatus(counts);\n\t\treturn await finalizeRepairStatus(db, repo, {\n\t\t\t...scope,\n\t\t\trunToken,\n\t\t\tcounts,\n\t\t\tstatus,\n\t\t\tstartedAt,\n\t\t\tcompletedAt,\n\t\t\texecution,\n\t\t});\n\t} catch (error) {\n\t\tif (!(error instanceof MediaUsageFieldDiscoveryError)) {\n\t\t\tconsole.error(`[media-usage] Failed to repair collection ${collectionSlug}:`, error);\n\t\t}\n\t\tconst completedAt = new Date().toISOString();\n\t\tconst lastErrorCode =\n\t\t\terror instanceof MediaUsageFieldDiscoveryError\n\t\t\t\t? error.code\n\t\t\t\t: CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_ERROR;\n\t\treturn finalizeRepairStatus(db, repo, {\n\t\t\t...scope,\n\t\t\trunToken,\n\t\t\tcounts: {\n\t\t\t\tindexedSourceCount: 0,\n\t\t\t\tfailedSourceCount: 0,\n\t\t\t\tskippedSourceCount: 0,\n\t\t\t\tdeletedSourceCount: 0,\n\t\t\t\tlastErrorCode,\n\t\t\t\tmissingContentIds: new Set(),\n\t\t\t},\n\t\t\tstatus: \"failed\",\n\t\t\tstartedAt,\n\t\t\tcompletedAt,\n\t\t\texecution,\n\t\t});\n\t}\n}\n\ninterface RepairCounts {\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tlastErrorCode: ContentMediaUsageRepairErrorCode | null;\n\tmissingContentIds: Set<string>;\n}\n\nasync function repairScannedContentSources(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tscan: ContentMediaUsageCollectionScan,\n\tcollectionId?: string,\n): Promise<RepairCounts> {\n\tconst counts: RepairCounts = {\n\t\tindexedSourceCount: 0,\n\t\tfailedSourceCount: 0,\n\t\tskippedSourceCount: 0,\n\t\tdeletedSourceCount: 0,\n\t\tlastErrorCode: null,\n\t\tmissingContentIds: new Set(),\n\t};\n\n\tconst fieldDiscovery = await loadContentMediaUsageFields(db, scan.collectionSlug, collectionId);\n\tconst observedSources = await repo.findSources(buildContentSourceKeysForScan(scan, collectionId));\n\n\tfor (const contentId of scan.contentIds) {\n\t\tawait repairContentSource(\n\t\t\tdb,\n\t\t\trepo,\n\t\t\tscan.collectionSlug,\n\t\t\tcontentId,\n\t\t\tfieldDiscovery,\n\t\t\tobservedSources,\n\t\t\tcounts,\n\t\t\tcollectionId,\n\t\t);\n\t}\n\n\tawait reconcileOrphanedContentSources(db, repo, scan.collectionSlug, counts, collectionId);\n\treturn counts;\n}\n\nasync function repairContentSource(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tcollectionSlug: string,\n\tcontentId: string,\n\tfieldDiscovery: ContentMediaUsageFieldDiscovery,\n\tobservedSources: Map<string, MediaUsageSource>,\n\tcounts: RepairCounts,\n\tcollectionId?: string,\n): Promise<void> {\n\tconst sourceKeys = buildContentSourceKeys(collectionSlug, contentId, collectionId);\n\tconst snapshotsResult = await loadContentMediaUsageSnapshots(\n\t\tdb,\n\t\tcollectionSlug,\n\t\tcontentId,\n\t\tfieldDiscovery,\n\t\tcollectionId ? { collectionId, identityVersion: 1 } : undefined,\n\t);\n\tif (!snapshotsResult.success) {\n\t\tif (snapshotsResult.error === CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_NOT_FOUND) {\n\t\t\tmarkRepairConflict(counts);\n\t\t\tcounts.missingContentIds.add(contentId);\n\t\t\treturn;\n\t\t}\n\t\tcounts.lastErrorCode = snapshotsResult.error;\n\t\tif (snapshotsResult.snapshots) {\n\t\t\t// Partial snapshot failures keep absent variants in place; the attempted source is marked below.\n\t\t\tawait repairSnapshotSources(repo, snapshotsResult.snapshots, observedSources, counts);\n\t\t}\n\t\tif (snapshotsResult.source) {\n\t\t\tconst result = await repo.markSourceAttemptedIfMatching(\n\t\t\t\t{\n\t\t\t\t\t...snapshotsResult.source,\n\t\t\t\t\tsourceCompleteness: \"failed\",\n\t\t\t\t\tlastErrorCode: snapshotsResult.error,\n\t\t\t\t},\n\t\t\t\tobservedSources.get(snapshotsResult.source.sourceKey) ?? null,\n\t\t\t);\n\t\t\tif (result.attempted) {\n\t\t\t\tcounts.failedSourceCount++;\n\t\t\t} else {\n\t\t\t\tmarkRepairConflict(counts);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tcounts.failedSourceCount++;\n\t\treturn;\n\t}\n\n\tconst expectedSourceKeys = await repairSnapshotSources(\n\t\trepo,\n\t\tsnapshotsResult.snapshots,\n\t\tobservedSources,\n\t\tcounts,\n\t);\n\n\tfor (const sourceKey of sourceKeys) {\n\t\tif (expectedSourceKeys.has(sourceKey)) continue;\n\t\tconst observedSource = observedSources.get(sourceKey);\n\t\tif (!observedSource) continue;\n\t\tawait deleteObservedSource(repo, sourceKey, observedSource, counts);\n\t}\n}\n\nasync function repairSnapshotSources(\n\trepo: MediaUsageRepository,\n\tsnapshots: readonly ContentMediaUsageSnapshot[],\n\tobservedSources: Map<string, MediaUsageSource>,\n\tcounts: RepairCounts,\n): Promise<Set<string>> {\n\tconst expectedSourceKeys = new Set<string>();\n\tfor (const snapshot of snapshots) {\n\t\texpectedSourceKeys.add(snapshot.source.sourceKey);\n\t\tconst result = await repo.replaceSourceIfMatching(\n\t\t\tsnapshot.source,\n\t\t\tsnapshot.occurrences,\n\t\t\tobservedSources.get(snapshot.source.sourceKey) ?? null,\n\t\t);\n\t\tif (result.replaced || result.unchanged) {\n\t\t\tcounts.indexedSourceCount++;\n\t\t} else {\n\t\t\tmarkRepairConflict(counts);\n\t\t}\n\t}\n\treturn expectedSourceKeys;\n}\n\nfunction markRepairConflict(counts: RepairCounts): void {\n\tcounts.skippedSourceCount++;\n\tcounts.lastErrorCode ??= CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_CONFLICT;\n}\n\nasync function reconcileOrphanedContentSources(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tcollectionSlug: string,\n\tcounts: RepairCounts,\n\tcollectionId?: string,\n): Promise<void> {\n\tconst sources = await repo.findCollectionContentSources(collectionSlug, collectionId);\n\tconst existingContentIds = await findExistingContentIds(\n\t\tdb,\n\t\tcollectionSlug,\n\t\tsources.flatMap((source) => (source.contentId ? [source.contentId] : [])),\n\t\tcollectionId,\n\t);\n\n\tfor (const source of sources) {\n\t\tif (!source.contentId) {\n\t\t\tawait deleteObservedSource(repo, source.sourceKey, source, counts);\n\t\t\tcontinue;\n\t\t}\n\t\tif (existingContentIds.has(source.contentId)) continue;\n\t\tawait deleteObservedSourceIfContentAbsent(repo, collectionSlug, source, counts);\n\t}\n}\n\nasync function findExistingContentIds(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n\tcontentIds: readonly string[],\n\tcollectionId?: string,\n): Promise<Set<string>> {\n\tvalidateIdentifier(collectionSlug, \"collection slug\");\n\tconst existingContentIds = new Set<string>();\n\tconst uniqueContentIds = [...new Set(contentIds)];\n\tif (uniqueContentIds.length === 0) return existingContentIds;\n\n\tconst tableName = getContentTableName(collectionSlug);\n\tfor (const contentIdBatch of chunks(uniqueContentIds, SQL_BATCH_SIZE)) {\n\t\tconst result = await sql<{ id: string }>`\n\t\t\tSELECT content.id\n\t\t\tFROM ${sql.ref(tableName)} AS content\n\t\t\tWHERE content.id IN (${sql.join(contentIdBatch)})\n\t\t\t${\n\t\t\t\tcollectionId\n\t\t\t\t\t? sql`AND EXISTS (\n\t\t\t\t\t\tSELECT 1\n\t\t\t\t\t\tFROM _emdash_collections AS collection\n\t\t\t\t\t\tWHERE collection.id = ${collectionId}\n\t\t\t\t\t\t\tAND collection.slug = ${collectionSlug}\n\t\t\t\t\t)`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t`.execute(db);\n\t\tfor (const row of result.rows) {\n\t\t\texistingContentIds.add(row.id);\n\t\t}\n\t}\n\n\treturn existingContentIds;\n}\n\nasync function deleteObservedSourceIfContentAbsent(\n\trepo: MediaUsageRepository,\n\tcollectionSlug: string,\n\tobservedSource: MediaUsageSource,\n\tcounts: RepairCounts,\n): Promise<void> {\n\tif (!observedSource.contentId) return;\n\tconst result = await repo.deleteSourceIfMatchingContentAbsent(\n\t\tobservedSource.sourceKey,\n\t\tobservedSource,\n\t\tcollectionSlug,\n\t\tobservedSource.contentId,\n\t);\n\tif (result.deleted) {\n\t\tcounts.deletedSourceCount++;\n\t\treturn;\n\t}\n\tif (result.contentPresent) return;\n\tif (result.source) {\n\t\tmarkRepairConflict(counts);\n\t}\n}\n\nasync function deleteObservedSource(\n\trepo: MediaUsageRepository,\n\tsourceKey: string,\n\tobservedSource: MediaUsageSource,\n\tcounts: RepairCounts,\n): Promise<void> {\n\tconst result = await repo.deleteSourceIfMatching(sourceKey, observedSource);\n\tif (result.deleted) {\n\t\tcounts.deletedSourceCount++;\n\t\treturn;\n\t}\n\tif (result.source) {\n\t\tmarkRepairConflict(counts);\n\t}\n}\n\ninterface FinalizeInput extends ContentMediaUsageRepairScope {\n\trunToken: string;\n\tcounts: RepairCounts;\n\tstatus: Exclude<ContentMediaUsageRepairStatus, \"stale\">;\n\tstartedAt: string;\n\tcompletedAt: string;\n\texecution?: ContentMediaUsageRepairExecution;\n}\n\nasync function finalizeRepairStatus(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tinput: FinalizeInput,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\tlet result;\n\tif (input.execution) {\n\t\tif (input.status === \"complete\") {\n\t\t\tawait new MediaUsageWorkRepository(db).deleteWorkThroughEpoch(\n\t\t\t\tinput.execution.collectionId,\n\t\t\t\tinput.execution.startingEpoch,\n\t\t\t);\n\t\t}\n\t\tresult = await repo.finalizeIndexStatusRepairAtEpoch({\n\t\t\tadapterId: input.adapterId,\n\t\t\tscopeType: input.scopeType,\n\t\t\tscopeKey: input.scopeKey,\n\t\t\tcollectionId: input.execution.collectionId,\n\t\t\trunToken: input.runToken,\n\t\t\tstartingEpoch: input.execution.startingEpoch,\n\t\t\tstatus: input.status,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t\tindexedSourceCount: input.counts.indexedSourceCount,\n\t\t\tfailedSourceCount: input.counts.failedSourceCount,\n\t\t\tlastErrorCode: input.counts.lastErrorCode,\n\t\t});\n\t} else {\n\t\tresult = await repo.finalizeIndexStatusRepairIfRunning({\n\t\t\tadapterId: input.adapterId,\n\t\t\tscopeType: input.scopeType,\n\t\t\tscopeKey: input.scopeKey,\n\t\t\trunToken: input.runToken,\n\t\t\tstatus: input.status,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t\tcompletedAt: input.completedAt,\n\t\t\tindexedSourceCount: input.counts.indexedSourceCount,\n\t\t\tfailedSourceCount: input.counts.failedSourceCount,\n\t\t\tlastErrorCode: input.counts.lastErrorCode,\n\t\t});\n\t}\n\n\treturn {\n\t\tscope: {\n\t\t\tadapterId: input.adapterId,\n\t\t\tscopeType: input.scopeType,\n\t\t\tscopeKey: input.scopeKey,\n\t\t},\n\t\tstatus: result.finalized ? input.status : \"stale\",\n\t\tindexedSourceCount: input.counts.indexedSourceCount,\n\t\tfailedSourceCount: input.counts.failedSourceCount,\n\t\tskippedSourceCount: input.counts.skippedSourceCount,\n\t\tdeletedSourceCount: input.counts.deletedSourceCount,\n\t\tlastErrorCode: result.finalized\n\t\t\t? input.counts.lastErrorCode\n\t\t\t: (result.status?.lastErrorCode ??\n\t\t\t\tCONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_CONFLICT),\n\t\tstartedAt: input.startedAt,\n\t\tcompletedAt: result.finalized ? (result.status?.completedAt ?? input.completedAt) : null,\n\t};\n}\n\nfunction determineRepairStatus(\n\tcounts: RepairCounts,\n): Exclude<ContentMediaUsageRepairStatus, \"stale\"> {\n\tif (counts.failedSourceCount === 0 && counts.skippedSourceCount === 0) return \"complete\";\n\tconst trustedProgress = counts.indexedSourceCount + counts.deletedSourceCount;\n\tif (counts.failedSourceCount > 0 && trustedProgress === 0) {\n\t\treturn \"failed\";\n\t}\n\treturn \"partial\";\n}\n\nfunction buildContentSourceKeys(\n\tcollectionSlug: string,\n\tcontentId: string,\n\tcollectionId?: string,\n): string[] {\n\treturn MEDIA_USAGE_CONTENT_SOURCE_VARIANTS.map((sourceVariant) =>\n\t\tbuildContentMediaUsageSourceKey({ collectionId, collectionSlug, contentId, sourceVariant }),\n\t);\n}\n\nfunction buildContentSourceKeysForScan(\n\tscan: ContentMediaUsageCollectionScan,\n\tcollectionId?: string,\n): string[] {\n\treturn scan.contentIds.flatMap((contentId) =>\n\t\tbuildContentSourceKeys(scan.collectionSlug, contentId, collectionId),\n\t);\n}\n\nasync function loadContentMediaUsageCollectionRecord(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n): Promise<ContentMediaUsageCollectionRecord | null> {\n\tconst row = await db\n\t\t.selectFrom(\"_emdash_collections\")\n\t\t.select([\"id\", \"slug\"])\n\t\t.where(\"slug\", \"=\", collectionSlug)\n\t\t.executeTakeFirst();\n\treturn row ?? null;\n}\n\nasync function isIncrementalCaptureActive(db: Kysely<Database>): Promise<boolean> {\n\tconst row = await db\n\t\t.selectFrom(\"_emdash_media_usage_activation\")\n\t\t.select(\"state\")\n\t\t.where(\"task_key\", \"=\", \"incremental_capture\")\n\t\t.executeTakeFirst();\n\treturn row?.state === \"active\";\n}\n\nfunction sameContentIds(left: readonly string[], right: readonly string[]): boolean {\n\tif (left.length !== right.length) return false;\n\tconst rightIds = new Set(right);\n\treturn left.every((id) => rightIds.has(id));\n}\n\nfunction repairedContentIds(\n\tcontentIds: readonly string[],\n\tcounts: Pick<RepairCounts, \"missingContentIds\">,\n): string[] {\n\tif (counts.missingContentIds.size === 0) return [...contentIds];\n\treturn contentIds.filter((contentId) => !counts.missingContentIds.has(contentId));\n}\n\nfunction contentMediaUsageCollectionScope(collectionSlug: string): ContentMediaUsageRepairScope {\n\treturn {\n\t\tadapterId: CONTENT_MEDIA_USAGE_ADAPTER_ID,\n\t\tscopeType: CONTENT_MEDIA_USAGE_COLLECTION_SCOPE,\n\t\tscopeKey: collectionSlug,\n\t};\n}\n\nfunction getContentTableName(collectionSlug: string): string {\n\tvalidateIdentifier(collectionSlug, \"collection slug\");\n\treturn `ec_${collectionSlug}`;\n}\n"],"mappings":";;;;;;;;AAiCA,MAAa,mCAAmC;CAC/C,sBAAsB;CACtB,mBAAmB;CACnB,0BAA0B;CAC1B,yBAAyB;CACzB,wBAAwB;CACxB,4BAA4B;CAC5B,+BAA+B;CAC/B,6BAA6B;CAC7B;AAwDD,eAAsB,2BACrB,IAC4C;CAC5C,MAAM,cAAc,MAAM,uCAAuC,GAAG;CACpE,MAAM,UAAsD,EAAE;AAE9D,MAAK,MAAM,cAAc,YACxB,SAAQ,KAAK;EACZ;EACA,QAAQ,MAAM,wCAAwC,IAAI,WAAW;EACrE,CAAC;AAGH,QAAO,oCACN,MAAM,iDAAiD,IAAI,QAAQ,CACnE;;AAGF,eAAsB,gCACrB,IACA,gBACA,sBACkD;AAClD,oBAAmB,gBAAgB,kBAAkB;CACrD,IAAI,kBAAkB,GACpB,WAAW,sBAAsB,CACjC,OAAO,KAAK,CACZ,MAAM,QAAQ,KAAK,eAAe;AACpC,KAAI,yBAAyB,OAC5B,mBAAkB,gBAAgB,MAAM,MAAM,KAAK,qBAAqB;CAEzE,MAAM,aAAa,MAAM,gBAAgB,kBAAkB;AAC3D,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,YAAY,oBAAoB,eAAe;AAarD,QAAO;EACN;EACA,aAdY,MAAM,GAAmB;;SAE9B,IAAI,IAAI,UAAU,CAAC;;;;2BAID,WAAW,GAAG;4BACb,eAAe;;;GAGxC,QAAQ,GAAG,EAIK,KAAK,KAAK,QAAQ,IAAI,GAAG;EAC1C;;AAGF,eAAsB,kCACrB,IACA,OACmD;AACnD,oBAAmB,MAAM,gBAAgB,kBAAkB;AAC3D,QAAO,+BAA+B,MAAM,sBAC3C,0CAA0C,IAAI,MAAM,eAAe,CACnE;;AAGF,eAAe,uCACd,IAC+C;AAC/C,QAAO,GACL,WAAW,sBAAsB,CACjC,OAAO,CAAC,MAAM,OAAO,CAAC,CACtB,QAAQ,QAAQ,MAAM,CACtB,SAAS;;AAGZ,eAAe,wCACd,IACA,YACmD;AACnD,KAAI;AACH,SAAO,MAAM,+BAA+B,WAAW,YACtD,0CAA0C,IAAI,WAAW,MAAM,WAAW,GAAG,CAC7E;UACO,OAAO;AACf,UAAQ,MAAM,6CAA6C,WAAW,KAAK,IAAI,MAAM;EACrF,MAAM,uBAAM,IAAI,MAAM,EAAC,aAAa;AACpC,SAAO;GACN,OAAO,iCAAiC,WAAW,KAAK;GACxD,QAAQ;GACR,oBAAoB;GACpB,mBAAmB;GACnB,oBAAoB;GACpB,oBAAoB;GACpB,eAAe,iCAAiC;GAChD,WAAW;GACX,aAAa;GACb;;;AAIH,eAAe,iDACd,IACA,SACqD;CACrD,MAAM,gBAAgB,MAAM,2BAA2B,GAAG;CAC1D,MAAM,qBAAqB,MAAM,6CAA6C,GAAG;CACjF,MAAM,mBAAmB,IAAI,IAC5B,mBAAmB,KAAK,eAAe,CAAC,WAAW,MAAM,WAAW,GAAG,CAAC,CACxE;CACD,MAAM,kBAA6D,EAAE;CACrE,MAAM,kBAA8D,EAAE;AAEtE,MAAK,MAAM,EAAE,YAAY,YAAY,QACpC,KAAI,iBAAiB,IAAI,WAAW,KAAK,KAAK,WAAW,GACxD,iBAAgB,KAAK,OAAO;KAE5B,iBAAgB,KAAK;EAAE;EAAY;EAAQ,CAAC;AAI9C,KAAI,gBAAgB,SAAS,GAAG;EAC/B,MAAM,OAAO,IAAI,qBAAqB,GAAG;AACzC,OAAK,MAAM,YAAY,gBACtB,OAAM,KAAK,kBACV,SAAS,OAAO,OAChB,gBAAgB,SAAS,WAAW,KAAK,OACzC;;AAIH,QAAO;;AAGR,eAAe,6CACd,IAC+C;AAC/C,KAAI;AACH,SAAO,MAAM,uCAAuC,GAAG;SAChD;AAIR,KAAI;AACH,SAAO,MAAM,uCAAuC,GAAG;UAC/C,OAAO;AACf,UAAQ,MAAM,qEAAqE,MAAM;AACzF,QAAM;;;AAIR,SAAS,oCACR,aACmC;AACnC,QAAO;EACN,QAAQ,yBAAyB,YAAY;EAC7C,aAAa,CAAC,GAAG,YAAY;EAC7B,oBAAoB,yBAAyB,aAAa,qBAAqB;EAC/E,mBAAmB,yBAAyB,aAAa,oBAAoB;EAC7E,oBAAoB,yBAAyB,aAAa,qBAAqB;EAC/E,oBAAoB,yBAAyB,aAAa,qBAAqB;EAC/E;;AAGF,SAAS,yBACR,aACgC;AAChC,KAAI,YAAY,WAAW,EAAG,QAAO;AACrC,KAAI,YAAY,OAAO,eAAe,WAAW,WAAW,WAAW,CAAE,QAAO;AAChF,KAAI,YAAY,MAAM,eAAe,WAAW,WAAW,QAAQ,CAAE,QAAO;AAC5E,KAAI,YAAY,MAAM,eAAe,WAAW,WAAW,UAAU,CAAE,QAAO;AAC9E,KAAI,YAAY,OAAO,eAAe,WAAW,WAAW,SAAS,CAAE,QAAO;AAC9E,QAAO;;AAGR,SAAS,yBACR,aACA,KACS;AACT,QAAO,YAAY,QAAQ,KAAK,eAAe,MAAM,WAAW,MAAM,EAAE;;AAGzE,eAAe,0CACd,IACA,gBACA,sBACmD;CACnD,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;CAC5C,MAAM,QAAQ,iCAAiC,eAAe;CAC9D,MAAM,gBAAgB,MAAM,2BAA2B,GAAG;CAC1D,MAAM,aAAa,MAAM,sCAAsC,IAAI,eAAe;AAClF,KACC,CAAC,cACA,iBAAiB,wBAAwB,WAAW,OAAO,qBAE5D,QAAO;EACN;EACA,QAAQ;EACR,oBAAoB;EACpB,mBAAmB;EACnB,oBAAoB;EACpB,oBAAoB;EACpB,eAAe,iCAAiC;EAChD,WAAW;EACX,aAAa;EACb;CAGF,MAAM,OAAO,IAAI,qBAAqB,GAAG;CACzC,MAAM,WAAW,MAAM;CACvB,IAAI,YAAY;CAChB,IAAI;AACJ,KAAI,eAAe;EAClB,MAAM,MAAM,MAAM,KAAK,qCAAqC;GAC3D,GAAG;GACH,cAAc,WAAW;GACzB;GACA,eAAe;GACf,CAAC;AACF,MAAI,CAAC,IACJ,QAAO;GACN;GACA,QAAQ;GACR,oBAAoB;GACpB,mBAAmB;GACnB,oBAAoB;GACpB,oBAAoB;GACpB,eAAe,iCAAiC;GAChD;GACA,aAAa;GACb;AAEF,cAAY,IAAI;AAChB,cAAY;GAAE,cAAc,WAAW;GAAI,eAAe,IAAI;GAAa;OAE3E,OAAM,KAAK,uBAAuB;EACjC,GAAG;EACH;EACA,eAAe;EACf;EACA,CAAC;AAGH,KAAI;EACH,MAAM,OAAO,MAAM,gCAAgC,IAAI,gBAAgB,WAAW,aAAa;AAC/F,MAAI,CAAC,MAAM;GACV,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;AAC5C,UAAO,MAAM,qBAAqB,IAAI,MAAM;IAC3C,GAAG;IACH;IACA,QAAQ;KACP,oBAAoB;KACpB,mBAAmB;KACnB,oBAAoB;KACpB,oBAAoB;KACpB,eAAe,iCAAiC;KAChD,mCAAmB,IAAI,KAAK;KAC5B;IACD,QAAQ;IACR;IACA;IACA;IACA,CAAC;;EAEH,MAAM,SAAS,MAAM,4BAA4B,IAAI,MAAM,MAAM,WAAW,aAAa;EACzF,MAAM,YAAY,MAAM,gCACvB,IACA,gBACA,WAAW,aACX;AACD,MAAI,CAAC,WAAW;AACf,UAAO;AACP,UAAO,gBAAgB,iCAAiC;aAC9C,CAAC,eAAe,mBAAmB,KAAK,YAAY,OAAO,EAAE,UAAU,WAAW,CAC5F,oBAAmB,OAAO;EAE3B,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;EAC5C,MAAM,SAAS,sBAAsB,OAAO;AAC5C,SAAO,MAAM,qBAAqB,IAAI,MAAM;GAC3C,GAAG;GACH;GACA;GACA;GACA;GACA;GACA;GACA,CAAC;UACM,OAAO;AACf,MAAI,EAAE,iBAAiB,+BACtB,SAAQ,MAAM,6CAA6C,eAAe,IAAI,MAAM;EAErF,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;EAC5C,MAAM,gBACL,iBAAiB,gCACd,MAAM,OACN,iCAAiC;AACrC,SAAO,qBAAqB,IAAI,MAAM;GACrC,GAAG;GACH;GACA,QAAQ;IACP,oBAAoB;IACpB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB;IACA,mCAAmB,IAAI,KAAK;IAC5B;GACD,QAAQ;GACR;GACA;GACA;GACA,CAAC;;;AAaJ,eAAe,4BACd,IACA,MACA,MACA,cACwB;CACxB,MAAM,SAAuB;EAC5B,oBAAoB;EACpB,mBAAmB;EACnB,oBAAoB;EACpB,oBAAoB;EACpB,eAAe;EACf,mCAAmB,IAAI,KAAK;EAC5B;CAED,MAAM,iBAAiB,MAAM,4BAA4B,IAAI,KAAK,gBAAgB,aAAa;CAC/F,MAAM,kBAAkB,MAAM,KAAK,YAAY,8BAA8B,MAAM,aAAa,CAAC;AAEjG,MAAK,MAAM,aAAa,KAAK,WAC5B,OAAM,oBACL,IACA,MACA,KAAK,gBACL,WACA,gBACA,iBACA,QACA,aACA;AAGF,OAAM,gCAAgC,IAAI,MAAM,KAAK,gBAAgB,QAAQ,aAAa;AAC1F,QAAO;;AAGR,eAAe,oBACd,IACA,MACA,gBACA,WACA,gBACA,iBACA,QACA,cACgB;CAChB,MAAM,aAAa,uBAAuB,gBAAgB,WAAW,aAAa;CAClF,MAAM,kBAAkB,MAAM,+BAC7B,IACA,gBACA,WACA,gBACA,eAAe;EAAE;EAAc,iBAAiB;EAAG,GAAG,OACtD;AACD,KAAI,CAAC,gBAAgB,SAAS;AAC7B,MAAI,gBAAgB,UAAU,iCAAiC,mBAAmB;AACjF,sBAAmB,OAAO;AAC1B,UAAO,kBAAkB,IAAI,UAAU;AACvC;;AAED,SAAO,gBAAgB,gBAAgB;AACvC,MAAI,gBAAgB,UAEnB,OAAM,sBAAsB,MAAM,gBAAgB,WAAW,iBAAiB,OAAO;AAEtF,MAAI,gBAAgB,QAAQ;AAS3B,QARe,MAAM,KAAK,8BACzB;IACC,GAAG,gBAAgB;IACnB,oBAAoB;IACpB,eAAe,gBAAgB;IAC/B,EACD,gBAAgB,IAAI,gBAAgB,OAAO,UAAU,IAAI,KACzD,EACU,UACV,QAAO;OAEP,oBAAmB,OAAO;AAE3B;;AAGD,SAAO;AACP;;CAGD,MAAM,qBAAqB,MAAM,sBAChC,MACA,gBAAgB,WAChB,iBACA,OACA;AAED,MAAK,MAAM,aAAa,YAAY;AACnC,MAAI,mBAAmB,IAAI,UAAU,CAAE;EACvC,MAAM,iBAAiB,gBAAgB,IAAI,UAAU;AACrD,MAAI,CAAC,eAAgB;AACrB,QAAM,qBAAqB,MAAM,WAAW,gBAAgB,OAAO;;;AAIrE,eAAe,sBACd,MACA,WACA,iBACA,QACuB;CACvB,MAAM,qCAAqB,IAAI,KAAa;AAC5C,MAAK,MAAM,YAAY,WAAW;AACjC,qBAAmB,IAAI,SAAS,OAAO,UAAU;EACjD,MAAM,SAAS,MAAM,KAAK,wBACzB,SAAS,QACT,SAAS,aACT,gBAAgB,IAAI,SAAS,OAAO,UAAU,IAAI,KAClD;AACD,MAAI,OAAO,YAAY,OAAO,UAC7B,QAAO;MAEP,oBAAmB,OAAO;;AAG5B,QAAO;;AAGR,SAAS,mBAAmB,QAA4B;AACvD,QAAO;AACP,QAAO,kBAAkB,iCAAiC;;AAG3D,eAAe,gCACd,IACA,MACA,gBACA,QACA,cACgB;CAChB,MAAM,UAAU,MAAM,KAAK,6BAA6B,gBAAgB,aAAa;CACrF,MAAM,qBAAqB,MAAM,uBAChC,IACA,gBACA,QAAQ,SAAS,WAAY,OAAO,YAAY,CAAC,OAAO,UAAU,GAAG,EAAE,CAAE,EACzE,aACA;AAED,MAAK,MAAM,UAAU,SAAS;AAC7B,MAAI,CAAC,OAAO,WAAW;AACtB,SAAM,qBAAqB,MAAM,OAAO,WAAW,QAAQ,OAAO;AAClE;;AAED,MAAI,mBAAmB,IAAI,OAAO,UAAU,CAAE;AAC9C,QAAM,oCAAoC,MAAM,gBAAgB,QAAQ,OAAO;;;AAIjF,eAAe,uBACd,IACA,gBACA,YACA,cACuB;AACvB,oBAAmB,gBAAgB,kBAAkB;CACrD,MAAM,qCAAqB,IAAI,KAAa;CAC5C,MAAM,mBAAmB,CAAC,GAAG,IAAI,IAAI,WAAW,CAAC;AACjD,KAAI,iBAAiB,WAAW,EAAG,QAAO;CAE1C,MAAM,YAAY,oBAAoB,eAAe;AACrD,MAAK,MAAM,kBAAkB,OAAO,kBAAkB,eAAe,EAAE;EACtE,MAAM,SAAS,MAAM,GAAmB;;UAEhC,IAAI,IAAI,UAAU,CAAC;0BACH,IAAI,KAAK,eAAe,CAAC;KAE/C,eACG,GAAG;;;8BAGoB,aAAa;+BACZ,eAAe;UAEvC,GAAG,GACN;IACA,QAAQ,GAAG;AACb,OAAK,MAAM,OAAO,OAAO,KACxB,oBAAmB,IAAI,IAAI,GAAG;;AAIhC,QAAO;;AAGR,eAAe,oCACd,MACA,gBACA,gBACA,QACgB;AAChB,KAAI,CAAC,eAAe,UAAW;CAC/B,MAAM,SAAS,MAAM,KAAK,oCACzB,eAAe,WACf,gBACA,gBACA,eAAe,UACf;AACD,KAAI,OAAO,SAAS;AACnB,SAAO;AACP;;AAED,KAAI,OAAO,eAAgB;AAC3B,KAAI,OAAO,OACV,oBAAmB,OAAO;;AAI5B,eAAe,qBACd,MACA,WACA,gBACA,QACgB;CAChB,MAAM,SAAS,MAAM,KAAK,uBAAuB,WAAW,eAAe;AAC3E,KAAI,OAAO,SAAS;AACnB,SAAO;AACP;;AAED,KAAI,OAAO,OACV,oBAAmB,OAAO;;AAa5B,eAAe,qBACd,IACA,MACA,OACmD;CACnD,IAAI;AACJ,KAAI,MAAM,WAAW;AACpB,MAAI,MAAM,WAAW,WACpB,OAAM,IAAI,yBAAyB,GAAG,CAAC,uBACtC,MAAM,UAAU,cAChB,MAAM,UAAU,cAChB;AAEF,WAAS,MAAM,KAAK,iCAAiC;GACpD,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,UAAU,MAAM;GAChB,cAAc,MAAM,UAAU;GAC9B,UAAU,MAAM;GAChB,eAAe,MAAM,UAAU;GAC/B,QAAQ,MAAM;GACd,eAAe;GACf,oBAAoB,MAAM,OAAO;GACjC,mBAAmB,MAAM,OAAO;GAChC,eAAe,MAAM,OAAO;GAC5B,CAAC;OAEF,UAAS,MAAM,KAAK,mCAAmC;EACtD,WAAW,MAAM;EACjB,WAAW,MAAM;EACjB,UAAU,MAAM;EAChB,UAAU,MAAM;EAChB,QAAQ,MAAM;EACd,eAAe;EACf,aAAa,MAAM;EACnB,oBAAoB,MAAM,OAAO;EACjC,mBAAmB,MAAM,OAAO;EAChC,eAAe,MAAM,OAAO;EAC5B,CAAC;AAGH,QAAO;EACN,OAAO;GACN,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,UAAU,MAAM;GAChB;EACD,QAAQ,OAAO,YAAY,MAAM,SAAS;EAC1C,oBAAoB,MAAM,OAAO;EACjC,mBAAmB,MAAM,OAAO;EAChC,oBAAoB,MAAM,OAAO;EACjC,oBAAoB,MAAM,OAAO;EACjC,eAAe,OAAO,YACnB,MAAM,OAAO,gBACZ,OAAO,QAAQ,iBACjB,iCAAiC;EACnC,WAAW,MAAM;EACjB,aAAa,OAAO,YAAa,OAAO,QAAQ,eAAe,MAAM,cAAe;EACpF;;AAGF,SAAS,sBACR,QACkD;AAClD,KAAI,OAAO,sBAAsB,KAAK,OAAO,uBAAuB,EAAG,QAAO;CAC9E,MAAM,kBAAkB,OAAO,qBAAqB,OAAO;AAC3D,KAAI,OAAO,oBAAoB,KAAK,oBAAoB,EACvD,QAAO;AAER,QAAO;;AAGR,SAAS,uBACR,gBACA,WACA,cACW;AACX,QAAO,oCAAoC,KAAK,kBAC/C,gCAAgC;EAAE;EAAc;EAAgB;EAAW;EAAe,CAAC,CAC3F;;AAGF,SAAS,8BACR,MACA,cACW;AACX,QAAO,KAAK,WAAW,SAAS,cAC/B,uBAAuB,KAAK,gBAAgB,WAAW,aAAa,CACpE;;AAGF,eAAe,sCACd,IACA,gBACoD;AAMpD,QALY,MAAM,GAChB,WAAW,sBAAsB,CACjC,OAAO,CAAC,MAAM,OAAO,CAAC,CACtB,MAAM,QAAQ,KAAK,eAAe,CAClC,kBAAkB,IACN;;AAGf,eAAe,2BAA2B,IAAwC;AAMjF,SALY,MAAM,GAChB,WAAW,iCAAiC,CAC5C,OAAO,QAAQ,CACf,MAAM,YAAY,KAAK,sBAAsB,CAC7C,kBAAkB,GACR,UAAU;;AAGvB,SAAS,eAAe,MAAyB,OAAmC;AACnF,KAAI,KAAK,WAAW,MAAM,OAAQ,QAAO;CACzC,MAAM,WAAW,IAAI,IAAI,MAAM;AAC/B,QAAO,KAAK,OAAO,OAAO,SAAS,IAAI,GAAG,CAAC;;AAG5C,SAAS,mBACR,YACA,QACW;AACX,KAAI,OAAO,kBAAkB,SAAS,EAAG,QAAO,CAAC,GAAG,WAAW;AAC/D,QAAO,WAAW,QAAQ,cAAc,CAAC,OAAO,kBAAkB,IAAI,UAAU,CAAC;;AAGlF,SAAS,iCAAiC,gBAAsD;AAC/F,QAAO;EACN,WAAW;EACX,WAAW;EACX,UAAU;EACV;;AAGF,SAAS,oBAAoB,gBAAgC;AAC5D,oBAAmB,gBAAgB,kBAAkB;AACrD,QAAO,MAAM"}
+{"version":3,"file":"content-repair-CIMt5C0U.mjs","names":[],"sources":["../src/media/usage/content-repair.ts"],"sourcesContent":["import { sql, type Kysely } from \"kysely\";\nimport { ulid } from \"ulidx\";\n\nimport { MediaUsageWorkRepository } from \"../../database/repositories/media-usage-work.js\";\nimport {\n\tMediaUsageRepository,\n\ttype MediaUsageSource,\n} from \"../../database/repositories/media-usage.js\";\nimport type { Database } from \"../../database/types.js\";\nimport { validateIdentifier } from \"../../database/validate.js\";\nimport { chunks, SQL_BATCH_SIZE } from \"../../utils/chunks.js\";\nimport {\n\tloadContentMediaUsageFields,\n\tMediaUsageFieldDiscoveryError,\n\ttype ContentMediaUsageFieldDiscovery,\n} from \"./content-fields.js\";\nimport {\n\tCONTENT_MEDIA_USAGE_ADAPTER_ID,\n\tCONTENT_MEDIA_USAGE_COLLECTION_SCOPE,\n\twithContentUsageCollectionLock,\n} from \"./content-refresh.js\";\nimport {\n\tCONTENT_SOURCE_SCHEMA_VERSION,\n\ttype ContentMediaUsageSnapshot,\n\tloadContentMediaUsageSnapshots,\n} from \"./content-snapshots.js\";\nimport {\n\tbuildContentMediaUsageSourceKey,\n\tMEDIA_USAGE_CONTENT_SOURCE_VARIANTS,\n} from \"./source-key.js\";\n\nexport type ContentMediaUsageRepairStatus = \"complete\" | \"partial\" | \"failed\" | \"stale\";\n\nexport const CONTENT_MEDIA_USAGE_REPAIR_ERROR = {\n\tCOLLECTION_NOT_FOUND: \"COLLECTION_NOT_FOUND\",\n\tCONTENT_NOT_FOUND: \"CONTENT_NOT_FOUND\",\n\tDRAFT_REVISION_NOT_FOUND: \"DRAFT_REVISION_NOT_FOUND\",\n\tDRAFT_REVISION_MISMATCH: \"DRAFT_REVISION_MISMATCH\",\n\tDRAFT_REVISION_INVALID: \"DRAFT_REVISION_INVALID\",\n\tCONTENT_USAGE_REPAIR_ERROR: \"CONTENT_USAGE_REPAIR_ERROR\",\n\tCONTENT_USAGE_REPAIR_CONFLICT: \"CONTENT_USAGE_REPAIR_CONFLICT\",\n\tINVALID_REPEATER_VALIDATION: \"INVALID_REPEATER_VALIDATION\",\n} as const;\n\nexport type ContentMediaUsageRepairErrorCode =\n\t(typeof CONTENT_MEDIA_USAGE_REPAIR_ERROR)[keyof typeof CONTENT_MEDIA_USAGE_REPAIR_ERROR];\n\nexport interface ContentMediaUsageRepairCollectionInput {\n\tcollectionSlug: string;\n}\n\nexport interface ContentMediaUsageRepairScope {\n\tadapterId: typeof CONTENT_MEDIA_USAGE_ADAPTER_ID;\n\tscopeType: typeof CONTENT_MEDIA_USAGE_COLLECTION_SCOPE;\n\tscopeKey: string;\n}\n\nexport interface ContentMediaUsageRepairCollectionResult {\n\tscope: ContentMediaUsageRepairScope;\n\tstatus: ContentMediaUsageRepairStatus;\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tlastErrorCode: string | null;\n\tstartedAt: string;\n\tcompletedAt: string | null;\n}\n\nexport interface ContentMediaUsageRepairAllResult {\n\tstatus: ContentMediaUsageRepairStatus;\n\tcollections: ContentMediaUsageRepairCollectionResult[];\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n}\n\nexport interface ContentMediaUsageCollectionScan {\n\tcollectionSlug: string;\n\tcontentIds: string[];\n}\n\ninterface ContentMediaUsageCollectionRecord {\n\tid: string;\n\tslug: string;\n}\n\ninterface ContentMediaUsageInitialCollectionResult {\n\tcollection: ContentMediaUsageCollectionRecord;\n\tresult: ContentMediaUsageRepairCollectionResult;\n}\n\ninterface ContentMediaUsageRepairExecution {\n\tcollectionId: string;\n\tstartingEpoch: number | string;\n}\n\nexport async function repairContentMediaUsageAll(\n\tdb: Kysely<Database>,\n): Promise<ContentMediaUsageRepairAllResult> {\n\tconst collections = await loadContentMediaUsageCollectionRecords(db);\n\tconst results: ContentMediaUsageInitialCollectionResult[] = [];\n\n\tfor (const collection of collections) {\n\t\tresults.push({\n\t\t\tcollection,\n\t\t\tresult: await repairContentMediaUsageCollectionSafely(db, collection),\n\t\t});\n\t}\n\n\treturn aggregateContentMediaUsageRepairAll(\n\t\tawait filterExistingContentMediaUsageCollectionResults(db, results),\n\t);\n}\n\nexport async function scanContentMediaUsageCollection(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n\texpectedCollectionId?: string,\n): Promise<ContentMediaUsageCollectionScan | null> {\n\tvalidateIdentifier(collectionSlug, \"collection slug\");\n\tlet collectionQuery = db\n\t\t.selectFrom(\"_emdash_collections\")\n\t\t.select(\"id\")\n\t\t.where(\"slug\", \"=\", collectionSlug);\n\tif (expectedCollectionId !== undefined) {\n\t\tcollectionQuery = collectionQuery.where(\"id\", \"=\", expectedCollectionId);\n\t}\n\tconst collection = await collectionQuery.executeTakeFirst();\n\tif (!collection) return null;\n\n\tconst tableName = getContentTableName(collectionSlug);\n\tconst rows = await sql<{ id: string }>`\n\t\tSELECT content.id\n\t\tFROM ${sql.ref(tableName)} AS content\n\t\tWHERE EXISTS (\n\t\t\tSELECT 1\n\t\t\tFROM _emdash_collections AS collection\n\t\t\tWHERE collection.id = ${collection.id}\n\t\t\t\tAND collection.slug = ${collectionSlug}\n\t\t)\n\t\tORDER BY content.id ASC\n\t`.execute(db);\n\n\treturn {\n\t\tcollectionSlug,\n\t\tcontentIds: rows.rows.map((row) => row.id),\n\t};\n}\n\nexport async function repairContentMediaUsageCollection(\n\tdb: Kysely<Database>,\n\tinput: ContentMediaUsageRepairCollectionInput,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\tvalidateIdentifier(input.collectionSlug, \"collection slug\");\n\treturn withContentUsageCollectionLock(input.collectionSlug, () =>\n\t\trepairContentMediaUsageCollectionUnlocked(db, input.collectionSlug),\n\t);\n}\n\nasync function loadContentMediaUsageCollectionRecords(\n\tdb: Kysely<Database>,\n): Promise<ContentMediaUsageCollectionRecord[]> {\n\treturn db\n\t\t.selectFrom(\"_emdash_collections\")\n\t\t.select([\"id\", \"slug\"])\n\t\t.orderBy(\"slug\", \"asc\")\n\t\t.execute();\n}\n\nasync function repairContentMediaUsageCollectionSafely(\n\tdb: Kysely<Database>,\n\tcollection: ContentMediaUsageCollectionRecord,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\ttry {\n\t\treturn await withContentUsageCollectionLock(collection.slug, () =>\n\t\t\trepairContentMediaUsageCollectionUnlocked(db, collection.slug, collection.id),\n\t\t);\n\t} catch (error) {\n\t\tconsole.error(`[media-usage] Failed to repair collection ${collection.slug}:`, error);\n\t\tconst now = new Date().toISOString();\n\t\treturn {\n\t\t\tscope: contentMediaUsageCollectionScope(collection.slug),\n\t\t\tstatus: \"failed\",\n\t\t\tindexedSourceCount: 0,\n\t\t\tfailedSourceCount: 0,\n\t\t\tskippedSourceCount: 0,\n\t\t\tdeletedSourceCount: 0,\n\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_ERROR,\n\t\t\tstartedAt: now,\n\t\t\tcompletedAt: now,\n\t\t};\n\t}\n}\n\nasync function filterExistingContentMediaUsageCollectionResults(\n\tdb: Kysely<Database>,\n\tresults: readonly ContentMediaUsageInitialCollectionResult[],\n): Promise<ContentMediaUsageRepairCollectionResult[]> {\n\tconst identityBound = await isIncrementalCaptureActive(db);\n\tconst currentCollections = await loadContentMediaUsageCollectionRecordsSafely(db);\n\tconst currentIdsBySlug = new Map(\n\t\tcurrentCollections.map((collection) => [collection.slug, collection.id]),\n\t);\n\tconst includedResults: ContentMediaUsageRepairCollectionResult[] = [];\n\tconst excludedResults: ContentMediaUsageInitialCollectionResult[] = [];\n\n\tfor (const { collection, result } of results) {\n\t\tif (currentIdsBySlug.get(collection.slug) === collection.id) {\n\t\t\tincludedResults.push(result);\n\t\t} else {\n\t\t\texcludedResults.push({ collection, result });\n\t\t}\n\t}\n\n\tif (excludedResults.length > 0) {\n\t\tconst repo = new MediaUsageRepository(db);\n\t\tfor (const excluded of excludedResults) {\n\t\t\tawait repo.deleteIndexStatus(\n\t\t\t\texcluded.result.scope,\n\t\t\t\tidentityBound ? excluded.collection.id : undefined,\n\t\t\t);\n\t\t}\n\t}\n\n\treturn includedResults;\n}\n\nasync function loadContentMediaUsageCollectionRecordsSafely(\n\tdb: Kysely<Database>,\n): Promise<ContentMediaUsageCollectionRecord[]> {\n\ttry {\n\t\treturn await loadContentMediaUsageCollectionRecords(db);\n\t} catch {\n\t\t// Retry once before failing; returning unpruned results can over-report deleted collections.\n\t}\n\n\ttry {\n\t\treturn await loadContentMediaUsageCollectionRecords(db);\n\t} catch (error) {\n\t\tconsole.error(\"[media-usage] Failed to reconcile all-content repair collections:\", error);\n\t\tthrow error;\n\t}\n}\n\nfunction aggregateContentMediaUsageRepairAll(\n\tcollections: readonly ContentMediaUsageRepairCollectionResult[],\n): ContentMediaUsageRepairAllResult {\n\treturn {\n\t\tstatus: determineRepairAllStatus(collections),\n\t\tcollections: [...collections],\n\t\tindexedSourceCount: sumCollectionRepairCount(collections, \"indexedSourceCount\"),\n\t\tfailedSourceCount: sumCollectionRepairCount(collections, \"failedSourceCount\"),\n\t\tskippedSourceCount: sumCollectionRepairCount(collections, \"skippedSourceCount\"),\n\t\tdeletedSourceCount: sumCollectionRepairCount(collections, \"deletedSourceCount\"),\n\t};\n}\n\nfunction determineRepairAllStatus(\n\tcollections: readonly ContentMediaUsageRepairCollectionResult[],\n): ContentMediaUsageRepairStatus {\n\tif (collections.length === 0) return \"complete\";\n\tif (collections.every((collection) => collection.status === \"complete\")) return \"complete\";\n\tif (collections.some((collection) => collection.status === \"stale\")) return \"stale\";\n\tif (collections.some((collection) => collection.status === \"partial\")) return \"partial\";\n\tif (collections.every((collection) => collection.status === \"failed\")) return \"failed\";\n\treturn \"partial\";\n}\n\nfunction sumCollectionRepairCount(\n\tcollections: readonly ContentMediaUsageRepairCollectionResult[],\n\tkey: \"indexedSourceCount\" | \"failedSourceCount\" | \"skippedSourceCount\" | \"deletedSourceCount\",\n): number {\n\treturn collections.reduce((sum, collection) => sum + collection[key], 0);\n}\n\nasync function repairContentMediaUsageCollectionUnlocked(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n\texpectedCollectionId?: string,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\tconst requestedAt = new Date().toISOString();\n\tconst scope = contentMediaUsageCollectionScope(collectionSlug);\n\tconst identityBound = await isIncrementalCaptureActive(db);\n\tconst collection = await loadContentMediaUsageCollectionRecord(db, collectionSlug);\n\tif (\n\t\t!collection ||\n\t\t(identityBound && expectedCollectionId && collection.id !== expectedCollectionId)\n\t) {\n\t\treturn {\n\t\t\tscope,\n\t\t\tstatus: \"failed\",\n\t\t\tindexedSourceCount: 0,\n\t\t\tfailedSourceCount: 0,\n\t\t\tskippedSourceCount: 0,\n\t\t\tdeletedSourceCount: 0,\n\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.COLLECTION_NOT_FOUND,\n\t\t\tstartedAt: requestedAt,\n\t\t\tcompletedAt: requestedAt,\n\t\t};\n\t}\n\n\tconst repo = new MediaUsageRepository(db);\n\tconst runToken = ulid();\n\tlet startedAt = requestedAt;\n\tlet execution: ContentMediaUsageRepairExecution | undefined;\n\tif (identityBound) {\n\t\tconst run = await repo.beginIndexStatusRepairAtCurrentEpoch({\n\t\t\t...scope,\n\t\t\tcollectionId: collection.id,\n\t\t\trunToken,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t});\n\t\tif (!run) {\n\t\t\treturn {\n\t\t\t\tscope,\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tindexedSourceCount: 0,\n\t\t\t\tfailedSourceCount: 0,\n\t\t\t\tskippedSourceCount: 0,\n\t\t\t\tdeletedSourceCount: 0,\n\t\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_ERROR,\n\t\t\t\tstartedAt,\n\t\t\t\tcompletedAt: requestedAt,\n\t\t\t};\n\t\t}\n\t\tstartedAt = run.startedAt;\n\t\texecution = { collectionId: collection.id, startingEpoch: run.changeEpoch };\n\t} else {\n\t\tawait repo.beginIndexStatusRepair({\n\t\t\t...scope,\n\t\t\trunToken,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t\tstartedAt,\n\t\t});\n\t}\n\n\ttry {\n\t\tconst scan = await scanContentMediaUsageCollection(db, collectionSlug, execution?.collectionId);\n\t\tif (!scan) {\n\t\t\tconst completedAt = new Date().toISOString();\n\t\t\treturn await finalizeRepairStatus(db, repo, {\n\t\t\t\t...scope,\n\t\t\t\trunToken,\n\t\t\t\tcounts: {\n\t\t\t\t\tindexedSourceCount: 0,\n\t\t\t\t\tfailedSourceCount: 0,\n\t\t\t\t\tskippedSourceCount: 0,\n\t\t\t\t\tdeletedSourceCount: 0,\n\t\t\t\t\tlastErrorCode: CONTENT_MEDIA_USAGE_REPAIR_ERROR.COLLECTION_NOT_FOUND,\n\t\t\t\t\tmissingContentIds: new Set(),\n\t\t\t\t},\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tstartedAt,\n\t\t\t\tcompletedAt,\n\t\t\t\texecution,\n\t\t\t});\n\t\t}\n\t\tconst counts = await repairScannedContentSources(db, repo, scan, execution?.collectionId);\n\t\tconst finalScan = await scanContentMediaUsageCollection(\n\t\t\tdb,\n\t\t\tcollectionSlug,\n\t\t\texecution?.collectionId,\n\t\t);\n\t\tif (!finalScan) {\n\t\t\tcounts.failedSourceCount++;\n\t\t\tcounts.lastErrorCode = CONTENT_MEDIA_USAGE_REPAIR_ERROR.COLLECTION_NOT_FOUND;\n\t\t} else if (!sameContentIds(repairedContentIds(scan.contentIds, counts), finalScan.contentIds)) {\n\t\t\tmarkRepairConflict(counts);\n\t\t}\n\t\tconst completedAt = new Date().toISOString();\n\t\tconst status = determineRepairStatus(counts);\n\t\treturn await finalizeRepairStatus(db, repo, {\n\t\t\t...scope,\n\t\t\trunToken,\n\t\t\tcounts,\n\t\t\tstatus,\n\t\t\tstartedAt,\n\t\t\tcompletedAt,\n\t\t\texecution,\n\t\t});\n\t} catch (error) {\n\t\tif (!(error instanceof MediaUsageFieldDiscoveryError)) {\n\t\t\tconsole.error(`[media-usage] Failed to repair collection ${collectionSlug}:`, error);\n\t\t}\n\t\tconst completedAt = new Date().toISOString();\n\t\tconst lastErrorCode =\n\t\t\terror instanceof MediaUsageFieldDiscoveryError\n\t\t\t\t? error.code\n\t\t\t\t: CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_ERROR;\n\t\treturn finalizeRepairStatus(db, repo, {\n\t\t\t...scope,\n\t\t\trunToken,\n\t\t\tcounts: {\n\t\t\t\tindexedSourceCount: 0,\n\t\t\t\tfailedSourceCount: 0,\n\t\t\t\tskippedSourceCount: 0,\n\t\t\t\tdeletedSourceCount: 0,\n\t\t\t\tlastErrorCode,\n\t\t\t\tmissingContentIds: new Set(),\n\t\t\t},\n\t\t\tstatus: \"failed\",\n\t\t\tstartedAt,\n\t\t\tcompletedAt,\n\t\t\texecution,\n\t\t});\n\t}\n}\n\ninterface RepairCounts {\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tlastErrorCode: ContentMediaUsageRepairErrorCode | null;\n\tmissingContentIds: Set<string>;\n}\n\nasync function repairScannedContentSources(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tscan: ContentMediaUsageCollectionScan,\n\tcollectionId?: string,\n): Promise<RepairCounts> {\n\tconst counts: RepairCounts = {\n\t\tindexedSourceCount: 0,\n\t\tfailedSourceCount: 0,\n\t\tskippedSourceCount: 0,\n\t\tdeletedSourceCount: 0,\n\t\tlastErrorCode: null,\n\t\tmissingContentIds: new Set(),\n\t};\n\n\tconst fieldDiscovery = await loadContentMediaUsageFields(db, scan.collectionSlug, collectionId);\n\tconst observedSources = await repo.findSources(buildContentSourceKeysForScan(scan, collectionId));\n\n\tfor (const contentId of scan.contentIds) {\n\t\tawait repairContentSource(\n\t\t\tdb,\n\t\t\trepo,\n\t\t\tscan.collectionSlug,\n\t\t\tcontentId,\n\t\t\tfieldDiscovery,\n\t\t\tobservedSources,\n\t\t\tcounts,\n\t\t\tcollectionId,\n\t\t);\n\t}\n\n\tawait reconcileOrphanedContentSources(db, repo, scan.collectionSlug, counts, collectionId);\n\treturn counts;\n}\n\nasync function repairContentSource(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tcollectionSlug: string,\n\tcontentId: string,\n\tfieldDiscovery: ContentMediaUsageFieldDiscovery,\n\tobservedSources: Map<string, MediaUsageSource>,\n\tcounts: RepairCounts,\n\tcollectionId?: string,\n): Promise<void> {\n\tconst sourceKeys = buildContentSourceKeys(collectionSlug, contentId, collectionId);\n\tconst snapshotsResult = await loadContentMediaUsageSnapshots(\n\t\tdb,\n\t\tcollectionSlug,\n\t\tcontentId,\n\t\tfieldDiscovery,\n\t\tcollectionId ? { collectionId, identityVersion: 1 } : undefined,\n\t);\n\tif (!snapshotsResult.success) {\n\t\tif (snapshotsResult.error === CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_NOT_FOUND) {\n\t\t\tmarkRepairConflict(counts);\n\t\t\tcounts.missingContentIds.add(contentId);\n\t\t\treturn;\n\t\t}\n\t\tcounts.lastErrorCode = snapshotsResult.error;\n\t\tif (snapshotsResult.snapshots) {\n\t\t\t// Partial snapshot failures keep absent variants in place; the attempted source is marked below.\n\t\t\tawait repairSnapshotSources(repo, snapshotsResult.snapshots, observedSources, counts);\n\t\t}\n\t\tif (snapshotsResult.source) {\n\t\t\tconst result = await repo.markSourceAttemptedIfMatching(\n\t\t\t\t{\n\t\t\t\t\t...snapshotsResult.source,\n\t\t\t\t\tsourceCompleteness: \"failed\",\n\t\t\t\t\tlastErrorCode: snapshotsResult.error,\n\t\t\t\t},\n\t\t\t\tobservedSources.get(snapshotsResult.source.sourceKey) ?? null,\n\t\t\t);\n\t\t\tif (result.attempted) {\n\t\t\t\tcounts.failedSourceCount++;\n\t\t\t} else {\n\t\t\t\tmarkRepairConflict(counts);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tcounts.failedSourceCount++;\n\t\treturn;\n\t}\n\n\tconst expectedSourceKeys = await repairSnapshotSources(\n\t\trepo,\n\t\tsnapshotsResult.snapshots,\n\t\tobservedSources,\n\t\tcounts,\n\t);\n\n\tfor (const sourceKey of sourceKeys) {\n\t\tif (expectedSourceKeys.has(sourceKey)) continue;\n\t\tconst observedSource = observedSources.get(sourceKey);\n\t\tif (!observedSource) continue;\n\t\tawait deleteObservedSource(repo, sourceKey, observedSource, counts);\n\t}\n}\n\nasync function repairSnapshotSources(\n\trepo: MediaUsageRepository,\n\tsnapshots: readonly ContentMediaUsageSnapshot[],\n\tobservedSources: Map<string, MediaUsageSource>,\n\tcounts: RepairCounts,\n): Promise<Set<string>> {\n\tconst expectedSourceKeys = new Set<string>();\n\tfor (const snapshot of snapshots) {\n\t\texpectedSourceKeys.add(snapshot.source.sourceKey);\n\t\tconst result = await repo.replaceSourceIfMatching(\n\t\t\tsnapshot.source,\n\t\t\tsnapshot.occurrences,\n\t\t\tobservedSources.get(snapshot.source.sourceKey) ?? null,\n\t\t);\n\t\tif (result.replaced || result.unchanged) {\n\t\t\tcounts.indexedSourceCount++;\n\t\t} else {\n\t\t\tmarkRepairConflict(counts);\n\t\t}\n\t}\n\treturn expectedSourceKeys;\n}\n\nfunction markRepairConflict(counts: RepairCounts): void {\n\tcounts.skippedSourceCount++;\n\tcounts.lastErrorCode ??= CONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_CONFLICT;\n}\n\nasync function reconcileOrphanedContentSources(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tcollectionSlug: string,\n\tcounts: RepairCounts,\n\tcollectionId?: string,\n): Promise<void> {\n\tconst sources = await repo.findCollectionContentSources(collectionSlug, collectionId);\n\tconst existingContentIds = await findExistingContentIds(\n\t\tdb,\n\t\tcollectionSlug,\n\t\tsources.flatMap((source) => (source.contentId ? [source.contentId] : [])),\n\t\tcollectionId,\n\t);\n\n\tfor (const source of sources) {\n\t\tif (!source.contentId) {\n\t\t\tawait deleteObservedSource(repo, source.sourceKey, source, counts);\n\t\t\tcontinue;\n\t\t}\n\t\tif (existingContentIds.has(source.contentId)) continue;\n\t\tawait deleteObservedSourceIfContentAbsent(repo, collectionSlug, source, counts);\n\t}\n}\n\nasync function findExistingContentIds(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n\tcontentIds: readonly string[],\n\tcollectionId?: string,\n): Promise<Set<string>> {\n\tvalidateIdentifier(collectionSlug, \"collection slug\");\n\tconst existingContentIds = new Set<string>();\n\tconst uniqueContentIds = [...new Set(contentIds)];\n\tif (uniqueContentIds.length === 0) return existingContentIds;\n\n\tconst tableName = getContentTableName(collectionSlug);\n\tfor (const contentIdBatch of chunks(uniqueContentIds, SQL_BATCH_SIZE)) {\n\t\tconst result = await sql<{ id: string }>`\n\t\t\tSELECT content.id\n\t\t\tFROM ${sql.ref(tableName)} AS content\n\t\t\tWHERE content.id IN (${sql.join(contentIdBatch)})\n\t\t\t${\n\t\t\t\tcollectionId\n\t\t\t\t\t? sql`AND EXISTS (\n\t\t\t\t\t\tSELECT 1\n\t\t\t\t\t\tFROM _emdash_collections AS collection\n\t\t\t\t\t\tWHERE collection.id = ${collectionId}\n\t\t\t\t\t\t\tAND collection.slug = ${collectionSlug}\n\t\t\t\t\t)`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t`.execute(db);\n\t\tfor (const row of result.rows) {\n\t\t\texistingContentIds.add(row.id);\n\t\t}\n\t}\n\n\treturn existingContentIds;\n}\n\nasync function deleteObservedSourceIfContentAbsent(\n\trepo: MediaUsageRepository,\n\tcollectionSlug: string,\n\tobservedSource: MediaUsageSource,\n\tcounts: RepairCounts,\n): Promise<void> {\n\tif (!observedSource.contentId) return;\n\tconst result = await repo.deleteSourceIfMatchingContentAbsent(\n\t\tobservedSource.sourceKey,\n\t\tobservedSource,\n\t\tcollectionSlug,\n\t\tobservedSource.contentId,\n\t);\n\tif (result.deleted) {\n\t\tcounts.deletedSourceCount++;\n\t\treturn;\n\t}\n\tif (result.contentPresent) return;\n\tif (result.source) {\n\t\tmarkRepairConflict(counts);\n\t}\n}\n\nasync function deleteObservedSource(\n\trepo: MediaUsageRepository,\n\tsourceKey: string,\n\tobservedSource: MediaUsageSource,\n\tcounts: RepairCounts,\n): Promise<void> {\n\tconst result = await repo.deleteSourceIfMatching(sourceKey, observedSource);\n\tif (result.deleted) {\n\t\tcounts.deletedSourceCount++;\n\t\treturn;\n\t}\n\tif (result.source) {\n\t\tmarkRepairConflict(counts);\n\t}\n}\n\ninterface FinalizeInput extends ContentMediaUsageRepairScope {\n\trunToken: string;\n\tcounts: RepairCounts;\n\tstatus: Exclude<ContentMediaUsageRepairStatus, \"stale\">;\n\tstartedAt: string;\n\tcompletedAt: string;\n\texecution?: ContentMediaUsageRepairExecution;\n}\n\nasync function finalizeRepairStatus(\n\tdb: Kysely<Database>,\n\trepo: MediaUsageRepository,\n\tinput: FinalizeInput,\n): Promise<ContentMediaUsageRepairCollectionResult> {\n\tlet result;\n\tif (input.execution) {\n\t\tif (input.status === \"complete\") {\n\t\t\tawait new MediaUsageWorkRepository(db).deleteWorkThroughEpoch(\n\t\t\t\tinput.execution.collectionId,\n\t\t\t\tinput.execution.startingEpoch,\n\t\t\t);\n\t\t}\n\t\tresult = await repo.finalizeIndexStatusRepairAtEpoch({\n\t\t\tadapterId: input.adapterId,\n\t\t\tscopeType: input.scopeType,\n\t\t\tscopeKey: input.scopeKey,\n\t\t\tcollectionId: input.execution.collectionId,\n\t\t\trunToken: input.runToken,\n\t\t\tstartingEpoch: input.execution.startingEpoch,\n\t\t\tstatus: input.status,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t\tindexedSourceCount: input.counts.indexedSourceCount,\n\t\t\tfailedSourceCount: input.counts.failedSourceCount,\n\t\t\tlastErrorCode: input.counts.lastErrorCode,\n\t\t});\n\t} else {\n\t\tresult = await repo.finalizeIndexStatusRepairIfRunning({\n\t\t\tadapterId: input.adapterId,\n\t\t\tscopeType: input.scopeType,\n\t\t\tscopeKey: input.scopeKey,\n\t\t\trunToken: input.runToken,\n\t\t\tstatus: input.status,\n\t\t\tschemaVersion: CONTENT_SOURCE_SCHEMA_VERSION,\n\t\t\tcompletedAt: input.completedAt,\n\t\t\tindexedSourceCount: input.counts.indexedSourceCount,\n\t\t\tfailedSourceCount: input.counts.failedSourceCount,\n\t\t\tlastErrorCode: input.counts.lastErrorCode,\n\t\t});\n\t}\n\n\treturn {\n\t\tscope: {\n\t\t\tadapterId: input.adapterId,\n\t\t\tscopeType: input.scopeType,\n\t\t\tscopeKey: input.scopeKey,\n\t\t},\n\t\tstatus: result.finalized ? input.status : \"stale\",\n\t\tindexedSourceCount: input.counts.indexedSourceCount,\n\t\tfailedSourceCount: input.counts.failedSourceCount,\n\t\tskippedSourceCount: input.counts.skippedSourceCount,\n\t\tdeletedSourceCount: input.counts.deletedSourceCount,\n\t\tlastErrorCode: result.finalized\n\t\t\t? input.counts.lastErrorCode\n\t\t\t: (result.status?.lastErrorCode ??\n\t\t\t\tCONTENT_MEDIA_USAGE_REPAIR_ERROR.CONTENT_USAGE_REPAIR_CONFLICT),\n\t\tstartedAt: input.startedAt,\n\t\tcompletedAt: result.finalized ? (result.status?.completedAt ?? input.completedAt) : null,\n\t};\n}\n\nfunction determineRepairStatus(\n\tcounts: RepairCounts,\n): Exclude<ContentMediaUsageRepairStatus, \"stale\"> {\n\tif (counts.failedSourceCount === 0 && counts.skippedSourceCount === 0) return \"complete\";\n\tconst trustedProgress = counts.indexedSourceCount + counts.deletedSourceCount;\n\tif (counts.failedSourceCount > 0 && trustedProgress === 0) {\n\t\treturn \"failed\";\n\t}\n\treturn \"partial\";\n}\n\nfunction buildContentSourceKeys(\n\tcollectionSlug: string,\n\tcontentId: string,\n\tcollectionId?: string,\n): string[] {\n\treturn MEDIA_USAGE_CONTENT_SOURCE_VARIANTS.map((sourceVariant) =>\n\t\tbuildContentMediaUsageSourceKey({ collectionId, collectionSlug, contentId, sourceVariant }),\n\t);\n}\n\nfunction buildContentSourceKeysForScan(\n\tscan: ContentMediaUsageCollectionScan,\n\tcollectionId?: string,\n): string[] {\n\treturn scan.contentIds.flatMap((contentId) =>\n\t\tbuildContentSourceKeys(scan.collectionSlug, contentId, collectionId),\n\t);\n}\n\nasync function loadContentMediaUsageCollectionRecord(\n\tdb: Kysely<Database>,\n\tcollectionSlug: string,\n): Promise<ContentMediaUsageCollectionRecord | null> {\n\tconst row = await db\n\t\t.selectFrom(\"_emdash_collections\")\n\t\t.select([\"id\", \"slug\"])\n\t\t.where(\"slug\", \"=\", collectionSlug)\n\t\t.executeTakeFirst();\n\treturn row ?? null;\n}\n\nasync function isIncrementalCaptureActive(db: Kysely<Database>): Promise<boolean> {\n\tconst row = await db\n\t\t.selectFrom(\"_emdash_media_usage_activation\")\n\t\t.select(\"state\")\n\t\t.where(\"task_key\", \"=\", \"incremental_capture\")\n\t\t.executeTakeFirst();\n\treturn row?.state === \"active\";\n}\n\nfunction sameContentIds(left: readonly string[], right: readonly string[]): boolean {\n\tif (left.length !== right.length) return false;\n\tconst rightIds = new Set(right);\n\treturn left.every((id) => rightIds.has(id));\n}\n\nfunction repairedContentIds(\n\tcontentIds: readonly string[],\n\tcounts: Pick<RepairCounts, \"missingContentIds\">,\n): string[] {\n\tif (counts.missingContentIds.size === 0) return [...contentIds];\n\treturn contentIds.filter((contentId) => !counts.missingContentIds.has(contentId));\n}\n\nfunction contentMediaUsageCollectionScope(collectionSlug: string): ContentMediaUsageRepairScope {\n\treturn {\n\t\tadapterId: CONTENT_MEDIA_USAGE_ADAPTER_ID,\n\t\tscopeType: CONTENT_MEDIA_USAGE_COLLECTION_SCOPE,\n\t\tscopeKey: collectionSlug,\n\t};\n}\n\nfunction getContentTableName(collectionSlug: string): string {\n\tvalidateIdentifier(collectionSlug, \"collection slug\");\n\treturn `ec_${collectionSlug}`;\n}\n"],"mappings":"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"}

package/dist/{context-CX6gxOLW.mjs → context-C9PB8vGd.mjs}

@@ -1,18 +1,20 @@
-import { d as pluginDataExtractExpr, f as pluginDataOrderExpr } from "./dialect-helpers-BSbfaO3F.mjs";
+import { n as validateJsonFieldName } from "./validate-BpwoDOgt.mjs";
+import { f as pluginDataExtractExpr, h as pluginDataWriteExpr, m as pluginDataUpdateGuard, p as pluginDataOrderExpr } from "./dialect-helpers-BcQvkHgn.mjs";
 import { o as resolveContentCreateLocale } from "./config-C3EBstHi.mjs";
-import { t as ContentRepository } from "./content-DjvM0T92.mjs";
+import { t as ContentRepository } from "./content-CNfMWuhY.mjs";
 import { o as decodeCursor, s as encodeCursor } from "./types-CQPWhPxE.mjs";
 import { t as MediaRepository } from "./media-BBm8Wg3f.mjs";
-import { t as UserRepository } from "./user-BTZ40aq6.mjs";
+import { t as UserRepository } from "./user-DIsIXogT.mjs";
 import { t as withTransaction } from "./transaction-0KOpOyMu.mjs";
-import { t as TaxonomyRepository } from "./taxonomy-tJepplLL.mjs";
-import { t as OptionsRepository } from "./options-BHPeIbBd.mjs";
-import { t as enrichImageMetadata } from "./enrich-BX0IDp4z.mjs";
-import { t as SeoRepository } from "./seo-926NRIgt.mjs";
-import { l as markContentMediaUsageCollectionStaleSafely } from "./content-refresh-Bwp-8yGy.mjs";
-import { s as invalidateSiteSettingsCache } from "./settings--wobrkkC.mjs";
-import { o as stripCredentialHeaders, r as resolveAndValidateExternalUrl, t as SsrfError } from "./ssrf-5sIM5jzl.mjs";
-import { t as CronAccessImpl } from "./cron-C6o7VppJ.mjs";
+import { t as TaxonomyRepository } from "./taxonomy-DP1vny4K.mjs";
+import { i as serializeConditionalValue, n as assertStorageKey, r as assertStorageRevision, t as OptionsRepository } from "./options-D1FBiAv1.mjs";
+import { t as enrichImageMetadata } from "./enrich-t2Xvjdqa.mjs";
+import { t as EntryLockRepository } from "./entry-locks-BEcX7ET0.mjs";
+import { t as SeoRepository } from "./seo-Bw68KxRc.mjs";
+import { l as markContentMediaUsageCollectionStaleSafely } from "./content-refresh-GTMyi2Xy.mjs";
+import { s as invalidateSiteSettingsCache } from "./settings-DcMjREe5.mjs";
+import { o as stripCredentialHeaders, r as resolveAndValidateExternalUrl, t as SsrfError } from "./ssrf-gl4gFNhw.mjs";
+import { t as CronAccessImpl } from "./cron-DHAy9oyq.mjs";
 import { sql } from "kysely";
 import { ulid } from "ulidx";
 
@@ -29,6 +31,36 @@ var StorageQueryError = class extends Error {
 	}
 };
 /**
+* Error thrown when a guarded `updateIf` loses a concurrent race by aborting
+* rather than resolving to `{ applied: false }`.
+*
+* `updateIf`'s `{ applied: false }` contract (row absent OR guard failed)
+* assumes READ COMMITTED — the default. There, a losing concurrent writer
+* re-evaluates the guard against the winner's freshly committed row and
+* cleanly resolves to `{ applied: false }`. Two aborts escape that contract:
+*
+* - `40001` (serialization_failure), only above READ COMMITTED, where the
+*   loser cannot re-read against a newer snapshot.
+* - `40P01` (deadlock_detected), at any isolation level, when transactions
+*   take row locks in opposite order.
+*
+* This error surfaces either abort so the caller can retry the write.
+*
+* The no-oversell SAFETY invariant holds either way: a losing writer NEVER
+* applies its update — it either sees `{ applied: false }` or throws here.
+*/
+var StorageSerializationError = class extends Error {
+	code = "STORAGE_SERIALIZATION_FAILURE";
+	retryable = true;
+	/** The Postgres SQLSTATE that triggered this error (`40001` / `40P01`). */
+	sqlState;
+	constructor(message, options) {
+		super(message, { cause: options?.cause });
+		this.name = "StorageSerializationError";
+		this.sqlState = options?.sqlState;
+	}
+};
+/**
 * Check if a value is a range filter
 */
 function isRangeFilter(value) {
@@ -145,6 +177,7 @@ function buildCondition(db, field, value) {
 		if (value.gte !== void 0) pushBound(">=", value.gte);
 		if (value.lt !== void 0) pushBound("<", value.lt);
 		if (value.lte !== void 0) pushBound("<=", value.lte);
+		if (conditions.length === 0) throw new StorageQueryError(`Range filter for field '${field}' has no defined bound`, field, "Provide at least one of gt, gte, lt, or lte, or omit the field.");
 		return {
 			sql: conditions.join(" AND "),
 			params
@@ -160,6 +193,7 @@ function buildWhereClause(db, where) {
 	const params = [];
 	for (const [field, value] of Object.entries(where)) {
 		const condition = buildCondition(db, field, value);
+		if (!condition.sql) continue;
 		conditions.push(condition.sql);
 		params.push(...condition.params);
 	}
@@ -173,9 +207,113 @@ function buildWhereClause(db, where) {
 	};
 }
 
+//#endregion
+//#region src/plugins/storage-update.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireRecord(value, label) {
+	if (!isRecord(value)) throw new TypeError(`${label} must be an object`);
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== Object.prototype && prototype !== null) throw new TypeError(`${label} must be a plain object`);
+	return value;
+}
+function operand(value) {
+	if (typeof value === "string" || typeof value === "number" && Number.isFinite(value)) return value;
+	throw new TypeError("Storage guard operands must be strings or finite numbers");
+}
+function normalizeFilter(value) {
+	if (value === null || typeof value === "boolean") return value;
+	if (typeof value === "string" || typeof value === "number") return operand(value);
+	const filter = requireRecord(value, "Storage guard filter");
+	const values = filter.in;
+	if (Array.isArray(values)) return { in: Array.from(values, operand) };
+	const prefix = filter.startsWith;
+	if (typeof prefix === "string") return { startsWith: prefix };
+	const range = {};
+	for (const key of [
+		"gt",
+		"gte",
+		"lt",
+		"lte"
+	]) if (key in filter) {
+		const bound = filter[key];
+		range[key] = bound === void 0 ? void 0 : operand(bound);
+	}
+	return range;
+}
+function parseStorageUpdate(value) {
+	const args = requireRecord(value, "Storage update arguments");
+	if (Object.keys(args).some((key) => key !== "where" && key !== "set" && key !== "delta")) throw new TypeError("Unknown storage update argument");
+	const where = {};
+	for (const [field, filter] of Object.entries(requireRecord(args.where, "Storage where guard"))) {
+		validateJsonFieldName(field);
+		where[field] = normalizeFilter(filter);
+	}
+	const set = args.set === void 0 ? {} : requireRecord(args.set, "Storage set");
+	const delta = args.delta === void 0 ? {} : requireRecord(args.delta, "Storage delta");
+	const setEntries = [];
+	for (const [field, entry] of Object.entries(set)) {
+		if (entry === void 0) continue;
+		validateJsonFieldName(field);
+		const serialized = JSON.stringify(entry);
+		if (serialized === void 0) throw new TypeError("Storage set values must be JSON serializable");
+		const normalized = JSON.parse(serialized);
+		setEntries.push([field, normalized]);
+	}
+	const setFields = new Set(setEntries.map(([field]) => field));
+	const deltaEntries = [];
+	for (const [field, entry] of Object.entries(delta)) {
+		if (entry === void 0) continue;
+		validateJsonFieldName(field);
+		if (setFields.has(field)) throw new TypeError("Storage field appears in both set and delta");
+		const spec = requireRecord(entry, "Storage numeric delta");
+		const keys = Object.keys(spec);
+		const key = keys[0];
+		if (keys.length !== 1 || key !== "inc" && key !== "dec") throw new TypeError("Storage delta must contain exactly one of inc or dec");
+		const amount = spec[key];
+		if (typeof amount !== "number" || !Number.isSafeInteger(amount)) throw new TypeError("Storage delta must be a safe integer");
+		deltaEntries.push([field, key === "dec" ? -amount : amount]);
+	}
+	if (setEntries.length + deltaEntries.length === 0) throw new TypeError("Storage update requires at least one of set or delta");
+	return {
+		where,
+		setEntries,
+		deltaEntries
+	};
+}
+
 //#endregion
 //#region src/database/repositories/plugin-storage.ts
 /**
+* SQLSTATEs a losing concurrent `updateIf` writer can abort with.
+*
+* `40001` (serialization_failure) is raised only above READ COMMITTED, where
+* the loser cannot re-evaluate its guard against a newer snapshot. `40P01`
+* (deadlock_detected) is not tied to isolation level: it needs only two
+* transactions taking row locks in opposite order, which a caller reaches at
+* READ COMMITTED by wrapping several `updateIf` calls in one transaction.
+*/
+const SERIALIZATION_SQLSTATES = new Set(["40001", "40P01"]);
+function errSqlState(err) {
+	if (typeof err !== "object" || err === null) return void 0;
+	const code = err.code;
+	if (typeof code === "string") return code;
+	const cause = err.cause;
+	if (typeof cause === "object" && cause !== null) {
+		const causeCode = cause.code;
+		if (typeof causeCode === "string") return causeCode;
+	}
+}
+function mapSerializationFailure(err) {
+	const sqlState = errSqlState(err);
+	if (sqlState !== void 0 && SERIALIZATION_SQLSTATES.has(sqlState)) return new StorageSerializationError("Storage write must be retried. Restart the transaction before retrying when using an explicit transaction.", {
+		cause: err,
+		sqlState
+	});
+	return err;
+}
+/**
 * Interleave a `?`-placeholder SQL string with its params into a single
 * boolean raw expression. Used as a WHERE predicate directly — wrapping it
 * in `(...) = 1` breaks on Postgres, which has a strict boolean type (#920).
@@ -229,11 +367,13 @@ var PluginStorageRepository = class {
 	async put(id, data) {
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		const jsonData = JSON.stringify(data);
+		const revision = crypto.randomUUID();
 		await this.db.insertInto("_plugin_storage").values({
 			plugin_id: this.pluginId,
 			collection: this.collection,
 			id,
 			data: jsonData,
+			revision,
 			created_at: now,
 			updated_at: now
 		}).onConflict((oc) => oc.columns([
@@ -242,9 +382,52 @@ var PluginStorageRepository = class {
 			"id"
 		]).doUpdateSet({
 			data: jsonData,
+			revision,
 			updated_at: now
 		})).execute();
 	}
+	async getVersioned(id) {
+		assertStorageKey(id);
+		const row = await this.db.selectFrom("_plugin_storage").select(["data", "revision"]).where("plugin_id", "=", this.pluginId).where("collection", "=", this.collection).where("id", "=", id).executeTakeFirst();
+		if (!row) return null;
+		return {
+			value: JSON.parse(row.data),
+			revision: row.revision
+		};
+	}
+	async compareAndSet(id, expectedRevision, data) {
+		assertStorageKey(id);
+		if (expectedRevision !== null) assertStorageRevision(expectedRevision);
+		const jsonData = serializeConditionalValue(data);
+		const revision = crypto.randomUUID();
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const row = expectedRevision === null ? await this.db.insertInto("_plugin_storage").values({
+			plugin_id: this.pluginId,
+			collection: this.collection,
+			id,
+			data: jsonData,
+			revision,
+			created_at: now,
+			updated_at: now
+		}).onConflict((oc) => oc.columns([
+			"plugin_id",
+			"collection",
+			"id"
+		]).doNothing()).returning("revision").executeTakeFirst() : await this.db.updateTable("_plugin_storage").set({
+			data: jsonData,
+			revision,
+			updated_at: now
+		}).where("plugin_id", "=", this.pluginId).where("collection", "=", this.collection).where("id", "=", id).where("revision", "=", expectedRevision).returning("revision").executeTakeFirst();
+		return row ? {
+			applied: true,
+			revision: row.revision
+		} : { applied: false };
+	}
+	async compareAndDelete(id, expectedRevision) {
+		assertStorageKey(id);
+		assertStorageRevision(expectedRevision);
+		return { applied: await this.db.deleteFrom("_plugin_storage").where("plugin_id", "=", this.pluginId).where("collection", "=", this.collection).where("id", "=", id).where("revision", "=", expectedRevision).returning("id").executeTakeFirst() !== void 0 };
+	}
 	/**
 	* Delete a document
 	*/
@@ -276,11 +459,13 @@ var PluginStorageRepository = class {
 		await withTransaction(this.db, async (trx) => {
 			for (const item of items) {
 				const jsonData = JSON.stringify(item.data);
+				const revision = crypto.randomUUID();
 				await trx.insertInto("_plugin_storage").values({
 					plugin_id: this.pluginId,
 					collection: this.collection,
 					id: item.id,
 					data: jsonData,
+					revision,
 					created_at: now,
 					updated_at: now
 				}).onConflict((oc) => oc.columns([
@@ -289,6 +474,7 @@ var PluginStorageRepository = class {
 					"id"
 				]).doUpdateSet({
 					data: jsonData,
+					revision,
 					updated_at: now
 				})).execute();
 			}
@@ -381,6 +567,30 @@ var PluginStorageRepository = class {
 		const result = await query.executeTakeFirst();
 		return Number(result?.count ?? 0);
 	}
+	async updateIf(id, args) {
+		if (typeof id !== "string") throw new TypeError("Storage ID must be a string");
+		const { where, setEntries, deltaEntries } = parseStorageUpdate(args);
+		for (const value of Object.values(where)) if (isInFilter(value) && value.in.length === 0) return { applied: false };
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const dataExpr = pluginDataWriteExpr(this.db, setEntries, deltaEntries);
+		let query = this.db.updateTable("_plugin_storage").set({
+			data: dataExpr,
+			updated_at: now
+		}).where("plugin_id", "=", this.pluginId).where("collection", "=", this.collection).where("id", "=", id).where(pluginDataUpdateGuard(this.db, deltaEntries));
+		const whereResult = buildWhereClause(this.db, where);
+		if (whereResult.sql) query = query.where(rawWhereExpr(whereResult.sql, whereResult.params));
+		let row;
+		try {
+			row = await query.returning("data").executeTakeFirst();
+		} catch (err) {
+			throw mapSerializationFailure(err);
+		}
+		if (!row) return { applied: false };
+		return {
+			applied: true,
+			data: JSON.parse(row.data)
+		};
+	}
 };
 
 //#endregion
@@ -395,6 +605,18 @@ function createKVAccess(optionsRepo, pluginId) {
 		async get(key) {
 			return optionsRepo.get(`${prefix}${key}`);
 		},
+		async getVersioned(key) {
+			assertStorageKey(key);
+			return optionsRepo.getVersioned(`${prefix}${key}`);
+		},
+		async compareAndSet(key, expectedRevision, value) {
+			assertStorageKey(key);
+			return optionsRepo.compareAndSet(`${prefix}${key}`, expectedRevision, value);
+		},
+		async compareAndDelete(key, expectedRevision) {
+			assertStorageKey(key);
+			return optionsRepo.compareAndDelete(`${prefix}${key}`, expectedRevision);
+		},
 		async set(key, value) {
 			await optionsRepo.set(`${prefix}${key}`, value);
 		},
@@ -421,6 +643,9 @@ function createStorageCollection(db, pluginId, collectionName, indexes) {
 	const repo = new PluginStorageRepository(db, pluginId, collectionName, indexes);
 	return {
 		get: (id) => repo.get(id),
+		getVersioned: (id) => repo.getVersioned(id),
+		compareAndSet: (id, expectedRevision, data) => repo.compareAndSet(id, expectedRevision, data),
+		compareAndDelete: (id, expectedRevision) => repo.compareAndDelete(id, expectedRevision),
 		put: (id, data) => repo.put(id, data),
 		delete: (id) => repo.delete(id),
 		exists: (id) => repo.exists(id),
@@ -428,6 +653,7 @@ function createStorageCollection(db, pluginId, collectionName, indexes) {
 		putMany: (items) => repo.putMany(items),
 		deleteMany: (ids) => repo.deleteMany(ids),
 		count: (where) => repo.count(where),
+		updateIf: (id, updateArgs) => repo.updateIf(id, updateArgs),
 		async query(options) {
 			const result = await repo.query({
 				where: options?.where,
@@ -683,7 +909,10 @@ function createContentAccessWithWrite(db, beforeContentWrite) {
 		async delete(collection, id) {
 			await beforeContentWrite?.();
 			const deleted = await new ContentRepository(db).delete(collection, id);
-			if (deleted) await markContentMediaUsageCollectionStaleSafely(db, collection, "CONTENT_USAGE_STALE");
+			if (deleted) {
+				await new EntryLockRepository(db).releaseEntry(collection, id);
+				await markContentMediaUsageCollectionStaleSafely(db, collection, "CONTENT_USAGE_STALE");
+			}
 			return deleted;
 		}
 	};
@@ -822,11 +1051,26 @@ function isHostAllowed(host, allowedHosts) {
 		return host === pattern;
 	});
 }
+function tryParsePluginHttpTarget(url) {
+	try {
+		return new URL(url);
+	} catch {
+		return null;
+	}
+}
+async function validatePluginHttpTarget(pluginId, url) {
+	try {
+		return await resolveAndValidateExternalUrl(url);
+	} catch (error) {
+		const message = error instanceof SsrfError ? error.message : "SSRF validation failed";
+		const target = tryParsePluginHttpTarget(url);
+		throw new Error(`Plugin "${pluginId}": blocked fetch to "${target ? target.hostname : "invalid URL"}": ${message}`, { cause: error });
+	}
+}
 /**
-* Create HTTP access with host validation.
+* Create HTTP access with host validation and SSRF protection.
 *
-* Uses redirect: "manual" to re-validate each redirect target against
-* the allowedHosts list, preventing redirects to unauthorized hosts.
+* Uses redirect: "manual" to re-validate each redirect target before dispatch.
 */
 function createHttpAccess(pluginId, allowedHosts) {
 	return { async fetch(url, init) {
@@ -834,8 +1078,9 @@ function createHttpAccess(pluginId, allowedHosts) {
 		let currentUrl = url;
 		let currentInit = init;
 		for (let i = 0; i <= MAX_PLUGIN_REDIRECTS; i++) {
-			const hostname = new URL(currentUrl).hostname;
-			if (!isHostAllowed(hostname, allowedHosts)) throw new Error(`Plugin "${pluginId}" is not allowed to fetch from host "${hostname}". Allowed hosts: ${allowedHosts.join(", ")}`);
+			const target = tryParsePluginHttpTarget(currentUrl);
+			if (target && !isHostAllowed(target.hostname, allowedHosts)) throw new Error(`Plugin "${pluginId}" is not allowed to fetch from host "${target.hostname}". Allowed hosts: ${allowedHosts.join(", ")}`);
+			await validatePluginHttpTarget(pluginId, currentUrl);
 			const response = await globalThis.fetch(currentUrl, {
 				...currentInit,
 				redirect: "manual"
@@ -860,12 +1105,7 @@ function createUnrestrictedHttpAccess(pluginId) {
 		let currentUrl = url;
 		let currentInit = init;
 		for (let i = 0; i <= MAX_PLUGIN_REDIRECTS; i++) {
-			try {
-				await resolveAndValidateExternalUrl(currentUrl);
-			} catch (e) {
-				const msg = e instanceof SsrfError ? e.message : "SSRF validation failed";
-				throw new Error(`Plugin "${pluginId}": blocked fetch to "${new URL(currentUrl).hostname}": ${msg}`, { cause: e });
-			}
+			await validatePluginHttpTarget(pluginId, currentUrl);
 			const response = await globalThis.fetch(currentUrl, {
 				...currentInit,
 				redirect: "manual"
@@ -1064,5 +1304,5 @@ var PluginContextFactory = class {
 };
 
 //#endregion
-export { createUnrestrictedHttpAccess as a, createStorageAccess as i, createHttpAccess as n, PluginStorageRepository as o, createSiteInfo as r, PluginContextFactory as t };
-//# sourceMappingURL=context-CX6gxOLW.mjs.map
+export { createUnrestrictedHttpAccess as a, createStorageAccess as i, createHttpAccess as n, PluginStorageRepository as o, createSiteInfo as r, StorageSerializationError as s, PluginContextFactory as t };
+//# sourceMappingURL=context-C9PB8vGd.mjs.map