emdash 0.33.0 → 0.34.0

package/dist/media-usage-work-B9Bksh_b.mjs

@@ -0,0 +1,152 @@
+import { i as InvalidCursorError } from "./types-CQPWhPxE.mjs";
+import { t as MediaUsageWorkRepository } from "./media-usage-work-DrCbqBcl.mjs";
+import { t as ErrorCode } from "./errors-CLUPm7aD.mjs";
+import { t as MediaUsageCollectionDeletionRepository } from "./collection-deletion-C8BugSGz.mjs";
+
+//#region src/api/handlers/media-usage-work.ts
+async function handleMediaUsageWorkList(db, query) {
+	try {
+		const page = await new MediaUsageWorkRepository(db).findOperatorPage({
+			collectionSlug: query.collection,
+			state: query.state,
+			cursor: query.cursor,
+			limit: query.limit
+		});
+		if (!page) return {
+			success: false,
+			error: {
+				code: ErrorCode.COLLECTION_NOT_FOUND,
+				message: "Collection not found"
+			}
+		};
+		return {
+			success: true,
+			data: page
+		};
+	} catch (error) {
+		if (error instanceof InvalidCursorError) return {
+			success: false,
+			error: {
+				code: ErrorCode.INVALID_CURSOR,
+				message: "Invalid media usage work cursor"
+			}
+		};
+		console.error("[media-usage-work] list failed:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.MEDIA_USAGE_WORK_LIST_ERROR,
+				message: "Failed to list media usage work"
+			}
+		};
+	}
+}
+async function handleMediaUsageCollectionDeletionList(db, query) {
+	try {
+		return {
+			success: true,
+			data: await new MediaUsageCollectionDeletionRepository(db).findOperatorPage(query)
+		};
+	} catch (error) {
+		if (error instanceof InvalidCursorError) return {
+			success: false,
+			error: {
+				code: ErrorCode.INVALID_CURSOR,
+				message: "Invalid cursor"
+			}
+		};
+		console.error("[media-usage:collection-deletion] list failed:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.MEDIA_USAGE_COLLECTION_DELETION_LIST_ERROR,
+				message: "Failed to list collection deletions"
+			}
+		};
+	}
+}
+async function handleMediaUsageCollectionDeletionRetry(db, input) {
+	try {
+		const result = await new MediaUsageCollectionDeletionRepository(db).retryOperatorDeletion(input);
+		if (result.outcome === "pending") return {
+			success: true,
+			data: {
+				changed: result.changed,
+				item: result.item
+			}
+		};
+		if (result.outcome === "lease_active") return {
+			success: false,
+			error: {
+				code: ErrorCode.WORK_LEASE_ACTIVE,
+				message: "Collection deletion is currently leased",
+				details: { leaseExpiresAt: result.leaseExpiresAt }
+			}
+		};
+		return {
+			success: false,
+			error: {
+				code: result.outcome === "not_found" ? ErrorCode.NOT_FOUND : ErrorCode.WORK_CHANGED,
+				message: result.outcome === "not_found" ? "Collection deletion not found" : "Collection deletion changed"
+			}
+		};
+	} catch (error) {
+		console.error("[media-usage:collection-deletion] retry failed:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.MEDIA_USAGE_COLLECTION_DELETION_RETRY_ERROR,
+				message: "Failed to retry collection deletion"
+			}
+		};
+	}
+}
+async function handleMediaUsageWorkRetry(db, input) {
+	try {
+		const result = await new MediaUsageWorkRepository(db).retryOperatorWork(input);
+		switch (result.outcome) {
+			case "pending": return {
+				success: true,
+				data: {
+					changed: result.changed,
+					item: result.work
+				}
+			};
+			case "lease_active": return {
+				success: false,
+				error: {
+					code: ErrorCode.WORK_LEASE_ACTIVE,
+					message: "Media usage work is currently leased",
+					details: { leaseExpiresAt: result.leaseExpiresAt }
+				}
+			};
+			case "collection_not_found": return {
+				success: false,
+				error: {
+					code: ErrorCode.COLLECTION_NOT_FOUND,
+					message: "Collection not found"
+				}
+			};
+			case "conflict": return {
+				success: false,
+				error: {
+					code: ErrorCode.WORK_CHANGED,
+					message: "Media usage work changed; retry the request"
+				}
+			};
+		}
+	} catch (error) {
+		console.error("[media-usage-work] retry failed:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.MEDIA_USAGE_WORK_RETRY_ERROR,
+				message: "Failed to retry media usage work"
+			}
+		};
+	}
+}
+
+//#endregion
+export { handleMediaUsageWorkRetry as i, handleMediaUsageCollectionDeletionRetry as n, handleMediaUsageWorkList as r, handleMediaUsageCollectionDeletionList as t };
+//# sourceMappingURL=media-usage-work-B9Bksh_b.mjs.map

