@dyrected/core 2.8.2 → 2.9.0

package/dist/{app-config-WzqpuZMr.d.cts → app-config-gEQJFvnN.d.cts}

@@ -851,6 +851,212 @@ type DetailItem<TDoc = any> = DetailSection | DetailTabs | DetailGrid | DetailFi
  */
 type DetailSchema<TDoc = any> = DetailItem<TDoc>[];
 
+/**
+ * The set of type-cast operations supported during aggregation.
+ *
+ * Each adapter maps these to its own native conversion primitive
+ * (e.g. `$toDouble` in MongoDB, `CAST(x AS REAL)` in SQLite).
+ * The public API is always database-independent.
+ */
+type AggregateCastType = "number" | "integer" | "float" | "string" | "boolean" | "date";
+/**
+ * A `count` aggregate operation.
+ *
+ * - `count: "*"` — count every document matched by `where`.
+ * - `cast` is intentionally absent: counting is document-level,
+ *   not field-value-level, so type conversion has no meaning here.
+ */
+interface CountOperation {
+    count: "*";
+    where?: Record<string, unknown>;
+}
+/**
+ * A `sum`, `avg`, `min`, or `max` aggregate operation on a named field.
+ *
+ * - `cast` converts stored values before the aggregation runs.
+ *   Invalid values (e.g. `"unknown"` cast to `number`) become `null`
+ *   and are ignored by `sum`, `avg`, `min`, and `max`.
+ */
+interface NumericOperation {
+    sum?: string;
+    avg?: string;
+    min?: string;
+    max?: string;
+    cast?: AggregateCastType;
+    where?: Record<string, unknown>;
+}
+/**
+ * A single named aggregate request — either a count or a numeric operation.
+ */
+type AggregateOperation = CountOperation | NumericOperation;
+/**
+ * The map of named aggregate operations sent in a single aggregate request.
+ *
+ * @example
+ * ```ts
+ * {
+ *   totalSubmitted: { count: "*" },
+ *   totalAsoebiYards: { sum: "asoebiYards", cast: "number", where: { wantsAsoebi: { equals: true } } },
+ * }
+ * ```
+ */
+type AggregateInput = Record<string, AggregateOperation>;
+/**
+ * The arguments passed to `DatabaseAdapter.aggregate`.
+ */
+interface AggregateArgs {
+    /** Collection slug. */
+    collection: string;
+    /** Named aggregate operations to compute. */
+    aggregates: AggregateInput;
+}
+/**
+ * The result returned by `DatabaseAdapter.aggregate`.
+ *
+ * Every named key maps to a `number | null`.
+ * `null` is returned when no documents matched the aggregate's `where`
+ * (applicable to `sum`, `avg`, `min`, `max`).
+ * `count` also returns `null` only if the database errors — it normally
+ * returns `0` for an empty match set.
+ */
+type AggregateResult = Record<string, number | null>;
+/**
+ * Derives the typed result shape from an `AggregateInput`.
+ * Every named key maps to `number | null`.
+ *
+ * @example
+ * ```ts
+ * type Input = { totalSubmitted: CountOperation; totalYards: NumericOperation };
+ * type Result = InferAggregateResult<Input>;
+ * // => { totalSubmitted: number | null; totalYards: number | null }
+ * ```
+ */
+type InferAggregateResult<T extends AggregateInput> = {
+    [K in keyof T]: number | null;
+};
+
+type ViewLayout = 'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards';
+type ActionType = 'row' | 'bulk' | 'header';
+/**
+ * Toggles for the built-in document operations an operational view surfaces
+ * (View/Edit/Duplicate/Delete/Export-selected). All default to enabled;
+ * set any to `false` to hide that operation for the view.
+ */
+interface ViewActionFeatures {
+    view?: boolean;
+    edit?: boolean;
+    duplicate?: boolean;
+    delete?: boolean;
+    exportSelected?: boolean;
+}
+type MetricColor = 'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange' | string;
+interface ViewSubMetric {
+    label: string;
+    aggregate?: AggregateOperation;
+    aggregates?: Record<string, AggregateOperation>;
+    transform?: string;
+    expression?: string;
+    format?: 'currency' | 'number' | 'percent' | string;
+    currency?: string;
+}
+interface ViewMetric {
+    label: string;
+    color?: MetricColor;
+    unit?: string;
+    aggregate?: AggregateOperation;
+    aggregates?: Record<string, AggregateOperation>;
+    transform?: string;
+    expression?: string;
+    format?: 'currency' | 'number' | 'percent' | string;
+    currency?: string;
+    subMetrics?: ViewSubMetric[];
+}
+interface ViewConfig {
+    slug: string;
+    label: string;
+    icon?: string;
+    layout?: ViewLayout;
+    filter?: Record<string, any> | string;
+    groupBy?: string;
+    dateField?: string;
+    startDateField?: string;
+    endDateField?: string;
+    columns?: string[];
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    actions?: ActionConfig[];
+    /** Toggles built-in operations (view/edit/duplicate/delete/export). */
+    features?: ViewActionFeatures;
+    /**
+     * Explicit display order for actions — built-in names ("view", "edit",
+     * "duplicate", "delete") and/or custom action names. Unlisted actions
+     * append in their default order.
+     */
+    actionOrder?: string[];
+    metrics?: ViewMetric[];
+    access?: AccessConfig;
+}
+interface ActionConfig {
+    name: string;
+    label: string;
+    icon?: string;
+    type?: ActionType;
+    confirm?: string;
+    fields?: Field[];
+    mutation?: Record<string, any>;
+    handler?: (context: ActionContext) => Promise<any>;
+    access?: AccessConfig;
+}
+interface ActionContext {
+    doc: Record<string, unknown>;
+    docs: Record<string, unknown>[];
+    user: Record<string, unknown> | null;
+    input: Record<string, unknown>;
+    collection: Record<string, unknown>;
+}
+interface AccessConfig {
+    read?: AccessRule<any>;
+    create?: AccessRule<any>;
+    update?: AccessRule<any>;
+    delete?: AccessRule<any>;
+}
+interface DefineViewOptions {
+    slug: string;
+    label: string;
+    icon?: string;
+    layout?: ViewLayout;
+    filter?: Record<string, any> | string;
+    groupBy?: string;
+    dateField?: string;
+    startDateField?: string;
+    endDateField?: string;
+    columns?: string[];
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    actions?: ActionConfig[];
+    features?: ViewActionFeatures;
+    actionOrder?: string[];
+    metrics?: ViewMetric[];
+    access?: AccessConfig;
+}
+interface DefineActionOptions {
+    name: string;
+    label: string;
+    icon?: string;
+    type?: ActionType;
+    confirm?: string;
+    fields?: Field[];
+    mutation?: Record<string, any>;
+    handler?: (context: ActionContext) => Promise<any>;
+    access?: AccessConfig;
+}
+declare function defineView(config: DefineViewOptions): ViewConfig;
+declare function defineAction(config: DefineActionOptions): ActionConfig;
+
 /**
  * Configures account lockout behavior for an auth-enabled collection.
  *
@@ -1208,6 +1414,11 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
      * Custom detail view layout configuration for the Admin UI.
      */
     detail?: DetailSchema<TDoc> | false;
