kysely 0.19.12 → 0.21.0

package/README.md

@@ -21,7 +21,7 @@ column names, aliases and types from selected subqueries, joined subqueries, `wi
 much anything you can think of.
 
 Of course there are cases where things cannot be typed at compile time, and Kysely offers escape
-hatches for these situations. See the [sql template tag](https://koskimas.github.io/kysely/modules.html#sql) 
+hatches for these situations. See the [sql template tag](https://koskimas.github.io/kysely/functions/sql.html) 
 and the [DynamicModule](https://koskimas.github.io/kysely/classes/DynamicModule.html#ref) for more info.
 
 If you start using Kysely and can't find something you'd want to use, please open an issue or join our

package/dist/cjs/dialect/mysql/mysql-introspector.js

@@ -30,6 +30,8 @@ class MysqlIntrospector {
             'extra',
         ])
             .where('table_schema', '=', (0, sql_js_1.sql) `database()`)
+            .orderBy('table_name')
+            .orderBy('column_name')
             .castTo();
         if (!options.withInternalKyselyTables) {
             query = query

package/dist/cjs/dialect/mysql/mysql-query-compiler.d.ts

@@ -1,6 +1,11 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export declare class MysqlQueryCompiler extends DefaultQueryCompiler {
     protected getCurrentParameterPlaceholder(): string;
+    protected getLeftExplainOptionsWrapper(): string;
+    protected getExplainOptionAssignment(): string;
+    protected getExplainOptionsDelimiter(): string;
+    protected getRightExplainOptionsWrapper(): string;
     protected getLeftIdentifierWrapper(): string;
     protected getRightIdentifierWrapper(): string;
+    protected sanitizeIdentifier(identifier: string): string;
 }

package/dist/cjs/dialect/mysql/mysql-query-compiler.js

@@ -2,15 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MysqlQueryCompiler = void 0;
 const default_query_compiler_js_1 = require("../../query-compiler/default-query-compiler.js");
+const ID_WRAP_REGEX = /`/g;
 class MysqlQueryCompiler extends default_query_compiler_js_1.DefaultQueryCompiler {
     getCurrentParameterPlaceholder() {
         return '?';
     }
+    getLeftExplainOptionsWrapper() {
+        return '';
+    }
+    getExplainOptionAssignment() {
+        return '=';
+    }
+    getExplainOptionsDelimiter() {
+        return ' ';
+    }
+    getRightExplainOptionsWrapper() {
+        return '';
+    }
     getLeftIdentifierWrapper() {
         return '`';
     }
     getRightIdentifierWrapper() {
         return '`';
     }
+    sanitizeIdentifier(identifier) {
+        return identifier.replace(ID_WRAP_REGEX, '``');
+    }
 }
 exports.MysqlQueryCompiler = MysqlQueryCompiler;

package/dist/cjs/dialect/postgres/postgres-dialect-config.d.ts

@@ -1,14 +1,4 @@
 import { DatabaseConnection } from '../../driver/database-connection.js';
-export declare type PostgresCursorConstructor = new <T>(sql: string, parameters: readonly unknown[]) => PostgresCursor<T>;
-export declare type PostgresCursor<T> = {
-    state: 'initialized' | 'idle' | 'submitted' | 'busy';
-    read: (rowsCount: number) => Promise<T[]>;
-} | {
-    state: 'done';
-} | {
-    state: 'error';
-    _error: Error;
-};
 /**
  * Config for the PostgreSQL dialect.
  */
@@ -56,13 +46,16 @@ export interface PostgresPoolClient {
     query<R>(cursor: PostgresCursor<R>): PostgresCursor<R>;
     release(): void;
 }
+export interface PostgresCursor<T> {
+    read(rowsCount: number): Promise<T[]>;
+    close(): Promise<void>;
+}
+export declare type PostgresCursorConstructor = new <T>(sql: string, parameters: unknown[]) => PostgresCursor<T>;
 export interface PostgresQueryResult<R> {
     command: 'UPDATE' | 'DELETE' | 'INSERT' | 'SELECT';
     rowCount: number;
     rows: R[];
 }
