@mastra/clickhouse 1.15.1 → 1.15.2-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @mastra/clickhouse
 
+## 1.15.2-alpha.0
+
+### Patch Changes
+
+- Fixed ClickHouse replication initialization rejecting pre-existing tables that use local engines. Initialization now warns that `CREATE TABLE IF NOT EXISTS` will leave those tables unchanged and continues creating any missing replicated tables. ([#21538](https://github.com/mastra-ai/mastra/pull/21538))
+
+- Fixed Studio metrics and logs detection for ClickHouse observability storage. Fixes #21435. ([#21536](https://github.com/mastra-ai/mastra/pull/21536))
+
+- Updated dependencies [[`7e096f0`](https://github.com/mastra-ai/mastra/commit/7e096f02f0dddbf09b85d306458351245ed2f886), [`8f0a332`](https://github.com/mastra-ai/mastra/commit/8f0a3321bf180368d76fe7b36aa1a8f60f00b6de), [`b098de9`](https://github.com/mastra-ai/mastra/commit/b098de9d7cb9f672e0883a5c716465a3a689693d), [`ef6e295`](https://github.com/mastra-ai/mastra/commit/ef6e295b59bc25a5b61b633a89c97bcfce9fb465), [`208e1b3`](https://github.com/mastra-ai/mastra/commit/208e1b39f30f4b386e494394e9d71d96f0f90241), [`c938d34`](https://github.com/mastra-ai/mastra/commit/c938d34739936c8ecbabd67ad6a4a4396f41c4c6), [`1d9a0ea`](https://github.com/mastra-ai/mastra/commit/1d9a0ea4a9901baee6cd56737243bd6d1f631ac0), [`3667679`](https://github.com/mastra-ai/mastra/commit/3667679db057edfb086846d13369fdda4902ad65), [`49696e8`](https://github.com/mastra-ai/mastra/commit/49696e8e42f870674a0a58f5abcd22cc54dd2864), [`512100a`](https://github.com/mastra-ai/mastra/commit/512100a7d8b7e9c920f2590c6b3612f5de0d3cff), [`9ef432b`](https://github.com/mastra-ai/mastra/commit/9ef432b6faa534b57b0d182a610e13dd9a7123ff), [`b9cf308`](https://github.com/mastra-ai/mastra/commit/b9cf30846f97f99ac1906ee8a68f4f2d117b0378)]:
+  - @mastra/core@1.60.0-alpha.2
+
 ## 1.15.1
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-clickhouse
 description: Documentation for @mastra/clickhouse. Use when working with @mastra/clickhouse APIs, configuration, or implementation.
 metadata:
   package: "@mastra/clickhouse"
-  version: "1.15.1"
+  version: "1.15.2-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.15.1",
+  "version": "1.15.2-alpha.0",
   "package": "@mastra/clickhouse",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -166,17 +166,6 @@ function rewriteEngineClauses(sql, replication) {
 function applyReplicationToDDL(sql, replication) {
 	return addOnClusterToDDL(replication ? rewriteEngineClauses(sql, replication) : sql, replication);
 }
-function buildLocalTableReplicationError(tables) {
-	const tableList = tables.map((table) => `  - ${table.name} (${table.engine})`).join("\n");
-	return new _mastra_core_error.MastraError({
-		id: (0, _mastra_core_storage.createStorageErrorId)("CLICKHOUSE", "REPLICATION", "LOCAL_TABLES_UNSUPPORTED"),
-		domain: _mastra_core_error.ErrorDomain.STORAGE,
-		category: _mastra_core_error.ErrorCategory.USER,
-		text: `ClickHouse replication is enabled, but existing Mastra tables use non-replicated local engines.
-Mastra will not automatically convert existing local tables to replicated tables.
-Please migrate or recreate these tables manually before enabling replication:\n${tableList}`
-	});
-}
 //#endregion
 //#region src/storage/db/utils.ts
 const TABLE_ENGINES = {
@@ -351,12 +340,12 @@ var ClickhouseDB = class extends _mastra_core_base.MastraBase {
 	}
 	async assertExistingTableCompatibleWithReplication(tableName) {
 		if (!isReplicationConfigured(this.replication)) return;
-		const localTables = (await (await this.client.query({
+		const localTable = (await (await this.client.query({
 			query: `SELECT name, engine FROM system.tables WHERE database = currentDatabase() AND name = {tableName:String}`,
 			query_params: { tableName },
 			format: "JSONEachRow"
-		})).json()).filter((row) => row.engine && !isReplicatedOrSharedEngine(row.engine));
-		if (localTables.length > 0) throw buildLocalTableReplicationError(localTables);
+		})).json()).find((row) => row.engine && !isReplicatedOrSharedEngine(row.engine));
+		if (localTable) this.logger.warn(`ClickHouse replication is enabled, but pre-existing table '${localTable.name}' uses local engine '${localTable.engine}'. CREATE TABLE IF NOT EXISTS will leave the existing table untouched.`);
 	}
 	/**
 	* Gets the sorting key (ORDER BY columns) for a table.
@@ -7032,17 +7021,14 @@ async function filterAppliedRetention(client, entries) {
 * Silently returns if `system.tables` can't be queried — the rest of init
 * will still run and leave any existing tables untouched.
 */
-async function assertExistingTablesCompatibleWithReplication(client, replication) {
+async function assertExistingTablesCompatibleWithReplication(client, replication, logger) {
 	if (!isReplicationConfigured(replication)) return;
 	const localTable = (await (await client.query({
 		query: `SELECT name, engine FROM system.tables WHERE database = currentDatabase() AND name IN ({tables:Array(String)})`,
 		query_params: { tables: [...ALL_TABLE_NAMES] },
 		format: "JSONEachRow"
 	})).json()).find((row) => !isReplicatedOrSharedEngine(row.engine));
-	if (localTable) throw buildLocalTableReplicationError([{
-		name: localTable.name,
-		engine: localTable.engine
-	}]);
+	if (localTable) logger.warn(`ClickHouse replication is enabled, but pre-existing observability table '${localTable.name}' uses local engine '${localTable.engine}'. CREATE TABLE IF NOT EXISTS will leave existing tables untouched.`);
 }
 async function reconcileDiscoveryTables(client, replication) {
 	let engines;
@@ -7161,7 +7147,7 @@ var ObservabilityStorageClickhouseVNext = class extends _mastra_core_storage.Obs
 			if ((await checkLegacySpanMigrationStatus(this.#client)).needsMigration) this.logger?.warn?.("Legacy span table 'mastra_ai_spans' detected. Run 'npx mastra migrate' to migrate historical spans to the v-next schema.");
 		} catch {}
 		try {
-			await assertExistingTablesCompatibleWithReplication(this.#client, this.#replication);
+			await assertExistingTablesCompatibleWithReplication(this.#client, this.#replication, this.logger);
 			const existingStrategy = await detectExistingDeltaCursorStrategy(this.#client);
 			if (existingStrategy === "mixed") {
 				this.#deltaCursorStrategy = null;
@@ -7245,8 +7231,12 @@ var ObservabilityStorageClickhouseVNext = class extends _mastra_core_storage.Obs
 		};
 	}
 	getFeatures() {
-		if (!deltaPollingSupported(this.#deltaCursorStrategy)) return;
-		return ["delta-polling"];
+		if (!deltaPollingSupported(this.#deltaCursorStrategy)) return ["metrics", "logs"];
+		return [
+			"metrics",
+			"logs",
+			"delta-polling"
+		];
 	}
 	async createSpan(args) {
 		try {