emdash 0.31.1 → 0.33.0

package/src/query.ts

@@ -29,6 +29,7 @@ import { getFallbackChain, getI18nConfig, isI18nEnabled } from "./i18n/config.js
 import {
 	CURSOR_RAW_VALUES,
 	FOLDED_BYLINES,
+	FOLDED_BYLINES_EXIST,
 	FOLDED_TERMS,
 	type WhereRange,
 	type WhereValue,
@@ -310,17 +311,6 @@ function dataStr(data: Record<string, unknown>, key: string, fallback = ""): str
 	return typeof val === "string" ? val : fallback;
 }
 
-/** Safely read a date-like field from a Record */
-function dataDate(data: Record<string, unknown>, key: string): Date | undefined {
-	const val = data[key];
-	if (val instanceof Date) {
-		return Number.isNaN(val.getTime()) ? undefined : val;
-	}
-	if (typeof val !== "string" && typeof val !== "number") return undefined;
-	const date = new Date(val);
-	return Number.isNaN(date.getTime()) ? undefined : date;
-}
-
 /** Type guard for Record<string, unknown> */
 function isRecord(value: unknown): value is Record<string, unknown> {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -347,6 +337,23 @@ function entryEditOptions(entry: { data?: unknown }): EditableOptions {
 	return { status, hasDraft };
 }
 
+function stripRevisionMetadata(entry: { data?: unknown }): void {
+	const data = entryData(entry);
+	delete data.draftRevisionId;
+	delete data.liveRevisionId;
+}
+
+function canExposeRevisionMetadata(
+	entry: { id: string; data?: unknown },
+	collection: string,
+): boolean {
+	const ctx = getRequestContext();
+	if (ctx?.editMode) return true;
+	if (ctx?.preview?.collection !== collection) return false;
+	const dbId = entryDatabaseId(entry);
+	return ctx.preview.id === dbId || ctx.preview.id === entry.id;
+}
+
 /**
  * Get all entries of a content type
  *
@@ -441,7 +448,11 @@ async function loadCollectionCached<T extends string, D = InferCollectionData<T>
 		return { entries: [], error: snapshot.error, cacheHint: snapshot.cacheHint };
 	}
 	return {
-		entries: snapshot.value.entries.map((entry) => reviveEntry<D>(entry)),
+		entries: snapshot.value.entries.map((entry) => {
+			const revived = reviveEntry<D>(entry);
+			if (!canExposeRevisionMetadata(revived, type)) stripRevisionMetadata(revived);
+			return revived;
+		}),
 		nextCursor: snapshot.value.nextCursor,
 		hasMore: snapshot.value.hasMore,
 		cacheHint: snapshot.value.cacheHint,
@@ -729,6 +740,9 @@ async function getEmDashCollectionUncached<T extends string, D = InferCollection
 		if (isEditMode) {
 			tagEditableFields(entryData(entry), type, dbId);
 		}
+		if (!canExposeRevisionMetadata(entry, type)) {
+			stripRevisionMetadata(entry);
+		}
 		return {
 			...entry,
 			edit: isEditMode ? createEditable(type, dbId, entryEditOptions(entry)) : createNoop(),
@@ -804,23 +818,9 @@ export async function getEmDashEntry<T extends string, D = InferCollectionData<T
 		};
 	}
 
-	/** Check if an entry is publicly visible (published or scheduled past its time) */
+	/** Check if an entry has completed publication. */
 	function isVisible(entry: ContentEntry<D>): boolean {
-		const data = entryData(entry);
-		const status = dataStr(data, "status");
-		const scheduledAt = dataDate(data, "scheduledAt");
-		const isPublished = status === "published";
-		const isScheduledAndReady =
-			status === "scheduled" && scheduledAt !== undefined && scheduledAt.getTime() <= Date.now();
-		return isPublished || !!isScheduledAndReady;
-	}
-
-	/** True when an entry is scheduled to become visible at a future time. */
-	function isPendingScheduled(entry: ContentEntry<D>): boolean {
-		const data = entryData(entry);
-		if (dataStr(data, "status") !== "scheduled") return false;
-		const scheduledAt = dataDate(data, "scheduledAt");
-		return scheduledAt !== undefined && scheduledAt.getTime() > Date.now();
+		return dataStr(entryData(entry), "status") === "published";
 	}
 
 	// Build the fallback chain: [requestedLocale, fallback1, ..., defaultLocale]
@@ -833,6 +833,7 @@ export async function getEmDashEntry<T extends string, D = InferCollectionData<T
 		wrapped: ContentEntry<D>,
 		opts: { isPreview: boolean; fallbackLocale?: string; cacheHint: CacheHint },
 	): Promise<EntryResult<D>> {
+		if (!opts.isPreview) stripRevisionMetadata(wrapped);
 		// Hydrate terms in the entry's resolved locale (fallback-aware) so a
 		// localized entry never picks up default-locale taxonomy terms (#1441).
 		// When i18n is disabled we leave the locale unset to preserve the
@@ -929,11 +930,6 @@ export async function getEmDashEntry<T extends string, D = InferCollectionData<T
 	// hydration) is wrapped in the distributed L2 cache, keyed by the requested
 	// locale. Preview/edit requests took the `serveDrafts` branch above and
 	// never reach here; the object cache additionally bypasses them.
-	// A scheduled entry becomes visible on a future clock tick, not on a write,
-	// so an L2 snapshot taken before its time would keep it hidden past go-live
-	// (until the publish sweep bumps the epoch or the TTL lapses). Mark such a
-	// resolution time-sensitive and skip caching it.
-	let timeSensitive = false;
 
 	const resolveNormal = async (): Promise<EntryResult<D>> => {
 		for (let i = 0; i < localeChain.length; i++) {
@@ -952,9 +948,6 @@ export async function getEmDashEntry<T extends string, D = InferCollectionData<T
 					cacheHint: cacheHint ?? {},
 				});
 			}
