@hypequery/clickhouse 1.6.1 → 1.6.2

package/dist/cli/generate-types.js

@@ -2,6 +2,9 @@ import { ClickHouseConnection } from '../core/connection.js';
 import fs from 'fs/promises';
 import path from 'path';
 import dotenv from 'dotenv';
+import { clickhouseToTsType } from './type-parsing.js';
+
+export { clickhouseToTsType } from './type-parsing.js';
 
 // Load environment variables from the current directory
 dotenv.config();
@@ -18,87 +21,6 @@ dotenv.config();
  * @property {string[]} [excludeTables] - List of tables to exclude
  */
 
-/**
- * Converts ClickHouse types to TypeScript types
- * @param {string} type - The ClickHouse type to convert
- * @returns {string} - The corresponding TypeScript type
- */
-export const clickhouseToTsType = (type) => {
-  if (type.startsWith('Array(')) {
-    const innerType = type.slice(6, -1);
-    return `Array<${clickhouseToTsType(innerType)}>`;
-  }
-
-  // Handle Nullable types
-  if (type.startsWith('Nullable(')) {
-    const innerType = type.slice(9, -1);
-    return `${clickhouseToTsType(innerType)} | null`;
-  }
-
-  // Handle Map types
-  if (type.startsWith('Map(')) {
-    // Extract key and value types from Map(KeyType, ValueType)
-    const mapContent = type.slice(4, -1); // Remove 'Map(' and ')'
-    const commaIndex = mapContent.lastIndexOf(',');
-    if (commaIndex !== -1) {
-      const keyType = mapContent.substring(0, commaIndex).trim();
-      const valueType = mapContent.substring(commaIndex + 1).trim();
-
-      // Handle different value types
-      let valueTsType = 'unknown';
-      if (valueType.startsWith('Array(')) {
-        const innerType = valueType.slice(6, -1);
-        valueTsType = `Array<${clickhouseToTsType(innerType)}>`;
-      } else if (valueType.startsWith('Nullable(')) {
-        const innerType = valueType.slice(9, -1);
-        valueTsType = `${clickhouseToTsType(innerType)} | null`;
-      } else {
-        valueTsType = clickhouseToTsType(valueType);
-      }
-
-      // JSON object keys are strings even when ClickHouse map keys are numeric.
-      return `Record<string, ${valueTsType}>`;
-    }
-    return 'Record<string, unknown>';
-  }
-
-  switch (type.toLowerCase()) {
-    case 'string':
-    case 'fixedstring':
-      return 'string';
-    case 'int8':
-    case 'int16':
-    case 'int32':
-    case 'uint8':
-    case 'uint16':
-    case 'uint32':
-      return 'number';
-    case 'int64':
-    case 'uint64':
-    case 'uint128':
-    case 'uint256':
-    case 'int128':
-    case 'int256':
-      return 'string';
-    case 'float32':
-    case 'float64':
-    case 'decimal':
-      return 'number';
-    case 'datetime':
-    case 'datetime64':
-      return 'string'; // Use string for datetime
-    case 'date':
-    case 'date32':
-      return 'string'; // Use string for date
-    case 'bool':
-    case 'boolean':
-      return 'boolean';
-    default:
-      // For complex types or unknown types, return string as a safe default
-      return 'string';
-  }
-};
-
 /**
  * Generates TypeScript type definitions from the ClickHouse database schema
  * @param {string} outputPath - The file path where the type definitions will be written

package/dist/cli/type-parsing.js

@@ -0,0 +1,124 @@
+function splitTopLevelArgs(value) {
+  const parts = [];
+  let current = '';
+  let depth = 0;
+
+  for (const char of value) {
+    if (char === '(') {
+      depth += 1;
+      current += char;
+      continue;
+    }
+
+    if (char === ')') {
+      depth -= 1;
+      current += char;
+      continue;
+    }
+
+    if (char === ',' && depth === 0) {
+      parts.push(current.trim());
+      current = '';
+      continue;
+    }
+
+    current += char;
+  }
+
+  if (current.trim()) {
+    parts.push(current.trim());
+  }
+
+  return parts;
+}
+
+function unwrapType(type, wrapperName) {
+  const prefix = `${wrapperName}(`;
+  return type.startsWith(prefix) && type.endsWith(')')
+    ? type.slice(prefix.length, -1)
+    : null;
+}
+
+function getPrimitiveTsType(type) {
+  const lowerType = type.toLowerCase();
+
+  switch (lowerType) {
+    case 'string':
+    case 'uuid':
+      return 'string';
+    case 'int8':
+    case 'int16':
+    case 'int32':
+    case 'uint8':
+    case 'uint16':
+    case 'uint32':
+      return 'number';
+    case 'int64':
+    case 'uint64':
+    case 'uint128':
+    case 'uint256':
+    case 'int128':
+    case 'int256':
+      return 'string';
+    case 'float32':
+    case 'float64':
+    case 'decimal':
+      return 'number';
+    case 'datetime':
+    case 'datetime64':
+    case 'date':
+    case 'date32':
+      return 'string';
+    case 'bool':
+    case 'boolean':
+      return 'boolean';
+    default:
+      if (type.startsWith('FixedString(')) return 'string';
+      if (type.startsWith('Decimal(')) return 'number';
+      if (type.startsWith('DateTime64(')) return 'string';
+      if (type.startsWith('DateTime(')) return 'string';
+      if (type.startsWith('Enum8(')) return 'string';
+      if (type.startsWith('Enum16(')) return 'string';
+      return null;
+  }
+}
+
+export const clickhouseToTsType = (type) => {
+  const wrappedArrayType = unwrapType(type, 'Array');
+  if (wrappedArrayType) {
+    return `Array<${clickhouseToTsType(wrappedArrayType)}>`;
+  }
+
+  const wrappedNullableType = unwrapType(type, 'Nullable');
+  if (wrappedNullableType) {
+    return `${clickhouseToTsType(wrappedNullableType)} | null`;
+  }
+
+  const wrappedLowCardinalityType = unwrapType(type, 'LowCardinality');
+  if (wrappedLowCardinalityType) {
+    return clickhouseToTsType(wrappedLowCardinalityType);
+  }
+
+  const wrappedTupleType = unwrapType(type, 'Tuple');
+  if (wrappedTupleType) {
+    const tupleParts = splitTopLevelArgs(wrappedTupleType);
+    return `[${tupleParts.map(clickhouseToTsType).join(', ')}]`;
+  }
+
+  const wrappedMapType = unwrapType(type, 'Map');
+  if (wrappedMapType) {
+    const mapParts = splitTopLevelArgs(wrappedMapType);
+    if (mapParts.length === 2) {
+      const [, valueType] = mapParts;
+      // JSON object keys are strings even when ClickHouse map keys are numeric.
+      return `Record<string, ${clickhouseToTsType(valueType)}>`;
+    }
+    return 'Record<string, unknown>';
+  }
+
+  const primitiveType = getPrimitiveTsType(type);
+  if (primitiveType) return primitiveType;
+
+  // Unsupported or more complex ClickHouse types currently preserve the historical fallback.
+  return 'string';
+};

package/dist/index.d.ts

@@ -31,11 +31,13 @@ export { introspectDimension, introspectMetric, getDatasetSchema, getAllDatasetS
 export { defineConfig, resolveClickHouseConfig, DEFAULT_MIGRATIONS_OUT_DIR, DEFAULT_MIGRATIONS_PREFIX, DEFAULT_MIGRATIONS_TABLE, } from './migrations/config/index.js';
 export { column, ClickHouseColumnBuilder, defineMaterializedView, defineSchema, defineTable, } from './migrations/schema/index.js';
 export { diffSnapshots, } from './migrations/diff/index.js';
+export { createMigrationPlan, isMigrationPlan, } from './migrations/plan/index.js';
 export { serializeSchemaToSnapshot, snapshotToStableJson, hashSnapshot, } from './migrations/snapshot/index.js';
 export { renderMigrationArtifacts, writeMigrationArtifacts, } from './migrations/sql/index.js';
 export type { ClickHouseClusterConfig, ClickHouseMigrationDbCredentials, ClickHouseMigrationDirectoryConfig, HypequeryClickHouseConfig, MigrationFilePrefix, ResolvedHypequeryClickHouseConfig, } from './migrations/config/index.js';
 export type { ClickHouseColumnDefinition, ClickHouseColumnBuilderLike, ClickHouseColumnDefaultValue, ClickHouseColumnType, ClickHouseDefaultInput, ClickHouseLowCardinalityColumnType, ClickHouseLiteralDefaultValue, ClickHouseMaterializedViewDefinition, ClickHouseMaterializedViewInputDefinition, ClickHouseNamedColumnType, ClickHouseNullableColumnType, ClickHouseSqlDefaultValue, ClickHouseSchemaAst, ClickHouseSchemaDefinition, ClickHouseSqlExpression, ClickHouseTableDefinition, ClickHouseTableInputDefinition, ClickHouseTableEngine, } from './migrations/schema/index.js';
 export type { AddColumnOperation, AlterTableWithDependentViewsOperation, CreateMaterializedViewOperation, CreateTableOperation, DiffWarning, DropColumnOperation, DropMaterializedViewOperation, DropTableOperation, MigrationOperation, ModifyColumnDefaultOperation, ModifyColumnTypeOperation, RecreateMaterializedViewOperation, SnapshotDiffResult, TableMutationOperation, UnsupportedChange, } from './migrations/diff/index.js';
-export type { MigrationMeta, RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult, WriteMigrationArtifactsOptions, WriteMigrationArtifactsResult, } from './migrations/sql/index.js';
+export type { ClickHouseMigrationSyncSetting, ClickHouseMigrationPlanContext, ClickHouseTableCostStats, CreateMigrationPlanOptions, MigrationPlanAnalyzer, MigrationPlanAnalyzerContext, MigrationPlanAnalyzerResult, MigrationOperationClassification, MigrationOperationCostEstimate, MigrationPlan, MigrationPlanBlocker, MigrationPlanConfirmation, MigrationPlanDiagnostic, MigrationPlanDiagnosticLevel, MigrationPlanInput, PlannedMigrationOperation, } from './migrations/plan/index.js';
+export type { MigrationMeta, RenderMigrationArtifactsInput, RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult, WriteMigrationArtifactsOptions, WriteMigrationArtifactsResult, } from './migrations/sql/index.js';
 export type { Snapshot, SnapshotColumn, SnapshotColumnDefault, SnapshotDependencyEdge, SnapshotMaterializedView, SnapshotTable, SnapshotTableEngine, } from './migrations/snapshot/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -27,5 +27,6 @@ export { introspectDimension, introspectMetric, getDatasetSchema, getAllDatasetS
 export { defineConfig, resolveClickHouseConfig, DEFAULT_MIGRATIONS_OUT_DIR, DEFAULT_MIGRATIONS_PREFIX, DEFAULT_MIGRATIONS_TABLE, } from './migrations/config/index.js';
 export { column, ClickHouseColumnBuilder, defineMaterializedView, defineSchema, defineTable, } from './migrations/schema/index.js';
 export { diffSnapshots, } from './migrations/diff/index.js';
+export { createMigrationPlan, isMigrationPlan, } from './migrations/plan/index.js';
 export { serializeSchemaToSnapshot, snapshotToStableJson, hashSnapshot, } from './migrations/snapshot/index.js';
 export { renderMigrationArtifacts, writeMigrationArtifacts, } from './migrations/sql/index.js';

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

@@ -0,0 +1,3 @@
+export { createMigrationPlan, isMigrationPlan } from './plan.js';
+export type { ClickHouseMigrationSyncSetting, ClickHouseMigrationPlanContext, ClickHouseTableCostStats, CreateMigrationPlanOptions, MigrationPlanAnalyzer, MigrationPlanAnalyzerContext, MigrationPlanAnalyzerResult, MigrationOperationClassification, MigrationOperationCostEstimate, MigrationPlan, MigrationPlanBlocker, MigrationPlanConfirmation, MigrationPlanDiagnostic, MigrationPlanDiagnosticLevel, MigrationPlanInput, PlannedMigrationOperation, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjE,YAAY,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,gCAAgC,EAChC,8BAA8B,EAC9B,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/migrations/plan/index.js

@@ -0,0 +1 @@
+export { createMigrationPlan, isMigrationPlan } from './plan.js';

package/dist/migrations/plan/plan.d.ts

@@ -0,0 +1,12 @@
+import type { SnapshotDiffResult } from '../diff/types.js';
+import type { CreateMigrationPlanOptions, MigrationPlan, MigrationPlanInput } from './types.js';
+/**
+ * Converts a raw snapshot diff into an explicit migration plan.
+ *
+ * The initial planner is intentionally static: it classifies operations and
+ * carries diagnostics/blockers without querying a live ClickHouse instance.
+ * Later phases can enrich this plan with system-table cost estimates.
+ */
+export declare function createMigrationPlan(diff: SnapshotDiffResult, options?: CreateMigrationPlanOptions): MigrationPlan;
+export declare function isMigrationPlan(input: MigrationPlanInput): input is MigrationPlan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/migrations/plan/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/migrations/plan/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAIV,0BAA0B,EAG1B,aAAa,EAMb,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,0BAA+B,GACvC,aAAa,CAqFf;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,aAAa,CAMjF"}

