@rebasepro/server-postgresql 0.3.0 → 0.5.0

package/dist/server-postgresql/src/services/EntityFetchService.d.ts

@@ -1,6 +1,6 @@
 import { SQL } from "drizzle-orm";
 import { PgTable } from "drizzle-orm/pg-core";
-import { Entity, FilterValues } from "@rebasepro/types";
+import { Entity, FilterValues, LogicalCondition } from "@rebasepro/types";
 import type { VectorSearchParams } from "@rebasepro/types";
 import { RelationService } from "./RelationService";
 import { DrizzleClient } from "../interfaces";
@@ -104,6 +104,7 @@ export declare class EntityFetchService {
         searchString?: string;
         databaseId?: string;
         vectorSearch?: VectorSearchParams;
+        logical?: LogicalCondition;
     }): Promise<Entity<M>[]>;
     /**
      * Fallback path used when db.query is unavailable.

package/dist/server-postgresql/src/services/EntityPersistService.d.ts

@@ -17,6 +17,10 @@ export declare class EntityPersistService {
      * Delete an entity by ID
      */
     deleteEntity(collectionPath: string, entityId: string | number, _databaseId?: string): Promise<void>;
+    /**
+     * Delete all entities from a collection
+     */
+    deleteAll(collectionPath: string, _databaseId?: string): Promise<void>;
     /**
      * Save an entity (create or update)
      */

package/dist/server-postgresql/src/services/entityService.d.ts