-export interface PostgresStreamOptions {
-}
 export interface PostgresStream<T> {
     [Symbol.asyncIterator](): AsyncIterableIterator<T>;
 }

package/dist/cjs/dialect/postgres/postgres-driver.js

@@ -90,18 +90,23 @@ class PostgresConnection {
         if (!this.#options.cursor) {
             throw new Error("'cursor' is not present in your postgres dialect config. It's required to make streaming work in postgres.");
         }
-        const cursor = this.#client.query(new this.#options.cursor(compiledQuery.sql, compiledQuery.parameters));
-        while (true) {
-            if (cursor.state === 'done') {
-                break;
-            }
-            if (cursor.state === 'error') {
-                throw cursor._error;
+        if (!Number.isInteger(chunkSize) || chunkSize <= 0) {
+            throw new Error('chunkSize must be a positive integer');
+        }
+        const cursor = this.#client.query(new this.#options.cursor(compiledQuery.sql, compiledQuery.parameters.slice()));
+        try {
+            while (true) {
+                const rows = await cursor.read(chunkSize);
+                if (rows.length === 0) {
+                    break;
+                }
+                yield {
+                    rows,
+                };
             }
-            const rows = await cursor.read(chunkSize);
-            yield {
-                rows,
-            };
+        }
+        finally {
+            await cursor.close();
         }
     }
     [PRIVATE_RELEASE_METHOD]() {

package/dist/cjs/dialect/postgres/postgres-introspector.js

@@ -21,33 +21,41 @@ class PostgresIntrospector {
         let query = this.#db
             .selectFrom('pg_catalog.pg_attribute as a')
             .innerJoin('pg_catalog.pg_class as c', 'a.attrelid', 'c.oid')
-            .innerJoin('pg_catalog.pg_tables as t', 't.tablename', 'c.relname')
+            .innerJoin('pg_catalog.pg_namespace as ns', 'c.relnamespace', 'ns.oid')
             .innerJoin('pg_catalog.pg_type as typ', 'a.atttypid', 'typ.oid')
             .select([
             'a.attname as column',
             'a.attnotnull as not_null',
             'a.atthasdef as has_default',
-            't.tablename as table',
-            't.schemaname as schema',
+            'c.relname as table',
+            'ns.nspname as schema',
             'typ.typname as type',
             // Detect if the column is auto incrementing by finding the sequence
             // that is created for `serial` and `bigserial` columns.
             this.#db
                 .selectFrom('pg_class')
                 .select((0, sql_js_1.sql) `true`.as('auto_incrementing'))
+                // Make sure the sequence is in the same schema as the table.
+                .whereRef('relnamespace', '=', 'c.relnamespace')
                 .where('relkind', '=', 'S')
-                .where('relname', '=', (0, sql_js_1.sql) `t.tablename || '_' || a.attname || '_seq'`)
+                .where('relname', '=', (0, sql_js_1.sql) `c.relname || '_' || a.attname || '_seq'`)
                 .as('auto_incrementing'),
         ])
-            .where('t.schemaname', '!~', '^pg_')
-            .where('t.schemaname', '!=', 'information_schema')
-            .where('a.attnum', '>=', 0) // No system columns
+            // r == normal table
+            .where('c.relkind', '=', 'r')
+            .where('ns.nspname', '!~', '^pg_')
+            .where('ns.nspname', '!=', 'information_schema')
+            // No system columns
+            .where('a.attnum', '>=', 0)
             .where('a.attisdropped', '!=', true)
+            .orderBy('ns.nspname')
+            .orderBy('c.relname')
+            .orderBy('a.attname')
             .castTo();
         if (!options.withInternalKyselyTables) {
             query = query
-                .where('t.tablename', '!=', migrator_js_1.DEFAULT_MIGRATION_TABLE)
-                .where('t.tablename', '!=', migrator_js_1.DEFAULT_MIGRATION_LOCK_TABLE);
+                .where('c.relname', '!=', migrator_js_1.DEFAULT_MIGRATION_TABLE)
+                .where('c.relname', '!=', migrator_js_1.DEFAULT_MIGRATION_LOCK_TABLE);
         }
         const rawColumns = await query.execute();
         return this.#parseTableMetadata(rawColumns);

package/dist/cjs/dialect/postgres/postgres-query-compiler.d.ts

@@ -1,6 +1,4 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export declare class PostgresQueryCompiler extends DefaultQueryCompiler {
-    protected getCurrentParameterPlaceholder(): string;
-    protected getLeftIdentifierWrapper(): string;
-    protected getRightIdentifierWrapper(): string;
+    protected sanitizeIdentifier(identifier: string): string;
 }

package/dist/cjs/dialect/postgres/postgres-query-compiler.js

@@ -2,15 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostgresQueryCompiler = void 0;
 const default_query_compiler_js_1 = require("../../query-compiler/default-query-compiler.js");
+const ID_WRAP_REGEX = /"/g;
 class PostgresQueryCompiler extends default_query_compiler_js_1.DefaultQueryCompiler {
-    getCurrentParameterPlaceholder() {
-        return '$' + this.numParameters;
-    }
-    getLeftIdentifierWrapper() {
-        return '"';
-    }
-    getRightIdentifierWrapper() {
-        return '"';
+    sanitizeIdentifier(identifier) {
+        return identifier.replace(ID_WRAP_REGEX, '""');
     }
 }
 exports.PostgresQueryCompiler = PostgresQueryCompiler;

package/dist/cjs/dialect/sqlite/sqlite-introspector.js

@@ -18,6 +18,7 @@ class SqliteIntrospector {
             .where('type', '=', 'table')
             .where('name', 'not like', 'sqlite_%')
             .select('name')
+            .orderBy('name')
             .castTo();
         if (!options.withInternalKyselyTables) {
             query = query
@@ -50,6 +51,7 @@ class SqliteIntrospector {
         const columns = await db
             .selectFrom((0, sql_js_1.sql) `pragma_table_info(${table})`.as('table_info'))
             .select(['name', 'type', 'notnull', 'dflt_value'])
+            .orderBy('name')
             .execute();
         return {
             name: table,

package/dist/cjs/dialect/sqlite/sqlite-query-compiler.d.ts

@@ -1,7 +1,10 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export declare class SqliteQueryCompiler extends DefaultQueryCompiler {
     protected getCurrentParameterPlaceholder(): string;
+    protected getLeftExplainOptionsWrapper(): string;
+    protected getRightExplainOptionsWrapper(): string;
     protected getLeftIdentifierWrapper(): string;
     protected getRightIdentifierWrapper(): string;
     protected getAutoIncrement(): string;
+    protected sanitizeIdentifier(identifier: string): string;
 }

package/dist/cjs/dialect/sqlite/sqlite-query-compiler.js

@@ -2,10 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SqliteQueryCompiler = void 0;
 const default_query_compiler_js_1 = require("../../query-compiler/default-query-compiler.js");
+const ID_WRAP_REGEX = /"/g;
 class SqliteQueryCompiler extends default_query_compiler_js_1.DefaultQueryCompiler {
     getCurrentParameterPlaceholder() {
         return '?';
     }
+    getLeftExplainOptionsWrapper() {
+        return '';
+    }
+    getRightExplainOptionsWrapper() {
+        return '';
+    }
     getLeftIdentifierWrapper() {
         return '"';
     }
@@ -15,5 +22,8 @@ class SqliteQueryCompiler extends default_query_compiler_js_1.DefaultQueryCompil
     getAutoIncrement() {
         return 'autoincrement';
     }
+    sanitizeIdentifier(identifier) {
+        return identifier.replace(ID_WRAP_REGEX, '""');
+    }
 }
 exports.SqliteQueryCompiler = SqliteQueryCompiler;

package/dist/cjs/index.d.ts

@@ -73,6 +73,7 @@ export * from './migration/file-migration-provider.js';
 export * from './plugin/kysely-plugin.js';
 export * from './plugin/camel-case/camel-case-plugin.js';
 export * from './plugin/deduplicate-joins/deduplicate-joins-plugin.js';
+export * from './plugin/with-schema/with-schema-plugin.js';
 export * from './operation-node/add-column-node.js';
 export * from './operation-node/add-constraint-node.js';
 export * from './operation-node/alias-node.js';
@@ -149,8 +150,10 @@ export * from './operation-node/value-node.js';
 export * from './operation-node/values-node.js';
 export * from './operation-node/where-node.js';
 export * from './operation-node/with-node.js';
+export * from './operation-node/explain-node.js';
 export * from './util/column-type.js';
 export * from './util/compilable.js';
+export * from './util/explainable.js';
 export * from './util/log.js';
 export { AnyColumn, UnknownRow, AnySelectQueryBuilder, } from './util/type-utils.js';
 export { SelectExpression, SelectExpressionOrList, Selection, } from './parser/select-parser.js';

package/dist/cjs/index.js

@@ -89,6 +89,7 @@ __exportStar(require("./migration/file-migration-provider.js"), exports);
 __exportStar(require("./plugin/kysely-plugin.js"), exports);
 __exportStar(require("./plugin/camel-case/camel-case-plugin.js"), exports);
 __exportStar(require("./plugin/deduplicate-joins/deduplicate-joins-plugin.js"), exports);
+__exportStar(require("./plugin/with-schema/with-schema-plugin.js"), exports);
 __exportStar(require("./operation-node/add-column-node.js"), exports);
 __exportStar(require("./operation-node/add-constraint-node.js"), exports);
 __exportStar(require("./operation-node/alias-node.js"), exports);
@@ -165,6 +166,8 @@ __exportStar(require("./operation-node/value-node.js"), exports);
 __exportStar(require("./operation-node/values-node.js"), exports);
 __exportStar(require("./operation-node/where-node.js"), exports);
 __exportStar(require("./operation-node/with-node.js"), exports);
+__exportStar(require("./operation-node/explain-node.js"), exports);
 __exportStar(require("./util/column-type.js"), exports);
 __exportStar(require("./util/compilable.js"), exports);
+__exportStar(require("./util/explainable.js"), exports);
 __exportStar(require("./util/log.js"), exports);

package/dist/cjs/operation-node/create-table-node.d.ts

@@ -3,9 +3,10 @@ import { TableNode } from './table-node.js';
 import { ConstraintNode } from './constraint-node.js';
 import { ColumnDefinitionNode } from './column-definition-node.js';
 import { ArrayItemType } from '../util/type-utils.js';
+import { RawNode } from './raw-node.js';
 export declare const ON_COMMIT_ACTIONS: string[];
 export declare type OnCommitAction = ArrayItemType<typeof ON_COMMIT_ACTIONS>;
-export declare type CreateTableNodeParams = Omit<CreateTableNode, 'kind' | 'table' | 'columns' | 'constraints'>;
+export declare type CreateTableNodeParams = Omit<CreateTableNode, 'kind' | 'table' | 'columns' | 'constraints' | 'frontModifiers' | 'endModifiers'>;
 export interface CreateTableNode extends OperationNode {
     readonly kind: 'CreateTableNode';
     readonly table: TableNode;
@@ -14,6 +15,8 @@ export interface CreateTableNode extends OperationNode {
     readonly temporary?: boolean;
     readonly ifNotExists?: boolean;
     readonly onCommit?: OnCommitAction;
+    readonly frontModifiers?: ReadonlyArray<RawNode>;
+    readonly endModifiers?: ReadonlyArray<RawNode>;
 }
 /**
  * @internal
@@ -23,5 +26,7 @@ export declare const CreateTableNode: Readonly<{
     create(table: TableNode): CreateTableNode;
     cloneWithColumn(createTable: CreateTableNode, column: ColumnDefinitionNode): CreateTableNode;
     cloneWithConstraint(createTable: CreateTableNode, constraint: ConstraintNode): CreateTableNode;
+    cloneWithFrontModifier(createTable: CreateTableNode, modifier: RawNode): CreateTableNode;
+    cloneWithEndModifier(createTable: CreateTableNode, modifier: RawNode): CreateTableNode;
     cloneWith(createTable: CreateTableNode, params: CreateTableNodeParams): CreateTableNode;
 }>;

package/dist/cjs/operation-node/create-table-node.js

@@ -31,6 +31,22 @@ exports.CreateTableNode = (0, object_utils_js_1.freeze)({
                 : (0, object_utils_js_1.freeze)([constraint]),
         });
     },
+    cloneWithFrontModifier(createTable, modifier) {
+        return (0, object_utils_js_1.freeze)({
+            ...createTable,
+            frontModifiers: createTable.frontModifiers
+                ? (0, object_utils_js_1.freeze)([...createTable.frontModifiers, modifier])
+                : (0, object_utils_js_1.freeze)([modifier]),
+        });
+    },
+    cloneWithEndModifier(createTable, modifier) {
+        return (0, object_utils_js_1.freeze)({
+            ...createTable,
+            endModifiers: createTable.endModifiers
+                ? (0, object_utils_js_1.freeze)([...createTable.endModifiers, modifier])
+                : (0, object_utils_js_1.freeze)([modifier]),
+        });
+    },
     cloneWith(createTable, params) {
         return (0, object_utils_js_1.freeze)({
             ...createTable,

package/dist/cjs/operation-node/create-type-node.d.ts

@@ -1,10 +1,10 @@
-import { IdentifierNode } from './identifier-node.js';
 import { OperationNode } from './operation-node.js';
+import { SchemableIdentifierNode } from './schemable-identifier-node.js';
 import { ValueListNode } from './value-list-node.js';
 export declare type CreateTypeNodeParams = Omit<Partial<CreateTypeNode>, 'kind'>;
 export interface CreateTypeNode extends OperationNode {
     readonly kind: 'CreateTypeNode';
-    readonly name: IdentifierNode;
+    readonly name: SchemableIdentifierNode;
     readonly enum?: ValueListNode;
 }
 /**

package/dist/cjs/operation-node/create-type-node.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateTypeNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const identifier_node_js_1 = require("./identifier-node.js");
+const schemable_identifier_node_js_1 = require("./schemable-identifier-node.js");
 const value_list_node_js_1 = require("./value-list-node.js");
 const value_node_js_1 = require("./value-node.js");
 /**
@@ -15,7 +15,7 @@ exports.CreateTypeNode = (0, object_utils_js_1.freeze)({
     create(name) {
         return (0, object_utils_js_1.freeze)({
             kind: 'CreateTypeNode',
-            name: identifier_node_js_1.IdentifierNode.create(name),
+            name: schemable_identifier_node_js_1.SchemableIdentifierNode.create(name),
         });
     },
     cloneWithEnum(createType, values) {

package/dist/cjs/operation-node/create-view-node.d.ts

@@ -1,12 +1,12 @@
 import { ColumnNode } from './column-node.js';
-import { IdentifierNode } from './identifier-node.js';
 import { OperationNode } from './operation-node.js';
 import { RawNode } from './raw-node.js';
+import { SchemableIdentifierNode } from './schemable-identifier-node.js';
 import { SelectQueryNode } from './select-query-node.js';
 export declare type CreateViewNodeParams = Omit<Partial<CreateViewNode>, 'kind' | 'name'>;
 export interface CreateViewNode extends OperationNode {
     readonly kind: 'CreateViewNode';
-    readonly name: IdentifierNode;
+    readonly name: SchemableIdentifierNode;
     readonly temporary?: boolean;
     readonly materialized?: boolean;
     readonly orReplace?: boolean;

package/dist/cjs/operation-node/create-view-node.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateViewNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const identifier_node_js_1 = require("./identifier-node.js");
+const schemable_identifier_node_js_1 = require("./schemable-identifier-node.js");
 /**
  * @internal
  */
@@ -13,7 +13,7 @@ exports.CreateViewNode = (0, object_utils_js_1.freeze)({
     create(name) {
         return (0, object_utils_js_1.freeze)({
             kind: 'CreateViewNode',
-            name: identifier_node_js_1.IdentifierNode.create(name),
+            name: schemable_identifier_node_js_1.SchemableIdentifierNode.create(name),
         });
     },
     cloneWith(createView, params) {

package/dist/cjs/operation-node/delete-query-node.d.ts

@@ -8,6 +8,7 @@ import { WithNode } from './with-node.js';
 import { LimitNode } from './limit-node.js';
 import { OrderByNode } from './order-by-node.js';
 import { OrderByItemNode } from './order-by-item-node.js';
+import { ExplainNode } from './explain-node.js';
 export interface DeleteQueryNode extends OperationNode {
     readonly kind: 'DeleteQueryNode';
     readonly from: FromNode;
@@ -17,6 +18,7 @@ export interface DeleteQueryNode extends OperationNode {
     readonly with?: WithNode;
     readonly orderBy?: OrderByNode;
     readonly limit?: LimitNode;
+    readonly explain?: ExplainNode;
 }
 /**
  * @internal
@@ -26,4 +28,5 @@ export declare const DeleteQueryNode: Readonly<{
     create(fromItem: TableExpressionNode, withNode?: WithNode): DeleteQueryNode;
     cloneWithOrderByItem(deleteNode: DeleteQueryNode, item: OrderByItemNode): DeleteQueryNode;
     cloneWithLimit(deleteNode: DeleteQueryNode, limit: LimitNode): DeleteQueryNode;
+    cloneWithExplain(deleteNode: DeleteQueryNode, explain: ExplainNode): DeleteQueryNode;
 }>;

package/dist/cjs/operation-node/delete-query-node.js

@@ -32,4 +32,10 @@ exports.DeleteQueryNode = (0, object_utils_js_1.freeze)({
             limit,
         });
     },
+    cloneWithExplain(deleteNode, explain) {
+        return (0, object_utils_js_1.freeze)({
+            ...deleteNode,
+            explain,
+        });
+    },
 });

package/dist/cjs/operation-node/drop-index-node.d.ts

@@ -1,10 +1,10 @@
-import { IdentifierNode } from './identifier-node.js';
 import { OperationNode } from './operation-node.js';
+import { SchemableIdentifierNode } from './schemable-identifier-node.js';
 import { TableNode } from './table-node.js';
 export declare type DropIndexNodeProps = Omit<DropIndexNode, 'kind' | 'name'>;
 export interface DropIndexNode extends OperationNode {
     readonly kind: 'DropIndexNode';
-    readonly name: IdentifierNode;
+    readonly name: SchemableIdentifierNode;
     readonly table?: TableNode;
     readonly ifExists?: boolean;
 }

package/dist/cjs/operation-node/drop-index-node.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DropIndexNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const identifier_node_js_1 = require("./identifier-node.js");
+const schemable_identifier_node_js_1 = require("./schemable-identifier-node.js");
 /**
  * @internal
  */
@@ -13,7 +13,7 @@ exports.DropIndexNode = (0, object_utils_js_1.freeze)({
     create(name, params) {
         return (0, object_utils_js_1.freeze)({
             kind: 'DropIndexNode',
-            name: identifier_node_js_1.IdentifierNode.create(name),
+            name: schemable_identifier_node_js_1.SchemableIdentifierNode.create(name),
             ...params,
         });
     },

package/dist/cjs/operation-node/drop-type-node.d.ts

@@ -1,9 +1,9 @@
-import { IdentifierNode } from './identifier-node.js';
 import { OperationNode } from './operation-node.js';
+import { SchemableIdentifierNode } from './schemable-identifier-node.js';
 export declare type DropTypeNodeParams = Omit<Partial<DropTypeNode>, 'kind' | 'name'>;
 export interface DropTypeNode extends OperationNode {
     readonly kind: 'DropTypeNode';
-    readonly name: IdentifierNode;
+    readonly name: SchemableIdentifierNode;
     readonly ifExists?: boolean;
 }
 /**

package/dist/cjs/operation-node/drop-type-node.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DropTypeNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const identifier_node_js_1 = require("./identifier-node.js");
+const schemable_identifier_node_js_1 = require("./schemable-identifier-node.js");
 /**
  * @internal
  */
@@ -13,7 +13,7 @@ exports.DropTypeNode = (0, object_utils_js_1.freeze)({
     create(name) {
         return (0, object_utils_js_1.freeze)({
             kind: 'DropTypeNode',
-            name: identifier_node_js_1.IdentifierNode.create(name),
+            name: schemable_identifier_node_js_1.SchemableIdentifierNode.create(name),
         });
     },
     cloneWith(dropType, params) {

package/dist/cjs/operation-node/drop-view-node.d.ts

@@ -1,9 +1,9 @@
-import { IdentifierNode } from './identifier-node.js';
 import { OperationNode } from './operation-node.js';
+import { SchemableIdentifierNode } from './schemable-identifier-node.js';
 export declare type DropViewNodeParams = Omit<Partial<DropViewNode>, 'kind' | 'name'>;
 export interface DropViewNode extends OperationNode {
     readonly kind: 'DropViewNode';
-    readonly name: IdentifierNode;
+    readonly name: SchemableIdentifierNode;
     readonly ifExists?: boolean;
     readonly materialized?: boolean;
 }

package/dist/cjs/operation-node/drop-view-node.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DropViewNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const identifier_node_js_1 = require("./identifier-node.js");
+const schemable_identifier_node_js_1 = require("./schemable-identifier-node.js");
 /**
  * @internal
  */
@@ -13,7 +13,7 @@ exports.DropViewNode = (0, object_utils_js_1.freeze)({
     create(name) {
         return (0, object_utils_js_1.freeze)({
             kind: 'DropViewNode',
-            name: identifier_node_js_1.IdentifierNode.create(name),
+            name: schemable_identifier_node_js_1.SchemableIdentifierNode.create(name),
         });
     },
     cloneWith(dropView, params) {

package/dist/cjs/operation-node/explain-node.d.ts

@@ -0,0 +1,16 @@
+import { ExplainFormat } from '../util/explainable.js';
+import { AnyRawBuilder } from '../util/type-utils.js';
+import { OperationNode } from './operation-node.js';
+import { RawNode } from './raw-node.js';
+export interface ExplainNode extends OperationNode {
+    readonly kind: 'ExplainNode';
+    readonly format?: ExplainFormat;
+    readonly options?: RawNode;
+}
+/**
+ * @internal
+ */
+export declare const ExplainNode: Readonly<{
+    is(node: OperationNode): node is ExplainNode;
+    create(format?: ExplainFormat, options?: AnyRawBuilder): ExplainNode;
+}>;

package/dist/cjs/operation-node/explain-node.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplainNode = void 0;
+const object_utils_js_1 = require("../util/object-utils.js");
+/**
+ * @internal
+ */
+exports.ExplainNode = (0, object_utils_js_1.freeze)({
+    is(node) {
+        return node.kind === 'ExplainNode';
+    },
+    create(format, options) {
+        return (0, object_utils_js_1.freeze)({
+            kind: 'ExplainNode',
+            format,
+            options: options?.toOperationNode(),
+        });
+    },
+});

package/dist/cjs/operation-node/identifier-node.d.ts

@@ -1,12 +1,12 @@
 import { OperationNode } from './operation-node.js';
 export interface IdentifierNode extends OperationNode {
     readonly kind: 'IdentifierNode';
-    readonly identifier: string;
+    readonly name: string;
 }
 /**
  * @internal
  */
 export declare const IdentifierNode: Readonly<{
     is(node: OperationNode): node is IdentifierNode;
-    create(identifier: string): IdentifierNode;
+    create(name: string): IdentifierNode;
 }>;

package/dist/cjs/operation-node/identifier-node.js

@@ -9,10 +9,10 @@ exports.IdentifierNode = (0, object_utils_js_1.freeze)({
     is(node) {
         return node.kind === 'IdentifierNode';
     },
-    create(identifier) {
+    create(name) {
         return (0, object_utils_js_1.freeze)({
             kind: 'IdentifierNode',
-            identifier,
+            name,
         });
     },
 });