@dyrected/core 2.15.0 → 2.16.0

package/dist/{app-Cmp5lFLJ.d.cts → app-KSDgfXsw.d.cts}

@@ -1584,9 +1584,9 @@ type ActionConfig<TDoc extends Record<string, unknown> = Record<string, unknown>
  * Context passed to an action's server handler function.
  */
 interface ActionContext<TDoc extends Record<string, unknown> = Record<string, unknown>> {
-    /** The target document (for row actions). */
-    doc: TDoc;
-    /** All targeted documents (for bulk actions). */
+    /** The target document (for row actions), or null for header actions. */
+    doc: TDoc | null;
+    /** All targeted documents (for bulk actions). Empty array for header actions. */
     docs: TDoc[];
     /** The authenticated acting user, if available. */
     user: Record<string, unknown> | null;
@@ -1835,6 +1835,30 @@ interface AuthConfig {
      */
     adminRole?: string;
 }
+/**
+ * Physical database index specification for a collection.
+ */
+interface CollectionIndex {
+    /** Optional custom index name. If omitted, adapter auto-generates one. */
+    name?: string;
+    /** Field names participating in the index. */
+    fields: string[];
+    /** Whether the index enforces database-level uniqueness. Defaults to false. */
+    unique?: boolean;
+    /** Whether to only index non-null rows where supported. */
+    sparse?: boolean;
+}
+/**
+ * Atomic numeric update operators for database mutation payloads.
+ */
+interface NumericUpdateOperator {
+    increment?: number;
+    decrement?: number;
+}
+/**
+ * Strategy for generating document IDs.
+ */
+type IdStrategy = "prefixed-nanoid" | "nanoid" | "ulid" | "uuid";
 /**
  * Use this contract when you want the exact shape of a collection config.
  *
@@ -1960,6 +1984,31 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
      * @see {@link https://dyrected.com/docs/model-content/fields/blocks Blocks and page sections}
      */
     fields: Field[];
+    /**
+     * Database indexes to create on this collection.
+     *
+     * Fields participating in indexes are automatically promoted to physical columns.
+     */
+    indexes?: CollectionIndex[];
+    /**
+     * Optional custom prefix for auto-generated document IDs (e.g. `'usr'`, `'cob'`, `'sub'`).
+     * When using the default prefixed ID generator, IDs will follow the format `${idPrefix}_${random}`.
+     */
+    idPrefix?: string;
+    /**
+     * Strategy for generating document IDs when not explicitly provided.
+     * - `'prefixed-nanoid'`: Stripe-style prefixed NanoID (default), e.g. `cob_8xK2p9LmQwRt9a`
+     * - `'nanoid'`: Compact URL-friendly random ID, e.g. `V1StGXR8_Z5jdHi6B-myT`
+     * - `'ulid'`: 26-character Crockford Base32 time-sortable ID, e.g. `01J8K3R4Q7V9N2M1P6W0XYZA3C`
+     * - `'uuid'`: 36-character RFC 4122 UUIDv4, e.g. `f47ac10b-58cc-4372-a567-0e02b2c3d479`
+     *
+     * Defaults to `'prefixed-nanoid'`.
+     */
+    idType?: IdStrategy;
+    /**
+     * Custom function to generate document IDs. Overrides `idType` and `idPrefix`.
+     */
+    idGenerator?: (slug: string) => string;
     /**
      * If `true`, Dyrected automatically adds the built-in system fields
      * `createdAt`, `updatedAt`, `createdBy`, and `updatedBy` to every document.
@@ -2424,21 +2473,26 @@ interface DatabaseAdapter {
          * ignore it; SQL adapters use it to sort numeric fields by magnitude.
          */
         fields?: Field[];
+        /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
+        lock?: "for-update";
     }): Promise<PaginatedResult>;
     /** Find a single document by its ID. Returns `null` if not found. */
     findOne(args: {
         collection: string;
         id: string;
+        /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
+        lock?: "for-update";
     }): Promise<BaseDocument | null>;
     /** Insert a new document and return it with its generated `id`. */
     create(args: {
         collection: string;
         data: Record<string, unknown>;
     }): Promise<BaseDocument>;
-    /** Update a document by ID and return the updated document. */
+    /** Update a document by ID or conditional filter and return the updated document. */
     update(args: {
         collection: string;
-        id: string;
+        id?: string;
+        where?: Record<string, unknown>;
         data: Record<string, unknown>;
     }): Promise<BaseDocument>;
     /** Delete a document by ID. Return value is intentionally untyped — callers do not use it. */