+    /**
+     * Operational views for this collection.
+     * Each view provides a tailored workspace for a specific job or workflow.
+     */
+    views?: ViewConfig[];
 }
 /**
  * Defines a Dyrected global — a singleton document without pagination or IDs.
@@ -1297,90 +1508,6 @@ interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
     detail?: DetailSchema<TDoc> | false;
 }
 
-/**
- * The set of type-cast operations supported during aggregation.
- *
- * Each adapter maps these to its own native conversion primitive
- * (e.g. `$toDouble` in MongoDB, `CAST(x AS REAL)` in SQLite).
- * The public API is always database-independent.
- */
-type AggregateCastType = "number" | "integer" | "float" | "string" | "boolean" | "date";
-/**
- * A `count` aggregate operation.
- *
- * - `count: "*"` — count every document matched by `where`.
- * - `cast` is intentionally absent: counting is document-level,
- *   not field-value-level, so type conversion has no meaning here.
- */
-interface CountOperation {
-    count: "*";
-    where?: Record<string, unknown>;
-}
-/**
- * A `sum`, `avg`, `min`, or `max` aggregate operation on a named field.
- *
- * - `cast` converts stored values before the aggregation runs.
- *   Invalid values (e.g. `"unknown"` cast to `number`) become `null`
- *   and are ignored by `sum`, `avg`, `min`, and `max`.
- */
-interface NumericOperation {
-    sum?: string;
-    avg?: string;
-    min?: string;
-    max?: string;
-    cast?: AggregateCastType;
-    where?: Record<string, unknown>;
-}
-/**
- * A single named aggregate request — either a count or a numeric operation.
- */
-type AggregateOperation = CountOperation | NumericOperation;
-/**
- * The map of named aggregate operations sent in a single aggregate request.
- *
- * @example
- * ```ts
- * {
- *   totalSubmitted: { count: "*" },
- *   totalAsoebiYards: { sum: "asoebiYards", cast: "number", where: { wantsAsoebi: { equals: true } } },
- * }
- * ```
- */
-type AggregateInput = Record<string, AggregateOperation>;
-/**
- * The arguments passed to `DatabaseAdapter.aggregate`.
- */
-interface AggregateArgs {
-    /** Collection slug. */
-    collection: string;
-    /** Named aggregate operations to compute. */
-    aggregates: AggregateInput;
-}
-/**
- * The result returned by `DatabaseAdapter.aggregate`.
- *
- * Every named key maps to a `number | null`.
- * `null` is returned when no documents matched the aggregate's `where`
- * (applicable to `sum`, `avg`, `min`, `max`).
- * `count` also returns `null` only if the database errors — it normally
- * returns `0` for an empty match set.
- */
-type AggregateResult = Record<string, number | null>;
-/**
- * Derives the typed result shape from an `AggregateInput`.
- * Every named key maps to `number | null`.
- *
- * @example
- * ```ts
- * type Input = { totalSubmitted: CountOperation; totalYards: NumericOperation };
- * type Result = InferAggregateResult<Input>;
- * // => { totalSubmitted: number | null; totalYards: number | null }
- * ```
- */
-type InferAggregateResult<T extends AggregateInput> = {
-    [K in keyof T]: number | null;
-};
-
 /**
  * The interface every database adapter must implement.
  *
@@ -1455,6 +1582,11 @@ interface DatabaseAdapter {
      * Shipped adapters implement this; workflow transitions require it.
      */
     transaction?<T>(callback: (db: DatabaseAdapter) => Promise<T>): Promise<T>;