package/dist/media-usage-work-B9Bksh_b.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-usage-work-B9Bksh_b.mjs","names":[],"sources":["../src/api/handlers/media-usage-work.ts"],"sourcesContent":["import type { Kysely } from \"kysely\";\n\nimport { MediaUsageWorkRepository } from \"../../database/repositories/media-usage-work.js\";\nimport { InvalidCursorError } from \"../../database/repositories/types.js\";\nimport type { Database } from \"../../database/types.js\";\nimport { MediaUsageCollectionDeletionRepository } from \"../../media/usage/collection-deletion.js\";\nimport { ErrorCode } from \"../errors.js\";\nimport type {\n\tMediaUsageWorkListQuery,\n\tMediaUsageWorkListResponse,\n\tMediaUsageWorkRetryRequest,\n\tMediaUsageWorkRetryResponse,\n\tMediaUsageCollectionDeletionListQuery,\n\tMediaUsageCollectionDeletionListResponse,\n\tMediaUsageCollectionDeletionRetryRequest,\n\tMediaUsageCollectionDeletionRetryResponse,\n} from \"../schemas/media-usage.js\";\nimport type { ApiResult } from \"../types.js\";\n\nexport type {\n\tMediaUsageWorkItem,\n\tMediaUsageWorkListQuery,\n\tMediaUsageWorkListResponse,\n\tMediaUsageWorkRetryRequest,\n\tMediaUsageWorkRetryResponse,\n} from \"../schemas/media-usage.js\";\n\nexport async function handleMediaUsageWorkList(\n\tdb: Kysely<Database>,\n\tquery: MediaUsageWorkListQuery,\n): Promise<ApiResult<MediaUsageWorkListResponse>> {\n\ttry {\n\t\tconst page = await new MediaUsageWorkRepository(db).findOperatorPage({\n\t\t\tcollectionSlug: query.collection,\n\t\t\tstate: query.state,\n\t\t\tcursor: query.cursor,\n\t\t\tlimit: query.limit,\n\t\t});\n\t\tif (!page) {\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\terror: {\n\t\t\t\t\tcode: ErrorCode.COLLECTION_NOT_FOUND,\n\t\t\t\t\tmessage: \"Collection not found\",\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\treturn { success: true, data: page };\n\t} catch (error) {\n\t\tif (error instanceof InvalidCursorError) {\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\terror: {\n\t\t\t\t\tcode: ErrorCode.INVALID_CURSOR,\n\t\t\t\t\tmessage: \"Invalid media usage work cursor\",\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\tconsole.error(\"[media-usage-work] list failed:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: {\n\t\t\t\tcode: ErrorCode.MEDIA_USAGE_WORK_LIST_ERROR,\n\t\t\t\tmessage: \"Failed to list media usage work\",\n\t\t\t},\n\t\t};\n\t}\n}\n\nexport async function handleMediaUsageCollectionDeletionList(\n\tdb: Kysely<Database>,\n\tquery: MediaUsageCollectionDeletionListQuery,\n): Promise<ApiResult<MediaUsageCollectionDeletionListResponse>> {\n\ttry {\n\t\treturn {\n\t\t\tsuccess: true,\n\t\t\tdata: await new MediaUsageCollectionDeletionRepository(db).findOperatorPage(query),\n\t\t};\n\t} catch (error) {\n\t\tif (error instanceof InvalidCursorError) {\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\terror: { code: ErrorCode.INVALID_CURSOR, message: \"Invalid cursor\" },\n\t\t\t};\n\t\t}\n\t\tconsole.error(\"[media-usage:collection-deletion] list failed:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: {\n\t\t\t\tcode: ErrorCode.MEDIA_USAGE_COLLECTION_DELETION_LIST_ERROR,\n\t\t\t\tmessage: \"Failed to list collection deletions\",\n\t\t\t},\n\t\t};\n\t}\n}\n\nexport async function handleMediaUsageCollectionDeletionRetry(\n\tdb: Kysely<Database>,\n\tinput: MediaUsageCollectionDeletionRetryRequest,\n): Promise<ApiResult<MediaUsageCollectionDeletionRetryResponse>> {\n\ttry {\n\t\tconst result = await new MediaUsageCollectionDeletionRepository(db).retryOperatorDeletion(\n\t\t\tinput,\n\t\t);\n\t\tif (result.outcome === \"pending\") {\n\t\t\treturn { success: true, data: { changed: result.changed, item: result.item } };\n\t\t}\n\t\tif (result.outcome === \"lease_active\") {\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\terror: {\n\t\t\t\t\tcode: ErrorCode.WORK_LEASE_ACTIVE,\n\t\t\t\t\tmessage: \"Collection deletion is currently leased\",\n\t\t\t\t\tdetails: { leaseExpiresAt: result.leaseExpiresAt },\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: {\n\t\t\t\tcode: result.outcome === \"not_found\" ? ErrorCode.NOT_FOUND : ErrorCode.WORK_CHANGED,\n\t\t\t\tmessage:\n\t\t\t\t\tresult.outcome === \"not_found\"\n\t\t\t\t\t\t? \"Collection deletion not found\"\n\t\t\t\t\t\t: \"Collection deletion changed\",\n\t\t\t},\n\t\t};\n\t} catch (error) {\n\t\tconsole.error(\"[media-usage:collection-deletion] retry failed:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: {\n\t\t\t\tcode: ErrorCode.MEDIA_USAGE_COLLECTION_DELETION_RETRY_ERROR,\n\t\t\t\tmessage: \"Failed to retry collection deletion\",\n\t\t\t},\n\t\t};\n\t}\n}\n\nexport async function handleMediaUsageWorkRetry(\n\tdb: Kysely<Database>,\n\tinput: MediaUsageWorkRetryRequest,\n): Promise<ApiResult<MediaUsageWorkRetryResponse>> {\n\ttry {\n\t\tconst result = await new MediaUsageWorkRepository(db).retryOperatorWork(input);\n\t\tswitch (result.outcome) {\n\t\t\tcase \"pending\":\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: true,\n\t\t\t\t\tdata: { changed: result.changed, item: result.work },\n\t\t\t\t};\n\t\t\tcase \"lease_active\":\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: {\n\t\t\t\t\t\tcode: ErrorCode.WORK_LEASE_ACTIVE,\n\t\t\t\t\t\tmessage: \"Media usage work is currently leased\",\n\t\t\t\t\t\tdetails: { leaseExpiresAt: result.leaseExpiresAt },\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\tcase \"collection_not_found\":\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: {\n\t\t\t\t\t\tcode: ErrorCode.COLLECTION_NOT_FOUND,\n\t\t\t\t\t\tmessage: \"Collection not found\",\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\tcase \"conflict\":\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: {\n\t\t\t\t\t\tcode: ErrorCode.WORK_CHANGED,\n\t\t\t\t\t\tmessage: \"Media usage work changed; retry the request\",\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t}\n\t} catch (error) {\n\t\tconsole.error(\"[media-usage-work] retry failed:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: {\n\t\t\t\tcode: ErrorCode.MEDIA_USAGE_WORK_RETRY_ERROR,\n\t\t\t\tmessage: \"Failed to retry media usage work\",\n\t\t\t},\n\t\t};\n\t}\n}\n"],"mappings":";;;;;;AA2BA,eAAsB,yBACrB,IACA,OACiD;AACjD,KAAI;EACH,MAAM,OAAO,MAAM,IAAI,yBAAyB,GAAG,CAAC,iBAAiB;GACpE,gBAAgB,MAAM;GACtB,OAAO,MAAM;GACb,QAAQ,MAAM;GACd,OAAO,MAAM;GACb,CAAC;AACF,MAAI,CAAC,KACJ,QAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT;GACD;AAEF,SAAO;GAAE,SAAS;GAAM,MAAM;GAAM;UAC5B,OAAO;AACf,MAAI,iBAAiB,mBACpB,QAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT;GACD;AAEF,UAAQ,MAAM,mCAAmC,MAAM;AACvD,SAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT;GACD;;;AAIH,eAAsB,uCACrB,IACA,OAC+D;AAC/D,KAAI;AACH,SAAO;GACN,SAAS;GACT,MAAM,MAAM,IAAI,uCAAuC,GAAG,CAAC,iBAAiB,MAAM;GAClF;UACO,OAAO;AACf,MAAI,iBAAiB,mBACpB,QAAO;GACN,SAAS;GACT,OAAO;IAAE,MAAM,UAAU;IAAgB,SAAS;IAAkB;GACpE;AAEF,UAAQ,MAAM,kDAAkD,MAAM;AACtE,SAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT;GACD;;;AAIH,eAAsB,wCACrB,IACA,OACgE;AAChE,KAAI;EACH,MAAM,SAAS,MAAM,IAAI,uCAAuC,GAAG,CAAC,sBACnE,MACA;AACD,MAAI,OAAO,YAAY,UACtB,QAAO;GAAE,SAAS;GAAM,MAAM;IAAE,SAAS,OAAO;IAAS,MAAM,OAAO;IAAM;GAAE;AAE/E,MAAI,OAAO,YAAY,eACtB,QAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT,SAAS,EAAE,gBAAgB,OAAO,gBAAgB;IAClD;GACD;AAEF,SAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,OAAO,YAAY,cAAc,UAAU,YAAY,UAAU;IACvE,SACC,OAAO,YAAY,cAChB,kCACA;IACJ;GACD;UACO,OAAO;AACf,UAAQ,MAAM,mDAAmD,MAAM;AACvE,SAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT;GACD;;;AAIH,eAAsB,0BACrB,IACA,OACkD;AAClD,KAAI;EACH,MAAM,SAAS,MAAM,IAAI,yBAAyB,GAAG,CAAC,kBAAkB,MAAM;AAC9E,UAAQ,OAAO,SAAf;GACC,KAAK,UACJ,QAAO;IACN,SAAS;IACT,MAAM;KAAE,SAAS,OAAO;KAAS,MAAM,OAAO;KAAM;IACpD;GACF,KAAK,eACJ,QAAO;IACN,SAAS;IACT,OAAO;KACN,MAAM,UAAU;KAChB,SAAS;KACT,SAAS,EAAE,gBAAgB,OAAO,gBAAgB;KAClD;IACD;GACF,KAAK,uBACJ,QAAO;IACN,SAAS;IACT,OAAO;KACN,MAAM,UAAU;KAChB,SAAS;KACT;IACD;GACF,KAAK,WACJ,QAAO;IACN,SAAS;IACT,OAAO;KACN,MAAM,UAAU;KAChB,SAAS;KACT;IACD;;UAEK,OAAO;AACf,UAAQ,MAAM,oCAAoC,MAAM;AACxD,SAAO;GACN,SAAS;GACT,OAAO;IACN,MAAM,UAAU;IAChB,SAAS;IACT;GACD"}

