emdash 1.1.0 → 1.2.0

package/dist/wxr-taxonomies-BxI0CbTg.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wxr-taxonomies-BxI0CbTg.mjs","names":[],"sources":["../src/import/wxr-taxonomies.ts"],"sourcesContent":["/**\n * WXR taxonomy import helpers.\n *\n * Bridges parsed WordPress taxonomy data (`WxrCategory`, `WxrTag`, `WxrTerm`,\n * and per-item `WxrPost.categories` / `WxrPost.tags` / `WxrPost.customTaxonomies`)\n * onto EmDash's term + content_taxonomies tables.\n *\n * Why this isn't inline in `execute.ts`: pre-creating all terms before any\n * post is created lets us (a) build a lookup once for every (taxonomy, slug)\n * the import needs, and (b) keep the per-post attachment loop cheap. It also\n * makes the logic testable without spinning up an Astro request.\n *\n * Behaviour:\n *   - `wp:category` -> EmDash `category` taxonomy (seeded by migration 006).\n *   - `wp:tag`      -> EmDash `tag` taxonomy.\n *   - `wp:term`     -> matching EmDash taxonomy by `name` (case-sensitive).\n *                      If the taxonomy isn't defined in any locale, the\n *                      term is skipped — we don't auto-create defs because\n *                      the user controls their schema through the admin.\n *   - Terms are created idempotently by `(taxonomy, slug, locale)`. Existing\n *     terms are reused.\n *   - Assignments respect the def's `collections` array. If the post's target\n *     collection isn't listed on the taxonomy def, the assignment is skipped\n *     (matches admin UI behaviour: you can't tag a \"products\" post with a\n *     \"category\" if `category.collections` only includes \"posts\").\n */\n\nimport type { Kysely } from \"kysely\";\n\nimport type { WxrCategory, WxrPost, WxrTag, WxrTerm } from \"../cli/wxr/parser.js\";\nimport {\n\tfindTaxonomyStructure,\n\tselectTaxonomyDefs,\n} from \"../database/repositories/taxonomy-def.js\";\nimport { TaxonomyRepository } from \"../database/repositories/taxonomy.js\";\nimport type { Database } from \"../database/types.js\";\nimport { invalidateTermCache } from \"../taxonomies/index.js\";\n\n/**\n * Thrown by `mirrorTermsToLocales` when a pre-existing locale row at the\n * same `(taxonomy, slug)` belongs to a different `translation_group` than\n * the canonical term. Callers in the route layer surface\n * `publicMessage` to the operator (no internal data) while logging\n * `cause` server-side.\n *\n * Marker class so the route layer can distinguish \"operator-actionable\n * taxonomy conflict\" from any other DB / repository error that might\n * escape the helper.\n */\nexport class WxrTaxonomyConflictError extends Error {\n\treadonly publicMessage: string;\n\tconstructor(publicMessage: string, options?: { cause?: unknown }) {\n\t\tsuper(publicMessage, options);\n\t\tthis.name = \"WxrTaxonomyConflictError\";\n\t\tthis.publicMessage = publicMessage;\n\t}\n}\n\nexport function isWxrTaxonomyConflictError(error: unknown): error is WxrTaxonomyConflictError {\n\treturn error instanceof WxrTaxonomyConflictError;\n}\n\n/**\n * Result of pre-importing taxonomy terms from a WXR file.\n */\nexport interface TaxonomyImportPlan {\n\t/** terms created during this run (per taxonomy name) */\n\ttermsCreated: Record<string, number>;\n\t/** terms that already existed and were reused (per taxonomy name) */\n\ttermsReused: Record<string, number>;\n\t/** custom taxonomies (`wp:term`) skipped because no matching EmDash def exists */\n\tmissingTaxonomies: string[];\n\t/**\n\t * Lookup table: `taxonomy name` -> `term slug` -> term id.\n\t * Used by `attachPostTaxonomies` to translate WXR assignments into pivot rows.\n\t */\n\ttermIdByNameAndSlug: Map<string, Map<string, string>>;\n\t/**\n\t * Lookup table: `taxonomy name` -> set of collection slugs the def allows.\n\t * Empty (or missing) means \"any collection\" — we only enforce the filter\n\t * when the def explicitly lists collections.\n\t */\n\tcollectionsByTaxonomy: Map<string, Set<string>>;\n\t/**\n\t * Lookup table: `term id` -> the term's `translation_group` (or `null`\n\t * if the term doesn't exist any more). Populated lazily by helpers that\n\t * need to check pivot existence without repeating per-term DB reads.\n\t */\n\ttranslationGroupByTermId: Map<string, string | null>;\n}\n\n/**\n * Track running counts plus the lookup maps.\n */\ninterface TaxonomyImportState {\n\tplan: TaxonomyImportPlan;\n}\n\nfunction makeState(): TaxonomyImportState {\n\treturn {\n\t\tplan: {\n\t\t\ttermsCreated: {},\n\t\t\ttermsReused: {},\n\t\t\tmissingTaxonomies: [],\n\t\t\ttermIdByNameAndSlug: new Map(),\n\t\t\tcollectionsByTaxonomy: new Map(),\n\t\t\ttranslationGroupByTermId: new Map(),\n\t\t},\n\t};\n}\n\n/**\n * Record-keeping helpers — keep mutations centralised so the result object\n * stays consistent.\n */\nfunction bump(record: Record<string, number>, key: string): void {\n\trecord[key] = (record[key] ?? 0) + 1;\n}\n\nfunction rememberTerm(\n\tstate: TaxonomyImportState,\n\ttaxonomyName: string,\n\tslug: string,\n\ttermId: string,\n): void {\n\tlet bySlug = state.plan.termIdByNameAndSlug.get(taxonomyName);\n\tif (!bySlug) {\n\t\tbySlug = new Map();\n\t\tstate.plan.termIdByNameAndSlug.set(taxonomyName, bySlug);\n\t}\n\tbySlug.set(slug, termId);\n}\n\nfunction parseDefCollections(raw: string | null): string[] {\n\tif (!raw) return [];\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(raw);\n\t\tif (Array.isArray(parsed)) {\n\t\t\treturn parsed.filter((c): c is string => typeof c === \"string\");\n\t\t}\n\t} catch {\n\t\t// malformed JSON in the def -- treat as \"no collection filter\"\n\t}\n\treturn [];\n}\n\n/**\n * Rebuild the taxonomy lookup maps from the database without creating\n * anything. The chunked WP import runs term creation once (first content\n * chunk); every later chunk only needs the maps to attach per-post\n * assignments, and two SELECTs are far cheaper than re-walking every term\n * through the ensure path.\n *\n * ponytail: first row wins per (name, slug), ordered by locale asc — the\n * same row `findBySlug` without a locale resolves to. Per-locale term\n * variants beyond that are the mirror pass's job, not the importer's.\n */\nexport async function loadTaxonomyPlanFromDb(db: Kysely<Database>): Promise<TaxonomyImportPlan> {\n\tconst state = makeState();\n\n\tconst defs = await selectTaxonomyDefs(db).orderBy(\"d.locale\", \"asc\").execute();\n\tfor (const def of defs) {\n\t\tif (!state.plan.collectionsByTaxonomy.has(def.name)) {\n\t\t\tstate.plan.collectionsByTaxonomy.set(def.name, new Set(parseDefCollections(def.collections)));\n\t\t}\n\t}\n\n\tconst terms = await db\n\t\t.selectFrom(\"taxonomies\")\n\t\t.select([\"name\", \"slug\", \"id\"])\n\t\t.orderBy(\"locale\", \"asc\")\n\t\t.execute();\n\tfor (const term of terms) {\n\t\tif (!state.plan.termIdByNameAndSlug.get(term.name)?.has(term.slug)) {\n\t\t\trememberTerm(state, term.name, term.slug, term.id);\n\t\t}\n\t}\n\n\treturn state.plan;\n}\n\ninterface TermDescriptor {\n\ttaxonomyName: string;\n\tslug: string;\n\tlabel: string;\n\tdescription?: string;\n}\n\nfunction termKey(taxonomyName: string, slug: string): string {\n\treturn `${taxonomyName}\\u0000${slug}`;\n}\n\n/**\n * Find or create many terms in a small number of batched SELECTs instead of\n * one SELECT per term. This is the dominant fixed cost for WXR imports with\n * large category/tag vocabularies: a site with 100+ categories would otherwise\n * spend one D1 round-trip per category before writing any posts.\n *\n * Batching rules:\n *   - Descriptors already resolved in `state.plan.termIdByNameAndSlug` are\n *     skipped (same idempotency as the old per-term loop).\n *   - Remaining descriptors are deduplicated by `(taxonomy, slug)`; the first\n *     label/description seen wins, matching the old behaviour where the first\n *     `ensureTerm` call cached the id.\n *   - One batched SELECT resolves existing rows at the requested locale.\n *   - One batched SELECT resolves any-locale rows for use as `translationOf`.\n *   - Missing rows are still created one at a time because each insert needs\n *     its own ULID/translation_group/sort_order bookkeeping, but the reads are\n *     where the round-trip bottleneck lives.\n */\nasync function ensureTermsBatch(\n\tdb: Kysely<Database>,\n\tstate: TaxonomyImportState,\n\tdescriptors: TermDescriptor[],\n\tlocale: string | undefined,\n): Promise<void> {\n\tif (descriptors.length === 0) return;\n\n\tconst repo = new TaxonomyRepository(db);\n\n\tconst needed: TermDescriptor[] = [];\n\tconst seenKeys = new Set<string>();\n\tfor (const d of descriptors) {\n\t\tif (state.plan.termIdByNameAndSlug.get(d.taxonomyName)?.has(d.slug)) continue;\n\t\tconst key = termKey(d.taxonomyName, d.slug);\n\t\tif (seenKeys.has(key)) continue;\n\t\tseenKeys.add(key);\n\t\tneeded.push(d);\n\t}\n\tif (needed.length === 0) return;\n\n\t// Resolve existing rows at the requested locale in one round-trip.\n\tconst existingAtLocale = await findExistingTerms(db, needed, locale);\n\tfor (const row of existingAtLocale) {\n\t\tbump(state.plan.termsReused, row.name);\n\t\trememberTerm(state, row.name, row.slug, row.id);\n\t}\n\n\t// Build the list of descriptors that still need creation.\n\tconst stillNeeded: TermDescriptor[] = [];\n\tfor (const d of needed) {\n\t\tif (!state.plan.termIdByNameAndSlug.get(d.taxonomyName)?.has(d.slug)) {\n\t\t\tstillNeeded.push(d);\n\t\t}\n\t}\n\tif (stillNeeded.length === 0) return;\n\n\t// Resolve any-locale rows once for translationOf linking.\n\tconst anyLocaleRows = await findExistingTerms(db, stillNeeded, undefined);\n\tconst translationOfByKey = new Map<string, string>();\n\tfor (const row of anyLocaleRows) {\n\t\tconst key = termKey(row.name, row.slug);\n\t\tif (!translationOfByKey.has(key)) translationOfByKey.set(key, row.id);\n\t}\n\n\tfor (const d of stillNeeded) {\n\t\tconst created = await repo.create({\n\t\t\tname: d.taxonomyName,\n\t\t\tslug: d.slug,\n\t\t\tlabel: d.label,\n\t\t\tdata: d.description ? { description: d.description } : undefined,\n\t\t\tlocale,\n\t\t\ttranslationOf: translationOfByKey.get(termKey(d.taxonomyName, d.slug)),\n\t\t});\n\t\tbump(state.plan.termsCreated, d.taxonomyName);\n\t\trememberTerm(state, d.taxonomyName, d.slug, created.id);\n\t}\n}\n\n/**\n * Batched lookup of term rows for a list of `(taxonomy, slug)` pairs.\n * Chunks at `SQL_BATCH_SIZE / 2` because each pair consumes two bind\n * parameters (`name` and `slug`). When `locale` is omitted, returns rows\n * for all locales ordered by locale ascending so callers can pick the first\n * row per pair (mirroring `TaxonomyRepository.findBySlug` without a locale\n * argument).\n */\nasync function findExistingTerms(\n\tdb: Kysely<Database>,\n\tdescriptors: TermDescriptor[],\n\tlocale: string | undefined,\n): Promise<Array<{ id: string; name: string; slug: string }>> {\n\tconst { chunks, SQL_BATCH_SIZE } = await import(\"../utils/chunks.js\");\n\tconst rows: Array<{ id: string; name: string; slug: string }> = [];\n\tconst seenKeys = new Set<string>();\n\n\t// Each pair uses 2 bind params, so limit each batch to SQL_BATCH_SIZE / 2 pairs.\n\tfor (const batch of chunks(descriptors, Math.floor(SQL_BATCH_SIZE / 2))) {\n\t\tconst batchRows = await db\n\t\t\t.selectFrom(\"taxonomies\")\n\t\t\t.select([\"id\", \"name\", \"slug\"])\n\t\t\t.where((eb) =>\n\t\t\t\teb.or(batch.map((d) => eb.and([eb(\"name\", \"=\", d.taxonomyName), eb(\"slug\", \"=\", d.slug)]))),\n\t\t\t)\n\t\t\t.$if(locale !== undefined, (qb) => qb.where(\"locale\", \"=\", locale!))\n\t\t\t.orderBy(\"locale\", \"asc\")\n\t\t\t.execute();\n\n\t\tfor (const row of batchRows) {\n\t\t\tconst key = termKey(row.name, row.slug);\n\t\t\tif (seenKeys.has(key)) continue;\n\t\t\tseenKeys.add(key);\n\t\t\trows.push(row);\n\t\t}\n\t}\n\n\treturn rows;\n}\n\n/**\n * Retrieve the human label captured by the parser for a per-item\n * `<category>` text body, falling back to the slug when the parser didn't\n * see a label (e.g. self-closing tags or whitespace-only bodies).\n */\nfunction labelFor(post: WxrPost, taxonomy: string, slug: string): string {\n\tconst key = `${taxonomy}\\u0000${slug}`;\n\treturn post.taxonomyLabels?.get(key) ?? slug;\n}\n\n/**\n * Pre-import every term referenced by the WXR file.\n *\n * Pass 1: `wp:category` blocks. Each becomes a term in EmDash's seeded\n *         `category` taxonomy.\n * Pass 2: `wp:tag` blocks. Each becomes a term in `tag`.\n * Pass 3: `wp:term` blocks (custom taxonomies). Skipped when no matching\n *         EmDash def exists.\n * Pass 4: per-item `<category domain=\"…\" nicename=\"…\">` assignments. WXR\n *         exports sometimes reference taxonomies/terms that weren't declared\n *         at the top level (older exports especially), so we backfill terms\n *         from per-item assignments. Categories and tags use the seeded defs\n *         and pick up the assignment text as the label; custom domains fall\n *         back to the same \"def must exist\" rule.\n */\nexport async function preImportWxrTaxonomies(\n\tdb: Kysely<Database>,\n\tposts: WxrPost[],\n\tcategories: WxrCategory[],\n\ttags: WxrTag[],\n\tterms: WxrTerm[],\n\tlocale: string | undefined,\n): Promise<TaxonomyImportPlan> {\n\tconst state = makeState();\n\n\t// Cache def lookups for the duration of the import. Keyed by name; value\n\t// is `null` when we've already determined the taxonomy is missing (so we\n\t// only report the \"missing\" warning once per taxonomy).\n\tconst defCache = new Map<string, { id: string; collections: string[] } | null>();\n\tconst lookupDef = async (name: string): Promise<{ id: string; collections: string[] } | null> => {\n\t\tif (defCache.has(name)) return defCache.get(name) ?? null;\n\t\t// A taxonomy's structure is the same in every locale, so a definition in\n\t\t// any locale counts, as it does for the runtime's `getTaxonomyDef`.\n\t\tconst def = await findTaxonomyStructure(db, name);\n\t\tdefCache.set(name, def);\n\t\tif (def) {\n\t\t\tstate.plan.collectionsByTaxonomy.set(name, new Set(def.collections));\n\t\t}\n\t\treturn def;\n\t};\n\n\t// Pass 1-3: collect every term declared at the top of the WXR, then\n\t// resolve them in a few batched queries instead of one round-trip per term.\n\tconst categoryDef = await lookupDef(\"category\");\n\tconst tagDef = await lookupDef(\"tag\");\n\tconst topLevel: TermDescriptor[] = [];\n\n\tif (categoryDef) {\n\t\tfor (const cat of categories) {\n\t\t\tif (!cat.nicename || !cat.name) continue;\n\t\t\ttopLevel.push({\n\t\t\t\ttaxonomyName: \"category\",\n\t\t\t\tslug: cat.nicename,\n\t\t\t\tlabel: cat.name,\n\t\t\t\tdescription: cat.description,\n\t\t\t});\n\t\t}\n\t} else if (categories.length > 0) {\n\t\tstate.plan.missingTaxonomies.push(\"category\");\n\t}\n\n\tif (tagDef) {\n\t\tfor (const tag of tags) {\n\t\t\tif (!tag.slug || !tag.name) continue;\n\t\t\ttopLevel.push({\n\t\t\t\ttaxonomyName: \"tag\",\n\t\t\t\tslug: tag.slug,\n\t\t\t\tlabel: tag.name,\n\t\t\t\tdescription: tag.description,\n\t\t\t});\n\t\t}\n\t} else if (tags.length > 0) {\n\t\tstate.plan.missingTaxonomies.push(\"tag\");\n\t}\n\n\tfor (const term of terms) {\n\t\tif (term.taxonomy === \"nav_menu\" || term.taxonomy === \"language\") continue;\n\t\t// Normalize WordPress' `post_tag` synonym -> EmDash `tag`. WordPress\n\t\t// emits `<wp:tag>` for some exports and `<wp:term wp:term_taxonomy=\"post_tag\">`\n\t\t// for others; both must land in the same EmDash taxonomy.\n\t\tconst taxonomyName = term.taxonomy === \"post_tag\" ? \"tag\" : term.taxonomy;\n\t\tconst def = await lookupDef(taxonomyName);\n\t\tif (!def) {\n\t\t\tif (!state.plan.missingTaxonomies.includes(taxonomyName)) {\n\t\t\t\tstate.plan.missingTaxonomies.push(taxonomyName);\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\ttopLevel.push({\n\t\t\ttaxonomyName,\n\t\t\tslug: term.slug,\n\t\t\tlabel: term.name,\n\t\t\tdescription: term.description,\n\t\t});\n\t}\n\n\tawait ensureTermsBatch(db, state, topLevel, locale);\n\n\t// Pass 4: per-item assignments. Backfills terms missing from the top-\n\t// level blocks (rare, but observed in hand-edited or partial exports).\n\t// Collect every assignment first so we can batch-resolve them too.\n\tconst fromPosts: TermDescriptor[] = [];\n\tlet recordedMissingCategoryFromPosts = false;\n\tlet recordedMissingTagFromPosts = false;\n\n\tfor (const post of posts) {\n\t\tfor (const slug of post.categories) {\n\t\t\tif (!categoryDef) {\n\t\t\t\tif (\n\t\t\t\t\t!recordedMissingCategoryFromPosts &&\n\t\t\t\t\t!state.plan.missingTaxonomies.includes(\"category\")\n\t\t\t\t) {\n\t\t\t\t\tstate.plan.missingTaxonomies.push(\"category\");\n\t\t\t\t\trecordedMissingCategoryFromPosts = true;\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (state.plan.termIdByNameAndSlug.get(\"category\")?.has(slug)) continue;\n\t\t\tfromPosts.push({\n\t\t\t\ttaxonomyName: \"category\",\n\t\t\t\tslug,\n\t\t\t\tlabel: labelFor(post, \"category\", slug),\n\t\t\t});\n\t\t}\n\t\tfor (const slug of post.tags) {\n\t\t\tif (!tagDef) {\n\t\t\t\tif (!recordedMissingTagFromPosts && !state.plan.missingTaxonomies.includes(\"tag\")) {\n\t\t\t\t\tstate.plan.missingTaxonomies.push(\"tag\");\n\t\t\t\t\trecordedMissingTagFromPosts = true;\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (state.plan.termIdByNameAndSlug.get(\"tag\")?.has(slug)) continue;\n\t\t\tfromPosts.push({\n\t\t\t\ttaxonomyName: \"tag\",\n\t\t\t\tslug,\n\t\t\t\tlabel: labelFor(post, \"tag\", slug),\n\t\t\t});\n\t\t}\n\t\tif (post.customTaxonomies) {\n\t\t\tfor (const [rawName, slugs] of post.customTaxonomies) {\n\t\t\t\tif (rawName === \"nav_menu\" || rawName === \"language\") continue;\n\t\t\t\tconst taxonomyName = rawName === \"post_tag\" ? \"tag\" : rawName;\n\t\t\t\tconst def = await lookupDef(taxonomyName);\n\t\t\t\tif (!def) {\n\t\t\t\t\tif (!state.plan.missingTaxonomies.includes(taxonomyName)) {\n\t\t\t\t\t\tstate.plan.missingTaxonomies.push(taxonomyName);\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tfor (const slug of slugs) {\n\t\t\t\t\tif (state.plan.termIdByNameAndSlug.get(taxonomyName)?.has(slug)) continue;\n\t\t\t\t\tfromPosts.push({\n\t\t\t\t\t\ttaxonomyName,\n\t\t\t\t\t\tslug,\n\t\t\t\t\t\tlabel: labelFor(post, taxonomyName, slug),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tawait ensureTermsBatch(db, state, fromPosts, locale);\n\n\t// `content_taxonomies` writes happen later in `attachPostTaxonomies`, but\n\t// term inserts above already invalidate the in-memory \"has any terms\" probe.\n\t// We flush once at the end of the pre-import to keep the runtime cache hot.\n\tinvalidateTermCache();\n\n\treturn state.plan;\n}\n\n/**\n * Walk a parsed WXR post's per-item taxonomy assignments and return only\n * the ones that resolve to a real EmDash term AND aren't filtered out by\n * the taxonomy def's `collections` allowlist. Grouped by EmDash taxonomy\n * name (so `post_tag` is already folded into `tag`). Deduplicated.\n *\n * This is the single source of truth for \"what will the importer try to\n * write for this post\". Both the anchor (additive `attachToEntry`) and\n * translation (per-taxonomy `setTermsForEntry`) paths drive from this map\n * so they agree on which taxonomies need touching. In particular, the\n * translation path uses the keys here -- not `postAssignedTaxonomies` --\n * to decide which inherited pivot rows to clear, so a translation whose\n * only assignment is filtered out by `collections` doesn't lose its\n * inherited terms (see #1087 review feedback).\n *\n * Skipped taxonomies: `nav_menu` (handled by the menu importer) and\n * `language` (Polylang's locale signal, already promoted to `post.locale`\n * by the parser).\n */\nexport function resolvePostTermAssignments(\n\tcollection: string,\n\tpost: WxrPost,\n\tplan: TaxonomyImportPlan,\n): Map<string, string[]> {\n\tconst result = new Map<string, string[]>();\n\tconst seen = new Set<string>();\n\n\tconst tryResolve = (taxonomyName: string, slug: string): void => {\n\t\tconst termId = plan.termIdByNameAndSlug.get(taxonomyName)?.get(slug);\n\t\tif (!termId) return;\n\t\tconst collectionFilter = plan.collectionsByTaxonomy.get(taxonomyName);\n\t\t// Empty set means \"no filter\" (def has no collections array). A\n\t\t// non-empty set is enforced: skip assignments to collections the\n\t\t// def doesn't list. Matches admin UI: a `category` term linked\n\t\t// only to `posts` shouldn't end up on a `products` row just\n\t\t// because the WXR happened to mention it.\n\t\tif (collectionFilter && collectionFilter.size > 0 && !collectionFilter.has(collection)) {\n\t\t\treturn;\n\t\t}\n\t\tconst dedupeKey = `${taxonomyName}\\u0000${termId}`;\n\t\tif (seen.has(dedupeKey)) return;\n\t\tseen.add(dedupeKey);\n\t\tconst existing = result.get(taxonomyName);\n\t\tif (existing) existing.push(termId);\n\t\telse result.set(taxonomyName, [termId]);\n\t};\n\n\tfor (const slug of post.categories) tryResolve(\"category\", slug);\n\tfor (const slug of post.tags) tryResolve(\"tag\", slug);\n\tif (post.customTaxonomies) {\n\t\tfor (const [rawName, slugs] of post.customTaxonomies) {\n\t\t\tif (rawName === \"nav_menu\" || rawName === \"language\") continue;\n\t\t\tconst taxonomyName = rawName === \"post_tag\" ? \"tag\" : rawName;\n\t\t\tfor (const slug of slugs) tryResolve(taxonomyName, slug);\n\t\t}\n\t}\n\n\treturn result;\n}\n\n/**\n * Attach the taxonomy assignments parsed for a single WXR post to a freshly-\n * created EmDash content row. Additive (`attachToEntry` + `ON CONFLICT DO\n * NOTHING`). Used for anchors -- translations need replace-semantics per\n * taxonomy and should use `setPostTermAssignmentsReplacing` instead.\n *\n * Returns the number of pivot rows actually inserted (excludes rows that\n * already existed via the `ON CONFLICT DO NOTHING` path), so the caller can\n * roll them up into the import summary without over-counting on re-imports.\n */\nexport async function attachPostTaxonomies(\n\tdb: Kysely<Database>,\n\tcollection: string,\n\tentryId: string,\n\tpost: WxrPost,\n\tplan: TaxonomyImportPlan,\n): Promise<number> {\n\tconst repo = new TaxonomyRepository(db);\n\tconst resolved = resolvePostTermAssignments(collection, post, plan);\n\tconst groups = new Set<string>();\n\tfor (const [, termIds] of resolved) {\n\t\tfor (const termId of termIds) {\n\t\t\tconst group = await termTranslationGroup(repo, plan, termId);\n\t\t\tif (group) groups.add(group);\n\t\t}\n\t}\n\treturn repo.attachGroupsToEntry(collection, entryId, [...groups]);\n}\n\n/**\n * Replace assignments per-taxonomy from a parsed WXR post. Used for\n * translations. Assignments belong to the content translation_group, so a\n * translated item's explicit taxonomy replaces that taxonomy for every\n * locale. Taxonomies with no resolvable permitted terms are left unchanged.\n *\n * Returns the number of pivot rows after replacement (sum of `termIds`\n * lists across taxonomies actually touched). Note this counts logical\n * assignments, not the delta from the prior state; the import summary\n * treats this as an additive count for compatibility with `attachPost-\n * Taxonomies`.\n */\nexport async function setPostTermAssignmentsReplacing(\n\tdb: Kysely<Database>,\n\tcollection: string,\n\tentryId: string,\n\tpost: WxrPost,\n\tplan: TaxonomyImportPlan,\n): Promise<number> {\n\tconst repo = new TaxonomyRepository(db);\n\tconst resolved = resolvePostTermAssignments(collection, post, plan);\n\n\tlet attached = 0;\n\tfor (const [taxonomyName, termIds] of resolved) {\n\t\tawait repo.setTermsForEntry(collection, entryId, taxonomyName, termIds);\n\t\tattached += termIds.length;\n\t}\n\treturn attached;\n}\n\n/**\n * Resolve a term id to its `translation_group` (the value\n * `content_taxonomies` stores). Caches the result on the plan so\n * repeated attaches of the same term don't repeat the lookup.\n */\nasync function termTranslationGroup(\n\trepo: TaxonomyRepository,\n\tplan: TaxonomyImportPlan,\n\ttermId: string,\n): Promise<string | null> {\n\tconst cached = plan.translationGroupByTermId.get(termId);\n\tif (cached !== undefined) return cached;\n\tconst term = await repo.findById(termId);\n\tconst group = term?.translationGroup ?? null;\n\tplan.translationGroupByTermId.set(termId, group);\n\treturn group;\n}\n\n/**\n * Mirror every term in the plan into each additional locale used by the\n * incoming posts. New rows share the canonical term's `translation_group`\n * so per-locale lookups (`getTermsForEntry(..., locale)`) resolve correctly\n * for translations whose locale differs from the import-wide one.\n *\n * Without this pass, multilingual WXR imports (#1080) write all term rows\n * at the upload-wide locale; the `content_taxonomies` pivot is correct (it\n * stores `translation_group`, not `term id`), but\n * `getTermsForEntry(collection, arabicPostId, \"category\", \"ar\")` filters on\n * `taxonomies.locale = \"ar\"` and returns zero rows. Users see \"no tags\" on\n * every non-canonical translation.\n *\n * Idempotent: skips a locale when a row already exists at `(name, slug,\n * locale)`. Safe to call after `preImportWxrTaxonomies` on subsequent\n * imports.\n */\nexport async function mirrorTermsToLocales(\n\tdb: Kysely<Database>,\n\tplan: TaxonomyImportPlan,\n\tpostLocales: Iterable<string>,\n\tcanonicalLocale: string | undefined,\n): Promise<void> {\n\tconst localeSet = new Set<string>();\n\tfor (const locale of postLocales) {\n\t\tif (!locale || locale === canonicalLocale) continue;\n\t\tlocaleSet.add(locale);\n\t}\n\tif (localeSet.size === 0) return;\n\n\tconst repo = new TaxonomyRepository(db);\n\n\tfor (const [taxonomyName, bySlug] of plan.termIdByNameAndSlug) {\n\t\tfor (const [slug, canonicalTermId] of bySlug) {\n\t\t\t// Resolve the canonical's translation_group once; we'll compare\n\t\t\t// against any pre-existing rows we find at the target locales.\n\t\t\t// Cache on the plan so subsequent attaches (which also need\n\t\t\t// this resolution) don't repeat the lookup.\n\t\t\tconst cachedGroup = await termTranslationGroup(repo, plan, canonicalTermId);\n\t\t\tif (!cachedGroup) {\n\t\t\t\t// The canonical term id is in the plan but the row is no\n\t\t\t\t// longer in the DB. Shouldn't happen during a single\n\t\t\t\t// import run; skip rather than crash so the rest of the\n\t\t\t\t// import can complete.\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst canonicalGroup = cachedGroup;\n\n\t\t\tfor (const locale of localeSet) {\n\t\t\t\tconst existing = await repo.findBySlug(taxonomyName, slug, locale);\n\t\t\t\tif (existing) {\n\t\t\t\t\t// `ensureTerm` resolves cross-locale grouping when it\n\t\t\t\t\t// creates the canonical row, so a pre-existing sibling\n\t\t\t\t\t// row at this locale should already share the\n\t\t\t\t\t// canonical's `translation_group`. If it doesn't, the\n\t\t\t\t\t// import would write pivots pointing at a group that\n\t\t\t\t\t// has no row in this locale -- a silent data-integrity\n\t\t\t\t\t// bug. Fail closed: throw so the operator reconciles\n\t\t\t\t\t// the existing rows in the admin before retrying. This\n\t\t\t\t\t// happens when the canonical row was created in an\n\t\t\t\t\t// earlier import and a sibling-locale row was added\n\t\t\t\t\t// manually afterwards (or vice versa) without linking\n\t\t\t\t\t// them via translationOf.\n\t\t\t\t\tif (existing.translationGroup !== canonicalGroup) {\n\t\t\t\t\t\tthrow new WxrTaxonomyConflictError(\n\t\t\t\t\t\t\t`Cannot import: term \"${taxonomyName}/${slug}\" already exists at locale \"${locale}\" in a different translation group than the canonical row at this import's locale. Reconcile the rows in the admin (re-link via translationOf, or delete one) and retry.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait repo.create({\n\t\t\t\t\t\tname: taxonomyName,\n\t\t\t\t\t\tslug,\n\t\t\t\t\t\tlabel: slug, // we don't have a per-locale label from the WXR\n\t\t\t\t\t\tlocale,\n\t\t\t\t\t\ttranslationOf: canonicalTermId,\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// `findBySlug` + `create` is not atomic. A concurrent\n\t\t\t\t\t// import racing us into the same `(name, slug, locale)`\n\t\t\t\t\t// will trip the UNIQUE constraint. Re-read the row that\n\t\t\t\t\t// won the race and verify its `translation_group`\n\t\t\t\t\t// matches the canonical's; if not, the pivot will\n\t\t\t\t\t// resolve to a group that has no row in this locale\n\t\t\t\t\t// (silent data-integrity bug) so we surface that loudly\n\t\t\t\t\t// rather than continue.\n\t\t\t\t\t//\n\t\t\t\t\t// Other errors (validation, connectivity) re-throw so\n\t\t\t\t\t// the import fails closed rather than silently shipping\n\t\t\t\t\t// translations that resolve to empty taxonomy queries.\n\t\t\t\t\tconst message = error instanceof Error ? error.message.toLowerCase() : \"\";\n\t\t\t\t\tconst isUniqueRace =\n\t\t\t\t\t\tmessage.includes(\"unique constraint failed\") || message.includes(\"duplicate key\");\n\t\t\t\t\tif (!isUniqueRace) throw error;\n\n\t\t\t\t\tconst winner = await repo.findBySlug(taxonomyName, slug, locale);\n\t\t\t\t\tif (!winner) {\n\t\t\t\t\t\t// UNIQUE conflict but no row visible? Shouldn't\n\t\t\t\t\t\t// happen unless the racing transaction rolled back;\n\t\t\t\t\t\t// fail loudly so the operator can investigate.\n\t\t\t\t\t\tthrow new WxrTaxonomyConflictError(\n\t\t\t\t\t\t\t`Cannot import: term \"${taxonomyName}/${slug}\" raced UNIQUE at locale \"${locale}\" but no row is visible afterwards. The concurrent transaction may have rolled back; retry the import.`,\n\t\t\t\t\t\t\t{ cause: error },\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (winner.translationGroup !== canonicalGroup) {\n\t\t\t\t\t\tthrow new WxrTaxonomyConflictError(\n\t\t\t\t\t\t\t`Cannot import: term \"${taxonomyName}/${slug}\" raced UNIQUE at locale \"${locale}\" with a different translation group. Reconcile the rows in the admin and retry.`,\n\t\t\t\t\t\t\t{ cause: error },\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t`[WXR import] concurrent writer beat us to term \"${taxonomyName}/${slug}\" at locale \"${locale}\"; using existing row (same group).`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":"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"}