-			if (entry && isPendingScheduled(entry)) {
-				timeSensitive = true;
-			}
 			// Entry not found or not visible in this locale — try next
 		}
 		return { entry: null, isPreview: false, cacheHint: {} };
@@ -978,14 +971,16 @@ export async function getEmDashEntry<T extends string, D = InferCollectionData<T
 				},
 			};
 		},
-		cacheable: (snap) => snap.ok && !timeSensitive,
+		cacheable: (snap) => snap.ok,
 	});
 
 	if (!snapshot.ok) {
 		return { entry: null, error: snapshot.error, isPreview: false, cacheHint: snapshot.cacheHint };
 	}
+	const revived = snapshot.value.entry ? reviveEntry<D>(snapshot.value.entry) : null;
+	if (revived && !canExposeRevisionMetadata(revived, type)) stripRevisionMetadata(revived);
 	return {
-		entry: snapshot.value.entry ? reviveEntry<D>(snapshot.value.entry) : null,
+		entry: revived,
 		isPreview: snapshot.value.isPreview,
 		fallbackLocale: snapshot.value.fallbackLocale,
 		cacheHint: snapshot.value.cacheHint,
@@ -1036,18 +1031,29 @@ async function hydrateEntryBylines<D>(type: string, entries: ContentEntry<D>[]):
 			return { data, credits };
 		});
 
+		// An empty `_emdash_bylines` table makes an empty fold authoritative: no
+		// credit can exist in any locale and the author fallback has no byline
+		// to resolve to, so skip the query path and the custom-fields probe
+		// entirely. A missing marker (older cached rows) means "unknown" and
+		// keeps the conservative fallback below.
+		const knownEmpty = entries.every(
+			(e) => Reflect.get(entryData(e), FOLDED_BYLINES_EXIST) === false,
+		);
+
 		// Fall back to the full query path when the fold can't be trusted to be
 		// complete: an entry with a byline reference (explicit primary, or an
 		// author for the author-fallback) but no folded credits — e.g. a credit
 		// in a different locale than the row, which the locale-correlated subquery
 		// skips, or the author-fallback path which the fold doesn't express.
-		let needsQueryPath = parsed.some(
-			(p) =>
-				p.credits.length === 0 &&
-				(dataStr(p.data, "authorId") !== "" || dataStr(p.data, "primaryBylineId") !== ""),
-		);
+		let needsQueryPath =
+			!knownEmpty &&
+			parsed.some(
+				(p) =>
+					p.credits.length === 0 &&
+					(dataStr(p.data, "authorId") !== "" || dataStr(p.data, "primaryBylineId") !== ""),
+			);
 		let hasCustomFields = false;