package/dist/migrations/plan/plan.js

@@ -0,0 +1,416 @@
+/**
+ * Converts a raw snapshot diff into an explicit migration plan.
+ *
+ * The initial planner is intentionally static: it classifies operations and
+ * carries diagnostics/blockers without querying a live ClickHouse instance.
+ * Later phases can enrich this plan with system-table cost estimates.
+ */
+export function createMigrationPlan(diff, options = {}) {
+    const plannedOperations = diff.operations.map((operation, operationIndex) => planOperation(operation, operationIndex, diff, options));
+    const blockerDiagnostics = diff.unsupportedChanges.map((change) => ({
+        level: 'error',
+        kind: change.kind,
+        message: change.message,
+    }));
+    const warningDiagnostics = diff.warnings.map((warning) => ({
+        level: 'warning',
+        kind: warning.kind,
+        message: warning.message,
+    }));
+    const operationDiagnostics = plannedOperations.flatMap(operation => operation.diagnostics);
+    const requiredConfirmations = plannedOperations.flatMap(operation => operation.requiredConfirmations);
+    const recommendedSyncSettings = dedupeSyncSettings(plannedOperations.flatMap(operation => operation.recommendedSyncSettings));
+    const staticBlockers = plannedOperations.flatMap((operation, operationIndex) => operation.classification === 'forbidden'
+        ? [{
+                kind: 'ForbiddenOperation',
+                operationIndex,
+                message: forbiddenOperationMessage(operation.operation),
+            }]
+        : []);
+    const unsupportedBlockers = diff.unsupportedChanges.map(change => ({
+        kind: change.kind,
+        message: change.message,
+        tableName: change.tableName,
+        ...(change.columnName !== undefined ? { columnName: change.columnName } : {}),
+    }));
+    const plan = {
+        previousSnapshot: diff.previousSnapshot,
+        nextSnapshot: diff.nextSnapshot,
+        sourceSnapshotHash: diff.previousSnapshot.contentHash,
+        targetSnapshotHash: diff.nextSnapshot.contentHash,
+        operations: plannedOperations,
+        diagnostics: [
+            ...blockerDiagnostics,
+            ...warningDiagnostics,
+            ...operationDiagnostics,
+        ],
+        blockers: [
+            ...unsupportedBlockers,
+            ...staticBlockers,
+        ],
+        requiredConfirmations,
+        recommendedSyncSettings,
+        // Backward-compatible alias. These settings are recommendations for the future executor,
+        // not proof that generated SQL has applied them.
+        requiredSyncSettings: recommendedSyncSettings,
+    };
+    const analyzerResult = runAnalyzers(plan, diff, options.analyzers ?? [], options.context);
+    if (analyzerResult.diagnostics.length === 0 &&
+        analyzerResult.blockers.length === 0 &&
+        analyzerResult.confirmations.length === 0) {
+        return plan;
+    }
+    return {
+        ...plan,
+        diagnostics: [
+            ...plan.diagnostics,
+            ...analyzerResult.diagnostics,
+        ],
+        blockers: [
+            ...plan.blockers,
+            ...analyzerResult.blockers,
+        ],
+        requiredConfirmations: [
+            ...plan.requiredConfirmations,
+            ...analyzerResult.confirmations,
+        ],
+    };
+}
+export function isMigrationPlan(input) {
+    return 'blockers' in input &&
+        'diagnostics' in input &&
+        'requiredConfirmations' in input &&
+        Array.isArray(input.operations) &&
+        input.operations.every(operation => 'operation' in operation && 'classification' in operation);
+}
+function planOperation(operation, operationIndex, diff, options) {
+    const classification = classifyOperation(operation, diff.previousSnapshot.tables);
+    const costEstimate = estimateOperationCost(operation, options.context);
+    const diagnostics = diagnosticsForOperation(operation, classification, operationIndex, costEstimate, options.context);
+    const requiredConfirmations = confirmationsForOperation(operation, classification, operationIndex, options);
+    return {
+        operation,
+        classification,
+        costEstimate,
+        diagnostics,
+        requiredConfirmations,
+        recommendedSyncSettings: syncSettingsForOperation(operation, classification),
+        requiredSyncSettings: syncSettingsForOperation(operation, classification),
+    };
+}
+function classifyOperation(operation, previousTables) {
+    switch (operation.kind) {
+        case 'ModifyColumnType':
+            return isKeyColumn(previousTables, operation.tableName, operation.columnName)
+                ? 'forbidden'
+                : 'mutation';
+        case 'AlterTableWithDependentViews':
+            return classifyAlterTableWithDependentViews(operation, previousTables);
+        case 'DropColumn':
+            return isKeyColumn(previousTables, operation.tableName, operation.columnName)
+                ? 'forbidden'
+                : 'metadata';
+        case 'AddColumn':
+        case 'CreateMaterializedView':
+        case 'CreateTable':
+        case 'DropMaterializedView':
+        case 'DropTable':
+        case 'ModifyColumnDefault':
+        case 'RecreateMaterializedView':
+            return 'metadata';
+        default: {
+            const exhaustiveCheck = operation;
+            return exhaustiveCheck;
+        }
+    }
+}
+function classifyAlterTableWithDependentViews(operation, previousTables) {
+    const nestedClassifications = operation.operations.map(nestedOperation => classifyTableMutationOperation(nestedOperation, previousTables));
+    if (nestedClassifications.includes('forbidden')) {
+        return 'forbidden';
+    }
+    if (nestedClassifications.includes('mutation')) {
+        return 'mutation';
+    }
+    if (nestedClassifications.includes('data-copy')) {
+        return 'data-copy';
+    }
+    return 'metadata';
+}
+function classifyTableMutationOperation(operation, previousTables) {
+    if ((operation.kind === 'DropColumn' || operation.kind === 'ModifyColumnType') &&
+        isKeyColumn(previousTables, operation.tableName, operation.columnName)) {
+        return 'forbidden';
+    }
+    return operation.kind === 'ModifyColumnType' ? 'mutation' : 'metadata';
+}
+function diagnosticsForOperation(operation, classification, operationIndex, costEstimate, context) {
+    const diagnostics = [];
+    if (classification === 'mutation') {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'MutationOperation',
+            operationIndex,
+            message: `Operation "${operation.kind}" may trigger a ClickHouse mutation. ` +
+                'Review table size and mutation impact before applying.',
+        });
+    }
+    if (classification === 'forbidden') {
+        diagnostics.push({
+            level: 'error',
+            kind: 'ForbiddenOperation',
+            operationIndex,
+            message: forbiddenOperationMessage(operation),
+        });
+    }
+    if (operation.kind === 'DropTable') {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'DestructiveDropTable',
+            operationIndex,
+            message: `Operation drops table "${operation.tableName}".`,
+        });
+    }
+    if (operation.kind === 'DropColumn') {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'DestructiveDropColumn',
+            operationIndex,
+            message: `Operation drops column "${operation.tableName}.${operation.columnName}".`,
+        });
+    }
+    diagnostics.push(...costDiagnosticsForOperation(operation, classification, operationIndex, costEstimate, context));
+    return diagnostics;
+}
+function confirmationsForOperation(operation, classification, operationIndex, options) {
+    if (classification !== 'mutation' || options.requireConfirmationForMutations === false) {
+        return [];
+    }
+    return [
+        {
+            kind: 'MutationRequiresConfirmation',
+            operationIndex,
+            message: `Operation "${operation.kind}" is classified as a mutation and should require explicit confirmation.`,
+        },
+    ];
+}
+function syncSettingsForOperation(operation, classification) {
+    if (classification === 'forbidden') {
+        return [];
+    }
+    const settings = [];
+    if (operation.kind !== 'CreateTable' && operation.kind !== 'CreateMaterializedView') {
+        settings.push({
+            name: 'alter_sync',
+            value: 2,
+            reason: 'Wait for ClickHouse ALTER/DDL operations to finish on active replicas where supported.',
+        });
+    }
+    if (classification === 'mutation') {
+        settings.push({
+            name: 'mutations_sync',
+            value: 2,
+            reason: 'Wait for mutation-triggering ALTER operations to finish before marking the step complete.',
+        });
+    }
+    return settings;
+}
+function dedupeSyncSettings(settings) {
+    const seen = new Set();
+    const deduped = [];
+    for (const setting of settings) {
+        const key = `${setting.name}:${setting.value}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(setting);
+    }
+    return deduped;
+}
+function runAnalyzers(plan, diff, analyzers, context) {
+    const results = analyzers.map((analyzer, index) => {
+        try {
+            return analyzer(plan, { diff, clickhouse: context });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                diagnostics: [{
+                        level: 'error',
+                        kind: 'AnalyzerError',
+                        message: `Analyzer at index ${index} failed: ${message}`,
+                    }],
+                blockers: [{
+                        kind: 'AnalyzerError',
+                        message: `Analyzer at index ${index} failed: ${message}`,
+                    }],
+            };
+        }
+    });
+    return {
+        diagnostics: results.flatMap(result => result.diagnostics ?? []),
+        blockers: results.flatMap(result => result.blockers ?? []),
+        confirmations: results.flatMap(result => result.confirmations ?? []),
+    };
+}
+function estimateOperationCost(operation, context) {
+    const tableName = getOperationTableName(operation);
+    if (!tableName) {
+        return {
+            source: 'static',
+            confidence: 'none',
+        };
+    }
+    const stats = getTableStats(context, tableName);
+    if (!stats) {
+        return {
+            tableName,
+            source: 'static',
+            confidence: 'none',
+        };
+    }
+    return {
+        tableName,
+        affectedRows: stats.totalRows,
+        affectedBytes: stats.totalBytes,
+        activeParts: stats.activeParts,
+        pendingMutations: stats.pendingMutations,
+        replicaAbsoluteDelaySeconds: stats.replicaAbsoluteDelaySeconds,
+        replicaQueueSize: stats.replicaQueueSize,
+        source: 'provided-context',
+        confidence: 'medium',
+    };
+}
+function costDiagnosticsForOperation(operation, classification, operationIndex, costEstimate, context) {
+    if (costEstimate.source !== 'provided-context') {
+        return [];
+    }
+    const diagnostics = [];
+    const mutationWarningBytes = atLeast(context?.mutationWarningBytes, 0, 1024 ** 3);
+    const mutationWarningRows = atLeast(context?.mutationWarningRows, 1, 100_000_000);
+    const activePartsWarningThreshold = atLeast(context?.activePartsWarningThreshold, 1, 200);
+    const pendingMutationsWarningThreshold = atLeast(context?.pendingMutationsWarningThreshold, 0, 0);
+    const replicaDelayWarningSeconds = atLeast(context?.replicaDelayWarningSeconds, 0, 60);
+    if (classification === 'mutation' &&
+        costEstimate.affectedBytes !== undefined &&
+        costEstimate.affectedBytes >= mutationWarningBytes) {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'ExpensiveMutationBytes',
+            operationIndex,
+            message: `Operation "${operation.kind}" may mutate ${costEstimate.affectedBytes} bytes ` +
+                `on table "${costEstimate.tableName}".`,
+        });
+    }
+    if (classification === 'mutation' &&
+        costEstimate.affectedRows !== undefined &&
+        costEstimate.affectedRows >= mutationWarningRows) {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'ExpensiveMutationRows',
+            operationIndex,
+            message: `Operation "${operation.kind}" may mutate ${costEstimate.affectedRows} rows ` +
+                `on table "${costEstimate.tableName}".`,
+        });
+    }
+    if (costEstimate.activeParts !== undefined && costEstimate.activeParts >= activePartsWarningThreshold) {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'HighActivePartCount',
+            operationIndex,
+            message: `Table "${costEstimate.tableName}" has ${costEstimate.activeParts} active parts. ` +
+                'Consider reducing part pressure before applying DDL.',
+        });
+    }
+    if (costEstimate.pendingMutations !== undefined &&
+        costEstimate.pendingMutations > pendingMutationsWarningThreshold) {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'PendingMutations',
+            operationIndex,
+            message: `Table "${costEstimate.tableName}" has ${costEstimate.pendingMutations} pending mutation(s).`,
+        });
+    }
+    if (costEstimate.replicaAbsoluteDelaySeconds !== undefined &&
+        costEstimate.replicaAbsoluteDelaySeconds >= replicaDelayWarningSeconds) {
+        diagnostics.push({
+            level: 'warning',
+            kind: 'ReplicaDelay',
+            operationIndex,
+            message: `Table "${costEstimate.tableName}" has replica delay of ` +
+                `${costEstimate.replicaAbsoluteDelaySeconds} second(s).`,
+        });
+    }
+    return diagnostics;
+}
+function forbiddenOperationMessage(operation) {
+    if (operation.kind === 'DropColumn' || operation.kind === 'ModifyColumnType') {
+        return [
+            `Cannot ${operation.kind === 'DropColumn' ? 'drop' : 'modify'} key column ` +
+                `"${operation.tableName}.${operation.columnName}" automatically.`,
+            'ClickHouse key columns participate in ORDER BY, PRIMARY KEY, PARTITION BY, or SAMPLE BY expressions.',
+            'Recommended approach: create a new table with the desired schema, backfill data in controlled batches, swap tables, then drop the old table.',
+            'Use a custom SQL migration if you understand the operational risk.',
+        ].join(' ');
+    }
+    return [
+        `Operation "${operation.kind}" cannot be generated safely.`,
+        'Use a custom SQL migration or split the schema evolution into supported steps.',
+    ].join(' ');
+}
+function atLeast(value, minimum, fallback) {
+    if (value === undefined || Number.isNaN(value)) {
+        return fallback;
+    }
+    return Math.max(minimum, value);
+}
+function getOperationTableName(operation) {
+    switch (operation.kind) {
+        case 'AddColumn':
+        case 'AlterTableWithDependentViews':
+        case 'DropColumn':
+        case 'DropTable':
+        case 'ModifyColumnDefault':
+        case 'ModifyColumnType':
+            return operation.tableName;
+        case 'CreateTable':
+            return operation.table.name;
+        case 'CreateMaterializedView':
+        case 'DropMaterializedView':
+        case 'RecreateMaterializedView':
+            return undefined;
+        default: {
+            const exhaustiveCheck = operation;
+            return exhaustiveCheck;
+        }
+    }
+}
+function getTableStats(context, tableName) {
+    if (!context?.tables) {
+        return undefined;
+    }
+    if (Array.isArray(context.tables)) {
+        return context.tables.find(table => table.tableName === tableName);
+    }
+    return context.tables[tableName];
+}
+function isKeyColumn(tables, tableName, columnName) {
+    const table = tables.find(candidate => candidate.name === tableName);
+    if (!table) {
+        return false;
+    }
+    return [
+        ...table.engine.orderBy,
+        ...table.engine.primaryKey,
+        table.engine.partitionBy,
+        table.engine.sampleBy,
+    ].some(expression => expression !== undefined && expressionReferencesColumn(expression, columnName));
+}
+function expressionReferencesColumn(expression, columnName) {
+    if (expression === columnName) {
+        return true;
+    }
+    const escapedColumn = columnName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(^|[^A-Za-z0-9_])${escapedColumn}([^A-Za-z0-9_]|$)`).test(expression);
+}

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

