@murumets-ee/entity 0.15.3 → 0.16.0

package/dist/admin/index.d.mts

@@ -1,5 +1,5 @@
 import { SQL, eq } from "drizzle-orm";
-import { PgTableWithColumns } from "drizzle-orm/pg-core";
+import { PgColumn, PgColumnBuilderBase, PgTableWithColumns } from "drizzle-orm/pg-core";
 import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 
 //#region src/count-cache.d.ts
@@ -184,6 +184,35 @@ type InferCreateInput<Fields extends Record<string, FieldConfig>> = Omit<{ [K in
 type ImmutableFields = 'id' | 'createdAt' | 'createdBy';
 type InferUpdateInput<Fields extends Record<string, FieldConfig>> = { [K in keyof Fields as K extends ImmutableFields ? never : K]?: FieldToTS<Fields[K]> | null };
 //#endregion
+//#region src/behaviors/schema-fragment.d.ts
+/** Which table a behavior fragment targets. */
+type SchemaTarget = 'main' | 'translations';
+/**
+ * A constraint contributed by a behavior. The union is intentionally
+ * closed — there is NO `kind: 'raw'` escape hatch. If a future behavior
+ * needs a new constraint shape, add a typed variant to this union rather
+ * than reaching for raw SQL.
+ */
+type SchemaFragment = {
+  kind: 'index';
+  name: string;
+  on: PgColumn[]; /** Defaults to btree. Pass `'gin'`/`'gist'` for FTS / vector indexes. */
+  using?: 'btree' | 'gin' | 'gist' | 'hash' | 'brin';
+} | {
+  kind: 'uniqueConstraint';
+  /**
+   * Required even though Drizzle's `unique()` accepts an unnamed
+   * constraint — the schema generator uses `name` as the
+   * collision-detection key across behaviors.
+   */
+  name: string;
+  on: PgColumn[];
+} | {
+  kind: 'checkConstraint';
+  name: string;
+  expression: SQL;
+};
+//#endregion
 //#region src/behaviors/types.d.ts
 /**
  * Structural shape of a queue `JobDefinition` as seen by behaviors.
@@ -298,6 +327,40 @@ interface Behavior<F extends Record<string, FieldConfig> = {}> {
     beforeDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
     afterDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
   };
+  /**
+   * Contribute extra columns to the entity's main table or `<entity>_translations` table.
+   * Runs BEFORE the Drizzle `pgTable()` call so contributions (including GENERATED
+   * columns) participate in the column map. Returns an empty object when the behavior
+   * does not contribute to the requested `target`.
+   *
+   * `info.allFields` is the post-behaviors-merge field map (i.e. user fields plus
+   * any fields contributed by earlier behaviors). Behaviors like `searchable()`
+   * use it to decide whether to put the column on `'main'` or `'translations'`
+   * based on each referenced field's `translatable` flag.
+   *
+   * Collisions with entity fields or other behaviors' contributions throw at
+   * schema-build time — see `schema-generator.ts:collectBehaviorContributions`.
+   */
+  columns?: (target: SchemaTarget, info: BehaviorSchemaInfo) => Record<string, PgColumnBuilderBase>;
+  /**
+   * Contribute table-level constraints (indexes, uniques, checks) to the entity's
+   * main table or `<entity>_translations` table. Runs INSIDE the `pgTable` builder
+   * callback once columns are resolved. Returns an empty array when the behavior
+   * does not contribute to the requested `target`.
+   *
+   * Constraint names must be globally unique within the table; collisions throw.
+   */
+  constraints?: (table: Record<string, PgColumn>, target: SchemaTarget, info: BehaviorSchemaInfo) => SchemaFragment[];
+}
+/**
+ * Subset of `Entity` passed to behavior `columns` / `constraints` callbacks.
+ * Structurally typed so `behaviors/types.ts` does not need to import the full
+ * `Entity` type from `../define-entity.js` (which would create the well-known
+ * types-↔-define-entity dance inside the package).
+ */
+interface BehaviorSchemaInfo {
+  readonly entityName: string;
+  readonly allFields: Readonly<Record<string, FieldConfig>>;
 }
 //#endregion
 //#region src/cursor.d.ts

package/dist/admin/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/count-cache.ts","../../src/fields/base.ts","../../src/types/infer.ts","../../src/behaviors/types.ts","../../src/cursor.ts","../../src/admin-config.ts","../../src/define-entity.ts","../../src/shared/entity-data-ops.ts","../../src/types/logger.ts","../../src/admin/client.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/count-cache.ts","../../src/fields/base.ts","../../src/types/infer.ts","../../src/behaviors/schema-fragment.ts","../../src/behaviors/types.ts","../../src/cursor.ts","../../src/admin-config.ts","../../src/define-entity.ts","../../src/shared/entity-data-ops.ts","../../src/types/logger.ts","../../src/admin/client.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as _$drizzle_orm0 from "drizzle-orm";
 import { SQL } from "drizzle-orm";
 import * as _$drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
-import { PgTable } from "drizzle-orm/pg-core";
+import { PgColumn, PgColumnBuilderBase, PgTable } from "drizzle-orm/pg-core";
 import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 
 //#region src/admin-config.d.ts
@@ -259,6 +259,35 @@ type InferEntity<E> = E extends {
   allFields: infer F extends Record<string, FieldConfig>;
 } ? InferEntityDTO<F> : never;
 //#endregion
+//#region src/behaviors/schema-fragment.d.ts
+/** Which table a behavior fragment targets. */
+type SchemaTarget = 'main' | 'translations';
+/**
+ * A constraint contributed by a behavior. The union is intentionally
+ * closed — there is NO `kind: 'raw'` escape hatch. If a future behavior
+ * needs a new constraint shape, add a typed variant to this union rather
+ * than reaching for raw SQL.
+ */
+type SchemaFragment = {
+  kind: 'index';
+  name: string;
+  on: PgColumn[]; /** Defaults to btree. Pass `'gin'`/`'gist'` for FTS / vector indexes. */
+  using?: 'btree' | 'gin' | 'gist' | 'hash' | 'brin';
+} | {
+  kind: 'uniqueConstraint';
+  /**
+   * Required even though Drizzle's `unique()` accepts an unnamed
+   * constraint — the schema generator uses `name` as the
+   * collision-detection key across behaviors.
+   */
+  name: string;
+  on: PgColumn[];
+} | {
+  kind: 'checkConstraint';
+  name: string;
+  expression: SQL;
+};
+//#endregion
 //#region src/behaviors/types.d.ts
 /**
  * Structural shape of a queue `JobDefinition` as seen by behaviors.
@@ -373,6 +402,40 @@ interface Behavior<F extends Record<string, FieldConfig> = {}> {
     beforeDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
     afterDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
   };
+  /**
+   * Contribute extra columns to the entity's main table or `<entity>_translations` table.
+   * Runs BEFORE the Drizzle `pgTable()` call so contributions (including GENERATED
+   * columns) participate in the column map. Returns an empty object when the behavior
+   * does not contribute to the requested `target`.
+   *
+   * `info.allFields` is the post-behaviors-merge field map (i.e. user fields plus
+   * any fields contributed by earlier behaviors). Behaviors like `searchable()`
+   * use it to decide whether to put the column on `'main'` or `'translations'`
+   * based on each referenced field's `translatable` flag.
+   *
+   * Collisions with entity fields or other behaviors' contributions throw at
+   * schema-build time — see `schema-generator.ts:collectBehaviorContributions`.
+   */
+  columns?: (target: SchemaTarget, info: BehaviorSchemaInfo) => Record<string, PgColumnBuilderBase>;
+  /**
+   * Contribute table-level constraints (indexes, uniques, checks) to the entity's
+   * main table or `<entity>_translations` table. Runs INSIDE the `pgTable` builder
+   * callback once columns are resolved. Returns an empty array when the behavior
+   * does not contribute to the requested `target`.
+   *
+   * Constraint names must be globally unique within the table; collisions throw.
+   */
+  constraints?: (table: Record<string, PgColumn>, target: SchemaTarget, info: BehaviorSchemaInfo) => SchemaFragment[];
+}
+/**
+ * Subset of `Entity` passed to behavior `columns` / `constraints` callbacks.
+ * Structurally typed so `behaviors/types.ts` does not need to import the full
+ * `Entity` type from `../define-entity.js` (which would create the well-known
+ * types-↔-define-entity dance inside the package).
+ */
+interface BehaviorSchemaInfo {
+  readonly entityName: string;
+  readonly allFields: Readonly<Record<string, FieldConfig>>;
 }
 //#endregion
 //#region src/behaviors/auditable.d.ts