package/dist/wxr-taxonomies-Dad33GJi.d.mts

@@ -0,0 +1,34 @@
+import { Kysely } from "kysely";
+
+//#region src/import/wxr-taxonomies.d.ts
+/**
+ * Result of pre-importing taxonomy terms from a WXR file.
+ */
+interface TaxonomyImportPlan {
+  /** terms created during this run (per taxonomy name) */
+  termsCreated: Record<string, number>;
+  /** terms that already existed and were reused (per taxonomy name) */
+  termsReused: Record<string, number>;
+  /** custom taxonomies (`wp:term`) skipped because no matching EmDash def exists */
+  missingTaxonomies: string[];
+  /**
+   * Lookup table: `taxonomy name` -> `term slug` -> term id.
+   * Used by `attachPostTaxonomies` to translate WXR assignments into pivot rows.
+   */
+  termIdByNameAndSlug: Map<string, Map<string, string>>;
+  /**
+   * Lookup table: `taxonomy name` -> set of collection slugs the def allows.
+   * Empty (or missing) means "any collection" — we only enforce the filter
+   * when the def explicitly lists collections.
+   */
+  collectionsByTaxonomy: Map<string, Set<string>>;
+  /**
+   * Lookup table: `term id` -> the term's `translation_group` (or `null`
+   * if the term doesn't exist any more). Populated lazily by helpers that
+   * need to check pivot existence without repeating per-term DB reads.
+   */
+  translationGroupByTermId: Map<string, string | null>;
+}
+//#endregion
+export { TaxonomyImportPlan as t };
+//# sourceMappingURL=wxr-taxonomies-Dad33GJi.d.mts.map

