@dyrected/core 2.18.1 → 2.20.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as Field, B as Block, C as CollectionConfig, D as DyrectedConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, G as GlobalConfig, a as DeclarativeHookExpression, W as WorkflowConfig, b as AuthenticatedUser, c as WorkflowTransition, L as LifecycleEventName, d as LifecycleEvent, e as DatabaseAdapter, f as BaseDocument, H as HookRequestContext, T as TaskRunResult, g as TaskConfig, h as DetailActionOptions, i as DetailAction, j as DetailComputedOptions, k as ComputedHandler, l as DetailComputed, m as DetailCustomOptions, n as DetailCustom, o as DetailDividerOptions, p as DetailDivider, q as DisplayFieldOptions, r as DetailField, s as DetailItem, t as DetailGridOptions, u as DetailGrid, v as DetailRepeatOptions, w as DetailRepeat, x as DetailSectionOptions, y as DetailSection, z as DetailTabOptions, E as DetailTab, I as DetailTabsOptions, J as DetailTabs, K as DetailTextOptions, M as DetailText, N as DetailSchema, O as DyrectedContext, Q as AIConfig, R as AIPIIConfig, S as IdStrategy, U as CompiledNavTree, V as CompiledNavItem, X as UserNavigationPreferences, Y as DefineWorkspaceOptions, Z as ViewConfig, _ as ArrayField, $ as FieldType, a0 as BooleanField, a1 as AuthConfig, a2 as AccessPolicyResolver, a3 as DateField, a4 as DateTimeField, a5 as EmailField, a6 as IconField, a7 as ImageField, a8 as JoinField, a9 as JsonField, aa as MoneyField, ab as MultiSelectField, ac as NumberField, ad as ObjectField, ae as RadioField, af as RelationshipField, ag as RichTextField, ah as RowField, ai as SelectField, aj as TextField, ak as TextareaField, al as TimeField, am as UrlField } from './app-x7J5BIqK.cjs';
-export { an as AIAction, ao as AIActionStatus, ap as AIActionType, aq as AIAuditActionType, ar as AIAuditRecord, as as AIChunk, at as AIMessage, au as AIPIIPattern, av as AIRateLimitResult, aw as AIRateLimitStore, ax as AIThread, ay as AIToolContext, az as AIToolDefinition, aA as AI_ACTIONS_COLLECTION, aB as AI_AUDIT_COLLECTION, aC as AI_CHUNKS_COLLECTION, aD as AI_MESSAGES_COLLECTION, aE as AI_THREADS_COLLECTION, aF as AccessConfig, aG as AccessFunction, aH as AccessFunctionArgs, aI as AccessResult, aJ as AccessRule, aK as ActionConfig, aL as ActionConfigBase, aM as ActionConfigWithHandler, aN as ActionConfigWithMutation, aO as ActionContext, aP as ActionType, aQ as AdminAuthAccessResolution, aR as AdminAuthClaimMapping, aS as AdminAuthMember, aT as AdminAuthProvider, aU as AdminAuthProviderMembersConfig, aV as AdminAuthProvisioningMode, aW as AdminAuthResolveAccessArgs, aX as AdminAuthResolvedIdentity, aY as AdminConfig, aZ as AdminDashboardComponentSlots, a_ as AdminIconName, a$ as AggregateArgs, b0 as AggregateCastType, b1 as AggregateCollectionResult, b2 as AggregateInput, b3 as AggregateOperation, b4 as AggregateResult, b5 as BaseAdminAuthProvider, b6 as BaseFieldAdmin, b7 as BlockVariant, b8 as BlocksField, b9 as BooleanFieldAdmin, ba as BooleanFormat, bb as CURRENT_NAV_PREFERENCES_VERSION, bc as CalendarViewConfig, bd as CardsViewConfig, be as CharacterLimitFieldAdmin, bf as CharacterLimitFieldConfig, bg as CollectionAfterChangeHook, bh as CollectionAfterDeleteHook, bi as CollectionAfterReadHook, bj as CollectionAfterReadHookEntry, bk as CollectionAfterTransitionHook, bl as CollectionBeforeChangeHook, bm as CollectionBeforeChangeHookEntry, bn as CollectionBeforeCommitHook, bo as CollectionBeforeDeleteHook, bp as CollectionBeforeReadHook, bq as CollectionBeforeReadHookEntry, br as CollectionBeforeTransitionHook, bs as CollectionIndex, bt as CollectionListComponentSlots, bu as CollectionRAGConfig, bv as CollectionSchemaResult, bw as CollectionSummaryResult, bx as CollectionViewComponentSlots, by as CompiledNavGroup, bz as CountOperation, bA as CustomAdminAuthProvider, bB as DEFAULT_USER_NAV_PREFERENCES, bC as DateFieldAdmin, bD as DateFormat, bE as DefaultValueContext, bF as DefineActionOptions, bG as DefineCalendarViewOptions, bH as DefineCardsViewOptions, bI as DefineGanttViewOptions, bJ as DefineKanbanViewOptions, bK as DefineTableViewOptions, bL as DefineViewBaseOptions, bM as DefineViewOptions, bN as DetailSpan, bO as DisplayTone, bP as DisplayVariant, bQ as DistinctCountOperation, bR as DistinctValuesOperation, bS as DynamicOptionItem, bT as DynamicOptionsConfig, bU as DynamicOptionsResolver, bV as DynamicOptionsResolverArgs, bW as DyrectedAIContext, bX as DyrectedLoggerConfig, bY as DyrectedObservabilityConfig, bZ as EmailFieldAdmin, b_ as FieldAdminHooks, b$ as FieldAdminOnChangeHook, c0 as FieldAdminOnChangeHookArgs, c1 as FieldAdminOptionsHook, c2 as FieldAdminOptionsHookArgs, c3 as FieldAdminOptionsHookResult, c4 as FieldAfterReadHook, c5 as FieldAfterReadHookArgs, c6 as FieldBase, c7 as FieldBeforeChangeHook, c8 as FieldBeforeChangeHookArgs, c9 as FieldHook, ca as FieldHooks, cb as FileData, cc as GanttViewConfig, cd as GetDocumentResult, ce as GlobalAfterChangeHook, cf as GlobalAfterReadHook, cg as GlobalAfterReadHookEntry, ch as GlobalBeforeChangeHook, ci as GlobalBeforeChangeHookEntry, cj as GlobalBeforeReadHook, ck as GlobalBeforeReadHookEntry, cl as GlobalRAGConfig, cm as GlobalSchemaResult, cn as GlobalSummaryResult, co as HeadingLevel, cp as HookFunction, cq as IconFieldAdmin, cr as ImageService, cs as ImageTransformOptions, ct as InferAggregateResult, cu as JoinFieldAdmin, cv as JsonFieldAdmin, cw as JsonFormat, cx as KanbanViewConfig, cy as LIFECYCLE_EVENT_NAMES, cz as LifecycleEventHandler, cA as LinkFormat, cB as MetricColor, cC as MoneyFieldAdmin, cD as MoneyFieldConfig, cE as MultiSelectFieldAdmin, cF as NamedAccessPolicy, cG as NavBadgeConfig, cH as NavGroup, cI as NumberFieldAdmin, cJ as NumberFormat, cK as NumberLimitFieldAdmin, cL as NumberLimitFieldConfig, cM as NumericOperation, cN as NumericUpdateOperator, cO as OIDCAdminAuthProvider, cP as OptionFormat, cQ as PaginatedResult, cR as PinnedNavItemRef, cS as PublicAdminAuthProvider, cT as QueryCollectionResult, cU as RAGSearchResult, cV as RadioFieldAdmin, cW as RateLimitConfig, cX as ReadonlyDatabaseAdapter, cY as RichTextFeature, cZ as RichTextFieldConfig, c_ as SelectFieldAdmin, c$ as SqlWhereResult, d0 as StorageAdapter, d1 as TableViewConfig, d2 as TaskContext, d3 as TaskLogger, d4 as TaskRunStatus, d5 as TextFieldAdmin, d6 as TextFormat, d7 as TextareaFieldAdmin, d8 as TrustProxyConfig, d9 as TypedField, da as UploadConfig, db as UrlFieldAdmin, dc as UrlLinkValue, dd as ViewActionFeatures, de as ViewComponentSlots, df as ViewConfigBase, dg as ViewLayout, dh as ViewMetric, di as ViewSubMetric, dj as WhereClause, dk as WhereOperator, dl as WhereOperatorName, dm as WordLimitFieldAdmin, dn as WordLimitFieldConfig, dp as WorkflowMetadata, dq as WorkflowOnTransitionContext, dr as WorkflowOnTransitionHook, ds as WorkflowRole, dt as WorkflowState, du as WorkflowTransitionContext, dv as coerceBooleanWhere, dw as defineAction, dx as defineCalendarView, dy as defineCardsView, dz as defineGanttView, dA as defineKanbanView, dB as defineTableView, dC as defineView, dD as defineWorkspace, dE as isAICollection, dF as parseMongoWhere, dG as parseSqlWhere } from './app-x7J5BIqK.cjs';
+import { F as Field, B as Block, C as CollectionConfig, D as DyrectedConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, G as GlobalConfig, a as DeclarativeHookExpression, W as WorkflowConfig, b as AuthenticatedUser, c as WorkflowTransition, L as LifecycleEventName, d as LifecycleEvent, e as DatabaseAdapter, f as BaseDocument, H as HookRequestContext, T as TaskRunResult, g as TaskConfig, h as DetailActionOptions, i as DetailAction, j as DetailComputedOptions, k as ComputedHandler, l as DetailComputed, m as DetailCustomOptions, n as DetailCustom, o as DetailDividerOptions, p as DetailDivider, q as DisplayFieldOptions, r as DetailField, s as DetailItem, t as DetailGridOptions, u as DetailGrid, v as DetailRepeatOptions, w as DetailRepeat, x as DetailSectionOptions, y as DetailSection, z as DetailTabOptions, E as DetailTab, I as DetailTabsOptions, J as DetailTabs, K as DetailTextOptions, M as DetailText, N as DetailSchema, O as DyrectedContext, Q as AIConfig, R as AIPIIConfig, S as IdStrategy, U as CompiledNavTree, V as CompiledNavItem, X as UserNavigationPreferences, Y as DefineWorkspaceOptions, Z as ViewConfig, _ as DateTimeField, $ as RelationshipField, a0 as SelectField, a1 as ArrayField, a2 as FieldType, a3 as BooleanField, a4 as AuthConfig, a5 as AccessPolicyResolver, a6 as DateField, a7 as TextField, a8 as EmailField, a9 as IconField, aa as ImageField, ab as JoinField, ac as JsonField, ad as MoneyField, ae as MultiSelectField, af as NumberField, ag as ObjectField, ah as RadioField, ai as RichTextField, aj as RowField, ak as TextareaField, al as TimeField, am as UrlField } from './app-v23fNf58.cjs';
+export { an as AIAction, ao as AIActionStatus, ap as AIActionType, aq as AIAuditActionType, ar as AIAuditRecord, as as AIChunk, at as AIMessage, au as AIPIIPattern, av as AIRateLimitResult, aw as AIRateLimitStore, ax as AIThread, ay as AIToolContext, az as AIToolDefinition, aA as AI_ACTIONS_COLLECTION, aB as AI_AUDIT_COLLECTION, aC as AI_CHUNKS_COLLECTION, aD as AI_MESSAGES_COLLECTION, aE as AI_THREADS_COLLECTION, aF as AccessConfig, aG as AccessFunction, aH as AccessFunctionArgs, aI as AccessResult, aJ as AccessRule, aK as ActionConfig, aL as ActionConfigBase, aM as ActionConfigWithHandler, aN as ActionConfigWithMutation, aO as ActionContext, aP as ActionType, aQ as AdminAuthAccessResolution, aR as AdminAuthClaimMapping, aS as AdminAuthMember, aT as AdminAuthProvider, aU as AdminAuthProviderMembersConfig, aV as AdminAuthProvisioningMode, aW as AdminAuthResolveAccessArgs, aX as AdminAuthResolvedIdentity, aY as AdminConfig, aZ as AdminDashboardComponentSlots, a_ as AdminIconName, a$ as AggregateArgs, b0 as AggregateCastType, b1 as AggregateCollectionResult, b2 as AggregateInput, b3 as AggregateOperation, b4 as AggregateResult, b5 as AppTrashConfig, b6 as BaseAdminAuthProvider, b7 as BaseFieldAdmin, b8 as BlockVariant, b9 as BlocksField, ba as BooleanFieldAdmin, bb as BooleanFormat, bc as CURRENT_NAV_PREFERENCES_VERSION, bd as CalendarViewConfig, be as CardsViewConfig, bf as CharacterLimitFieldAdmin, bg as CharacterLimitFieldConfig, bh as CollectionAfterChangeHook, bi as CollectionAfterDeleteHook, bj as CollectionAfterReadHook, bk as CollectionAfterReadHookEntry, bl as CollectionAfterRestoreHook, bm as CollectionAfterTransitionHook, bn as CollectionAfterTrashHook, bo as CollectionBeforeChangeHook, bp as CollectionBeforeChangeHookEntry, bq as CollectionBeforeCommitHook, br as CollectionBeforeDeleteHook, bs as CollectionBeforeReadHook, bt as CollectionBeforeReadHookEntry, bu as CollectionBeforeRestoreHook, bv as CollectionBeforeTransitionHook, bw as CollectionBeforeTrashHook, bx as CollectionEmailConfig, by as CollectionIndex, bz as CollectionListComponentSlots, bA as CollectionRAGConfig, bB as CollectionSchemaResult, bC as CollectionSummaryResult, bD as CollectionViewComponentSlots, bE as CompiledNavGroup, bF as CountOperation, bG as CustomAdminAuthProvider, bH as DEFAULT_USER_NAV_PREFERENCES, bI as DateFieldAdmin, bJ as DateFormat, bK as DefaultValueContext, bL as DefineActionOptions, bM as DefineCalendarViewOptions, bN as DefineCardsViewOptions, bO as DefineGanttViewOptions, bP as DefineKanbanViewOptions, bQ as DefineTableViewOptions, bR as DefineViewBaseOptions, bS as DefineViewOptions, bT as DetailSpan, bU as DisplayTone, bV as DisplayVariant, bW as DistinctCountOperation, bX as DistinctValuesOperation, bY as DynamicOptionItem, bZ as DynamicOptionsConfig, b_ as DynamicOptionsResolver, b$ as DynamicOptionsResolverArgs, c0 as DyrectedAIContext, c1 as DyrectedLoggerConfig, c2 as DyrectedObservabilityConfig, c3 as EmailFieldAdmin, c4 as EmailTemplateArgs, c5 as EmailTemplateResult, c6 as FieldAdminHooks, c7 as FieldAdminOnChangeHook, c8 as FieldAdminOnChangeHookArgs, c9 as FieldAdminOptionsHook, ca as FieldAdminOptionsHookArgs, cb as FieldAdminOptionsHookResult, cc as FieldAfterReadHook, cd as FieldAfterReadHookArgs, ce as FieldBase, cf as FieldBeforeChangeHook, cg as FieldBeforeChangeHookArgs, ch as FieldHook, ci as FieldHooks, cj as FileData, ck as GanttViewConfig, cl as GetDocumentResult, cm as GlobalAfterChangeHook, cn as GlobalAfterReadHook, co as GlobalAfterReadHookEntry, cp as GlobalBeforeChangeHook, cq as GlobalBeforeChangeHookEntry, cr as GlobalBeforeReadHook, cs as GlobalBeforeReadHookEntry, ct as GlobalRAGConfig, cu as GlobalSchemaResult, cv as GlobalSummaryResult, cw as HeadingLevel, cx as HookFunction, cy as IconFieldAdmin, cz as ImageService, cA as ImageTransformOptions, cB as InferAggregateResult, cC as JoinFieldAdmin, cD as JsonFieldAdmin, cE as JsonFormat, cF as KanbanViewConfig, cG as LIFECYCLE_EVENT_NAMES, cH as LifecycleEventHandler, cI as LinkFormat, cJ as MetricColor, cK as MoneyFieldAdmin, cL as MoneyFieldConfig, cM as MultiSelectFieldAdmin, cN as NamedAccessPolicy, cO as NavBadgeConfig, cP as NavGroup, cQ as NumberFieldAdmin, cR as NumberFormat, cS as NumberLimitFieldAdmin, cT as NumberLimitFieldConfig, cU as NumericOperation, cV as NumericUpdateOperator, cW as OIDCAdminAuthProvider, cX as OptionFormat, cY as OutboundEmail, cZ as PaginatedResult, c_ as PinnedNavItemRef, c$ as PublicAdminAuthProvider, d0 as QueryCollectionResult, d1 as RAGSearchResult, d2 as RadioFieldAdmin, d3 as RateLimitConfig, d4 as ReadonlyDatabaseAdapter, d5 as RichTextFeature, d6 as RichTextFieldConfig, d7 as SelectFieldAdmin, d8 as SqlWhereResult, d9 as StorageAdapter, da as TableViewConfig, db as TaskContext, dc as TaskLogger, dd as TaskRunStatus, de as TextFieldAdmin, df as TextFormat, dg as TextareaFieldAdmin, dh as TrashConfig, di as TrustProxyConfig, dj as TypedField, dk as UploadConfig, dl as UrlFieldAdmin, dm as UrlLinkValue, dn as ViewActionFeatures, dp as ViewComponentSlots, dq as ViewConfigBase, dr as ViewLayout, ds as ViewMetric, dt as ViewSubMetric, du as WhereClause, dv as WhereOperator, dw as WhereOperatorName, dx as WordLimitFieldAdmin, dy as WordLimitFieldConfig, dz as WorkflowMetadata, dA as WorkflowOnTransitionContext, dB as WorkflowOnTransitionHook, dC as WorkflowRole, dD as WorkflowState, dE as WorkflowTransitionContext, dF as coerceBooleanWhere, dG as defineAction, dH as defineCalendarView, dI as defineCardsView, dJ as defineGanttView, dK as defineKanbanView, dL as defineTableView, dM as defineView, dN as defineWorkspace, dO as isAICollection, dP as parseMongoWhere, dQ as parseSqlWhere } from './app-v23fNf58.cjs';
 import jexl from 'jexl';
 import { Context } from 'hono';
 export { z } from 'zod';