@@ -3900,4 +3954,4 @@ interface DyrectedContext {
  */
 declare function createDyrectedApp(rawConfig: DyrectedConfig | any): Promise<Hono<DyrectedContext, hono_types.BlankSchema, "/">>;
 
-export { type JoinField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTabs as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTextOptions as I, type DetailText as J, type DetailSchema as K, type LifecycleEventName as L, type DyrectedContext as M, type AIConfig as N, type AIPIIConfig as O, type PublicAdminAuthConfig as P, type ArrayField as Q, type FieldType as R, type BooleanField as S, type AuthConfig as T, type AccessPolicyResolver as U, type DateField as V, type WorkflowConfig as W, type DateTimeField as X, type EmailField as Y, type IconField as Z, type ImageField as _, type DeclarativeHookExpression as a, type BooleanFieldAdmin as a$, type JsonField as a0, type MultiSelectField as a1, type NumberField as a2, type ObjectField as a3, type RadioField as a4, type RelationshipField as a5, type RichTextField as a6, type RowField as a7, type SelectField as a8, type TextField as a9, type ActionConfig as aA, type ActionConfigBase as aB, type ActionConfigWithHandler as aC, type ActionConfigWithMutation 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 AggregateCollectionResult as aT, type AggregateInput as aU, type AggregateOperation as aV, type AggregateResult as aW, type BaseAdminAuthProvider as aX, type BaseFieldAdmin as aY, type BlockVariant as aZ, type BlocksField as a_, type TextareaField as aa, type TimeField as ab, type UrlField as ac, type AIAction as ad, type AIActionStatus as ae, type AIActionType as af, type AIAuditActionType as ag, type AIAuditRecord as ah, type AIChunk as ai, type AIMessage as aj, type AIPIIPattern as ak, type AIRateLimitResult as al, type AIRateLimitStore as am, type AIThread as an, type AIToolContext as ao, type AIToolDefinition as ap, AI_ACTIONS_COLLECTION as aq, AI_AUDIT_COLLECTION as ar, AI_CHUNKS_COLLECTION as as, AI_MESSAGES_COLLECTION as at, AI_THREADS_COLLECTION as au, type AccessConfig as av, type AccessFunction as aw, type AccessFunctionArgs as ax, type AccessResult as ay, type AccessRule as az, type AuthenticatedUser as b, type GlobalAfterReadHookEntry as b$, type BooleanFormat as b0, type CharacterLimitFieldAdmin as b1, type CharacterLimitFieldConfig as b2, type CollectionAfterChangeHook as b3, type CollectionAfterDeleteHook as b4, type CollectionAfterReadHook as b5, type CollectionAfterReadHookEntry as b6, type CollectionAfterTransitionHook as b7, type CollectionBeforeChangeHook as b8, type CollectionBeforeChangeHookEntry as b9, type DistinctCountOperation as bA, type DistinctValuesOperation as bB, type DynamicOptionItem as bC, type DynamicOptionsConfig as bD, type DynamicOptionsResolver as bE, type DynamicOptionsResolverArgs as bF, type DyrectedAIContext as bG, type DyrectedLoggerConfig as bH, type DyrectedObservabilityConfig as bI, type EmailFieldAdmin as bJ, type FieldAdminHooks as bK, type FieldAdminOnChangeHook as bL, type FieldAdminOnChangeHookArgs as bM, type FieldAdminOptionsHook as bN, type FieldAdminOptionsHookArgs as bO, type FieldAdminOptionsHookResult as bP, type FieldAfterReadHook as bQ, type FieldAfterReadHookArgs as bR, type FieldBase as bS, type FieldBeforeChangeHook as bT, type FieldBeforeChangeHookArgs as bU, type FieldHook as bV, type FieldHooks as bW, type FileData as bX, type GetDocumentResult as bY, type GlobalAfterChangeHook as bZ, type GlobalAfterReadHook as b_, type CollectionBeforeDeleteHook as ba, type CollectionBeforeReadHook as bb, type CollectionBeforeReadHookEntry as bc, type CollectionBeforeTransitionHook as bd, type CollectionListComponentSlots as be, type CollectionRAGConfig as bf, type CollectionSchemaResult as bg, type CollectionSummaryResult as bh, type CollectionViewComponentSlots as bi, type CountOperation as bj, type CustomAdminAuthProvider as bk, type DatabaseAdapter as bl, type DateFieldAdmin as bm, type DateFormat as bn, type DefaultValueContext as bo, type DefineActionOptions as bp, type DefineCalendarViewOptions as bq, type DefineCardsViewOptions as br, type DefineGanttViewOptions as bs, type DefineKanbanViewOptions as bt, type DefineTableViewOptions as bu, type DefineViewBaseOptions as bv, type DefineViewOptions as bw, type DetailSpan as bx, type DisplayTone as by, type DisplayVariant as bz, type WorkflowTransition as c, type WorkflowTransitionContext as c$, type GlobalBeforeChangeHook as c0, type GlobalBeforeChangeHookEntry as c1, type GlobalBeforeReadHook as c2, type GlobalBeforeReadHookEntry as c3, type GlobalRAGConfig as c4, type GlobalSchemaResult as c5, type GlobalSummaryResult as c6, type HeadingLevel as c7, type HookFunction as c8, type IconFieldAdmin as c9, type RichTextFeature as cA, type RichTextFieldConfig as cB, type SelectFieldAdmin as cC, type SqlWhereResult as cD, type StorageAdapter as cE, type TextFieldAdmin as cF, type TextFormat as cG, type TextareaFieldAdmin as cH, type TrustProxyConfig as cI, type TypedField as cJ, type UploadConfig as cK, type UrlFieldAdmin as cL, type UrlLinkValue as cM, type ViewActionFeatures as cN, type ViewComponentSlots as cO, type ViewConfig as cP, type ViewLayout as cQ, type ViewMetric as cR, type ViewSubMetric as cS, type WhereClause as cT, type WhereOperator as cU, type WhereOperatorName as cV, type WordLimitFieldAdmin as cW, type WordLimitFieldConfig as cX, type WorkflowMetadata as cY, type WorkflowRole as cZ, type WorkflowState as c_, type ImageService as ca, type ImageTransformOptions as cb, type InferAggregateResult as cc, type JoinFieldAdmin as cd, type JsonFieldAdmin as ce, type JsonFormat as cf, LIFECYCLE_EVENT_NAMES as cg, type LifecycleEventHandler as ch, type LinkFormat as ci, type MetricColor as cj, type MultiSelectFieldAdmin as ck, type NamedAccessPolicy as cl, type NumberFieldAdmin as cm, type NumberFormat as cn, type NumberLimitFieldAdmin as co, type NumberLimitFieldConfig as cp, type NumericOperation as cq, type OIDCAdminAuthProvider as cr, type OptionFormat as cs, type PaginatedResult as ct, type PublicAdminAuthProvider as cu, type QueryCollectionResult as cv, type RAGSearchResult as cw, type RadioFieldAdmin as cx, type RateLimitConfig as cy, type ReadonlyDatabaseAdapter as cz, type LifecycleEvent as d, defineAction as d0, defineCalendarView as d1, defineCardsView as d2, defineGanttView as d3, defineKanbanView as d4, defineTableView as d5, defineView as d6, isAICollection as d7, parseMongoWhere as d8, parseSqlWhere as d9, verifyCollectionToken as dA, type CollectionTokenPayload as da, DEFAULT_SESSION_EXPIRY as db, type DyrectedObservabilityRuntime as dc, type RequestBodyCapture as dd, type RequestTraceContext as de, type ResolvedObservabilityConfig as df, attachRequestMetrics as dg, bindObservabilityRuntime as dh, buildRequestLogger as di, captureRequestBody as dj, createDyrectedApp as dk, createObservabilityRuntime as dl, createRequestSpan as dm, decodeCollectionToken as dn, endRequestSpan as dp, getConfigLogger as dq, getObservabilityRuntime as dr, getRequestLogger as ds, redactBody as dt, redactHeaders as du, renderPrometheusMetrics as dv, resolveObservabilityConfig as dw, resolveSessionTokenExpiry as dx, shouldSampleRequest as dy, signCollectionToken as dz, type BaseDocument as e, type DetailActionOptions as f, type DetailAction as g, type DetailComputedOptions as h, type ComputedHandler as i, type DetailComputed as j, type DetailCustomOptions as k, type DetailCustom as l, type DetailDividerOptions as m, type DetailDivider as n, type DisplayFieldOptions as o, type DetailField as p, type DetailItem as q, type DetailGridOptions as r, type DetailGrid as s, type DetailRepeatOptions as t, type DetailRepeat as u, type DetailSectionOptions as v, type DetailSection as w, type DetailTabOptions as x, type DetailTab as y, type DetailTabsOptions as z };
+export { type ImageField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTabs as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTextOptions as I, type DetailText as J, type DetailSchema as K, type LifecycleEventName as L, type DyrectedContext as M, type AIConfig as N, type AIPIIConfig as O, type PublicAdminAuthConfig as P, type IdStrategy as Q, type ArrayField as R, type FieldType as S, type BooleanField as T, type AuthConfig as U, type AccessPolicyResolver as V, type WorkflowConfig as W, type DateField as X, type DateTimeField as Y, type EmailField as Z, type IconField as _, type DeclarativeHookExpression as a, type BlocksField as a$, type JoinField as a0, type JsonField as a1, type MultiSelectField as a2, type NumberField as a3, type ObjectField as a4, type RadioField as a5, type RelationshipField as a6, type RichTextField as a7, type RowField as a8, type SelectField as a9, type AccessRule as aA, type ActionConfig as aB, type ActionConfigBase as aC, type ActionConfigWithHandler as aD, type ActionConfigWithMutation as aE, type ActionContext as aF, type ActionType as aG, type AdminAuthAccessResolution as aH, type AdminAuthClaimMapping as aI, type AdminAuthMember as aJ, type AdminAuthProvider as aK, type AdminAuthProviderMembersConfig as aL, type AdminAuthProvisioningMode as aM, type AdminAuthResolveAccessArgs as aN, type AdminAuthResolvedIdentity as aO, type AdminConfig as aP, type AdminDashboardComponentSlots as aQ, type AdminIconName as aR, type AggregateArgs as aS, type AggregateCastType as aT, type AggregateCollectionResult as aU, type AggregateInput as aV, type AggregateOperation as aW, type AggregateResult as aX, type BaseAdminAuthProvider as aY, type BaseFieldAdmin as aZ, type BlockVariant as a_, type TextField as aa, type TextareaField as ab, type TimeField as ac, type UrlField as ad, type AIAction as ae, type AIActionStatus as af, type AIActionType as ag, type AIAuditActionType as ah, type AIAuditRecord as ai, type AIChunk as aj, type AIMessage as ak, type AIPIIPattern as al, type AIRateLimitResult as am, type AIRateLimitStore as an, type AIThread as ao, type AIToolContext as ap, type AIToolDefinition as aq, AI_ACTIONS_COLLECTION as ar, AI_AUDIT_COLLECTION as as, AI_CHUNKS_COLLECTION as at, AI_MESSAGES_COLLECTION as au, AI_THREADS_COLLECTION as av, type AccessConfig as aw, type AccessFunction as ax, type AccessFunctionArgs as ay, type AccessResult as az, type AuthenticatedUser as b, type GlobalAfterChangeHook as b$, type BooleanFieldAdmin as b0, type BooleanFormat as b1, type CharacterLimitFieldAdmin as b2, type CharacterLimitFieldConfig as b3, type CollectionAfterChangeHook as b4, type CollectionAfterDeleteHook as b5, type CollectionAfterReadHook as b6, type CollectionAfterReadHookEntry as b7, type CollectionAfterTransitionHook as b8, type CollectionBeforeChangeHook as b9, type DisplayTone as bA, type DisplayVariant as bB, type DistinctCountOperation as bC, type DistinctValuesOperation as bD, type DynamicOptionItem as bE, type DynamicOptionsConfig as bF, type DynamicOptionsResolver as bG, type DynamicOptionsResolverArgs as bH, type DyrectedAIContext as bI, type DyrectedLoggerConfig as bJ, type DyrectedObservabilityConfig as bK, type EmailFieldAdmin as bL, type FieldAdminHooks as bM, type FieldAdminOnChangeHook as bN, type FieldAdminOnChangeHookArgs as bO, type FieldAdminOptionsHook as bP, type FieldAdminOptionsHookArgs as bQ, type FieldAdminOptionsHookResult as bR, type FieldAfterReadHook as bS, type FieldAfterReadHookArgs as bT, type FieldBase as bU, type FieldBeforeChangeHook as bV, type FieldBeforeChangeHookArgs as bW, type FieldHook as bX, type FieldHooks as bY, type FileData as bZ, type GetDocumentResult as b_, type CollectionBeforeChangeHookEntry as ba, type CollectionBeforeDeleteHook as bb, type CollectionBeforeReadHook as bc, type CollectionBeforeReadHookEntry as bd, type CollectionBeforeTransitionHook as be, type CollectionIndex as bf, type CollectionListComponentSlots as bg, type CollectionRAGConfig as bh, type CollectionSchemaResult as bi, type CollectionSummaryResult as bj, type CollectionViewComponentSlots as bk, type CountOperation as bl, type CustomAdminAuthProvider as bm, type DatabaseAdapter as bn, type DateFieldAdmin as bo, type DateFormat as bp, type DefaultValueContext as bq, type DefineActionOptions as br, type DefineCalendarViewOptions as bs, type DefineCardsViewOptions as bt, type DefineGanttViewOptions as bu, type DefineKanbanViewOptions as bv, type DefineTableViewOptions as bw, type DefineViewBaseOptions as bx, type DefineViewOptions as by, type DetailSpan as bz, type WorkflowTransition as c, type WorkflowMetadata as c$, type GlobalAfterReadHook as c0, type GlobalAfterReadHookEntry as c1, type GlobalBeforeChangeHook as c2, type GlobalBeforeChangeHookEntry as c3, type GlobalBeforeReadHook as c4, type GlobalBeforeReadHookEntry as c5, type GlobalRAGConfig as c6, type GlobalSchemaResult as c7, type GlobalSummaryResult as c8, type HeadingLevel as c9, type RadioFieldAdmin as cA, type RateLimitConfig as cB, type ReadonlyDatabaseAdapter as cC, type RichTextFeature as cD, type RichTextFieldConfig as cE, type SelectFieldAdmin as cF, type SqlWhereResult as cG, type StorageAdapter as cH, type TextFieldAdmin as cI, type TextFormat as cJ, type TextareaFieldAdmin as cK, type TrustProxyConfig as cL, type TypedField as cM, type UploadConfig as cN, type UrlFieldAdmin as cO, type UrlLinkValue as cP, type ViewActionFeatures as cQ, type ViewComponentSlots as cR, type ViewConfig as cS, type ViewLayout as cT, type ViewMetric as cU, type ViewSubMetric as cV, type WhereClause as cW, type WhereOperator as cX, type WhereOperatorName as cY, type WordLimitFieldAdmin as cZ, type WordLimitFieldConfig as c_, type HookFunction as ca, type IconFieldAdmin as cb, type ImageService as cc, type ImageTransformOptions as cd, type InferAggregateResult as ce, type JoinFieldAdmin as cf, type JsonFieldAdmin as cg, type JsonFormat as ch, LIFECYCLE_EVENT_NAMES as ci, type LifecycleEventHandler as cj, type LinkFormat as ck, type MetricColor as cl, type MultiSelectFieldAdmin as cm, type NamedAccessPolicy as cn, type NumberFieldAdmin as co, type NumberFormat as cp, type NumberLimitFieldAdmin as cq, type NumberLimitFieldConfig as cr, type NumericOperation as cs, type NumericUpdateOperator as ct, type OIDCAdminAuthProvider as cu, type OptionFormat as cv, type PaginatedResult as cw, type PublicAdminAuthProvider as cx, type QueryCollectionResult as cy, type RAGSearchResult as cz, type LifecycleEvent as d, type WorkflowRole as d0, type WorkflowState as d1, type WorkflowTransitionContext as d2, defineAction as d3, defineCalendarView as d4, defineCardsView as d5, defineGanttView as d6, defineKanbanView as d7, defineTableView as d8, defineView as d9, resolveSessionTokenExpiry as dA, shouldSampleRequest as dB, signCollectionToken as dC, verifyCollectionToken as dD, isAICollection as da, parseMongoWhere as db, parseSqlWhere as dc, type CollectionTokenPayload as dd, DEFAULT_SESSION_EXPIRY as de, type DyrectedObservabilityRuntime as df, type RequestBodyCapture as dg, type RequestTraceContext as dh, type ResolvedObservabilityConfig as di, attachRequestMetrics as dj, bindObservabilityRuntime as dk, buildRequestLogger as dl, captureRequestBody as dm, createDyrectedApp as dn, createObservabilityRuntime as dp, createRequestSpan as dq, decodeCollectionToken as dr, endRequestSpan as ds, getConfigLogger as dt, getObservabilityRuntime as du, getRequestLogger as dv, redactBody as dw, redactHeaders as dx, renderPrometheusMetrics as dy, resolveObservabilityConfig as dz, type BaseDocument as e, type DetailActionOptions as f, type DetailAction as g, type DetailComputedOptions as h, type ComputedHandler as i, type DetailComputed as j, type DetailCustomOptions as k, type DetailCustom as l, type DetailDividerOptions as m, type DetailDivider as n, type DisplayFieldOptions as o, type DetailField as p, type DetailItem as q, type DetailGridOptions as r, type DetailGrid as s, type DetailRepeatOptions as t, type DetailRepeat as u, type DetailSectionOptions as v, type DetailSection as w, type DetailTabOptions as x, type DetailTab as y, type DetailTabsOptions as z };

package/dist/{app-Cmp5lFLJ.d.ts → app-KSDgfXsw.d.ts}

@@ -1584,9 +1584,9 @@ type ActionConfig<TDoc extends Record<string, unknown> = Record<string, unknown>
  * Context passed to an action's server handler function.
  */
 interface ActionContext<TDoc extends Record<string, unknown> = Record<string, unknown>> {
-    /** The target document (for row actions). */
-    doc: TDoc;
-    /** All targeted documents (for bulk actions). */
+    /** The target document (for row actions), or null for header actions. */
+    doc: TDoc | null;
+    /** All targeted documents (for bulk actions). Empty array for header actions. */
     docs: TDoc[];
     /** The authenticated acting user, if available. */
     user: Record<string, unknown> | null;
@@ -1835,6 +1835,30 @@ interface AuthConfig {
      */
     adminRole?: string;
 }
+/**
+ * Physical database index specification for a collection.
+ */
+interface CollectionIndex {
+    /** Optional custom index name. If omitted, adapter auto-generates one. */
+    name?: string;
+    /** Field names participating in the index. */
+    fields: string[];
+    /** Whether the index enforces database-level uniqueness. Defaults to false. */
+    unique?: boolean;
+    /** Whether to only index non-null rows where supported. */
+    sparse?: boolean;
+}
+/**
+ * Atomic numeric update operators for database mutation payloads.
+ */
+interface NumericUpdateOperator {
+    increment?: number;
+    decrement?: number;
+}
+/**
+ * Strategy for generating document IDs.
+ */
+type IdStrategy = "prefixed-nanoid" | "nanoid" | "ulid" | "uuid";
 /**
  * Use this contract when you want the exact shape of a collection config.
  *
@@ -1960,6 +1984,31 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
      * @see {@link https://dyrected.com/docs/model-content/fields/blocks Blocks and page sections}
      */
     fields: Field[];
+    /**
+     * Database indexes to create on this collection.
+     *
+     * Fields participating in indexes are automatically promoted to physical columns.
+     */
+    indexes?: CollectionIndex[];
+    /**
+     * Optional custom prefix for auto-generated document IDs (e.g. `'usr'`, `'cob'`, `'sub'`).
+     * When using the default prefixed ID generator, IDs will follow the format `${idPrefix}_${random}`.
+     */
+    idPrefix?: string;
+    /**
+     * Strategy for generating document IDs when not explicitly provided.
+     * - `'prefixed-nanoid'`: Stripe-style prefixed NanoID (default), e.g. `cob_8xK2p9LmQwRt9a`
+     * - `'nanoid'`: Compact URL-friendly random ID, e.g. `V1StGXR8_Z5jdHi6B-myT`
+     * - `'ulid'`: 26-character Crockford Base32 time-sortable ID, e.g. `01J8K3R4Q7V9N2M1P6W0XYZA3C`
+     * - `'uuid'`: 36-character RFC 4122 UUIDv4, e.g. `f47ac10b-58cc-4372-a567-0e02b2c3d479`
+     *
+     * Defaults to `'prefixed-nanoid'`.
+     */
+    idType?: IdStrategy;
+    /**
+     * Custom function to generate document IDs. Overrides `idType` and `idPrefix`.
+     */
+    idGenerator?: (slug: string) => string;
     /**
      * If `true`, Dyrected automatically adds the built-in system fields
      * `createdAt`, `updatedAt`, `createdBy`, and `updatedBy` to every document.
@@ -2424,21 +2473,26 @@ interface DatabaseAdapter {
          * ignore it; SQL adapters use it to sort numeric fields by magnitude.
          */
         fields?: Field[];
+        /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
+        lock?: "for-update";
     }): Promise<PaginatedResult>;
     /** Find a single document by its ID. Returns `null` if not found. */
     findOne(args: {
         collection: string;
         id: string;
+        /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
+        lock?: "for-update";
     }): Promise<BaseDocument | null>;
     /** Insert a new document and return it with its generated `id`. */
     create(args: {
         collection: string;
         data: Record<string, unknown>;
     }): Promise<BaseDocument>;
