@rebasepro/server-postgresql 0.4.0 → 0.5.0

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

@@ -1,13 +1,13 @@
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { PgTable, AnyPgColumn } from "drizzle-orm/pg-core";
+import type { RebasePgTable } from "../types";
 import { UserRepository, TokenRepository, MfaRepository, AuthRepository, UserData, CreateUserData, RoleData, CreateRoleData, RefreshTokenInfo, PasswordResetTokenInfo, UserIdentityData, ListUsersOptions, PaginatedUsersResult, MfaFactor, MfaChallengeInfo, RoleData as Role } from "@rebasepro/server-core";
 export type { Role };
 export interface AuthSchemaTables {
-    users: PgTable & Record<string, AnyPgColumn>;
-    refreshTokens: PgTable & Record<string, AnyPgColumn>;
-    passwordResetTokens: PgTable & Record<string, AnyPgColumn>;
-    appConfig: PgTable & Record<string, AnyPgColumn>;
-    userIdentities: PgTable & Record<string, AnyPgColumn>;
+    users: RebasePgTable;
+    refreshTokens: RebasePgTable;
+    passwordResetTokens: RebasePgTable;
+    appConfig: RebasePgTable;
+    userIdentities: RebasePgTable;
 }
 /**
  * PostgreSQL implementation of UserRepository.
@@ -17,7 +17,7 @@ export declare class UserService implements UserRepository {
     private db;
     private usersTable;
     private userIdentitiesTable;
-    constructor(db: NodePgDatabase, tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>);
+    constructor(db: NodePgDatabase, tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>);
     private getQualifiedUsersTableName;
     private mapRowToUser;
     private mapPayload;
@@ -74,7 +74,7 @@ export declare class UserService implements UserRepository {
 export declare class RefreshTokenService {
     private db;
     private refreshTokensTable;
-    constructor(db: NodePgDatabase, tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>);
+    constructor(db: NodePgDatabase, tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>);
     private getQualifiedRefreshTokensTableName;
     createToken(userId: string, tokenHash: string, expiresAt: Date, userAgent?: string, ipAddress?: string): Promise<void>;
     findByHash(tokenHash: string): Promise<RefreshTokenInfo | null>;
@@ -89,7 +89,7 @@ export declare class RefreshTokenService {
 export declare class PasswordResetTokenService {
     private db;
     private passwordResetTokensTable;
-    constructor(db: NodePgDatabase, tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>);
+    constructor(db: NodePgDatabase, tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>);
     private getQualifiedPasswordResetTokensTableName;
     /**
      * Create a password reset token
@@ -123,7 +123,7 @@ export declare class PostgresTokenRepository implements TokenRepository {
     private db;
     private refreshTokenService;
     private passwordResetTokenService;
-    constructor(db: NodePgDatabase, tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>);
+    constructor(db: NodePgDatabase, tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>);
     createRefreshToken(userId: string, tokenHash: string, expiresAt: Date, userAgent?: string, ipAddress?: string): Promise<void>;
     findRefreshTokenByHash(tokenHash: string): Promise<RefreshTokenInfo | null>;
     deleteRefreshToken(tokenHash: string): Promise<void>;
@@ -145,7 +145,7 @@ export declare class PostgresAuthRepository implements AuthRepository {
     private db;
     private userService;
     private tokenRepository;
-    constructor(db: NodePgDatabase, tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>);
+    constructor(db: NodePgDatabase, tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>);
     createUser(data: CreateUserData): Promise<UserData>;
     getUserById(id: string): Promise<UserData | null>;
     getUserByEmail(email: string): Promise<UserData | null>;

package/dist/server-postgresql/src/data-transformer.d.ts

@@ -42,9 +42,6 @@ export declare function serializePropertyToServer(value: unknown, property: Prop
  * Transform IDs back to relation objects for frontend
  */
 export declare function parseDataFromServer<M extends Record<string, unknown>>(data: M, collection: EntityCollection, db?: NodePgDatabase<Record<string, unknown>>, registry?: PostgresCollectionRegistry): Promise<M>;
