emdash 0.33.0 → 0.34.0

package/dist/{index-M37iz29I.d.mts → index-C3Y-rsyN.d.mts}

@@ -1,15 +1,16 @@
-import { _ as UpdateFieldInput, f as FieldValidation, g as UpdateCollectionInput, i as CollectionWithFields, o as CreateCollectionInput, s as CreateFieldInput, t as Collection, u as Field } from "./types-BnFP1M3J.mjs";
-import { f as UpdateContentInput, i as ContentItem, l as FindManyOptions, o as ContentSeoInput, r as ContentDateField, s as CreateContentInput, t as BylineSummary, u as FindManyResult } from "./types-BGWPMiBO.mjs";
-import { d as ContentListResponse, f as ContentResponse, h as ManifestResponse, u as ApiResult } from "./options-CA4eVX6P.mjs";
-import { t as Database } from "./types-Dc4ntQjQ.mjs";
-import { At as StorageCollection, Ct as QueryOptions, Et as ResolvedPlugin, H as HttpAccess, O as CronEvent, R as EmailMessage, St as PublicPageContext, Z as MediaItem$1, _t as PluginMcpManifestConfig, bt as PortableTextBlockConfig, c as CommentBeforeCreateEvent, ct as PaginatedResult, et as PageFragmentContribution, ft as PluginCapability, gt as PluginManifest, i as CommentAfterCreateEvent, it as PageMetadataEvent, kt as SettingField, mt as PluginDefinition, o as CommentAfterModerateEvent, rt as PageMetadataContribution, tt as PageFragmentEvent, wt as RequestMeta, yt as PluginStorageConfig, z as FieldWidgetConfig, zt as WhereClause } from "./types-Cz8hNch2.mjs";
-import { _ as MediaValue, f as MediaProvider, m as MediaProviderDescriptor, p as MediaProviderCapabilities } from "./placeholder-DaeNS-VG.mjs";
-import { w as ContentBylineInput } from "./index-MGw47uWq.mjs";
-import { t as DatabaseDescriptor } from "./adapters-BMyNSSZi.mjs";
-import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-CbUcuxxc.mjs";
-import { r as ObjectCacheDescriptor } from "./types-BK6U01Ro.mjs";
-import { d as Storage } from "./types-DLG4IFEQ.mjs";
-import { i as SiteSettings, r as SiteSettingKey } from "./types-LoagAGzH.mjs";
+import { r as ContentFieldFilters } from "./content-list-query-DhQ84eVV.mjs";
+import { _ as UpdateCollectionInput, a as CollectionWithFields, c as CreateFieldInput, d as Field, p as FieldValidation, s as CreateCollectionInput, t as Collection, v as UpdateFieldInput } from "./types-C3_AbkDP.mjs";
+import { f as UpdateContentInput, i as ContentItem, l as FindManyOptions, o as ContentSeoInput, r as ContentDateField, s as CreateContentInput, t as BylineSummary, u as FindManyResult } from "./types-D4_1Ga4L.mjs";
+import { d as ContentListResponse, f as ContentResponse, h as ManifestResponse, u as ApiResult } from "./options-DRe1pIBL.mjs";
+import { t as Database } from "./types-CAGdePf3.mjs";
+import { At as SettingField, B as FieldWidgetConfig, Bt as UserInfo, Ct as PublicPageContext, Dt as ResolvedPlugin, Q as MediaItem$1, Tt as RequestMeta, U as HttpAccess, Vt as WhereClause, _t as PluginManifest, at as PageMetadataEvent, bt as PluginStorageConfig, c as CommentBeforeCreateEvent, ht as PluginDefinition, i as CommentAfterCreateEvent, it as PageMetadataContribution, jt as StorageCollection, k as CronEvent, lt as PaginatedResult, nt as PageFragmentEvent, o as CommentAfterModerateEvent, pt as PluginCapability, tt as PageFragmentContribution, vt as PluginMcpManifestConfig, wt as QueryOptions, xt as PortableTextBlockConfig, z as EmailMessage } from "./types-Cs-TFLNf.mjs";
+import { _ as MediaValue, f as MediaProvider, m as MediaProviderDescriptor, p as MediaProviderCapabilities } from "./placeholder-CzW7Lshs.mjs";
+import { T as ContentBylineInput } from "./index-Cof4-Fab.mjs";
+import { r as DatabaseDescriptor } from "./adapters-34EN2eXO.mjs";
+import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-BPuloofb.mjs";
+import { r as ObjectCacheDescriptor } from "./types-X0MThr7x.mjs";
+import { d as Storage } from "./types-CFUfyt1s.mjs";
+import { i as SiteSettings, r as SiteSettingKey } from "./types-CPx2lIGo.mjs";
 import { EmDashManifest } from "./astro/types.mjs";
 import { Dialect, Kysely, sql } from "kysely";
 import { z } from "astro/zod";