@@ -87,6 +87,10 @@ export declare class EntityService implements EntityRepository {
      * Delete an entity by ID
      */
     deleteEntity(collectionPath: string, entityId: string | number, databaseId?: string): Promise<void>;
+    /**
+     * Delete all entities from a collection
+     */
+    deleteAll(collectionPath: string, databaseId?: string): Promise<void>;
     /**
      * Execute raw SQL
      */

package/dist/server-postgresql/src/types.d.ts

@@ -0,0 +1,3 @@
+import type { PgTable, AnyPgColumn } from "drizzle-orm/pg-core";
+/** Drizzle PgTable with column access by name. Runtime Drizzle tables satisfy this shape. */
+export type RebasePgTable = PgTable & Record<string, AnyPgColumn>;

package/dist/server-postgresql/src/utils/drizzle-conditions.d.ts

@@ -1,6 +1,6 @@
 import { SQL } from "drizzle-orm";
 import { AnyPgColumn, PgTable } from "drizzle-orm/pg-core";
-import { FilterValues, WhereFilterOp, Relation } from "@rebasepro/types";
+import { FilterValues, WhereFilterOp, Relation, LogicalCondition, FilterCondition } from "@rebasepro/types";
 import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
 /** Drizzle dynamic query builder — accepts innerJoin + where chaining */
 export interface DrizzleDynamicQuery {
@@ -22,6 +22,10 @@ export declare class DrizzleConditionBuilder {
      * Build filter conditions from FilterValues
      */
     static buildFilterConditions<M extends Record<string, unknown>>(filter: FilterValues<Extract<keyof M, string>>, table: PgTable<any>, collectionPath: string): SQL[];
+    /**
+     * Build logical conditions recursively from LogicalCondition or FilterCondition
+     */
+    static buildLogicalConditions(cond: LogicalCondition | FilterCondition, table: PgTable<any>, collectionPath: string): SQL | null;
     /**
      * Build a single filter condition for a specific operator and value
      */

package/dist/server-postgresql/src/websocket.d.ts

@@ -1,6 +1,11 @@
 import { RealtimeService } from "./services/realtimeService";
 import { PostgresBackendDriver } from "./PostgresBackendDriver";
-import { AuthAdapter } from "@rebasepro/types";
+import type { AuthAdapter } from "@rebasepro/types";
 import { Server } from "http";
-import { AuthConfig } from "@rebasepro/server-core";
-export declare function createPostgresWebSocket(server: Server, realtimeService: RealtimeService, driver: PostgresBackendDriver, authConfig?: AuthConfig, authAdapter?: AuthAdapter): void;
+/** Minimal subset of RebaseAuthConfig used by the WebSocket layer. */
+interface WsAuthConfig {
+    requireAuth?: boolean;
+    jwtSecret?: string;
+}
+export declare function createPostgresWebSocket(server: Server, realtimeService: RealtimeService, driver: PostgresBackendDriver, authConfig?: WsAuthConfig, authAdapter?: AuthAdapter): void;
+export {};

package/dist/types/src/controllers/auth.d.ts

@@ -1,4 +1,4 @@
-import { Role, User } from "../users";
+import type { User } from "../users";
 /**
  * Capabilities advertised by an auth provider.
  * UI components use this to show/hide features dynamically
@@ -62,7 +62,7 @@ export type AuthController<USER extends User = User, ExtraData = unknown> = {
     extra: ExtraData;
     setExtra: (extra: ExtraData) => void;
     setUser?(user: USER | null): void;
-    setUserRoles?(roles: Role[]): void;
+    setUserRoles?(roles: string[]): void;
     /**
      * Capabilities advertised by the auth provider.
      * UI components use this to feature-detect what the backend supports.

package/dist/types/src/controllers/client.d.ts

@@ -1,6 +1,6 @@
-import { User } from "../users";
-import { RebaseData } from "./data";
-import { EmailService } from "./email";
+import type { User } from "../users";
+import type { RebaseData } from "./data";
+import type { EmailService } from "./email";
 /**
  * Event type for authentication state changes
  */
@@ -14,7 +14,7 @@ export interface RebaseSession {
     expiresAt: number;
     user: User;
 }
-import { StorageSource } from "./storage";
+import type { StorageSource } from "./storage";
 /**
  * Unified Authentication Client Interface
  * Pure functional SDK interface, decoupled from UI and React hooks
@@ -56,19 +56,9 @@ export interface AdminUser {
     createdAt: string;
     updatedAt: string;
 }
-/**
- * Role record as returned by the Admin API.
- * @group Admin
- */
-export interface AdminRole {
-    id: string;
-    name: string;
-    isAdmin: boolean;
-    defaultPermissions: Record<string, unknown> | null;
-}
 /**
  * Client-side Admin API interface.
- * Provides user and role management operations.
+ * Provides user management operations.
  * @group Admin
  */
 export interface AdminAPI {
@@ -111,30 +101,6 @@ export interface AdminAPI {
     deleteUser(userId: string): Promise<{
         success: boolean;
     }>;
-    listRoles(): Promise<{
-        roles: AdminRole[];
-    }>;
-    getRole(roleId: string): Promise<{
-        role: AdminRole;
-    }>;
-    createRole(data: {
-        id: string;
-        name: string;
-        isAdmin?: boolean;
-        defaultPermissions?: Record<string, unknown>;
-    }): Promise<{
-        role: AdminRole;
-    }>;
-    updateRole(roleId: string, data: {
-        name?: string;
-        isAdmin?: boolean;
-        defaultPermissions?: Record<string, unknown>;
-    }): Promise<{
-        role: AdminRole;
-    }>;
-    deleteRole(roleId: string): Promise<{
-        success: boolean;
-    }>;
     bootstrap(): Promise<{
         success: boolean;
         message: string;
@@ -165,7 +131,7 @@ export interface RebaseClient<DB = unknown> {
      * > The client-side SDK does not include an email service.
      */
     email?: EmailService;
-    /** Admin API for user and role management */
+    /** Admin API for user management */
     admin?: AdminAPI;
     /**
      * The base HTTP URL of the backend server.
@@ -180,4 +146,23 @@ export interface RebaseClient<DB = unknown> {
      * detection (e.g. `typeof ws.executeSql === "function"`).
      */
     ws?: unknown;
+    /**
+     * Execute raw SQL against the database.
+     *
+     * Only available server-side when the backend uses a SQL database
+     * (PostgreSQL, MySQL, etc.). `undefined` for document databases
+     * (MongoDB, Firestore) and on the client-side SDK.
+     *
+     * @example
+     * ```typescript
+     * // In a cron job or custom function:
+     * if (ctx.client.sql) {
+     *     const rows = await ctx.client.sql("SELECT count(*) FROM orders");
+     * }
+     * ```
+     */
+    sql?(query: string, options?: {
+        database?: string;
+        role?: string;
+    }): Promise<Record<string, unknown>[]>;
 }

package/dist/types/src/controllers/data.d.ts

@@ -16,7 +16,17 @@ import { Entity, EntityValues } from "../types/entities";
  *
  * @group Data
  */
-export type WhereFieldValue = string | number | boolean | null | [WhereFilterOpShort, any];
+export type WhereFieldValue = string | number | boolean | null | [WhereFilterOpShort, any] | [WhereFilterOpShort, any][];
+export type WhereValue<T> = T | T[] | null;
+export interface LogicalCondition {
+    type: "and" | "or";
+    conditions: (FilterCondition | LogicalCondition)[];
+}
+export interface FilterCondition {
+    column: string;
+    operator: FilterOperator;
+    value: unknown;
+}
 /** Short operator strings accepted in the tuple syntax. */
 export type WhereFilterOpShort = "==" | "!=" | ">" | ">=" | "<" | "<=" | "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "nin" | "not-in" | "array-contains" | "array-contains-any" | "cs" | "csa";
 export interface FindParams {
@@ -51,6 +61,8 @@ export interface FindParams {
      * ```
      */
     where?: Record<string, WhereFieldValue>;
+    /** Logical grouping conditions (AND/OR) */
+    logical?: LogicalCondition;
     /**
      * Sort order. Format: "field:direction".
      * @example "created_at:desc", "name:asc"
@@ -82,7 +94,8 @@ export type FilterOperator = WhereFilterOpShort;
  * @group Data
  */
 export interface QueryBuilderInterface<M extends Record<string, unknown> = Record<string, unknown>> {
-    where(column: keyof M & string, operator: FilterOperator, value: unknown): this;
+    where<K extends keyof M & string>(column: K, operator: FilterOperator, value: WhereValue<M[K]>): this;
+    where(logicalCondition: LogicalCondition): this;
     orderBy(column: keyof M & string, ascending?: "asc" | "desc"): this;
     limit(count: number): this;
     offset(count: number): this;
@@ -125,6 +138,10 @@ export interface CollectionAccessor<M extends Record<string, unknown> = Record<s
      * Delete a record by ID.
      */
     delete(id: string | number): Promise<void>;
+    /**
+     * Delete all records in this collection.
+     */
+    deleteAll?(): Promise<void>;
     /**
      * Subscribe to a collection for real-time updates.
      * Optional method, may not be supported by all implementations (like stateless HTTP clients).
@@ -139,7 +156,8 @@ export interface CollectionAccessor<M extends Record<string, unknown> = Record<s
      * Count the number of records matching the given filter.
      */
     count?(params?: FindParams): Promise<number>;
-    where(column: keyof M & string, operator: FilterOperator, value: unknown): QueryBuilderInterface<M>;
+    where<K extends keyof M & string>(column: K, operator: FilterOperator, value: WhereValue<M[K]>): QueryBuilderInterface<M>;
+    where(logicalCondition: LogicalCondition): QueryBuilderInterface<M>;
     orderBy(column: keyof M & string, ascending?: "asc" | "desc"): QueryBuilderInterface<M>;
     limit(count: number): QueryBuilderInterface<M>;
     offset(count: number): QueryBuilderInterface<M>;

package/dist/types/src/controllers/data_driver.d.ts

@@ -129,6 +129,11 @@ export interface DataDriver {
      * @return was the whole deletion flow successful
      */
     deleteEntity<M extends Record<string, unknown> = Record<string, unknown>>(props: DeleteEntityProps<M>): Promise<void>;
+    /**
+     * Delete all entities from a collection.
+     * @param path Collection path
+     */
+    deleteAll?(path: string): Promise<void>;
     /**
      * Check if the given property is unique in the given collection
      * @param path Collection path

package/dist/types/src/controllers/email.d.ts

@@ -31,4 +31,6 @@ export interface EmailService {
     send(options: EmailSendOptions): Promise<void>;
     /** Returns `true` when the service has valid credentials / is ready to send. */
     isConfigured(): boolean;
+    /** Verify connection/credentials with the email provider. */
+    verifyConnection?(): Promise<boolean>;
 }

package/dist/types/src/types/auth_adapter.d.ts

@@ -148,38 +148,6 @@ export interface AuthCreateUserData {
     photoUrl?: string;
     metadata?: Record<string, unknown>;
 }
-/**
- * Role data exposed by the auth adapter.
- * @group Auth
- */
-export interface AuthRoleData {
-    id: string;
-    name: string;
-    isAdmin: boolean;
-    defaultPermissions?: {
-        read?: boolean;
-        create?: boolean;
-        edit?: boolean;
-        delete?: boolean;
-    } | null;
-    collectionPermissions?: Record<string, {
-        read?: boolean;
-        create?: boolean;
-        edit?: boolean;
-        delete?: boolean;
-    }> | null;
-}
-/**
- * Data for creating a role.
- * @group Auth
- */
-export interface AuthCreateRoleData {
-    id: string;
-    name: string;
-    isAdmin?: boolean;
-    defaultPermissions?: AuthRoleData["defaultPermissions"];
-    collectionPermissions?: AuthRoleData["collectionPermissions"];
-}
 /**
  * User management operations for the admin panel.
  *
@@ -193,23 +161,9 @@ export interface UserManagementAdapter {
     createUser(data: AuthCreateUserData): Promise<AuthUserData>;
     updateUser(id: string, data: Partial<AuthCreateUserData>): Promise<AuthUserData | null>;
     deleteUser(id: string): Promise<void>;
-    getUserRoles(userId: string): Promise<AuthRoleData[]>;
+    getUserRoles(userId: string): Promise<string[]>;
     setUserRoles(userId: string, roleIds: string[]): Promise<void>;
 }
-/**
- * Role management operations for the admin panel.
- *
- * Optional — if not provided by the adapter, role management is disabled.
- *
- * @group Auth
- */
-export interface RoleManagementAdapter {
-    listRoles(): Promise<AuthRoleData[]>;
-    getRoleById(id: string): Promise<AuthRoleData | null>;
-    createRole(data: AuthCreateRoleData): Promise<AuthRoleData>;
-    updateRole(id: string, data: Partial<AuthRoleData>): Promise<AuthRoleData | null>;
-    deleteRole(id: string): Promise<void>;
-}
 /**
  * Pluggable authentication adapter for Rebase.
  *
@@ -217,7 +171,7 @@ export interface RoleManagementAdapter {
  * database layer. Each auth adapter knows how to:
  *
  * 1. Verify incoming HTTP requests (`verifyRequest`)
- * 2. Optionally manage users and roles (for the admin panel)
+ * 2. Optionally manage users (for the admin panel)
  * 3. Optionally mount auth-specific routes (login, register, etc.)
  * 4. Advertise its capabilities so the frontend can adapt
  *
@@ -269,11 +223,6 @@ export interface AuthAdapter {
      * Optional — if not provided, user management UI is hidden.
      */
     userManagement?: UserManagementAdapter;
-    /**
-     * Role CRUD for the admin panel.
-     * Optional — if not provided, role management is disabled.
-     */
-    roleManagement?: RoleManagementAdapter;
     /**
      * Mount adapter-specific auth routes (login, register, refresh, etc.).
      *
@@ -289,7 +238,7 @@ export interface AuthAdapter {
      */
     createAuthRoutes?(): Hono<any, any, any> | undefined;
     /**
-     * Mount admin routes for user/role management.
+     * Mount admin routes for user management.
      *
      * Same typing rationale as `createAuthRoutes` — the sub-app env is
      * unconstrained to support arbitrary adapter implementations.
@@ -345,8 +294,6 @@ export interface CustomAuthAdapterOptions {
     verifyToken?: (token: string) => Promise<AuthenticatedUser | null>;
     /** Optional user management for the admin panel. */
     userManagement?: UserManagementAdapter;
-    /** Optional role management for the admin panel. */
-    roleManagement?: RoleManagementAdapter;
     /** Static service key for server-to-server auth. */
     serviceKey?: string;
     /** Override default capabilities. */

package/dist/types/src/types/backend.d.ts

@@ -1,5 +1,6 @@
 import type { Entity } from "./entities";
 import type { EntityCollection, FilterValues, WhereFilterOp } from "./collections";
+import type { AuthAdapter } from "./auth_adapter";
 /**
  * Abstract database connection interface.
  * Represents a connection to any database system.
@@ -182,6 +183,24 @@ export interface RealtimeProvider {
      * Notify all relevant subscribers of an entity update
      */
     notifyEntityUpdate(path: string, entityId: string, entity: Entity | null, databaseId?: string): Promise<void>;
+    /**
+     * Called when the HTTP server is ready and listening.
+     * Useful for providers that need the server address for callbacks.
+     */
+    onServerReady?(serverInfo: {
+        port: number;
+        hostname?: string;
+    }): void;
+    /**
+     * Gracefully shut down the realtime provider.
+     * Called during server shutdown to clean up resources.
+     */
+    destroy?(): Promise<void>;
+    /**
+     * Stop the internal LISTEN client (e.g., PostgreSQL LISTEN/NOTIFY).
+     * Called during graceful shutdown before closing database connections.
+     */
+    stopListening?(): Promise<void>;
 }
 /**
  * Abstract collection registry interface.
@@ -464,6 +483,22 @@ export interface BackendBootstrapper {
      * (e.g., `"postgres"`, `"mongodb"`, `"mysql"`).
      */
     type: string;
+    /**
+     * Unique identifier for this bootstrapper instance.
+     * Used to register the driver in the driver registry.
+     * Defaults to `type` if not set.
+     */
+    id?: string;
+    /**
+     * Whether this bootstrapper provides the default driver.
+     * When true, the coordinator uses this driver as the primary one.
+     */
+    isDefault?: boolean;
+    /**
+     * Run database migrations for this driver.
+     * Called by the coordinator after all drivers are initialized.
+     */
+    runMigrations?(config: unknown, driverResult: InitializedDriver): Promise<void>;
     /**
      * Create a DataDriver from the given config.
      * This is the only **required** method.
@@ -498,7 +533,7 @@ export interface BackendBootstrapper {
     /**
      * Initialize WebSocket server for realtime operations.
      */
-    initializeWebsockets?(server: unknown, realtimeService: RealtimeProvider, driver: import("../controllers/data_driver").DataDriver, config?: unknown): Promise<void> | void;
+    initializeWebsockets?(server: unknown, realtimeService: RealtimeProvider, driver: import("../controllers/data_driver").DataDriver, config?: unknown, authAdapter?: AuthAdapter): Promise<void> | void;
 }
 /**
  * Result of `BackendBootstrapper.initializeDriver()`.
@@ -527,8 +562,8 @@ export interface InitializedDriver {
 export interface BootstrappedAuth {
     /** User management service. */
     userService: unknown;
-    /** Role management service. */
-    roleService: unknown;
+    /** Role management service (optional, roles are now simple strings). */
+    roleService?: unknown;
     /** Email service (optional). */
     emailService?: unknown;
     /** Combined Auth Repository for unified token and user management. */

package/dist/types/src/types/backend_hooks.d.ts

@@ -1,4 +1,4 @@
-import type { AdminUser, AdminRole } from "../controllers/client";
+import type { AdminUser } from "../controllers/client";
 /**
  * Context passed to every backend hook.
  * Provides information about the request that triggered the hook.
@@ -64,19 +64,6 @@ export interface UserHooks {
      */
     afterDelete?(userId: string, context: BackendHookContext): void | Promise<void>;
 }
-/**
- * Hooks for intercepting Admin Role data at the API boundary.
- * @group Backend Hooks
- */
-export interface RoleHooks {
-    /**
-     * Transform a role record after it's read from the database,
-     * before it's returned to the client.
-     *
-     * Return the modified role, or `null` to filter it out entirely.
-     */
-    afterRead?(role: AdminRole, context: BackendHookContext): AdminRole | null | Promise<AdminRole | null>;
-}
 /**
  * Hooks for intercepting collection entity data at the REST API boundary.
  *
@@ -146,7 +133,7 @@ export interface DataHooks {
  * These hooks run server-side after database operations complete and before
  * API responses are sent.
  *
- * - `users` / `roles` — intercept admin user and role management endpoints
+ * - `users` — intercept admin user management endpoints
  * - `data` — intercept ALL collection entity data flowing through the REST API
  *
  * `data` hooks complement per-collection `EntityCallbacks`. Entity callbacks
@@ -180,8 +167,6 @@ export interface DataHooks {
 export interface BackendHooks {
     /** Hooks for intercepting user management data */
     users?: UserHooks;
-    /** Hooks for intercepting role management data */
-    roles?: RoleHooks;
     /** Hooks for intercepting ALL collection entity data via the REST API */
     data?: DataHooks;
 }

package/dist/types/src/types/collections.d.ts

@@ -7,7 +7,7 @@ import type { EntityOverrides } from "./entity_overrides";
 import type { User } from "../users";
 import type { RebaseContext } from "../rebase_context";
 import type { Relation } from "./relations";
-import type { EntityCustomView, EntityDetailViewConfig } from "./entity_views";
+import type { EntityCustomView, FormViewConfig } from "./entity_views";
 import type { EntityAction } from "./entity_actions";
 import type { ComponentRef } from "./component_ref";
 /**
@@ -124,10 +124,14 @@ export interface BaseEntityCollection<M extends Record<string, unknown> = Record
      */
     defaultEntityAction?: "view" | "edit";
     /**
-     * Customization options for the read-only detail view.
-     * Only used when `defaultEntityAction` is `"view"`.
+     * Replace the default entity form with a custom component.
+     * The Builder receives the same props as entity view tabs
+     * (entity, formContext, collection, etc.) and has full control over the UI.
+     *
+     * Works in both edit mode and read-only mode (when `defaultEntityAction`
+     * is `"view"`). In read-only mode, `formContext.readOnly` will be `true`.
      */
-    detailView?: EntityDetailViewConfig;
+    formView?: FormViewConfig;
     /**
      * Prevent default actions from being displayed or executed on this collection.
      */
@@ -339,6 +343,23 @@ export interface BaseEntityCollection<M extends Record<string, unknown> = Record
      * Builder for the collection actions rendered in the toolbar
      */
     Actions?: ComponentRef<CollectionActionsProps>[];
+    /**
+     * The database table name for this collection.
+     * Automatically set for PostgreSQL collections.
+     * For non-SQL backends, this may be undefined.
+     */
+    table?: string;
+    /**
+     * Relations defined for this collection.
+     * Populated at normalization time from inline relation properties
+     * or explicit relation definitions.
+     */
+    relations?: Relation[];
+    /**
+     * Security rules for this collection (Row Level Security).
+     * When defined, the backend enforces access control policies.
+     */
+    securityRules?: SecurityRule[];
 }
 /**
  * A collection backed by PostgreSQL (or any SQL database).
@@ -432,7 +453,10 @@ export interface MongoDBCollection<M extends Record<string, unknown> = Record<st
  * @group Models
  */
 export type EntityCollection<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = PostgresCollection<M, USER> | FirebaseCollection<M, USER> | MongoDBCollection<M, USER>;
-/** An EntityCollection that supports SQL-style relations (e.g. Postgres). */
+/**
+ * An EntityCollection that supports SQL-style relations (e.g. Postgres).
+ * @deprecated Use `EntityCollection` directly — `table`, `relations`, and `securityRules` are now on `BaseEntityCollection`.
+ */
 export type CollectionWithRelations<M extends Record<string, unknown> = Record<string, unknown>> = EntityCollection<M> & {
     table?: string;
     relations?: Relation[];
@@ -566,7 +590,7 @@ export type WhereFilterOp = "<" | "<=" | "==" | "!=" | ">=" | ">" | "array-conta
  *
  * @group Models
  */
-export type FilterValues<Key extends string> = Partial<Record<Key, [WhereFilterOp, unknown]>>;
+export type FilterValues<Key extends string> = Partial<Record<Key, [WhereFilterOp, unknown] | [WhereFilterOp, unknown][]>>;
 /**
  * A pre-defined filter preset for quick access in the collection toolbar.
  * Users can select a preset to instantly apply a set of filters and

package/dist/types/src/types/entity_views.d.ts

@@ -56,41 +56,32 @@ export type EntityCustomView<M extends Record<string, unknown> = Record<string,
     Builder?: ComponentRef<EntityCustomViewParams<M>>;
     position?: "start" | "end";
 };
-export interface EntityCustomViewParams<M extends Record<string, unknown> = Record<string, unknown>> {
-    collection: EntityCollection<M>;
-    entity?: Entity<M>;
-    modifiedValues?: EntityValues<M>;
-    formContext: FormContext<M>;
-    parentCollectionSlugs?: string[];
-    parentEntityIds?: string[];
-}
 /**
- * Configuration for customizing the read-only detail view of an entity.
- * Only used when `defaultEntityAction` is set to `"view"` on the collection.
+ * Configuration to replace the default entity form with a custom component.
+ * The Builder receives the same props as entity view tabs (entity, formContext, etc.)
+ * and has full control over the UI.
+ *
+ * The form tab still appears in the tab bar but renders your Builder
+ * instead of the auto-generated field form.
+ *
  * @group Models
  */
-export type EntityDetailViewConfig<M extends Record<string, unknown> = Record<string, unknown>> = {
-    /**
-     * Custom component rendered above the property display in the detail view.
-     */
-    Header?: ComponentRef<EntityDetailViewParams<M>>;
+export type FormViewConfig<M extends Record<string, unknown> = Record<string, unknown>> = {
     /**
-     * Custom component rendered below the property display in the detail view.
+     * Custom component that replaces the default form.
      */
-    Footer?: ComponentRef<EntityDetailViewParams<M>>;
+    Builder: ComponentRef<EntityCustomViewParams<M>>;
     /**
-     * Completely replace the default detail view with a custom component.
-     * When set, Header and Footer are ignored.
+     * If true, the save/delete action bar is rendered alongside the custom view.
+     * Defaults to true.
      */
-    Builder?: ComponentRef<EntityDetailViewParams<M>>;
+    includeActions?: boolean;
 };
-/**
- * Props passed to detail view customization components (Header, Footer, Builder).
- * @group Models
- */
-export interface EntityDetailViewParams<M extends Record<string, unknown> = Record<string, unknown>> {
+export interface EntityCustomViewParams<M extends Record<string, unknown> = Record<string, unknown>> {
     collection: EntityCollection<M>;
-    entity: Entity<M>;
-    path: string;
-    onEditClick: () => void;
+    entity?: Entity<M>;
+    modifiedValues?: EntityValues<M>;
+    formContext: FormContext<M>;
+    parentCollectionSlugs?: string[];
+    parentEntityIds?: string[];
 }