@@ -17,7 +17,7 @@ type FieldValueType<F extends Field> = F["type"] extends "text" | "textarea" | "
     hasMany: true;
 } ? string[] : string : F["type"] extends "image" ? F extends {
     hasMany: true;
-} ? string[] : string : F["type"] extends "richText" | "json" ? Record<string, unknown> : F["type"] extends "object" ? F extends {
+} ? string[] : string : F["type"] extends "richText" ? string | Record<string, unknown> : F["type"] extends "json" ? Record<string, unknown> : F["type"] extends "object" ? F extends {
     fields: infer SF extends readonly Field[];
 } ? Prettify<InferDocShape<SF>> : Record<string, unknown> : F["type"] extends "array" ? F extends {
     fields: infer SF extends readonly Field[];
@@ -133,6 +133,8 @@ declare class DyrectedAIError extends Error {
  */
 declare function asCollection<T extends CollectionConfig<any>>(config: T): T;
 
+declare const EMAIL_TEMPLATES_COLLECTION_SLUG = "__email_templates";
+declare const EMAIL_TEMPLATES_COLLECTION_CONFIG: CollectionConfig;
 /**
  * Normalizes the Dyrected configuration by injecting system fields
  * (createdAt, updatedAt, createdBy, updatedBy) into every collection and
@@ -150,8 +152,8 @@ declare function getAdminRoleForCollection(collection?: CollectionConfig | null)
 /**
  * Checks whether a user possesses an administrative role.
  * Considers:
- * 1. The collection's configured `adminRole` (e.g. 'super_admin')
- * 2. Standard admin roles ('admin', 'super_admin')
+ * 1. The collection's configured `adminRole` (e.g. 'super_admin' or 'super admin')
+ * 2. Standard admin roles ('admin', 'super_admin', 'super admin', 'superadmin', 'owner')
  */
 declare function isUserAdmin(user: any, collection?: CollectionConfig | null): boolean;
 
@@ -719,6 +721,11 @@ interface TaskRunner {
     }): void;
     /** Stops polling and waits for any run in progress to settle. */
     stop(): Promise<void>;
+    /** Lists all registered tasks with their configured cron expression. */
+    getTasks(): Array<{
+        name: string;
+        cron?: string;
+    }>;
 }
 /**
  * Creates the runner for the tasks in `config.tasks`. Coordination between
@@ -1547,6 +1554,133 @@ declare function pruneNavigationForUser(tree: CompiledNavTree, user?: any): Comp
  */
 declare function resolveAllCollectionViews(collection: CollectionConfig, config?: Partial<DyrectedConfig> | null): ViewConfig[];
 