@@ -0,0 +1,93 @@
+import type { MigrationOperation, SnapshotDiffResult } from '../diff/types.js';
+import type { Snapshot } from '../snapshot/types.js';
+export type MigrationOperationClassification = 'metadata' | 'mutation' | 'data-copy' | 'forbidden';
+export type MigrationPlanDiagnosticLevel = 'warning' | 'error';
+export interface MigrationPlanDiagnostic {
+    level: MigrationPlanDiagnosticLevel;
+    kind: string;
+    message: string;
+    operationIndex?: number;
+}
+export interface MigrationPlanBlocker {
+    kind: string;
+    message: string;
+    tableName?: string;
+    columnName?: string;
+    operationIndex?: number;
+}
+export interface MigrationPlanConfirmation {
+    kind: string;
+    message: string;
+    operationIndex: number;
+}
+export interface ClickHouseMigrationSyncSetting {
+    name: 'alter_sync' | 'mutations_sync' | 'replication_alter_partitions_sync' | 'distributed_ddl_task_timeout';
+    value: string | number;
+    reason: string;
+}
+export interface ClickHouseTableCostStats {
+    tableName: string;
+    totalRows?: number;
+    totalBytes?: number;
+    activeParts?: number;
+    pendingMutations?: number;
+    replicaAbsoluteDelaySeconds?: number;
+    replicaQueueSize?: number;
+}
+export interface ClickHouseMigrationPlanContext {
+    tables?: Record<string, ClickHouseTableCostStats> | ClickHouseTableCostStats[];
+    mutationWarningBytes?: number;
+    mutationWarningRows?: number;
+    activePartsWarningThreshold?: number;
+    pendingMutationsWarningThreshold?: number;
+    replicaDelayWarningSeconds?: number;
+}
+export interface MigrationOperationCostEstimate {
+    tableName?: string;
+    affectedRows?: number;
+    affectedBytes?: number;
+    activeParts?: number;
+    pendingMutations?: number;
+    replicaAbsoluteDelaySeconds?: number;
+    replicaQueueSize?: number;
+    source: 'static' | 'provided-context';
+    confidence: 'none' | 'low' | 'medium';
+}
+export interface PlannedMigrationOperation {
+    operation: MigrationOperation;
+    classification: MigrationOperationClassification;
+    costEstimate: MigrationOperationCostEstimate;
+    diagnostics: MigrationPlanDiagnostic[];
+    requiredConfirmations: MigrationPlanConfirmation[];
+    recommendedSyncSettings: ClickHouseMigrationSyncSetting[];
+    requiredSyncSettings: ClickHouseMigrationSyncSetting[];
+}
+export interface MigrationPlan {
+    previousSnapshot: Snapshot;
+    nextSnapshot: Snapshot;
+    sourceSnapshotHash: string;
+    targetSnapshotHash: string;
+    operations: PlannedMigrationOperation[];
+    diagnostics: MigrationPlanDiagnostic[];
+    blockers: MigrationPlanBlocker[];
+    requiredConfirmations: MigrationPlanConfirmation[];
+    recommendedSyncSettings: ClickHouseMigrationSyncSetting[];
+    requiredSyncSettings: ClickHouseMigrationSyncSetting[];
+}
+export interface MigrationPlanAnalyzerContext {
+    diff: SnapshotDiffResult;
+    clickhouse?: ClickHouseMigrationPlanContext;
+}
+export interface MigrationPlanAnalyzerResult {
+    diagnostics?: MigrationPlanDiagnostic[];
+    blockers?: MigrationPlanBlocker[];
+    confirmations?: MigrationPlanConfirmation[];
+}
+export type MigrationPlanAnalyzer = (plan: MigrationPlan, context: MigrationPlanAnalyzerContext) => MigrationPlanAnalyzerResult;
+export interface CreateMigrationPlanOptions {
+    requireConfirmationForMutations?: boolean;
+    analyzers?: MigrationPlanAnalyzer[];
+    context?: ClickHouseMigrationPlanContext;
+}
+export type MigrationPlanInput = SnapshotDiffResult | MigrationPlan;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/migrations/plan/types.js

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

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

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

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

