@voltro/plugin-clickhouse 0.85.0 → 0.87.0

package/dist/index.js

@@ -1,300 +1,59 @@
-import { createClient as e } from "@clickhouse/client";
-import { Effect as t } from "effect";
-import { createLogger as n } from "@voltro/logger";
-import { AnalyticsError as r } from "@voltro/runtime";
-//#region src/sink.ts
-var i = n({ scope: "@voltro/plugin-clickhouse" }), a = "clickhouse", o = (e) => `voltro_mirror_${e}`, s = (e, t) => `
-  CREATE TABLE IF NOT EXISTS ${e}.${o(t)} (
-    id          String,
-    data        String CODEC(ZSTD(1)),
-    version     UInt64,
-    is_deleted  UInt8 DEFAULT 0
-  ) ENGINE = ReplacingMergeTree(version)
-  ORDER BY id
-`.trim(), c = (e, t) => `
-  CREATE TABLE IF NOT EXISTS ${e}.${t} (
-    id          UUID DEFAULT generateUUIDv7(),
-    name        LowCardinality(String),
-    subject_id  Nullable(String),
-    tenant_id   Nullable(String),
-    properties  String CODEC(ZSTD(1)),
-    occurred_at DateTime64(3),
-    ingested_at DateTime64(3) DEFAULT now64()
-  ) ENGINE = MergeTree
-  ORDER BY (name, occurred_at, id)
-`.trim(), l = (e) => (t) => t instanceof r ? new r({
-	provider: a,
-	operation: e,
-	cause: t.cause
-}) : new r({
-	provider: a,
-	operation: e,
-	cause: t instanceof Error ? `${t.name}: ${t.message}` : String(t)
-}), u = (e) => (n) => n.pipe(t.catchDefect((e) => e instanceof r ? t.fail(e) : t.die(e)), t.mapError(l(e))), d = /^[A-Za-z_][A-Za-z0-9_]*$/, f = (e, t) => {
-	if (!d.test(e)) throw new r({
-		provider: a,
-		operation: "config",
-		cause: `invalid ${t} ${JSON.stringify(e)} — must match ${d.source} (letters, digits, underscore; no dots/quotes/spaces)`
-	});
-	return e;
-}, p = /['\\]/, m = (e) => {
-	for (let t = 0; t < e.length; t++) if (e.charCodeAt(t) < 32) return !0;
-	return !1;
-}, h = (e) => (t) => {
-	if (p.test(t) || m(t)) throw new r({
-		provider: a,
-		operation: e,
-		cause: `invalid property key ${JSON.stringify(t)} — must not contain quotes, backslashes, or control characters`
-	});
-	return t;
-}, g = (e) => e.client === null ? t.fail(new r({
-	provider: a,
-	operation: "ensureClient",
-	cause: "client not initialized — spec.initialize must run before queries"
-})) : t.succeed(e.client), _ = (e) => t.gen(function* () {
-	let n = e.client;
-	e.client = null, n !== null && (yield* t.tryPromise(() => n.close()).pipe(t.catch((e) => t.logWarning("clickhouse analytics sink teardown failed", {
-		provider: a,
-		err: e
-	}))));
-}), v = (e) => ({
-	name: e.name,
-	subject_id: e.subjectId ?? null,
-	tenant_id: e.tenantId ?? null,
-	properties: JSON.stringify(e.properties),
-	occurred_at: (e.occurredAt ?? /* @__PURE__ */ new Date()).toISOString()
-}), y = (e, t) => {
-	let n = [], r, a = () => {
-		r !== void 0 && (clearTimeout(r), r = void 0);
-	}, o = async () => {
-		if (a(), n.length === 0) return;
-		let t = n;
-		n = [];
-		let r = e.client;
-		if (r === null) {
-			i.warn("clickhouse batch flush skipped — client not initialized; events dropped", { dropped: t.length });
-			return;
-		}
-		try {
-			await r.insert({
-				table: `${e.database}.${e.table}`,
-				values: t,
-				format: "JSONEachRow"
-			});
-		} catch (e) {
-			i.warn("clickhouse batch flush failed — dropped events", { dropped: t.length }, e);
-		}
-	};
-	return {
-		add: (e) => {
-			if (n.push(v(e)), n.length >= t.maxSize) {
-				o();
-				return;
-			}
-			r === void 0 && (r = setTimeout(() => {
-				o();
-			}, t.flushIntervalMs), r.unref?.());
-		},
-		flush: o
-	};
-}, b = (e) => {
-	switch (e) {
-		case "minute": return "toStartOfMinute";
-		case "hour": return "toStartOfHour";
-		case "day": return "toStartOfDay";
-		case "week": return "toStartOfWeek";
-		case "month": return "toStartOfMonth";
-	}
-}, x = (e, t) => `JSONExtractString(properties, '${h(e)(t)}')`, S = (e, t) => `JSONExtractFloat(properties, '${h(e)(t)}')`, C = (e, t) => t === "count" ? "count()" : t === "unique" ? "uniqExact(subject_id)" : "sum" in t ? `sum(${S(e, t.sum)})` : `avg(${S(e, t.avg)})`, w = (e, t) => t === "count" ? "count()" : `sum(${S(e, t.sum)})`, T = (e, t, n, r, i) => {
-	let a = {
-		event: t,
-		from: n.from.toISOString(),
-		...n.to === void 0 ? {} : { to: n.to.toISOString() }
-	}, o = "name = {event:String} AND occurred_at >= {from:DateTime64(3)}" + (n.to === void 0 ? "" : " AND occurred_at < {to:DateTime64(3)}");
-	if (i != null && (a.tenant = i, o += " AND tenant_id = {tenant:String}"), r !== void 0) {
-		let t = 0;
-		for (let [n, i] of Object.entries(r)) {
-			let r = `f${t++}`;
-			a[r] = String(i), o += ` AND ${x(e, n)} = {${r}:String}`;
-		}
-	}
-	return {
-		sql: o,
-		params: a
+import { EVENTS_TABLE_DDL as e, MIRROR_TABLE_DDL as t, assertIdentifier as n, buildClickhouseSink as r, closeClickhouseState as i, makeEventBatcher as a } from "./sink.js";
+import { createClient as o } from "@clickhouse/client";
+import { Effect as s } from "effect";
+//#region src/index.ts
+var c = 20, l = 5e3, u = (u) => {
+	let d = (u.mirrorTables ?? []).map((e) => n(e, "mirror table")), f = {
+		client: null,
+		database: n(u.database ?? "default", "database"),
+		table: n(u.table ?? "events", "table"),
+		mirrorTables: d,
+		mirrorPrimaryKey: u.mirrorPrimaryKey ?? "id"
 	};
-}, E = (e) => {
-	let n = (n, r) => t.gen(function* () {
-		f(n, "mirror table");
-		let i = yield* g(e);
-		yield* t.tryPromise({
-			try: () => i.insert({
-				table: `${e.database}.${o(n)}`,
-				values: [r],
-				format: "JSONEachRow"
-			}),
-			catch: (e) => e
+	if (u.batch !== !1) {
+		let e = u.batch ?? {};
+		f.batcher = a(f, {
+			maxSize: e.maxSize ?? c,
+			flushIntervalMs: e.flushIntervalMs ?? l
 		});
-	});
-	return {
-		tables: e.mirrorTables,
-		primaryKey: e.mirrorPrimaryKey,
-		upsert: ({ table: r, row: i, version: a }) => t.gen(function* () {
-			let t = String(i[e.mirrorPrimaryKey]);
-			yield* n(r, {
-				id: t,
-				data: JSON.stringify(i),
-				version: a,
-				is_deleted: 0
-			});
-		}).pipe(u("mirror.upsert")),
-		remove: ({ table: e, primaryKeyValue: r, version: i }) => t.gen(function* () {
-			yield* n(e, {
-				id: String(r),
-				data: "{}",
-				version: i,
-				is_deleted: 1
-			});
-		}).pipe(u("mirror.remove")),
-		maxVersion: ({ table: n, primaryKeyValue: r }) => t.gen(function* () {
-			f(String(n), "mirror table");
-			let i = yield* g(e), a = `SELECT max(version) AS v, count() AS n FROM ${e.database}.${o(String(n))} WHERE id = {id: String} FORMAT JSON`, s = yield* t.tryPromise({
-				try: () => i.query({
-					query: a,
-					query_params: { id: String(r) }
-				}),
-				catch: (e) => e
-			}), { data: c } = yield* t.tryPromise({
-				try: () => s.json(),
-				catch: (e) => e
-			}), l = c[0];
-			return l === void 0 || Number(l.n) === 0 || l.v === null ? null : Number(l.v);
-		}).pipe(u("mirror.maxVersion"))
-	};
-}, D = (e) => {
-	let n = e.mirrorTables.length > 0 ? E(e) : void 0;
+	}
 	return {
-		info: {
-			provider: a,
-			capabilities: {
-				track: !0,
-				aggregate: !0,
-				timeseries: !0,
-				topN: !0,
-				mirror: n !== void 0
-			},
-			detail: {
-				database: e.database,
-				table: e.table,
-				...e.mirrorTables.length > 0 ? { mirrorTables: e.mirrorTables } : {},
-				...e.batcher === void 0 ? {} : { batching: !0 }
-			}
-		},
-		track: (n) => e.batcher ? t.sync(() => e.batcher.add(n)) : t.gen(function* () {
-			let r = yield* g(e);
-			yield* t.tryPromise({
-				try: () => r.insert({
-					table: `${e.database}.${e.table}`,
-					values: [v(n)],
-					format: "JSONEachRow"
-				}),
-				catch: (e) => e
-			});
-		}).pipe(u("track")),
-		aggregate: (n) => t.gen(function* () {
-			let r = yield* g(e), i = T("aggregate", n.event, n.range, n.filter, n.tenantId), a = `SELECT ${C("aggregate", n.metric)} AS value FROM ${e.database}.${e.table} WHERE ${i.sql} FORMAT JSON`, o = yield* t.tryPromise({
-				try: () => r.query({
-					query: a,
-					query_params: i.params
+		kind: "clickhouse",
+		sql: "none",
+		build: () => r(f),
+		initialize: () => s.gen(function* () {
+			let n = yield* s.sync(() => o({
+				url: u.url,
+				database: f.database,
+				...u.username === void 0 ? {} : { username: u.username },
+				...u.password === void 0 ? {} : { password: u.password }
+			}));
+			if (f.client = n, !(yield* s.tryPromise({
+				try: (e) => n.ping({
+					select: !1,
+					abort_signal: e
 				}),
-				catch: (e) => e
-			}), { data: s } = yield* t.tryPromise({
-				try: () => o.json(),
-				catch: (e) => e
-			}), c = s[0]?.value ?? 0;
-			return typeof c == "number" ? c : Number(c ?? 0);
-		}).pipe(u("aggregate")),
-		timeseries: (n) => t.gen(function* () {
-			let r = yield* g(e), i = T("timeseries", n.event, n.range, n.filter, n.tenantId), a = `
-        SELECT ${`${b(n.bucket)}(occurred_at)`} AS bucket_start, ${C("timeseries", n.metric)} AS value
-        FROM ${e.database}.${e.table}
-        WHERE ${i.sql}
-        GROUP BY bucket_start
-        ORDER BY bucket_start ASC
-        FORMAT JSON
-      `, o = yield* t.tryPromise({
-				try: () => r.query({
-					query: a,
-					query_params: i.params
+				catch: () => /* @__PURE__ */ Error("ClickHouse readiness failed")
+			})).success) return yield* s.fail(/* @__PURE__ */ Error("ClickHouse readiness failed"));
+			yield* s.tryPromise({
+				try: (t) => n.command({
+					query: e(f.database, f.table),
+					abort_signal: t
 				}),
-				catch: (e) => e
-			}), { data: s } = yield* t.tryPromise({
-				try: () => o.json(),
-				catch: (e) => e
+				catch: () => /* @__PURE__ */ Error("ClickHouse schema initialization failed")
 			});
-			return s.map((e) => ({
-				bucketStart: new Date(e.bucket_start),
-				value: typeof e.value == "number" ? e.value : Number(e.value ?? 0)
-			}));
-		}).pipe(u("timeseries")),
-		topN: (n) => t.gen(function* () {
-			let r = yield* g(e), i = T("topN", n.event, n.range, n.filter, n.tenantId), a = Math.max(1, Math.floor(n.n)), o = x("topN", n.groupBy), s = `
-        SELECT ${o} AS key, ${w("topN", n.metric)} AS value
-        FROM ${e.database}.${e.table}
-        WHERE ${i.sql}
-        GROUP BY ${o}
-        ORDER BY value DESC
-        LIMIT ${a}
-        FORMAT JSON
-      `, c = yield* t.tryPromise({
-				try: () => r.query({
-					query: s,
-					query_params: i.params
+			for (let e of f.mirrorTables) yield* s.tryPromise({
+				try: (r) => n.command({
+					query: t(f.database, e),
+					abort_signal: r
 				}),
-				catch: (e) => e
-			}), { data: l } = yield* t.tryPromise({
-				try: () => c.json(),
-				catch: (e) => e
+				catch: () => /* @__PURE__ */ Error("ClickHouse mirror initialization failed")
 			});
-			return l.filter((e) => e.key !== null).map((e) => ({
-				key: e.key,
-				value: typeof e.value == "number" ? e.value : Number(e.value ?? 0)
-			}));
-		}).pipe(u("topN")),
-		...n === void 0 ? {} : { mirror: n }
-	};
-}, O = 20, k = 5e3, A = (n) => {
-	let r = (n.mirrorTables ?? []).map((e) => f(e, "mirror table")), i = {
-		client: null,
-		database: f(n.database ?? "default", "database"),
-		table: f(n.table ?? "events", "table"),
-		mirrorTables: r,
-		mirrorPrimaryKey: n.mirrorPrimaryKey ?? "id"
-	};
-	if (n.batch !== !1) {
-		let e = n.batch ?? {};
-		i.batcher = y(i, {
-			maxSize: e.maxSize ?? O,
-			flushIntervalMs: e.flushIntervalMs ?? k
-		});
-	}
-	return {
-		kind: "clickhouse",
-		build: (e) => D(i),
-		initialize: () => t.gen(function* () {
-			let r = yield* t.promise(() => Promise.resolve(e({
-				url: n.url,
-				database: i.database,
-				...n.username === void 0 ? {} : { username: n.username },
-				...n.password === void 0 ? {} : { password: n.password }
-			})));
-			yield* t.promise(() => r.ping()), yield* t.promise(() => r.command({ query: c(i.database, i.table) }));
-			for (let e of i.mirrorTables) yield* t.promise(() => r.command({ query: s(i.database, e) }));
-			i.client = r;
-		}),
-		dispose: () => t.gen(function* () {
-			i.batcher && (yield* t.promise(() => i.batcher.flush())), yield* _(i);
-		})
+		}).pipe(s.onError(() => i(f))),
+		dispose: () => s.gen(function* () {
+			f.batcher && (yield* s.promise(() => f.batcher.flush()));
+		}).pipe(s.ensuring(i(f)))
 	};
 };
 //#endregion
-export { c as EVENTS_TABLE_DDL, s as MIRROR_TABLE_DDL, A as clickhouseAnalytics };
+export { e as EVENTS_TABLE_DDL, t as MIRROR_TABLE_DDL, u as clickhouseAnalytics };

package/dist/sink.js

@@ -0,0 +1,259 @@
+import { Effect as e } from "effect";
+import { createLogger as t } from "@voltro/logger";
+import { AnalyticsError as n } from "@voltro/runtime";
+//#region src/sink.ts
+var r = t({ scope: "@voltro/plugin-clickhouse" }), i = "clickhouse", a = (e) => `voltro_mirror_${e}`, o = (e, t) => `
+  CREATE TABLE IF NOT EXISTS ${e}.${a(t)} (
+    id          String,
+    data        String CODEC(ZSTD(1)),
+    version     UInt64,
+    is_deleted  UInt8 DEFAULT 0
+  ) ENGINE = ReplacingMergeTree(version)
+  ORDER BY id
+`.trim(), s = (e, t) => `
+  CREATE TABLE IF NOT EXISTS ${e}.${t} (
+    id          UUID DEFAULT generateUUIDv7(),
+    name        LowCardinality(String),
+    subject_id  Nullable(String),
+    tenant_id   Nullable(String),
+    properties  String CODEC(ZSTD(1)),
+    occurred_at DateTime64(3),
+    ingested_at DateTime64(3) DEFAULT now64()
+  ) ENGINE = MergeTree
+  ORDER BY (name, occurred_at, id)
+`.trim(), c = (e) => (t) => t instanceof n ? new n({
+	provider: i,
+	operation: e,
+	cause: t.cause
+}) : new n({
+	provider: i,
+	operation: e,
+	cause: t instanceof Error ? `${t.name}: ${t.message}` : String(t)
+}), l = (t) => (r) => r.pipe(e.catchDefect((t) => t instanceof n ? e.fail(t) : e.die(t)), e.mapError(c(t))), u = /^[A-Za-z_][A-Za-z0-9_]*$/, d = (e, t) => {
+	if (!u.test(e)) throw new n({
+		provider: i,
+		operation: "config",
+		cause: `invalid ${t} ${JSON.stringify(e)} — must match ${u.source} (letters, digits, underscore; no dots/quotes/spaces)`
+	});
+	return e;
+}, f = /['\\]/, p = (e) => {
+	for (let t = 0; t < e.length; t++) if (e.charCodeAt(t) < 32) return !0;
+	return !1;
+}, m = (e) => (t) => {
+	if (f.test(t) || p(t)) throw new n({
+		provider: i,
+		operation: e,
+		cause: `invalid property key ${JSON.stringify(t)} — must not contain quotes, backslashes, or control characters`
+	});
+	return t;
+}, h = (t) => t.client === null ? e.fail(new n({
+	provider: i,
+	operation: "ensureClient",
+	cause: "client not initialized — spec.initialize must run before queries"
+})) : e.succeed(t.client), g = (t) => e.gen(function* () {
+	let n = t.client;
+	t.client = null, n !== null && (yield* e.tryPromise(() => n.close()).pipe(e.catch((t) => e.logWarning("clickhouse analytics sink teardown failed", {
+		provider: i,
+		err: t
+	}))));
+}), _ = (e) => ({
+	name: e.name,
+	subject_id: e.subjectId ?? null,
+	tenant_id: e.tenantId ?? null,
+	properties: JSON.stringify(e.properties),
+	occurred_at: (e.occurredAt ?? /* @__PURE__ */ new Date()).toISOString()
+}), v = (e, t) => {
+	let n = [], i, a = () => {
+		i !== void 0 && (clearTimeout(i), i = void 0);
+	}, o = async () => {
+		if (a(), n.length === 0) return;
+		let t = n;
+		n = [];
+		let i = e.client;
+		if (i === null) r.warn("clickhouse batch flush skipped — client not initialized; events dropped", { dropped: t.length });
+		else try {
+			await i.insert({
+				table: `${e.database}.${e.table}`,
+				values: t,
+				format: "JSONEachRow"
+			});
+		} catch (e) {
+			r.warn("clickhouse batch flush failed — dropped events", { dropped: t.length }, e);
+		}
+	};
+	return {
+		add: (e) => {
+			n.push(_(e)), n.length >= t.maxSize ? o() : i === void 0 && (i = setTimeout(() => {
+				o();
+			}, t.flushIntervalMs), i.unref?.());
+		},
+		flush: o
+	};
+}, y = (e) => {
+	switch (e) {
+		case "minute": return "toStartOfMinute";
+		case "hour": return "toStartOfHour";
+		case "day": return "toStartOfDay";
+		case "week": return "toStartOfWeek";
+		case "month": return "toStartOfMonth";
+	}
+}, b = (e, t) => `JSONExtractString(properties, '${m(e)(t)}')`, x = (e, t) => `JSONExtractFloat(properties, '${m(e)(t)}')`, S = (e, t) => t === "count" ? "count()" : t === "unique" ? "uniqExact(subject_id)" : "sum" in t ? `sum(${x(e, t.sum)})` : `avg(${x(e, t.avg)})`, C = (e, t) => t === "count" ? "count()" : `sum(${x(e, t.sum)})`, w = (e, t, n, r, i) => {
+	let a = {
+		event: t,
+		from: n.from.toISOString(),
+		...n.to === void 0 ? {} : { to: n.to.toISOString() }
+	}, o = "name = {event:String} AND occurred_at >= {from:DateTime64(3)}" + (n.to === void 0 ? "" : " AND occurred_at < {to:DateTime64(3)}");
+	if (i != null && (a.tenant = i, o += " AND tenant_id = {tenant:String}"), r !== void 0) {
+		let t = 0;
+		for (let [n, i] of Object.entries(r)) {
+			let r = `f${t++}`;
+			a[r] = String(i), o += ` AND ${b(e, n)} = {${r}:String}`;
+		}
+	}
+	return {
+		sql: o,
+		params: a
+	};
+}, T = (t) => {
+	let n = (n, r) => e.gen(function* () {
+		d(n, "mirror table");
+		let i = yield* h(t);
+		yield* e.tryPromise({
+			try: () => i.insert({
+				table: `${t.database}.${a(n)}`,
+				values: [r],
+				format: "JSONEachRow"
+			}),
+			catch: (e) => e
+		});
+	});
+	return {
+		tables: t.mirrorTables,
+		primaryKey: t.mirrorPrimaryKey,
+		upsert: ({ table: r, row: i, version: a }) => e.gen(function* () {
+			let e = String(i[t.mirrorPrimaryKey]);
+			yield* n(r, {
+				id: e,
+				data: JSON.stringify(i),
+				version: a,
+				is_deleted: 0
+			});
+		}).pipe(l("mirror.upsert")),
+		remove: ({ table: t, primaryKeyValue: r, version: i }) => e.gen(function* () {
+			yield* n(t, {
+				id: String(r),
+				data: "{}",
+				version: i,
+				is_deleted: 1
+			});
+		}).pipe(l("mirror.remove")),
+		maxVersion: ({ table: n, primaryKeyValue: r }) => e.gen(function* () {
+			d(String(n), "mirror table");
+			let i = yield* h(t), o = `SELECT max(version) AS v, count() AS n FROM ${t.database}.${a(String(n))} WHERE id = {id: String} FORMAT JSON`, s = yield* e.tryPromise({
+				try: () => i.query({
+					query: o,
+					query_params: { id: String(r) }
+				}),
+				catch: (e) => e
+			}), { data: c } = yield* e.tryPromise({
+				try: () => s.json(),
+				catch: (e) => e
+			}), l = c[0];
+			return l === void 0 || Number(l.n) === 0 || l.v === null ? null : Number(l.v);
+		}).pipe(l("mirror.maxVersion"))
+	};
+}, E = (t) => {
+	let n = t.mirrorTables.length > 0 ? T(t) : void 0;
+	return {
+		info: {
+			provider: i,
+			capabilities: {
+				track: !0,
+				aggregate: !0,
+				timeseries: !0,
+				topN: !0,
+				mirror: n !== void 0
+			},
+			detail: {
+				database: t.database,
+				table: t.table,
+				...t.mirrorTables.length > 0 ? { mirrorTables: t.mirrorTables } : {},
+				...t.batcher === void 0 ? {} : { batching: !0 }
+			}
+		},
+		track: (n) => t.batcher ? e.sync(() => t.batcher.add(n)) : e.gen(function* () {
+			let r = yield* h(t);
+			yield* e.tryPromise({
+				try: () => r.insert({
+					table: `${t.database}.${t.table}`,
+					values: [_(n)],
+					format: "JSONEachRow"
+				}),
+				catch: (e) => e
+			});
+		}).pipe(l("track")),
+		aggregate: (n) => e.gen(function* () {
+			let r = yield* h(t), i = w("aggregate", n.event, n.range, n.filter, n.tenantId), a = `SELECT ${S("aggregate", n.metric)} AS value FROM ${t.database}.${t.table} WHERE ${i.sql} FORMAT JSON`, o = yield* e.tryPromise({
+				try: () => r.query({
+					query: a,
+					query_params: i.params
+				}),
+				catch: (e) => e
+			}), { data: s } = yield* e.tryPromise({
+				try: () => o.json(),
+				catch: (e) => e
+			}), c = s[0]?.value ?? 0;
+			return typeof c == "number" ? c : Number(c ?? 0);
+		}).pipe(l("aggregate")),
+		timeseries: (n) => e.gen(function* () {
+			let r = yield* h(t), i = w("timeseries", n.event, n.range, n.filter, n.tenantId), a = `
+        SELECT ${`${y(n.bucket)}(occurred_at)`} AS bucket_start, ${S("timeseries", n.metric)} AS value
+        FROM ${t.database}.${t.table}
+        WHERE ${i.sql}
+        GROUP BY bucket_start
+        ORDER BY bucket_start ASC
+        FORMAT JSON
+      `, o = yield* e.tryPromise({
+				try: () => r.query({
+					query: a,
+					query_params: i.params
+				}),
+				catch: (e) => e
+			}), { data: s } = yield* e.tryPromise({
+				try: () => o.json(),
+				catch: (e) => e
+			});
+			return s.map((e) => ({
+				bucketStart: new Date(e.bucket_start),
+				value: typeof e.value == "number" ? e.value : Number(e.value ?? 0)
+			}));
+		}).pipe(l("timeseries")),
+		topN: (n) => e.gen(function* () {
+			let r = yield* h(t), i = w("topN", n.event, n.range, n.filter, n.tenantId), a = Math.max(1, Math.floor(n.n)), o = b("topN", n.groupBy), s = `
+        SELECT ${o} AS key, ${C("topN", n.metric)} AS value
+        FROM ${t.database}.${t.table}
+        WHERE ${i.sql}
+        GROUP BY ${o}
+        ORDER BY value DESC
+        LIMIT ${a}
+        FORMAT JSON
+      `, c = yield* e.tryPromise({
+				try: () => r.query({
+					query: s,
+					query_params: i.params
+				}),
+				catch: (e) => e
+			}), { data: l } = yield* e.tryPromise({
+				try: () => c.json(),
+				catch: (e) => e
+			});
+			return l.filter((e) => e.key !== null).map((e) => ({
+				key: e.key,
+				value: typeof e.value == "number" ? e.value : Number(e.value ?? 0)
+			}));
+		}).pipe(l("topN")),
+		...n === void 0 ? {} : { mirror: n }
+	};
+};
+//#endregion
+export { s as EVENTS_TABLE_DDL, o as MIRROR_TABLE_DDL, d as assertIdentifier, E as buildClickhouseSink, g as closeClickhouseState, v as makeEventBatcher, a as mirrorTableName };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-clickhouse",
-  "version": "0.85.0",
+  "version": "0.87.0",
   "description": "ClickHouse AnalyticsSink. Native HTTP ingest into a ClickHouse cluster — self-hosted OR ClickHouse Cloud. Production-grade OLAP for high-cardinality events with millisecond aggregate queries over billions of rows.",
   "keywords": [
     "voltro",
@@ -34,8 +34,8 @@
   },
   "dependencies": {
     "@clickhouse/client": "^1.23.1",
-    "@voltro/logger": "0.85.0",
-    "@voltro/runtime": "0.85.0"
+    "@voltro/logger": "0.87.0",
+    "@voltro/runtime": "0.87.0"
   },
   "peerDependencies": {
     "effect": "4.0.1"