@voltro/plugin-tinybird 0.86.0 → 0.88.0
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.
- package/CHANGELOG.md +5484 -0
- package/README.md +27 -0
- package/THIRD-PARTY-NOTICES.md +1511 -276
- package/dist/index.js +3 -3
- package/dist/sink.js +1 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -24,3 +24,30 @@ deliberately short so there is nothing here to drift out of date.
|
|
|
24
24
|
|
|
25
25
|
Proprietary. © 2026 Voltro UG. Your use is governed by the
|
|
26
26
|
[Terms of Service](https://voltro.cloud/legal/terms). See the bundled `LICENSE`.
|
|
27
|
+
|
|
28
|
+
## Boot dependencies and ownership
|
|
29
|
+
|
|
30
|
+
Every `AnalyticsSinkSpec` declares `sql: 'required'` or `sql: 'none'`.
|
|
31
|
+
`postgresAnalytics()` requires the application's SQL store. DuckDB, ClickHouse,
|
|
32
|
+
Tinybird and PostHog build independently and can be configured on a memory-store
|
|
33
|
+
app. A composite requires SQL when any member requires it. A missing required
|
|
34
|
+
SQL store refuses boot; only absent `analytics` selects the no-op sink.
|
|
35
|
+
|
|
36
|
+
The app waits for configured initialization before admitting requests. A failed
|
|
37
|
+
ClickHouse ping prevents schema commands; failed ping, DDL or cancellation closes
|
|
38
|
+
the client. An initialization failure refuses boot with a redacted diagnosis and
|
|
39
|
+
cleans the owning resources. Providers without an initializer still report
|
|
40
|
+
upstream failure on their normal operations; boot is not an external readiness
|
|
41
|
+
proof for Tinybird or PostHog.
|
|
42
|
+
|
|
43
|
+
The owner stops new operation admission, waits for accepted event/query/mirror
|
|
44
|
+
operations and then disposes the provider and its SQL scope once. Custom builders
|
|
45
|
+
stay pure; resource acquisition belongs in `initialize`, and `dispose` awaits
|
|
46
|
+
actual cleanup. Composite hooks receive their own child instance, initialize in
|
|
47
|
+
declaration order and unwind in reverse order. Construct fresh specs for another
|
|
48
|
+
application owner. Batching and mirror delivery guarantees remain provider-specific;
|
|
49
|
+
this lifecycle does not make buffered events durable.
|
|
50
|
+
|
|
51
|
+
Custom specs must declare their SQL dependency, and direct builder calls narrow
|
|
52
|
+
on `spec.sql`: required builders receive a `SqlClient`; independent builders take
|
|
53
|
+
no arguments. Run `voltro update` for the analytics owner migration guidance.
|