@dyrected/core 2.17.0 → 2.18.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 BaseDocument, H as HookRequestContext, f as DetailActionOptions, g as DetailAction, h as DetailComputedOptions, i as ComputedHandler, j as DetailComputed, k as DetailCustomOptions, l as DetailCustom, m as DetailDividerOptions, n as DetailDivider, o as DisplayFieldOptions, p as DetailField, q as DetailItem, r as DetailGridOptions, s as DetailGrid, t as DetailRepeatOptions, u as DetailRepeat, v as DetailSectionOptions, w as DetailSection, x as DetailTabOptions, y as DetailTab, z as DetailTabsOptions, E as DetailTabs, I as DetailTextOptions, J as DetailText, K as DetailSchema, M as DyrectedContext, N as AIConfig, O as AIPIIConfig, Q as IdStrategy, R as CompiledNavTree, S as CompiledNavItem, U as UserNavigationPreferences, T as DefineWorkspaceOptions, V as ArrayField, X as FieldType, Y as BooleanField, Z as AuthConfig, _ as AccessPolicyResolver, $ as DateField, a0 as DateTimeField, a1 as EmailField, a2 as IconField, a3 as ImageField, a4 as JoinField, a5 as JsonField, a6 as MultiSelectField, a7 as NumberField, a8 as ObjectField, a9 as RadioField, aa as RelationshipField, ab as RichTextField, ac as RowField, ad as SelectField, ae as TextField, af as TextareaField, ag as TimeField, ah as UrlField } from './app-CLdT_0se.cjs';
-export { ai as AIAction, aj as AIActionStatus, ak as AIActionType, al as AIAuditActionType, am as AIAuditRecord, an as AIChunk, ao as AIMessage, ap as AIPIIPattern, aq as AIRateLimitResult, ar as AIRateLimitStore, as as AIThread, at as AIToolContext, au as AIToolDefinition, av as AI_ACTIONS_COLLECTION, aw as AI_AUDIT_COLLECTION, ax as AI_CHUNKS_COLLECTION, ay as AI_MESSAGES_COLLECTION, az as AI_THREADS_COLLECTION, aA as AccessConfig, aB as AccessFunction, aC as AccessFunctionArgs, aD as AccessResult, aE as AccessRule, aF as ActionConfig, aG as ActionConfigBase, aH as ActionConfigWithHandler, aI as ActionConfigWithMutation, aJ as ActionContext, aK as ActionType, aL as AdminAuthAccessResolution, aM as AdminAuthClaimMapping, aN as AdminAuthMember, aO as AdminAuthProvider, aP as AdminAuthProviderMembersConfig, aQ as AdminAuthProvisioningMode, aR as AdminAuthResolveAccessArgs, aS as AdminAuthResolvedIdentity, aT as AdminConfig, aU as AdminDashboardComponentSlots, aV as AdminIconName, aW as AggregateArgs, aX as AggregateCastType, aY as AggregateCollectionResult, aZ as AggregateInput, a_ as AggregateOperation, a$ as AggregateResult, b0 as BaseAdminAuthProvider, b1 as BaseFieldAdmin, b2 as BlockVariant, b3 as BlocksField, b4 as BooleanFieldAdmin, b5 as BooleanFormat, b6 as CURRENT_NAV_PREFERENCES_VERSION, b7 as CalendarViewConfig, b8 as CardsViewConfig, b9 as CharacterLimitFieldAdmin, ba as CharacterLimitFieldConfig, bb as CollectionAfterChangeHook, bc as CollectionAfterDeleteHook, bd as CollectionAfterReadHook, be as CollectionAfterReadHookEntry, bf as CollectionAfterTransitionHook, bg as CollectionBeforeChangeHook, bh as CollectionBeforeChangeHookEntry, bi as CollectionBeforeDeleteHook, bj as CollectionBeforeReadHook, bk as CollectionBeforeReadHookEntry, bl as CollectionBeforeTransitionHook, bm as CollectionIndex, bn as CollectionListComponentSlots, bo as CollectionRAGConfig, bp as CollectionSchemaResult, bq as CollectionSummaryResult, br as CollectionViewComponentSlots, bs as CompiledNavGroup, bt as CountOperation, bu as CustomAdminAuthProvider, bv as DEFAULT_USER_NAV_PREFERENCES, bw as DatabaseAdapter, bx as DateFieldAdmin, by as DateFormat, bz as DefaultValueContext, bA as DefineActionOptions, bB as DefineCalendarViewOptions, bC as DefineCardsViewOptions, bD as DefineGanttViewOptions, bE as DefineKanbanViewOptions, bF as DefineTableViewOptions, bG as DefineViewBaseOptions, bH as DefineViewOptions, bI as DetailSpan, bJ as DisplayTone, bK as DisplayVariant, bL as DistinctCountOperation, bM as DistinctValuesOperation, bN as DynamicOptionItem, bO as DynamicOptionsConfig, bP as DynamicOptionsResolver, bQ as DynamicOptionsResolverArgs, bR as DyrectedAIContext, bS as DyrectedLoggerConfig, bT as DyrectedObservabilityConfig, bU as EmailFieldAdmin, bV as FieldAdminHooks, bW as FieldAdminOnChangeHook, bX as FieldAdminOnChangeHookArgs, bY as FieldAdminOptionsHook, bZ as FieldAdminOptionsHookArgs, b_ as FieldAdminOptionsHookResult, b$ as FieldAfterReadHook, c0 as FieldAfterReadHookArgs, c1 as FieldBase, c2 as FieldBeforeChangeHook, c3 as FieldBeforeChangeHookArgs, c4 as FieldHook, c5 as FieldHooks, c6 as FileData, c7 as GanttViewConfig, c8 as GetDocumentResult, c9 as GlobalAfterChangeHook, ca as GlobalAfterReadHook, cb as GlobalAfterReadHookEntry, cc as GlobalBeforeChangeHook, cd as GlobalBeforeChangeHookEntry, ce as GlobalBeforeReadHook, cf as GlobalBeforeReadHookEntry, cg as GlobalRAGConfig, ch as GlobalSchemaResult, ci as GlobalSummaryResult, cj as HeadingLevel, ck as HookFunction, cl as IconFieldAdmin, cm as ImageService, cn as ImageTransformOptions, co as InferAggregateResult, cp as JoinFieldAdmin, cq as JsonFieldAdmin, cr as JsonFormat, cs as KanbanViewConfig, ct as LIFECYCLE_EVENT_NAMES, cu as LifecycleEventHandler, cv as LinkFormat, cw as MetricColor, cx as MultiSelectFieldAdmin, cy as NamedAccessPolicy, cz as NavBadgeConfig, cA as NavGroup, cB as NumberFieldAdmin, cC as NumberFormat, cD as NumberLimitFieldAdmin, cE as NumberLimitFieldConfig, cF as NumericOperation, cG as NumericUpdateOperator, cH as OIDCAdminAuthProvider, cI as OptionFormat, cJ as PaginatedResult, cK as PinnedNavItemRef, cL as PublicAdminAuthProvider, cM as QueryCollectionResult, cN as RAGSearchResult, cO as RadioFieldAdmin, cP as RateLimitConfig, cQ as ReadonlyDatabaseAdapter, cR as RichTextFeature, cS as RichTextFieldConfig, cT as SelectFieldAdmin, cU as SqlWhereResult, cV as StorageAdapter, cW as TableViewConfig, cX as TextFieldAdmin, cY as TextFormat, cZ as TextareaFieldAdmin, c_ as TrustProxyConfig, c$ as TypedField, d0 as UploadConfig, d1 as UrlFieldAdmin, d2 as UrlLinkValue, d3 as ViewActionFeatures, d4 as ViewComponentSlots, d5 as ViewConfig, d6 as ViewConfigBase, d7 as ViewLayout, d8 as ViewMetric, d9 as ViewSubMetric, da as WhereClause, db as WhereOperator, dc as WhereOperatorName, dd as WordLimitFieldAdmin, de as WordLimitFieldConfig, df as WorkflowMetadata, dg as WorkflowRole, dh as WorkflowState, di as WorkflowTransitionContext, dj as defineAction, dk as defineCalendarView, dl as defineCardsView, dm as defineGanttView, dn as defineKanbanView, dp as defineTableView, dq as defineView, dr as defineWorkspace, ds as isAICollection, dt as parseMongoWhere, du as parseSqlWhere } from './app-CLdT_0se.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 ArrayField, _ as FieldType, $ as BooleanField, a0 as AuthConfig, a1 as AccessPolicyResolver, a2 as DateField, a3 as DateTimeField, a4 as EmailField, a5 as IconField, a6 as ImageField, a7 as JoinField, a8 as JsonField, a9 as MoneyField, aa as MultiSelectField, ab as NumberField, ac as ObjectField, ad as RadioField, ae as RelationshipField, af as RichTextField, ag as RowField, ah as SelectField, ai as TextField, aj as TextareaField, ak as TimeField, al as UrlField } from './app-Dd9cBbCs.cjs';
+export { am as AIAction, an as AIActionStatus, ao as AIActionType, ap as AIAuditActionType, aq as AIAuditRecord, ar as AIChunk, as as AIMessage, at as AIPIIPattern, au as AIRateLimitResult, av as AIRateLimitStore, aw as AIThread, ax as AIToolContext, ay as AIToolDefinition, az as AI_ACTIONS_COLLECTION, aA as AI_AUDIT_COLLECTION, aB as AI_CHUNKS_COLLECTION, aC as AI_MESSAGES_COLLECTION, aD as AI_THREADS_COLLECTION, aE as AccessConfig, aF as AccessFunction, aG as AccessFunctionArgs, aH as AccessResult, aI as AccessRule, aJ as ActionConfig, aK as ActionConfigBase, aL as ActionConfigWithHandler, aM as ActionConfigWithMutation, aN as ActionContext, aO as ActionType, aP as AdminAuthAccessResolution, aQ as AdminAuthClaimMapping, aR as AdminAuthMember, aS as AdminAuthProvider, aT as AdminAuthProviderMembersConfig, aU as AdminAuthProvisioningMode, aV as AdminAuthResolveAccessArgs, aW as AdminAuthResolvedIdentity, aX as AdminConfig, aY as AdminDashboardComponentSlots, aZ as AdminIconName, a_ as AggregateArgs, a$ as AggregateCastType, b0 as AggregateCollectionResult, b1 as AggregateInput, b2 as AggregateOperation, b3 as AggregateResult, b4 as BaseAdminAuthProvider, b5 as BaseFieldAdmin, b6 as BlockVariant, b7 as BlocksField, b8 as BooleanFieldAdmin, b9 as BooleanFormat, ba as CURRENT_NAV_PREFERENCES_VERSION, bb as CalendarViewConfig, bc as CardsViewConfig, bd as CharacterLimitFieldAdmin, be as CharacterLimitFieldConfig, bf as CollectionAfterChangeHook, bg as CollectionAfterDeleteHook, bh as CollectionAfterReadHook, bi as CollectionAfterReadHookEntry, bj as CollectionAfterTransitionHook, bk as CollectionBeforeChangeHook, bl as CollectionBeforeChangeHookEntry, bm as CollectionBeforeCommitHook, bn as CollectionBeforeDeleteHook, bo as CollectionBeforeReadHook, bp as CollectionBeforeReadHookEntry, bq as CollectionBeforeTransitionHook, br as CollectionIndex, bs as CollectionListComponentSlots, bt as CollectionRAGConfig, bu as CollectionSchemaResult, bv as CollectionSummaryResult, bw as CollectionViewComponentSlots, bx as CompiledNavGroup, by as CountOperation, bz as CustomAdminAuthProvider, bA as DEFAULT_USER_NAV_PREFERENCES, bB as DateFieldAdmin, bC as DateFormat, bD as DefaultValueContext, bE as DefineActionOptions, bF as DefineCalendarViewOptions, bG as DefineCardsViewOptions, bH as DefineGanttViewOptions, bI as DefineKanbanViewOptions, bJ as DefineTableViewOptions, bK as DefineViewBaseOptions, bL as DefineViewOptions, bM as DetailSpan, bN as DisplayTone, bO as DisplayVariant, bP as DistinctCountOperation, bQ as DistinctValuesOperation, bR as DynamicOptionItem, bS as DynamicOptionsConfig, bT as DynamicOptionsResolver, bU as DynamicOptionsResolverArgs, bV as DyrectedAIContext, bW as DyrectedLoggerConfig, bX as DyrectedObservabilityConfig, bY as EmailFieldAdmin, bZ as FieldAdminHooks, b_ as FieldAdminOnChangeHook, b$ as FieldAdminOnChangeHookArgs, c0 as FieldAdminOptionsHook, c1 as FieldAdminOptionsHookArgs, c2 as FieldAdminOptionsHookResult, c3 as FieldAfterReadHook, c4 as FieldAfterReadHookArgs, c5 as FieldBase, c6 as FieldBeforeChangeHook, c7 as FieldBeforeChangeHookArgs, c8 as FieldHook, c9 as FieldHooks, ca as FileData, cb as GanttViewConfig, cc as GetDocumentResult, cd as GlobalAfterChangeHook, ce as GlobalAfterReadHook, cf as GlobalAfterReadHookEntry, cg as GlobalBeforeChangeHook, ch as GlobalBeforeChangeHookEntry, ci as GlobalBeforeReadHook, cj as GlobalBeforeReadHookEntry, ck as GlobalRAGConfig, cl as GlobalSchemaResult, cm as GlobalSummaryResult, cn as HeadingLevel, co as HookFunction, cp as IconFieldAdmin, cq as ImageService, cr as ImageTransformOptions, cs as InferAggregateResult, ct as JoinFieldAdmin, cu as JsonFieldAdmin, cv as JsonFormat, cw as KanbanViewConfig, cx as LIFECYCLE_EVENT_NAMES, cy as LifecycleEventHandler, cz as LinkFormat, cA as MetricColor, cB as MoneyFieldAdmin, cC as MoneyFieldConfig, cD as MultiSelectFieldAdmin, cE as NamedAccessPolicy, cF as NavBadgeConfig, cG as NavGroup, cH as NumberFieldAdmin, cI as NumberFormat, cJ as NumberLimitFieldAdmin, cK as NumberLimitFieldConfig, cL as NumericOperation, cM as NumericUpdateOperator, cN as OIDCAdminAuthProvider, cO as OptionFormat, cP as PaginatedResult, cQ as PinnedNavItemRef, cR as PublicAdminAuthProvider, cS as QueryCollectionResult, cT as RAGSearchResult, cU as RadioFieldAdmin, cV as RateLimitConfig, cW as ReadonlyDatabaseAdapter, cX as RichTextFeature, cY as RichTextFieldConfig, cZ as SelectFieldAdmin, c_ as SqlWhereResult, c$ as StorageAdapter, d0 as TableViewConfig, d1 as TaskContext, d2 as TaskLogger, d3 as TaskRunStatus, d4 as TextFieldAdmin, d5 as TextFormat, d6 as TextareaFieldAdmin, d7 as TrustProxyConfig, d8 as TypedField, d9 as UploadConfig, da as UrlFieldAdmin, db as UrlLinkValue, dc as ViewActionFeatures, dd as ViewComponentSlots, de as ViewConfig, 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-Dd9cBbCs.cjs';
 import jexl from 'jexl';
 import { Context } from 'hono';
 export { z } from 'zod';
@@ -13,7 +13,7 @@ import '@opentelemetry/exporter-prometheus';
 type Prettify<T> = {
     [K in keyof T]: T[K];
 };
-type FieldValueType<F extends Field> = F["type"] extends "text" | "textarea" | "email" | "url" | "icon" | "date" | "datetime" | "time" | "select" | "radio" ? string : F["type"] extends "number" ? number : F["type"] extends "boolean" ? boolean : F["type"] extends "multiSelect" ? string[] : F["type"] extends "relationship" ? F extends {
+type FieldValueType<F extends Field> = F["type"] extends "text" | "textarea" | "email" | "url" | "icon" | "date" | "datetime" | "time" | "select" | "radio" ? string : F["type"] extends "number" | "money" ? number : F["type"] extends "boolean" ? boolean : F["type"] extends "multiSelect" ? string[] : F["type"] extends "relationship" ? F extends {
     hasMany: true;
 } ? string[] : string : F["type"] extends "image" ? F extends {
     hasMany: true;
@@ -639,6 +639,8 @@ declare function saveWorkflowDraft(args: {
     originalDoc: BaseDocument;
     data: Record<string, unknown>;
     user?: AuthenticatedUser;
+    /** Runs inside the write transaction, after the draft is saved. */
+    beforeCommit?: (tx: DatabaseAdapter, doc: BaseDocument) => Promise<void>;
 }): Promise<{
     doc: BaseDocument;
     event: LifecycleEvent;
@@ -648,6 +650,8 @@ declare function createWorkflowDocument(args: {
     collection: CollectionConfig;
     data: Record<string, unknown>;
     user?: AuthenticatedUser;
+    /** Runs inside the write transaction, after the document is created. */
+    beforeCommit?: (tx: DatabaseAdapter, doc: BaseDocument) => Promise<void>;
 }): Promise<{
     doc: BaseDocument;
     event: LifecycleEvent;
@@ -659,10 +663,74 @@ declare function transitionWorkflow(args: {
     transitionName: string;
     expectedRevision?: number;
     comment?: string;
+    input?: Record<string, unknown>;
     user?: AuthenticatedUser;
     req: HookRequestContext;
 }): Promise<BaseDocument>;
 
+declare const TASK_LOCKS_COLLECTION = "__task_locks";
+/** Internal collection holding one lock row per task. Created on demand by the runner. */
+declare const TASK_LOCKS_COLLECTION_CONFIG: CollectionConfig;
+interface CronSchedule {
+    minutes: Set<number>;
+    hours: Set<number>;
+    daysOfMonth: Set<number>;
+    months: Set<number>;
+    daysOfWeek: Set<number>;
+    /** Standard cron semantics: when both day fields are restricted, either may match. */
+    dayFieldsBothRestricted: boolean;
+}
+/** Parses a five-field cron expression. Throws a descriptive error when it is invalid. */
+declare function parseCron(expression: string): CronSchedule;
+/** The first cron slot strictly after `after`, in UTC. */
+declare function nextCronRun(expression: string | CronSchedule, after: Date): Date;
+/**
+ * Defines a background task. Validates the name, cron expression and lock
+ * timeout immediately, so a typo fails at startup rather than at 3am.
+ *
+ * @example
+ * ```ts
+ * export const ledgerDrift = defineTask({
+ *   name: "wallet:ledger-drift",
+ *   cron: "*\/15 * * * *",
+ *   lockTimeout: 300,
+ *   async run({ db, logger }) {
+ *     const drifts = await checkLedgerDrift(db);
+ *     if (drifts.length) logger.error({ drifts }, "Ledger drift detected");
+ *   },
+ * });
+ * ```
+ */
+declare function defineTask<const T extends TaskConfig>(task: T): T;
+interface TaskRunner {
+    /**
+     * Runs one task now, ignoring its schedule. Returns `skipped` with reason
+     * `"locked"` when another instance is already running it.
+     */
+    runTask(name: string): Promise<TaskRunResult>;
+    /**
+     * Runs every scheduled task that is due. Safe to call from any number of
+     * instances or from a platform cron: each due slot runs exactly once.
+     */
+    runDue(now?: Date): Promise<TaskRunResult[]>;
+    /** Starts polling for due tasks. Returns immediately and never blocks startup. */
+    start(options?: {
+        intervalMs?: number;
+    }): void;
+    /** Stops polling and waits for any run in progress to settle. */
+    stop(): Promise<void>;
+}
+/**
+ * Creates the runner for the tasks in `config.tasks`. Coordination between
+ * instances uses a lock row per task in the database, taken with a single
+ * conditional update, so it works across processes and on every adapter.
+ *
+ * Core does not start it for you: a timer is unreliable on serverless, so the
+ * host chooses. Call `start()` on a long-lived Node server, or call `runDue()`
+ * from a platform cron.
+ */
+declare function createTaskRunner(config: DyrectedConfig): TaskRunner;
+
 /**
  * Normalizes a DetailItem (which may be a shorthand string) into a standard DetailItem object.
  *
@@ -1393,6 +1461,28 @@ declare function generateDocumentId(collectionOrSlug?: string | {
     idGenerator?: (slug: string) => string;
 }): string;
 
+/**
+ * Builds the physical name of an index, for example `uniq_collection_wallets_currency`.
+ *
+ * MySQL rejects names over 64 characters and Postgres silently truncates at 63, which can
+ * collide or, on MySQL, leave a unique constraint uncreated. Names that would be too long are
+ * shortened to `<prefix>_<hash>_<last field>`, where the hash is derived from the full name so
+ * the result stays stable and unique per table and field set.
+ */
+declare function resolveIndexName(prefix: "uniq" | "idx", table: string, fields: string[]): string;
+
+/** Key used for the group whose value is null or missing. */
+declare const UNASSIGNED_GROUP_KEY = "__unassigned__";
+/**
+ * Turns the raw value of a `groupBy` column into the string key used in aggregate results.
+ *
+ * Databases hand the same logical value back in different shapes: a boolean is `true`, `1` or
+ * `'1'`; a decimal column returns `'1.0000'`; a timestamp is a `Date` or a space-separated string.
+ * Normalizing by the field's declared type keeps the keys identical on every adapter, so callers
+ * can look up `groups["true"]`, `groups["1"]` or an ISO date whichever database they run on.
+ */
+declare function normalizeGroupKey(raw: unknown, fieldType?: string): string;
+
 interface ReconciledNavTree extends CompiledNavTree {
     pinnedItems: CompiledNavItem[];
 }
@@ -1770,6 +1860,10 @@ declare const defineRichTextField: <const T extends Omit<RichTextField, "type">>
 declare const defineNumberField: <const T extends Omit<NumberField, "type">>(field: T) => T & {
     type: "number";
 };
+/** Define a `money` field stored as integer minor units. */
+declare const defineMoneyField: <const T extends Omit<MoneyField, "type">>(field: T) => T & {
+    type: "money";
+};
 /** Define a `boolean` field. */
 declare const defineBooleanField: <const T extends Omit<BooleanField, "type">>(field: T) => T & {
     type: "boolean";
@@ -1946,4 +2040,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, 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, 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, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, UserNavigationPreferences, ValidationError, 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, createWorkflowDocument, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, 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, normalizeConfig, normalizeDetailItem, now, numericFieldNames, parseSort, pow, prefixedId, pruneNavigationForUser, publishedStateName, publishingWorkflow, readingTime, reconcileNavigation, registerJexlHelpers, replace, resolveAdminAuthCollection, resolveAuthorizedSiteId, 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, 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, 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, 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 };

package/dist/index.d.ts

@@ -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 BaseDocument, H as HookRequestContext, f as DetailActionOptions, g as DetailAction, h as DetailComputedOptions, i as ComputedHandler, j as DetailComputed, k as DetailCustomOptions, l as DetailCustom, m as DetailDividerOptions, n as DetailDivider, o as DisplayFieldOptions, p as DetailField, q as DetailItem, r as DetailGridOptions, s as DetailGrid, t as DetailRepeatOptions, u as DetailRepeat, v as DetailSectionOptions, w as DetailSection, x as DetailTabOptions, y as DetailTab, z as DetailTabsOptions, E as DetailTabs, I as DetailTextOptions, J as DetailText, K as DetailSchema, M as DyrectedContext, N as AIConfig, O as AIPIIConfig, Q as IdStrategy, R as CompiledNavTree, S as CompiledNavItem, U as UserNavigationPreferences, T as DefineWorkspaceOptions, V as ArrayField, X as FieldType, Y as BooleanField, Z as AuthConfig, _ as AccessPolicyResolver, $ as DateField, a0 as DateTimeField, a1 as EmailField, a2 as IconField, a3 as ImageField, a4 as JoinField, a5 as JsonField, a6 as MultiSelectField, a7 as NumberField, a8 as ObjectField, a9 as RadioField, aa as RelationshipField, ab as RichTextField, ac as RowField, ad as SelectField, ae as TextField, af as TextareaField, ag as TimeField, ah as UrlField } from './app-CLdT_0se.js';
-export { ai as AIAction, aj as AIActionStatus, ak as AIActionType, al as AIAuditActionType, am as AIAuditRecord, an as AIChunk, ao as AIMessage, ap as AIPIIPattern, aq as AIRateLimitResult, ar as AIRateLimitStore, as as AIThread, at as AIToolContext, au as AIToolDefinition, av as AI_ACTIONS_COLLECTION, aw as AI_AUDIT_COLLECTION, ax as AI_CHUNKS_COLLECTION, ay as AI_MESSAGES_COLLECTION, az as AI_THREADS_COLLECTION, aA as AccessConfig, aB as AccessFunction, aC as AccessFunctionArgs, aD as AccessResult, aE as AccessRule, aF as ActionConfig, aG as ActionConfigBase, aH as ActionConfigWithHandler, aI as ActionConfigWithMutation, aJ as ActionContext, aK as ActionType, aL as AdminAuthAccessResolution, aM as AdminAuthClaimMapping, aN as AdminAuthMember, aO as AdminAuthProvider, aP as AdminAuthProviderMembersConfig, aQ as AdminAuthProvisioningMode, aR as AdminAuthResolveAccessArgs, aS as AdminAuthResolvedIdentity, aT as AdminConfig, aU as AdminDashboardComponentSlots, aV as AdminIconName, aW as AggregateArgs, aX as AggregateCastType, aY as AggregateCollectionResult, aZ as AggregateInput, a_ as AggregateOperation, a$ as AggregateResult, b0 as BaseAdminAuthProvider, b1 as BaseFieldAdmin, b2 as BlockVariant, b3 as BlocksField, b4 as BooleanFieldAdmin, b5 as BooleanFormat, b6 as CURRENT_NAV_PREFERENCES_VERSION, b7 as CalendarViewConfig, b8 as CardsViewConfig, b9 as CharacterLimitFieldAdmin, ba as CharacterLimitFieldConfig, bb as CollectionAfterChangeHook, bc as CollectionAfterDeleteHook, bd as CollectionAfterReadHook, be as CollectionAfterReadHookEntry, bf as CollectionAfterTransitionHook, bg as CollectionBeforeChangeHook, bh as CollectionBeforeChangeHookEntry, bi as CollectionBeforeDeleteHook, bj as CollectionBeforeReadHook, bk as CollectionBeforeReadHookEntry, bl as CollectionBeforeTransitionHook, bm as CollectionIndex, bn as CollectionListComponentSlots, bo as CollectionRAGConfig, bp as CollectionSchemaResult, bq as CollectionSummaryResult, br as CollectionViewComponentSlots, bs as CompiledNavGroup, bt as CountOperation, bu as CustomAdminAuthProvider, bv as DEFAULT_USER_NAV_PREFERENCES, bw as DatabaseAdapter, bx as DateFieldAdmin, by as DateFormat, bz as DefaultValueContext, bA as DefineActionOptions, bB as DefineCalendarViewOptions, bC as DefineCardsViewOptions, bD as DefineGanttViewOptions, bE as DefineKanbanViewOptions, bF as DefineTableViewOptions, bG as DefineViewBaseOptions, bH as DefineViewOptions, bI as DetailSpan, bJ as DisplayTone, bK as DisplayVariant, bL as DistinctCountOperation, bM as DistinctValuesOperation, bN as DynamicOptionItem, bO as DynamicOptionsConfig, bP as DynamicOptionsResolver, bQ as DynamicOptionsResolverArgs, bR as DyrectedAIContext, bS as DyrectedLoggerConfig, bT as DyrectedObservabilityConfig, bU as EmailFieldAdmin, bV as FieldAdminHooks, bW as FieldAdminOnChangeHook, bX as FieldAdminOnChangeHookArgs, bY as FieldAdminOptionsHook, bZ as FieldAdminOptionsHookArgs, b_ as FieldAdminOptionsHookResult, b$ as FieldAfterReadHook, c0 as FieldAfterReadHookArgs, c1 as FieldBase, c2 as FieldBeforeChangeHook, c3 as FieldBeforeChangeHookArgs, c4 as FieldHook, c5 as FieldHooks, c6 as FileData, c7 as GanttViewConfig, c8 as GetDocumentResult, c9 as GlobalAfterChangeHook, ca as GlobalAfterReadHook, cb as GlobalAfterReadHookEntry, cc as GlobalBeforeChangeHook, cd as GlobalBeforeChangeHookEntry, ce as GlobalBeforeReadHook, cf as GlobalBeforeReadHookEntry, cg as GlobalRAGConfig, ch as GlobalSchemaResult, ci as GlobalSummaryResult, cj as HeadingLevel, ck as HookFunction, cl as IconFieldAdmin, cm as ImageService, cn as ImageTransformOptions, co as InferAggregateResult, cp as JoinFieldAdmin, cq as JsonFieldAdmin, cr as JsonFormat, cs as KanbanViewConfig, ct as LIFECYCLE_EVENT_NAMES, cu as LifecycleEventHandler, cv as LinkFormat, cw as MetricColor, cx as MultiSelectFieldAdmin, cy as NamedAccessPolicy, cz as NavBadgeConfig, cA as NavGroup, cB as NumberFieldAdmin, cC as NumberFormat, cD as NumberLimitFieldAdmin, cE as NumberLimitFieldConfig, cF as NumericOperation, cG as NumericUpdateOperator, cH as OIDCAdminAuthProvider, cI as OptionFormat, cJ as PaginatedResult, cK as PinnedNavItemRef, cL as PublicAdminAuthProvider, cM as QueryCollectionResult, cN as RAGSearchResult, cO as RadioFieldAdmin, cP as RateLimitConfig, cQ as ReadonlyDatabaseAdapter, cR as RichTextFeature, cS as RichTextFieldConfig, cT as SelectFieldAdmin, cU as SqlWhereResult, cV as StorageAdapter, cW as TableViewConfig, cX as TextFieldAdmin, cY as TextFormat, cZ as TextareaFieldAdmin, c_ as TrustProxyConfig, c$ as TypedField, d0 as UploadConfig, d1 as UrlFieldAdmin, d2 as UrlLinkValue, d3 as ViewActionFeatures, d4 as ViewComponentSlots, d5 as ViewConfig, d6 as ViewConfigBase, d7 as ViewLayout, d8 as ViewMetric, d9 as ViewSubMetric, da as WhereClause, db as WhereOperator, dc as WhereOperatorName, dd as WordLimitFieldAdmin, de as WordLimitFieldConfig, df as WorkflowMetadata, dg as WorkflowRole, dh as WorkflowState, di as WorkflowTransitionContext, dj as defineAction, dk as defineCalendarView, dl as defineCardsView, dm as defineGanttView, dn as defineKanbanView, dp as defineTableView, dq as defineView, dr as defineWorkspace, ds as isAICollection, dt as parseMongoWhere, du as parseSqlWhere } from './app-CLdT_0se.js';
+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 ArrayField, _ as FieldType, $ as BooleanField, a0 as AuthConfig, a1 as AccessPolicyResolver, a2 as DateField, a3 as DateTimeField, a4 as EmailField, a5 as IconField, a6 as ImageField, a7 as JoinField, a8 as JsonField, a9 as MoneyField, aa as MultiSelectField, ab as NumberField, ac as ObjectField, ad as RadioField, ae as RelationshipField, af as RichTextField, ag as RowField, ah as SelectField, ai as TextField, aj as TextareaField, ak as TimeField, al as UrlField } from './app-Dd9cBbCs.js';
+export { am as AIAction, an as AIActionStatus, ao as AIActionType, ap as AIAuditActionType, aq as AIAuditRecord, ar as AIChunk, as as AIMessage, at as AIPIIPattern, au as AIRateLimitResult, av as AIRateLimitStore, aw as AIThread, ax as AIToolContext, ay as AIToolDefinition, az as AI_ACTIONS_COLLECTION, aA as AI_AUDIT_COLLECTION, aB as AI_CHUNKS_COLLECTION, aC as AI_MESSAGES_COLLECTION, aD as AI_THREADS_COLLECTION, aE as AccessConfig, aF as AccessFunction, aG as AccessFunctionArgs, aH as AccessResult, aI as AccessRule, aJ as ActionConfig, aK as ActionConfigBase, aL as ActionConfigWithHandler, aM as ActionConfigWithMutation, aN as ActionContext, aO as ActionType, aP as AdminAuthAccessResolution, aQ as AdminAuthClaimMapping, aR as AdminAuthMember, aS as AdminAuthProvider, aT as AdminAuthProviderMembersConfig, aU as AdminAuthProvisioningMode, aV as AdminAuthResolveAccessArgs, aW as AdminAuthResolvedIdentity, aX as AdminConfig, aY as AdminDashboardComponentSlots, aZ as AdminIconName, a_ as AggregateArgs, a$ as AggregateCastType, b0 as AggregateCollectionResult, b1 as AggregateInput, b2 as AggregateOperation, b3 as AggregateResult, b4 as BaseAdminAuthProvider, b5 as BaseFieldAdmin, b6 as BlockVariant, b7 as BlocksField, b8 as BooleanFieldAdmin, b9 as BooleanFormat, ba as CURRENT_NAV_PREFERENCES_VERSION, bb as CalendarViewConfig, bc as CardsViewConfig, bd as CharacterLimitFieldAdmin, be as CharacterLimitFieldConfig, bf as CollectionAfterChangeHook, bg as CollectionAfterDeleteHook, bh as CollectionAfterReadHook, bi as CollectionAfterReadHookEntry, bj as CollectionAfterTransitionHook, bk as CollectionBeforeChangeHook, bl as CollectionBeforeChangeHookEntry, bm as CollectionBeforeCommitHook, bn as CollectionBeforeDeleteHook, bo as CollectionBeforeReadHook, bp as CollectionBeforeReadHookEntry, bq as CollectionBeforeTransitionHook, br as CollectionIndex, bs as CollectionListComponentSlots, bt as CollectionRAGConfig, bu as CollectionSchemaResult, bv as CollectionSummaryResult, bw as CollectionViewComponentSlots, bx as CompiledNavGroup, by as CountOperation, bz as CustomAdminAuthProvider, bA as DEFAULT_USER_NAV_PREFERENCES, bB as DateFieldAdmin, bC as DateFormat, bD as DefaultValueContext, bE as DefineActionOptions, bF as DefineCalendarViewOptions, bG as DefineCardsViewOptions, bH as DefineGanttViewOptions, bI as DefineKanbanViewOptions, bJ as DefineTableViewOptions, bK as DefineViewBaseOptions, bL as DefineViewOptions, bM as DetailSpan, bN as DisplayTone, bO as DisplayVariant, bP as DistinctCountOperation, bQ as DistinctValuesOperation, bR as DynamicOptionItem, bS as DynamicOptionsConfig, bT as DynamicOptionsResolver, bU as DynamicOptionsResolverArgs, bV as DyrectedAIContext, bW as DyrectedLoggerConfig, bX as DyrectedObservabilityConfig, bY as EmailFieldAdmin, bZ as FieldAdminHooks, b_ as FieldAdminOnChangeHook, b$ as FieldAdminOnChangeHookArgs, c0 as FieldAdminOptionsHook, c1 as FieldAdminOptionsHookArgs, c2 as FieldAdminOptionsHookResult, c3 as FieldAfterReadHook, c4 as FieldAfterReadHookArgs, c5 as FieldBase, c6 as FieldBeforeChangeHook, c7 as FieldBeforeChangeHookArgs, c8 as FieldHook, c9 as FieldHooks, ca as FileData, cb as GanttViewConfig, cc as GetDocumentResult, cd as GlobalAfterChangeHook, ce as GlobalAfterReadHook, cf as GlobalAfterReadHookEntry, cg as GlobalBeforeChangeHook, ch as GlobalBeforeChangeHookEntry, ci as GlobalBeforeReadHook, cj as GlobalBeforeReadHookEntry, ck as GlobalRAGConfig, cl as GlobalSchemaResult, cm as GlobalSummaryResult, cn as HeadingLevel, co as HookFunction, cp as IconFieldAdmin, cq as ImageService, cr as ImageTransformOptions, cs as InferAggregateResult, ct as JoinFieldAdmin, cu as JsonFieldAdmin, cv as JsonFormat, cw as KanbanViewConfig, cx as LIFECYCLE_EVENT_NAMES, cy as LifecycleEventHandler, cz as LinkFormat, cA as MetricColor, cB as MoneyFieldAdmin, cC as MoneyFieldConfig, cD as MultiSelectFieldAdmin, cE as NamedAccessPolicy, cF as NavBadgeConfig, cG as NavGroup, cH as NumberFieldAdmin, cI as NumberFormat, cJ as NumberLimitFieldAdmin, cK as NumberLimitFieldConfig, cL as NumericOperation, cM as NumericUpdateOperator, cN as OIDCAdminAuthProvider, cO as OptionFormat, cP as PaginatedResult, cQ as PinnedNavItemRef, cR as PublicAdminAuthProvider, cS as QueryCollectionResult, cT as RAGSearchResult, cU as RadioFieldAdmin, cV as RateLimitConfig, cW as ReadonlyDatabaseAdapter, cX as RichTextFeature, cY as RichTextFieldConfig, cZ as SelectFieldAdmin, c_ as SqlWhereResult, c$ as StorageAdapter, d0 as TableViewConfig, d1 as TaskContext, d2 as TaskLogger, d3 as TaskRunStatus, d4 as TextFieldAdmin, d5 as TextFormat, d6 as TextareaFieldAdmin, d7 as TrustProxyConfig, d8 as TypedField, d9 as UploadConfig, da as UrlFieldAdmin, db as UrlLinkValue, dc as ViewActionFeatures, dd as ViewComponentSlots, de as ViewConfig, 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-Dd9cBbCs.js';
 import jexl from 'jexl';
 import { Context } from 'hono';
 export { z } from 'zod';
@@ -13,7 +13,7 @@ import '@opentelemetry/exporter-prometheus';
 type Prettify<T> = {
     [K in keyof T]: T[K];
 };
-type FieldValueType<F extends Field> = F["type"] extends "text" | "textarea" | "email" | "url" | "icon" | "date" | "datetime" | "time" | "select" | "radio" ? string : F["type"] extends "number" ? number : F["type"] extends "boolean" ? boolean : F["type"] extends "multiSelect" ? string[] : F["type"] extends "relationship" ? F extends {
+type FieldValueType<F extends Field> = F["type"] extends "text" | "textarea" | "email" | "url" | "icon" | "date" | "datetime" | "time" | "select" | "radio" ? string : F["type"] extends "number" | "money" ? number : F["type"] extends "boolean" ? boolean : F["type"] extends "multiSelect" ? string[] : F["type"] extends "relationship" ? F extends {
     hasMany: true;
 } ? string[] : string : F["type"] extends "image" ? F extends {
     hasMany: true;
@@ -639,6 +639,8 @@ declare function saveWorkflowDraft(args: {
     originalDoc: BaseDocument;
     data: Record<string, unknown>;
     user?: AuthenticatedUser;
+    /** Runs inside the write transaction, after the draft is saved. */
+    beforeCommit?: (tx: DatabaseAdapter, doc: BaseDocument) => Promise<void>;
 }): Promise<{
     doc: BaseDocument;
     event: LifecycleEvent;
@@ -648,6 +650,8 @@ declare function createWorkflowDocument(args: {
     collection: CollectionConfig;
     data: Record<string, unknown>;
     user?: AuthenticatedUser;
+    /** Runs inside the write transaction, after the document is created. */
+    beforeCommit?: (tx: DatabaseAdapter, doc: BaseDocument) => Promise<void>;
 }): Promise<{
     doc: BaseDocument;
     event: LifecycleEvent;
@@ -659,10 +663,74 @@ declare function transitionWorkflow(args: {
     transitionName: string;
     expectedRevision?: number;
     comment?: string;
+    input?: Record<string, unknown>;
     user?: AuthenticatedUser;
     req: HookRequestContext;
 }): Promise<BaseDocument>;
 
+declare const TASK_LOCKS_COLLECTION = "__task_locks";
+/** Internal collection holding one lock row per task. Created on demand by the runner. */
+declare const TASK_LOCKS_COLLECTION_CONFIG: CollectionConfig;
+interface CronSchedule {
+    minutes: Set<number>;
+    hours: Set<number>;
+    daysOfMonth: Set<number>;
+    months: Set<number>;
+    daysOfWeek: Set<number>;
+    /** Standard cron semantics: when both day fields are restricted, either may match. */
+    dayFieldsBothRestricted: boolean;
+}
+/** Parses a five-field cron expression. Throws a descriptive error when it is invalid. */
+declare function parseCron(expression: string): CronSchedule;
+/** The first cron slot strictly after `after`, in UTC. */
+declare function nextCronRun(expression: string | CronSchedule, after: Date): Date;
+/**
+ * Defines a background task. Validates the name, cron expression and lock
+ * timeout immediately, so a typo fails at startup rather than at 3am.
+ *
+ * @example
+ * ```ts
+ * export const ledgerDrift = defineTask({
+ *   name: "wallet:ledger-drift",
+ *   cron: "*\/15 * * * *",
+ *   lockTimeout: 300,
+ *   async run({ db, logger }) {
+ *     const drifts = await checkLedgerDrift(db);
+ *     if (drifts.length) logger.error({ drifts }, "Ledger drift detected");
+ *   },
+ * });
+ * ```
+ */
+declare function defineTask<const T extends TaskConfig>(task: T): T;
+interface TaskRunner {
+    /**
+     * Runs one task now, ignoring its schedule. Returns `skipped` with reason
+     * `"locked"` when another instance is already running it.
+     */
+    runTask(name: string): Promise<TaskRunResult>;
+    /**
+     * Runs every scheduled task that is due. Safe to call from any number of
+     * instances or from a platform cron: each due slot runs exactly once.
+     */
+    runDue(now?: Date): Promise<TaskRunResult[]>;
+    /** Starts polling for due tasks. Returns immediately and never blocks startup. */
+    start(options?: {
+        intervalMs?: number;
+    }): void;
+    /** Stops polling and waits for any run in progress to settle. */
+    stop(): Promise<void>;
+}
+/**
+ * Creates the runner for the tasks in `config.tasks`. Coordination between
+ * instances uses a lock row per task in the database, taken with a single
+ * conditional update, so it works across processes and on every adapter.
+ *
+ * Core does not start it for you: a timer is unreliable on serverless, so the
+ * host chooses. Call `start()` on a long-lived Node server, or call `runDue()`
+ * from a platform cron.
+ */
+declare function createTaskRunner(config: DyrectedConfig): TaskRunner;
+
 /**
  * Normalizes a DetailItem (which may be a shorthand string) into a standard DetailItem object.
  *
@@ -1393,6 +1461,28 @@ declare function generateDocumentId(collectionOrSlug?: string | {
     idGenerator?: (slug: string) => string;
 }): string;
 
+/**
+ * Builds the physical name of an index, for example `uniq_collection_wallets_currency`.
+ *
+ * MySQL rejects names over 64 characters and Postgres silently truncates at 63, which can
+ * collide or, on MySQL, leave a unique constraint uncreated. Names that would be too long are
+ * shortened to `<prefix>_<hash>_<last field>`, where the hash is derived from the full name so
+ * the result stays stable and unique per table and field set.
+ */
+declare function resolveIndexName(prefix: "uniq" | "idx", table: string, fields: string[]): string;
+
+/** Key used for the group whose value is null or missing. */
+declare const UNASSIGNED_GROUP_KEY = "__unassigned__";
+/**
+ * Turns the raw value of a `groupBy` column into the string key used in aggregate results.
+ *
+ * Databases hand the same logical value back in different shapes: a boolean is `true`, `1` or
+ * `'1'`; a decimal column returns `'1.0000'`; a timestamp is a `Date` or a space-separated string.
+ * Normalizing by the field's declared type keeps the keys identical on every adapter, so callers
+ * can look up `groups["true"]`, `groups["1"]` or an ISO date whichever database they run on.
+ */
+declare function normalizeGroupKey(raw: unknown, fieldType?: string): string;
+
 interface ReconciledNavTree extends CompiledNavTree {
     pinnedItems: CompiledNavItem[];
 }
@@ -1770,6 +1860,10 @@ declare const defineRichTextField: <const T extends Omit<RichTextField, "type">>
 declare const defineNumberField: <const T extends Omit<NumberField, "type">>(field: T) => T & {
     type: "number";
 };
+/** Define a `money` field stored as integer minor units. */
+declare const defineMoneyField: <const T extends Omit<MoneyField, "type">>(field: T) => T & {
+    type: "money";
+};
 /** Define a `boolean` field. */
 declare const defineBooleanField: <const T extends Omit<BooleanField, "type">>(field: T) => T & {
     type: "boolean";
@@ -1946,4 +2040,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, 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, 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, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, UserNavigationPreferences, ValidationError, 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, createWorkflowDocument, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, 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, normalizeConfig, normalizeDetailItem, now, numericFieldNames, parseSort, pow, prefixedId, pruneNavigationForUser, publishedStateName, publishingWorkflow, readingTime, reconcileNavigation, registerJexlHelpers, replace, resolveAdminAuthCollection, resolveAuthorizedSiteId, 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, 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, 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, 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 };