package/dist/wxr-taxonomies-Dad33GJi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wxr-taxonomies-Dad33GJi.d.mts","names":[],"sources":["../src/import/wxr-taxonomies.ts"],"mappings":";;;;;;UAiEiB,kBAAA;;EAEhB,YAAA,EAAc,MAAA;;EAEd,WAAA,EAAa,MAAA;;EAEb,iBAAA;;;;;EAKA,mBAAA,EAAqB,GAAA,SAAY,GAAA;;;;;;EAMjC,qBAAA,EAAuB,GAAA,SAAY,GAAA;;;;;;EAMnC,wBAAA,EAA0B,GAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emdash",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Astro-native CMS with WordPress migration support",
   "type": "module",
   "main": "dist/index.mjs",
@@ -265,6 +265,8 @@
     "@tiptap/extension-link": "^3.20.0",
     "@tiptap/extension-list": "^3.20.0",
     "@tiptap/extension-placeholder": "^3.20.0",
+    "@tiptap/extension-subscript": "^3.20.0",
+    "@tiptap/extension-superscript": "^3.20.0",
     "@tiptap/extension-text-align": "^3.20.0",
     "@tiptap/extension-typography": "^3.20.0",
     "@tiptap/extension-underline": "^3.20.0",
@@ -295,14 +297,14 @@
     "upng-js": "^2.1.0",
     "zod": "4.5.4",
     "@atcute/client": "^5.0.0",