+declare const TRASH_COLLECTION = "__trash";
+/**
+ * Internal system collections managed directly by Dyrected engine features.
+ * These should never be exposed in public API schemas or user collection navigation.
+ */
+declare const INTERNAL_SYSTEM_COLLECTIONS: Set<string>;
+/**
+ * Internal collection holding snapshots of trashed documents across all collections.
+ */
+declare const TRASH_COLLECTION_CONFIG: CollectionConfig;
+/**
+ * Deterministic primary key for a trash entry: `${collection}:${docId}`.
+ */
+declare function getTrashEntryId(collection: string, docId: string): string;
+interface ResolvedTrashConfig {
+    enabled: boolean;
+    retentionDays: number | null;
+    allowPermanentDelete: boolean;
+}
+/**
+ * Resolves trash settings for a collection based on collection and app-level config.
+ *
+ * Resolution order:
+ * | Collection trash | App trash.enabled | Result |
+ * |---|---|---|
+ * | false            | any               | hard delete |
+ * | true / object    | any               | trash enabled |
+ * | omitted          | false             | hard delete |
+ * | omitted          | omitted / true    | trash enabled (default: 30 days retention) |
+ */
+declare function resolveTrashConfig(collection: CollectionConfig, appConfig?: DyrectedConfig): ResolvedTrashConfig;
+/**
+ * Validates trash configuration for app and collections.
+ */
+declare function assertValidTrashInConfig(config: DyrectedConfig, source?: string): void;
+/**
+ * Resolves a human-readable title for a document snapshot using collection useAsTitle.
+ */
+declare function resolveDocumentTitle(collection: CollectionConfig, doc: any): string;
+/**
+ * Creates the built-in purge task that automatically permanently deletes
+ * expired documents from __trash.
+ */
+declare function createTrashPurgeTask(config: DyrectedConfig): TaskConfig;
+interface SoftDeleteOptions {
+    db: any;
+    config: DyrectedConfig;
+    collection: string;
+    id: string;
+    deletedBy?: string | null;
+}
+declare function softDeleteDocument(options: SoftDeleteOptions): Promise<{
+    id: string;
+    purgeAt: number | null;
+}>;
+interface RestoreDocumentOptions {
+    db: any;
+    config: DyrectedConfig;
+    collection: string;
+    trashId: string;
+    overrides?: Record<string, unknown>;
+}
+declare function restoreDocument(options: RestoreDocumentOptions): Promise<{
+    restoredDoc: any;
+}>;
+
+declare const emailTokens: {
+    readonly colors: {
+        readonly canvas: "#f6f7f2";
+        readonly surface: "#ffffff";
+        readonly text: "#171717";
+        readonly muted: "#62665b";
+        readonly subtle: "#8a8f82";
+        readonly border: "#dde0d7";
+        readonly accent: "#b6ff2e";
+        readonly code: "#f1f3ec";
+        readonly codeBorder: "#e2e5dc";
+        readonly dangerSurface: "#fff2f0";
+        readonly dangerBorder: "#ffc9c2";
+        readonly dangerText: "#9f251b";
+    };
+    readonly font: "Arial, 'Helvetica Neue', Helvetica, sans-serif";
+    readonly mono: "'Courier New', Courier, monospace";
+    readonly radius: {
+        readonly card: "12px";
+        readonly control: "6px";
+    };
+    readonly width: "600px";
+};
+declare function escapeHtml(value: string): string;
+declare function heading(content: string): string;
+declare function paragraph(content: string, margin?: string, size?: string): string;
+declare function sectionLabel(content: string): string;
+declare function divider(): string;
+declare function spacer(height?: number): string;
+declare function row(content: string, cellStyle?: string): string;
+declare function table(content: string, style?: string): string;
+declare function detailBox(content: string, monospace?: boolean): string;
+declare function eventList(events: ReadonlyArray<{
+    label: string;
+    value: string;
+}>): string;
+declare function ctaButton(label: string, href: string): string;
+declare function safeLinkDetailBox(href: string): string;
+declare function alertBox(content: string): string;
+type TemplateBlock = string | false | null | undefined;
+interface LayoutOptions {
+    preheader: string;
+    title: string;
+    content: string | (TemplateBlock | TemplateBlock[])[];
+    footer: string | (TemplateBlock | TemplateBlock[])[];
+    siteName?: string;
+}
+declare function resolveBlocks(input: string | (TemplateBlock | TemplateBlock[])[]): string;
+declare function layout({ preheader, title, content, footer, siteName }: LayoutOptions): string;
+/**
+ * Returns the canonical, bulletproof Dyrected HTML email template
+ * for a specific auth purpose (invite, resetPassword, welcome, passwordChanged).
+ * Formatted using responsive tables and inline styles tested across Gmail, Apple Mail, Outlook, and mobile clients.
+ */
+declare function getDefaultEmailTemplate(purpose: "invite" | "resetPassword" | "welcome" | "passwordChanged" | string, options?: {
+    siteName?: string;
+}): {
+    subject: string;
+    rawHtml: string;
+};
+
 type TopLevelFieldName<TFields extends readonly Field[]> = Extract<TFields[number], {
     name: string;
 }>["name"];
