emdash 0.33.0 → 0.34.0

package/src/database/types.ts

@@ -35,23 +35,11 @@ export interface TaxonomyTable {
 
 export interface ContentTaxonomyTable {
 	collection: string; // e.g., 'posts'
-	entry_id: string; // ID in the ec_* table
+	entry_id: string; // stores the ec_* row's translation_group (locale-agnostic)
 	taxonomy_id: string; // stores taxonomies.translation_group (locale-agnostic)
-	// Denormalized filter + sort columns mirrored from the entry's ec_* row
-	// (migration 051). They let a taxonomy-filtered listing seek the matching
-	// entries directly on the pivot instead of scanning the whole collection.
-	//
-	// ADVISORY, not authoritative: D1 has no transactions, so the write-path
-	// re-stamp (ContentRepository / TaxonomyRepository) is a separate statement
-	// from the ec_* mutation and can be transiently stale. The read path narrows
-	// the candidate set with these columns but re-checks the real filter
-	// predicates on the joined ec_* row. `updated_at` is deliberately NOT
-	// denormalized — it moves on every edit, so denormalizing it would force a
-	// pivot re-stamp on the common edit path for little read value.
-	//
-	// Nullable/Generated so inserts that predate a re-stamp (or the migration
-	// backfill) leave them NULL; every insert site in the repositories stamps
-	// them explicitly.
+	// Legacy denormalized columns from migration 051. A group assignment spans
+	// locale rows whose status and dates may differ, so current reads use the
+	// authoritative ec_* rows and new pivot inserts leave these nullable.
 	status: Generated<string | null>;
 	scheduled_at: Generated<string | null>;
 	deleted_at: Generated<string | null>;
@@ -102,6 +90,7 @@ export interface MediaUploadAttemptTable {
 export interface MediaUsageSourceTable {
 	source_key: string;
 	source_type: string;
+	collection_id: Generated<string | null>;
 	collection_slug: string | null;
 	content_id: string | null;
 	source_variant: string;
@@ -118,6 +107,7 @@ export interface MediaUsageSourceTable {
 	source_updated_at: Generated<string | null>;
 	source_version: Generated<number | null>;
 	source_fingerprint: Generated<string | null>;
+	identity_version: Generated<number | null>;
 	source_completeness: Generated<string>;
 	last_attempted_at: Generated<string | null>;
 	last_error_code: Generated<string | null>;
@@ -140,6 +130,44 @@ export interface MediaUsageTable {
 	media_kind: string | null;
 	mime_type: string | null;
 	created_at: Generated<string>;
+	cleanup_lease_token: Generated<string | null>;
+}
+
+export interface MediaUsageCleanupTable {
+	task_key: string;
+	lease_token: string | null;
+	lease_expires_at: string | null;
+	next_eligible_at: string;
+	cursor_created_at: string | null;
+	cursor_id: string | null;
+	scan_before_at: string | null;
+	consecutive_failures: Generated<number>;
+	last_started_at: string | null;
+	last_completed_at: string | null;
+	last_candidate_count: Generated<number>;
+	last_deleted_orphans: Generated<number>;
+	last_deleted_stale: Generated<number>;
+	last_deleted_abandoned: Generated<number>;
+	last_deleted_write_leases: Generated<number>;
+	last_backlog_lower_bound: Generated<number>;
+	last_scan_has_more: Generated<number>;
+	last_duration_ms: Generated<number>;
+	last_error_code: string | null;
+	updated_at: Generated<string>;
+}
+
+export interface MediaUsageGenerationWriteTable {
+	source_key: string;
+	generation: string;
+	lease_token: string;
+	expires_at: string;
+	created_at: Generated<string>;
+}
+
+export interface MediaUsageGenerationFenceTable {
+	task_key: string;
+	generation_floor: string;
+	updated_at: Generated<string>;
 }
 
 export interface MediaUsageIndexStatusTable {
@@ -155,6 +183,84 @@ export interface MediaUsageIndexStatusTable {
 	failed_source_count: Generated<number>;
 	last_error_code: Generated<string | null>;
 	updated_at: Generated<string>;
+	collection_id: Generated<string | null>;
+	change_epoch: Generated<number | string>;
+	reconciliation_required: Generated<number>;
+	last_incremental_success_at: Generated<string | null>;
+	capture_state: Generated<string | null>;
+}
+
+export interface MediaUsageActivationTable {
+	task_key: string;
+	state: Generated<string>;
+	runtime_generation: Generated<number>;
+	collection_cursor: Generated<string | null>;
+	drain_confirmed_at: Generated<string | null>;
+	lease_token: Generated<string | null>;
+	lease_expires_at: Generated<string | null>;
+	attempt_count: Generated<number>;
+	last_attempted_at: Generated<string | null>;
+	last_error_code: Generated<string | null>;
+	activated_at: Generated<string | null>;
+	created_at: Generated<string>;
+	updated_at: Generated<string>;
+	media_usage_maintenance_turn: Generated<number>;
+}
+
+export interface MediaUsageWorkTable {
+	collection_id: string;
+	collection_slug: string;
+	content_id: string;
+	change_epoch: number | string;
+	work_version: Generated<number | string>;
+	state: Generated<string>;
+	attempt_count: Generated<number>;
+	next_attempt_at: string;
+	lease_token: Generated<string | null>;
+	lease_expires_at: Generated<string | null>;
+	last_attempted_at: Generated<string | null>;
+	last_error_code: Generated<string | null>;
+	created_at: Generated<string>;
+	updated_at: Generated<string>;
+}
+
+export interface MediaUsageCollectionDeletionTable {
+	collection_id: string;
+	collection_slug: string;
+	force_delete: number;
+	state: Generated<string>;
+	phase: Generated<string>;
+	work_cursor: Generated<string | null>;
+	source_key: Generated<string | null>;
+	occurrence_cursor: Generated<string | null>;
+	attempt_count: Generated<number>;
+	next_attempt_at: string;
+	lease_token: Generated<string | null>;
+	lease_expires_at: Generated<string | null>;
+	last_error_code: Generated<string | null>;
+	created_at: Generated<string>;
+	updated_at: Generated<string>;
+}
+
+export interface MediaUsageReconciliationTable {
+	collection_id: string;
+	collection_slug: string;
+	run_token: string;
+	target_epoch: Generated<number | string | null>;
+	field_fingerprint: Generated<string | null>;
+	state: Generated<string>;
+	phase: Generated<string>;
+	scan_cursor: Generated<string | null>;
+	scan_upper_id: Generated<string | null>;
+	source_cursor: Generated<string | null>;
+	source_upper_key: Generated<string | null>;
+	attempt_count: Generated<number>;
+	next_attempt_at: string;
+	lease_token: Generated<string | null>;
+	lease_expires_at: Generated<string | null>;
+	last_error_code: Generated<string | null>;
+	created_at: Generated<string>;
+	updated_at: Generated<string>;
 }
 
 export interface UserTable {
@@ -309,11 +415,15 @@ export interface CollectionTable {
 	label_singular: string | null;
 	description: string | null;
 	icon: string | null;
+	admin_config: Generated<string | null>; // JSON: { listColumns?: string[] }
 	supports: string | null; // JSON array
 	source: string | null;
 	search_config: string | null; // JSON: SearchConfig
 	has_seo: number; // 0 or 1 — opt-in SEO fields for this collection
+	title_field: string | null; // field slug for the admin list Title column (NULL = default)
+	date_field: string | null; // field slug (datetime) for the admin list Date column (NULL = default)
 	url_pattern: string | null; // URL pattern with {slug} placeholder (e.g. "/blog/{slug}")
+	routable: Generated<number>; // 0 or 1 — published entries require a slug when enabled
 	hidden: Generated<number>; // 0 or 1 — omit the auto-generated admin sidebar entry
 	sort_order: number | null; // explicit admin sidebar position; NULL = alphabetical fallback
 	comments_enabled: Generated<number>; // 0 or 1
@@ -351,6 +461,7 @@ export interface FieldTable {
 	options: string | null; // JSON
 	sort_order: number;
 	searchable: Generated<number>; // boolean as 0/1, defaults to 0
+	indexed: Generated<number>; // boolean as 0/1, defaults to 0
 	translatable: Generated<number>; // boolean as 0/1, defaults to 1
 	created_at: Generated<string>;
 }
@@ -519,7 +630,14 @@ export interface Database {
 	_emdash_media_upload_attempts: MediaUploadAttemptTable;
 	_emdash_media_usage_sources: MediaUsageSourceTable;
 	_emdash_media_usage: MediaUsageTable;
+	_emdash_media_usage_cleanup: MediaUsageCleanupTable;
+	_emdash_media_usage_generation_writes: MediaUsageGenerationWriteTable;
+	_emdash_media_usage_cleanup_fence: MediaUsageGenerationFenceTable;
 	_emdash_media_usage_index_status: MediaUsageIndexStatusTable;
+	_emdash_media_usage_activation: MediaUsageActivationTable;
+	_emdash_media_usage_work: MediaUsageWorkTable;
+	_emdash_media_usage_collection_deletions: MediaUsageCollectionDeletionTable;
+	_emdash_media_usage_reconciliations: MediaUsageReconciliationTable;
 	users: UserTable;
 	credentials: CredentialTable;
 	auth_tokens: AuthTokenTable;

package/src/db/adapters.ts

@@ -26,6 +26,32 @@
  */
 export type DatabaseDialectType = "sqlite" | "postgres";
 
+export type CollectionDeletionGuardInput =
+	| {
+			action: "fence";
+			collectionId: string;
+			collectionSlug: string;
+			leaseToken: string;
+			forceDelete: boolean;
+	  }
+	| {
+			action: "drop";
+			collectionId: string;
+			collectionSlug: string;
+			leaseToken: string;
+	  };
+
+export type CollectionDeletionGuardResult =
+	| { outcome: "fenced" }
+	| { outcome: "has_content" }
+	| { outcome: "stale" }
+	| { outcome: "dropped" };
+
+export type ExecuteCollectionDeletionGuard = (
+	config: unknown,
+	input: CollectionDeletionGuardInput,
+) => Promise<CollectionDeletionGuardResult>;
+
 /**
  * Database descriptor - serializable config for virtual modules
  */
@@ -65,6 +91,8 @@ export interface DatabaseDescriptor {
 	 * inspecting an optional entrypoint export.
 	 */
 	supportsCoalescing?: boolean;
+	/** The runtime entrypoint exports the deletion-specific atomic guard. */
+	supportsCollectionDeletionGuard?: boolean;
 }
 
 export interface SqliteConfig {

package/src/db/index.ts

@@ -26,6 +26,9 @@ export type {
 	SqliteConfig,
 	LibsqlConfig,
 	PostgresConfig,
+	CollectionDeletionGuardInput,
+	CollectionDeletionGuardResult,
+	ExecuteCollectionDeletionGuard,
 } from "./adapters.js";
 
 // Migration utilities (used by playground, preview, and custom deployment scripts)