@@ -56,7 +57,7 @@ declare class ContentRepository {
    * (optionally scoped to a locale) and appends a numeric suffix (`-1`,
    * `-2`, etc.) on collision to guarantee uniqueness.
    *
-   * Returns `null` if `baseSlug` is empty after slugification.
+   * Returns null when slug normalization cannot produce a value.
    */
   generateUniqueSlug(type: string, text: string, locale?: string): Promise<string | null>;
   /**
@@ -102,6 +103,13 @@ declare class ContentRepository {
    * Update content
    */
   update(type: string, id: string, input: UpdateContentInput): Promise<ContentItem>;
+  /**
+   * Update plugin-authored fields without letting content columns diverge
+   * from the revision pointers that publication promotes.
+   */
+  updateDraftAware(type: string, id: string, input: UpdateContentInput): Promise<ContentItem>;
+  private deleteUnstagedRevision;
+  private replaceDraftRevisionForUpdate;
   /**
    * Delete content (soft delete - moves to trash)
    */
@@ -110,19 +118,6 @@ declare class ContentRepository {
    * Restore content from trash
    */
   restore(type: string, id: string): Promise<ContentItem | null>;
-  /**
-   * Re-stamp the denormalized filter + sort columns on every
-   * `content_taxonomies` pivot row for an entry from its authoritative `ec_*`
-   * row (migration 051). Called after any mutation that moves one of those
-   * columns so a taxonomy-filtered listing can seek the entry directly.
-   *
-   * A single correlated `UPDATE` reads the post-mutation values from `ec_*`, so
-   * the pivot converges to the authoritative row. This is NOT atomic with the
-   * `ec_*` mutation on D1 (no transactions), which is why the read path
-   * re-checks the real predicates on the joined `ec_*` row. Untagged entries
-   * have no pivot rows, so the statement is a cheap no-op for them.
-   */
-  private restampEntryPivot;
   /**
    * Permanently delete content (cannot be undone)
    */
@@ -171,10 +166,25 @@ declare class ContentRepository {
    * range naturally excludes never-published rows (their column is NULL).
    */
   private applyDateFilter;
+  /**
+   * Apply the optional byline filter as a correlated (NOT) EXISTS against
+   * `_emdash_content_bylines`.
+   *
+   * Correlating from the content table preserves the outer sort index so
+   * `LIMIT` can short-circuit. `mode: "none"` tests the junction rather than
+   * `primary_byline_id` because the two are written in the same call but
+   * are not atomically consistent, so the junction is authoritative.
+   *
+   * Whether a credit *renders* is locale-scoped; whether one *exists* is
+   * not. Both are needed: the first decides what the filter matches, the
+   * second decides whether the author fallback applies at all.
+   */
+  private applyBylineFilter;
   /**
    * Count content items
    */
   count(type: string, where?: FindManyOptions["where"]): Promise<number>;
+  private countWithResolvedFilters;
   /**
    * Distinct, non-null `author_id` values across the collection's live
    * (non-trashed) content. Used to populate the admin author filter with
@@ -182,11 +192,12 @@ declare class ContentRepository {
    * full user directory (which requires admin privileges to read).
    */
   findDistinctAuthorIds(type: string): Promise<string[]>;
-  getStats(type: string): Promise<{
+  getStats(type: string, now?: Date): Promise<{
     total: number;
     published: number;
     draft: number;
     scheduled: number;
+    overdueScheduled: number;
   }>;
   /**
    * Schedule content for future publishing
@@ -263,6 +274,8 @@ declare class ContentRepository {
    * Syncs the draft revision's data into the content table columns so the
    * content table always reflects the published version.
    * If no draft revision exists, creates one from current data and publishes it.
+   * When `promoteRevision` is false, publishes the current content-table data
+   * by changing lifecycle metadata only.
    *
    * `publishedAt` (optional) overrides the publication timestamp. If omitted,
    * the existing `published_at` is preserved (idempotent re-publish keeps the
@@ -274,7 +287,7 @@ declare class ContentRepository {
    * `expectedScheduledAt` additionally fences changes made after a sweep
    * selected the row but before publication preparation began.
    */
-  publish(type: string, id: string, publishedAt?: string, requireDue?: boolean, expectedScheduledAt?: string): Promise<ContentItem>;
+  publish(type: string, id: string, publishedAt?: string, requireDue?: boolean, expectedScheduledAt?: string, promoteRevision?: boolean, requireSlug?: boolean): Promise<ContentItem>;
   /**
    * Unpublish content
    *
@@ -314,11 +327,17 @@ declare class ContentRepository {
    * Excludes null values from data to match input semantics
    */
   private mapRow;
+  private normalizeFilterScalar;
+  private normalizeFieldFilter;
+  private collectionExists;
+  private resolveFieldFilters;
+  private applyFieldFilters;
   /**
    * Map order field names to database columns.
    * Only allows known fields to prevent column enumeration via crafted orderBy values.
    */
   private mapOrderField;
+  private resolveOrderField;
 }
 //#endregion
 //#region src/database/repositories/media.d.ts
@@ -693,14 +712,27 @@ interface PortableTextBlock$1 {
  */
 type ImageValue = MediaValue;
 /**
- * File field value
+ * Persisted file field value.
+ *
+ * File values are references with cached metadata, not implicitly hydrated
+ * media records. Use the media provider API when current metadata is needed.
  */
 interface FileValue {
   id: string;
-  url: string;
-  filename: string;
-  mimeType: string;
-  size: number;
+  /** Legacy cached URL. Provider-backed values commonly omit this. */
+  url?: string;
+  /** Direct URL used by external media providers. */
+  src?: string;
+  /** Cached original filename, when available. */
+  filename?: string;
+  /** Cached MIME type, when available. */
+  mimeType?: string;
+  /** Cached file size in bytes, when persisted with the value. */
+  size?: number;
+  /** Media provider ID. Defaults to `local` when omitted. */
+  provider?: string;
+  /** Provider-specific data needed to resolve or render the file. */
+  meta?: Record<string, unknown>;
 }
 //#endregion
 //#region src/fields/image.d.ts
@@ -769,6 +801,10 @@ declare function handleContentList(db: Kysely<Database>, collection: string, par
   dateField?: ContentDateField;
   dateFrom?: string;
   dateTo?: string;
+  bylines?: string[];
+  bylinesNone?: boolean;
+  includeInferredBylines?: boolean;
+  fieldFilters?: ContentFieldFilters;
 }): Promise<ApiResult<ContentListResponse>>;
 /** A content author option for the admin author filter. */
 interface ContentAuthor {
@@ -806,7 +842,7 @@ declare function handleContentGetIncludingTrashed(db: Kysely<Database>, collecti
  */
 declare function handleContentCreate(db: Kysely<Database>, collection: string, body: {
   data: Record<string, unknown>;
-  slug?: string;
+  slug?: string | null;
   status?: string;
   authorId?: string;
   bylines?: ContentBylineInput[];
@@ -826,7 +862,7 @@ declare function handleContentCreate(db: Kysely<Database>, collection: string, b
  */
 declare function handleContentUpdate(db: Kysely<Database>, collection: string, id: string, body: {
   data?: Record<string, unknown>;
-  slug?: string;
+  slug?: string | null;
   status?: string;
   authorId?: string | null;
   bylines?: ContentBylineInput[];
@@ -954,6 +990,7 @@ interface CollectionDefinition {
     label: string;
     labelSingular?: string;
     supports?: string[];
+    routable?: boolean;
   };
 }
 type CollectionMap = Record<string, CollectionDefinition>;
@@ -1046,7 +1083,7 @@ declare function handleMediaDelete(db: Kysely<Database>, id: string): Promise<Ap
 }>>;
 //#endregion
 //#region src/media/usage/content-refresh.d.ts
-type ContentMediaUsageRefreshErrorCode = "CONTENT_NOT_FOUND" | "DRAFT_REVISION_NOT_FOUND" | "DRAFT_REVISION_MISMATCH" | "DRAFT_REVISION_INVALID" | "CONTENT_USAGE_REFRESH_ERROR" | "CONTENT_USAGE_DELETE_ERROR" | "CONTENT_USAGE_GENERATION_CONFLICT" | "CONTENT_USAGE_STALE";
+type ContentMediaUsageRefreshErrorCode = "CONTENT_NOT_FOUND" | "DRAFT_REVISION_NOT_FOUND" | "DRAFT_REVISION_MISMATCH" | "DRAFT_REVISION_INVALID" | "CONTENT_USAGE_REFRESH_ERROR" | "CONTENT_USAGE_DELETE_ERROR" | "CONTENT_USAGE_GENERATION_CONFLICT" | "CONTENT_USAGE_RESOURCE_LIMIT" | "CONTENT_USAGE_STALE";
 declare function markContentMediaUsageCollectionStaleSafely(db: Kysely<Database>, collectionSlug: string, lastErrorCode: ContentMediaUsageRefreshErrorCode): Promise<boolean>;
 //#endregion
 //#region src/schema/registry.d.ts
@@ -1096,6 +1133,12 @@ declare class SchemaRegistry {
    * a manifest that is now built fresh per admin request (no cache).
    */
   listCollectionsWithFields(): Promise<CollectionWithFields[]>;
+  /**
+   * Validate `titleField`/`dateField` against the collection's fields:
+   * `titleField` must be a text-like field; `dateField` must be a `datetime` field.
+   * Only truthy values are checked (undefined = unchanged, null/"" = cleared).
+   */
+  private validateTitleDateFields;
   /**
    * Create a new collection
    */
@@ -1111,6 +1154,7 @@ declare class SchemaRegistry {
    * in parameter-safe batches.
    */
   createSeedCollection(input: Omit<CreateCollectionInput, "source">, fields: readonly CreateFieldInput[]): Promise<void>;
+  private assertSeedFieldDefinitions;
   /**
    * Update a collection
    */
@@ -1173,6 +1217,10 @@ declare class SchemaRegistry {
    * Create a content table for a collection
    */
   private createContentTable;
+  private getFieldIndexName;
+  private getLocaleFieldIndexName;
+  private createFieldIndex;
+  private dropFieldIndex;
   /**
    * Add a column to a content table
    */
@@ -1918,6 +1966,19 @@ interface EmDashConfig {
    */
   allowedOrigins?: string[];
   trustedProxyHeaders?: string[];
+  /**
+   * User middleware that wraps the complete EmDash request pipeline.
+   *
+   * Before `next()` it runs before EmDash initializes its runtime or database,
+   * so `locals.emdash`, the authenticated user, and request-scoped EmDash state
+   * are unavailable. This allows cached responses and request gates to return
+   * without paying initialization cost. When it calls `next()`, the resolved
+   * response includes EmDash HTML injection and all other response mutations,
+   * allowing the middleware to finalize caching and response headers safely.
+   */
+  middleware?: {
+    /** Astro middleware module entrypoint. */outer: string | URL;
+  };
   /**
    * Enable playground mode for ephemeral "try EmDash" sites.
    *
@@ -2126,6 +2187,8 @@ interface SandboxOptions {
   storage?: PluginCodeStorage;
   /** Database for bridge operations */
   db: Kysely<Database>;
+  /** Called immediately before a sandboxed plugin content mutation. */
+  beforeContentWrite?: () => Promise<void>;
   /** Default resource limits */
   limits?: ResourceLimits;
   /** Site info for plugin context (injected into wrapper at generation time) */
@@ -2194,7 +2257,36 @@ interface SerializedRequest {
   headers: Record<string, string>;
   /** Normalized request metadata extracted before RPC serialization */
   meta: RequestMeta;
+  /**
+   * Authenticated caller for private routes, resolved by the host before
+   * dispatch. Undefined for public routes and unbound machine tokens.
+   */
+  user?: UserInfo;
 }
+declare const SANDBOX_ROUTE_ERROR_DEFINITIONS: {
+  readonly MEDIA_USAGE_ACTIVATION_IN_PROGRESS: {
+    readonly message: "Media usage activation is in progress";
+    readonly status: 503;
+  };
+  readonly MEDIA_USAGE_ACTIVATION_CHECK_FAILED: {
+    readonly message: "Unable to verify media usage activation state";
+    readonly status: 503;
+  };
+};
+type SandboxRouteErrorCode = keyof typeof SANDBOX_ROUTE_ERROR_DEFINITIONS;
+interface SandboxRouteErrorDetails {
+  code: SandboxRouteErrorCode;
+  message: string;
+  status: 503;
+}
+interface SandboxRouteErrorEnvelope {
+  __emdashSandboxRouteError: true;
+  error: SandboxRouteErrorDetails;
+}
+declare function getSandboxRouteErrorDetails(error: unknown): SandboxRouteErrorDetails | null;
+declare function createSandboxRouteError(code: SandboxRouteErrorCode): Error & SandboxRouteErrorDetails;
+declare function createSandboxRouteErrorEnvelope(error: unknown): SandboxRouteErrorEnvelope | null;
+declare function getSandboxRouteErrorEnvelope(value: unknown): SandboxRouteErrorEnvelope | null;
 /**
  * Sandbox runner interface.
  * Platform adapters implement this to provide plugin isolation.
@@ -2330,6 +2422,7 @@ interface SiteInfoOptions {
 }
 interface PluginContextFactoryOptions {
   db: Kysely<Database>;
+  beforeContentWrite?: () => Promise<void>;
   /**
    * Resolver for the database connection, preferred over `db` when present.
    * Called per `createContext()` so connection-backed adapters (e.g. Postgres
@@ -2760,6 +2853,18 @@ interface RouteResult<T = unknown> {
   };
   status: number;
 }
+/**
+ * Host-side user shape accepted when dispatching a plugin route. Structurally
+ * matches `User` from `@emdash-cms/auth` so hosts can pass `locals.user`
+ * directly without the plugin layer depending on the auth package.
+ */
+interface RouteCallerInput {
+  id: string;
+  email: string;
+  name: string | null;
+  role: number;
+  createdAt: Date | string;
+}
 /**
  * Route invocation options
  */
@@ -2768,6 +2873,11 @@ interface InvokeRouteOptions {
   request: Request;
   /** Request body (already parsed) */
   body?: unknown;
+  /**
+   * Authenticated caller resolved by the host, exposed to the handler as
+   * `ctx.user`. Undefined for public routes and unbound machine tokens.
+   */
+  user?: UserInfo;
 }
 /**
  * Error class for plugin routes
@@ -2824,6 +2934,8 @@ interface CronScheduler {
   reschedule(): void;
   /** Register a system cleanup function to run alongside each tick. */
   setSystemCleanup(fn: SystemCleanupFn): void;
+  /** Register bounded Media Usage maintenance to run after the general tick settles. */
+  setMediaUsageMaintenance?(fn: SystemCleanupFn): void;
 }
 /**
  * System cleanup callback invoked alongside each scheduler tick.
@@ -2991,6 +3103,7 @@ interface EmDashRuntimeParts {
   pipelineFactoryOptions: {
     db: Kysely<Database>;
     getDb?: () => Kysely<Database>;
+    beforeContentWrite?: () => Promise<void>;
     storage?: Storage;
     siteInfo?: {
       siteName?: string;
@@ -3004,6 +3117,16 @@ interface EmDashRuntimeParts {
     current: HookPipeline;
   };
 }
+type MediaUsageMaintenanceTaskClass = "entry_work" | "collection_deletion" | "reconciliation";
+type MediaUsageMaintenanceResult = {
+  outcome: "inactive" | "admission_closed";
+  taskClass: null;
+  turn: null;
+} | {
+  outcome: "processed";
+  taskClass: MediaUsageMaintenanceTaskClass;
+  turn: number;
+};
 /**
  * EmDashRuntime - singleton per worker
  */
@@ -3084,6 +3207,7 @@ declare class EmDashRuntime {
    * Returns the items promoted so callers can invalidate their cache tags.
    */
   publishScheduled(): Promise<PublishedRef[]>;
+  private publishScheduledWithFence;
   /**
    * Run the full scheduled-maintenance batch: cron tasks, scheduled
    * publishing, and system cleanup. For request-less drivers — the
@@ -3103,6 +3227,7 @@ declare class EmDashRuntime {
   }): Promise<{
     published: PublishedRef[];
   }>;
+  runScheduledMediaUsageTasks(): Promise<MediaUsageMaintenanceResult>;
   /**
    * Materialize plugin-declared storage indexes, once per process.
    *
@@ -3327,6 +3452,10 @@ declare class EmDashRuntime {
     dateField?: ContentDateField;
     dateFrom?: string;
     dateTo?: string;
+    bylines?: string[];
+    bylinesNone?: boolean;
+    includeInferredBylines?: boolean;
+    fieldFilters?: ContentFieldFilters;
   }): Promise<ApiResult<ContentListResponse>>;
   handleContentAuthors(collection: string): Promise<ApiResult<{
     items: ContentAuthor[];
@@ -3346,7 +3475,7 @@ declare class EmDashRuntime {
   private hydrateDraftData;
   handleContentCreate(collection: string, body: {
     data: Record<string, unknown>;
-    slug?: string;
+    slug?: string | null;
     status?: string;
     authorId?: string;
     bylines?: Array<{
@@ -3375,7 +3504,7 @@ declare class EmDashRuntime {
   }>;
   handleContentUpdate(collection: string, id: string, body: {
     data?: Record<string, unknown>;
-    slug?: string;
+    slug?: string | null;
     status?: string;
     authorId?: string | null;
     bylines?: Array<{
@@ -3523,13 +3652,14 @@ declare class EmDashRuntime {
    * contract of `getPluginSettingsSchema` for build-time plugins.
    */
   getRuntimePluginSettingsSchema(pluginId: string): Record<string, SettingField> | null;
-  handlePluginApiRoute(pluginId: string, _method: string, path: string, request: Request): Promise<{
+  handlePluginApiRoute(pluginId: string, _method: string, path: string, request: Request, user?: RouteCallerInput | null): Promise<{
     success: boolean;
     data?: unknown;
     error?: {
       code: string;
       message: string;
     };
+    status?: number;
   }>;
   getPluginMcpTools(pluginId?: string): Promise<{
     pluginId: string;
@@ -3552,13 +3682,14 @@ declare class EmDashRuntime {
     outputSchema?: z$1.ZodType;
   }[]>;
   serializePluginMcpConsent(tools: Awaited<ReturnType<EmDashRuntime["getPluginMcpTools"]>>, pluginId: string): string;
-  handlePluginMcpTool(pluginId: string, toolName: string, route: string, input: unknown, actorId: string, request: Request): Promise<{
+  handlePluginMcpTool(pluginId: string, toolName: string, route: string, input: unknown, actorId: string, request: Request, caller?: RouteCallerInput | null): Promise<{
     success: boolean;
     data?: unknown;
     error?: {
       code: string;
       message: string;
     };
+    status?: number;
   }>;
   handlePluginMcpDenied(pluginId: string, toolName: string, route: string, actorId: string, request: Request, reason: string): Promise<void>;
   private findSandboxedPlugin;
@@ -4458,6 +4589,8 @@ interface I18nConfig {
  * Returns null if i18n is not configured.
  */
 declare function getI18nConfig(): I18nConfig | null;
+/** Resolve the locale for a new content row. */
+declare function resolveContentCreateLocale(locale: unknown, config?: I18nConfig | null): string;
 /**
  * Check if i18n is enabled.
  * Returns true when multiple locales are configured.
@@ -4814,12 +4947,12 @@ declare const pluginManifestSchema: z$1.ZodObject<{
         number: "number";
         boolean: "boolean";
         slug: "slug";
+        text: "text";
+        select: "select";
         file: "file";
         image: "image";
         datetime: "datetime";
-        text: "text";
         integer: "integer";
-        select: "select";
         multiSelect: "multiSelect";
         portableText: "portableText";
         reference: "reference";
@@ -5072,8 +5205,10 @@ declare class NodeCronScheduler implements CronScheduler {
   private timer;
   private running;
   private systemCleanup;
+  private mediaUsageMaintenance;
   constructor(executor: CronExecutor);
   setSystemCleanup(fn: SystemCleanupFn): void;
+  setMediaUsageMaintenance(fn: SystemCleanupFn): void;
   start(): void;
   stop(): void;
   reschedule(): void;
@@ -5768,8 +5903,8 @@ declare function getTaxonomyTerms(taxonomyName: string, options?: TaxonomyTermsO
  */
 declare function getTerm(taxonomyName: string, slug: string, options?: TaxonomyQueryOptions): Promise<TaxonomyTerm | null>;
 /**
- * Terms assigned to a content entry, resolved into the active locale. Terms
- * whose translation_group lacks a row in the requested locale are omitted.
+ * Terms assigned to a content entry, resolved into the active locale and then
+ * the configured default locale.
  */
 declare function getEntryTerms(collection: string, entryId: string, taxonomyName?: string, options?: TaxonomyQueryOptions): Promise<TaxonomyTerm[]>;
 /**
@@ -5875,6 +6010,8 @@ interface SearchConfig {
   enabled: boolean;
   /** Field weights for ranking (higher = more important) */
   weights?: Record<string, number>;
+  /** Field slug used as the result title, from the collection's titleField. */
+  titleField?: string;
   /** FTS5 tokenizer configuration (defaults to English Porter stemming) */
   tokenize?: SearchTokenizer;
 }
@@ -6013,6 +6150,30 @@ declare class FTSManager {
    * @param tokenize - Optional FTS5 tokenizer configuration
    */
   createFtsTable(collectionSlug: string, searchableFields: string[], _weights?: Record<string, number>, tokenize?: SearchTokenizer): Promise<void>;
+  /**
+   * SQL expression producing the indexed value for one searchable field.
+   *
+   * Portable Text fields are stored as JSON; indexing the raw JSON pollutes
+   * the index with structural tokens (`_type`, style values like `normal`,
+   * `_key` ULIDs) and makes snippets show JSON fragments. Extract the prose
+   * instead: every JSON string under a `text`, `alt`, `caption`, or `code`
+   * key (span text, image alt/caption, code blocks). This is a superset of
+   * `extractPlainText` in text-extraction.ts, which walks only known block
+   * shapes — the SQL variant takes those keys at any depth, so search and
+   * the extractPlainText consumers (vectorize/ai-search) can see different
+   * text for the same document. Only JSON documents
+   * (arrays/objects) are extracted; legacy rows holding a bare string or a
+   * JSON scalar (`Some title`, `2024`) are indexed as-is. Extraction must
+   * live in SQL because the sync triggers cannot call into JS.
+   *
+   * `ref` must be a validated column reference (`NEW.x`, `OLD.x`, `"x"`).
+   */
+  private searchValueExpr;
+  /**
+   * Field type per slug for a collection, for choosing the indexed-value
+   * expression. Fields missing from the schema fall back to raw indexing.
+   */
+  private getFieldTypes;
   /**
    * Create triggers to keep FTS table in sync with content table.
    *
@@ -6021,31 +6182,20 @@ declare class FTSManager {
    * search index and ensures the FTS row count matches the non-deleted
    * content count (which `verifyAndRepairIndex` relies on).
    *
-   * IMPORTANT: The FTS5 virtual table is created with `content='ec_<slug>'`
-   * which makes it an *external content* FTS5 table. For external-content
-   * tables, removing a row must use the documented `'delete'` command and
-   * supply the OLD column values explicitly, e.g.:
-   *
-   *     INSERT INTO fts(fts, rowid, col1, col2)
-   *     VALUES('delete', OLD.rowid, OLD.col1, OLD.col2);
-   *
-   * Using `DELETE FROM fts WHERE rowid = OLD.rowid` is the correct form
-   * for *contentless* tables but is unsafe for external-content tables:
-   * FTS5 then reads column values from the backing content table, which
-   * in an AFTER UPDATE trigger already holds the NEW values. The wrong
-   * tokens get removed and the inverted index drifts out of sync until
-   * SQLite raises `SQLITE_CORRUPT_VTAB` on the next mutation. See
-   * https://www.sqlite.org/fts5.html#external_content_tables.
-   *
-   * The UPDATE and DELETE triggers gate the `'delete'` on
-   * `OLD.deleted_at IS NULL` because the INSERT trigger never indexed
-   * rows that were already soft-deleted. Issuing `'delete'` for a rowid
-   * that was never inserted into the FTS index is itself a corruption
-   * trigger -- FTS5's `'delete'` is not a no-op on missing rowids and
-   * raises `SQLITE_CORRUPT_VTAB`. Affected paths include restore-from-
-   * trash (UPDATE where `OLD.deleted_at IS NOT NULL`), permanent-delete
-   * from trash (DELETE on a soft-deleted row), and any edit on a row
-   * that's currently in the trash.
+   * The FTS table stores its own values (no `content=` option), so removal
+   * is a plain `DELETE FROM fts WHERE rowid = OLD.rowid` — a harmless no-op
+   * for rows that were never indexed (soft-deleted content). The
+   * external-content `'delete'`-command choreography and its corruption
+   * modes (migration 039) do not apply to self-contained tables.
+   *
+   * `INSERT OR REPLACE` keeps the insert path idempotent: re-running a
+   * populate (D1 has no migration lock, so two isolates can race) converges
+   * on one index row per content row instead of failing on the rowid
+   * constraint.
+   *
+   * The trigger SQL emitted here MUST stay in lock-step with migration
+   * `064_fts_plain_text.ts`. If this changes again, add a new migration
+   * rather than editing shipped ones — migrations are forward-only.
    */
   private createTriggers;
   /**
@@ -6063,7 +6213,10 @@ declare class FTSManager {
    */
   rebuildIndex(collectionSlug: string, searchableFields: string[], weights?: Record<string, number>, tokenize?: SearchTokenizer): Promise<void>;
   /**
-   * Populate the FTS table from existing content
+   * Populate the FTS table from existing content.
+   *
+   * `INSERT OR REPLACE` so a concurrent double-populate (D1 has no
+   * migration lock) converges instead of failing on the rowid constraint.
    */
   populateFromContent(collectionSlug: string, searchableFields: string[]): Promise<void>;
   /**
@@ -6084,7 +6237,7 @@ declare class FTSManager {
    * `title` is not a system column on `ec_*` tables -- it exists only when a
    * collection defines a field with slug `title`. Search and suggestion SQL
    * that selects `c.title` must check this first; otherwise collections
-   * without a title field raise "no such column: c.title" (#1178).
+   * without a title field raise "no such column: c.title".
    */
   hasTitleColumn(collectionSlug: string): Promise<boolean>;
   /**
@@ -6241,5 +6394,5 @@ declare function extractPlainText(blocks: PortableTextBlock[] | string | null |
  */
 declare function extractSearchableFields(entry: Record<string, unknown>, fields: string[]): Record<string, string>;
 //#endregion
-export { MenuItem as $, CronScheduler as $n, handleContentPublish as $r, CollectionFilter as $t, WidgetType as A, portableTextToProsemirror as An, handleMediaDelete as Ar, createPluginManager as At, CreateTermInput as B, ProseMirrorDocument as Bn, handleContentAuthors as Br, invalidateCollectionCache as Bt, CreateWidgetInput as C, EmDashDatabaseError as Ci, WhereValue as Cn, getCollectionInfo as Cr, parseContentId as Ct, Widget as D, sanitizeHref as Dn, MediaListResponse as Dr, createNoopSandboxRunner as Dt, UpdateWidgetInput as E, isSafeHref as En, markContentMediaUsageCollectionStaleSafely as Er, SandboxNotAvailableError as Et, getTaxonomyDefs as F, PortableTextLinkMark as Fn, RevisionResponse as Fr, CachedQueryOptions as Ft, getByline as G, CreateSectionInput as Gn, handleContentDelete as Gr, invalidateTaxonomyObjectCache as Gt, TaxonomyTerm as H, ProseMirrorNode as Hn, handleContentCountScheduled as Hr, invalidateMenuObjectCache as Ht, getTaxonomyTerms as I, PortableTextMarkDef as In, handleRevisionGet as Ir, cachedQuery as It, getMenu as J, SectionSource as Jn, handleContentGet as Jr, getI18nConfig as Jt, getBylineBySlug as K, GetSectionsOptions as Kn, handleContentDiscardDraft as Kr, I18nConfig as Kt, getTerm as L, PortableTextSpan as Ln, handleRevisionList as Lr, contentNamespace as Lt, getEntriesByTerm as M, PortableTextCodeBlock as Mn, handleMediaList as Mr, pluginManifestSchema as Mt, getEntryTerms as N, PortableTextHtmlBlock as Nn, handleMediaUpdate as Nr, definePlugin as Nt, WidgetArea as O, computeContentHash as On, MediaResponse as Or, NodeCronScheduler as Ot, getTaxonomyDef as P, PortableTextImageBlock as Pn, RevisionListResponse as Pr, CacheNamespace as Pt, Menu as Q, PublishedRef as Qn, handleContentPermanentDelete as Qr, CacheHint as Qt, getTermsForEntries as R, PortableTextTextBlock as Rn, handleRevisionRestore as Rr, contentNamespaces as Rt, CreateWidgetAreaInput as S, DatabaseConfig as Si, WhereRange as Sn, StorageDescriptor as Sr, generatePreviewToken as St, ReorderWidgetsInput as T, getDb as Tn, SchemaRegistry as Tr, NoopSandboxRunner as Tt, TaxonomyTermRow as U, getSection as Un, handleContentCountTrashed as Ur, invalidateObjectCache as Ut, TaxonomyDef as V, ProseMirrorMark as Vn, handleContentCompare as Vr, invalidateCommentObjectCache as Vt, UpdateTermInput as W, getSections as Wn, handleContentCreate as Wr, invalidateSchemaObjectCache as Wt, CreateMenuInput as X, EmDashRuntime as Xn, handleContentList as Xr, WaitUntilFn as Xt, getMenus as Y, UpdateSectionInput as Yn, handleContentGetIncludingTrashed as Yr, isI18nEnabled as Yt, CreateMenuItemInput as Z, SandboxedPluginEntry as Zn, handleContentListTrashed as Zr, after as Zt, SuggestOptions as _, UserRepository as _i, createEditable as _n, EmDashConfig as _r, getPreviewUrl as _t, search as a, handleContentUpdate as ai, InferCollectionData as an, HookResult as ar, GetCommentsResult as at, getWidgetAreas as b, MediaRepository as bi, EntryData as bn, LocalStorageConfig as br, VerifyPreviewTokenOptions as bt, FTSManager as c, file as ci, TranslationsResult as cn, createUnrestrictedHttpAccess as cr, getPluginSetting as ct, SearchConfig as d, FieldUIHints as di, getEmDashEntry as dn, SandboxOptions as dr, getSiteSettings as dt, handleContentRestore as ei, CollectionResult as en, SystemCleanupFn as er, MenuItemType as et, SearchOptions as f, FileValue as fi, getTranslations as fn, SandboxRunner as fr, setSiteSettings as ft, SearchTokenizer as g, PluginStorageRepository as gi, FieldAnnotation as gn, SerializedRequest as gr, buildPreviewUrl as gt, SearchStats as h, CompoundSelectLimitedAdapter as hi, EditProxy as hn, SandboxedPluginInstance as hr, GetPreviewUrlOptions as ht, getSuggestions as i, handleContentUnschedule as ii, EntryResult as in, HookPipeline as ir, GetCommentsOptions as it, getAllTermsForEntries as j, prosemirrorToPortableText as jn, handleMediaGet as jr, ValidatedPluginManifest as jt, WidgetComponentDef as k, hashString as kn, handleMediaCreate as kr, PluginManager as kt, CollectionSearchOptions as l, image as li, getEditMeta as ln, SandboxEmailMessage as lr, getPluginSettings as lt, SearchResult as m, PortableTextBlock$1 as mi, CMSAnnotation as mn, SandboxUnavailableError as mr, isPreviewRequest as mt, extractSearchableFields as n, handleContentTranslations as ni, EditFieldMeta as nn, RouteMeta as nr, UpdateMenuInput as nt, searchCollection as o, portableText as oi, ResolvePathResult as on, createHookPipeline as or, getCommentCount as ot, SearchResponse as p, ImageValue as pi, resolveEmDashPath as pn, SandboxRunnerFactory as pr, getPreviewToken as pt, getEntriesByByline as q, Section as qn, handleContentDuplicate as qr, getFallbackChain as qt, getSearchStats as r, handleContentUnpublish as ri, EmDashCollections as rn, EmailPipeline as rr, UpdateMenuItemInput as rt, searchWithDb as s, reference as si, TranslationSummary as sn, createHttpAccess as sr, getComments as st, extractPlainText as t, handleContentSchedule as ti, ContentEntry as tn, PluginRouteError as tr, ReorderMenuItemsInput as tt, SEARCH_TOKENIZERS as u, FieldDefinition as ui, getEmDashCollection as un, SandboxEmailSendCallback as ur, getSiteSetting as ut, Suggestion as v, CreateMediaInput as vi, createNoop as vn, PluginDescriptor as vr, GeneratePreviewTokenOptions as vt, PropDef as w, emdashLoader as wn, SchemaError as wr, verifyPreviewToken as wt, getWidgetComponents as x, ContentRepository as xi, EntryFilter as xn, S3StorageConfig as xr, VerifyPreviewTokenResult as xt, getWidgetArea as y, MediaItem as yi, CollectionFilter$1 as yn, getStoredConfig as yr, PreviewTokenPayload as yt, invalidateTermCache as z, PortableTextUnknownBlock as zn, generateManifest as zr, invalidateBylineObjectCache as zt };
-//# sourceMappingURL=index-M37iz29I.d.mts.map
+export { MenuItem as $, SandboxedPluginEntry as $n, handleContentCountTrashed as $r, CacheHint as $t, WidgetType as A, MediaRepository as Ai, hashString as An, LocalStorageConfig as Ar, createPluginManager as At, CreateTermInput as B, PortableTextUnknownBlock as Bn, handleMediaDelete as Br, invalidateCollectionCache as Bt, CreateWidgetInput as C, ImageValue as Ci, WhereRange as Cn, createSandboxRouteError as Cr, parseContentId as Ct, Widget as D, UserRepository as Di, isSafeHref as Dn, EmDashConfig as Dr, createNoopSandboxRunner as Dt, UpdateWidgetInput as E, PluginStorageRepository as Ei, getDb as En, getSandboxRouteErrorEnvelope as Er, SandboxNotAvailableError as Et, getTaxonomyDefs as F, PortableTextImageBlock as Fn, SchemaRegistry as Fr, CachedQueryOptions as Ft, getByline as G, getSections as Gn, RevisionResponse as Gr, invalidateTaxonomyObjectCache as Gt, TaxonomyTerm as H, ProseMirrorMark as Hn, handleMediaList as Hr, invalidateMenuObjectCache as Ht, getTaxonomyTerms as I, PortableTextLinkMark as In, markContentMediaUsageCollectionStaleSafely as Ir, cachedQuery as It, getMenu as J, Section as Jn, handleRevisionRestore as Jr, getI18nConfig as Jt, getBylineBySlug as K, CreateSectionInput as Kn, handleRevisionGet as Kr, I18nConfig as Kt, getTerm as L, PortableTextMarkDef as Ln, MediaListResponse as Lr, contentNamespace as Lt, getEntriesByTerm as M, DatabaseConfig as Mi, prosemirrorToPortableText as Mn, StorageDescriptor as Mr, pluginManifestSchema as Mt, getEntryTerms as N, EmDashDatabaseError as Ni, PortableTextCodeBlock as Nn, getCollectionInfo as Nr, definePlugin as Nt, WidgetArea as O, CreateMediaInput as Oi, sanitizeHref as On, PluginDescriptor as Or, NodeCronScheduler as Ot, getTaxonomyDef as P, PortableTextHtmlBlock as Pn, SchemaError as Pr, CacheNamespace as Pt, Menu as Q, MediaUsageMaintenanceResult as Qn, handleContentCountScheduled as Qr, after as Qt, getTermsForEntries as R, PortableTextSpan as Rn, MediaResponse as Rr, contentNamespaces as Rt, CreateWidgetAreaInput as S, FileValue as Si, EntryFilter as Sn, SerializedRequest as Sr, generatePreviewToken as St, ReorderWidgetsInput as T, CompoundSelectLimitedAdapter as Ti, emdashLoader as Tn, getSandboxRouteErrorDetails as Tr, NoopSandboxRunner as Tt, TaxonomyTermRow as U, ProseMirrorNode as Un, handleMediaUpdate as Ur, invalidateObjectCache as Ut, TaxonomyDef as V, ProseMirrorDocument as Vn, handleMediaGet as Vr, invalidateCommentObjectCache as Vt, UpdateTermInput as W, getSection as Wn, RevisionListResponse as Wr, invalidateSchemaObjectCache as Wt, CreateMenuInput as X, UpdateSectionInput as Xn, handleContentAuthors as Xr, resolveContentCreateLocale as Xt, getMenus as Y, SectionSource as Yn, generateManifest as Yr, isI18nEnabled as Yt, CreateMenuItemInput as Z, EmDashRuntime as Zn, handleContentCompare as Zr, WaitUntilFn as Zt, SuggestOptions as _, reference as _i, FieldAnnotation as _n, SandboxRouteErrorEnvelope as _r, getPreviewUrl as _t, search as a, handleContentGetIncludingTrashed as ai, EntryResult as an, RouteMeta as ar, GetCommentsResult as at, getWidgetAreas as b, FieldDefinition as bi, CollectionFilter$1 as bn, SandboxUnavailableError as br, VerifyPreviewTokenOptions as bt, FTSManager as c, handleContentPermanentDelete as ci, TranslationSummary as cn, HookResult as cr, getPluginSetting as ct, SearchConfig as d, handleContentSchedule as di, getEmDashCollection as dn, createUnrestrictedHttpAccess as dr, getSiteSettings as dt, handleContentCreate as ei, CollectionFilter as en, PublishedRef as er, MenuItemType as et, SearchOptions as f, handleContentTranslations as fi, getEmDashEntry as fn, SandboxEmailMessage as fr, setSiteSettings as ft, SearchTokenizer as g, portableText as gi, EditProxy as gn, SandboxRouteErrorDetails as gr, buildPreviewUrl as gt, SearchStats as h, handleContentUpdate as hi, CMSAnnotation as hn, SandboxRouteErrorCode as hr, GetPreviewUrlOptions as ht, getSuggestions as i, handleContentGet as ii, EmDashCollections as in, RouteCallerInput as ir, GetCommentsOptions as it, getAllTermsForEntries as j, ContentRepository as ji, portableTextToProsemirror as jn, S3StorageConfig as jr, ValidatedPluginManifest as jt, WidgetComponentDef as k, MediaItem as ki, computeContentHash as kn, getStoredConfig as kr, PluginManager as kt, CollectionSearchOptions as l, handleContentPublish as li, TranslationsResult as ln, createHookPipeline as lr, getPluginSettings as lt, SearchResult as m, handleContentUnschedule as mi, resolveEmDashPath as mn, SandboxOptions as mr, isPreviewRequest as mt, extractSearchableFields as n, handleContentDiscardDraft as ni, ContentEntry as nn, SystemCleanupFn as nr, UpdateMenuInput as nt, searchCollection as o, handleContentList as oi, InferCollectionData as on, EmailPipeline as or, getCommentCount as ot, SearchResponse as p, handleContentUnpublish as pi, getTranslations as pn, SandboxEmailSendCallback as pr, getPreviewToken as pt, getEntriesByByline as q, GetSectionsOptions as qn, handleRevisionList as qr, getFallbackChain as qt, getSearchStats as r, handleContentDuplicate as ri, EditFieldMeta as rn, PluginRouteError as rr, UpdateMenuItemInput as rt, searchWithDb as s, handleContentListTrashed as si, ResolvePathResult as sn, HookPipeline as sr, getComments as st, extractPlainText as t, handleContentDelete as ti, CollectionResult as tn, CronScheduler as tr, ReorderMenuItemsInput as tt, SEARCH_TOKENIZERS as u, handleContentRestore as ui, getEditMeta as un, createHttpAccess as ur, getSiteSetting as ut, Suggestion as v, file as vi, createEditable as vn, SandboxRunner as vr, GeneratePreviewTokenOptions as vt, PropDef as w, PortableTextBlock$1 as wi, WhereValue as wn, createSandboxRouteErrorEnvelope as wr, verifyPreviewToken as wt, getWidgetComponents as x, FieldUIHints as xi, EntryData as xn, SandboxedPluginInstance as xr, VerifyPreviewTokenResult as xt, getWidgetArea as y, image as yi, createNoop as yn, SandboxRunnerFactory as yr, PreviewTokenPayload as yt, invalidateTermCache as z, PortableTextTextBlock as zn, handleMediaCreate as zr, invalidateBylineObjectCache as zt };
+//# sourceMappingURL=index-C3Y-rsyN.d.mts.map