@mastra/clickhouse 1.16.1 → 1.17.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/dist/docs/SKILL.md +1 -1
  2. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  3. package/dist/docs/references/integrations-databases-clickhouse.md +6 -0
  4. package/dist/index.cjs +492 -35
  5. package/dist/index.cjs.map +1 -1
  6. package/dist/index.js +469 -36
  7. package/dist/index.js.map +1 -1
  8. package/dist/storage/db/replication.d.ts.map +1 -1
  9. package/dist/storage/domains/observability/index.d.ts.map +1 -1
  10. package/dist/storage/domains/observability/v-next/ddl.d.ts +3 -1
  11. package/dist/storage/domains/observability/v-next/ddl.d.ts.map +1 -1
  12. package/dist/storage/domains/observability/v-next/deletion-requests.d.ts +28 -0
  13. package/dist/storage/domains/observability/v-next/deletion-requests.d.ts.map +1 -0
  14. package/dist/storage/domains/observability/v-next/index.d.ts +8 -2
  15. package/dist/storage/domains/observability/v-next/index.d.ts.map +1 -1
  16. package/dist/storage/domains/observability/v-next/trace-query.d.ts +12 -0
  17. package/dist/storage/domains/observability/v-next/trace-query.d.ts.map +1 -0
  18. package/dist/storage/domains/observability/v-next/tracing.d.ts +22 -7
  19. package/dist/storage/domains/observability/v-next/tracing.d.ts.map +1 -1
  20. package/dist/storage/index.d.ts +4 -1
  21. package/dist/storage/index.d.ts.map +1 -1
  22. package/package.json +2 -2
package/dist/docs/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: mastra-clickhouse
3
3
  description: Documentation for @mastra/clickhouse. Use when working with @mastra/clickhouse APIs, configuration, or implementation.
4
4
  metadata:
5
5
  package: "@mastra/clickhouse"
6
- version: "1.16.1"
6
+ version: "1.17.0-alpha.1"
7
7
  ---
8
8
 
9
9
  ## When to use
package/dist/docs/assets/SOURCE_MAP.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.16.1",
2
+ "version": "1.17.0-alpha.1",
3
3
  "package": "@mastra/clickhouse",
4
4
  "exports": {},
5
5
  "modules": {}
package/dist/docs/references/integrations-databases-clickhouse.md CHANGED
@@ -87,6 +87,12 @@ export const mastra = new Mastra({
87
87
 
88
88
  `MastraStorageExporter` automatically selects the `insert-only` strategy when ClickHouse is the observability backend, which gives the highest write throughput. See [tracing strategies](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage) for details.
89
89
 
90
+ Trace deletion cascades to spans, trace roots and branches, metrics, logs, scores, and feedback linked by trace ID. Signals without a trace ID are preserved. Mastra records the deletion predicate, then waits for ClickHouse lightweight delete masks to be applied. Normal reads no longer return the rows matched by that operation when the call resolves.
91
+
92
+ Lightweight deletion is a hide-only operation that marks rows with ClickHouse's `_row_exists` mask. Physical removal depends on merges and deployment-configured retention TTLs. `ObservabilityStorageClickhouseVNext` applies retention only when you provide a `RetentionConfig`; Mastra OSS doesn't configure a default retention TTL.
93
+
94
+ Deletion requests aren't purged automatically in Mastra OSS. Automatic retirement will be introduced with future database-agnostic retention configuration.
95
+
90
96
  ### Observability with the legacy domain
91
97
 
92
98
  `ObservabilityStorageClickhouse` is the original observability adapter and remains supported for projects that haven't migrated to the vNext schema. The configuration shape is the same as the vNext class.