-		if (!needsQueryPath) {
+		if (!needsQueryPath && !knownEmpty) {
 			try {
 				const { getDb } = await import("./loader.js");
 				const db = await getDb();

package/src/redirects/cache.ts

@@ -1,19 +1,27 @@
 /**
  * Redirect rule cache.
  *
- * Module-level cache for enabled redirect rules. The middleware populates this
- * on first request; route handlers invalidate it on writes.
+ * Worker-isolate cache for enabled redirect rules. The middleware populates
+ * this on first request; route handlers invalidate it on writes. Cached rules
+ * expire so writes handled by another isolate become visible here too.
  *
  * Both exact-match and pattern rules are loaded from one query and cached
  * together: exact rules indexed by source path in a Map, pattern rules
  * pre-compiled into an array. A single warm request issues zero database
- * queries; a cold isolate issues one.
+ * queries; a cold or expired isolate issues one.
  *
  * This module deliberately has NO Astro imports so it can be safely imported
  * from handlers, seed, CLI, and tests without dragging in `astro:middleware`.
  */
 
+import { after } from "../after.js";
 import type { Redirect } from "../database/repositories/redirect.js";
+import {
+	createSingleFlightCache,
+	type SingleFlightCache,
+	invalidateSingleFlightCache,
+	singleFlightCached,
+} from "../utils/single-flight-cache.js";
 import type { CompiledPattern } from "./patterns.js";
 import { compilePattern, interpolateDestination, matchPattern } from "./patterns.js";
 
@@ -29,33 +37,54 @@ export interface CachedRedirects {
 	patterns: CachedRedirectRule[];
 }
 
-/**
- * Cached enabled redirects.
- * null = not yet populated, object = cached.
- */
-let cachedRedirects: CachedRedirects | null = null;
+interface RedirectCacheState {
+	redirects: CachedRedirects | null;
+	expiresAt: number;
+	generation: number;
+	refresh: SingleFlightCache<CachedRedirects>;
+}
+
+const REDIRECT_CACHE_TTL_MS = 30_000;
+const REDIRECT_CACHE_MAX_REFRESH_ATTEMPTS = 3;
+const REDIRECT_CACHE_KEY = Symbol.for("emdash:redirect-cache");
+const g = globalThis as Record<symbol, unknown>;
+const cacheState: RedirectCacheState =
+	// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-context.ts)
+	(g[REDIRECT_CACHE_KEY] as RedirectCacheState | undefined) ??
+	(() => {
+		const state: RedirectCacheState = {
+			redirects: null,
+			expiresAt: 0,
+			generation: 0,
+			refresh: createSingleFlightCache<CachedRedirects>(),
+		};
+		g[REDIRECT_CACHE_KEY] = state;
+		return state;
+	})();
 
 /**
  * Invalidate the cached redirects (both exact and pattern).
  * Call when redirects are created, updated, or deleted.
  */
 export function invalidateRedirectCache(): void {
-	cachedRedirects = null;
+	cacheState.generation++;
+	cacheState.redirects = null;
+	cacheState.expiresAt = 0;
+	invalidateSingleFlightCache(cacheState.refresh);
 }
 
 /**
  * Get the cached redirects, or null if the cache is cold.
  */
-export function getCachedRedirects(): CachedRedirects | null {
-	return cachedRedirects;
+function getCachedRedirects(): CachedRedirects | null {
+	if (cacheState.redirects && Date.now() >= cacheState.expiresAt) {
+		invalidateRedirectCache();
+	}
+	return cacheState.redirects;
 }
 
-/**
- * Populate the cache from a list of enabled redirects (both exact and
- * pattern). The caller is responsible for passing only enabled rows — the
- * cache stores them as-is.
- */
-export function setCachedRedirects(redirects: Redirect[]): CachedRedirects {
+/** Compile enabled database rows into the in-memory lookup structures. */
+function compileRedirects(redirects: Redirect[]): CachedRedirects {
 	const exact = new Map<string, Redirect>();
 	const patterns: CachedRedirectRule[] = [];
 	for (const r of redirects) {
@@ -65,8 +94,39 @@ export function setCachedRedirects(redirects: Redirect[]): CachedRedirects {
 			exact.set(r.source, r);
 		}
 	}
-	cachedRedirects = { exact, patterns };
-	return cachedRedirects;
+	return { exact, patterns };
+}
+
+function installCachedRedirects(redirects: CachedRedirects): CachedRedirects {
+	cacheState.redirects = redirects;
+	cacheState.expiresAt = Date.now() + REDIRECT_CACHE_TTL_MS;
+	return cacheState.redirects;
+}
+
+export async function loadCachedRedirects(
+	load: () => Promise<Redirect[]>,
+): Promise<CachedRedirects> {
+	for (let attempt = 0; attempt < REDIRECT_CACHE_MAX_REFRESH_ATTEMPTS; attempt++) {
+		const cached = getCachedRedirects();
+		if (cached) return cached;
+
+		const generation = cacheState.generation;
+		const loaded = await singleFlightCached(
+			cacheState.refresh,
+			async () => compileRedirects(await load()),
+			{ anchor: (promise) => after(() => promise), ownerTimeoutMs: 30_000 },
+		);
+
+		if (generation === cacheState.generation) {
+			return installCachedRedirects(loaded);
+		}
+
+		if (attempt === REDIRECT_CACHE_MAX_REFRESH_ATTEMPTS - 1) {
+			return loaded;
+		}
+	}
+
+	throw new Error("Redirect cache refresh exhausted without loading rules");
 }
 
 /**

package/src/request-context.ts

@@ -20,6 +20,7 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 
 import type { QueryRecorder } from "./database/instrumentation.js";
+import type { DeferredTaskTracker } from "./deferred-tasks.js";
 
 /**
  * Lightweight always-on counters surfaced in Server-Timing.
@@ -102,6 +103,8 @@ export interface EmDashRequestContext {
 	 * and `requestCached`.
 	 */
 	metrics?: RequestMetrics;
+	/** Deferred work that owns resources scoped to this request. */
+	deferredTasks?: DeferredTaskTracker;
 }
 
 const ALS_KEY = Symbol.for("emdash:request-context");

package/src/scheduled-publish.ts

@@ -40,7 +40,11 @@ export const SCHEDULED_PUBLISH_BATCH_LIMIT = 100;
 export type ScheduledPublishFn = (
 	collection: string,
 	id: string,
-	options: { publishedAt?: string; requireScheduledDue?: boolean },
+	options: {
+		publishedAt?: string;
+		requireScheduledDue?: boolean;
+		expectedScheduledAt?: string;
+	},
 ) => Promise<{ success: boolean; error?: { code?: string } }>;
 
 export interface PublishDueContentOptions {
@@ -114,6 +118,7 @@ export async function publishDueContent(
 				const result = await doPublish(collection.slug, item.id, {
 					publishedAt,
 					requireScheduledDue: true,
+					expectedScheduledAt: item.scheduledAt ?? undefined,
 				});
 				if (result.success) {
 					batch.push({ collection: collection.slug, id: item.id });

package/src/schema/registry.ts

@@ -73,6 +73,19 @@ const VALID_COLLECTION_SUPPORTS: ReadonlySet<string> = new Set<CollectionSupport
 // multi-row INSERT below D1's 100-parameter statement limit.
 const SEED_FIELD_INSERT_BATCH_SIZE = 6;
 
+/**
+ * Rank given to collections without an explicit `sort_order`. SQLite sorts
+ * NULL first on ASC while Postgres sorts it last, so the fallback is
+ * materialised with COALESCE rather than left to the dialect.
+ */
+const UNORDERED_COLLECTION_RANK = 2147483647;
+
+/**
+ * Collection ordering shared by every list read: explicit `sort_order`
+ * first (ascending), then alphabetically by slug.
+ */
+const collectionOrder = sql<number>`coalesce(sort_order, ${sql.lit(UNORDERED_COLLECTION_RANK)})`;
+
 function isCollectionSupport(value: unknown): value is CollectionSupport {
 	return typeof value === "string" && VALID_COLLECTION_SUPPORTS.has(value);
 }
@@ -126,6 +139,7 @@ export class SchemaRegistry {
 		const rows = await this.db
 			.selectFrom("_emdash_collections")
 			.selectAll()
+			.orderBy(collectionOrder, "asc")
 			.orderBy("slug", "asc")
 			.execute();
 
@@ -177,6 +191,7 @@ export class SchemaRegistry {
 		const collectionRows = await this.db
 			.selectFrom("_emdash_collections")
 			.selectAll()
+			.orderBy(collectionOrder, "asc")
 			.orderBy("slug", "asc")
 			.execute();
 
@@ -256,6 +271,8 @@ export class SchemaRegistry {
 					supports: JSON.stringify(supports),
 					source: input.source ?? "manual",
 					has_seo: hasSeo ? 1 : 0,
+					hidden: input.hidden ? 1 : 0,
+					sort_order: input.sortOrder ?? null,
 					comments_enabled: input.commentsEnabled ? 1 : 0,
 					url_pattern: input.urlPattern ?? null,
 				})
@@ -354,6 +371,8 @@ export class SchemaRegistry {
 						supports: JSON.stringify(supports),
 						source: "seed",
 						has_seo: hasSeo ? 1 : 0,
+						hidden: input.hidden ? 1 : 0,
+						sort_order: input.sortOrder ?? null,
 						comments_enabled: input.commentsEnabled ? 1 : 0,
 						url_pattern: input.urlPattern ?? null,
 					})
@@ -416,6 +435,9 @@ export class SchemaRegistry {
 							? (input.urlPattern ?? null)
 							: (existing.urlPattern ?? null),
 					has_seo: hasSeo ? 1 : 0,
+					hidden: input.hidden !== undefined ? (input.hidden ? 1 : 0) : existing.hidden ? 1 : 0,
+					sort_order:
+						input.sortOrder !== undefined ? input.sortOrder : (existing.sortOrder ?? null),
 					comments_enabled:
 						input.commentsEnabled !== undefined
 							? input.commentsEnabled
@@ -822,7 +844,12 @@ export class SchemaRegistry {
 		const ftsActive = config?.enabled === true;
 
 		if (wantsSearch && searchableFields.length > 0 && ftsActive) {
-			await ftsManager.rebuildIndex(collectionSlug, searchableFields, config?.weights);
+			await ftsManager.rebuildIndex(
+				collectionSlug,
+				searchableFields,
+				config?.weights,
+				config?.tokenize,
+			);
 		} else if (ftsActive && (!wantsSearch || searchableFields.length === 0)) {
 			await ftsManager.disableSearch(collectionSlug);
 		}
@@ -876,6 +903,60 @@ export class SchemaRegistry {
 		}
 	}
 
+	/**
+	 * Reorder collections in the admin sidebar.
+	 *
+	 * `slugs` is the full desired order: every listed collection gets its
+	 * index as `sort_order`, and any collection left out has its explicit
+	 * position cleared, dropping it back to the alphabetical tail. Unknown or
+	 * duplicate slugs throw before anything is written.
+	 */
+	async reorderCollections(slugs: string[]): Promise<void> {
+		const known = new Set((await this.listCollections()).map((collection) => collection.slug));
+
+		const unknown = slugs.filter((slug) => !known.has(slug));
+		if (unknown.length > 0) {
+			throw new SchemaError(
+				`Unknown collection${unknown.length > 1 ? "s" : ""}: ${unknown.join(", ")}`,
+				"COLLECTION_NOT_FOUND",
+				{ slugs: unknown },
+			);
+		}
+
+		const duplicates = slugs.filter((slug, index) => slugs.indexOf(slug) !== index);
+		if (duplicates.length > 0) {
+			throw new SchemaError(
+				`Duplicate collection${duplicates.length > 1 ? "s" : ""}: ${[...new Set(duplicates)].join(", ")}`,
+				"DUPLICATE_SLUG",
+				{ slugs: [...new Set(duplicates)] },
+			);
+		}
+
+		const now = new Date().toISOString();
+		const ordered = new Set(slugs);
+
+		await withTransaction(this.db, async (trx) => {
+			for (const [index, slug] of slugs.entries()) {
+				await trx
+					.updateTable("_emdash_collections")
+					.set({ sort_order: index, updated_at: now })
+					.where("slug", "=", slug)
+					.execute();
+			}
+
+			const cleared = [...known].filter((slug) => !ordered.has(slug));
+			// Chunked to stay under D1's bound-parameter limit; typical sites
+			// clear far fewer than one chunk.
+			for (const slugChunk of chunks(cleared, SQL_BATCH_SIZE)) {
+				await trx
+					.updateTable("_emdash_collections")
+					.set({ sort_order: null, updated_at: now })
+					.where("slug", "in", slugChunk)
+					.execute();
+			}
+		});
+	}
+
 	/**
 	 * Reorder fields
 	 */
@@ -984,9 +1065,18 @@ export class SchemaRegistry {
 			ON ${sql.ref(tableName)} (locale)
 		`.execute(conn);
 
+		// Names must stay identical to migration 055, which creates these indexes
+		// on tables that already exist. Lookups that don't constrain `deleted_at`
+		// (menu and reference resolution) need the first; reads that do need the
+		// second.
+		await sql`
+			CREATE INDEX ${sql.ref(`idx_${tableName}_tg_locale`)}
+			ON ${sql.ref(tableName)} (translation_group, locale)
+		`.execute(conn);
+
 		await sql`
-			CREATE INDEX ${sql.ref(`idx_${tableName}_translation_group`)}
-			ON ${sql.ref(tableName)} (translation_group)
+			CREATE INDEX ${sql.ref(`idx_${tableName}_del_tg_locale`)}
+			ON ${sql.ref(tableName)} (deleted_at, translation_group, locale)
 		`.execute(conn);
 
 		// Composite indexes for optimized query performance (see migration 033)
@@ -1228,6 +1318,8 @@ export class SchemaRegistry {
 			source: row.source && isCollectionSource(row.source) ? row.source : undefined,
 			hasSeo: row.has_seo === 1,
 			urlPattern: row.url_pattern ?? undefined,
+			hidden: row.hidden === 1,
+			sortOrder: row.sort_order ?? undefined,
 			commentsEnabled: row.comments_enabled === 1,
 			commentsModeration:
 				moderation === "all" || moderation === "first_time" || moderation === "none"

package/src/schema/types.ts

@@ -171,6 +171,19 @@ export interface Collection {
 	hasSeo: boolean;
 	/** URL pattern with {slug} placeholder (e.g. "/{slug}", "/blog/{slug}") */
 	urlPattern?: string;
+	/**
+	 * Omit this collection's auto-generated entry from the admin sidebar.
+	 * The collection stays fully functional everywhere else (API, MCP, hooks,
+	 * direct `/content/:collection` URLs) — this only hides the nav link, so a
+	 * plugin that owns the collection can point editors at its own admin UI.
+	 */
+	hidden: boolean;
+	/**
+	 * Explicit position in the admin sidebar. Collections with a `sortOrder`
+	 * come first, in ascending order; the rest keep the alphabetical-by-slug
+	 * order and follow. `undefined` means "no explicit position".
+	 */
+	sortOrder?: number;
 	/** Whether comments are enabled for this collection */
 	commentsEnabled: boolean;
 	/** Moderation strategy: "all" | "first_time" | "none" */
@@ -219,6 +232,10 @@ export interface CreateCollectionInput {
 	source?: CollectionSource;
 	urlPattern?: string;
 	hasSeo?: boolean;
+	/** Omit the auto-generated admin sidebar entry (defaults to false) */
+	hidden?: boolean;
+	/** Explicit admin sidebar position (omit for the alphabetical fallback) */
+	sortOrder?: number | null;
 	commentsEnabled?: boolean;
 }
 
@@ -233,6 +250,10 @@ export interface UpdateCollectionInput {
 	supports?: CollectionSupport[];
 	urlPattern?: string;
 	hasSeo?: boolean;
+	/** Omit the auto-generated admin sidebar entry */
+	hidden?: boolean;
+	/** Explicit admin sidebar position; `null` clears it back to alphabetical */
+	sortOrder?: number | null;
 	commentsEnabled?: boolean;
 	commentsModeration?: "all" | "first_time" | "none";
 	commentsClosedAfterDays?: number;
@@ -331,6 +352,9 @@ export const RESERVED_COLLECTION_SLUGS = [
 	"taxonomies",
 	"options",
 	"audit_logs",
+	// Shadowed by the static POST /schema/collections/reorder route: a
+	// collection with this slug could never be addressed at its own URL.
+	"reorder",
 ];
 
 /**