@mastra/clickhouse 1.18.0-alpha.0 → 1.18.0-alpha.1

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.18.0-alpha.0"
+  version: "1.18.0-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/index.cjs

@@ -27,9 +27,9 @@ let _mastra_core_storage = require("@mastra/core/storage");
 _mastra_core_storage = __toESM(_mastra_core_storage, 1);
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_base = require("@mastra/core/base");
+let crypto$1 = require("crypto");
 let _mastra_core_utils = require("@mastra/core/utils");
 let _mastra_core_features = require("@mastra/core/features");
-let crypto$1 = require("crypto");
 let _mastra_core_evals = require("@mastra/core/evals");
 //#region src/storage/db/replication.ts
 const DEFAULT_ZOOKEEPER_PATH = "/clickhouse/tables/{shard}/{database}/{table}";
@@ -4668,18 +4668,79 @@ async function batchCreateFeedback(client, args) {
 		clickhouse_settings: CH_INSERT_SETTINGS
 	});
 }
-async function updateFeedbackReviewStatus(client, args) {
-	const { feedbackId, reviewStatus } = parseUpdateFeedbackReviewStatusArgs(args);
-	const existing = await queryJson$2(client, `SELECT * FROM ${TABLE_FEEDBACK_EVENTS} FINAL WHERE feedbackId = {feedbackId:String} LIMIT 1`, { feedbackId });
-	if (!existing[0]) throw new _mastra_core_error.MastraError({
+/**
+* Delete feedback events by feedbackId via lightweight DELETE. Optional
+* `organizationId` and `resourceId` values are ANDed into the predicate to
+* restrict deletion to records with matching scope fields.
+*
+* A durable deletion request is recorded before the lightweight delete. The
+* delete is immediately visible to subsequent reads; physical purge depends on
+* the table's configured retention TTL. The delta table is intentionally not
+* touched and expires through its fixed two-day TTL.
+*/
+async function deleteFeedback(client, args, replication) {
+	if (args.feedbackIds.length === 0) return;
+	await recordDeletionRequest(client, {
+		requestId: (0, crypto$1.randomUUID)(),
+		organizationId: args.organizationId,
+		resourceId: args.resourceId,
+		signal: "feedback",
+		predicateType: "itemIds",
+		predicateValues: [...args.feedbackIds],
+		requestedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		replication
+	});
+	const params = {};
+	const idPlaceholders = [];
+	for (let i = 0; i < args.feedbackIds.length; i++) {
+		const name = `fid_${i}`;
+		params[name] = args.feedbackIds[i];
+		idPlaceholders.push(`{${name}:String}`);
+	}
+	const conditions = [`feedbackId IN (${idPlaceholders.join(", ")})`];
+	if (args.organizationId !== void 0) {
+		conditions.push("organizationId = {delOrganizationId:String}");
+		params.delOrganizationId = args.organizationId;
+	}
+	if (args.resourceId !== void 0) {
+		conditions.push("resourceId = {delResourceId:String}");
+		params.delResourceId = args.resourceId;
+	}
+	await client.command({
+		query: `DELETE FROM ${TABLE_FEEDBACK_EVENTS} WHERE ${conditions.join(" AND ")}`,
+		query_params: params,
+		clickhouse_settings: { lightweight_deletes_sync: isReplicationConfigured(replication) ? "2" : "1" }
+	});
+}
+function feedbackNotFoundError(feedbackId) {
+	return new _mastra_core_error.MastraError({
 		id: "OBSERVABILITY_UPDATE_FEEDBACK_REVIEW_STATUS_NOT_FOUND",
 		domain: _mastra_core_error.ErrorDomain.MASTRA_OBSERVABILITY,
 		category: _mastra_core_error.ErrorCategory.USER,
 		text: "Feedback record not found",
 		details: { feedbackId }
 	});
+}
+async function hasFeedbackDeletionRequest(client, feedbackId, organizationId, resourceId) {
+	return (await queryJson$2(client, `SELECT 1 AS found FROM ${TABLE_DELETION_REQUESTS} FINAL
+     WHERE signal = 'feedback'
+       AND predicateType = 'itemIds'
+       AND has(predicateValues, {feedbackId:String})
+       AND (organizationId = '' OR organizationId = {organizationId:String})
+       AND (resourceId = '' OR resourceId = {resourceId:String})
+     LIMIT 1`, {
+		feedbackId,
+		organizationId: organizationId ?? "",
+		resourceId: resourceId ?? ""
+	})).length > 0;
+}
+async function updateFeedbackReviewStatus(client, args, replication) {
+	const { feedbackId, reviewStatus } = parseUpdateFeedbackReviewStatusArgs(args);
+	const existingRow = (await queryJson$2(client, `SELECT * FROM ${TABLE_FEEDBACK_EVENTS} FINAL WHERE feedbackId = {feedbackId:String} LIMIT 1`, { feedbackId }))[0];
+	if (!existingRow) throw feedbackNotFoundError(feedbackId);
+	if (await hasFeedbackDeletionRequest(client, feedbackId, existingRow.organizationId, existingRow.resourceId)) throw feedbackNotFoundError(feedbackId);
 	const updated = rowToFeedbackRecord({
-		...existing[0],
+		...existingRow,
 		reviewStatus
 	});
 	await client.insert({
@@ -4688,6 +4749,14 @@ async function updateFeedbackReviewStatus(client, args) {
 		format: "JSONEachRow",
 		clickhouse_settings: CH_INSERT_SETTINGS
 	});
+	if (await hasFeedbackDeletionRequest(client, feedbackId, existingRow.organizationId, existingRow.resourceId)) {
+		await deleteFeedback(client, {
+			feedbackIds: [feedbackId],
+			organizationId: existingRow.organizationId ?? void 0,
+			resourceId: existingRow.resourceId ?? void 0
+		}, replication);
+		throw feedbackNotFoundError(feedbackId);
+	}
 	return updated;
 }
 async function listFeedback(client, args, strategy) {
@@ -5977,6 +6046,50 @@ async function batchCreateScores(client, args) {
 		clickhouse_settings: CH_INSERT_SETTINGS
 	});
 }
+/**
+* Delete score events by scoreId via lightweight DELETE. Optional
+* `organizationId` and `resourceId` values are ANDed into the predicate to
+* restrict deletion to records with matching scope fields.
+*
+* A durable deletion request is recorded before the lightweight delete. The
+* delete is immediately visible to subsequent reads; physical purge depends on
+* the table's configured retention TTL. The delta table is intentionally not
+* touched and expires through its fixed two-day TTL.
+*/
+async function deleteScores(client, args, replication) {
+	if (args.scoreIds.length === 0) return;
+	await recordDeletionRequest(client, {
+		requestId: (0, crypto$1.randomUUID)(),
+		organizationId: args.organizationId,
+		resourceId: args.resourceId,
+		signal: "scores",
+		predicateType: "itemIds",
+		predicateValues: [...args.scoreIds],
+		requestedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		replication
+	});
+	const params = {};
+	const idPlaceholders = [];
+	for (let i = 0; i < args.scoreIds.length; i++) {
+		const name = `sid_${i}`;
+		params[name] = args.scoreIds[i];
+		idPlaceholders.push(`{${name}:String}`);
+	}
+	const conditions = [`scoreId IN (${idPlaceholders.join(", ")})`];
+	if (args.organizationId !== void 0) {
+		conditions.push("organizationId = {delOrganizationId:String}");
+		params.delOrganizationId = args.organizationId;
+	}
+	if (args.resourceId !== void 0) {
+		conditions.push("resourceId = {delResourceId:String}");
+		params.delResourceId = args.resourceId;
+	}
+	await client.command({
+		query: `DELETE FROM ${TABLE_SCORE_EVENTS} WHERE ${conditions.join(" AND ")}`,
+		query_params: params,
+		clickhouse_settings: { lightweight_deletes_sync: isReplicationConfigured(replication) ? "2" : "1" }
+	});
+}
 async function listScores(client, args, strategy) {
 	const parsed = _mastra_core_storage.listScoresArgsSchema.parse(args);
 	const deltaCursorEnabled = deltaPollingSupported(strategy);
@@ -7948,6 +8061,19 @@ var ObservabilityStorageClickhouseVNext = class extends _mastra_core_storage.Obs
 			}, error);
 		}
 	}
