@voltro/plugin-clickhouse 0.33.0 → 0.34.0

package/dist/index.d.ts

@@ -70,8 +70,13 @@ export declare const EVENTS_TABLE_DDL: (database: string, table: string) => stri
  * gives idempotent upserts — re-inserting the same row with a newer
  * `version` collapses to the latest on merge. Deletes insert a tombstone
  * (`is_deleted = 1`); queries filter `is_deleted = 0` (or use the
- * `FINAL` modifier). `version` is a monotonic micro-timestamp so a later
- * write always wins.
+ * `FINAL` modifier).
+ *
+ * `version` is the framework's per-change ordering token
+ * (`MirrorVersion`), assigned in COMMIT order and carried on the write.
+ * It is never read from a clock inside this sink — that is what makes
+ * "a later write always wins" true of the later COMMIT rather than of
+ * whichever HTTP request happened to arrive last.
  */
 export declare const MIRROR_TABLE_DDL: (database: string, sourceTable: string) => string;
 

package/dist/index.js

@@ -138,20 +138,20 @@ var a = r({ scope: "@voltro/plugin-clickhouse" }), o = "clickhouse", s = (e) =>
 	return {
 		tables: e.mirrorTables,
 		primaryKey: e.mirrorPrimaryKey,
-		upsert: (r, i) => t.gen(function* () {
+		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: Date.now() * 1e3,
+				version: a,
 				is_deleted: 0
 			});
 		}).pipe(d("mirror.upsert")),
-		remove: (e, r) => t.gen(function* () {
+		remove: ({ table: e, primaryKeyValue: r, version: i }) => t.gen(function* () {
 			yield* n(e, {
 				id: String(r),
 				data: "{}",
-				version: Date.now() * 1e3,
+				version: i,
 				is_deleted: 1
 			});
 		}).pipe(d("mirror.remove"))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-clickhouse",
-  "version": "0.33.0",
+  "version": "0.34.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.33.0",
-    "@voltro/runtime": "0.33.0"
+    "@voltro/logger": "0.34.0",
+    "@voltro/runtime": "0.34.0"
   },
   "peerDependencies": {
     "effect": "^3.22.0"