-    "@emdash-cms/admin": "1.1.0",
-    "@emdash-cms/auth": "1.1.0",
-    "@emdash-cms/plugin-types": "0.5.0",
-    "@emdash-cms/blocks": "1.1.0",
-    "@emdash-cms/gutenberg-to-portable-text": "1.1.0",
+    "@emdash-cms/admin": "1.2.0",
+    "@emdash-cms/auth": "1.2.0",
+    "@emdash-cms/blocks": "1.2.0",
+    "@emdash-cms/gutenberg-to-portable-text": "1.2.0",
+    "@emdash-cms/plugin-types": "0.6.0",
     "@emdash-cms/registry-client": "0.7.0",
     "@emdash-cms/registry-lexicons": "0.7.0",
-    "@emdash-cms/registry-verification": "0.3.3"
+    "@emdash-cms/registry-verification": "0.3.4"
   },
   "optionalDependencies": {
     "@libsql/kysely-libsql": "^0.4.0",
@@ -323,10 +325,11 @@
   "devDependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
     "@arethetypeswrong/cli": "^0.18.2",
-    "@astrojs/react": "^6.0.5",
+    "@astrojs/react": "^7.0.0",
     "@cloudflare/vitest-plugin": "^1.0.0",
     "@types/pg": "^8.16.0",
     "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
     "@types/sanitize-html": "^2.16.0",
     "@types/sax": "^1.2.7",
     "@vitest/ui": "4.1.10",
@@ -339,7 +342,7 @@
     "vitest": "4.1.10",
     "zod-openapi": "^5.4.6",
     "@emdash-cms/atproto-test-utils": "0.0.0",
-    "@emdash-cms/registry-verification": "0.3.3"
+    "@emdash-cms/registry-verification": "0.3.4"
   },
   "repository": {
     "type": "git",
@@ -361,7 +364,7 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "typecheck": "tsgo --noEmit",
+    "typecheck": "tsgo --noEmit && tsgo --noEmit -p tsconfig.components.json",
     "check": "publint && attw --pack --ignore-rules=cjs-resolves-to-esm --ignore-rules=no-resolution --ignore-rules=internal-resolution-error",
     "test": "vitest",
     "test:workerd": "vitest run --config vitest.workerd.config.ts",

package/src/api/errors.ts

@@ -28,6 +28,7 @@ export const ErrorCode = {
 	NOT_IMPLEMENTED: "NOT_IMPLEMENTED",
 	NOT_SUPPORTED: "NOT_SUPPORTED",
 	MISSING_PARAM: "MISSING_PARAM",
+	DOMAIN_CHECK_FAILED: "DOMAIN_CHECK_FAILED",
 	CSRF_REJECTED: "CSRF_REJECTED",
 
 	// Content
@@ -185,6 +186,9 @@ export const ErrorCode = {
 	SIGNUP_VERIFY_ERROR: "SIGNUP_VERIFY_ERROR",
 	SIGNUP_COMPLETE_ERROR: "SIGNUP_COMPLETE_ERROR",
 	RECOVERY_SEND_ERROR: "RECOVERY_SEND_ERROR",
+	MAGIC_LINK_VERIFY_ERROR: "MAGIC_LINK_VERIFY_ERROR",
+	NO_SITE_URL: "NO_SITE_URL",
+	SIGN_IN_HANDOVER_ERROR: "SIGN_IN_HANDOVER_ERROR",
 	USER_LIST_ERROR: "USER_LIST_ERROR",
 	USER_DETAIL_ERROR: "USER_DETAIL_ERROR",
 	USER_UPDATE_ERROR: "USER_UPDATE_ERROR",
@@ -360,6 +364,9 @@ export const ErrorCode = {
 	SETTINGS_UPDATE_ERROR: "SETTINGS_UPDATE_ERROR",
 	EMAIL_SETTINGS_READ_ERROR: "EMAIL_SETTINGS_READ_ERROR",
 	EMAIL_TEST_ERROR: "EMAIL_TEST_ERROR",
+	SITE_DOMAIN_ERROR: "SITE_DOMAIN_ERROR",
+	DOMAIN_PROOF_ERROR: "DOMAIN_PROOF_ERROR",
+	DOMAIN_MOVE_NOTICE_ERROR: "DOMAIN_MOVE_NOTICE_ERROR",
 
 	// Backups
 	BACKUP_SETTINGS_READ_ERROR: "BACKUP_SETTINGS_READ_ERROR",
@@ -513,6 +520,7 @@ export function mapErrorStatus(code: string | undefined): number {
 		case ErrorCode.CREDENTIAL_EXISTS:
 		case ErrorCode.EMAIL_IN_USE:
 		case ErrorCode.USER_EXISTS:
+		case ErrorCode.NO_SITE_URL:
 		case ErrorCode.PLUGIN_ID_CONFLICT:
 		case ErrorCode.ALREADY_INSTALLED:
 		case ErrorCode.ALREADY_CONFIGURED:
@@ -543,6 +551,7 @@ export function mapErrorStatus(code: string | undefined): number {
 		case ErrorCode.CHECKSUM_MISMATCH:
 		case ErrorCode.INVALID_BUNDLE:
 		case ErrorCode.BUNDLE_EXTRACT_FAILED:
+		case ErrorCode.DOMAIN_CHECK_FAILED:
 			return 422;
 
 		// 429 Too Many Requests

package/src/api/handlers/api-tokens.ts

@@ -9,6 +9,7 @@
 import type { Kysely } from "kysely";
 import { ulid } from "ulidx";
 
+import { after } from "../../after.js";
 import { hashApiToken, generatePrefixedToken } from "../../auth/api-tokens.js";
 import type { Database } from "../../database/types.js";
 import type { ApiResult } from "../types.js";
@@ -227,12 +228,17 @@ export async function resolveApiToken(
 		return null;
 	}
 
-	// Update last_used_at (fire-and-forget, don't block the request)
-	db.updateTable("_emdash_api_tokens")
-		.set({ last_used_at: new Date().toISOString() })
-		.where("id", "=", row.id)
-		.execute()
-		.catch(() => {}); // Non-critical, swallow errors
+	after(async () => {
+		try {
+			await db
+				.updateTable("_emdash_api_tokens")
+				.set({ last_used_at: new Date().toISOString() })
+				.where("id", "=", row.id)
+				.execute();
+		} catch (error) {
+			console.error("[api-tokens] failed to record token use:", error);
+		}
+	});
 
 	return {
 		userId: row.user_id,

package/src/api/handlers/content.ts

@@ -868,6 +868,23 @@ function resolveBylineFilter(
 	return { mode: "any", bylineIds, includeInferred, locale };
 }
 
+/**
+ * Rows to skip for a numbered page, or `null` when the page can't be served
+ * (combined with a cursor, or past the safe-integer range).
+ */
+function pageOffset(params: { page: number; limit: number; cursor?: string }): number | null {
+	const offset = (params.page - 1) * params.limit;
+	if (
+		params.cursor !== undefined ||
+		!Number.isSafeInteger(params.page) ||
+		params.page < 1 ||
+		!Number.isSafeInteger(offset)
+	) {
+		return null;
+	}
+	return offset;
+}
+
 /**
  * Create content list handler
  */
@@ -876,6 +893,7 @@ export async function handleContentList(
 	collection: string,
 	params: {
 		cursor?: string;
+		page?: number;
 		limit?: number;
 		status?: string;
 		orderBy?: string;
@@ -893,6 +911,18 @@ export async function handleContentList(
 	},
 ): Promise<ApiResult<ContentListResponse>> {
 	try {
+		const limit = Math.max(1, Math.min(params.limit || 50, 100));
+		const offset =
+			params.page === undefined
+				? undefined
+				: pageOffset({ page: params.page, limit, cursor: params.cursor });
+		if (offset === null) {
+			return {
+				success: false,
+				error: { code: "VALIDATION_ERROR", message: "Invalid content page" },
+			};
+		}
+
 		const repo = new ContentRepository(db);
 		const where: FindManyOptions["where"] = {};
 		if (params.status) where.status = params.status;
@@ -940,7 +970,8 @@ export async function handleContentList(
 
 		const result = await repo.findMany(collection, {
 			cursor: params.cursor,
-			limit: params.limit || 50,
+			offset,
+			limit,
 			where: Object.keys(where).length > 0 ? where : undefined,
 			orderBy: params.orderBy
 				? { field: params.orderBy, direction: params.order || "desc" }
@@ -2033,15 +2064,32 @@ export async function handleContentPermanentDelete(
 export async function handleContentListTrashed(
 	db: Kysely<Database>,
 	collection: string,
-	options: { limit?: number; cursor?: string; locale?: string } = {},
-): Promise<ApiResult<{ items: TrashedContentItem[]; nextCursor?: string }>> {
+	options: { limit?: number; cursor?: string; page?: number; locale?: string } = {},
+): Promise<ApiResult<{ items: TrashedContentItem[]; nextCursor?: string; total?: number }>> {
 	try {
+		const limit = Math.max(1, Math.min(options.limit || 50, 100));
+		const offset =
+			options.page === undefined
+				? undefined
+				: pageOffset({ page: options.page, limit, cursor: options.cursor });
+		if (offset === null) {
+			return {
+				success: false,
+				error: { code: "VALIDATION_ERROR", message: "Invalid content page" },
+			};
+		}
+
 		const repo = new ContentRepository(db);
-		const result = await repo.findTrashed(collection, {
-			limit: options.limit,
-			cursor: options.cursor,
-			where: { locale: options.locale },
-		});
+		const where = { locale: options.locale };
+		// Settled like findMany's count, so a rejection can't leave the other
+		// query holding a pooled connection.
+		const [rowsResult, countResult] = await Promise.allSettled([
+			repo.findTrashed(collection, { limit, cursor: options.cursor, offset, where }),
+			offset === undefined ? undefined : repo.countTrashed(collection, where),
+		]);
+		if (rowsResult.status === "rejected") throw rowsResult.reason;
+		if (countResult.status === "rejected") throw countResult.reason;
+		const result = rowsResult.value;
 
 		return {
 			success: true,
@@ -2061,6 +2109,7 @@ export async function handleContentListTrashed(
 					deletedAt: item.deletedAt,
 				})),
 				nextCursor: result.nextCursor,
+				total: countResult.value,
 			},
 		};
 	} catch (error) {

package/src/api/handlers/domain-move-notice.ts

@@ -0,0 +1,94 @@
+/**
+ * Tell users that the site moved to a new address.
+ */
+
+import { getLocaleDir } from "@emdash-cms/admin/locales/config";
+import type { DomainMoveEmailStrings } from "@emdash-cms/admin/locales/emails";
+import { escapeHtml, type EmailMessage } from "@emdash-cms/auth";
+import type { Kysely } from "kysely";
+
+import type { Database } from "../../database/types.js";
+import type { ApiResult } from "../types.js";
+
+export interface DomainMoveNoticeOptions {
+	/** Origin users should sign in at, e.g. `https://example.com`. */
+	origin: string;
+	strings: DomainMoveEmailStrings;
+	locale: string;
+	/** The user sending the notice; they are not emailed. */
+	senderId: string;
+	send: (message: EmailMessage) => Promise<void>;
+}
+
+export function buildDomainMoveEmail(
+	to: string,
+	loginUrl: string,
+	strings: DomainMoveEmailStrings,
+	locale: string,
+): EmailMessage {
+	const url = escapeHtml(loginUrl);
+	return {
+		to,
+		subject: strings.subject,
+		text: `${strings.intro}\n\n${strings.instruction}\n\n${loginUrl}\n\n${strings.passkeyNote}`,
+		html: `
+<!DOCTYPE html>
+<html lang="${escapeHtml(locale)}" dir="${getLocaleDir(locale)}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.5; color: #333; max-width: 600px; margin: 0 auto; padding: 20px;">
+  <h1 style="font-size: 24px; margin-bottom: 20px;">${escapeHtml(strings.subject)}</h1>
+  <p>${escapeHtml(strings.intro)}</p>
+  <p>${escapeHtml(strings.instruction)}</p>
+  <p style="margin: 30px 0;">
+    <a href="${url}" style="background-color: #0066cc; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; display: inline-block;">${escapeHtml(strings.buttonLabel)}</a>
+  </p>
+  <p style="color: #666; font-size: 14px;">${escapeHtml(strings.passkeyNote)}</p>
+</body>
+</html>`,
+	};
+}
+
+/**
+ * Email every active user except the sender a link to the sign-in page at
+ * `origin`. The email carries no sign-in token. Sends one email per user,
+ * so a failed send for one address doesn't stop the others.
+ */
+export async function handleDomainMoveNotice(
+	db: Kysely<Database>,
+	options: DomainMoveNoticeOptions,
+): Promise<ApiResult<{ sent: number; failed: number }>> {
+	try {
+		const users = await db
+			.selectFrom("users")
+			.select("email")
+			.where("disabled", "=", 0)
+			.where("id", "!=", options.senderId)
+			.execute();
+
+		const loginUrl = new URL("/_emdash/admin/login", options.origin).toString();
+		let sent = 0;
+		let failed = 0;
+		for (const user of users) {
+			try {
+				// oxlint-disable-next-line no-await-in-loop -- one send at a time keeps email providers within their rate limits
+				await options.send(
+					buildDomainMoveEmail(user.email, loginUrl, options.strings, options.locale),
+				);
+				sent++;
+			} catch (error) {
+				failed++;
+				console.error("[domain-move-notice] send failed:", error);
+			}
+		}
+		return { success: true, data: { sent, failed } };
+	} catch (error) {
+		console.error("[domain-move-notice] failed:", error);
+		return {
+			success: false,
+			error: { code: "DOMAIN_MOVE_NOTICE_ERROR", message: "Failed to email users" },
+		};
+	}
+}

package/src/api/handlers/index.ts

@@ -147,9 +147,11 @@ export {
 // SEO handlers
 export {
 	handleSitemapData,
+	handleSitemapIndexData,
 	type SitemapCollectionData,
 	type SitemapContentEntry,
 	type SitemapDataResponse,
+	type SitemapIndexEntry,
 } from "./seo.js";
 
 // Plugin handlers

package/src/api/handlers/manifest.ts

@@ -377,6 +377,11 @@ function dbFieldDescriptor(
 		entry.validation = validation;
 	}
 
+	// A bound reference is set through `references`; create refuses a value for it in `data`.
+	if (field.defaultValue !== undefined && !isStoragelessField(field)) {
+		entry.defaultValue = field.defaultValue;
+	}
+
 	return entry;
 }
 

package/src/api/handlers/media-usage.ts

@@ -410,7 +410,8 @@ function normalizeMediaUsageReferenceType(
 	if (
 		referenceType === "image_field" ||
 		referenceType === "file_field" ||
-		referenceType === "portable_text_image"
+		referenceType === "portable_text_image" ||
+		referenceType === "portable_text_video"
 	) {
 		return referenceType;
 	}

package/src/api/handlers/media.ts

@@ -146,6 +146,7 @@ export async function handleMediaCreate(
 		width?: number;
 		height?: number;
 		alt?: string;
+		caption?: string;
 		storageKey: string;
 		contentHash?: string;
 		blurhash?: string;