package/dist/media-usage-work-DrCbqBcl.mjs

@@ -0,0 +1,424 @@
+import { s as isPostgres } from "./dialect-helpers-BSbfaO3F.mjs";
+import { o as decodeCursor, s as encodeCursor } from "./types-CQPWhPxE.mjs";
+import { sql } from "kysely";
+import { ulid } from "ulidx";
+
+//#region src/database/repositories/media-usage-work.ts
+const MAX_PORTABLE_DURATION_SECONDS = 365 * 24 * 60 * 60;
+const MAX_WORK_SELECTION_LIMIT = 100;
+const NON_NEGATIVE_DECIMAL_PATTERN = /^(?:0|[1-9][0-9]*)$/;
+const POSITIVE_DECIMAL_PATTERN = /^[1-9][0-9]*$/;
+const STABLE_ERROR_CODE_PATTERN = /^[A-Z][A-Z0-9_]{0,63}$/;
+const MEDIA_USAGE_WORK_OPERATOR_DEFAULT_LIMIT = 50;
+const MEDIA_USAGE_WORK_OPERATOR_MAX_LIMIT = 100;
+const MEDIA_USAGE_RECONCILIATION_PAGE_LIMIT = 50;
+const MEDIA_USAGE_WORK_STATES = [
+	"pending",
+	"retry",
+	"leased",
+	"failed"
+];
+var MediaUsageWorkRepository = class {
+	constructor(db) {
+		this.db = db;
+	}
+	async enqueueReconciliationPage(input) {
+		if (!input.collectionId || !input.collectionSlug || !input.runToken || !input.leaseToken) throw new Error("Reconciliation enqueue requires exact collection and lease identity");
+		assertNonNegativeDecimal(input.changeEpoch, "change epoch");
+		const contentIds = [...new Set(input.contentIds)];
+		if (contentIds.length < 1 || contentIds.length > MEDIA_USAGE_RECONCILIATION_PAGE_LIMIT) throw new Error("Reconciliation enqueue requires from 1 to 50 content IDs");
+		if (contentIds.some((contentId) => !contentId)) throw new Error("Reconciliation enqueue content IDs must not be empty");
+		const now = this.timestampOffset(0);
+		await sql`
+			WITH page(content_id) AS (VALUES ${sql.join(contentIds.map((contentId) => sql`(${contentId})`), sql`, `)})
+			INSERT INTO _emdash_media_usage_work (
+				collection_id, collection_slug, content_id, change_epoch, work_version,
+				state, attempt_count, next_attempt_at, lease_token, lease_expires_at,
+				last_attempted_at, last_error_code, created_at, updated_at
+			)
+			SELECT
+				${input.collectionId}, ${input.collectionSlug}, page.content_id, ${input.changeEpoch}, 1,
+				'pending', 0, ${now}, NULL, NULL, NULL, NULL, ${now}, ${now}
+			FROM page
+			WHERE EXISTS (
+				SELECT 1
+				FROM _emdash_media_usage_reconciliations AS reconciliation
+				INNER JOIN _emdash_media_usage_index_status AS status
+					ON status.collection_id = reconciliation.collection_id
+					AND status.scope_key = reconciliation.collection_slug
+				INNER JOIN _emdash_collections AS collection
+					ON collection.id = reconciliation.collection_id
+					AND collection.slug = reconciliation.collection_slug
+				WHERE reconciliation.collection_id = ${input.collectionId}
+					AND reconciliation.collection_slug = ${input.collectionSlug}
+					AND reconciliation.run_token = ${input.runToken}
+					AND reconciliation.target_epoch = ${input.changeEpoch}
+					AND reconciliation.state = 'leased'
+					AND reconciliation.phase = ${input.phase}
+					AND reconciliation.lease_token = ${input.leaseToken}
+					AND ${this.qualifiedLeaseIsLive("reconciliation.lease_expires_at")}
+					AND status.adapter_id = 'content-media'
+					AND status.scope_type = 'collection'
+					AND status.capture_state = 'active'
+					AND status.reconciliation_required = 1
+					AND status.status = 'running'
+					AND status.cursor = ${input.runToken}
+					AND status.change_epoch = ${input.changeEpoch}
+					AND EXISTS (
+						SELECT 1 FROM _emdash_media_usage_activation AS activation
+						WHERE activation.task_key = 'incremental_capture'
+							AND activation.state = 'active'
+					)
+					AND NOT EXISTS (
+						SELECT 1 FROM _emdash_media_usage_collection_deletions AS deletion
+						WHERE deletion.collection_id = reconciliation.collection_id
+					)
+			)
+			ON CONFLICT (collection_id, content_id) DO UPDATE SET
+				collection_slug = excluded.collection_slug,
+				change_epoch = excluded.change_epoch,
+				work_version = _emdash_media_usage_work.work_version + 1,
+				state = 'pending',
+				attempt_count = 0,
+				next_attempt_at = excluded.next_attempt_at,
+				lease_token = NULL,
+				lease_expires_at = NULL,
+				last_attempted_at = NULL,
+				last_error_code = NULL,
+				updated_at = excluded.updated_at
+			WHERE _emdash_media_usage_work.change_epoch < excluded.change_epoch
+		`.execute(this.db);
+	}
+	async findOperatorPage(options) {
+		if (!options.collectionSlug) throw new Error("Media usage work listing requires a collection slug");
+		if (options.state !== void 0 && !isMediaUsageWorkState(options.state)) throw new Error("Media usage work listing requires a valid state");
+		const limit = operatorLimit(options.limit);
+		const cursor = options.cursor ? decodeCursor(options.cursor) : null;
+		const collection = await this.db.selectFrom("_emdash_collections").select(["id", "slug"]).where("slug", "=", options.collectionSlug).executeTakeFirst();
+		if (!collection) return null;
+		const states = options.state ? [options.state] : MEDIA_USAGE_WORK_STATES;
+		const candidates = [];
+		for (const state of states) {
+			const rows = await this.findOperatorRows({
+				collectionId: collection.id,
+				collectionSlug: collection.slug,
+				state,
+				limit: limit + 1,
+				cursor
+			});
+			candidates.push(...rows.map(rowToOperatorWork));
+		}
+		const ordered = candidates.toSorted(compareOperatorWork);
+		const items = ordered.slice(0, limit);
+		const result = { items };
+		if (ordered.length > limit && items.length > 0) {
+			const last = items.at(-1);
+			result.nextCursor = encodeCursor(last.updatedAt, last.contentId);
+		}
+		return result;
+	}
+	async findOperatorRows(input) {
+		let query = this.db.selectFrom("_emdash_media_usage_work as work").innerJoin("_emdash_collections as current_collection", (join) => join.onRef("current_collection.id", "=", "work.collection_id").onRef("current_collection.slug", "=", "work.collection_slug")).selectAll("work").where("work.collection_id", "=", input.collectionId).where("work.collection_slug", "=", input.collectionSlug).where("work.state", "=", input.state);
+		if (input.cursor) query = query.where((eb) => eb.or([eb("work.updated_at", "<", input.cursor.orderValue), eb.and([eb("work.updated_at", "=", input.cursor.orderValue), eb("work.content_id", "<", input.cursor.id)])]));
+		return query.orderBy("work.updated_at", "desc").orderBy("work.content_id", "desc").limit(input.limit).execute();
+	}
+	async retryOperatorWork(input) {
+		if (!input.collectionId || !input.contentId) throw new Error("Media usage operator retry requires collection and content IDs");
+		const collection = await this.findActiveOperatorCollection(input.collectionId);
+		if (!collection) return { outcome: "collection_not_found" };
+		const observed = await this.findWorkByIdentity(input.collectionId, input.contentId);
+		if (observed?.state === "pending" && observed.collection_slug === collection.slug) return {
+			outcome: "pending",
+			changed: false,
+			work: rowToOperatorWork(observed)
+		};
+		const invalidated = await this.invalidateCoverageForOperatorRetry({
+			...input,
+			collectionSlug: collection.slug,
+			observed
+		});
+		if (!invalidated) return this.operatorRetryLost(input);
+		const reopened = observed ? await this.reopenObservedWork(observed, collection.slug, invalidated.change_epoch) : await this.createOperatorWork({
+			...input,
+			collectionSlug: collection.slug,
+			changeEpoch: invalidated.change_epoch
+		});
+		if (reopened) return {
+			outcome: "pending",
+			changed: true,
+			work: rowToOperatorWork(reopened)
+		};
+		return this.operatorRetryLost(input);
+	}
+	async findActiveOperatorCollection(collectionId) {
+		return await this.db.selectFrom("_emdash_collections as collection").innerJoin("_emdash_media_usage_index_status as status", (join) => join.onRef("status.collection_id", "=", "collection.id").onRef("status.scope_key", "=", "collection.slug")).select(["collection.id", "collection.slug"]).where("collection.id", "=", collectionId).where("status.adapter_id", "=", "content-media").where("status.scope_type", "=", "collection").where("status.capture_state", "=", "active").executeTakeFirst() ?? null;
+	}
+	async findWorkByIdentity(collectionId, contentId) {
+		return await this.db.selectFrom("_emdash_media_usage_work").selectAll().where("collection_id", "=", collectionId).where("content_id", "=", contentId).executeTakeFirst() ?? null;
+	}
+	async invalidateCoverageForOperatorRetry(input) {
+		let query = this.db.updateTable("_emdash_media_usage_index_status as status").set({
+			change_epoch: sql`change_epoch + 1`,
+			status: sql`CASE WHEN status = 'complete' THEN 'stale' ELSE status END`,
+			completed_at: sql`CASE WHEN status = 'complete' THEN NULL ELSE completed_at END`,
+			updated_at: this.timestampOffset(0)
+		}).where("status.adapter_id", "=", "content-media").where("status.scope_type", "=", "collection").where("status.scope_key", "=", input.collectionSlug).where("status.collection_id", "=", input.collectionId).where("status.capture_state", "=", "active").where((eb) => eb.exists(eb.selectFrom("_emdash_collections as collection").select("collection.id").whereRef("collection.id", "=", "status.collection_id").whereRef("collection.slug", "=", "status.scope_key")));
+		const observed = input.observed;
+		if (observed) query = query.where((eb) => {
+			let work = eb.selectFrom("_emdash_media_usage_work as work").select("work.content_id").whereRef("work.collection_id", "=", "status.collection_id").where("work.content_id", "=", input.contentId).where("work.work_version", "=", observed.work_version).where("work.state", "=", observed.state);
+			if (observed.state === "leased") work = work.where("work.lease_expires_at", "is not", null).where(this.timestampIsDue("work.lease_expires_at"));
+			return eb.exists(work);
+		});
+		else query = query.where((eb) => eb.not(eb.exists(eb.selectFrom("_emdash_media_usage_work as work").select("work.content_id").whereRef("work.collection_id", "=", "status.collection_id").where("work.content_id", "=", input.contentId))));
+		return await query.returning("change_epoch").executeTakeFirst() ?? null;
+	}
+	async reopenObservedWork(observed, collectionSlug, changeEpoch) {
+		let query = this.db.updateTable("_emdash_media_usage_work").set({
+			collection_slug: collectionSlug,
+			change_epoch: changeEpoch,
+			work_version: sql`work_version + 1`,
+			state: "pending",
+			attempt_count: 0,
+			next_attempt_at: this.timestampOffset(0),
+			lease_token: null,
+			lease_expires_at: null,
+			last_attempted_at: null,
+			last_error_code: null,
+			updated_at: this.timestampOffset(0)
+		}).where("collection_id", "=", observed.collection_id).where("content_id", "=", observed.content_id).where("work_version", "=", observed.work_version).where("state", "=", observed.state).where((eb) => eb.exists(eb.selectFrom("_emdash_collections as collection").innerJoin("_emdash_media_usage_index_status as status", (join) => join.onRef("status.collection_id", "=", "collection.id").onRef("status.scope_key", "=", "collection.slug")).select("collection.id").where("collection.id", "=", observed.collection_id).where("collection.slug", "=", collectionSlug).where("status.adapter_id", "=", "content-media").where("status.scope_type", "=", "collection").where("status.capture_state", "=", "active").where("status.change_epoch", "=", changeEpoch)));
+		if (observed.state === "leased") query = query.where("lease_expires_at", "is not", null).where(this.timestampIsDue("lease_expires_at"));
+		return await query.returningAll().executeTakeFirst() ?? null;
+	}
+	async createOperatorWork(input) {
+		const now = this.timestampOffset(0);
+		return await this.db.insertInto("_emdash_media_usage_work").columns([
+			"collection_id",
+			"collection_slug",
+			"content_id",
+			"change_epoch",
+			"work_version",
+			"state",
+			"attempt_count",
+			"next_attempt_at",
+			"lease_token",
+			"lease_expires_at",
+			"last_attempted_at",
+			"last_error_code",
+			"created_at",
+			"updated_at"
+		]).expression((insert) => insert.selectFrom("_emdash_media_usage_index_status as status").innerJoin("_emdash_collections as collection", (join) => join.onRef("collection.id", "=", "status.collection_id").onRef("collection.slug", "=", "status.scope_key")).select((select) => [
+			select.val(input.collectionId).as("collection_id"),
+			"collection.slug as collection_slug",
+			select.val(input.contentId).as("content_id"),
+			"status.change_epoch as change_epoch",
+			select.val(1).as("work_version"),
+			select.val("pending").as("state"),
+			select.val(0).as("attempt_count"),
+			now.as("next_attempt_at"),
+			sql`NULL`.as("lease_token"),
+			sql`NULL`.as("lease_expires_at"),
+			sql`NULL`.as("last_attempted_at"),
+			sql`NULL`.as("last_error_code"),
+			now.as("created_at"),
+			now.as("updated_at")
+		]).where("status.adapter_id", "=", "content-media").where("status.scope_type", "=", "collection").where("status.scope_key", "=", input.collectionSlug).where("status.collection_id", "=", input.collectionId).where("status.capture_state", "=", "active").where("status.change_epoch", "=", input.changeEpoch)).onConflict((conflict) => conflict.columns(["collection_id", "content_id"]).doNothing()).returningAll().executeTakeFirst() ?? null;
+	}
+	async operatorRetryLost(input) {
+		if (!await this.findActiveOperatorCollection(input.collectionId)) return { outcome: "collection_not_found" };
+		const current = await this.findWorkByIdentity(input.collectionId, input.contentId);
+		if (current?.state === "pending") return {
+			outcome: "pending",
+			changed: false,
+			work: rowToOperatorWork(current)
+		};
+		const liveLease = await this.findLiveLeaseExpiry(input.collectionId, input.contentId);
+		if (liveLease) return {
+			outcome: "lease_active",
+			leaseExpiresAt: liveLease
+		};
+		return { outcome: "conflict" };
+	}
+	async findLiveLeaseExpiry(collectionId, contentId) {
+		return (await this.db.selectFrom("_emdash_media_usage_work").select("lease_expires_at").where("collection_id", "=", collectionId).where("content_id", "=", contentId).where("state", "=", "leased").where("lease_expires_at", "is not", null).where(this.leaseIsLive()).executeTakeFirst())?.lease_expires_at ?? null;
+	}
+	async findDueWork(limit) {
+		if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_WORK_SELECTION_LIMIT) throw new Error(`Media usage due-work limit must be a whole number from 1 to ${MAX_WORK_SELECTION_LIMIT}`);
+		const pendingRows = await this.findDueRows("pending", "next_attempt_at", limit);
+		const retryRows = await this.findDueRows("retry", "next_attempt_at", limit);
+		const leasedRows = await this.findDueRows("leased", "lease_expires_at", limit);
+		return [
+			...pendingRows,
+			...retryRows,
+			...leasedRows
+		].map(rowToWork).toSorted(compareDueWork).slice(0, limit);
+	}
+	async findDueRows(state, timestampColumn, limit) {
+		let query = this.db.selectFrom("_emdash_media_usage_work").selectAll().where("state", "=", state).where(this.timestampIsDue(timestampColumn)).orderBy(timestampColumn, "asc");
+		if (timestampColumn === "next_attempt_at") query = query.orderBy("updated_at", "asc");
+		return query.orderBy("collection_id", "asc").orderBy("content_id", "asc").limit(limit).execute();
+	}
+	async findWorkForContent(collectionSlug, contentId) {
+		if (!collectionSlug || !contentId) throw new Error("Media usage work lookup requires collection and content identity");
+		const row = await this.db.selectFrom("_emdash_media_usage_work").innerJoin("_emdash_collections as current_collection", (join) => join.onRef("current_collection.id", "=", "_emdash_media_usage_work.collection_id").onRef("current_collection.slug", "=", "_emdash_media_usage_work.collection_slug")).selectAll("_emdash_media_usage_work").where("_emdash_media_usage_work.collection_slug", "=", collectionSlug).where("_emdash_media_usage_work.content_id", "=", contentId).executeTakeFirst();
+		return row ? rowToWork(row) : null;
+	}
+	async claimWork(input) {
+		assertIdentity(input);
+		const leaseDurationSeconds = durationSeconds(input.leaseDurationSeconds, "lease duration", false);
+		const leaseToken = ulid();
+		const now = this.timestampOffset(0);
+		const row = await this.db.updateTable("_emdash_media_usage_work").set({
+			state: "leased",
+			lease_token: leaseToken,
+			lease_expires_at: this.timestampOffset(leaseDurationSeconds),
+			last_attempted_at: now,
+			updated_at: now
+		}).where("collection_id", "=", input.collectionId).where("content_id", "=", input.contentId).where("work_version", "=", input.workVersion).where((eb) => eb.or([eb.and([eb("state", "in", ["pending", "retry"]), this.timestampIsDue("next_attempt_at")]), eb.and([
+			eb("state", "=", "leased"),
+			eb("lease_expires_at", "is not", null),
+			this.timestampIsDue("lease_expires_at")
+		])])).returningAll().executeTakeFirst();
+		return row ? rowToWork(row) : null;
+	}
+	async completeWork(input) {
+		assertLease(input);
+		const result = await this.db.deleteFrom("_emdash_media_usage_work").where("collection_id", "=", input.collectionId).where("content_id", "=", input.contentId).where("work_version", "=", input.workVersion).where("state", "=", "leased").where("lease_token", "=", input.leaseToken).where(this.leaseIsLive()).executeTakeFirst();
+		return Number(result.numDeletedRows ?? 0) > 0;
+	}
+	async deleteWorkThroughEpoch(collectionId, maxChangeEpoch) {
+		if (!collectionId) throw new Error("Media usage work cleanup requires a collection ID");
+		assertNonNegativeDecimal(maxChangeEpoch, "change epoch");
+		const result = await this.db.deleteFrom("_emdash_media_usage_work").where("collection_id", "=", collectionId).where("change_epoch", "<=", maxChangeEpoch).executeTakeFirst();
+		return Number(result.numDeletedRows ?? 0);
+	}
+	async retryWork(input) {
+		const retryDelaySeconds = durationSeconds(input.retryDelaySeconds, "retry delay", true);
+		assertErrorCode(input.errorCode);
+		return this.transitionFailure(input, "retry", { next_attempt_at: this.timestampOffset(retryDelaySeconds) });
+	}
+	async failWork(input) {
+		assertErrorCode(input.errorCode);
+		return this.transitionFailure(input, "failed");
+	}
+	async transitionFailure(input, state, extra = {}) {
+		assertLease(input);
+		const result = await this.db.updateTable("_emdash_media_usage_work").set({
+			state,
+			attempt_count: sql`attempt_count + 1`,
+			lease_token: null,
+			lease_expires_at: null,
+			last_error_code: input.errorCode,
+			updated_at: this.timestampOffset(0),
+			...extra
+		}).where("collection_id", "=", input.collectionId).where("content_id", "=", input.contentId).where("work_version", "=", input.workVersion).where("state", "=", "leased").where("lease_token", "=", input.leaseToken).where(this.leaseIsLive()).executeTakeFirst();
+		return Number(result.numUpdatedRows ?? 0) > 0;
+	}
+	leaseIsLive() {
+		return isPostgres(this.db) ? sql`lease_expires_at::timestamptz > clock_timestamp()` : sql`lease_expires_at > strftime('%Y-%m-%dT%H:%M:%fZ', 'now')`;
+	}
+	qualifiedLeaseIsLive(column) {
+		const expiry = sql.ref(column);
+		return isPostgres(this.db) ? sql`${expiry} > to_char(statement_timestamp() AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')` : sql`${expiry} > strftime('%Y-%m-%dT%H:%M:%fZ', 'now')`;
+	}
+	timestampIsDue(column) {
+		return isPostgres(this.db) ? sql`${sql.ref(column)} <= to_char(
+				statement_timestamp() AT TIME ZONE 'UTC',
+				'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"'
+			)` : sql`${sql.ref(column)} <= strftime('%Y-%m-%dT%H:%M:%fZ', 'now')`;
+	}
+	timestampOffset(offsetSeconds) {
+		if (isPostgres(this.db)) return sql`to_char(
+				(clock_timestamp() AT TIME ZONE 'UTC') + (${offsetSeconds} * INTERVAL '1 second'),
+				'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"'
+			)`;
+		return sql`strftime(
+			'%Y-%m-%dT%H:%M:%fZ',
+			'now',
+			${`${offsetSeconds >= 0 ? "+" : ""}${offsetSeconds} seconds`}
+		)`;
+	}
+};
+function operatorLimit(value) {
+	if (value === void 0) return MEDIA_USAGE_WORK_OPERATOR_DEFAULT_LIMIT;
+	if (!Number.isSafeInteger(value) || value < 1 || value > MEDIA_USAGE_WORK_OPERATOR_MAX_LIMIT) throw new Error(`Media usage operator limit must be a whole number from 1 to ${MEDIA_USAGE_WORK_OPERATOR_MAX_LIMIT}`);
+	return value;
+}
+function durationSeconds(value, label, allowZero) {
+	if (!Number.isSafeInteger(value) || value < (allowZero ? 0 : 1) || value > MAX_PORTABLE_DURATION_SECONDS) throw new Error(`Media usage work ${label} must be ${allowZero ? "a non-negative" : "a positive"} whole number of seconds no greater than one year`);
+	return value;
+}
+function assertIdentity(input) {
+	if (!input.collectionId || !input.contentId) throw new Error("Media usage work identity must include collection and content IDs");
+	if (!(typeof input.workVersion === "number" && Number.isSafeInteger(input.workVersion) && input.workVersion > 0 || typeof input.workVersion === "string" && POSITIVE_DECIMAL_PATTERN.test(input.workVersion))) throw new Error("Media usage work identity must include a work version");
+}
+function assertNonNegativeDecimal(value, label) {
+	if (!(typeof value === "number" && Number.isSafeInteger(value) && value >= 0 || typeof value === "string" && NON_NEGATIVE_DECIMAL_PATTERN.test(value))) throw new Error(`Media usage work ${label} must be a non-negative whole number`);
+}
+function assertToken(value) {
+	if (!value) throw new Error("Media usage work lease token must not be empty");
+}
+function assertLease(input) {
+	assertIdentity(input);
+	assertToken(input.leaseToken);
+}
+function assertErrorCode(value) {
+	if (!STABLE_ERROR_CODE_PATTERN.test(value)) throw new Error("Media usage work error code must use a stable SCREAMING_SNAKE_CASE value");
+}
+function rowToWork(row) {
+	if (!isMediaUsageWorkState(row.state)) throw new Error(`Invalid media usage work state: ${row.state}`);
+	return {
+		collectionId: row.collection_id,
+		collectionSlug: row.collection_slug,
+		contentId: row.content_id,
+		changeEpoch: row.change_epoch,
+		workVersion: row.work_version,
+		state: row.state,
+		attemptCount: row.attempt_count,
+		nextAttemptAt: row.next_attempt_at,
+		leaseToken: row.lease_token,
+		leaseExpiresAt: row.lease_expires_at,
+		lastAttemptedAt: row.last_attempted_at,
+		lastErrorCode: row.last_error_code,
+		createdAt: row.created_at,
+		updatedAt: row.updated_at
+	};
+}
+function rowToOperatorWork(row) {
+	const work = "collection_id" in row ? rowToWork(row) : row;
+	return {
+		collectionId: work.collectionId,
+		collectionSlug: work.collectionSlug,
+		contentId: work.contentId,
+		state: work.state,
+		attemptCount: work.attemptCount,
+		nextAttemptAt: work.nextAttemptAt,
+		leaseExpiresAt: work.leaseExpiresAt,
+		lastAttemptedAt: work.lastAttemptedAt,
+		lastErrorCode: work.lastErrorCode,
+		updatedAt: work.updatedAt
+	};
+}
+function isMediaUsageWorkState(value) {
+	return value === "pending" || value === "retry" || value === "leased" || value === "failed";
+}
+function compareDueWork(a, b) {
+	const eligibility = dueTimestamp(a).localeCompare(dueTimestamp(b));
+	if (eligibility !== 0) return eligibility;
+	const updated = a.updatedAt.localeCompare(b.updatedAt);
+	if (updated !== 0) return updated;
+	const collection = a.collectionId.localeCompare(b.collectionId);
+	return collection !== 0 ? collection : a.contentId.localeCompare(b.contentId);
+}
+function compareOperatorWork(a, b) {
+	const updated = b.updatedAt.localeCompare(a.updatedAt);
+	return updated !== 0 ? updated : b.contentId.localeCompare(a.contentId);
+}
+function dueTimestamp(work) {
+	if (work.state !== "leased") return work.nextAttemptAt;
+	if (!work.leaseExpiresAt) throw new Error("Due leased media usage work must have a lease expiry");
+	return work.leaseExpiresAt;
+}
+
+//#endregion
+export { MediaUsageWorkRepository as t };
+//# sourceMappingURL=media-usage-work-DrCbqBcl.mjs.map