+    /**
+     * Close any open connection pools, sockets, or background timers.
+     * Called during server teardown or build lifecycle cleanup.
+     */
+    disconnect?(): Promise<void>;
 }
 /**
  * Read-only view of the database adapter. Exposes only `find`, `findOne`,
@@ -2563,4 +2695,4 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
     }>;
 }
 
-export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type FieldAdminOnChangeHook as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessFunction as a8, type AccessFunctionArgs as a9, type CollectionAfterDeleteHook as aA, type CollectionAfterReadHook as aB, type CollectionAfterReadHookEntry as aC, type CollectionAfterTransitionHook as aD, type CollectionBeforeChangeHook as aE, type CollectionBeforeChangeHookEntry as aF, type CollectionBeforeDeleteHook as aG, type CollectionBeforeReadHook as aH, type CollectionBeforeReadHookEntry as aI, type CollectionBeforeTransitionHook as aJ, type CollectionListComponentSlots as aK, type CountOperation as aL, type CustomAdminAuthProvider as aM, type DatabaseAdapter as aN, type DateFieldAdmin as aO, type DateFormat as aP, type DetailSpan as aQ, type DisplayTone as aR, type DisplayVariant as aS, type DynamicOptionItem as aT, type DynamicOptionsConfig as aU, type DynamicOptionsResolver as aV, type DynamicOptionsResolverArgs as aW, type DyrectedLoggerConfig as aX, type DyrectedObservabilityConfig as aY, type EmailFieldAdmin as aZ, type FieldAdminHooks as a_, type AccessResult as aa, type AccessRule as ab, type AdminAuthAccessResolution as ac, type AdminAuthClaimMapping as ad, type AdminAuthMember as ae, type AdminAuthProvider as af, type AdminAuthProviderMembersConfig as ag, type AdminAuthProvisioningMode as ah, type AdminAuthResolveAccessArgs as ai, type AdminAuthResolvedIdentity as aj, type AdminConfig as ak, type AdminDashboardComponentSlots as al, type AdminIconName as am, type AggregateArgs as an, type AggregateCastType as ao, type AggregateInput as ap, type AggregateOperation as aq, type AggregateResult as ar, type BaseAdminAuthProvider as as, type BaseFieldAdmin as at, type BlockVariant as au, type BooleanFieldAdmin as av, type BooleanFormat as aw, type CharacterLimitFieldAdmin as ax, type CharacterLimitFieldConfig as ay, type CollectionAfterChangeHook as az, type AuthenticatedUser as b, type FieldAdminOnChangeHookArgs as b0, type FieldAdminOptionsHook as b1, type FieldAdminOptionsHookArgs as b2, type FieldAdminOptionsHookResult as b3, type FieldAfterReadHook as b4, type FieldAfterReadHookArgs as b5, type FieldBase as b6, type FieldBeforeChangeHook as b7, type FieldBeforeChangeHookArgs as b8, type FieldHook as b9, type NumberLimitFieldConfig as bA, type NumericOperation as bB, type OIDCAdminAuthProvider as bC, type OptionFormat as bD, type PaginatedResult as bE, type PublicAdminAuthProvider as bF, type RadioFieldAdmin as bG, type RateLimitConfig as bH, type ReadonlyDatabaseAdapter as bI, type RichTextFeature as bJ, type RichTextFieldConfig as bK, type SelectFieldAdmin as bL, type StorageAdapter as bM, type TextFieldAdmin as bN, type TextFormat as bO, type TextareaFieldAdmin as bP, type TrustProxyConfig as bQ, type TypedField as bR, type UploadConfig as bS, type UrlFieldAdmin as bT, type UrlLinkValue as bU, type WordLimitFieldAdmin as bV, type WordLimitFieldConfig as bW, type WorkflowMetadata as bX, type WorkflowRole as bY, type WorkflowState as bZ, type WorkflowTransitionContext as b_, type FieldHooks as ba, type FieldType as bb, type FileData as bc, type GlobalAfterChangeHook as bd, type GlobalAfterReadHook as be, type GlobalAfterReadHookEntry as bf, type GlobalBeforeChangeHook as bg, type GlobalBeforeChangeHookEntry as bh, type GlobalBeforeReadHook as bi, type GlobalBeforeReadHookEntry as bj, type HeadingLevel as bk, type HookFunction as bl, type IconFieldAdmin as bm, type ImageService as bn, type InferAggregateResult as bo, type JoinFieldAdmin as bp, type JsonFieldAdmin as bq, type JsonFormat as br, LIFECYCLE_EVENT_NAMES as bs, type LifecycleEventHandler as bt, type LinkFormat as bu, type MultiSelectFieldAdmin as bv, type NamedAccessPolicy as bw, type NumberFieldAdmin as bx, type NumberFormat as by, type NumberLimitFieldAdmin as bz, type WorkflowTransition as c, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };
+export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DynamicOptionsResolver as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CountOperation as aP, type CustomAdminAuthProvider as aQ, type DatabaseAdapter as aR, type DateFieldAdmin as aS, type DateFormat as aT, type DefineActionOptions as aU, type DefineViewOptions as aV, type DetailSpan as aW, type DisplayTone as aX, type DisplayVariant as aY, type DynamicOptionItem as aZ, type DynamicOptionsConfig as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type UrlLinkValue as b$, type DynamicOptionsResolverArgs as b0, type DyrectedLoggerConfig as b1, type DyrectedObservabilityConfig as b2, type EmailFieldAdmin as b3, type FieldAdminHooks as b4, type FieldAdminOnChangeHook as b5, type FieldAdminOnChangeHookArgs as b6, type FieldAdminOptionsHook as b7, type FieldAdminOptionsHookArgs as b8, type FieldAdminOptionsHookResult as b9, type LinkFormat as bA, type MetricColor as bB, type MultiSelectFieldAdmin as bC, type NamedAccessPolicy as bD, type NumberFieldAdmin as bE, type NumberFormat as bF, type NumberLimitFieldAdmin as bG, type NumberLimitFieldConfig as bH, type NumericOperation as bI, type OIDCAdminAuthProvider as bJ, type OptionFormat as bK, type PaginatedResult as bL, type PublicAdminAuthProvider as bM, type RadioFieldAdmin as bN, type RateLimitConfig as bO, type ReadonlyDatabaseAdapter as bP, type RichTextFeature as bQ, type RichTextFieldConfig as bR, type SelectFieldAdmin as bS, type StorageAdapter as bT, type TextFieldAdmin as bU, type TextFormat as bV, type TextareaFieldAdmin as bW, type TrustProxyConfig as bX, type TypedField as bY, type UploadConfig as bZ, type UrlFieldAdmin as b_, type FieldAfterReadHook as ba, type FieldAfterReadHookArgs as bb, type FieldBase as bc, type FieldBeforeChangeHook as bd, type FieldBeforeChangeHookArgs as be, type FieldHook as bf, type FieldHooks as bg, type FieldType as bh, type FileData as bi, type GlobalAfterChangeHook as bj, type GlobalAfterReadHook as bk, type GlobalAfterReadHookEntry as bl, type GlobalBeforeChangeHook as bm, type GlobalBeforeChangeHookEntry as bn, type GlobalBeforeReadHook as bo, type GlobalBeforeReadHookEntry as bp, type HeadingLevel as bq, type HookFunction as br, type IconFieldAdmin as bs, type ImageService as bt, type InferAggregateResult as bu, type JoinFieldAdmin as bv, type JsonFieldAdmin as bw, type JsonFormat as bx, LIFECYCLE_EVENT_NAMES as by, type LifecycleEventHandler as bz, type WorkflowTransition as c, type ViewActionFeatures as c0, type ViewConfig as c1, type ViewLayout as c2, type ViewMetric as c3, type ViewSubMetric as c4, type WordLimitFieldAdmin as c5, type WordLimitFieldConfig as c6, type WorkflowMetadata as c7, type WorkflowRole as c8, type WorkflowState as c9, type WorkflowTransitionContext as ca, defineAction as cb, defineView as cc, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };