@hypequery/clickhouse 1.6.1 → 2.0.0

package/dist/migrations/schema/types.d.ts

@@ -1,74 +0,0 @@
-import type { SQLExpression } from '../../dataset/sql-tag.js';
-export type ClickHouseSqlExpression = string | SQLExpression;
-export type ClickHouseDefaultInput = string | number | boolean | null | SQLExpression;
-export interface ClickHouseSchemaAst {
-    tables: ClickHouseTableDefinition[];
-    materializedViews?: ClickHouseMaterializedViewDefinition[];
-}
-export interface ClickHouseSchemaDefinition {
-    tables: ClickHouseTableDefinition[];
-    materializedViews?: ClickHouseMaterializedViewDefinition[];
-}
-export interface ClickHouseTableDefinition {
-    kind: 'table';
-    name: string;
-    columns: ClickHouseColumnDefinition[];
-    engine: ClickHouseTableEngine;
-    settings?: Record<string, string | number | boolean>;
-}
-export interface ClickHouseTableInputDefinition {
-    columns: Record<string, ClickHouseColumnBuilderLike>;
-    engine: ClickHouseTableEngine;
-    settings?: Record<string, string | number | boolean>;
-}
-export interface ClickHouseColumnDefinition {
-    name: string;
-    type: ClickHouseColumnType;
-    default?: ClickHouseColumnDefaultValue;
-}
-export interface ClickHouseColumnBuilderLike {
-    build(name: string): ClickHouseColumnDefinition;
-}
-export type ClickHouseColumnDefaultValue = ClickHouseLiteralDefaultValue | ClickHouseSqlDefaultValue;
-export interface ClickHouseLiteralDefaultValue {
-    kind: 'literal';
-    value: string | number | boolean | null;
-}
-export interface ClickHouseSqlDefaultValue {
-    kind: 'sql';
-    value: ClickHouseSqlExpression;
-}
-export type ClickHouseColumnType = ClickHouseNamedColumnType | ClickHouseNullableColumnType | ClickHouseLowCardinalityColumnType;
-export interface ClickHouseNamedColumnType {
-    kind: 'named';
-    name: string;
-    arguments?: Array<string | number>;
-}
-export interface ClickHouseNullableColumnType {
-    kind: 'nullable';
-    inner: ClickHouseColumnType;
-}
-export interface ClickHouseLowCardinalityColumnType {
-    kind: 'low_cardinality';
-    inner: ClickHouseColumnType;
-}
-export interface ClickHouseTableEngine {
-    type: string;
-    orderBy?: ClickHouseSqlExpression[];
-    partitionBy?: ClickHouseSqlExpression;
-    primaryKey?: ClickHouseSqlExpression[];
-    sampleBy?: ClickHouseSqlExpression;
-}
-export interface ClickHouseMaterializedViewDefinition {
-    kind: 'materialized_view';
-    name: string;
-    from: string;
-    to?: string;
-    select: ClickHouseSqlExpression;
-}
-export interface ClickHouseMaterializedViewInputDefinition {
-    from: string | ClickHouseTableDefinition;
-    to?: string | ClickHouseTableDefinition;
-    select: ClickHouseSqlExpression;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/migrations/schema/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/migrations/schema/types.ts"],"names":[],"mappings":"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"}

package/dist/migrations/schema/types.js

@@ -1 +0,0 @@
-export {};

package/dist/migrations/snapshot/index.d.ts

@@ -1,3 +0,0 @@
-export { hashSnapshot, serializeSchemaToSnapshot, snapshotToStableJson, } from './serialize.js';
-export type { Snapshot, SnapshotColumn, SnapshotColumnDefault, SnapshotDependencyEdge, SnapshotMaterializedView, SnapshotTable, SnapshotTableEngine, } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrations/snapshot/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/snapshot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/migrations/snapshot/index.js

@@ -1 +0,0 @@
-export { hashSnapshot, serializeSchemaToSnapshot, snapshotToStableJson, } from './serialize.js';

package/dist/migrations/snapshot/serialize.d.ts

@@ -1,21 +0,0 @@
-import type { ClickHouseSchemaAst } from '../schema/types.js';
-import type { Snapshot } from './types.js';
-type SnapshotWithoutHash = Omit<Snapshot, 'contentHash'>;
-/**
- * Converts a schema AST into a deterministic ClickHouse snapshot.
- *
- * Snapshot serialization normalizes ordering, SQL-expression whitespace, type
- * wrappers, settings, and materialized-view dependencies before computing the
- * content hash used by migration metadata.
- */
-export declare function serializeSchemaToSnapshot(schema: ClickHouseSchemaAst): Snapshot;
-/**
- * Serializes a snapshot with stable formatting for writing to disk and hashing.
- */
-export declare function snapshotToStableJson(snapshot: Snapshot | SnapshotWithoutHash): string;
-/**
- * Computes the SHA-256 content hash for a normalized snapshot.
- */
-export declare function hashSnapshot(snapshot: Snapshot | SnapshotWithoutHash): string;
-export {};
-//# sourceMappingURL=serialize.d.ts.map

package/dist/migrations/snapshot/serialize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/migrations/snapshot/serialize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,YAAY,CAAC;AAEpB,KAAK,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CA6D/E;AAgBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,mBAAmB,GAAG,MAAM,CAErF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,mBAAmB,GAAG,MAAM,CAE7E"}

package/dist/migrations/snapshot/serialize.js

@@ -1,127 +0,0 @@
-import { createHash } from 'node:crypto';
-import { isSQLExpression } from '../../dataset/sql-tag.js';
-/**
- * Converts a schema AST into a deterministic ClickHouse snapshot.
- *
- * Snapshot serialization normalizes ordering, SQL-expression whitespace, type
- * wrappers, settings, and materialized-view dependencies before computing the
- * content hash used by migration metadata.
- */
-export function serializeSchemaToSnapshot(schema) {
-    const snapshot = {
-        version: 1,
-        dialect: 'clickhouse',
-        tables: [...schema.tables]
-            .sort((left, right) => left.name.localeCompare(right.name))
-            .map((table) => ({
-            name: table.name,
-            columns: [...table.columns]
-                .sort((left, right) => left.name.localeCompare(right.name))
-                .map((column) => ({
-                name: column.name,
-                type: normalizeColumnType(column.type),
-                ...(column.default !== undefined
-                    ? { default: normalizeColumnDefault(column.default) }
-                    : {}),
-            })),
-            engine: {
-                type: table.engine.type,
-                orderBy: (table.engine.orderBy ?? []).map(normalizeSqlExpression),
-                ...(table.engine.partitionBy !== undefined
-                    ? { partitionBy: normalizeSqlExpression(table.engine.partitionBy) }
-                    : {}),
-                primaryKey: (table.engine.primaryKey ?? []).map(normalizeSqlExpression),
-                ...(table.engine.sampleBy !== undefined
-                    ? { sampleBy: normalizeSqlExpression(table.engine.sampleBy) }
-                    : {}),
-            },
-            settings: Object.fromEntries(Object.entries(table.settings ?? {})
-                .sort(([left], [right]) => left.localeCompare(right))
-                .map(([key, value]) => [key, String(value)])),
-        })),
-        materializedViews: [...(schema.materializedViews ?? [])]
-            .sort((left, right) => left.name.localeCompare(right.name))
-            .map((view) => ({
-            name: view.name,
-            from: view.from,
-            ...(view.to !== undefined ? { to: view.to } : {}),
-            select: normalizeSqlExpression(view.select),
-        })),
-        dependencies: [...(schema.materializedViews ?? [])]
-            .sort((left, right) => left.name.localeCompare(right.name))
-            .map((view) => ({
-            from: view.from,
-            to: view.name,
-            kind: 'table_to_materialized_view',
-        })),
-    };
-    return {
-        ...snapshot,
-        contentHash: hashSnapshot(snapshot),
-    };
-}
-function normalizeColumnDefault(defaultValue) {
-    if (defaultValue.kind === 'literal') {
-        return {
-            kind: 'literal',
-            value: defaultValue.value,
-        };
-    }
-    return {
-        kind: 'sql',
-        value: normalizeSqlExpression(defaultValue.value),
-    };
-}
-/**
- * Serializes a snapshot with stable formatting for writing to disk and hashing.
- */
-export function snapshotToStableJson(snapshot) {
-    return JSON.stringify(snapshot, null, 2);
-}
-/**
- * Computes the SHA-256 content hash for a normalized snapshot.
- */
-export function hashSnapshot(snapshot) {
-    return createHash('sha256').update(snapshotToStableJson(snapshot)).digest('hex');
-}
-function normalizeColumnType(type) {
-    switch (type.kind) {
-        case 'named': {
-            const args = type.arguments?.length ? `(${type.arguments.join(', ')})` : '';
-            return `${type.name}${args}`;
-        }
-        case 'nullable':
-            return `Nullable(${normalizeColumnType(type.inner)})`;
-        case 'low_cardinality':
-            return `LowCardinality(${normalizeColumnType(type.inner)})`;
-        default: {
-            const exhaustiveCheck = type;
-            return exhaustiveCheck;
-        }
-    }
-}
-function normalizeSqlExpression(expression) {
-    const sql = typeof expression === 'string'
-        ? expression
-        : isSQLExpression(expression)
-            ? expression.sql
-            : String(expression);
-    const lines = sql
-        .replace(/\r\n/g, '\n')
-        .split('\n')
-        .map(line => line.replace(/\s+$/g, ''));
-    while (lines.length > 0 && lines[0].trim() === '') {
-        lines.shift();
-    }
-    while (lines.length > 0 && lines[lines.length - 1].trim() === '') {
-        lines.pop();
-    }
-    const indents = lines
-        .filter(line => line.trim().length > 0)
-        .map(line => line.match(/^\s*/)?.[0].length ?? 0);
-    const minIndent = indents.length > 0 ? Math.min(...indents) : 0;
-    return lines
-        .map(line => line.slice(minIndent))
-        .join('\n')
-        .trim();
-}

package/dist/migrations/snapshot/types.d.ts

@@ -1,47 +0,0 @@
-export interface Snapshot {
-    version: 1;
-    dialect: 'clickhouse';
-    tables: SnapshotTable[];
-    materializedViews: SnapshotMaterializedView[];
-    dependencies: SnapshotDependencyEdge[];
-    contentHash: string;
-}
-export interface SnapshotTable {
-    name: string;
-    columns: SnapshotColumn[];
-    engine: SnapshotTableEngine;
-    settings: Record<string, string>;
-}
-export interface SnapshotColumn {
-    name: string;
-    type: string;
-    default?: SnapshotColumnDefault;
-}
-export type SnapshotColumnDefault = SnapshotLiteralColumnDefault | SnapshotSqlColumnDefault;
-export interface SnapshotLiteralColumnDefault {
-    kind: 'literal';
-    value: string | number | boolean | null;
-}
-export interface SnapshotSqlColumnDefault {
-    kind: 'sql';
-    value: string;
-}
-export interface SnapshotTableEngine {
-    type: string;
-    orderBy: string[];
-    partitionBy?: string;
-    primaryKey: string[];
-    sampleBy?: string;
-}
-export interface SnapshotMaterializedView {
-    name: string;
-    from: string;
-    to?: string;
-    select: string;
-}
-export interface SnapshotDependencyEdge {
-    from: string;
-    to: string;
-    kind: 'table_to_materialized_view';
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/migrations/snapshot/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/migrations/snapshot/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;IAC9C,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,GAAG,wBAAwB,CAAC;AAE5F,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,4BAA4B,CAAC;CACpC"}

package/dist/migrations/snapshot/types.js

@@ -1 +0,0 @@
-export {};

package/dist/migrations/sql/index.d.ts

@@ -1,4 +0,0 @@
-export { renderMigrationArtifacts } from './render.js';
-export { writeMigrationArtifacts } from './write.js';
-export type { MigrationMeta, RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult, WriteMigrationArtifactsOptions, WriteMigrationArtifactsResult, } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrations/sql/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EACV,aAAa,EACb,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/dist/migrations/sql/index.js

@@ -1,2 +0,0 @@
-export { renderMigrationArtifacts } from './render.js';
-export { writeMigrationArtifacts } from './write.js';

package/dist/migrations/sql/render.d.ts

@@ -1,11 +0,0 @@
-import type { SnapshotDiffResult } from '../diff/types.js';
-import type { RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult } from './types.js';
-/**
- * Renders a snapshot diff into reviewable migration artifacts.
- *
- * The renderer produces forward SQL, best-effort reverse SQL, and metadata. It
- * also sequences dependent materialized views around table mutations so stored
- * view SELECT definitions are dropped and recreated with the target snapshot.
- */
-export declare function renderMigrationArtifacts(diff: SnapshotDiffResult, options: RenderMigrationArtifactsOptions): RenderMigrationArtifactsResult;
-//# sourceMappingURL=render.d.ts.map

package/dist/migrations/sql/render.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EAEV,+BAA+B,EAC/B,8BAA8B,EAG/B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAuChC"}

package/dist/migrations/sql/render.js

@@ -1,334 +0,0 @@
-/**
- * Renders a snapshot diff into reviewable migration artifacts.
- *
- * The renderer produces forward SQL, best-effort reverse SQL, and metadata. It
- * also sequences dependent materialized views around table mutations so stored
- * view SELECT definitions are dropped and recreated with the target snapshot.
- */
-export function renderMigrationArtifacts(diff, options) {
-    assertNoUnsupportedChanges(diff);
-    const upStatements = [];
-    const downStatements = [];
-    const consumedViewNames = new Set();
-    const renderedOperations = [];
-    let containsManualSteps = false;
-    for (const operation of normalizeOperationsForRendering(diff.operations)) {
-        if (isMaterializedViewOperation(operation) && consumedViewNames.has(getOperationViewName(operation))) {
-            continue;
-        }
-        renderedOperations.push({ kind: operation.kind });
-        upStatements.push(...renderOperationUp(operation, { diff, cluster: options.cluster }, consumedViewNames));
-        const renderedDown = renderOperationDown(operation, {
-            previousSnapshot: diff.previousSnapshot,
-            nextSnapshot: diff.nextSnapshot,
-            cluster: options.cluster,
-        }, consumedViewNames);
-        downStatements.unshift(...renderedDown.statements);
-        containsManualSteps = containsManualSteps || renderedDown.manual;
-    }
-    return {
-        upSql: joinStatements(upStatements),
-        downSql: joinStatements(downStatements),
-        meta: {
-            name: options.name,
-            timestamp: options.timestamp,
-            operations: renderedOperations,
-            sourceSnapshotHash: diff.previousSnapshot.contentHash,
-            targetSnapshotHash: diff.nextSnapshot.contentHash,
-            custom: false,
-            unsafe: diff.warnings.length > 0 || diff.unsupportedChanges.length > 0 || containsManualSteps,
-            containsManualSteps,
-        },
-    };
-}
-function renderOperationUp(operation, context, consumedViewNames) {
-    switch (operation.kind) {
-        case 'CreateTable':
-            return [renderCreateTable(operation.table, context.cluster)];
-        case 'DropTable':
-            return [renderDropTable(operation.tableName, context.cluster)];
-        case 'AddColumn':
-            return [renderAlterTableAddColumn(operation.tableName, operation.column, context.cluster)];
-        case 'DropColumn':
-            return [renderAlterTableDropColumn(operation.tableName, operation.columnName, context.cluster)];
-        case 'ModifyColumnDefault':
-        case 'ModifyColumnType': {
-            const nextColumn = requireColumn(context.diff.nextSnapshot, operation.tableName, operation.columnName);
-            return [renderAlterTableModifyColumn(operation.tableName, nextColumn, context.cluster)];
-        }
-        case 'CreateMaterializedView':
-            return [renderCreateMaterializedView({ view: operation.view, cluster: context.cluster })];
-        case 'DropMaterializedView':
-            return [renderDropMaterializedView(operation.viewName, context.cluster)];
-        case 'RecreateMaterializedView':
-            return [
-                renderDropMaterializedView(operation.previousView.name, context.cluster),
-                renderCreateMaterializedView({ view: operation.nextView, cluster: context.cluster }),
-            ];
-        case 'AlterTableWithDependentViews':
-            return renderAlterTableWithDependentViewsUp(operation, context, consumedViewNames);
-        default: {
-            const exhaustiveCheck = operation;
-            return exhaustiveCheck;
-        }
-    }
-}
-function renderOperationDown(operation, lookup, consumedViewNames) {
-    switch (operation.kind) {
-        case 'CreateTable':
-            return { statements: [renderDropTable(operation.table.name, lookup.cluster)], manual: false };
-        case 'DropTable':
-            return { statements: [manualDownComment(`recreate dropped table "${operation.tableName}" manually`)], manual: true };
-        case 'AddColumn':
-            return {
-                statements: [renderAlterTableDropColumn(operation.tableName, operation.column.name, lookup.cluster)],
-                manual: false,
-            };
-        case 'DropColumn':
-            return {
-                statements: [manualDownComment(`recreate dropped column "${operation.tableName}.${operation.columnName}" manually`)],
-                manual: true,
-            };
-        case 'ModifyColumnDefault': {
-            const previousColumn = requireColumn(lookup.previousSnapshot, operation.tableName, operation.columnName);
-            return {
-                statements: [renderAlterTableModifyColumn(operation.tableName, previousColumn, lookup.cluster)],
-                manual: false,
-            };
-        }
-        case 'ModifyColumnType':
-            return {
-                statements: [manualDownComment(`revert type change for "${operation.tableName}.${operation.columnName}" manually`)],
-                manual: true,
-            };
-        case 'CreateMaterializedView':
-            return { statements: [renderDropMaterializedView(operation.view.name, lookup.cluster)], manual: false };
-        case 'DropMaterializedView': {
-            const previousView = requireMaterializedView(lookup.previousSnapshot, operation.viewName);
-            return {
-                statements: [renderCreateMaterializedView({ view: previousView, cluster: lookup.cluster })],
-                manual: false,
-            };
-        }
-        case 'RecreateMaterializedView':
-            return {
-                statements: [
-                    renderDropMaterializedView(operation.nextView.name, lookup.cluster),
-                    renderCreateMaterializedView({ view: operation.previousView, cluster: lookup.cluster }),
-                ],
-                manual: false,
-            };
-        case 'AlterTableWithDependentViews':
-            return renderAlterTableWithDependentViewsDown(operation, lookup, consumedViewNames);
-        default: {
-            const exhaustiveCheck = operation;
-            return exhaustiveCheck;
-        }
-    }
-}
-function renderAlterTableWithDependentViewsUp(operation, context, consumedViewNames) {
-    const statements = [];
-    for (const viewName of operation.dependentViewNames) {
-        statements.push(renderDropMaterializedView(viewName, context.cluster));
-        consumedViewNames.add(viewName);
-    }
-    for (const nestedOperation of normalizeTableMutationOperations(operation.operations)) {
-        statements.push(...renderOperationUp(nestedOperation, context, consumedViewNames));
-    }
-    for (const viewName of operation.dependentViewNames) {
-        statements.push(renderCreateMaterializedView({
-            view: requireMaterializedView(context.diff.nextSnapshot, viewName),
-            cluster: context.cluster,
-        }));
-    }
-    return statements;
-}
-function renderAlterTableWithDependentViewsDown(operation, lookup, consumedViewNames) {
-    const statements = [];
-    let manual = false;
-    for (const viewName of operation.dependentViewNames) {
-        statements.push(renderDropMaterializedView(viewName, lookup.cluster));
-        consumedViewNames.add(viewName);
-    }
-    for (const nestedOperation of [...normalizeTableMutationOperations(operation.operations)].reverse()) {
-        const rendered = renderOperationDown(nestedOperation, lookup, consumedViewNames);
-        statements.push(...rendered.statements);
-        manual = manual || rendered.manual;
-    }
-    for (const viewName of operation.dependentViewNames) {
-        statements.push(renderCreateMaterializedView({
-            view: requireMaterializedView(lookup.previousSnapshot, viewName),
-            cluster: lookup.cluster,
-        }));
-    }
-    return { statements, manual };
-}
-function renderCreateTable(table, cluster) {
-    const columns = table.columns
-        .map(column => `  ${quoteIdentifier(column.name)} ${column.type}${renderColumnDefault(column)}`)
-        .join(',\n');
-    const settings = Object.keys(table.settings).length > 0
-        ? `\nSETTINGS ${Object.entries(table.settings).map(([key, value]) => `${key} = ${value}`).join(', ')}`
-        : '';
-    return [
-        `CREATE TABLE ${quoteIdentifier(table.name)}${renderClusterClause(cluster)} (`,
-        columns,
-        `) ENGINE = ${renderTableEngine(table)}${settings};`,
-    ].join('\n');
-}
-function renderDropTable(tableName, cluster) {
-    return `DROP TABLE ${quoteIdentifier(tableName)}${renderClusterClause(cluster)};`;
-}
-function renderAlterTableAddColumn(tableName, column, cluster) {
-    return `ALTER TABLE ${quoteIdentifier(tableName)}${renderClusterClause(cluster)} ADD COLUMN ` +
-        `${quoteIdentifier(column.name)} ${column.type}${renderColumnDefault(column)};`;
-}
-function renderAlterTableDropColumn(tableName, columnName, cluster) {
-    return `ALTER TABLE ${quoteIdentifier(tableName)}${renderClusterClause(cluster)} DROP COLUMN ${quoteIdentifier(columnName)};`;
-}
-function renderAlterTableModifyColumn(tableName, column, cluster) {
-    return `ALTER TABLE ${quoteIdentifier(tableName)}${renderClusterClause(cluster)} MODIFY COLUMN ` +
-        `${quoteIdentifier(column.name)} ${column.type}${renderColumnDefault(column)};`;
-}
-function renderCreateMaterializedView(context) {
-    const toClause = context.view.to ? `\nTO ${quoteIdentifier(context.view.to)}` : '';
-    return [
-        `CREATE MATERIALIZED VIEW ${quoteIdentifier(context.view.name)}${renderClusterClause(context.cluster)}${toClause} AS`,
-        context.view.select,
-        ';',
-    ].join('\n');
-}
-function renderDropMaterializedView(viewName, cluster) {
-    return `DROP TABLE ${quoteIdentifier(viewName)}${renderClusterClause(cluster)};`;
-}
-function renderTableEngine(table) {
-    const parts = [table.engine.type, `ORDER BY (${table.engine.orderBy.join(', ')})`];
-    if (table.engine.partitionBy) {
-        parts.push(`PARTITION BY ${table.engine.partitionBy}`);
-    }
-    if (table.engine.primaryKey.length > 0) {
-        parts.push(`PRIMARY KEY (${table.engine.primaryKey.join(', ')})`);
-    }
-    if (table.engine.sampleBy) {
-        parts.push(`SAMPLE BY ${table.engine.sampleBy}`);
-    }
-    return parts.join('\n');
-}
-function renderColumnDefault(column) {
-    return column.default !== undefined ? ` DEFAULT ${renderDefaultValue(column.default)}` : '';
-}
-function renderClusterClause(cluster) {
-    return cluster ? ` ON CLUSTER ${quoteIdentifier(cluster)}` : '';
-}
-function quoteIdentifier(identifier) {
-    if (identifier.trim() === '') {
-        throw new Error('Invalid ClickHouse identifier: identifiers must not be empty.');
-    }
-    return `\`${identifier.replace(/`/g, '``')}\``;
-}
-function requireColumn(snapshot, tableName, columnName) {
-    const table = snapshot.tables.find(candidate => candidate.name === tableName);
-    if (!table) {
-        throw new Error(`Table "${tableName}" not found in snapshot.`);
-    }
-    const column = table.columns.find(candidate => candidate.name === columnName);
-    if (!column) {
-        throw new Error(`Column "${tableName}.${columnName}" not found in snapshot.`);
-    }
-    return column;
-}
-function requireMaterializedView(snapshot, viewName) {
-    const view = snapshot.materializedViews.find(candidate => candidate.name === viewName);
-    if (!view) {
-        throw new Error(`Materialized view "${viewName}" not found in snapshot.`);
-    }
-    return view;
-}
-function isMaterializedViewOperation(operation) {
-    return operation.kind === 'DropMaterializedView' ||
-        operation.kind === 'CreateMaterializedView' ||
-        operation.kind === 'RecreateMaterializedView';
-}
-function getOperationViewName(operation) {
-    switch (operation.kind) {
-        case 'DropMaterializedView':
-            return operation.viewName;
-        case 'CreateMaterializedView':
-            return operation.view.name;
-        case 'RecreateMaterializedView':
-            return operation.nextView.name;
-        default: {
-            const exhaustiveCheck = operation;
-            return exhaustiveCheck;
-        }
-    }
-}
-function manualDownComment(message) {
-    return `-- MANUAL STEP REQUIRED: ${message}`;
-}
-function joinStatements(statements) {
-    return statements.join('\n\n').trim();
-}
-function renderDefaultValue(defaultValue) {
-    if (defaultValue.kind === 'sql') {
-        return defaultValue.value;
-    }
-    if (defaultValue.value === null) {
-        return 'NULL';
-    }
-    if (typeof defaultValue.value === 'number') {
-        return String(defaultValue.value);
-    }
-    if (typeof defaultValue.value === 'boolean') {
-        return defaultValue.value ? 'true' : 'false';
-    }
-    return `'${escapeStringLiteral(defaultValue.value)}'`;
-}
-function escapeStringLiteral(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/\0/g, '\\0')
-        .replace(/\x08/g, '\\b')
-        .replace(/\f/g, '\\f')
-        .replace(/\n/g, '\\n')
-        .replace(/\r/g, '\\r')
-        .replace(/\t/g, '\\t')
-        .replace(/\v/g, '\\v')
-        .replace(/'/g, "\\'");
-}
-function normalizeOperationsForRendering(operations) {
-    return operations.map(operation => {
-        if (operation.kind !== 'AlterTableWithDependentViews') {
-            return operation;
-        }
-        return {
-            ...operation,
-            operations: normalizeTableMutationOperations(operation.operations),
-        };
-    }).filter(operation => {
-        if (operation.kind !== 'ModifyColumnDefault') {
-            return true;
-        }
-        return !operations.some(candidate => candidate.kind === 'ModifyColumnType' &&
-            candidate.tableName === operation.tableName &&
-            candidate.columnName === operation.columnName);
-    });
-}
-function normalizeTableMutationOperations(operations) {
-    return operations.filter(operation => {
-        if (operation.kind !== 'ModifyColumnDefault') {
-            return true;
-        }
-        return !operations.some(candidate => candidate.kind === 'ModifyColumnType' &&
-            candidate.tableName === operation.tableName &&
-            candidate.columnName === operation.columnName);
-    });
-}
-function assertNoUnsupportedChanges(diff) {
-    if (diff.unsupportedChanges.length === 0) {
-        return;
-    }
-    throw new Error('Cannot render migration with unsupported changes:\n' +
-        diff.unsupportedChanges.map(change => `- ${change.message}`).join('\n') +
-        '\n\nUse a custom SQL migration for this change, or split the schema evolution into supported steps.');
-}