@@ -1970,9 +2104,12 @@ declare const _defineJoinFieldBase: <const T extends Omit<JoinField, "type">>(fi
  * })
  * ```
  */
-declare function defineRelationshipField<TValidSlugs extends string = string>(config: Omit<Omit<Parameters<typeof _defineRelationshipFieldBase>[0], "type">, "relationTo"> & {
+declare function defineRelationshipField<TValidSlugs extends string = string, const T extends Omit<Omit<Parameters<typeof _defineRelationshipFieldBase>[0], "type">, "relationTo"> & {
+    relationTo: TValidSlugs;
+} = any>(config: T): T & {
+    type: "relationship";
     relationTo: TValidSlugs;
-}): RelationshipField;
+};
 declare function defineRelationshipField(config: Parameters<typeof _defineRelationshipFieldBase>[0]): RelationshipField;
 /**
  * Define an `image` field with automatic slug inference from your collection config.
@@ -2013,6 +2150,162 @@ declare function defineJoinField<TValidSlugs extends string = string>(config: Om
     collection: TValidSlugs;
 }): JoinField;
 declare function defineJoinField(config: Parameters<typeof _defineJoinFieldBase>[0]): JoinField;
+interface CreatedAtFieldOptions extends Partial<Omit<DateTimeField, "type">> {
+    type?: "datetime" | "date";
+}
+/**
+ * Define a `createdAt` timestamp field.
+ * Defaults to `type: "datetime"`, `name: "createdAt"`, `label: "Created At"`, and `admin: { readOnly: true }`.
+ *
+ * @example
+ * ```ts
+ * defineCreatedAtField()
+ * defineCreatedAtField({ name: "created_at", admin: { position: "sidebar" } })
+ * ```
+ */
+declare function defineCreatedAtField<const T extends CreatedAtFieldOptions = {
+    name: "createdAt";
+}>(config?: T): (T extends {
+    type: "date";
+} ? DateField : DateTimeField) & {
+    name: T extends {
+        name: infer N extends string;
+    } ? N : "createdAt";
+    type: T extends {
+        type: infer Type extends "datetime" | "date";
+    } ? Type : "datetime";
+};
+interface UpdatedAtFieldOptions extends Partial<Omit<DateTimeField, "type">> {
+    type?: "datetime" | "date";
+}
+/**
+ * Define an `updatedAt` timestamp field.
+ * Defaults to `type: "datetime"`, `name: "updatedAt"`, `label: "Updated At"`, and `admin: { readOnly: true }`.
+ *
+ * @example
+ * ```ts
+ * defineUpdatedAtField()
+ * defineUpdatedAtField({ name: "updated_at", admin: { position: "sidebar" } })
+ * ```
+ */
+declare function defineUpdatedAtField<const T extends UpdatedAtFieldOptions = {
+    name: "updatedAt";
+}>(config?: T): (T extends {
+    type: "date";
+} ? DateField : DateTimeField) & {
+    name: T extends {
+        name: infer N extends string;
+    } ? N : "updatedAt";
+    type: T extends {
+        type: infer Type extends "datetime" | "date";
+    } ? Type : "datetime";
+};
+interface CreatedByFieldOptions<TValidSlugs extends string = string> extends Partial<Omit<RelationshipField, "type" | "relationTo">> {
+    type?: "relationship" | "text";
+    relationTo?: TValidSlugs | TValidSlugs[];
+}
+/**
+ * Define a `createdBy` audit user field.
+ * Defaults to `type: "relationship"`, `name: "createdBy"`, `label: "Created By"`, `relationTo: "users"`, and `admin: { readOnly: true }`.
+ * If `type: "text"` is specified, creates a read-only text field instead of a relationship.
+ *
+ * @example
+ * ```ts
+ * defineCreatedByField() // relationship to 'users'
+ * defineCreatedByField({ relationTo: 'authors' }) // relationship to 'authors'
+ * defineCreatedByField({ type: 'text' }) // text user identifier
+ * ```
+ */
+declare function defineCreatedByField<TValidSlugs extends string = string, const T extends CreatedByFieldOptions<TValidSlugs> = CreatedByFieldOptions<TValidSlugs>>(config?: T): (T extends {
+    type: "text";
+} ? TextField : RelationshipField) & {
+    name: T extends {
+        name: infer N extends string;
+    } ? N : "createdBy";
+    type: T extends {
+        type: "text";
+    } ? "text" : "relationship";
+};
+interface UpdatedByFieldOptions<TValidSlugs extends string = string> extends Partial<Omit<RelationshipField, "type" | "relationTo">> {
+    type?: "relationship" | "text";
+    relationTo?: TValidSlugs | TValidSlugs[];
+}
+/**
+ * Define an `updatedBy` audit user field.
+ * Defaults to `type: "relationship"`, `name: "updatedBy"`, `label: "Updated By"`, `relationTo: "users"`, and `admin: { readOnly: true }`.
+ * If `type: "text"` is specified, creates a read-only text field instead of a relationship.
+ *
+ * @example
+ * ```ts
+ * defineUpdatedByField() // relationship to 'users'
+ * defineUpdatedByField({ relationTo: 'authors' }) // relationship to 'authors'
+ * defineUpdatedByField({ type: 'text' }) // text user identifier
+ * ```
+ */
+declare function defineUpdatedByField<TValidSlugs extends string = string, const T extends UpdatedByFieldOptions<TValidSlugs> = UpdatedByFieldOptions<TValidSlugs>>(config?: T): (T extends {
+    type: "text";
+} ? TextField : RelationshipField) & {
+    name: T extends {
+        name: infer N extends string;
+    } ? N : "updatedBy";
+    type: T extends {
+        type: "text";
+    } ? "text" : "relationship";
+};
+interface RoleOption {
+    value: string;
+    label: string;
+}
+interface RolesFieldOptions extends Partial<Omit<SelectField, "type" | "options">> {
+    type?: "select" | "multiSelect";
+    multiple?: boolean;
+    hasMany?: boolean;
+    roles?: readonly string[] | readonly RoleOption[];
+    options?: readonly string[] | readonly RoleOption[] | SelectField["options"];
+    /**
+     * The role name or names authorized to update this field.
+     * Defaults to `"admin"`.
+     * Can be a single role (`"super-admin"`) or an array (`["owner", "super-admin"]`).
+     */
+    adminRole?: string | readonly string[];
+}
+/**
+ * Define a `roles` authorization field on an auth or users collection.
+ * Replaces manual select/multiSelect field boilerplate with built-in role options,
+ * safe non-self-elevation update access control, and singular/multiple mode support.
+ *
+ * @example
+ * ```ts
+ * defineRolesField() // single select with admin, editor, viewer
+ * defineRoles({ multiple: true }) // multiSelect roles array
+ * defineRoles({ roles: ['super-admin', 'moderator', 'member'], adminRole: 'super-admin' })
+ * defineRoles({ name: 'role' }) // singular role
+ * ```
+ */
+declare function defineRolesField<const T extends RolesFieldOptions = {
+    name: "roles";
+}>(config?: T): (T extends {
+    multiple: true;
+} | {
+    hasMany: true;
+} | {
+    type: "multiSelect";
+} ? MultiSelectField : SelectField) & {
+    name: T extends {
+        name: infer N extends string;
+    } ? N : "roles";
+    type: T extends {
+        multiple: true;
+    } | {
+        hasMany: true;
+    } | {
+        type: "multiSelect";
+    } ? "multiSelect" : "select";
+};
+/**
+ * Convenience alias for {@link defineRolesField}.
+ */
+declare const defineRoles: typeof defineRolesField;
 /**
  * Group fields under a named tab in the Admin edit form. Tabs are presentational
  * only: `defineTab` returns the given fields unchanged except that each one's
@@ -2047,4 +2340,4 @@ declare function defineTab<const T extends readonly Field[]>(args: {
     fields: T;
 }): T;
 
-export { AIConfig, type AIErrorCode, AIPIIConfig, type AccessConditions, AccessPolicyResolver, AdminAuthConfig, ArrayField, AuthConfig, type AuthDocFields, AuthenticatedUser, BASE62_ALPHABET, BUILTIN_JEXL_HELPERS, BaseDocument, Block, BooleanField, CROCKFORD_BASE32, CollectionConfig, CompiledNavItem, CompiledNavTree, ComputedHandler, type ConfigDiagnostic, ConfigValidationError, ConflictError, DatabaseAdapter, DateField, DateTimeField, type DeclarativeAccessSurface, type DeclarativeAccessValidationIssue, type DeclarativeAdminSurface, type DeclarativeAdminValidationIssue, DeclarativeHookExpression, type DeclarativeHookSurface, type DeclarativeHookValidationIssue, type DeclarativePreviewSurface, type DeclarativePreviewValidationIssue, DefineWorkspaceOptions, DetailAction, DetailActionOptions, DetailComputed, DetailComputedOptions, DetailCustom, DetailCustomOptions, DetailDivider, DetailDividerOptions, DetailField, DetailGrid, DetailGridOptions, DetailItem, DetailRepeat, DetailRepeatOptions, DetailSchema, DetailSection, DetailSectionOptions, DetailTab, DetailTabOptions, DetailTabs, DetailTabsOptions, DetailText, DetailTextOptions, DisplayFieldOptions, DuplicateKeyError, DyrectedAIError, DyrectedConfig, DyrectedError, EmailField, type ExprFunction, type ExtractCollectionSlugs, Field, FieldConditionBuilder, FieldType, ForbiddenError, type GenerateIdOptions, GlobalConfig, HookRequestContext, IconField, IdStrategy, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MatchBuilder, MoneyField, MultiSelectField, NANOID_ALPHABET, NON_NEGOTIABLE_CREDENTIAL_FIELDS, NotFoundError, NumberField, ObjectField, PII_REGEX_PATTERNS, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RESERVED_NAVIGATION_SLUGS, RadioField, type ReconcileNavigationOptions, type ReconciledNavTree, RelationshipField, RichTextField, RowField, type SanitizeDocForAIOptions, SelectField, type SortClause, type SortDirection, type SqlSortDialect, type SystemDocFields, TASK_LOCKS_COLLECTION, TASK_LOCKS_COLLECTION_CONFIG, TaskConfig, TaskRunResult, type TaskRunner, TextField, TextareaField, TimeField, UNASSIGNED_GROUP_KEY, type UploadDocFields, UrlField, UserNavigationPreferences, ValidationError, ViewConfig, WORKFLOW_HISTORY_COLLECTION, type WhenFunction, WorkflowConfig, WorkflowTransition, abs, addDays, asCollection, assertValidAdminConditionsInConfig, assertValidDeclarativeAccessInConfig, assertValidDeclarativeHookExpression, assertValidDeclarativeHookResult, assertValidDeclarativeHooksInConfig, assertValidNavigationSlugs, assertValidPreviewUrlsInConfig, availableWorkflowTransitions, buildSqlOrderBy, canViewWorkflowDraft, capitalize, ceil, clamp, coalesce, collectAdminConditionValidationIssues, collectConfigDiagnostics, collectDeclarativeAccessValidationIssues, collectDeclarativeHookValidationIssues, collectPreviewUrlValidationIssues, compact, compileNavigation, count, createLifecycleEvent, createTaskRunner, createWorkflowDocument, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMoneyField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, defineTask, defineTextField, defineTextareaField, defineTimeField, defineUrlField, diffDays, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, displayAction, displayComputed, displayCustom, displayCustomComponent, displayDivider, displayField, displayGrid, displayRepeat, displaySection, displayTab, displayTabs, displayText, endsWith, evaluateDetailComputed, evaluateJexl, evaluateJexlSync, executeFieldAfterRead, executeFieldBeforeChange, expr, first, floor, formatConfigDiagnostics, formatDate, formatJexlValue, generateDefaultDetailSchema, generateDocumentId, generateId, generateOpenApi, get, getAdminAuthCollection, getAdminRoleForCollection, getAllowedSitesForUser, getPublicAdminAuthConfig, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, isSiteAuthorized, isUserAdmin, join, last, length, lower, maskEmail, maskPhone, maskTextPII, materializeWorkflowDocument, max, min, nanoid, nextCronRun, normalizeConfig, normalizeDetailItem, normalizeGroupKey, now, numericFieldNames, parseCron, parseSort, pow, prefixedId, pruneNavigationForUser, publishedStateName, publishingWorkflow, readingTime, reconcileNavigation, registerJexlHelpers, replace, resolveAdminAuthCollection, resolveAllCollectionViews, resolveAuthorizedSiteId, resolveIndexName, resolvePrefix, round, runCollectionHooks, sanitizeDocForAI, saveWorkflowDraft, simplePublishingWorkflow, slugify, sqrt, startsWith, sum, today, transitionWorkflow, trim, truncate, ulid, unique, upper, uuid, validateAdminConditionExpression, validateDeclarativeAccessExpression, validateDeclarativeHookExpression, validatePreviewUrlExpression, when, wordCount, workflowCapabilities };
+export { AIConfig, type AIErrorCode, AIPIIConfig, type AccessConditions, AccessPolicyResolver, AdminAuthConfig, ArrayField, AuthConfig, type AuthDocFields, AuthenticatedUser, BASE62_ALPHABET, BUILTIN_JEXL_HELPERS, BaseDocument, Block, BooleanField, CROCKFORD_BASE32, CollectionConfig, CompiledNavItem, CompiledNavTree, ComputedHandler, type ConfigDiagnostic, ConfigValidationError, ConflictError, type CreatedAtFieldOptions, type CreatedByFieldOptions, DatabaseAdapter, DateField, DateTimeField, type DeclarativeAccessSurface, type DeclarativeAccessValidationIssue, type DeclarativeAdminSurface, type DeclarativeAdminValidationIssue, DeclarativeHookExpression, type DeclarativeHookSurface, type DeclarativeHookValidationIssue, type DeclarativePreviewSurface, type DeclarativePreviewValidationIssue, DefineWorkspaceOptions, DetailAction, DetailActionOptions, DetailComputed, DetailComputedOptions, DetailCustom, DetailCustomOptions, DetailDivider, DetailDividerOptions, DetailField, DetailGrid, DetailGridOptions, DetailItem, DetailRepeat, DetailRepeatOptions, DetailSchema, DetailSection, DetailSectionOptions, DetailTab, DetailTabOptions, DetailTabs, DetailTabsOptions, DetailText, DetailTextOptions, DisplayFieldOptions, DuplicateKeyError, DyrectedAIError, DyrectedConfig, DyrectedError, EMAIL_TEMPLATES_COLLECTION_CONFIG, EMAIL_TEMPLATES_COLLECTION_SLUG, EmailField, type ExprFunction, type ExtractCollectionSlugs, Field, FieldConditionBuilder, FieldType, ForbiddenError, type GenerateIdOptions, GlobalConfig, HookRequestContext, INTERNAL_SYSTEM_COLLECTIONS, IconField, IdStrategy, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, type LayoutOptions, LifecycleEvent, LifecycleEventName, MatchBuilder, MoneyField, MultiSelectField, NANOID_ALPHABET, NON_NEGOTIABLE_CREDENTIAL_FIELDS, NotFoundError, NumberField, ObjectField, PII_REGEX_PATTERNS, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RESERVED_NAVIGATION_SLUGS, RadioField, type ReconcileNavigationOptions, type ReconciledNavTree, RelationshipField, type ResolvedTrashConfig, type RestoreDocumentOptions, RichTextField, type RoleOption, type RolesFieldOptions, RowField, type SanitizeDocForAIOptions, SelectField, type SoftDeleteOptions, type SortClause, type SortDirection, type SqlSortDialect, type SystemDocFields, TASK_LOCKS_COLLECTION, TASK_LOCKS_COLLECTION_CONFIG, TRASH_COLLECTION, TRASH_COLLECTION_CONFIG, TaskConfig, TaskRunResult, type TaskRunner, type TemplateBlock, TextField, TextareaField, TimeField, UNASSIGNED_GROUP_KEY, type UpdatedAtFieldOptions, type UpdatedByFieldOptions, type UploadDocFields, UrlField, UserNavigationPreferences, ValidationError, ViewConfig, WORKFLOW_HISTORY_COLLECTION, type WhenFunction, WorkflowConfig, WorkflowTransition, abs, addDays, alertBox, asCollection, assertValidAdminConditionsInConfig, assertValidDeclarativeAccessInConfig, assertValidDeclarativeHookExpression, assertValidDeclarativeHookResult, assertValidDeclarativeHooksInConfig, assertValidNavigationSlugs, assertValidPreviewUrlsInConfig, assertValidTrashInConfig, availableWorkflowTransitions, buildSqlOrderBy, canViewWorkflowDraft, capitalize, ceil, clamp, coalesce, collectAdminConditionValidationIssues, collectConfigDiagnostics, collectDeclarativeAccessValidationIssues, collectDeclarativeHookValidationIssues, collectPreviewUrlValidationIssues, compact, compileNavigation, count, createLifecycleEvent, createTaskRunner, createTrashPurgeTask, createWorkflowDocument, ctaButton, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineCreatedAtField, defineCreatedByField, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMoneyField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRoles, defineRolesField, defineRowField, defineSelectField, defineTab, defineTask, defineTextField, defineTextareaField, defineTimeField, defineUpdatedAtField, defineUpdatedByField, defineUrlField, detailBox, diffDays, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, displayAction, displayComputed, displayCustom, displayCustomComponent, displayDivider, displayField, displayGrid, displayRepeat, displaySection, displayTab, displayTabs, displayText, divider, emailTokens, endsWith, escapeHtml, evaluateDetailComputed, evaluateJexl, evaluateJexlSync, eventList, executeFieldAfterRead, executeFieldBeforeChange, expr, first, floor, formatConfigDiagnostics, formatDate, formatJexlValue, generateDefaultDetailSchema, generateDocumentId, generateId, generateOpenApi, get, getAdminAuthCollection, getAdminRoleForCollection, getAllowedSitesForUser, getDefaultEmailTemplate, getPublicAdminAuthConfig, getTrashEntryId, heading, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, isSiteAuthorized, isUserAdmin, join, last, layout, length, lower, maskEmail, maskPhone, maskTextPII, materializeWorkflowDocument, max, min, nanoid, nextCronRun, normalizeConfig, normalizeDetailItem, normalizeGroupKey, now, numericFieldNames, paragraph, parseCron, parseSort, pow, prefixedId, pruneNavigationForUser, publishedStateName, publishingWorkflow, readingTime, reconcileNavigation, registerJexlHelpers, replace, resolveAdminAuthCollection, resolveAllCollectionViews, resolveAuthorizedSiteId, resolveBlocks, resolveDocumentTitle, resolveIndexName, resolvePrefix, resolveTrashConfig, restoreDocument, round, row, runCollectionHooks, safeLinkDetailBox, sanitizeDocForAI, saveWorkflowDraft, sectionLabel, simplePublishingWorkflow, slugify, softDeleteDocument, spacer, sqrt, startsWith, sum, table, today, transitionWorkflow, trim, truncate, ulid, unique, upper, uuid, validateAdminConditionExpression, validateDeclarativeAccessExpression, validateDeclarativeHookExpression, validatePreviewUrlExpression, when, wordCount, workflowCapabilities };