-    /** Update a document by ID and return the updated document. */
+    /** Update a document by ID or conditional filter and return the updated document. */
     update(args: {
         collection: string;
-        id: string;
+        id?: string;
+        where?: Record<string, unknown>;
         data: Record<string, unknown>;
     }): Promise<BaseDocument>;
     /** Delete a document by ID. Return value is intentionally untyped — callers do not use it. */
@@ -3900,4 +3954,4 @@ interface DyrectedContext {
  */
 declare function createDyrectedApp(rawConfig: DyrectedConfig | any): Promise<Hono<DyrectedContext, hono_types.BlankSchema, "/">>;
 
-export { type JoinField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTabs as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTextOptions as I, type DetailText as J, type DetailSchema as K, type LifecycleEventName as L, type DyrectedContext as M, type AIConfig as N, type AIPIIConfig as O, type PublicAdminAuthConfig as P, type ArrayField as Q, type FieldType as R, type BooleanField as S, type AuthConfig as T, type AccessPolicyResolver as U, type DateField as V, type WorkflowConfig as W, type DateTimeField as X, type EmailField as Y, type IconField as Z, type ImageField as _, type DeclarativeHookExpression as a, type BooleanFieldAdmin as a$, type JsonField as a0, type MultiSelectField as a1, type NumberField as a2, type ObjectField as a3, type RadioField as a4, type RelationshipField as a5, type RichTextField as a6, type RowField as a7, type SelectField as a8, type TextField as a9, type ActionConfig as aA, type ActionConfigBase as aB, type ActionConfigWithHandler as aC, type ActionConfigWithMutation 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 AggregateCollectionResult as aT, type AggregateInput as aU, type AggregateOperation as aV, type AggregateResult as aW, type BaseAdminAuthProvider as aX, type BaseFieldAdmin as aY, type BlockVariant as aZ, type BlocksField as a_, type TextareaField as aa, type TimeField as ab, type UrlField as ac, type AIAction as ad, type AIActionStatus as ae, type AIActionType as af, type AIAuditActionType as ag, type AIAuditRecord as ah, type AIChunk as ai, type AIMessage as aj, type AIPIIPattern as ak, type AIRateLimitResult as al, type AIRateLimitStore as am, type AIThread as an, type AIToolContext as ao, type AIToolDefinition as ap, AI_ACTIONS_COLLECTION as aq, AI_AUDIT_COLLECTION as ar, AI_CHUNKS_COLLECTION as as, AI_MESSAGES_COLLECTION as at, AI_THREADS_COLLECTION as au, type AccessConfig as av, type AccessFunction as aw, type AccessFunctionArgs as ax, type AccessResult as ay, type AccessRule as az, type AuthenticatedUser as b, type GlobalAfterReadHookEntry as b$, type BooleanFormat as b0, type CharacterLimitFieldAdmin as b1, type CharacterLimitFieldConfig as b2, type CollectionAfterChangeHook as b3, type CollectionAfterDeleteHook as b4, type CollectionAfterReadHook as b5, type CollectionAfterReadHookEntry as b6, type CollectionAfterTransitionHook as b7, type CollectionBeforeChangeHook as b8, type CollectionBeforeChangeHookEntry as b9, type DistinctCountOperation as bA, type DistinctValuesOperation as bB, type DynamicOptionItem as bC, type DynamicOptionsConfig as bD, type DynamicOptionsResolver as bE, type DynamicOptionsResolverArgs as bF, type DyrectedAIContext as bG, type DyrectedLoggerConfig as bH, type DyrectedObservabilityConfig as bI, type EmailFieldAdmin as bJ, type FieldAdminHooks as bK, type FieldAdminOnChangeHook as bL, type FieldAdminOnChangeHookArgs as bM, type FieldAdminOptionsHook as bN, type FieldAdminOptionsHookArgs as bO, type FieldAdminOptionsHookResult as bP, type FieldAfterReadHook as bQ, type FieldAfterReadHookArgs as bR, type FieldBase as bS, type FieldBeforeChangeHook as bT, type FieldBeforeChangeHookArgs as bU, type FieldHook as bV, type FieldHooks as bW, type FileData as bX, type GetDocumentResult as bY, type GlobalAfterChangeHook as bZ, type GlobalAfterReadHook as b_, type CollectionBeforeDeleteHook as ba, type CollectionBeforeReadHook as bb, type CollectionBeforeReadHookEntry as bc, type CollectionBeforeTransitionHook as bd, type CollectionListComponentSlots as be, type CollectionRAGConfig as bf, type CollectionSchemaResult as bg, type CollectionSummaryResult as bh, type CollectionViewComponentSlots as bi, type CountOperation as bj, type CustomAdminAuthProvider as bk, type DatabaseAdapter as bl, type DateFieldAdmin as bm, type DateFormat as bn, type DefaultValueContext as bo, type DefineActionOptions as bp, type DefineCalendarViewOptions as bq, type DefineCardsViewOptions as br, type DefineGanttViewOptions as bs, type DefineKanbanViewOptions as bt, type DefineTableViewOptions as bu, type DefineViewBaseOptions as bv, type DefineViewOptions as bw, type DetailSpan as bx, type DisplayTone as by, type DisplayVariant as bz, type WorkflowTransition as c, type WorkflowTransitionContext as c$, type GlobalBeforeChangeHook as c0, type GlobalBeforeChangeHookEntry as c1, type GlobalBeforeReadHook as c2, type GlobalBeforeReadHookEntry as c3, type GlobalRAGConfig as c4, type GlobalSchemaResult as c5, type GlobalSummaryResult as c6, type HeadingLevel as c7, type HookFunction as c8, type IconFieldAdmin as c9, type RichTextFeature as cA, type RichTextFieldConfig as cB, type SelectFieldAdmin as cC, type SqlWhereResult as cD, type StorageAdapter as cE, type TextFieldAdmin as cF, type TextFormat as cG, type TextareaFieldAdmin as cH, type TrustProxyConfig as cI, type TypedField as cJ, type UploadConfig as cK, type UrlFieldAdmin as cL, type UrlLinkValue as cM, type ViewActionFeatures as cN, type ViewComponentSlots as cO, type ViewConfig as cP, type ViewLayout as cQ, type ViewMetric as cR, type ViewSubMetric as cS, type WhereClause as cT, type WhereOperator as cU, type WhereOperatorName as cV, type WordLimitFieldAdmin as cW, type WordLimitFieldConfig as cX, type WorkflowMetadata as cY, type WorkflowRole as cZ, type WorkflowState as c_, type ImageService as ca, type ImageTransformOptions as cb, type InferAggregateResult as cc, type JoinFieldAdmin as cd, type JsonFieldAdmin as ce, type JsonFormat as cf, LIFECYCLE_EVENT_NAMES as cg, type LifecycleEventHandler as ch, type LinkFormat as ci, type MetricColor as cj, type MultiSelectFieldAdmin as ck, type NamedAccessPolicy as cl, type NumberFieldAdmin as cm, type NumberFormat as cn, type NumberLimitFieldAdmin as co, type NumberLimitFieldConfig as cp, type NumericOperation as cq, type OIDCAdminAuthProvider as cr, type OptionFormat as cs, type PaginatedResult as ct, type PublicAdminAuthProvider as cu, type QueryCollectionResult as cv, type RAGSearchResult as cw, type RadioFieldAdmin as cx, type RateLimitConfig as cy, type ReadonlyDatabaseAdapter as cz, type LifecycleEvent as d, defineAction as d0, defineCalendarView as d1, defineCardsView as d2, defineGanttView as d3, defineKanbanView as d4, defineTableView as d5, defineView as d6, isAICollection as d7, parseMongoWhere as d8, parseSqlWhere as d9, verifyCollectionToken as dA, type CollectionTokenPayload as da, DEFAULT_SESSION_EXPIRY as db, type DyrectedObservabilityRuntime as dc, type RequestBodyCapture as dd, type RequestTraceContext as de, type ResolvedObservabilityConfig as df, attachRequestMetrics as dg, bindObservabilityRuntime as dh, buildRequestLogger as di, captureRequestBody as dj, createDyrectedApp as dk, createObservabilityRuntime as dl, createRequestSpan as dm, decodeCollectionToken as dn, endRequestSpan as dp, getConfigLogger as dq, getObservabilityRuntime as dr, getRequestLogger as ds, redactBody as dt, redactHeaders as du, renderPrometheusMetrics as dv, resolveObservabilityConfig as dw, resolveSessionTokenExpiry as dx, shouldSampleRequest as dy, signCollectionToken as dz, type BaseDocument as e, type DetailActionOptions as f, type DetailAction as g, type DetailComputedOptions as h, type ComputedHandler as i, type DetailComputed as j, type DetailCustomOptions as k, type DetailCustom as l, type DetailDividerOptions as m, type DetailDivider as n, type DisplayFieldOptions as o, type DetailField as p, type DetailItem as q, type DetailGridOptions as r, type DetailGrid as s, type DetailRepeatOptions as t, type DetailRepeat as u, type DetailSectionOptions as v, type DetailSection as w, type DetailTabOptions as x, type DetailTab as y, type DetailTabsOptions as z };
+export { type ImageField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTabs as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTextOptions as I, type DetailText as J, type DetailSchema as K, type LifecycleEventName as L, type DyrectedContext as M, type AIConfig as N, type AIPIIConfig as O, type PublicAdminAuthConfig as P, type IdStrategy as Q, type ArrayField as R, type FieldType as S, type BooleanField as T, type AuthConfig as U, type AccessPolicyResolver as V, type WorkflowConfig as W, type DateField as X, type DateTimeField as Y, type EmailField as Z, type IconField as _, type DeclarativeHookExpression as a, type BlocksField as a$, type JoinField as a0, type JsonField as a1, type MultiSelectField as a2, type NumberField as a3, type ObjectField as a4, type RadioField as a5, type RelationshipField as a6, type RichTextField as a7, type RowField as a8, type SelectField as a9, type AccessRule as aA, type ActionConfig as aB, type ActionConfigBase as aC, type ActionConfigWithHandler as aD, type ActionConfigWithMutation as aE, type ActionContext as aF, type ActionType as aG, type AdminAuthAccessResolution as aH, type AdminAuthClaimMapping as aI, type AdminAuthMember as aJ, type AdminAuthProvider as aK, type AdminAuthProviderMembersConfig as aL, type AdminAuthProvisioningMode as aM, type AdminAuthResolveAccessArgs as aN, type AdminAuthResolvedIdentity as aO, type AdminConfig as aP, type AdminDashboardComponentSlots as aQ, type AdminIconName as aR, type AggregateArgs as aS, type AggregateCastType as aT, type AggregateCollectionResult as aU, type AggregateInput as aV, type AggregateOperation as aW, type AggregateResult as aX, type BaseAdminAuthProvider as aY, type BaseFieldAdmin as aZ, type BlockVariant as a_, type TextField as aa, type TextareaField as ab, type TimeField as ac, type UrlField as ad, type AIAction as ae, type AIActionStatus as af, type AIActionType as ag, type AIAuditActionType as ah, type AIAuditRecord as ai, type AIChunk as aj, type AIMessage as ak, type AIPIIPattern as al, type AIRateLimitResult as am, type AIRateLimitStore as an, type AIThread as ao, type AIToolContext as ap, type AIToolDefinition as aq, AI_ACTIONS_COLLECTION as ar, AI_AUDIT_COLLECTION as as, AI_CHUNKS_COLLECTION as at, AI_MESSAGES_COLLECTION as au, AI_THREADS_COLLECTION as av, type AccessConfig as aw, type AccessFunction as ax, type AccessFunctionArgs as ay, type AccessResult as az, type AuthenticatedUser as b, type GlobalAfterChangeHook as b$, type BooleanFieldAdmin as b0, type BooleanFormat as b1, type CharacterLimitFieldAdmin as b2, type CharacterLimitFieldConfig as b3, type CollectionAfterChangeHook as b4, type CollectionAfterDeleteHook as b5, type CollectionAfterReadHook as b6, type CollectionAfterReadHookEntry as b7, type CollectionAfterTransitionHook as b8, type CollectionBeforeChangeHook as b9, type DisplayTone as bA, type DisplayVariant as bB, type DistinctCountOperation as bC, type DistinctValuesOperation as bD, type DynamicOptionItem as bE, type DynamicOptionsConfig as bF, type DynamicOptionsResolver as bG, type DynamicOptionsResolverArgs as bH, type DyrectedAIContext as bI, type DyrectedLoggerConfig as bJ, type DyrectedObservabilityConfig as bK, type EmailFieldAdmin as bL, type FieldAdminHooks as bM, type FieldAdminOnChangeHook as bN, type FieldAdminOnChangeHookArgs as bO, type FieldAdminOptionsHook as bP, type FieldAdminOptionsHookArgs as bQ, type FieldAdminOptionsHookResult as bR, type FieldAfterReadHook as bS, type FieldAfterReadHookArgs as bT, type FieldBase as bU, type FieldBeforeChangeHook as bV, type FieldBeforeChangeHookArgs as bW, type FieldHook as bX, type FieldHooks as bY, type FileData as bZ, type GetDocumentResult as b_, type CollectionBeforeChangeHookEntry as ba, type CollectionBeforeDeleteHook as bb, type CollectionBeforeReadHook as bc, type CollectionBeforeReadHookEntry as bd, type CollectionBeforeTransitionHook as be, type CollectionIndex as bf, type CollectionListComponentSlots as bg, type CollectionRAGConfig as bh, type CollectionSchemaResult as bi, type CollectionSummaryResult as bj, type CollectionViewComponentSlots as bk, type CountOperation as bl, type CustomAdminAuthProvider as bm, type DatabaseAdapter as bn, type DateFieldAdmin as bo, type DateFormat as bp, type DefaultValueContext as bq, type DefineActionOptions as br, type DefineCalendarViewOptions as bs, type DefineCardsViewOptions as bt, type DefineGanttViewOptions as bu, type DefineKanbanViewOptions as bv, type DefineTableViewOptions as bw, type DefineViewBaseOptions as bx, type DefineViewOptions as by, type DetailSpan as bz, type WorkflowTransition as c, type WorkflowMetadata as c$, type GlobalAfterReadHook as c0, type GlobalAfterReadHookEntry as c1, type GlobalBeforeChangeHook as c2, type GlobalBeforeChangeHookEntry as c3, type GlobalBeforeReadHook as c4, type GlobalBeforeReadHookEntry as c5, type GlobalRAGConfig as c6, type GlobalSchemaResult as c7, type GlobalSummaryResult as c8, type HeadingLevel as c9, type RadioFieldAdmin as cA, type RateLimitConfig as cB, type ReadonlyDatabaseAdapter as cC, type RichTextFeature as cD, type RichTextFieldConfig as cE, type SelectFieldAdmin as cF, type SqlWhereResult as cG, type StorageAdapter as cH, type TextFieldAdmin as cI, type TextFormat as cJ, type TextareaFieldAdmin as cK, type TrustProxyConfig as cL, type TypedField as cM, type UploadConfig as cN, type UrlFieldAdmin as cO, type UrlLinkValue as cP, type ViewActionFeatures as cQ, type ViewComponentSlots as cR, type ViewConfig as cS, type ViewLayout as cT, type ViewMetric as cU, type ViewSubMetric as cV, type WhereClause as cW, type WhereOperator as cX, type WhereOperatorName as cY, type WordLimitFieldAdmin as cZ, type WordLimitFieldConfig as c_, type HookFunction as ca, type IconFieldAdmin as cb, type ImageService as cc, type ImageTransformOptions as cd, type InferAggregateResult as ce, type JoinFieldAdmin as cf, type JsonFieldAdmin as cg, type JsonFormat as ch, LIFECYCLE_EVENT_NAMES as ci, type LifecycleEventHandler as cj, type LinkFormat as ck, type MetricColor as cl, type MultiSelectFieldAdmin as cm, type NamedAccessPolicy as cn, type NumberFieldAdmin as co, type NumberFormat as cp, type NumberLimitFieldAdmin as cq, type NumberLimitFieldConfig as cr, type NumericOperation as cs, type NumericUpdateOperator as ct, type OIDCAdminAuthProvider as cu, type OptionFormat as cv, type PaginatedResult as cw, type PublicAdminAuthProvider as cx, type QueryCollectionResult as cy, type RAGSearchResult as cz, type LifecycleEvent as d, type WorkflowRole as d0, type WorkflowState as d1, type WorkflowTransitionContext as d2, defineAction as d3, defineCalendarView as d4, defineCardsView as d5, defineGanttView as d6, defineKanbanView as d7, defineTableView as d8, defineView as d9, resolveSessionTokenExpiry as dA, shouldSampleRequest as dB, signCollectionToken as dC, verifyCollectionToken as dD, isAICollection as da, parseMongoWhere as db, parseSqlWhere as dc, type CollectionTokenPayload as dd, DEFAULT_SESSION_EXPIRY as de, type DyrectedObservabilityRuntime as df, type RequestBodyCapture as dg, type RequestTraceContext as dh, type ResolvedObservabilityConfig as di, attachRequestMetrics as dj, bindObservabilityRuntime as dk, buildRequestLogger as dl, captureRequestBody as dm, createDyrectedApp as dn, createObservabilityRuntime as dp, createRequestSpan as dq, decodeCollectionToken as dr, endRequestSpan as ds, getConfigLogger as dt, getObservabilityRuntime as du, getRequestLogger as dv, redactBody as dw, redactHeaders as dx, renderPrometheusMetrics as dy, resolveObservabilityConfig as dz, type BaseDocument as e, type DetailActionOptions as f, type DetailAction as g, type DetailComputedOptions as h, type ComputedHandler as i, type DetailComputed as j, type DetailCustomOptions as k, type DetailCustom as l, type DetailDividerOptions as m, type DetailDivider as n, type DisplayFieldOptions as o, type DetailField as p, type DetailItem as q, type DetailGridOptions as r, type DetailGrid as s, type DetailRepeatOptions as t, type DetailRepeat as u, type DetailSectionOptions as v, type DetailSection as w, type DetailTabOptions as x, type DetailTab as y, type DetailTabsOptions as z };

package/dist/index.cjs

@@ -1789,9 +1789,12 @@ __export(index_exports, {
   AI_CHUNKS_COLLECTION: () => AI_CHUNKS_COLLECTION,
   AI_MESSAGES_COLLECTION: () => AI_MESSAGES_COLLECTION,
   AI_THREADS_COLLECTION: () => AI_THREADS_COLLECTION,
+  BASE62_ALPHABET: () => BASE62_ALPHABET,
   BUILTIN_JEXL_HELPERS: () => BUILTIN_JEXL_HELPERS,
+  CROCKFORD_BASE32: () => CROCKFORD_BASE32,
   ConfigValidationError: () => ConfigValidationError,
   ConflictError: () => ConflictError,
+  DuplicateKeyError: () => DuplicateKeyError,
   DyrectedAIError: () => DyrectedAIError,
   DyrectedError: () => DyrectedError,
   FieldConditionBuilder: () => FieldConditionBuilder,
@@ -1799,6 +1802,7 @@ __export(index_exports, {
   LIFECYCLE_EVENTS_COLLECTION: () => LIFECYCLE_EVENTS_COLLECTION,
   LIFECYCLE_EVENT_NAMES: () => LIFECYCLE_EVENT_NAMES,
   MatchBuilder: () => MatchBuilder,
+  NANOID_ALPHABET: () => NANOID_ALPHABET,
   NON_NEGOTIABLE_CREDENTIAL_FIELDS: () => NON_NEGOTIABLE_CREDENTIAL_FIELDS,
   NotFoundError: () => NotFoundError,
   PII_REGEX_PATTERNS: () => PII_REGEX_PATTERNS,
@@ -1894,6 +1898,8 @@ __export(index_exports, {
   formatDate: () => formatDate,
   formatJexlValue: () => formatJexlValue,
   generateDefaultDetailSchema: () => generateDefaultDetailSchema,
+  generateDocumentId: () => generateDocumentId,
+  generateId: () => generateId,
   generateOpenApi: () => generateOpenApi,
   get: () => get,
   getAdminAuthCollection: () => getAdminAuthCollection,
@@ -1920,6 +1926,7 @@ __export(index_exports, {
   materializeWorkflowDocument: () => materializeWorkflowDocument,
   max: () => max,
   min: () => min,
+  nanoid: () => nanoid,
   normalizeConfig: () => normalizeConfig,
   normalizeDetailItem: () => normalizeDetailItem,
   now: () => now,
@@ -1928,6 +1935,7 @@ __export(index_exports, {
   parseSort: () => parseSort,
   parseSqlWhere: () => parseSqlWhere,
   pow: () => pow,
+  prefixedId: () => prefixedId,
   publishedStateName: () => publishedStateName,
   publishingWorkflow: () => publishingWorkflow,
   readingTime: () => readingTime,
@@ -1935,6 +1943,7 @@ __export(index_exports, {
   replace: () => replace,
   resolveAdminAuthCollection: () => resolveAdminAuthCollection,
   resolveAuthorizedSiteId: () => resolveAuthorizedSiteId,
+  resolvePrefix: () => resolvePrefix,
   round: () => round,
   runCollectionHooks: () => runCollectionHooks,
   sanitizeDocForAI: () => sanitizeDocForAI,
@@ -1948,8 +1957,10 @@ __export(index_exports, {
   transitionWorkflow: () => transitionWorkflow,
   trim: () => trim,
   truncate: () => truncate,
+  ulid: () => ulid,
   unique: () => unique,
   upper: () => upper,
+  uuid: () => uuid,
   validateAdminConditionExpression: () => validateAdminConditionExpression,
   validateDeclarativeAccessExpression: () => validateDeclarativeAccessExpression,
   validateDeclarativeHookExpression: () => validateDeclarativeHookExpression,
@@ -3549,6 +3560,134 @@ function assertValidDeclarativeAccessInConfig(config, source = "config") {
   throw new ConfigValidationError(source, diagnostics);
 }
 
+// src/utils/id.ts
+var import_node_crypto = require("crypto");
+var NANOID_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-";
+var BASE62_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+var CROCKFORD_BASE32 = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+var COMMON_SLUG_PREFIXES = {
+  users: "usr",
+  members: "mem",
+  accounts: "acc",
+  applications: "app",
+  customers: "cus",
+  products: "prd",
+  orders: "ord",
+  reports: "rpt",
+  sessions: "ses",
+  transactions: "txn",
+  wallets: "wal",
+  media: "med",
+  files: "fil",
+  posts: "post",
+  pages: "page",
+  tags: "tag",
+  categories: "cat",
+  comments: "com"
+};
+function nanoid(size = 21, alphabet = NANOID_ALPHABET) {
+  const mask = (2 << 31 - Math.clz32(alphabet.length - 1 | 1)) - 1;
+  const step = Math.ceil(1.6 * mask * size / alphabet.length);
+  let id = "";
+  while (true) {
+    const bytes = (0, import_node_crypto.randomBytes)(step);
+    for (let i = 0; i < step; i++) {
+      const byte = bytes[i] & mask;
+      if (alphabet[byte]) {
+        id += alphabet[byte];
+        if (id.length === size) return id;
+      }
+    }
+  }
+}
+function encodeUlidTime(now2, len = 10) {
+  let str = "";
+  let time = Math.floor(now2);
+  for (let i = len - 1; i >= 0; i--) {
+    const mod = time % 32;
+    str = CROCKFORD_BASE32[mod] + str;
+    time = (time - mod) / 32;
+  }
+  return str;
+}
+function encodeUlidRandom(bytes) {
+  let str = "";
+  let bitBuffer = 0;
+  let bitsInBuffer = 0;
+  for (let i = 0; i < bytes.length; i++) {
+    bitBuffer = bitBuffer << 8 | bytes[i];
+    bitsInBuffer += 8;
+    while (bitsInBuffer >= 5) {
+      bitsInBuffer -= 5;
+      const index = bitBuffer >> bitsInBuffer & 31;
+      str += CROCKFORD_BASE32[index];
+    }
+  }
+  return str;
+}
+function ulid(seedTime = Date.now()) {
+  const timePart = encodeUlidTime(seedTime);
+  const randPart = encodeUlidRandom((0, import_node_crypto.randomBytes)(10));
+  return timePart + randPart;
+}
+function uuid() {
+  return (0, import_node_crypto.randomUUID)();
+}
+function resolvePrefix(slug, explicitPrefix) {
+  if (explicitPrefix && typeof explicitPrefix === "string" && explicitPrefix.trim().length > 0) {
+    const cleaned = explicitPrefix.trim().toLowerCase().replace(/[^a-z0-9_]/g, "");
+    if (cleaned.length > 0) return cleaned;
+  }
+  if (!slug || typeof slug !== "string") return "col";
+  const s = slug.trim().toLowerCase();
+  if (COMMON_SLUG_PREFIXES[s]) return COMMON_SLUG_PREFIXES[s];
+  const pieces = s.split(/[-_]/).filter(Boolean);
+  if (pieces.length > 1 && pieces[0].length >= 2) {
+    const first2 = pieces[0].replace(/[^a-z0-9]/g, "");
+    if (first2.length >= 2) return first2.slice(0, 4);
+  }
+  const cleanWord = s.replace(/[^a-z0-9]/g, "");
+  if (cleanWord.length <= 4) return cleanWord || "col";
+  return cleanWord.slice(0, 3) || "col";
+}
+function prefixedId(prefix = "col", size = 16) {
+  const cleanPrefix = (prefix || "col").toLowerCase().replace(/[^a-z0-9_]/g, "") || "col";
+  return `${cleanPrefix}_${nanoid(size, BASE62_ALPHABET)}`;
+}
+function generateId(options) {
+  if (typeof options === "string") {
+    return prefixedId(resolvePrefix(options));
+  }
+  const opts = options || {};
+  const type = opts.type || "prefixed-nanoid";
+  switch (type) {
+    case "uuid":
+      return uuid();
+    case "ulid":
+      return ulid();
+    case "nanoid":
+      return nanoid(opts.size || 21);
+    case "prefixed-nanoid":
+    default:
+      return prefixedId(opts.prefix || "col", opts.size || 16);
+  }
+}
+function generateDocumentId(collectionOrSlug) {
+  if (!collectionOrSlug) {
+    return prefixedId("col");
+  }
+  if (typeof collectionOrSlug === "string") {
+    const prefix2 = resolvePrefix(collectionOrSlug);
+    return prefixedId(prefix2);
+  }
+  if (typeof collectionOrSlug.idGenerator === "function") {
+    return collectionOrSlug.idGenerator(collectionOrSlug.slug);
+  }
+  const type = collectionOrSlug.idType || "prefixed-nanoid";
+  const prefix = resolvePrefix(collectionOrSlug.slug, collectionOrSlug.idPrefix);
+  return generateId({ prefix, type });
+}
+
 // src/utils/config.ts
 var AUDIT_COLLECTION_SLUG = "__audit";
 var SYSTEM_FIELDS = [
@@ -3870,11 +4009,31 @@ function normalizeConfig(config) {
     }
     const updatedFieldNames = new Set(fields.map((f) => f.name));
     const fieldsToInject = SYSTEM_FIELDS.filter((f) => !updatedFieldNames.has(f.name));
+    const indexedFieldNames = /* @__PURE__ */ new Set();
+    if (col.indexes) {
+      for (const idx of col.indexes) {
+        if (Array.isArray(idx.fields)) {
+          for (const f of idx.fields) {
+            indexedFieldNames.add(f);
+          }
+        }
+      }
+    }
+    const allFields = [...fields, ...fieldsToInject].map((field) => {
+      if (field.unique || field.name && indexedFieldNames.has(field.name)) {
+        return { ...field, promoted: true };
+      }
+      return field;
+    });
     const workflow = col.workflow || (col.drafts ? simplePublishingWorkflow() : void 0);
+    const idPrefix = col.idPrefix || resolvePrefix(col.slug);
+    const idType = col.idType || "prefixed-nanoid";
     return {
       ...col,
+      idPrefix,
+      idType,
       workflow,
-      fields: [...fields, ...fieldsToInject]
+      fields: allFields
     };
   });
   const hasAuditCollection = normalizedCollections.some((col) => col.slug === AUDIT_COLLECTION_SLUG);
@@ -3934,6 +4093,17 @@ var ConflictError = class _ConflictError extends DyrectedError {
     Object.setPrototypeOf(this, _ConflictError.prototype);
   }
 };
+var DuplicateKeyError = class _DuplicateKeyError extends ConflictError {
+  field;
+  value;
+  constructor(message, options) {
+    super(message);
+    this.name = "DuplicateKeyError";
+    this.field = options?.field;
+    this.value = options?.value;
+    Object.setPrototypeOf(this, _DuplicateKeyError.prototype);
+  }
+};
 
 // src/utils/parse-where.ts
 function assertNever(op, context) {
@@ -6619,9 +6789,12 @@ function defineTab(args) {
   AI_CHUNKS_COLLECTION,
   AI_MESSAGES_COLLECTION,
   AI_THREADS_COLLECTION,
+  BASE62_ALPHABET,
   BUILTIN_JEXL_HELPERS,
+  CROCKFORD_BASE32,
   ConfigValidationError,
   ConflictError,
+  DuplicateKeyError,
   DyrectedAIError,
   DyrectedError,
   FieldConditionBuilder,
@@ -6629,6 +6802,7 @@ function defineTab(args) {
   LIFECYCLE_EVENTS_COLLECTION,
   LIFECYCLE_EVENT_NAMES,
   MatchBuilder,
+  NANOID_ALPHABET,
   NON_NEGOTIABLE_CREDENTIAL_FIELDS,
   NotFoundError,
   PII_REGEX_PATTERNS,
@@ -6724,6 +6898,8 @@ function defineTab(args) {
   formatDate,
   formatJexlValue,
   generateDefaultDetailSchema,
+  generateDocumentId,
+  generateId,
   generateOpenApi,
   get,
   getAdminAuthCollection,
@@ -6750,6 +6926,7 @@ function defineTab(args) {
   materializeWorkflowDocument,
   max,
   min,
+  nanoid,
   normalizeConfig,
   normalizeDetailItem,
   now,
@@ -6758,6 +6935,7 @@ function defineTab(args) {
   parseSort,
   parseSqlWhere,
   pow,
+  prefixedId,
   publishedStateName,
   publishingWorkflow,
   readingTime,
@@ -6765,6 +6943,7 @@ function defineTab(args) {
   replace,
   resolveAdminAuthCollection,
   resolveAuthorizedSiteId,
+  resolvePrefix,
   round,
   runCollectionHooks,
   sanitizeDocForAI,
@@ -6778,8 +6957,10 @@ function defineTab(args) {
   transitionWorkflow,
   trim,
   truncate,
+  ulid,
   unique,
   upper,
+  uuid,
   validateAdminConditionExpression,
   validateDeclarativeAccessExpression,
   validateDeclarativeHookExpression,