@@ -396,6 +459,227 @@ declare function publishable(): Behavior<PublishableFields>;
 //#region src/behaviors/revisionable.d.ts
 declare function revisionable(): Behavior<RevisionableFields>;
 //#endregion
+//#region src/define-entity.d.ts
+/**
+ * Entity definition input (without behaviors — behaviors are typed separately
+ * on the `defineEntity` function to enable tuple inference).
+ *
+ * @typeParam F - The literal field map. Inferred automatically from the call site.
+ */
+interface EntityDefinition<F extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+  name: string;
+  kind?: 'collection' | 'singleton';
+  fields: F;
+  scope?: 'global' | 'team' | 'user';
+  access?: {
+    view?: string;
+    create?: string;
+    update?: string;
+    delete?: string;
+  };
+  /** Admin UI configuration — controls sidebar, list, and form display */
+  admin?: EntityAdminConfig;
+}
+/**
+ * Full input for defineEntity (fields + behaviors + other config).
+ * Behaviors are typed as a tuple `B` for type extraction.
+ */
+type EntityInput<F extends Record<string, FieldConfig> = Record<string, FieldConfig>, B extends Behavior[] = Behavior[]> = EntityDefinition<F> & {
+  behaviors?: B;
+};
+/**
+ * A fully resolved entity with merged behavior fields.
+ * @typeParam AllFields - The complete field map (id + behaviors + user fields).
+ */
+interface Entity<AllFields extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+  name: string;
+  kind?: 'collection' | 'singleton';
+  fields: Record<string, FieldConfig>;
+  behaviors?: Behavior[];
+  scope?: 'global' | 'team' | 'user';
+  access?: {
+    view?: string;
+    create?: string;
+    update?: string;
+    delete?: string;
+  };
+  /** Admin UI configuration — controls sidebar, list, and form display */
+  admin?: EntityAdminConfig;
+  allFields: AllFields;
+}
+/**
+ * Extract and intersect behavior field types from a behaviors tuple.
+ * Walks the tuple recursively (depth bounded by number of behaviors, max ~5).
+ *
+ * Inferring `F` via `Behavior<infer F1>` is unreliable for inline hook-only
+ * behaviors: when the literal has no `fields` property, TS falls back to the
+ * `Behavior` constraint bound (`Record<string, FieldConfig>`) rather than the
+ * declared default. That bound would widen every `AllFields[K]` access to
+ * `FieldConfig` and break per-field type inference downstream (e.g. reference
+ * cardinality, select option literals). Instead, derive the field map from
+ * the behavior's `fields` property directly — if absent/undefined, contribute
+ * nothing (empty object) to the intersection.
+ */
+type BehaviorFieldsOf<B> = B extends {
+  fields?: infer F;
+} ? F extends Record<string, FieldConfig> ? F : {} : {};
+type ExtractBehaviorFields<B extends Behavior[]> = B extends [infer B1, ...infer Rest extends Behavior[]] ? BehaviorFieldsOf<B1> & ExtractBehaviorFields<Rest> : {};
+/**
+ * Define an entity with full type inference.
+ *
+ * @example
+ * const Article = defineEntity({
+ *   name: 'article',
+ *   fields: {
+ *     title: field.text({ required: true }),
+ *     featured: field.boolean(),
+ *   },
+ *   behaviors: [publishable(), auditable()],
+ * })
+ *
+ * type ArticleDTO = InferEntity<typeof Article>
+ * // { id: string; title: string; featured?: boolean | null; status?: ...; createdAt?: ...; }
+ */
+declare function defineEntity<F extends Record<string, FieldConfig>, const B extends Behavior[] = []>(definition: EntityDefinition<F> & {
+  behaviors?: B;
+}): Entity<{
+  id: IdField;
+} & ExtractBehaviorFields<B> & F>;
+//#endregion
+//#region src/behaviors/searchable.d.ts
+/**
+ * Locally-defined result-row shape. Structurally compatible with
+ * `@murumets-ee/search`'s `SearchResultRow` — see file-level note.
+ */
+interface SearchableResultRow {
+  /** Stable id used by the consumer to navigate / select the row. */
+  id: string;
+  /** Headline / title rendered in the result list. */
+  label: string;
+  /** Optional secondary text. */
+  description?: string;
+  /** Optional URL the consumer can link to. */
+  url?: string;
+  /** Provider-specific extras (consumer-typed). */
+  data?: Record<string, unknown>;
+}
+/** Full-text search configuration. */
+interface SearchableFts {
+  /**
+   * Subset of the entity's `fields` that participate in FTS. Order
+   * determines `setweight()` (first field → 'A', second → 'B', …).
+   */
+  readonly fields: readonly string[];
+  /**
+   * Postgres text-search configuration name. Defaults to `'simple'`
+   * (no stemming/stopwords). v1 only wires `'simple'`; locale-specific
+   * dictionaries are a future iteration.
+   */
+  readonly language?: string;
+}
+/**
+ * Cross-entity OR-search target. Allows the parent's `searchable()` to
+ * reach into related-entity tsvectors at query time (UNION ALL + GROUP
+ * BY shape) without denormalizing into the parent table.
+ *
+ * Requires the included entity to ALSO have a `searchable({ fts: ... })`
+ * declaration — its tsvector is what the parent's provider unions
+ * against.
+ */
+interface SearchableInclude {
+  /** Name of the included entity (must have its own `searchable()`). */
+  readonly entity: string;
+  /**
+   * Foreign-key **field name** on the included entity that points back
+   * to the parent's `id`. Use the JS field name (`ticketId`), not the
+   * database column name (`ticket_id`) — `getTable()` returns
+   * Drizzle's typed accessor where keys match field names.
+   */
+  readonly fk: string;
+}
+/** The metadata a `searchable()` declaration attaches to its `Behavior`. */
+interface SearchableConfig {
+  /**
+   * Fields searched in ILIKE mode AND used to construct the tsvector
+   * expression (when `fts` is set). Field names must exist on the entity.
+   */
+  readonly fields: readonly string[];
+  /** Optional FTS configuration. When set, the entity gains a tsvector + GIN. */
+  readonly fts?: SearchableFts;
+  /** Optional cross-entity includes for JOIN-mode search (commit #5). */
+  readonly includes?: readonly SearchableInclude[];
+  /**
+   * Filters applied to every search call unless the caller overrides
+   * them. The standard use case is bounding to active rows (e.g.
+   * `{ status: ['open', 'pending'] }` to exclude `closed`/`archived`).
+   */
+  readonly defaultFilters?: Readonly<Record<string, readonly string[]>>;
+  /**
+   * Project an entity row into a `SearchableResultRow`. Per D14 the
+   * provider does not synthesize a default — every entity declares its
+   * own projection so consumer-visible result shape is explicit.
+   */
+  readonly projection: (row: Record<string, unknown>) => SearchableResultRow;
+}
+/** Public options shape accepted by the `searchable()` factory. */
+type SearchableOptions = SearchableConfig;
+/**
+ * A {@link Behavior} returned by `searchable()`. Adds a typed `config`
+ * property so downstream consumers can read the metadata without
+ * casting to `any`.
+ */
+interface SearchableBehavior extends Behavior {
+  readonly name: 'searchable';
+  readonly config: SearchableConfig;
+}
+/**
+ * Declare that an entity participates in admin/inbox search.
+ *
+ * ```ts
+ * defineEntity({
+ *   name: 'ticket',
+ *   behaviors: [
+ *     auditable(),
+ *     searchable({
+ *       fields: ['subject', 'requesterEmail', 'requesterName'],
+ *       fts: { fields: ['subject'], language: 'simple' },
+ *       includes: [{ entity: 'ticket_message', fk: 'ticketId' }],
+ *       defaultFilters: { status: ['open', 'pending', 'on_hold'] },
+ *       projection: (row) => ({
+ *         id: row.id as string,
+ *         label: row.subject as string,
+ *         description: row.requesterEmail as string,
+ *       }),
+ *     }),
+ *   ],
+ * })
+ * ```
+ *
+ * Adding a field to `fts.fields` on an entity that already shipped FTS
+ * requires a manual two-step migration (drop the generated tsvector
+ * column, then re-run `pnpm db:migrate`) — Postgres does not allow
+ * `ALTER COLUMN` for GENERATED expressions, and drizzle-kit silently
+ * ignores the change. v1 is greenfield so this is documented for
+ * post-launch operators, not a blocker now.
+ */
+declare function searchable(options: SearchableOptions): SearchableBehavior;
+/**
+ * Runtime type predicate — narrows a `Behavior` to {@link SearchableBehavior}.
+ * Guards against accidental matches where another behavior happens to
+ * also be named `'searchable'` (defense in depth — shouldn't happen in
+ * practice).
+ */
+declare function isSearchableBehavior(b: Behavior): b is SearchableBehavior;
+/**
+ * Read the `searchable()` config from an entity. Returns `undefined`
+ * when the entity does not declare `searchable()`.
+ *
+ * Used by the admin search bootstrap (commit #6) to build a provider
+ * per searchable entity, and by the EntityList toolbar to know whether
+ * to enable the search input.
+ */
+declare function getSearchableConfig(entity: Entity): SearchableConfig | undefined;
+//#endregion
 //#region src/behaviors/sluggable.d.ts
 interface SluggableOptions {
   /** Make the slug translatable — each locale gets its own slug. Default: false */
@@ -499,6 +783,7 @@ declare const behavior: {
   revisionable: typeof revisionable;
   hierarchical: typeof hierarchical;
   timestamped: typeof timestamped;
+  searchable: typeof searchable;
 };
 //#endregion
 //#region src/count-cache.d.ts
@@ -639,93 +924,6 @@ declare function decodeCursor(encoded: string): DecodedCursor | null;
  */
 declare function buildCursorCondition(table: PgTable, cursor: DecodedCursor): SQL | null;
 //#endregion
-//#region src/define-entity.d.ts
-/**
- * Entity definition input (without behaviors — behaviors are typed separately
- * on the `defineEntity` function to enable tuple inference).
- *
- * @typeParam F - The literal field map. Inferred automatically from the call site.
- */
-interface EntityDefinition<F extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
-  name: string;
-  kind?: 'collection' | 'singleton';
-  fields: F;
-  scope?: 'global' | 'team' | 'user';
-  access?: {
-    view?: string;
-    create?: string;
-    update?: string;
-    delete?: string;
-  };
-  /** Admin UI configuration — controls sidebar, list, and form display */
-  admin?: EntityAdminConfig;
-}
-/**
- * Full input for defineEntity (fields + behaviors + other config).
- * Behaviors are typed as a tuple `B` for type extraction.
- */
-type EntityInput<F extends Record<string, FieldConfig> = Record<string, FieldConfig>, B extends Behavior[] = Behavior[]> = EntityDefinition<F> & {
-  behaviors?: B;
-};
-/**
- * A fully resolved entity with merged behavior fields.
- * @typeParam AllFields - The complete field map (id + behaviors + user fields).
- */
-interface Entity<AllFields extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
-  name: string;
-  kind?: 'collection' | 'singleton';
-  fields: Record<string, FieldConfig>;
-  behaviors?: Behavior[];
-  scope?: 'global' | 'team' | 'user';
-  access?: {
-    view?: string;
-    create?: string;
-    update?: string;
-    delete?: string;
-  };
-  /** Admin UI configuration — controls sidebar, list, and form display */
-  admin?: EntityAdminConfig;
-  allFields: AllFields;
-}
-/**
- * Extract and intersect behavior field types from a behaviors tuple.
- * Walks the tuple recursively (depth bounded by number of behaviors, max ~5).
- *
- * Inferring `F` via `Behavior<infer F1>` is unreliable for inline hook-only
- * behaviors: when the literal has no `fields` property, TS falls back to the
- * `Behavior` constraint bound (`Record<string, FieldConfig>`) rather than the
- * declared default. That bound would widen every `AllFields[K]` access to
- * `FieldConfig` and break per-field type inference downstream (e.g. reference
- * cardinality, select option literals). Instead, derive the field map from
- * the behavior's `fields` property directly — if absent/undefined, contribute
- * nothing (empty object) to the intersection.
- */
-type BehaviorFieldsOf<B> = B extends {
-  fields?: infer F;
-} ? F extends Record<string, FieldConfig> ? F : {} : {};
-type ExtractBehaviorFields<B extends Behavior[]> = B extends [infer B1, ...infer Rest extends Behavior[]] ? BehaviorFieldsOf<B1> & ExtractBehaviorFields<Rest> : {};
-/**
- * Define an entity with full type inference.
- *
- * @example
- * const Article = defineEntity({
- *   name: 'article',
- *   fields: {
- *     title: field.text({ required: true }),
- *     featured: field.boolean(),
- *   },
- *   behaviors: [publishable(), auditable()],
- * })
- *
- * type ArticleDTO = InferEntity<typeof Article>
- * // { id: string; title: string; featured?: boolean | null; status?: ...; createdAt?: ...; }
- */
-declare function defineEntity<F extends Record<string, FieldConfig>, const B extends Behavior[] = []>(definition: EntityDefinition<F> & {
-  behaviors?: B;
-}): Entity<{
-  id: IdField;
-} & ExtractBehaviorFields<B> & F>;
-//#endregion
 //#region src/refs/find-usages.d.ts
 interface EntityUsage {
   sourceEntity: string;
@@ -750,7 +948,7 @@ declare function generateSchema(entity: Entity): _$drizzle_orm_pg_core0.PgTableW
   name: string;
   schema: undefined;
   columns: {
-    [x: string]: _$drizzle_orm_pg_core0.PgColumn<{
+    [x: string]: PgColumn<{
       name: string;
       tableName: string;
       dataType: _$drizzle_orm0.ColumnDataType;
@@ -783,7 +981,7 @@ declare function generateTranslationSchema(entity: Entity, parent?: PgTable): _$
   name: string;
   schema: undefined;
   columns: {
-    [x: string]: _$drizzle_orm_pg_core0.PgColumn<{
+    [x: string]: PgColumn<{
       name: string;
       tableName: string;
       dataType: _$drizzle_orm0.ColumnDataType;
@@ -821,7 +1019,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
   name: string;
   schema: undefined;
   columns: {
-    id: _$drizzle_orm_pg_core0.PgColumn<{
+    id: PgColumn<{
       name: "id";
       tableName: string;
       dataType: "string";
@@ -838,7 +1036,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    entityId: _$drizzle_orm_pg_core0.PgColumn<{
+    entityId: PgColumn<{
       name: "entity_id";
       tableName: string;
       dataType: "string";
@@ -855,7 +1053,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    fieldName: _$drizzle_orm_pg_core0.PgColumn<{
+    fieldName: PgColumn<{
       name: "field_name";
       tableName: string;
       dataType: "string";
@@ -874,7 +1072,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
     }, {}, {
       length: 100;
     }>;
-    blockType: _$drizzle_orm_pg_core0.PgColumn<{
+    blockType: PgColumn<{
       name: "block_type";
       tableName: string;
       dataType: "string";
@@ -893,7 +1091,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
     }, {}, {
       length: 100;
     }>;
-    sortOrder: _$drizzle_orm_pg_core0.PgColumn<{
+    sortOrder: PgColumn<{
       name: "sort_order";
       tableName: string;
       dataType: "number";
@@ -910,7 +1108,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    data: _$drizzle_orm_pg_core0.PgColumn<{
+    data: PgColumn<{
       name: "data";
       tableName: string;
       dataType: "json";
@@ -927,7 +1125,7 @@ declare function generateLayoutSchema(entity: Entity, parent?: PgTable): _$drizz
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    locale: _$drizzle_orm_pg_core0.PgColumn<{
+    locale: PgColumn<{
       name: "locale";
       tableName: string;
       dataType: "string";
@@ -986,7 +1184,7 @@ declare function generateLayoutTranslationSchema(entity: Entity, layoutParent?:
   name: string;
   schema: undefined;
   columns: {
-    id: _$drizzle_orm_pg_core0.PgColumn<{
+    id: PgColumn<{
       name: "id";
       tableName: string;
       dataType: "string";
@@ -1003,7 +1201,7 @@ declare function generateLayoutTranslationSchema(entity: Entity, layoutParent?:
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    layoutId: _$drizzle_orm_pg_core0.PgColumn<{
+    layoutId: PgColumn<{
       name: "layout_id";
       tableName: string;
       dataType: "string";
@@ -1020,7 +1218,7 @@ declare function generateLayoutTranslationSchema(entity: Entity, layoutParent?:
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    locale: _$drizzle_orm_pg_core0.PgColumn<{
+    locale: PgColumn<{
       name: "locale";
       tableName: string;
       dataType: "string";
@@ -1039,7 +1237,7 @@ declare function generateLayoutTranslationSchema(entity: Entity, layoutParent?:
     }, {}, {
       length: 10;
     }>;
-    fields: _$drizzle_orm_pg_core0.PgColumn<{
+    fields: PgColumn<{
       name: "fields";
       tableName: string;
       dataType: "json";
@@ -1111,5 +1309,5 @@ declare class ForbiddenError extends Error {
   constructor(message: string);
 }
 //#endregion
-export { type AuditableFields, type Behavior, type BehaviorContext, type BlockDefinitionRef, type BlocksField, type BooleanField, type ContextResolver, CountCache, type CountCacheLike, type CursorInput, type DateField, type EnqueueOnCommit, type EnqueueOnCommitFactory, type Entity, type EntityAdminConfig, type EntityDefinition, type EntityInput, type EntityUsage, type FieldConfig, type FieldToTS, ForbiddenError, type IdField, type InferCreateInput, type InferEntity, type InferEntityDTO, type InferUpdateInput, type JobLike, type JsonField, type JsonValue, type MediaField, type NumberField, type PublishableFields, type ReferenceField, ReferencedEntityError, type RichTextField, type SecurityContext, type SelectField, type SlugField, type TextField, auditable, behavior, buildCursorCondition, buildEntitySchemaMap, decodeCursor, defineEntity, encodeCursor, estimateRowCount, field, generateLayoutSchema, generateLayoutTranslationSchema, generateSchema, generateTranslationSchema, hasBehavior, hasBlocksFields, hasTranslatableBlocks, hierarchical, isPublishable, isVersionable, needsLocaleStatus, publishable, revisionable, sluggable, slugify, timestamped };
+export { type AuditableFields, type Behavior, type BehaviorContext, type BehaviorSchemaInfo, type BlockDefinitionRef, type BlocksField, type BooleanField, type ContextResolver, CountCache, type CountCacheLike, type CursorInput, type DateField, type EnqueueOnCommit, type EnqueueOnCommitFactory, type Entity, type EntityAdminConfig, type EntityDefinition, type EntityInput, type EntityUsage, type FieldConfig, type FieldToTS, ForbiddenError, type IdField, type InferCreateInput, type InferEntity, type InferEntityDTO, type InferUpdateInput, type JobLike, type JsonField, type JsonValue, type MediaField, type NumberField, type PublishableFields, type ReferenceField, ReferencedEntityError, type RichTextField, type SchemaFragment, type SchemaTarget, type SearchableBehavior, type SearchableConfig, type SearchableFts, type SearchableInclude, type SearchableOptions, type SearchableResultRow, type SecurityContext, type SelectField, type SlugField, type TextField, auditable, behavior, buildCursorCondition, buildEntitySchemaMap, decodeCursor, defineEntity, encodeCursor, estimateRowCount, field, generateLayoutSchema, generateLayoutTranslationSchema, generateSchema, generateTranslationSchema, getSearchableConfig, hasBehavior, hasBlocksFields, hasTranslatableBlocks, hierarchical, isPublishable, isSearchableBehavior, isVersionable, needsLocaleStatus, publishable, revisionable, searchable, sluggable, slugify, timestamped };
 //# sourceMappingURL=index.d.mts.map