kysely 0.12.1 → 0.14.1

package/dist/esm/migration/migration.js

@@ -1,9 +1,10 @@
 import * as path from 'path';
 import { promises as fs } from 'fs';
-import { getLast, isFunction, isObject, isString, } from '../util/object-utils.js';
+import { freeze, getLast, isFunction, isObject, isString, } from '../util/object-utils.js';
 export const MIGRATION_TABLE = 'kysely_migration';
 export const MIGRATION_LOCK_TABLE = 'kysely_migration_lock';
 export const MIGRATION_LOCK_ID = 'migration_lock';
+export const NO_MIGRATIONS = freeze({ __noMigrations__: true });
 export class MigrationModule {
     #db;
     #adapter;
@@ -12,170 +13,290 @@ export class MigrationModule {
         this.#adapter = adapter;
     }
     async migrateToLatest(migrationsOrFolderPath) {
-        await ensureMigrationTablesExists(this.#db);
-        const allMigrations = await this.#getAllMigrations(migrationsOrFolderPath);
-        await this.#migrateToLatest(allMigrations);
+        return this.#migrate(migrationsOrFolderPath, ({ migrations }) => migrations.length - 1);
     }
-    async #getAllMigrations(migrationsOrFolderPath) {
-        return isString(migrationsOrFolderPath)
-            ? await readMigrationsFromFolder(migrationsOrFolderPath)
-            : migrationsOrFolderPath;
+    async migrateTo(migrationsOrFolderPath, targetMigrationName) {
+        return this.#migrate(migrationsOrFolderPath, ({ migrations }) => {
+            if (targetMigrationName === NO_MIGRATIONS) {
+                return -1;
+            }
+            const index = migrations.findIndex((it) => it.name === targetMigrationName);
+            if (index === -1) {
+                throw new Error(`migration "${targetMigrationName}" doesn't exist`);
+            }
+            return index;
+        });
+    }
+    async migrateUp(migrationsOrFolderPath) {
+        return this.#migrate(migrationsOrFolderPath, ({ currentIndex, migrations }) => Math.min(currentIndex + 1, migrations.length - 1));
+    }
+    async migrateDown(migrationsOrFolderPath) {
+        return this.#migrate(migrationsOrFolderPath, ({ currentIndex }) => Math.max(currentIndex - 1, -1));
+    }
+    async #migrate(migrationsOrFolderPath, getTargetMigration) {
+        try {
+            await this.#ensureMigrationTablesExists();
+            return await this.#runMigrations(migrationsOrFolderPath, getTargetMigration);
+        }
+        catch (error) {
+            if (error instanceof MigrationResultSetError) {
+                return error.resultSet;
+            }
+            return { error };
+        }
+    }
+    async #ensureMigrationTablesExists() {
+        await this.#ensureMigrationTableExists();
+        await this.#ensureMigrationLockTableExists();
+        await this.#ensureLockRowExists();
+    }
+    async #ensureMigrationTableExists() {
+        if (!(await this.#doesTableExists(MIGRATION_TABLE))) {
+            try {
+                await this.#db.schema
+                    .createTable(MIGRATION_TABLE)
+                    .ifNotExists()
+                    .addColumn('name', 'varchar(255)', (col) => col.notNull().primaryKey())
+                    // The migration run time as ISO string. This is not a real date type as we
+                    // can't know which data type is supported by all future dialects.
+                    .addColumn('timestamp', 'varchar(255)', (col) => col.notNull())
+                    .execute();
+            }
+            catch (error) {
+                // At least on PostgreSQL, `if not exists` doesn't guarantee the `create table`
+                // query doesn't throw if the table already exits. That's why we check if
+                // the table exist here and ignore the error if it does.
+                if (!(await this.#doesTableExists(MIGRATION_TABLE))) {
+                    throw error;
+                }
+            }
+        }
+    }
+    async #ensureMigrationLockTableExists() {
+        if (!(await this.#doesTableExists(MIGRATION_LOCK_TABLE))) {
+            try {
+                await this.#db.schema
+                    .createTable(MIGRATION_LOCK_TABLE)
+                    .ifNotExists()
+                    .addColumn('id', 'varchar(255)', (col) => col.notNull().primaryKey())
+                    .addColumn('is_locked', 'integer', (col) => col.notNull().defaultTo(0))
+                    .execute();
+            }
+            catch (error) {
+                // At least on PostgreSQL, `if not exists` doesn't guarantee the `create table`
+                // query doesn't throw if the table already exits. That's why we check if
+                // the table exist here and ignore the error if it does.
+                if (!(await this.#doesTableExists(MIGRATION_LOCK_TABLE))) {
+                    throw error;
+                }
+            }
+        }
     }
-    async #migrateToLatest(allMigrations) {
+    async #ensureLockRowExists() {
+        if (!(await this.#doesLockRowExists())) {
+            try {
+                await this.#db
+                    .insertInto(MIGRATION_LOCK_TABLE)
+                    .values({ id: MIGRATION_LOCK_ID })
+                    .execute();
+            }
+            catch (error) {
+                if (!(await this.#doesLockRowExists())) {
+                    throw error;
+                }
+            }
+        }
+    }
+    async #doesTableExists(tableName) {
+        const metadata = await this.#db.introspection.getMetadata({
+            withInternalKyselyTables: true,
+        });
+        return !!metadata.tables.find((it) => it.name === tableName);
+    }
+    async #doesLockRowExists() {
+        const lockRow = await this.#db
+            .selectFrom(MIGRATION_LOCK_TABLE)
+            .where('id', '=', MIGRATION_LOCK_ID)
+            .select('id')
+            .executeTakeFirst();
+        return !!lockRow;
+    }
+    async #runMigrations(migrationsOrFolderPath, getTargetMigration) {
         const run = async (db) => {
             try {
                 await this.#adapter.acquireMigrationLock(db);
-                await runNewMigrations(db, allMigrations);
+                const state = await this.#getState(db, migrationsOrFolderPath);
+                if (state.migrations.length === 0) {
+                    return { results: [] };
+                }
+                const targetIndex = getTargetMigration(state);
+                if (targetIndex === undefined) {
+                    return { results: [] };
+                }
+                if (targetIndex < state.currentIndex) {
+                    return await this.#migrateDown(db, state, targetIndex);
+                }
+                else if (targetIndex > state.currentIndex) {
+                    return await this.#migrateUp(db, state, targetIndex);
+                }
+                return { results: [] };
             }
             finally {
                 await this.#adapter.releaseMigrationLock(db);
             }
         };
         if (this.#adapter.supportsTransactionalDdl) {
-            await this.#db.transaction().execute(run);
+            return this.#db.transaction().execute(run);
         }
         else {
-            await this.#db.connection().execute(run);
+            return this.#db.connection().execute(run);
         }
     }
