emdash 0.38.0 → 0.39.0

package/dist/taxonomies-BpqpXJUE.mjs

@@ -0,0 +1,707 @@
+import { u as __exportAll } from "./runner-ClrleR8A.mjs";
+import { n as isMissingTableError } from "./db-errors-CBD5yMro.mjs";
+import { t as validateIdentifier } from "./validate-DANX1-Qi.mjs";
+import { i as compoundSelectLimit, n as buildStatusCondition } from "./dialect-helpers-CtYdsX4W.mjs";
+import { r as getI18nConfig } from "./config-CGVeT8Hc.mjs";
+import { getRequestContext } from "./request-context.mjs";
+import { m as isObjectCacheActive, n as cachedQuery, p as invalidateTaxonomyObjectCache, r as contentCacheNamespaces, t as CacheNamespace } from "./object-cache-DlSVbn5Y.mjs";
+import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-BmWyou79.mjs";
+import { n as resolveLocale, r as resolveLocaleChain } from "./resolve-BJIS8wKr.mjs";
+import { i as setRequestCacheEntry, n as peekRequestCache, r as requestCached } from "./request-cache-DaMhSQdx.mjs";
+import { r as taxonomyTag } from "./chrome-tags-D7LGB91U.mjs";
+import { l as resetTaxonomyNamesCache, s as getDb } from "./loader-t4TxaFiQ.mjs";
+import { n as noteStaleRegisteredCollections, t as filterToRegisteredCollections } from "./collection-slugs-cache-D9auiKmI.mjs";
+import { sql } from "kysely";
+
+//#region src/taxonomies/term-counts.ts
+/**
+* Per-collection count branch. `taxonomy_id` stores the term's
+* translation_group, so results are keyed by group (locale-independent) and
+* each assignment is counted once per content translation group. When a
+* locale is provided, only that group's matching content row contributes.
+*
+* Scoping to the taxonomy uses `translation_group IN (...)` rather than a
+* join on `taxonomies.id` — the anchor row (id == group) can be deleted while
+* sibling translations survive, and a plain join on `translation_group` would
+* multiply counts by the number of locales.
+*
+* CROSS JOIN with the join predicate in WHERE keeps stats-blind SQLite/D1 from
+* reordering content_taxonomies out of the outer position; it touches ec_* only
+* through the translation-group index. Postgres treats this as an ordinary
+* inner join and plans freely.
+*/
+function collectionBranch(db, taxonomyName, collection, locale) {
+	return sql`
+		SELECT ct.taxonomy_id AS taxonomy_id, COUNT(DISTINCT e.translation_group) AS count
+		FROM content_taxonomies AS ct
+		CROSS JOIN ${sql.ref(`ec_${collection}`)} AS e
+		WHERE e.translation_group = ct.entry_id
+			AND ct.collection = ${collection}
+			AND ct.taxonomy_id IN (SELECT translation_group FROM taxonomies WHERE name = ${taxonomyName})
+			${locale ? sql`AND e.locale = ${locale}` : sql``}
+			AND ${buildStatusCondition(db, "published", "e")}
+			AND e.deleted_at IS NULL
+		GROUP BY ct.taxonomy_id`;
+}
+async function runCounts(db, taxonomyName, collections, locale) {
+	const branches = collections.map((collection) => collectionBranch(db, taxonomyName, collection, locale));
+	const result = await sql`
+		SELECT taxonomy_id, SUM(count) AS count
+		FROM (${sql.join(branches, sql` UNION ALL `)}) AS per_collection
+		GROUP BY taxonomy_id`.execute(db);
+	const counts = /* @__PURE__ */ new Map();
+	for (const row of result.rows) counts.set(row.taxonomy_id, Number(row.count));
+	return counts;
+}
+function addCounts(into, from) {
+	for (const [group, count] of from) into.set(group, (into.get(group) ?? 0) + count);
+}
+/**
+* Counts for one batch of collections, degrading to a query per collection
+* when a declared collection has no ec_* table so the rest still contribute.
+*/
+async function runBatch(db, taxonomyName, collections, locale) {
+	try {
+		return await runCounts(db, taxonomyName, collections, locale);
+	} catch (error) {
+		if (!isMissingTableError(error)) throw error;
+		noteStaleRegisteredCollections();
+	}
+	const counts = /* @__PURE__ */ new Map();
+	for (const collection of collections) try {
+		addCounts(counts, await runCounts(db, taxonomyName, [collection], locale));
+	} catch (error) {
+		if (!isMissingTableError(error)) throw error;
+	}
+	return counts;
+}
+/**
+* Count publicly-visible term assignments for one taxonomy, keyed by the
+* term's translation_group (what `content_taxonomies.taxonomy_id` stores).
+* When `locale` is provided, only entries in that locale contribute. Omitting
+* it preserves the locale-agnostic API used by legacy callers.
+*
+* Counts are scoped to the taxonomy's declared collections — pass
+* `TaxonomyDef.collections` (`_emdash_taxonomy_defs.collections`). Declared
+* collections without a `_emdash_collections` row (the migration-seeded
+* defaults declare `posts` unconditionally) are filtered out before any SQL
+* is built, so no statement referencing a missing `ec_*` table is sent — a
+* failed statement is logged by the database even when the caller recovers,
+* flooding D1 observability with phantom errors. The missing-table guards in
+* `runBatch` stay as the backstop for registry/table drift (e.g. a partially
+* applied D1 create) and for a table dropped mid-flight, yielding a
+* partial-but-correct count rather than a throw.
+*
+* One database round-trip for the whole taxonomy (UNION ALL across
+* collections). On a backend that caps compound-SELECT terms — D1 allows five
+* — the branches are split into one statement per batch, since a taxonomy
+* declaring more collections than that would otherwise take down every path
+* that shows counts. Per-collection sums are commutative, so batching cannot
+* change the total.
+*
+* Callers on the public render path should go through the request-cached
+* wrapper in `taxonomies/index.ts` so a page rendering both the widget and a
+* term detail shares one computation.
+*/
+async function fetchVisibleTermCounts(db, taxonomyName, collections, locale) {
+	const unique = [...new Set(collections)];
+	for (const collection of unique) validateIdentifier(collection, "collection slug");
+	if (unique.length === 0) return /* @__PURE__ */ new Map();
+	const present = await filterToRegisteredCollections(db, unique);
+	if (present.length === 0) return /* @__PURE__ */ new Map();
+	const limit = compoundSelectLimit(db);
+	const batched = limit === null ? [present] : chunks(present, limit);
+	const batches = await Promise.all(batched.map((batch) => runBatch(db, taxonomyName, batch, locale)));
+	const counts = /* @__PURE__ */ new Map();
+	for (const batch of batches) addCounts(counts, batch);
+	return counts;
+}
+
+//#endregion
+//#region src/taxonomies/index.ts
+/**
+* Runtime API for taxonomies.
+*
+* All helpers are locale-aware. When a locale is not passed explicitly we fall
+* back to the request context or the configured `defaultLocale` (see
+* `i18n/resolve.ts`).
+*
+* Because `content_taxonomies.taxonomy_id` stores the translation_group (not a
+* specific term id), and `entry_id` stores the content translation_group, one
+* assignment resolves to the requested locale on both sides.
+*/
+var taxonomies_exports = /* @__PURE__ */ __exportAll({
+	getAllTermsForEntries: () => getAllTermsForEntries,
+	getEntriesByTerm: () => getEntriesByTerm,
+	getEntryTerms: () => getEntryTerms,
+	getTaxonomyDef: () => getTaxonomyDef,
+	getTaxonomyDefs: () => getTaxonomyDefs,
+	getTaxonomyTerms: () => getTaxonomyTerms,
+	getTaxonomyTermsWithCacheHint: () => getTaxonomyTermsWithCacheHint,
+	getTerm: () => getTerm,
+	getTermsForEntries: () => getTermsForEntries,
+	invalidateTaxonomyDefsCache: () => invalidateTaxonomyDefsCache,
+	invalidateTermCache: () => invalidateTermCache,
+	primeFoldedEntryTerms: () => primeFoldedEntryTerms
+});
+async function selectEntryTermRows(db, collection, entryIds, taxonomyName, locale) {
+	validateIdentifier(collection, "collection slug");
+	const tableName = `ec_${collection}`;
+	const preferredLocale = locale ? sql`${locale}` : sql`content.locale`;
+	const defaultLocale = getI18nConfig()?.defaultLocale ?? "en";
+	return (await sql`
+		SELECT content.id AS entry_id,
+			coalesce(exact_term.id, default_term.id) AS id,
+			coalesce(exact_term.name, default_term.name) AS name,
+			coalesce(exact_term.slug, default_term.slug) AS slug,
+			coalesce(exact_term.label, default_term.label) AS label,
+			coalesce(exact_term.parent_id, default_term.parent_id) AS parent_id,
+			coalesce(exact_term.locale, default_term.locale) AS locale,
+			coalesce(exact_term.translation_group, default_term.translation_group) AS translation_group
+		FROM ${sql.ref(tableName)} AS content
+		INNER JOIN content_taxonomies AS pivot
+			ON pivot.entry_id = content.translation_group
+			AND pivot.collection = ${collection}
+		LEFT JOIN taxonomies AS exact_term
+			ON exact_term.translation_group = pivot.taxonomy_id
+			AND exact_term.locale = ${preferredLocale}
+		LEFT JOIN taxonomies AS default_term
+			ON default_term.translation_group = pivot.taxonomy_id
+			AND default_term.locale = ${defaultLocale}
+		WHERE content.id IN (${sql.join(entryIds.map((id) => sql`${id}`))})
+			AND coalesce(exact_term.id, default_term.id) IS NOT NULL
+			${taxonomyName ? sql`AND coalesce(exact_term.name, default_term.name) = ${taxonomyName}` : sql``}
+		ORDER BY coalesce(exact_term.label, default_term.label) ASC
+	`.execute(db)).rows;
+}
+/** Invalidate cached taxonomy term data and any content that hydrates terms. */
+function invalidateTermCache() {
+	invalidateTaxonomyObjectCache();
+}
+const TAXONOMY_DEFS_CACHE_KEY = Symbol.for("emdash:taxonomy-defs");
+const taxonomyDefsStore = globalThis;
+const defsHolder = taxonomyDefsStore[TAXONOMY_DEFS_CACHE_KEY] ?? (() => {
+	const h = {
+		version: 0,
+		cache: /* @__PURE__ */ new Map()
+	};
+	taxonomyDefsStore[TAXONOMY_DEFS_CACHE_KEY] = h;
+	return h;
+})();
+/**
+* Invalidate the isolate-wide taxonomy-definitions cache (and the related
+* loader taxonomy-names cache). Called from every taxonomy-def write path
+* (`handleTaxonomyCreate`/`Update`/`Delete`, seed application). Other isolates
+* refresh on their next recycle — staleness bounded by isolate lifetime.
+*/
+function invalidateTaxonomyDefsCache() {
+	defsHolder.version++;
+	defsHolder.cache.clear();
+	resetTaxonomyNamesCache();
+	invalidateTaxonomyObjectCache();
+}
+/**
+* Fetch taxonomy definitions straight from the database (no caching).
+*/
+async function fetchTaxonomyDefs(locale) {
+	let query = (await getDb()).selectFrom("_emdash_taxonomy_defs").selectAll();
+	if (locale !== void 0) query = query.where("locale", "=", locale);
+	return (await query.execute()).map(rowToTaxonomyDef);
+}
+/**
+* Resolve taxonomy defs through the isolate fallback cache, bypassing it for
+* isolated databases. The returned promise is cached (not the resolved value)
+* so concurrent cold-isolate readers share one in-flight query; a rejection
+* evicts the entry so the next caller retries.
+*/
+function loadTaxonomyDefs(localeKey, locale) {
+	if (getRequestContext()?.dbIsIsolated === true) return fetchTaxonomyDefs(locale);
+	const existing = defsHolder.cache.get(localeKey);
+	if (existing && existing.version === defsHolder.version) return existing.promise;
+	const version = defsHolder.version;
+	const promise = fetchTaxonomyDefs(locale).catch((error) => {
+		const current = defsHolder.cache.get(localeKey);
+		if (current && current.promise === promise) defsHolder.cache.delete(localeKey);
+		throw error;
+	});
+	defsHolder.cache.set(localeKey, {
+		version,
+		promise
+	});
+	return promise;
+}
+/**
+* Get every taxonomy definition. Definitions are per-locale (one row per
+* locale inside the same translation_group) — by default we resolve to the
+* active locale.
+*
+* Two-tier cache: per-request via `requestCached` (so a single render that
+* hydrates terms for several collections pays at most one call), then
+* per-isolate via the global holder (so warm renders issue zero queries).
+* The `requestCached` key is unchanged so `getTaxonomyDef`'s peek still hits.
+*/
+async function getTaxonomyDefs(options = {}) {
+	const locale = resolveLocale(options.locale);
+	const localeKey = locale ?? "*";
+	return requestCached(`taxonomy-defs:${localeKey}`, async () => {
+		if (await isObjectCacheActive()) return cachedQuery({
+			namespace: CacheNamespace.TAXONOMIES,
+			key: `defs:${localeKey}`,
+			load: () => fetchTaxonomyDefs(locale)
+		});
+		return loadTaxonomyDefs(localeKey, locale);
+	});
+}
+/**
+* Get a single taxonomy definition by name. Uses the fallback chain so even
+* if there is no translation for the active locale we still return something.
+*
+* If `getTaxonomyDefs()` has already loaded the full list in this request
+* (which happens during entry-term hydration on every page that renders a
+* collection), search the matching def in memory rather than running a
+* second query against `_emdash_taxonomy_defs`.
+*/
+async function getTaxonomyDef(name, options = {}) {
+	const chain = resolveLocaleChain(options.locale);
+	const allDefs = peekRequestCache(`taxonomy-defs:${resolveLocale(options.locale) ?? "*"}`);
+	if (allDefs) {
+		const defs = await allDefs;
+		if (chain.length === 0) return defs.find((d) => d.name === name) ?? null;
+		for (const locale of chain) {
+			const found = defs.find((d) => d.name === name && d.locale === locale);
+			if (found) return found;
+		}
+		return null;
+	}
+	return requestCached(`taxonomy-def:${name}:${chain.join(",")}`, async () => {
+		const db = await getDb();
+		if (chain.length === 0) {
+			const row = await db.selectFrom("_emdash_taxonomy_defs").selectAll().where("name", "=", name).orderBy("locale", "asc").executeTakeFirst();
+			return row ? rowToTaxonomyDef(row) : null;
+		}
+		for (const locale of chain) {
+			const row = await db.selectFrom("_emdash_taxonomy_defs").selectAll().where("name", "=", name).where("locale", "=", locale).executeTakeFirst();
+			if (row) return rowToTaxonomyDef(row);
+		}
+		return null;
+	});
+}
+/**
+* Object-cache namespaces for values that embed visible term counts: the
+* taxonomy epoch (term/assignment writes) plus each counted collection's
+* content epoch, so publishing, unpublishing, or trashing an entry
+* invalidates the cached count promptly. Both content namespace generations
+* participate so rolling deployments preserve invalidation in either direction.
+*/
+function termCountNamespaces(collections) {
+	return [...[...new Set(collections)].flatMap((collection) => contentCacheNamespaces(collection)), CacheNamespace.TAXONOMIES];
+}
+/**
+* All terms of a taxonomy in a specific locale (flat for non-hierarchical,
+* tree for hierarchical).
+*
+* The term list and the visible-entry counts are loaded and cached separately:
+* the list depends only on the taxonomy epoch, while the counts additionally
+* depend on every counted collection's content epoch and cost an aggregate over
+* the whole assignment pivot. Callers that don't render counts pass
+* `includeCounts: false` and skip that aggregate entirely, while still sharing
+* the term list with callers that do.
+*/
+async function getTaxonomyTerms(taxonomyName, options = {}) {
+	const locale = resolveLocale(options.locale);
+	const def = await getTaxonomyDef(taxonomyName, options);
+	if (!def) return [];
+	if (options.includeCounts === false) return getTermList(def, locale);
+	const [terms, counts] = await Promise.all([getTermList(def, locale), getVisibleTermCounts(def.name, def.collections, locale)]);
+	return withCounts(terms, counts);
+}
+/**
+* Get all terms of a taxonomy with a Workers edge-cache hint.
+*
+* Use the returned `cacheHint` with `Astro.cache.set()` so pages that render
+* a taxonomy facet can be purged automatically when taxonomy terms change.
+*/
+async function getTaxonomyTermsWithCacheHint(taxonomyName, options = {}) {
+	return {
+		data: await getTaxonomyTerms(taxonomyName, options),
+		cacheHint: { tags: [taxonomyTag(taxonomyName)] }
+	};
+}
+/** Terms without counts, under the cache keys the layout prefetch warms. */
+function getTermList(def, locale) {
+	const localeKey = locale ?? "*";
+	return requestCached(`taxonomy-terms:${def.name}:${localeKey}`, () => cachedQuery({
+		namespace: CacheNamespace.TAXONOMIES,
+		key: `termList:${def.name}:${localeKey}`,
+		load: () => loadTaxonomyTerms(def, locale)
+	}));
+}
+/**
+* Copy a term list with counts attached. Counts are keyed by translation_group
+* (what the pivot stores) and are locale-independent. Rebuilds every node so
+* the shared, cached count-free list is never mutated.
+*/
+function withCounts(terms, counts) {
+	return terms.map((term) => ({
+		...term,
+		count: counts.get(term.translationGroup ?? term.id) ?? 0,
+		children: withCounts(term.children, counts)
+	}));
+}
+async function loadTaxonomyTerms(def, locale) {
+	let termsQuery = (await getDb()).selectFrom("taxonomies").selectAll().where("name", "=", def.name).orderBy("sort_order", "asc").orderBy("label", "asc");
+	if (locale !== void 0) termsQuery = termsQuery.where("locale", "=", locale);
+	const flatTerms = (await termsQuery.execute()).map((row) => ({
+		id: row.id,
+		name: row.name,
+		slug: row.slug,
+		label: row.label,
+		parent_id: row.parent_id,
+		data: row.data,
+		locale: row.locale,
+		translation_group: row.translation_group
+	}));
+	if (def.hierarchical) return buildTree(flatTerms);
+	return flatTerms.map((term) => ({
+		id: term.id,
+		name: term.name,
+		slug: term.slug,
+		label: term.label,
+		description: term.data ? JSON.parse(term.data).description : void 0,
+		children: [],
+		locale: term.locale,
+		translationGroup: term.translation_group
+	}));
+}
+/**
+* Per-translation-group visible-usage counts for one taxonomy, in a single
+* round-trip (see `fetchVisibleTermCounts`). The pivot identity is the
+* translation group, while entry rows are scoped to the resolved locale.
+* Request and object cache keys include that locale so translated views never
+* reuse each other's visible counts.
+*/
+function getVisibleTermCounts(taxonomyName, collections, locale) {
+	const scope = [...new Set(collections)].toSorted().join(",");
+	const localeScope = locale ?? "*";
+	return requestCached(`taxonomy-term-counts:${taxonomyName}:${scope}:${localeScope}`, async () => {
+		const entries = await cachedQuery({
+			namespace: termCountNamespaces(collections),
+			key: `termCounts:${taxonomyName}:${scope}:${localeScope}`,
+			load: async () => {
+				return [...await fetchVisibleTermCounts(await getDb(), taxonomyName, collections, locale)];
+			}
+		});
+		return new Map(entries);
+	});
+}
+/**
+* Get a single term by (taxonomy, slug). Honours the fallback chain — if the
+* slug exists in a fallback locale, we return that row (useful for deep-linking
+* to a term page when the translation is missing).
+*
+* The term row and its visible-entry count are loaded and cached separately: the
+* row depends only on the taxonomy epoch, while the count adds an aggregate over
+* the whole assignment pivot and every counted collection's content epoch. A
+* caller that renders no count passes `includeCounts: false` and skips it.
+*/
+async function getTerm(taxonomyName, slug, options = {}) {
+	const chain = resolveLocaleChain(options.locale);
+	const term = await getTermRow(taxonomyName, slug, chain);
+	if (!term) return null;
+	if (options.includeCounts === false) return term;
+	const counts = await getVisibleTermCounts(taxonomyName, (await getTaxonomyDef(taxonomyName, options))?.collections ?? [], chain[0] ?? term.locale);
+	return {
+		...term,
+		count: counts.get(term.translationGroup ?? term.id) ?? 0
+	};
+}
+/** A single term with its children, without counts, under the taxonomy epoch. */
+function getTermRow(taxonomyName, slug, chain) {
+	return cachedQuery({
+		namespace: CacheNamespace.TAXONOMIES,
+		key: `term:${taxonomyName}:${slug}:${chain.join(",")}`,
+		load: () => loadTerm(taxonomyName, slug, chain)
+	});
+}
+async function loadTerm(taxonomyName, slug, chain) {
+	const db = await getDb();
+	let row;
+	const selectTerm = () => db.selectFrom("taxonomies").selectAll().where("name", "=", taxonomyName).where("slug", "=", slug);
+	if (chain.length === 0) row = await selectTerm().orderBy("locale", "asc").executeTakeFirst();
+	else {
+		row = void 0;
+		for (const locale of chain) {
+			row = await selectTerm().where("locale", "=", locale).executeTakeFirst();
+			if (row) break;
+		}
+	}
+	if (!row) return null;
+	let childrenQuery = db.selectFrom("taxonomies").selectAll().where("parent_id", "=", row.translation_group ?? row.id).orderBy("sort_order", "asc").orderBy("label", "asc");
+	const termLocale = row.locale;
+	if (termLocale) childrenQuery = childrenQuery.where("locale", "=", termLocale);
+	const children = (await childrenQuery.execute()).map((child) => ({
+		id: child.id,
+		name: child.name,
+		slug: child.slug,
+		label: child.label,
+		parentId: child.parent_id ?? void 0,
+		children: [],
+		locale: child.locale,
+		translationGroup: child.translation_group
+	}));
+	return {
+		id: row.id,
+		name: row.name,
+		slug: row.slug,
+		label: row.label,
+		parentId: row.parent_id ?? void 0,
+		description: row.data ? JSON.parse(row.data).description : void 0,
+		children,
+		locale: row.locale,
+		translationGroup: row.translation_group
+	};
+}
+/**
+* Terms assigned to a content entry, resolved into the active locale and then
+* the configured default locale.
+*/
+function getEntryTerms(collection, entryId, taxonomyName, options = {}) {
+	const locale = resolveLocale(options.locale);
+	return requestCached(`terms:${collection}:${entryId}:${taxonomyName ?? "*"}:${locale ?? "*"}`, () => cachedQuery({
+		namespace: [...contentCacheNamespaces(collection), CacheNamespace.TAXONOMIES],
+		key: `entryTerms:${collection}:${entryId}:${taxonomyName ?? "*"}:${locale ?? "*"}`,
+		load: async () => {
+			return (await selectEntryTermRows(await getDb(), collection, [entryId], taxonomyName, locale)).map((row) => ({
+				id: row.id,
+				name: row.name,
+				slug: row.slug,
+				label: row.label,
+				parentId: row.parent_id ?? void 0,
+				children: [],
+				locale: row.locale,
+				translationGroup: row.translation_group
+			}));
+		}
+	}));
+}
+/**
+* Terms for multiple entries of one taxonomy, single query.
+*/
+async function getTermsForEntries(collection, entryIds, taxonomyName, options = {}) {
+	const uniqueIds = [...new Set(entryIds)];
+	if (uniqueIds.length === 0) return /* @__PURE__ */ new Map();
+	const locale = resolveLocale(options.locale);
+	const localeKey = locale ?? "*";
+	const load = async () => {
+		const result = /* @__PURE__ */ new Map();
+		for (const id of uniqueIds) result.set(id, []);
+		const missedIds = [];
+		const cacheReads = [];
+		for (const id of uniqueIds) {
+			const cached = peekRequestCache(`terms:${collection}:${id}:${taxonomyName}:${localeKey}`);
+			if (cached) cacheReads.push(cached.then((terms) => ({
+				id,
+				terms
+			}), () => ({
+				id,
+				miss: true
+			})));
+			else missedIds.push(id);
+		}
+		for (const read of await Promise.all(cacheReads)) {
+			if ("miss" in read) {
+				missedIds.push(read.id);
+				continue;
+			}
+			result.set(read.id, read.terms.map((t) => ({
+				...t,
+				children: [...t.children]
+			})));
+		}
+		if (missedIds.length === 0) return [...result.entries()];
+		const db = await getDb();
+		for (const chunk of chunks(missedIds, SQL_BATCH_SIZE)) {
+			let rows;
+			try {
+				rows = await selectEntryTermRows(db, collection, chunk, taxonomyName, locale);
+			} catch (error) {
+				if (isMissingTableError(error)) return [...result.entries()];
+				throw error;
+			}
+			for (const row of rows) {
+				const term = {
+					id: row.id,
+					name: row.name,
+					slug: row.slug,
+					label: row.label,
+					parentId: row.parent_id ?? void 0,
+					children: [],
+					locale: row.locale,
+					translationGroup: row.translation_group
+				};
+				const terms = result.get(row.entry_id);
+				if (terms) terms.push(term);
+			}
+		}
+		return [...result.entries()];
+	};
+	const idKey = uniqueIds.toSorted().join(",");
+	const pairs = idKey.length <= 256 ? await cachedQuery({
+		namespace: [...contentCacheNamespaces(collection), CacheNamespace.TAXONOMIES],
+		key: `termsForEntries:${collection}:${taxonomyName}:${locale ?? "*"}:${idKey}`,
+		load
+	}) : await load();
+	return new Map(pairs);
+}
+/**
+* Batch-fetch terms for multiple entries across ALL taxonomies in one query.
+* Primes the request-cache for subsequent per-entry calls to `getEntryTerms`.
+*/
+async function getAllTermsForEntries(collection, entryIds, options = {}) {
+	const result = /* @__PURE__ */ new Map();
+	const uniqueIds = [...new Set(entryIds)];
+	for (const id of uniqueIds) result.set(id, {});
+	if (uniqueIds.length === 0) return result;
+	const db = await getDb();
+	const locale = resolveLocale(options.locale);
+	const applicableTaxonomyNames = await getCollectionTaxonomyNames(collection, { locale });
+	for (const chunk of chunks(uniqueIds, SQL_BATCH_SIZE)) {
+		let rows;
+		try {
+			rows = await selectEntryTermRows(db, collection, chunk, void 0, locale);
+		} catch (error) {
+			if (isMissingTableError(error)) {
+				for (const id of uniqueIds) primeEntryTermsCache(collection, id, {}, applicableTaxonomyNames, locale);
+				return result;
+			}
+			throw error;
+		}
+		for (const row of rows) {
+			const term = {
+				id: row.id,
+				name: row.name,
+				slug: row.slug,
+				label: row.label,
+				parentId: row.parent_id ?? void 0,
+				children: [],
+				locale: row.locale,
+				translationGroup: row.translation_group
+			};
+			const byTaxonomy = result.get(row.entry_id);
+			if (!byTaxonomy) continue;
+			const existing = byTaxonomy[row.name];
+			if (existing) existing.push(term);
+			else byTaxonomy[row.name] = [term];
+		}
+	}
+	for (const [entryId, byTaxonomy] of result) primeEntryTermsCache(collection, entryId, byTaxonomy, applicableTaxonomyNames, locale);
+	return result;
+}
+/**
+* Return the list of taxonomy names applicable to a collection, request-
+* cached so a page render only pays for it once.
+*
+* Returns an empty list when taxonomies haven't been defined yet.
+*/
+async function getCollectionTaxonomyNames(collection, options) {
+	try {
+		return (await getTaxonomyDefs(options)).filter((d) => d.collections.includes(collection)).map((d) => d.name);
+	} catch (error) {
+		if (isMissingTableError(error)) return [];
+		throw error;
+	}
+}
+/**
+* Pre-populate the request-cache for every getEntryTerms call-shape that
+* could hit this entry:
+*
+*   getEntryTerms(collection, entryId)                 -> key `terms:C:E:*`
+*   getEntryTerms(collection, entryId, "tag")          -> key `terms:C:E:tag`
+*   getEntryTerms(collection, entryId, "category")     -> key `terms:C:E:category`
+*   ...one per taxonomy that applies to this collection
+*
+* Taxonomies with no rows on this entry are seeded with `[]` so legacy
+* callers short-circuit to the cached empty array instead of re-querying.
+*/
+function primeEntryTermsCache(collection, entryId, byTaxonomy, applicableTaxonomyNames, locale) {
+	const localeKey = locale ?? "*";
+	for (const name of applicableTaxonomyNames) setRequestCacheEntry(`terms:${collection}:${entryId}:${name}:${localeKey}`, byTaxonomy[name] ?? []);
+	for (const [name, terms] of Object.entries(byTaxonomy)) setRequestCacheEntry(`terms:${collection}:${entryId}:${name}:${localeKey}`, terms);
+	const allTerms = Object.values(byTaxonomy).flat();
+	setRequestCacheEntry(`terms:${collection}:${entryId}:*:${localeKey}`, allTerms);
+}
+/**
+* Prime the per-entry request cache from terms that were folded into the
+* content query (query.ts `hydrateEntryTerms` fast path), so subsequent
+* `getEntryTerms` calls in the same render hit the cache instead of issuing an
+* N+1 query. Seeds the wildcard key and one key per taxonomy present on the
+* entry — purely from the folded data, with no DB lookup.
+*
+* Unlike `getAllTermsForEntries`, this deliberately does NOT seed `[]` for
+* taxonomies that apply to the collection but have no rows on the entry: doing
+* so would require a `getTaxonomyDefs` query, adding a round trip to every fold
+* render to serve the rarer `getEntryTerms(id, absentTaxonomy)` case from cache.
+* That call simply falls through to its own cached query. Keeping the key shape
+* here (rather than in query.ts) prevents the two from drifting.
+*/
+function primeFoldedEntryTerms(collection, perEntry, options = {}) {
+	if (perEntry.length === 0) return;
+	const locale = resolveLocale(options.locale);
+	for (const { entryId, byTaxonomy } of perEntry) primeEntryTermsCache(collection, entryId, byTaxonomy, [], locale);
+}
+/**
+* Get entries by term. Both the lookup (term slug in the active locale) and
+* the content query respect the active locale.
+*/
+async function getEntriesByTerm(collection, taxonomyName, termSlug, options = {}) {
+	const { getEmDashCollection } = await import("./query-D-lxiOgn.mjs").then((n) => n.o);
+	const queryOptions = { where: { [taxonomyName]: termSlug } };
+	if (options.locale !== void 0) queryOptions.locale = options.locale;
+	const { entries } = await getEmDashCollection(collection, queryOptions);
+	return entries;
+}
+function rowToTaxonomyDef(row) {
+	return {
+		id: row.id,
+		name: row.name,
+		label: row.label,
+		labelSingular: row.label_singular ?? void 0,
+		hierarchical: row.hierarchical === 1,
+		collections: row.collections ? JSON.parse(row.collections) : [],
+		locale: row.locale,
+		translationGroup: row.translation_group
+	};
+}
+/**
+* Build tree structure from flat terms
+*/
+function buildTree(flatTerms) {
+	const byLocaleGroup = /* @__PURE__ */ new Map();
+	const nodes = [];
+	const roots = [];
+	for (const term of flatTerms) {
+		const node = {
+			id: term.id,
+			name: term.name,
+			slug: term.slug,
+			label: term.label,
+			parentId: term.parent_id ?? void 0,
+			description: term.data ? JSON.parse(term.data).description : void 0,
+			children: [],
+			locale: term.locale,
+			translationGroup: term.translation_group
+		};
+		byLocaleGroup.set(`${term.locale}::${term.translation_group ?? term.id}`, node);
+		nodes.push(node);
+	}
+	for (const node of nodes) {
+		const parent = node.parentId ? byLocaleGroup.get(`${node.locale}::${node.parentId}`) : void 0;
+		if (parent) parent.children.push(node);
+		else roots.push(node);
+	}
+	return roots;
+}
+
+//#endregion
+export { getTaxonomyDefs as a, getTerm as c, invalidateTermCache as d, taxonomies_exports as f, getTaxonomyDef as i, getTermsForEntries as l, getEntriesByTerm as n, getTaxonomyTerms as o, fetchVisibleTermCounts as p, getEntryTerms as r, getTaxonomyTermsWithCacheHint as s, getAllTermsForEntries as t, invalidateTaxonomyDefsCache as u };
+//# sourceMappingURL=taxonomies-BpqpXJUE.mjs.map