+	async deleteScores(args) {
+		try {
+			await deleteScores(this.#client, args, this.#replication);
+		} catch (error) {
+			if (error instanceof _mastra_core_error.MastraError) throw error;
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("CLICKHOUSE", "DELETE_SCORES", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
+				details: { count: args.scoreIds.length }
+			}, error);
+		}
+	}
 	async getScoreById(scoreId) {
 		try {
 			return await getScoreById(this.#client, scoreId);
@@ -7986,9 +8112,22 @@ var ObservabilityStorageClickhouseVNext = class extends _mastra_core_storage.Obs
 			}, error);
 		}
 	}
+	async deleteFeedback(args) {
+		try {
+			await deleteFeedback(this.#client, args, this.#replication);
+		} catch (error) {
+			if (error instanceof _mastra_core_error.MastraError) throw error;
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("CLICKHOUSE", "DELETE_FEEDBACK", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
+				details: { count: args.feedbackIds.length }
+			}, error);
+		}
+	}
 	async updateFeedbackReviewStatus(args) {
 		try {
-			return await updateFeedbackReviewStatus(this.#client, args);
+			return await updateFeedbackReviewStatus(this.#client, args, this.#replication);
 		} catch (error) {
 			if (error instanceof _mastra_core_error.MastraError) throw error;
 			throw new _mastra_core_error.MastraError({