@@ -1 +1 @@
-{"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"}
+{"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,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

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

@@ -1,5 +1,4 @@
-import type { SnapshotDiffResult } from '../diff/types.js';
-import type { RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult } from './types.js';
+import type { RenderMigrationArtifactsInput, RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult } from './types.js';
 /**
  * Renders a snapshot diff into reviewable migration artifacts.
  *
@@ -7,5 +6,5 @@ import type { RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult }
  * 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;
+export declare function renderMigrationArtifacts(input: RenderMigrationArtifactsInput, options: RenderMigrationArtifactsOptions): RenderMigrationArtifactsResult;
 //# sourceMappingURL=render.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/render.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,EAG/B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAkDhC"}

package/dist/migrations/sql/render.js

@@ -1,3 +1,4 @@
+import { createMigrationPlan, isMigrationPlan } from '../plan/index.js';
 /**
  * Renders a snapshot diff into reviewable migration artifacts.
  *
@@ -5,22 +6,27 @@
  * 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);
+export function renderMigrationArtifacts(input, options) {
+    const plan = isMigrationPlan(input) ? input : createMigrationPlan(input);
+    assertNoPlanBlockers(plan);
     const upStatements = [];
     const downStatements = [];
     const consumedViewNames = new Set();
     const renderedOperations = [];
     let containsManualSteps = false;
-    for (const operation of normalizeOperationsForRendering(diff.operations)) {
+    for (const plannedOperation of normalizeOperationsForRendering(plan.operations)) {
+        const { operation } = plannedOperation;
         if (isMaterializedViewOperation(operation) && consumedViewNames.has(getOperationViewName(operation))) {
             continue;
         }
-        renderedOperations.push({ kind: operation.kind });
-        upStatements.push(...renderOperationUp(operation, { diff, cluster: options.cluster }, consumedViewNames));
+        renderedOperations.push({
+            kind: operation.kind,
+            classification: plannedOperation.classification,
+        });
+        upStatements.push(...renderOperationUp(operation, { plan, cluster: options.cluster }, consumedViewNames));
         const renderedDown = renderOperationDown(operation, {
-            previousSnapshot: diff.previousSnapshot,
-            nextSnapshot: diff.nextSnapshot,
+            previousSnapshot: plan.previousSnapshot,
+            nextSnapshot: plan.nextSnapshot,
             cluster: options.cluster,
         }, consumedViewNames);
         downStatements.unshift(...renderedDown.statements);
@@ -33,12 +39,15 @@ export function renderMigrationArtifacts(diff, options) {
             name: options.name,
             timestamp: options.timestamp,
             operations: renderedOperations,
-            sourceSnapshotHash: diff.previousSnapshot.contentHash,
-            targetSnapshotHash: diff.nextSnapshot.contentHash,
+            sourceSnapshotHash: plan.sourceSnapshotHash,
+            targetSnapshotHash: plan.targetSnapshotHash,
             custom: false,
-            unsafe: diff.warnings.length > 0 || diff.unsupportedChanges.length > 0 || containsManualSteps,
+            unsafe: plan.diagnostics.some(diagnostic => diagnostic.level === 'warning') ||
+                plan.blockers.length > 0 ||
+                containsManualSteps,
             containsManualSteps,
         },
+        plan,
     };
 }
 function renderOperationUp(operation, context, consumedViewNames) {
@@ -53,7 +62,7 @@ function renderOperationUp(operation, context, consumedViewNames) {
             return [renderAlterTableDropColumn(operation.tableName, operation.columnName, context.cluster)];
         case 'ModifyColumnDefault':
         case 'ModifyColumnType': {
-            const nextColumn = requireColumn(context.diff.nextSnapshot, operation.tableName, operation.columnName);
+            const nextColumn = requireColumn(context.plan.nextSnapshot, operation.tableName, operation.columnName);
             return [renderAlterTableModifyColumn(operation.tableName, nextColumn, context.cluster)];
         }
         case 'CreateMaterializedView':
@@ -137,7 +146,7 @@ function renderAlterTableWithDependentViewsUp(operation, context, consumedViewNa
     }
     for (const viewName of operation.dependentViewNames) {
         statements.push(renderCreateMaterializedView({
-            view: requireMaterializedView(context.diff.nextSnapshot, viewName),
+            view: requireMaterializedView(context.plan.nextSnapshot, viewName),
             cluster: context.cluster,
         }));
     }
@@ -297,21 +306,25 @@ function escapeStringLiteral(value) {
         .replace(/'/g, "\\'");
 }
 function normalizeOperationsForRendering(operations) {
-    return operations.map(operation => {
-        if (operation.kind !== 'AlterTableWithDependentViews') {
-            return operation;
+    return operations.map(plannedOperation => {
+        if (plannedOperation.operation.kind !== 'AlterTableWithDependentViews') {
+            return plannedOperation;
         }
         return {
-            ...operation,
-            operations: normalizeTableMutationOperations(operation.operations),
+            ...plannedOperation,
+            operation: {
+                ...plannedOperation.operation,
+                operations: normalizeTableMutationOperations(plannedOperation.operation.operations),
+            },
         };
-    }).filter(operation => {
-        if (operation.kind !== 'ModifyColumnDefault') {
+    }).filter(plannedOperation => {
+        if (plannedOperation.operation.kind !== 'ModifyColumnDefault') {
             return true;
         }
-        return !operations.some(candidate => candidate.kind === 'ModifyColumnType' &&
-            candidate.tableName === operation.tableName &&
-            candidate.columnName === operation.columnName);
+        const operation = plannedOperation.operation;
+        return !operations.some(candidate => candidate.operation.kind === 'ModifyColumnType' &&
+            candidate.operation.tableName === operation.tableName &&
+            candidate.operation.columnName === operation.columnName);
     });
 }
 function normalizeTableMutationOperations(operations) {
@@ -324,11 +337,11 @@ function normalizeTableMutationOperations(operations) {
             candidate.columnName === operation.columnName);
     });
 }
-function assertNoUnsupportedChanges(diff) {
-    if (diff.unsupportedChanges.length === 0) {
+function assertNoPlanBlockers(plan) {
+    if (plan.blockers.length === 0) {
         return;
     }
     throw new Error('Cannot render migration with unsupported changes:\n' +
-        diff.unsupportedChanges.map(change => `- ${change.message}`).join('\n') +
+        plan.blockers.map(blocker => `- ${blocker.message}`).join('\n') +
         '\n\nUse a custom SQL migration for this change, or split the schema evolution into supported steps.');
 }

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

@@ -1,10 +1,12 @@
 import type { MigrationOperation, SnapshotDiffResult } from '../diff/types.js';
+import type { MigrationOperationClassification, MigrationPlan, MigrationPlanInput } from '../plan/types.js';
 import type { Snapshot, SnapshotMaterializedView } from '../snapshot/types.js';
 export interface MigrationMeta {
     name: string;
     timestamp: string;
     operations: Array<{
         kind: MigrationOperation['kind'];
+        classification: MigrationOperationClassification;
     }>;
     sourceSnapshotHash: string;
     targetSnapshotHash: string;
@@ -21,9 +23,10 @@ export interface RenderMigrationArtifactsResult {
     upSql: string;
     downSql: string;
     meta: MigrationMeta;
+    plan: MigrationPlan;
 }
 export interface RenderSqlContext {
-    diff: SnapshotDiffResult;
+    plan: MigrationPlan;
     cluster?: string;
 }
 export interface MaterializedViewRenderContext {
@@ -40,9 +43,11 @@ export interface WriteMigrationArtifactsResult {
     upPath: string;
     downPath: string;
     metaPath: string;
+    planPath: string;
 }
 export interface SnapshotLookup {
     previousSnapshot: Snapshot;
     nextSnapshot: Snapshot;
 }
+export type RenderMigrationArtifactsInput = MigrationPlanInput | SnapshotDiffResult;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,8BAA8B,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,YAAY,EAAE,QAAQ,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EACV,gCAAgC,EAChC,aAAa,EACb,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjC,cAAc,EAAE,gCAAgC,CAAC;KAClD,CAAC,CAAC;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,8BAA8B,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,YAAY,EAAE,QAAQ,CAAC;CACxB;AAED,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,GAAG,kBAAkB,CAAC"}

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

@@ -3,7 +3,8 @@ import type { WriteMigrationArtifactsOptions, WriteMigrationArtifactsResult } fr
  * Writes rendered migration artifacts to a migration directory.
  *
  * The migration name must be a single safe path segment. The writer creates
- * `up.sql`, `down.sql`, and `meta.json` files under `outDir/migrationName`.
+ * `up.sql`, `down.sql`, `meta.json`, and `plan.json` files under
+ * `outDir/migrationName`.
  */
 export declare function writeMigrationArtifacts(options: WriteMigrationArtifactsOptions): Promise<WriteMigrationArtifactsResult>;
 //# sourceMappingURL=write.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAoBxC"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAuBxC"}

package/dist/migrations/sql/write.js

@@ -4,7 +4,8 @@ import path from 'node:path';
  * Writes rendered migration artifacts to a migration directory.
  *
  * The migration name must be a single safe path segment. The writer creates
- * `up.sql`, `down.sql`, and `meta.json` files under `outDir/migrationName`.
+ * `up.sql`, `down.sql`, `meta.json`, and `plan.json` files under
+ * `outDir/migrationName`.
  */
 export async function writeMigrationArtifacts(options) {
     assertValidMigrationName(options.migrationName);
@@ -13,14 +14,17 @@ export async function writeMigrationArtifacts(options) {
     const upPath = path.join(migrationDir, 'up.sql');
     const downPath = path.join(migrationDir, 'down.sql');
     const metaPath = path.join(migrationDir, 'meta.json');
+    const planPath = path.join(migrationDir, 'plan.json');
     await writeFile(upPath, `${options.artifacts.upSql}\n`, 'utf8');
     await writeFile(downPath, `${options.artifacts.downSql}\n`, 'utf8');
     await writeFile(metaPath, `${JSON.stringify(options.artifacts.meta, null, 2)}\n`, 'utf8');
+    await writeFile(planPath, `${JSON.stringify(options.artifacts.plan, null, 2)}\n`, 'utf8');
     return {
         migrationDir,
         upPath,
         downPath,
         metaPath,
+        planPath,
     };
 }
 function assertValidMigrationName(migrationName) {

package/dist/types/clickhouse-types.d.ts

@@ -1,3 +1,4 @@
+import type { ParseTopLevelArgs } from './type-helpers.js';
 export type ClickHouseInteger = 'Int8' | 'Int16' | 'Int32' | 'Int64' | 'Int128' | 'Int256' | 'UInt8' | 'UInt16' | 'UInt32' | 'UInt64' | 'UInt128' | 'UInt256';
 export type ClickHouseJsSafeInteger = 'Int8' | 'Int16' | 'Int32' | 'UInt8' | 'UInt16' | 'UInt32';
 export type ClickHouseJsUnsafeInteger = Exclude<ClickHouseInteger, ClickHouseJsSafeInteger>;
@@ -8,8 +9,10 @@ export type ClickHouseString = 'String' | `FixedString(${number})` | 'UUID';
 export type ClickHouseBoolean = 'Bool' | 'Boolean';
 export type ClickHouseEnum = `Enum8(${string})` | `Enum16(${string})`;
 export type ClickHouseBaseType = ClickHouseInteger | ClickHouseFloat | ClickHouseDecimal | ClickHouseDateTime | ClickHouseString | ClickHouseBoolean | ClickHouseEnum;
-export type ClickHouseType = ClickHouseBaseType | `Array(${ClickHouseBaseType})` | `Array(Nullable(${ClickHouseBaseType}))` | `Array(LowCardinality(String))` | `Array(LowCardinality(${ClickHouseEnum}))` | `Nullable(${ClickHouseBaseType})` | `Nullable(Array(${ClickHouseBaseType}))` | `LowCardinality(${ClickHouseString})` | `LowCardinality(${ClickHouseEnum})` | `LowCardinality(Nullable(${ClickHouseString}))` | `LowCardinality(Nullable(${ClickHouseEnum}))` | `Map(String, ${ClickHouseBaseType})` | `Map(String, Array(${ClickHouseBaseType}))` | `Map(String, Nullable(${ClickHouseBaseType}))` | `Map(LowCardinality(String), ${ClickHouseBaseType})` | `Map(LowCardinality(String), Array(${ClickHouseBaseType}))` | `Map(LowCardinality(String), Nullable(${ClickHouseBaseType}))` | `Map(${ClickHouseInteger}, ${ClickHouseBaseType})` | `Map(${ClickHouseInteger}, Array(${ClickHouseBaseType}))` | `Map(${ClickHouseInteger}, Nullable(${ClickHouseBaseType}))` | `Array(Map(String, ${ClickHouseBaseType}))` | `Array(Map(LowCardinality(String), ${ClickHouseBaseType}))` | `Array(Map(${ClickHouseInteger}, ${ClickHouseBaseType}))` | `Nullable(Map(String, ${ClickHouseBaseType}))` | `Nullable(Map(LowCardinality(String), ${ClickHouseBaseType}))`;
-export type InferClickHouseType<T extends ClickHouseType, Depth extends number = 0> = Depth extends 5 ? unknown : T extends ClickHouseJsSafeInteger ? number : T extends ClickHouseJsUnsafeInteger ? string : T extends ClickHouseFloat ? number : T extends ClickHouseDecimal ? number : T extends ClickHouseDateTime ? string : T extends ClickHouseString ? string : T extends ClickHouseEnum ? string : T extends ClickHouseBoolean ? boolean : T extends `Array(${infer U})` ? U extends ClickHouseType ? Array<InferClickHouseType<U, Add1<Depth>>> : unknown[] : T extends `Nullable(${infer U})` ? U extends ClickHouseType ? InferClickHouseType<U, Add1<Depth>> | null : unknown | null : T extends `LowCardinality(${infer U})` ? U extends `Nullable(${infer V})` ? V extends ClickHouseString | ClickHouseEnum ? InferClickHouseType<V, Add1<Depth>> | null : unknown | null : U extends ClickHouseString | ClickHouseEnum ? InferClickHouseType<U, Add1<Depth>> : unknown : T extends `Map(${string}, ${infer V})` ? V extends ClickHouseType ? Record<string, InferClickHouseType<V, Add1<Depth>>> : Record<string, unknown> : unknown;
+export type ClickHouseType = ClickHouseBaseType | `Array(${ClickHouseBaseType})` | `Array(Nullable(${ClickHouseBaseType}))` | `Array(LowCardinality(String))` | `Array(LowCardinality(${ClickHouseEnum}))` | `Array(Tuple(${string}))` | `Nullable(${ClickHouseBaseType})` | `Nullable(Array(${ClickHouseBaseType}))` | `Nullable(Array(Tuple(${string})))` | `Nullable(Tuple(${string}))` | `LowCardinality(${ClickHouseString})` | `LowCardinality(${ClickHouseEnum})` | `LowCardinality(Nullable(${ClickHouseString}))` | `LowCardinality(Nullable(${ClickHouseEnum}))` | `Map(String, ${ClickHouseBaseType})` | `Map(String, Array(${ClickHouseBaseType}))` | `Map(String, Nullable(${ClickHouseBaseType}))` | `Map(String, Tuple(${string}))` | `Map(String, Array(Tuple(${string})))` | `Map(LowCardinality(String), ${ClickHouseBaseType})` | `Map(LowCardinality(String), Array(${ClickHouseBaseType}))` | `Map(LowCardinality(String), Nullable(${ClickHouseBaseType}))` | `Map(LowCardinality(String), Tuple(${string}))` | `Map(LowCardinality(String), Array(Tuple(${string})))` | `Map(${ClickHouseInteger}, ${ClickHouseBaseType})` | `Map(${ClickHouseInteger}, Array(${ClickHouseBaseType}))` | `Map(${ClickHouseInteger}, Nullable(${ClickHouseBaseType}))` | `Map(${ClickHouseInteger}, Tuple(${string}))` | `Map(${ClickHouseInteger}, Array(Tuple(${string})))` | `Array(Map(String, ${ClickHouseBaseType}))` | `Array(Map(String, Tuple(${string})))` | `Array(Map(LowCardinality(String), ${ClickHouseBaseType}))` | `Array(Map(LowCardinality(String), Tuple(${string})))` | `Array(Map(${ClickHouseInteger}, ${ClickHouseBaseType}))` | `Array(Map(${ClickHouseInteger}, Tuple(${string})))` | `Nullable(Map(String, ${ClickHouseBaseType}))` | `Nullable(Map(String, Tuple(${string})))` | `Nullable(Map(LowCardinality(String), ${ClickHouseBaseType}))` | `Nullable(Map(LowCardinality(String), Tuple(${string})))` | `Tuple(${string})`;
+export type InferClickHouseType<T extends string, Depth extends number = 0> = Depth extends 5 ? unknown : T extends ClickHouseJsSafeInteger ? number : T extends ClickHouseJsUnsafeInteger ? string : T extends ClickHouseFloat ? number : T extends ClickHouseDecimal ? number : T extends ClickHouseDateTime ? string : T extends ClickHouseString ? string : T extends ClickHouseEnum ? string : T extends ClickHouseBoolean ? boolean : T extends `Array(${infer U})` ? U extends ClickHouseType ? Array<InferClickHouseType<U, Add1<Depth>>> : unknown[] : T extends `Tuple(${infer U})` ? ParseTopLevelArgs<U> extends infer Parts extends string[] ? {
+    [K in keyof Parts]: InferClickHouseType<Parts[K] & ClickHouseType, Add1<Depth>>;
+} : unknown[] : T extends `Nullable(${infer U})` ? U extends ClickHouseType ? InferClickHouseType<U, Add1<Depth>> | null : unknown | null : T extends `LowCardinality(${infer U})` ? U extends `Nullable(${infer V})` ? V extends ClickHouseString | ClickHouseEnum ? InferClickHouseType<V, Add1<Depth>> | null : unknown | null : U extends ClickHouseString | ClickHouseEnum ? InferClickHouseType<U, Add1<Depth>> : unknown : T extends `Map(${string}, ${infer V})` ? V extends ClickHouseType ? Record<string, InferClickHouseType<V, Add1<Depth>>> : Record<string, unknown> : unknown;
 type Add1<T extends number> = T extends 0 ? 1 : T extends 1 ? 2 : T extends 2 ? 3 : T extends 3 ? 4 : 5;
 export type ClickHouseSchema = Record<string, ClickHouseType>;
 export type InferSchemaType<T extends ClickHouseSchema> = {

package/dist/types/clickhouse-types.d.ts.map

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

package/dist/types/index.d.ts

@@ -2,4 +2,5 @@ export * from './base.js';
 export * from './filters.js';
 export * from './clickhouse-types.js';
 export * from './schema.js';
+export * from './type-helpers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -2,3 +2,4 @@ export * from './base.js';
 export * from './filters.js';
 export * from './clickhouse-types.js';
 export * from './schema.js';
+export * from './type-helpers.js';

package/dist/types/type-helpers.d.ts

@@ -0,0 +1,7 @@
+type TrimLeft<S extends string> = S extends ` ${infer R}` ? TrimLeft<R> : S;
+type TrimRight<S extends string> = S extends `${infer R} ` ? TrimRight<R> : S;
+type Trim<S extends string> = TrimLeft<TrimRight<S>>;
+type Push<T extends string[], V extends string> = [...T, V];
+export type ParseTopLevelArgs<S extends string, Current extends string = '', Depth extends string[] = [], Result extends string[] = []> = S extends `${infer First}${infer Rest}` ? First extends '(' ? ParseTopLevelArgs<Rest, `${Current}${First}`, Push<Depth, First>, Result> : First extends ')' ? Depth extends [...infer Remaining extends string[], string] ? ParseTopLevelArgs<Rest, `${Current}${First}`, Remaining, Result> : ParseTopLevelArgs<Rest, `${Current}${First}`, Depth, Result> : First extends ',' ? Depth['length'] extends 0 ? ParseTopLevelArgs<Rest, '', Depth, Push<Result, Trim<Current>>> : ParseTopLevelArgs<Rest, `${Current}${First}`, Depth, Result> : ParseTopLevelArgs<Rest, `${Current}${First}`, Depth, Result> : Current extends '' ? Result : Push<Result, Trim<Current>>;
+export {};
+//# sourceMappingURL=type-helpers.d.ts.map

package/dist/types/type-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.d.ts","sourceRoot":"","sources":["../../src/types/type-helpers.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC5E,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC9E,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAG5D,MAAM,MAAM,iBAAiB,CAC3B,CAAC,SAAS,MAAM,EAChB,OAAO,SAAS,MAAM,GAAG,EAAE,EAC3B,KAAK,SAAS,MAAM,EAAE,GAAG,EAAE,EAC3B,MAAM,SAAS,MAAM,EAAE,GAAG,EAAE,IAC1B,CAAC,SAAS,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,GACvC,KAAK,SAAS,GAAG,GACf,iBAAiB,CAAC,IAAI,EAAE,GAAG,OAAO,GAAG,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,GACzE,KAAK,SAAS,GAAG,GACf,KAAK,SAAS,CAAC,GAAG,MAAM,SAAS,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,GACzD,iBAAiB,CAAC,IAAI,EAAE,GAAG,OAAO,GAAG,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAChE,iBAAiB,CAAC,IAAI,EAAE,GAAG,OAAO,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAC9D,KAAK,SAAS,GAAG,GACf,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACvB,iBAAiB,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAC/D,iBAAiB,CAAC,IAAI,EAAE,GAAG,OAAO,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAC9D,iBAAiB,CAAC,IAAI,EAAE,GAAG,OAAO,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAClE,OAAO,SAAS,EAAE,GAChB,MAAM,GACN,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/dist/types/type-helpers.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/clickhouse",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "ClickHouse typescript query builder",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",