-/**
- * Parse a single property value from database format to frontend format
- */
 export declare function parsePropertyFromServer(value: unknown, property: Property, collection: EntityCollection, propertyKey?: string): unknown;
 /**
  * Lightweight value normalization for db.query results.

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

@@ -6,7 +6,7 @@ export declare class DatabasePoolManager {
     readonly defaultDatabaseName: string;
     private readonly rootConnectionString;
     constructor(adminConnectionString: string);
-    getDrizzle(databaseName: string): NodePgDatabase<any>;
+    getDrizzle(databaseName: string): NodePgDatabase<Record<string, never>>;
     getPool(databaseName: string): Pool;
     /**
      * Disconnect and remove the pool for a specific database.

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/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/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()`.

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

@@ -343,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).
@@ -436,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[];

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

@@ -641,14 +641,6 @@ export interface MapProperty extends BaseProperty {
      * Properties that are displayed when rendered as a preview
      */
     previewProperties?: string[];
-    /**
-     * Allow the user to add only some keys in this map.
-     * By default, all properties of the map have the corresponding field in
-     * the form view. Setting this flag to true allows to pick only some.
-     * Useful for map that can have a lot of sub-properties that may not be
-     * needed
-     */
-    pickOnlySomeKeys?: boolean;
     /**
      * Render this map as a key-value table that allows to use
      * arbitrary keys. You don't need to define the properties in this case.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rebasepro/server-postgresql",
   "type": "module",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "PostgreSQL data source backend implementation for Rebase with Drizzle ORM",
   "funding": {
     "url": "https://github.com/sponsors/rebaseco"
@@ -68,11 +68,11 @@
     "hono": "^4.12.21",
     "pg": "^8.21.0",
     "ws": "^8.20.1",
-    "@rebasepro/sdk-generator": "0.4.0",
-    "@rebasepro/server-core": "0.4.0",
-    "@rebasepro/types": "0.4.0",
-    "@rebasepro/common": "0.4.0",
-    "@rebasepro/utils": "0.4.0"
+    "@rebasepro/sdk-generator": "0.5.0",
+    "@rebasepro/server-core": "0.5.0",
+    "@rebasepro/types": "0.5.0",
+    "@rebasepro/utils": "0.5.0",
+    "@rebasepro/common": "0.5.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",

package/src/PostgresBackendDriver.ts

@@ -1079,7 +1079,7 @@ roles: this.user?.roles ?? [] };
     }
 
     async deleteAll(path: string): Promise<void> {
-        return this.delegate.deleteAll(path);
+        return this.withTransaction((delegate) => delegate.deleteAll(path));
     }
 
     async checkUniqueField(

package/src/PostgresBootstrapper.ts

@@ -6,7 +6,8 @@
 
 import { getTableName, isTable, Relations, sql, Table } from "drizzle-orm";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { PgEnum, PgTable, getTableConfig, AnyPgColumn } from "drizzle-orm/pg-core";
+import { PgEnum, PgTable, getTableConfig } from "drizzle-orm/pg-core";
+import type { RebasePgTable } from "./types";
 import {
     BackendBootstrapper,
     InitializedDriver,
@@ -207,7 +208,7 @@ export function createPostgresBootstrapper(pgConfig: PostgresDriverConfig): Back
                     : authCollection.slug)
                 : undefined;
             const usersTable = tableName
-                ? registry.getTable(tableName) as (PgTable & Record<string, AnyPgColumn>) | undefined
+                ? registry.getTable(tableName) as RebasePgTable | undefined
                 : undefined;
 
             let usersSchemaName = "rebase";
@@ -217,7 +218,7 @@ export function createPostgresBootstrapper(pgConfig: PostgresDriverConfig): Back
 
             const authTables = createAuthSchema(usersSchemaName) as unknown as AuthSchemaTables;
             if (usersTable) {
-                authTables.users = usersTable as unknown as PgTable & Record<string, AnyPgColumn>;
+                authTables.users = usersTable as RebasePgTable;
             }
 
             const userService = new UserService(db, authTables);

package/src/auth/services.ts

@@ -1,6 +1,7 @@
 import { eq, getTableName, sql } from "drizzle-orm";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { getTableConfig, PgTable, AnyPgColumn } from "drizzle-orm/pg-core";
+import { getTableConfig } from "drizzle-orm/pg-core";
+import type { RebasePgTable } from "../types";
 import { users, refreshTokens, passwordResetTokens, userIdentities } from "../schema/auth-schema";
 import {
     UserRepository,
@@ -27,14 +28,14 @@ import { toSnakeCase, camelCase } from "@rebasepro/utils";
 export type { Role };
 
 export interface AuthSchemaTables {
-    users: PgTable & Record<string, AnyPgColumn>;
-    refreshTokens: PgTable & Record<string, AnyPgColumn>;
-    passwordResetTokens: PgTable & Record<string, AnyPgColumn>;
-    appConfig: PgTable & Record<string, AnyPgColumn>;
-    userIdentities: PgTable & Record<string, AnyPgColumn>;
+    users: RebasePgTable;
+    refreshTokens: RebasePgTable;
+    passwordResetTokens: RebasePgTable;
+    appConfig: RebasePgTable;
+    userIdentities: RebasePgTable;
 }
 
-function getColumnKey(table: (PgTable & Record<string, AnyPgColumn>) | undefined, ...keys: string[]): string | undefined {
+function getColumnKey(table: RebasePgTable | undefined, ...keys: string[]): string | undefined {
     if (!table) return undefined;
     for (const key of keys) {
         if (key in table) return key;
@@ -46,7 +47,7 @@ function getColumnKey(table: (PgTable & Record<string, AnyPgColumn>) | undefined
     return undefined;
 }
 
-function getColumn(table: (PgTable & Record<string, AnyPgColumn>) | undefined, ...keys: string[]): AnyPgColumn | undefined {
+function getColumn(table: RebasePgTable | undefined, ...keys: string[]): RebasePgTable[string] | undefined {
     if (!table) return undefined;
     const key = getColumnKey(table, ...keys);
     return key ? table[key] : undefined;
@@ -57,21 +58,21 @@ function getColumn(table: (PgTable & Record<string, AnyPgColumn>) | undefined, .
  * Handles all user-related database operations using Drizzle ORM.
  */
 export class UserService implements UserRepository {
-    private usersTable: PgTable & Record<string, AnyPgColumn>;
-    private userIdentitiesTable: PgTable & Record<string, AnyPgColumn>;
+    private usersTable: RebasePgTable;
+    private userIdentitiesTable: RebasePgTable;
 
     constructor(
         private db: NodePgDatabase,
-        tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>
+        tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>
     ) {
         if (tableOrTables && ((tableOrTables as Partial<AuthSchemaTables>).users)) {
             const tables = tableOrTables as Partial<AuthSchemaTables>;
-            this.usersTable = (tables.users || users) as unknown as PgTable & Record<string, AnyPgColumn>;
-            this.userIdentitiesTable = (tables.userIdentities || userIdentities) as unknown as PgTable & Record<string, AnyPgColumn>;
+            this.usersTable = (tables.users || users) as RebasePgTable;
+            this.userIdentitiesTable = (tables.userIdentities || userIdentities) as RebasePgTable;
         } else {
-            const table = tableOrTables as (PgTable & Record<string, AnyPgColumn>) | undefined;
-            this.usersTable = table || (users as unknown as PgTable & Record<string, AnyPgColumn>);
-            this.userIdentitiesTable = userIdentities as unknown as PgTable & Record<string, AnyPgColumn>;
+            const table = tableOrTables as RebasePgTable | undefined;
+            this.usersTable = table || (users as unknown as RebasePgTable);
+            this.userIdentitiesTable = userIdentities as unknown as RebasePgTable;
         }
     }
 
@@ -82,7 +83,7 @@ export class UserService implements UserRepository {
     }
 
     private mapRowToUser(row: Record<string, unknown>): UserData {
-        if (!row) return row as unknown as UserData;
+        if (!row) return row as UserData;
 
         const id = (row.id ?? row.uid) as string;
         const email = row.email as string;
@@ -497,16 +498,16 @@ export class UserService implements UserRepository {
 
 
 export class RefreshTokenService {
-    private refreshTokensTable: PgTable & Record<string, AnyPgColumn>;
+    private refreshTokensTable: RebasePgTable;
 
     constructor(
         private db: NodePgDatabase,
-        tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>
+        tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>
     ) {
         if (tableOrTables && ((tableOrTables as Partial<AuthSchemaTables>).refreshTokens || (tableOrTables as Partial<AuthSchemaTables>).users)) {
-            this.refreshTokensTable = ((tableOrTables as Partial<AuthSchemaTables>).refreshTokens || refreshTokens) as unknown as PgTable & Record<string, AnyPgColumn>;
+            this.refreshTokensTable = ((tableOrTables as Partial<AuthSchemaTables>).refreshTokens || refreshTokens) as RebasePgTable;
         } else {
-            this.refreshTokensTable = (tableOrTables as unknown as PgTable & Record<string, AnyPgColumn>) || (refreshTokens as unknown as PgTable & Record<string, AnyPgColumn>);
+            this.refreshTokensTable = (tableOrTables as RebasePgTable) || (refreshTokens as unknown as RebasePgTable);
         }
     }
 
@@ -595,16 +596,16 @@ export class RefreshTokenService {
  * Password reset token service
  */
 export class PasswordResetTokenService {
-    private passwordResetTokensTable: PgTable & Record<string, AnyPgColumn>;
+    private passwordResetTokensTable: RebasePgTable;
 
     constructor(
         private db: NodePgDatabase,
-        tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>
+        tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>
     ) {
         if (tableOrTables && ((tableOrTables as Partial<AuthSchemaTables>).passwordResetTokens || (tableOrTables as Partial<AuthSchemaTables>).users)) {
-            this.passwordResetTokensTable = ((tableOrTables as Partial<AuthSchemaTables>).passwordResetTokens || passwordResetTokens) as unknown as PgTable & Record<string, AnyPgColumn>;
+            this.passwordResetTokensTable = ((tableOrTables as Partial<AuthSchemaTables>).passwordResetTokens || passwordResetTokens) as RebasePgTable;
         } else {
-            this.passwordResetTokensTable = (tableOrTables as unknown as PgTable & Record<string, AnyPgColumn>) || (passwordResetTokens as unknown as PgTable & Record<string, AnyPgColumn>);
+            this.passwordResetTokensTable = (tableOrTables as RebasePgTable) || (passwordResetTokens as unknown as RebasePgTable);
         }
     }
 
@@ -704,7 +705,7 @@ export class PostgresTokenRepository implements TokenRepository {
 
     constructor(
         private db: NodePgDatabase,
-        tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>
+        tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>
     ) {
         this.refreshTokenService = new RefreshTokenService(db, tableOrTables);
         this.passwordResetTokenService = new PasswordResetTokenService(db, tableOrTables);
@@ -770,7 +771,7 @@ export class PostgresAuthRepository implements AuthRepository {
 
     constructor(
         private db: NodePgDatabase,
-        tableOrTables?: (PgTable & Record<string, AnyPgColumn>) | Partial<AuthSchemaTables>
+        tableOrTables?: RebasePgTable | Partial<AuthSchemaTables>
     ) {
         this.userService = new UserService(db, tableOrTables);
         this.tokenRepository = new PostgresTokenRepository(db, tableOrTables);

package/src/cli.ts

@@ -436,15 +436,28 @@ async function runDrizzleKit(action: string, _rawArgs: string[]): Promise<void>
         // dotenv may not be available — fall through
     }
 
-    const interactive = ["generate", "push"].includes(action);
+    const interactive = ["generate", "push"].includes(action) && Boolean(process.stdout.isTTY);
 
     // For push: always use --strict (prompts before destructive ops) and --verbose
     // (shows all SQL). This ensures unmapped tables are never silently dropped.
     const drizzleKitArgs = [action];
     if (action === "push") {
         drizzleKitArgs.push("--strict", "--verbose");
-        if (_rawArgs.includes("--force")) {
-            drizzleKitArgs.push("--force");
+    }
+
+    // Forward any additional arguments, excluding schema-generator-specific options
+    const excludedFlags = ["--collections", "-c", "--output", "-o", "--watch", "-w"];
+    for (let i = 2; i < _rawArgs.length; i++) {
+        const arg = _rawArgs[i];
+        if (excludedFlags.includes(arg)) {
+            // Skip this flag and its value if it takes a parameter
+            if (["--collections", "-c", "--output", "-o"].includes(arg)) {
+                i++; // Skip the next arg (the value)
+            }
+            continue;
+        }
+        if (!drizzleKitArgs.includes(arg)) {
+            drizzleKitArgs.push(arg);
         }
     }
 
@@ -456,7 +469,7 @@ async function runDrizzleKit(action: string, _rawArgs: string[]): Promise<void>
                 env
             });
         } else {
-            const child = execa(drizzleKitBin, [action], {
+            const child = execa(drizzleKitBin, drizzleKitArgs, {
                 cwd: process.cwd(),
                 env,
                 reject: false
@@ -473,20 +486,28 @@ async function runDrizzleKit(action: string, _rawArgs: string[]): Promise<void>
             const stdout = stripAnsi(result.stdout || "").trim();
             const stderr = stripAnsi(result.stderr || "").trim();
 
-            if (result.exitCode !== 0) {
+            const hasTtyError = stdout.includes("Interactive prompts require a TTY terminal") || 
+                               stderr.includes("Interactive prompts require a TTY terminal");
+
+            if (result.exitCode !== 0 || hasTtyError) {
                 console.error(chalk.red(`\n✗ drizzle-kit ${action} failed.\n`));
-                const errorOutput = stderr || stdout;
-                if (errorOutput) {
-                    const lines = errorOutput.split("\n").filter((l: string) => l.trim());
-                    let printedCount = 0;
-                    for (const line of lines) {
-                        if (line.toLowerCase().includes("error") || line.includes("cannot") || line.includes("already exists") || line.includes("does not exist") || line.includes("violates") || line.includes("permission denied")) {
-                            console.error(chalk.red(`  ${line.trim()}`));
-                            printedCount++;
+                if (hasTtyError) {
+                    console.error(chalk.red("  Error: Interactive prompts require a TTY terminal."));
+                    console.error(chalk.gray("  Please run with --force to skip interactive prompts or run in an interactive terminal."));
+                } else {
+                    const errorOutput = stderr || stdout;
+                    if (errorOutput) {
+                        const lines = errorOutput.split("\n").filter((l: string) => l.trim());
+                        let printedCount = 0;
+                        for (const line of lines) {
+                            if (line.toLowerCase().includes("error") || line.includes("cannot") || line.includes("already exists") || line.includes("does not exist") || line.includes("violates") || line.includes("permission denied")) {
+                                console.error(chalk.red(`  ${line.trim()}`));
+                                printedCount++;
+                            }
+                        }
+                        if (printedCount === 0) {
+                            lines.slice(0, 10).forEach(line => console.error(chalk.red(`  ${line.trim()}`)));
                         }
-                    }
-                    if (printedCount === 0) {
-                        lines.slice(0, 10).forEach(line => console.error(chalk.red(`  ${line.trim()}`)));
                     }
                 }
                 console.error("");
@@ -498,15 +519,21 @@ async function runDrizzleKit(action: string, _rawArgs: string[]): Promise<void>
         // eslint-disable-next-line no-control-regex
         const stripAnsi = (s: string) => s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").replace(/\[?[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⣷⣯⣟⡿⢿⣻⣽]+\]\s*/g, "");
         const cleaned = stripAnsi(msg).trim();
+        const hasTtyError = cleaned.includes("Interactive prompts require a TTY terminal");
         console.error(chalk.red(`\n✗ drizzle-kit ${action} failed.\n`));
-        const lines = cleaned.split("\n").filter((l: string) => l.trim());
-        for (const line of lines) {
-            if (line.toLowerCase().includes("error") || line.includes("cannot") || line.includes("already exists") || line.includes("does not exist") || line.includes("violates")) {
-                console.error(chalk.red(`  ${line.trim()}`));
+        if (hasTtyError) {
+            console.error(chalk.red("  Error: Interactive prompts require a TTY terminal."));
+            console.error(chalk.gray("  Please run with --force to skip interactive prompts or run in an interactive terminal."));
+        } else {
+            const lines = cleaned.split("\n").filter((l: string) => l.trim());
+            for (const line of lines) {
+                if (line.toLowerCase().includes("error") || line.includes("cannot") || line.includes("already exists") || line.includes("does not exist") || line.includes("violates")) {
+                    console.error(chalk.red(`  ${line.trim()}`));
+                }
+            }
+            if (lines.length === 0) {
+                console.error(chalk.gray(`  ${cleaned}`));
             }
-        }
-        if (lines.length === 0) {
-            console.error(chalk.gray(`  ${cleaned}`));
         }
         console.error("");
         process.exit(1);