-}
-async function ensureMigrationTablesExists(db) {
-    await ensureMigrationTableExists(db);
-    await ensureMigrationLockTableExists(db);
-    await ensureLockRowExists(db);
-}
-async function ensureMigrationTableExists(db) {
-    if (!(await doesTableExists(db, MIGRATION_TABLE))) {
-        try {
-            await db.schema
-                .createTable(MIGRATION_TABLE)
-                .ifNotExists()
-                .addColumn('name', 'varchar(255)', (col) => col.notNull().primaryKey())
-                // The migration run time as ISO string. This is not a real date type as we
-                // can't know which data type is supported by all future dialects.
-                .addColumn('timestamp', 'varchar(255)', (col) => col.notNull())
-                .execute();
-        }
-        catch (error) {
-            // At least on PostgreSQL, `if not exists` doesn't guarantee the `create table`
-            // query doesn't throw if the table already exits. That's why we check if
-            // the table exist here and ignore the error if it does.
-            if (!(await doesTableExists(db, MIGRATION_TABLE))) {
-                throw error;
+    async #getState(db, migrationsOrFolderPath) {
+        const migrations = await this.#resolveMigrations(migrationsOrFolderPath);
+        const executedMigrations = await this.#getExecutedMigrations(db);
+        this.#ensureMigrationsNotCorrupted(migrations, executedMigrations);
+        return freeze({
+            migrations,
+            currentIndex: migrations.findIndex((it) => it.name === getLast(executedMigrations)),
+        });
+    }
+    async #resolveMigrations(migrationsOrFolderPath) {
+        const allMigrations = isString(migrationsOrFolderPath)
+            ? await this.#readMigrationsFromFolder(migrationsOrFolderPath)
+            : migrationsOrFolderPath;
+        return Object.keys(allMigrations)
+            .sort()
+            .map((name) => ({
+            ...allMigrations[name],
+            name,
+        }));
+    }
+    async #readMigrationsFromFolder(migrationsFolderPath) {
+        const files = await fs.readdir(migrationsFolderPath);
+        const migrations = {};
+        for (const file of files) {
+            if ((file.endsWith('.js') || file.endsWith('.ts')) &&
+                !file.endsWith('.d.ts')) {
+                const migration = await import(path.join(migrationsFolderPath, file));
+                if (isMigration(migration)) {
+                    migrations[file.substring(0, file.length - 3)] = migration;
+                }
             }
         }
+        return migrations;
     }
-}
-async function ensureMigrationLockTableExists(db) {
-    if (!(await doesTableExists(db, MIGRATION_LOCK_TABLE))) {
-        try {
-            await db.schema
-                .createTable(MIGRATION_LOCK_TABLE)
-                .ifNotExists()
-                .addColumn('id', 'varchar(255)', (col) => col.notNull().primaryKey())
-                .addColumn('is_locked', 'integer', (col) => col.notNull().defaultTo(0))
-                .execute();
+    async #getExecutedMigrations(db) {
+        const executedMigrations = await db
+            .selectFrom(MIGRATION_TABLE)
+            .select('name')
+            .orderBy('name')
+            .execute();
+        return executedMigrations.map((it) => it.name);
+    }
+    #ensureMigrationsNotCorrupted(migrations, executedMigrations) {
+        for (const executed of executedMigrations) {
+            if (!migrations.some((it) => it.name === executed)) {
+                throw new Error(`corrupted migrations: previously executed migration ${executed} is missing`);
+            }
         }
-        catch (error) {
-            // At least on PostgreSQL, `if not exists` doesn't guarantee the `create table`
-            // query doesn't throw if the table already exits. That's why we check if
-            // the table exist here and ignore the error if it does.
-            if (!(await doesTableExists(db, MIGRATION_LOCK_TABLE))) {
-                throw error;
+        // Now we know all executed migrations exist in the `migrations` list.
+        // Next we need to make sure that the executed migrations are the first
+        // ones in the migration list.
+        for (let i = 0; i < executedMigrations.length; ++i) {
+            if (migrations[i].name !== executedMigrations[i]) {
+                throw new Error(`corrupted migrations: expected previously executed migration ${executedMigrations[i]} to be at index ${i} but ${migrations[i].name} was found in its place. New migrations must always have a name that comes alphabetically after the last executed migration.`);
             }
         }
     }
-}
-async function ensureLockRowExists(db) {
-    if (!(await doesLockRowExists(db))) {
-        try {
-            await db
-                .insertInto(MIGRATION_LOCK_TABLE)
-                .values({ id: MIGRATION_LOCK_ID })
-                .execute();
+    async #migrateDown(db, state, targetIndex) {
+        const results = [];
+        for (let i = state.currentIndex; i > targetIndex; --i) {
+            results.push({
+                migrationName: state.migrations[i].name,
+                direction: 'Down',
+                status: 'NotExecuted',
+            });
         }
-        catch (error) {
-            if (!(await doesLockRowExists(db))) {
-                throw error;
+        for (let i = 0; i < results.length; ++i) {
+            const migration = state.migrations.find((it) => it.name === results[i].migrationName);
+            try {
+                if (migration.down) {
+                    await migration.down(db);
+                    await db
+                        .deleteFrom(MIGRATION_TABLE)
+                        .where('name', '=', migration.name)
+                        .execute();
+                    results[i] = {
+                        migrationName: migration.name,
+                        direction: 'Down',
+                        status: 'Success',
+                    };
+                }
+            }
+            catch (error) {
+                results[i] = {
+                    migrationName: migration.name,
+                    direction: 'Down',
+                    status: 'Error',
+                };
+                throw new MigrationResultSetError({
+                    error,
+                    results,
+                });
             }
         }
+        return { results };
     }
-}
-async function doesTableExists(db, tableName) {
-    const metadata = await db.introspection.getMetadata({
-        withInternalKyselyTables: true,
-    });
-    return !!metadata.tables.find((it) => it.name === tableName);
-}
-async function doesLockRowExists(db) {
-    const lockRow = await db
-        .selectFrom(MIGRATION_LOCK_TABLE)
-        .where('id', '=', MIGRATION_LOCK_ID)
-        .select('id')
-        .executeTakeFirst();
-    return !!lockRow;
-}
-async function readMigrationsFromFolder(migrationsFolderPath) {
-    const files = await fs.readdir(migrationsFolderPath);
-    const migrations = {};
-    for (const file of files) {
-        if ((file.endsWith('.js') || file.endsWith('.ts')) &&
-            !file.endsWith('.d.ts')) {
-            const migration = await import(path.join(migrationsFolderPath, file));
-            if (isMigration(migration)) {
-                migrations[file.substring(0, file.length - 3)] = migration;
+    async #migrateUp(db, state, targetIndex) {
+        const results = [];
+        for (let i = state.currentIndex + 1; i <= targetIndex; ++i) {
+            results.push({
+                migrationName: state.migrations[i].name,
+                direction: 'Up',
+                status: 'NotExecuted',
+            });
+        }
+        for (let i = 0; i < results.length; ++i) {
+            const migration = state.migrations.find((it) => it.name === results[i].migrationName);
+            try {
+                await migration.up(db);
+                await db
+                    .insertInto(MIGRATION_TABLE)
+                    .values({
+                    name: migration.name,
+                    timestamp: new Date().toISOString(),
+                })
+                    .execute();
+                results[i] = {
+                    migrationName: migration.name,
+                    direction: 'Up',
+                    status: 'Success',
+                };
+            }
+            catch (error) {
+                results[i] = {
+                    migrationName: migration.name,
+                    direction: 'Up',
+                    status: 'Error',
+                };
+                throw new MigrationResultSetError({
+                    error,
+                    results,
+                });
             }
         }
+        return { results };
     }
-    return migrations;
 }
-async function runNewMigrations(db, allMigrations) {
-    const sortedMigrations = Object.keys(allMigrations)
-        .sort()
-        .map((name) => ({
-        ...allMigrations[name],
-        name,
-    }));
-    const executedMigrations = await db
-        .selectFrom(MIGRATION_TABLE)
-        .select('name')
-        .orderBy('name')
-        .execute();
-    const lastExecuted = getLast(executedMigrations);
-    const lastExecutedIndex = sortedMigrations.findIndex((it) => it.name === lastExecuted?.name);
-    if (lastExecuted && lastExecutedIndex === -1) {
-        throw new Error(`corrupted migrations: previously executed migration ${lastExecuted.name} is missing`);
-    }
-    const oldMigrations = lastExecuted
-        ? sortedMigrations.slice(0, lastExecutedIndex + 1)
-        : [];
-    const newMigrations = lastExecuted
-        ? sortedMigrations.slice(lastExecutedIndex + 1)
-        : sortedMigrations;
-    ensureMigrationsAreNotCorrupted(executedMigrations.map((it) => it.name), oldMigrations.map((it) => it.name));
-    for (const migration of newMigrations) {
-        await migration.up(db);
-        await db
-            .insertInto(MIGRATION_TABLE)
-            .values({
-            name: migration.name,
-            timestamp: new Date().toISOString(),
-        })
-            .execute();
+class MigrationResultSetError extends Error {
+    #resultSet;
+    constructor(result) {
+        super();
+        this.#resultSet = result;
     }
-}
-function ensureMigrationsAreNotCorrupted(executedMigrationNames, oldMigrationNames) {
-    const executedSet = new Set(executedMigrationNames);
-    const oldMigrationSet = new Set(oldMigrationNames);
-    for (const it of executedSet) {
-        if (!oldMigrationSet.has(it)) {
-            throw new Error(`corrupted migrations: previously executed migration ${it} is missing`);
-        }
-    }
-    for (const it of oldMigrationSet) {
-        if (!executedSet.has(it)) {
-            throw new Error(`corrupted migrations: new migration ${it} comes alphabetically before the last executed migration. New migrations must always have a name that comes alphabetically after the last executed migration.`);
-        }
+    get resultSet() {
+        return this.#resultSet;
     }
 }
 function isMigration(obj) {

package/dist/esm/operation-node/check-constraint-node.d.ts

@@ -11,5 +11,5 @@ export interface CheckConstraintNode extends OperationNode {
  */
 export declare const CheckConstraintNode: Readonly<{
     is(node: OperationNode): node is CheckConstraintNode;
-    create(expressionSql: string, constraintName?: string | undefined): CheckConstraintNode;
+    create(expression: RawNode, constraintName?: string | undefined): CheckConstraintNode;
 }>;

package/dist/esm/operation-node/check-constraint-node.js

@@ -1,5 +1,4 @@
 import { freeze } from '../util/object-utils.js';
-import { RawNode } from './raw-node.js';
 import { IdentifierNode } from './identifier-node.js';
 /**
  * @internal
@@ -8,10 +7,10 @@ export const CheckConstraintNode = freeze({
     is(node) {
         return node.kind === 'CheckConstraintNode';
     },
-    create(expressionSql, constraintName) {
+    create(expression, constraintName) {
         return freeze({
             kind: 'CheckConstraintNode',
-            expression: RawNode.createWithSql(expressionSql),
+            expression,
             name: constraintName ? IdentifierNode.create(constraintName) : undefined,
         });
     },

package/dist/esm/operation-node/column-definition-node.d.ts

@@ -2,24 +2,25 @@ import { CheckConstraintNode } from './check-constraint-node.js';
 import { ColumnNode } from './column-node.js';
 import { DataTypeNode } from './data-type-node.js';
 import { DefaultValueNode } from './default-value-node.js';
-import { GeneratedAlwaysAsNode } from './generated-always-as-node.js';
+import { GeneratedNode } from './generated-node.js';
 import { OperationNode } from './operation-node.js';
 import { RawNode } from './raw-node.js';
 import { ReferencesNode } from './references-node.js';
-export declare type ColumnDefinitionNodeProps = Omit<Partial<ColumnDefinitionNode>, 'kind'>;
+export declare type ColumnDefinitionNodeProps = Omit<Partial<ColumnDefinitionNode>, 'kind' | 'dataType'>;
 export declare type ColumnDataTypeNode = DataTypeNode | RawNode;
 export interface ColumnDefinitionNode extends OperationNode {
     readonly kind: 'ColumnDefinitionNode';
     readonly column: ColumnNode;
     readonly dataType: ColumnDataTypeNode;
     readonly references?: ReferencesNode;
-    readonly primaryKey: boolean;
-    readonly autoIncrement: boolean;
-    readonly unique: boolean;
-    readonly nullable: boolean;
+    readonly primaryKey?: boolean;
+    readonly autoIncrement?: boolean;
+    readonly unique?: boolean;
+    readonly notNull?: boolean;
     readonly defaultTo?: DefaultValueNode;
     readonly check?: CheckConstraintNode;
-    readonly generatedAlwaysAs?: GeneratedAlwaysAsNode;
+    readonly generated?: GeneratedNode;
+    readonly unsigned?: boolean;
 }
 /**
  * @internal

package/dist/esm/operation-node/column-definition-node.js

@@ -12,10 +12,6 @@ export const ColumnDefinitionNode = freeze({
             kind: 'ColumnDefinitionNode',
             column: ColumnNode.create(column),
             dataType,
-            primaryKey: false,
-            autoIncrement: false,
-            unique: false,
-            nullable: true,
         });
     },
     cloneWith(node, props) {

package/dist/esm/operation-node/common-table-expression-name-node.d.ts

@@ -0,0 +1,15 @@
+import { ColumnNode } from './column-node.js';
+import { OperationNode } from './operation-node.js';
+import { TableNode } from './table-node.js';
+export interface CommonTableExpressionNameNode extends OperationNode {
+    readonly kind: 'CommonTableExpressionNameNode';
+    readonly table: TableNode;
+    readonly columns?: ReadonlyArray<ColumnNode>;
+}
+/**
+ * @internal
+ */
+export declare const CommonTableExpressionNameNode: Readonly<{
+    is(node: OperationNode): node is CommonTableExpressionNameNode;
+    create(tableName: string, columnNames?: readonly string[] | undefined): CommonTableExpressionNameNode;
+}>;

package/dist/esm/operation-node/common-table-expression-name-node.js

@@ -0,0 +1,20 @@
+import { freeze } from '../util/object-utils.js';
+import { ColumnNode } from './column-node.js';
+import { TableNode } from './table-node.js';
+/**
+ * @internal
+ */
+export const CommonTableExpressionNameNode = freeze({
+    is(node) {
+        return node.kind === 'CommonTableExpressionNameNode';
+    },
+    create(tableName, columnNames) {
+        return freeze({
+            kind: 'CommonTableExpressionNameNode',
+            table: TableNode.create(tableName),
+            columns: columnNames
+                ? freeze(columnNames.map(ColumnNode.create))
+                : undefined,
+        });
+    },
+});

package/dist/esm/operation-node/common-table-expression-node.d.ts

@@ -1,10 +1,10 @@
-import { IdentifierNode } from './identifier-node.js';
+import { CommonTableExpressionNameNode } from './common-table-expression-name-node.js';
 import { OperationNode } from './operation-node.js';
 import { QueryNode } from './query-node.js';
 import { RawNode } from './raw-node.js';
 export interface CommonTableExpressionNode extends OperationNode {
     readonly kind: 'CommonTableExpressionNode';
-    readonly name: IdentifierNode;
+    readonly name: CommonTableExpressionNameNode;
     readonly expression: QueryNode | RawNode;
 }
 /**
@@ -12,5 +12,5 @@ export interface CommonTableExpressionNode extends OperationNode {
  */
 export declare const CommonTableExpressionNode: Readonly<{
     is(node: OperationNode): node is CommonTableExpressionNode;
-    create(name: IdentifierNode, expression: QueryNode | RawNode): CommonTableExpressionNode;
+    create(name: CommonTableExpressionNameNode, expression: QueryNode | RawNode): CommonTableExpressionNode;
 }>;

package/dist/esm/operation-node/data-type-node.d.ts

@@ -1,5 +1,5 @@
 import { OperationNode } from './operation-node.js';
-export declare type ColumnDataType = 'varchar' | `varchar(${number})` | 'text' | 'integer' | 'int2' | 'int4' | 'int8' | 'bigint' | 'boolean' | 'real' | 'double precision' | 'float4' | 'float8' | 'decimal' | `decimal(${number}, ${number})` | 'numeric' | `numeric(${number}, ${number})` | 'binary' | 'date' | 'datetime' | 'time' | 'timetz' | 'timestamp' | 'timestamptz' | 'serial' | 'bigserial' | 'uuid' | 'json' | 'jsonb';
+export declare type ColumnDataType = 'varchar' | `varchar(${number})` | 'text' | 'integer' | 'int2' | 'int4' | 'int8' | 'bigint' | 'boolean' | 'real' | 'double precision' | 'float4' | 'float8' | 'decimal' | `decimal(${number}, ${number})` | 'numeric' | `numeric(${number}, ${number})` | 'binary' | 'date' | 'datetime' | 'time' | 'timetz' | 'timestamp' | 'timestamptz' | 'serial' | 'bigserial' | 'uuid' | 'json' | 'jsonb' | 'blob';
 export declare type DataTypeParams = Omit<DataTypeNode, 'kind' | 'dataType'>;
 export interface DataTypeNode extends OperationNode {
     readonly kind: 'DataTypeNode';

package/dist/esm/operation-node/generated-node.d.ts

@@ -0,0 +1,20 @@
+import { OperationNode } from './operation-node.js';
+import { RawNode } from './raw-node.js';
+export declare type GeneratedNodeParams = Omit<GeneratedNode, 'kind' | 'expression'>;
+export interface GeneratedNode extends OperationNode {
+    readonly kind: 'GeneratedNode';
+    readonly byDefault?: boolean;
+    readonly always?: boolean;
+    readonly identity?: boolean;
+    readonly stored?: boolean;
+    readonly expression?: RawNode;
+}
+/**
+ * @internal
+ */
+export declare const GeneratedNode: Readonly<{
+    is(node: OperationNode): node is GeneratedNode;
+    create(params: GeneratedNodeParams): GeneratedNode;
+    createWithExpression(expression: RawNode): GeneratedNode;
+    cloneWith(node: GeneratedNode, params: GeneratedNodeParams): GeneratedNode;
+}>;

package/dist/esm/operation-node/generated-node.js

@@ -0,0 +1,28 @@
+import { freeze } from '../util/object-utils.js';
+/**
+ * @internal
+ */
+export const GeneratedNode = freeze({
+    is(node) {
+        return node.kind === 'GeneratedNode';
+    },
+    create(params) {
+        return freeze({
+            kind: 'GeneratedNode',
+            ...params,
+        });
+    },
+    createWithExpression(expression) {
+        return freeze({
+            kind: 'GeneratedNode',
+            always: true,
+            expression,
+        });
+    },
+    cloneWith(node, params) {
+        return freeze({
+            ...node,
+            ...params,
+        });
+    },
+});