turbine-orm 0.19.1 → 0.21.0

package/dist/cjs/cli/studio.js

@@ -34,7 +34,6 @@ exports.apiBuilder = apiBuilder;
 exports.apiListSavedQueries = apiListSavedQueries;
 exports.apiCreateSavedQuery = apiCreateSavedQuery;
 exports.apiDeleteSavedQuery = apiDeleteSavedQuery;
-exports.isReadOnlyStatement = isReadOnlyStatement;
 const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
@@ -238,13 +237,12 @@ function checkRateLimit(limiter, token) {
     return { allowed: true, resetAt: entry.resetAt };
 }
 function constantTimeEqual(a, b) {
-    if (a.length !== b.length)
-        return false;
-    let result = 0;
-    for (let i = 0; i < a.length; i++) {
-        result |= a.charCodeAt(i) ^ b.charCodeAt(i);
-    }
-    return result === 0;
+    // Hash both inputs to fixed-length 32-byte SHA-256 digests before comparing.
+    // This makes the comparison constant-length (timingSafeEqual never throws on a
+    // length mismatch) and leaks neither length nor content via timing.
+    const ah = (0, node_crypto_1.createHash)('sha256').update(a).digest();
+    const bh = (0, node_crypto_1.createHash)('sha256').update(b).digest();
+    return (0, node_crypto_1.timingSafeEqual)(ah, bh);
 }
 /**
  * Build a helpful "unknown table" error that lists the available tables so the
@@ -550,35 +548,6 @@ function clampInt(value, fallback, min, max) {
         return fallback;
     return Math.min(Math.max(n, min), max);
 }
-/**
- * Accept only SELECT or WITH (CTE) statements. Reject any statement that
- * contains a semicolon followed by non-whitespace (prevents statement
- * stacking), and require the first non-comment keyword to be SELECT or WITH.
- *
- * This is a first-line filter — the transaction's READ ONLY mode is the
- * second line of defense. Both must fail before a destructive statement
- * could run.
- */
-function isReadOnlyStatement(sql) {
-    const stripped = stripSqlComments(sql).trim();
-    if (!stripped)
-        return false;
-    // Disallow statement stacking. A single trailing `;` is fine.
-    const withoutTrailingSemi = stripped.replace(/;+\s*$/, '');
-    if (withoutTrailingSemi.includes(';'))
-        return false;
-    const firstWord = withoutTrailingSemi.slice(0, 6).toUpperCase();
-    if (firstWord.startsWith('SELECT'))
-        return true;
-    if (firstWord.startsWith('WITH'))
-        return true;
-    return false;
-}
-function stripSqlComments(sql) {
-    // Strip -- line comments and /* block comments */. Not a full SQL parser,
-    // but sufficient to catch the common bypass attempts.
-    return sql.replace(/--[^\n]*/g, '').replace(/\/\*[\s\S]*?\*\//g, '');
-}
 function serializeRow(row) {
     const out = {};
     for (const [k, v] of Object.entries(row)) {

package/dist/cjs/client.js

@@ -29,6 +29,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TurbineClient = exports.TransactionClient = void 0;
 exports.withRetry = withRetry;
 const pg_1 = __importDefault(require("pg"));
+const dialect_js_1 = require("./dialect.js");
 const errors_js_1 = require("./errors.js");
 const observe_js_1 = require("./observe.js");
 const pipeline_js_1 = require("./pipeline.js");
@@ -89,11 +90,14 @@ class TransactionClient {
     queryOptions;
     tableCache = new Map();
     savepointCounter = 0;
+    /** Active SQL dialect — owns savepoint keywords and raw-SQL placeholders. */
+    dialect;
     constructor(client, schema, middlewares, queryOptions) {
         this.client = client;
         this.schema = schema;
         this.middlewares = middlewares;
         this.queryOptions = queryOptions;
+        this.dialect = queryOptions?.dialect ?? dialect_js_1.postgresDialect;
         // Auto-create typed table accessors for all tables in the schema
         for (const tableName of Object.keys(schema.tables)) {
             const camelName = tableName.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
@@ -127,14 +131,14 @@ class TransactionClient {
      */
     async $transaction(fn) {
         const savepointName = `sp_${++this.savepointCounter}`;
-        await this.client.query(`SAVEPOINT ${savepointName}`);
+        await this.client.query(this.dialect.savepointStatement(savepointName));
         try {
             const result = await fn(this);
-            await this.client.query(`RELEASE SAVEPOINT ${savepointName}`);
+            await this.client.query(this.dialect.releaseSavepointStatement(savepointName));
             return result;
         }
         catch (err) {
-            await this.client.query(`ROLLBACK TO SAVEPOINT ${savepointName}`);
+            await this.client.query(this.dialect.rollbackToSavepointStatement(savepointName));
             throw err;
         }
     }
@@ -146,7 +150,7 @@ class TransactionClient {
         strings.forEach((str, i) => {
             sql += str;
             if (i < values.length) {
-                sql += `$${i + 1}`;
+                sql += this.dialect.paramPlaceholder(i + 1);
             }
         });
         try {
@@ -200,6 +204,8 @@ class TurbineClient {
     schema;
     static int8ParserRegistered = false;
     logging;
+    /** Active SQL dialect — owns transaction keywords, set_config, raw-SQL placeholders, capability flags. */
+    dialect;
     tableCache = new Map();
     middlewares = [];
     queryListeners = new Set();
@@ -245,6 +251,7 @@ class TurbineClient {
             TurbineClient.int8ParserRegistered = true;
         }
         this.logging = config.logging ?? false;
+        this.dialect = config.dialect ?? dialect_js_1.postgresDialect;
         this.schema = schema;
         // Respect env var kill switch
         const envDisablePrepared = typeof process !== 'undefined' && process.env?.TURBINE_DISABLE_PREPARED === '1';
@@ -331,12 +338,14 @@ class TurbineClient {
     // Middleware — intercept all queries
     // -------------------------------------------------------------------------
     /**
-     * Register a middleware function that runs before/after every query.
+     * Register a middleware function that runs around every query.
      *
-     * Middleware can inspect and log query parameters, modify results after execution,
-     * and measure timing. Note: query SQL is generated before middleware runs, so
-     * modifying params.args in middleware will NOT affect the executed SQL.
-     * To intercept queries before SQL generation, use the raw() method instead.
+     * Middleware can inspect and log query parameters, measure timing, and
+     * transform the result returned by `next()`. Note: query SQL is generated
+     * BEFORE middleware runs — `params.args` is a read-only snapshot, and
+     * mutating it does NOT change the executed SQL. Cross-cutting filters
+     * (e.g. soft deletes) belong in the query itself: pass an explicit
+     * `where: { deletedAt: null }` or wrap the table accessor in a small helper.
      *
      * @example
      * ```ts
@@ -348,16 +357,13 @@ class TurbineClient {
      *   return result;
      * });
      *
-     * // Soft-delete middleware
+     * // Result transformation middleware — redact a field on the way out
      * db.$use(async (params, next) => {
-     *   if (params.action === 'findMany' || params.action === 'findUnique') {
-     *     params.args.where = { ...params.args.where, deletedAt: null };
-     *   }
-     *   if (params.action === 'delete') {
-     *     params.action = 'update';
-     *     params.args = { where: params.args.where, data: { deletedAt: new Date() } };
+     *   const result = await next(params);
+     *   if (params.model === 'users' && Array.isArray(result)) {
+     *     for (const row of result as { email?: string }[]) row.email = '[redacted]';
      *   }
-     *   return next(params);
+     *   return result;
      * });
      * ```
      */
@@ -474,7 +480,7 @@ class TurbineClient {
         strings.forEach((str, i) => {
             sql += str;
             if (i < values.length) {
-                sql += `$${i + 1}`;
+                sql += this.dialect.paramPlaceholder(i + 1);
             }
         });
         if (this.logging) {
@@ -519,7 +525,7 @@ class TurbineClient {
      * ```
      */
     sql(strings, ...values) {
-        const { sql, params } = (0, typed_sql_js_1.buildTypedSql)(strings, values);
+        const { sql, params } = (0, typed_sql_js_1.buildTypedSql)(strings, values, this.dialect);
         return new typed_sql_js_1.TypedSqlQuery(this.pool, sql, params, this.logging);
     }
     // -------------------------------------------------------------------------
@@ -539,13 +545,13 @@ class TurbineClient {
     async transaction(fn) {
         const client = await this.pool.connect();
         try {
-            await client.query('BEGIN');
+            await client.query(this.dialect.beginStatement());
             const result = await fn(client);
-            await client.query('COMMIT');
+            await client.query(this.dialect.commitStatement());
             return result;
         }
         catch (err) {
-            await client.query('ROLLBACK');
+            await client.query(this.dialect.rollbackStatement());
             throw err;
         }
         finally {
@@ -596,14 +602,10 @@ class TurbineClient {
         };
         let timedOut = false;
         try {
-            // BEGIN with optional isolation level
-            let beginSQL = 'BEGIN';
-            if (options?.isolationLevel) {
-                const level = ISOLATION_LEVELS[options.isolationLevel];
-                if (level)
-                    beginSQL += ` ISOLATION LEVEL ${level}`;
-            }
-            await client.query(beginSQL);
+            // BEGIN with optional isolation level — the dialect owns the keyword and
+            // BEGIN+isolation composition (Postgres appends ` ISOLATION LEVEL …`).
+            const isolationSql = options?.isolationLevel ? ISOLATION_LEVELS[options.isolationLevel] : undefined;
+            await client.query(this.dialect.beginStatement(isolationSql));
             // Apply transaction-local session context (RLS / multi-tenant GUCs).
             // Order matters: BEGIN -> isolation level (above) -> set_config loop ->
             // user fn. Any error here propagates to the catch below and rolls back
@@ -611,12 +613,16 @@ class TurbineClient {
             // is_local=true) — the parameterizable, transaction-scoped equivalent of
             // SET LOCAL — so both name and value are BOUND params, never interpolated.
             if (options?.sessionContext) {
+                if (!this.dialect.supportsRLS) {
+                    throw new errors_js_1.UnsupportedFeatureError('sessionContext (RLS session GUCs)', this.dialect.name, 'set_config-based row-level-security context requires PostgreSQL.');
+                }
                 for (const [name, value] of Object.entries(options.sessionContext)) {
                     if (!GUC_NAME_REGEX.test(name)) {
                         throw new errors_js_1.ValidationError(`[turbine] Invalid session-context GUC name "${name}" — must match ` +
                             '/^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)?$/ (optionally namespaced, e.g. "app.current_tenant")');
                     }
-                    await client.query('SELECT set_config($1, $2, true)', [name, String(value)]);
+                    const cfg = this.dialect.buildSetSessionConfig(name, String(value));
+                    await client.query(cfg.sql, cfg.params);
                 }
             }
             // Create the transaction client with typed table accessors
@@ -662,7 +668,7 @@ class TurbineClient {
             else {
                 result = await fn(tx);
             }
-            await client.query('COMMIT');
+            await client.query(this.dialect.commitStatement());
             if (this.logging) {
                 console.log('[turbine] Transaction committed');
             }
@@ -675,7 +681,7 @@ class TurbineClient {
             // when its socket was closed).
             if (!timedOut && !released) {
                 try {
-                    await client.query('ROLLBACK');
+                    await client.query(this.dialect.rollbackStatement());
                 }
                 catch {
                     // Best-effort rollback — the connection may have died mid-query.
@@ -742,6 +748,9 @@ class TurbineClient {
      * ```
      */
     async $listen(channel, handler) {
+        if (!this.dialect.supportsListenNotify) {
+            throw new errors_js_1.UnsupportedFeatureError('$listen (LISTEN/NOTIFY realtime)', this.dialect.name, 'Realtime pub/sub requires PostgreSQL.');
+        }
         (0, realtime_js_1.validateChannel)(channel);
         const quoted = (0, utils_js_1.quoteIdent)(channel);
         if (this.logging) {
@@ -767,6 +776,9 @@ class TurbineClient {
      * ```
      */
     async $notify(channel, payload) {
+        if (!this.dialect.supportsListenNotify) {
+            throw new errors_js_1.UnsupportedFeatureError('$notify (LISTEN/NOTIFY realtime)', this.dialect.name, 'Realtime pub/sub requires PostgreSQL.');
+        }
         (0, realtime_js_1.validateChannel)(channel);
         if (this.logging) {
             console.log(`[turbine] NOTIFY ${channel}`);

package/dist/cjs/dialect.js

@@ -6,6 +6,39 @@
  * PostgreSQL-native by default, but query generation now depends on this
  * contract for the SQL primitives that vary across MySQL and SQLite.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.postgresDialect = void 0;
 const errors_js_1 = require("./errors.js");
@@ -13,11 +46,17 @@ const schema_js_1 = require("./schema.js");
 /** PostgreSQL implementation of the dialect contract. */
 exports.postgresDialect = {
     name: 'postgresql',
+    resultStrategy: 'returning',
     supportsReturning: true,
     supportsILike: true,
     jsonPathSupport: 'native',
     emptyJsonArrayLiteral: "'[]'::json",
     nullJsonLiteral: 'NULL',
+    aggSupportsInlineOrderBy: true,
+    supportsVector: true,
+    supportsListenNotify: true,
+    supportsRLS: true,
+    supportsAdvisoryLock: true,
     paramPlaceholder(index) {
         return `$${index}`;
     },
@@ -35,6 +74,9 @@ exports.postgresDialect = {
         const suffix = orderBy ? ` ${orderBy}` : '';
         return `COALESCE(json_agg(${jsonObjectExpr}${suffix}), ${this.emptyJsonArrayLiteral})`;
     },
+    wrapJsonSubresult(subquery, fallback) {
+        return `COALESCE((${subquery}), ${fallback})`;
+    },
     buildReturningClause(selection = '*') {
         return ` RETURNING ${selection}`;
     },
@@ -76,6 +118,15 @@ exports.postgresDialect = {
     typeToTypeScript(dialectType, nullable) {
         return (0, schema_js_1.pgTypeToTs)(dialectType, nullable);
     },
+    castAggregate(expr, target) {
+        return `${expr}::${target}`;
+    },
+    buildInClause(expr, paramRef, negated) {
+        return negated ? `${expr} != ALL(${paramRef})` : `${expr} = ANY(${paramRef})`;
+    },
+    inClauseParam(values) {
+        return values;
+    },
     arrayType(baseType) {
         return (0, schema_js_1.pgArrayType)(baseType);
     },
@@ -131,4 +182,69 @@ exports.postgresDialect = {
     buildMigrationDeleteApplied(table) {
         return `DELETE FROM ${table} WHERE name = ${this.paramPlaceholder(1)}`;
     },
+    beginStatement(isolationLevel) {
+        return isolationLevel ? `BEGIN ISOLATION LEVEL ${isolationLevel}` : 'BEGIN';
+    },
+    commitStatement() {
+        return 'COMMIT';
+    },
+    rollbackStatement() {
+        return 'ROLLBACK';
+    },
+    savepointStatement(name) {
+        return `SAVEPOINT ${name}`;
+    },
+    releaseSavepointStatement(name) {
+        return `RELEASE SAVEPOINT ${name}`;
+    },
+    rollbackToSavepointStatement(name) {
+        return `ROLLBACK TO SAVEPOINT ${name}`;
+    },
+    buildSetSessionConfig(name, value) {
+        // set_config(name, value, is_local=true) — the parameterizable,
+        // transaction-local equivalent of `SET LOCAL` (which rejects bind params).
+        return {
+            sql: `SELECT set_config(${this.paramPlaceholder(1)}, ${this.paramPlaceholder(2)}, true)`,
+            params: [name, value],
+        };
+    },
+    async *openStream(connection, sql, params, batchSize) {
+        // Cursors require a single connection inside a transaction. Identical SQL
+        // sequence to the historical inline implementation: BEGIN → DECLARE … NO
+        // SCROLL CURSOR FOR → FETCH n (loop) → CLOSE → COMMIT; ROLLBACK on error.
+        const cursorName = `turbine_cursor_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const quotedCursor = this.quoteIdentifier(cursorName);
+        await connection.query(this.beginStatement());
+        try {
+            await connection.query(`DECLARE ${quotedCursor} NO SCROLL CURSOR FOR ${sql}`, params);
+            while (true) {
+                const batch = await connection.query(`FETCH ${batchSize} FROM ${quotedCursor}`);
+                if (batch.rows.length === 0)
+                    break;
+                yield batch.rows;
+                if (batch.rows.length < batchSize)
+                    break;
+            }
+            await connection.query(`CLOSE ${quotedCursor}`);
+            await connection.query(this.commitStatement());
+        }
+        catch (err) {
+            try {
+                await connection.query(this.rollbackStatement());
+            }
+            catch {
+                // Connection may already be broken — ignore rollback error.
+            }
+            throw err;
+        }
+    },
+    // Postgres introspection wraps the information_schema / pg_catalog reader in
+    // introspect.ts. A dynamic import keeps the static graph acyclic (introspect.ts
+    // imports postgresDialect) and calls the raw catalog reader (never the router).
+    introspector: {
+        async introspect(options) {
+            const { introspectPostgresCatalog } = await Promise.resolve().then(() => __importStar(require('./introspect.js')));
+            return introspectPostgresCatalog(options);
+        },
+    },
 };

package/dist/cjs/errors.js

@@ -6,7 +6,7 @@
  * All Turbine errors extend TurbineError which includes a `code` property.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OptimisticLockError = exports.PipelineError = exports.ExclusionConstraintError = exports.CheckConstraintError = exports.SerializationFailureError = exports.DeadlockError = exports.NotNullViolationError = exports.ForeignKeyError = exports.UniqueConstraintError = exports.CircularRelationError = exports.MigrationError = exports.RelationError = exports.ConnectionError = exports.ValidationError = exports.TimeoutError = exports.NotFoundError = exports.TurbineError = exports.TurbineErrorCode = void 0;
+exports.UnsupportedFeatureError = exports.OptimisticLockError = exports.PipelineError = exports.ExclusionConstraintError = exports.CheckConstraintError = exports.SerializationFailureError = exports.DeadlockError = exports.NotNullViolationError = exports.ForeignKeyError = exports.UniqueConstraintError = exports.CircularRelationError = exports.MigrationError = exports.RelationError = exports.ConnectionError = exports.ValidationError = exports.TimeoutError = exports.NotFoundError = exports.TurbineError = exports.TurbineErrorCode = void 0;
 exports.setErrorMessageMode = setErrorMessageMode;
 exports.getErrorMessageMode = getErrorMessageMode;
 exports.wrapPgError = wrapPgError;
@@ -28,6 +28,7 @@ exports.TurbineErrorCode = {
     PIPELINE: 'TURBINE_E014',
     OPTIMISTIC_LOCK: 'TURBINE_E015',
     EXCLUSION_VIOLATION: 'TURBINE_E016',
+    UNSUPPORTED_FEATURE: 'TURBINE_E017',
 };
 /** Base error class for all Turbine errors */
 class TurbineError extends Error {
@@ -458,6 +459,23 @@ class OptimisticLockError extends TurbineError {
     }
 }
 exports.OptimisticLockError = OptimisticLockError;
+/**
+ * Thrown when a Postgres-only feature (pgvector distance ops, LISTEN/NOTIFY
+ * realtime, RLS session GUCs, advisory-lock migration locking, ...) is invoked
+ * on a dialect/engine whose capability flag reports it unsupported. Surfaces a
+ * clear `unsupported on <engine>` message instead of generating broken SQL.
+ */
+class UnsupportedFeatureError extends TurbineError {
+    feature;
+    dialect;
+    constructor(feature, dialect, hint) {
+        super(exports.TurbineErrorCode.UNSUPPORTED_FEATURE, `[turbine] ${feature} is unsupported on "${dialect}".${hint ? ` ${hint}` : ''}`);
+        this.name = 'UnsupportedFeatureError';
+        this.feature = feature;
+        this.dialect = dialect;
+    }
+}
+exports.UnsupportedFeatureError = UnsupportedFeatureError;
 /**
  * Parse column names out of a pg `detail` string like:
  *   "Key (email)=(foo@bar) already exists."

package/dist/cjs/generate.js

@@ -363,6 +363,10 @@ function generateMetadata(schema) {
     lines.push('  },');
     lines.push('};');
     lines.push('');
+    // Back-compat lowercase alias. `SCHEMA` is the canonical export, but docs and
+    // users frequently import `schema`; emit both so either name resolves.
+    lines.push('export const schema = SCHEMA;');
+    lines.push('');
     return lines.join('\n');
 }
 // ---------------------------------------------------------------------------

package/dist/cjs/index.js

@@ -34,8 +34,8 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.column = exports.ColumnBuilder = exports.applyManyToManyRelations = exports.snakeToPascal = exports.snakeToCamel = exports.singularize = exports.pgTypeToTs = exports.pgArrayType = exports.normalizeKeyColumns = exports.isDateType = exports.camelToSnake = exports.validateChannel = exports.QueryInterface = exports.pipelineSupported = exports.executePipeline = exports.hasRelationFields = exports.executeNestedUpdate = exports.executeNestedCreate = exports.introspect = exports.generate = exports.wrapPgError = exports.ValidationError = exports.UniqueConstraintError = exports.TurbineErrorCode = exports.TurbineError = exports.TimeoutError = exports.setErrorMessageMode = exports.SerializationFailureError = exports.RelationError = exports.PipelineError = exports.OptimisticLockError = exports.NotNullViolationError = exports.NotFoundError = exports.MigrationError = exports.getErrorMessageMode = exports.ForeignKeyError = exports.ExclusionConstraintError = exports.DeadlockError = exports.ConnectionError = exports.CircularRelationError = exports.CheckConstraintError = exports.postgresDialect = exports.withRetry = exports.TurbineClient = exports.TransactionClient = exports.yugabytedb = exports.timescale = exports.postgresql = exports.cockroachdb = exports.alloydb = void 0;
-exports.TypedSqlQuery = exports.buildTypedSql = exports.turbineHttp = exports.schemaToSQLString = exports.schemaToSQL = exports.schemaPush = exports.schemaDiff = exports.table = exports.defineSchema = void 0;
+exports.ColumnBuilder = exports.applyManyToManyRelations = exports.snakeToPascal = exports.snakeToCamel = exports.singularize = exports.pgTypeToTs = exports.pgArrayType = exports.normalizeKeyColumns = exports.isDateType = exports.camelToSnake = exports.validateChannel = exports.QueryInterface = exports.pipelineSupported = exports.executePipeline = exports.hasRelationFields = exports.executeNestedUpdate = exports.executeNestedCreate = exports.introspect = exports.generate = exports.wrapPgError = exports.ValidationError = exports.UnsupportedFeatureError = exports.UniqueConstraintError = exports.TurbineErrorCode = exports.TurbineError = exports.TimeoutError = exports.setErrorMessageMode = exports.SerializationFailureError = exports.RelationError = exports.PipelineError = exports.OptimisticLockError = exports.NotNullViolationError = exports.NotFoundError = exports.MigrationError = exports.getErrorMessageMode = exports.ForeignKeyError = exports.ExclusionConstraintError = exports.DeadlockError = exports.ConnectionError = exports.CircularRelationError = exports.CheckConstraintError = exports.postgresDialect = exports.withRetry = exports.TurbineClient = exports.TransactionClient = exports.yugabytedb = exports.timescale = exports.postgresql = exports.cockroachdb = exports.alloydb = void 0;
+exports.TypedSqlQuery = exports.buildTypedSql = exports.turbineHttp = exports.schemaToSQLString = exports.schemaToSQL = exports.schemaPush = exports.schemaDiff = exports.table = exports.defineSchema = exports.column = void 0;
 var index_js_1 = require("./adapters/index.js");
 Object.defineProperty(exports, "alloydb", { enumerable: true, get: function () { return index_js_1.alloydb; } });
 Object.defineProperty(exports, "cockroachdb", { enumerable: true, get: function () { return index_js_1.cockroachdb; } });
@@ -70,6 +70,7 @@ Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function
 Object.defineProperty(exports, "TurbineError", { enumerable: true, get: function () { return errors_js_1.TurbineError; } });
 Object.defineProperty(exports, "TurbineErrorCode", { enumerable: true, get: function () { return errors_js_1.TurbineErrorCode; } });
 Object.defineProperty(exports, "UniqueConstraintError", { enumerable: true, get: function () { return errors_js_1.UniqueConstraintError; } });
+Object.defineProperty(exports, "UnsupportedFeatureError", { enumerable: true, get: function () { return errors_js_1.UnsupportedFeatureError; } });
 Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
 Object.defineProperty(exports, "wrapPgError", { enumerable: true, get: function () { return errors_js_1.wrapPgError; } });
 // Code generation

package/dist/cjs/introspect.js

@@ -13,6 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.introspect = introspect;
+exports.introspectPostgresCatalog = introspectPostgresCatalog;
 const pg_1 = __importDefault(require("pg"));
 const dialect_js_1 = require("./dialect.js");
 const schema_js_1 = require("./schema.js");
@@ -100,7 +101,26 @@ const SQL_ENUMS = `
 // ---------------------------------------------------------------------------
 // Main introspection function
 // ---------------------------------------------------------------------------
+/**
+ * Introspect a database into {@link SchemaMetadata}, routing through the active
+ * dialect's {@link Dialect.introspector} so each engine can override the catalog
+ * SQL. PostgreSQL is driven by {@link introspectPostgresCatalog}.
+ */
 async function introspect(options) {
+    const dialect = options.dialect ?? dialect_js_1.postgresDialect;
+    const introspector = dialect.introspector;
+    if (introspector) {
+        return introspector.introspect(options);
+    }
+    // Dialects without an introspector fall back to the Postgres catalog reader.
+    return introspectPostgresCatalog(options);
+}
+/**
+ * PostgreSQL catalog introspector: reads information_schema + pg_catalog and
+ * produces {@link SchemaMetadata}. This is the implementation wrapped by
+ * `postgresDialect.introspector`; call {@link introspect} for dialect routing.
+ */
+async function introspectPostgresCatalog(options) {
     const schema = options.schema ?? 'public';
     const dialect = dialect_js_1.postgresDialect;
     const pool = new pg_1.default.Pool({