emdash 0.33.0 → 0.35.0

package/dist/{index-M37iz29I.d.mts → index-BVBZj4-7.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-wJ2WN8Vp.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-C2pMvO62.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-DN64_zzZ.mjs";
+import { d as ContentListResponse, f as ContentResponse, h as ManifestResponse, u as ApiResult } from "./options--hhz-jZ1.mjs";
+import { t as Database } from "./types-DQIDRKF2.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-DrJrVCT1.mjs";
+import { _ as MediaValue, f as MediaProvider, m as MediaProviderDescriptor, p as MediaProviderCapabilities } from "./placeholder-Dp0K3RkD.mjs";
+import { T as ContentBylineInput } from "./index-C9KuQyO-.mjs";
+import { r as DatabaseDescriptor } from "./adapters-Bb1vG41D.mjs";
+import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-DWRhk9xZ.mjs";
+import { r as ObjectCacheDescriptor } from "./types-Dfk8KI5R.mjs";
+import { d as Storage } from "./types-BcqdcT-r.mjs";
+import { i as SiteSettings, r as SiteSettingKey } from "./types-BntycPTF.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
    */
@@ -1264,6 +1312,13 @@ declare class SchemaRegistry {
  */
 declare function getCollectionInfo(slug: string): Promise<Collection | null>;
 //#endregion
+//#region src/database/migrations/policy.d.ts
+type RuntimeMigrationMode = "auto" | "check" | "manual";
+interface RuntimeMigrationConfig {
+  runtime: RuntimeMigrationMode;
+  dev?: RuntimeMigrationMode;
+}
+//#endregion
 //#region src/registry/types.d.ts
 /**
  * Public types for the experimental plugin registry.
@@ -1655,6 +1710,8 @@ interface EmDashConfig {
    * ```
    */
   database?: DatabaseDescriptor;
+  /** Core database migration behavior at runtime. Defaults to `auto`. */
+  migrations?: RuntimeMigrationConfig;
   /**
    * Storage configuration (for media)
    */
@@ -1918,6 +1975,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 +2196,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 +2266,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 +2431,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 +2862,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 +2882,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 +2943,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.
@@ -2928,6 +3049,8 @@ type CreateSchedulerFn = (executor: CronExecutor) => CronScheduler;
  */
 interface RuntimeDependencies {
   config: EmDashConfig;
+  /** Effective migration mode, resolved once by the runtime entrypoint. */
+  migrationMode?: RuntimeMigrationMode;
   plugins: ResolvedPlugin[];
   createDialect: (config: any) => Dialect;
   /**
@@ -2991,6 +3114,7 @@ interface EmDashRuntimeParts {
   pipelineFactoryOptions: {
     db: Kysely<Database>;
     getDb?: () => Kysely<Database>;
+    beforeContentWrite?: () => Promise<void>;
     storage?: Storage;
     siteInfo?: {
       siteName?: string;
@@ -3004,6 +3128,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 +3218,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 +3238,7 @@ declare class EmDashRuntime {
   }): Promise<{
     published: PublishedRef[];
   }>;
+  runScheduledMediaUsageTasks(): Promise<MediaUsageMaintenanceResult>;
   /**
    * Materialize plugin-declared storage indexes, once per process.
    *
@@ -3327,6 +3463,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 +3486,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 +3515,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 +3663,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 +3693,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;
@@ -4440,36 +4582,6 @@ type WaitUntilFn = (promise: Promise<unknown>) => void;
  */
 declare function after(fn: () => void | Promise<void>): void;
 //#endregion
-//#region src/i18n/config.d.ts
-/**
- * EmDash i18n Configuration
- *
- * Reads locale configuration from the virtual module (sourced from Astro config).
- * Initialized during runtime startup, then available via getI18nConfig().
- */
-interface I18nConfig {
-  defaultLocale: string;
-  locales: string[];
-  fallback?: Record<string, string>;
-  prefixDefaultLocale?: boolean;
-}
-/**
- * Get the current i18n config.
- * Returns null if i18n is not configured.
- */
-declare function getI18nConfig(): I18nConfig | null;
-/**
- * Check if i18n is enabled.
- * Returns true when multiple locales are configured.
- */
-declare function isI18nEnabled(): boolean;
-/**
- * Resolve fallback locale chain for a given locale.
- * Returns array of locales to try, from most preferred to least.
- * Always ends with defaultLocale.
- */
-declare function getFallbackChain(locale: string): string[];
-//#endregion
 //#region src/object-cache/index.d.ts
 /** Options for {@link cachedQuery}. */
 interface CachedQueryOptions<T> {
@@ -4813,13 +4925,13 @@ declare const pluginManifestSchema: z$1.ZodObject<{
         string: "string";
         number: "number";
         boolean: "boolean";
-        slug: "slug";
         file: "file";
-        image: "image";
+        slug: "slug";
         datetime: "datetime";
         text: "text";
-        integer: "integer";
         select: "select";
+        image: "image";
+        integer: "integer";
         multiSelect: "multiSelect";
         portableText: "portableText";
         reference: "reference";
@@ -5072,8 +5184,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 +5882,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 +5989,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 +6129,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 +6161,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 +6192,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 +6216,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 +6373,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 $, RouteCallerInput as $n, handleContentGet as $r, EmDashCollections as $t, WidgetType as A, PortableTextImageBlock as An, SchemaRegistry as Ar, createPluginManager as At, CreateTermInput as B, getSections as Bn, RevisionResponse as Br, invalidateCollectionCache as Bt, CreateWidgetInput as C, CreateMediaInput as Ci, sanitizeHref as Cn, PluginDescriptor as Cr, parseContentId as Ct, Widget as D, DatabaseConfig as Di, prosemirrorToPortableText as Dn, StorageDescriptor as Dr, createNoopSandboxRunner as Dt, UpdateWidgetInput as E, ContentRepository as Ei, portableTextToProsemirror as En, S3StorageConfig as Er, SandboxNotAvailableError as Et, getTaxonomyDefs as F, PortableTextUnknownBlock as Fn, handleMediaDelete as Fr, CachedQueryOptions as Ft, getByline as G, UpdateSectionInput as Gn, handleContentAuthors as Gr, invalidateTaxonomyObjectCache as Gt, TaxonomyTerm as H, GetSectionsOptions as Hn, handleRevisionList as Hr, invalidateMenuObjectCache as Ht, getTaxonomyTerms as I, ProseMirrorDocument as In, handleMediaGet as Ir, cachedQuery as It, getMenu as J, SandboxedPluginEntry as Jn, handleContentCountTrashed as Jr, CacheHint as Jt, getBylineBySlug as K, EmDashRuntime as Kn, handleContentCompare as Kr, WaitUntilFn as Kt, getTerm as L, ProseMirrorMark as Ln, handleMediaList as Lr, contentNamespace as Lt, getEntriesByTerm as M, PortableTextMarkDef as Mn, MediaListResponse as Mr, pluginManifestSchema as Mt, getEntryTerms as N, PortableTextSpan as Nn, MediaResponse as Nr, definePlugin as Nt, WidgetArea as O, EmDashDatabaseError as Oi, PortableTextCodeBlock as On, getCollectionInfo as Or, NodeCronScheduler as Ot, getTaxonomyDef as P, PortableTextTextBlock as Pn, handleMediaCreate as Pr, CacheNamespace as Pt, Menu as Q, PluginRouteError as Qn, handleContentDuplicate as Qr, EditFieldMeta as Qt, getTermsForEntries as R, ProseMirrorNode as Rn, handleMediaUpdate as Rr, contentNamespaces as Rt, CreateWidgetAreaInput as S, UserRepository as Si, isSafeHref as Sn, EmDashConfig as Sr, generatePreviewToken as St, ReorderWidgetsInput as T, MediaRepository as Ti, hashString as Tn, LocalStorageConfig as Tr, NoopSandboxRunner as Tt, TaxonomyTermRow as U, Section as Un, handleRevisionRestore as Ur, invalidateObjectCache as Ut, TaxonomyDef as V, CreateSectionInput as Vn, handleRevisionGet as Vr, invalidateCommentObjectCache as Vt, UpdateTermInput as W, SectionSource as Wn, generateManifest as Wr, invalidateSchemaObjectCache as Wt, CreateMenuInput as X, CronScheduler as Xn, handleContentDelete as Xr, CollectionResult as Xt, getMenus as Y, PublishedRef as Yn, handleContentCreate as Yr, CollectionFilter as Yt, CreateMenuItemInput as Z, SystemCleanupFn as Zn, handleContentDiscardDraft as Zr, ContentEntry as Zt, SuggestOptions as _, FileValue as _i, EntryFilter as _n, SerializedRequest as _r, getPreviewUrl as _t, search as a, handleContentRestore as ai, getEditMeta as an, createHttpAccess as ar, GetCommentsResult as at, getWidgetAreas as b, CompoundSelectLimitedAdapter as bi, emdashLoader as bn, getSandboxRouteErrorDetails as br, VerifyPreviewTokenOptions as bt, FTSManager as c, handleContentUnpublish as ci, getTranslations as cn, SandboxEmailSendCallback as cr, getPluginSetting as ct, SearchConfig as d, portableText as di, EditProxy as dn, SandboxRouteErrorDetails as dr, getSiteSettings as dt, handleContentGetIncludingTrashed as ei, EntryResult as en, RouteMeta as er, MenuItemType as et, SearchOptions as f, reference as fi, FieldAnnotation as fn, SandboxRouteErrorEnvelope as fr, setSiteSettings as ft, SearchTokenizer as g, FieldUIHints as gi, EntryData as gn, SandboxedPluginInstance as gr, buildPreviewUrl as gt, SearchStats as h, FieldDefinition as hi, CollectionFilter$1 as hn, SandboxUnavailableError as hr, GetPreviewUrlOptions as ht, getSuggestions as i, handleContentPublish as ii, TranslationsResult as in, createHookPipeline as ir, GetCommentsOptions as it, getAllTermsForEntries as j, PortableTextLinkMark as jn, markContentMediaUsageCollectionStaleSafely as jr, ValidatedPluginManifest as jt, WidgetComponentDef as k, PortableTextHtmlBlock as kn, SchemaError as kr, PluginManager as kt, CollectionSearchOptions as l, handleContentUnschedule as li, resolveEmDashPath as ln, SandboxOptions as lr, getPluginSettings as lt, SearchResult as m, image as mi, createNoop as mn, SandboxRunnerFactory as mr, isPreviewRequest as mt, extractSearchableFields as n, handleContentListTrashed as ni, ResolvePathResult as nn, HookPipeline as nr, UpdateMenuInput as nt, searchCollection as o, handleContentSchedule as oi, getEmDashCollection as on, createUnrestrictedHttpAccess as or, getCommentCount as ot, SearchResponse as p, file as pi, createEditable as pn, SandboxRunner as pr, getPreviewToken as pt, getEntriesByByline as q, MediaUsageMaintenanceResult as qn, handleContentCountScheduled as qr, after as qt, getSearchStats as r, handleContentPermanentDelete as ri, TranslationSummary as rn, HookResult as rr, UpdateMenuItemInput as rt, searchWithDb as s, handleContentTranslations as si, getEmDashEntry as sn, SandboxEmailMessage as sr, getComments as st, extractPlainText as t, handleContentList as ti, InferCollectionData as tn, EmailPipeline as tr, ReorderMenuItemsInput as tt, SEARCH_TOKENIZERS as u, handleContentUpdate as ui, CMSAnnotation as un, SandboxRouteErrorCode as ur, getSiteSetting as ut, Suggestion as v, ImageValue as vi, WhereRange as vn, createSandboxRouteError as vr, GeneratePreviewTokenOptions as vt, PropDef as w, MediaItem as wi, computeContentHash as wn, getStoredConfig as wr, verifyPreviewToken as wt, getWidgetComponents as x, PluginStorageRepository as xi, getDb as xn, getSandboxRouteErrorEnvelope as xr, VerifyPreviewTokenResult as xt, getWidgetArea as y, PortableTextBlock$1 as yi, WhereValue as yn, createSandboxRouteErrorEnvelope as yr, PreviewTokenPayload as yt, invalidateTermCache as z, getSection as zn, RevisionListResponse as zr, invalidateBylineObjectCache as zt };
+//# sourceMappingURL=index-BVBZj4-7.d.mts.map