@voltro/data-transfer 0.66.0 → 0.67.0

package/CHANGELOG.md

@@ -39,6 +39,58 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.67.0] — 2026-09-07
+
+### ⚠ BREAKING
+
+- **@voltro/client, @voltro/protocol, @voltro/runtime, @voltro/cli, @voltro/web** — Confirmed optimistic writes now reconcile against a token-bound post-ACK primary snapshot, never an unrelated delta, changed row or timeout. Matching snapshots retire only covered previews; server normalisation and later writers remain authoritative. Same-tick acknowledgements coalesce, and affected cache entries preserve primary consistency across same-subject reconnects. Migration: deploy matching client/server framework versions together and account for an additional subscription read per affected acknowledgement group; affected entries use primary snapshots instead of replica reads/delta-resume for their cache lifetime. Native hooks need no source rewrite. Direct callers of the public `supersedesConfirmedPatches(event, baseBefore, baseAfter)` helper must migrate to `(event, reconciliationToken)` using the token of the post-ACK read, or use the native `SubscriptionCache`; row comparison cannot be mechanically rewritten into causal proof.
+
+  **`voltro update` carries you across this** — codemod `0.67.0/01_subscription-reconciliation`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.67.0).
+- **@voltro/cli** — `voltro support sentry <eventId>` is removed. It wrapped `sentry-cli sourcemaps explain`, which sentry-cli 3 dropped in favour of Sentry's in-product source-map debugger; `@voltro/cli` now depends on `@sentry/cli` 3, whose `execute(args, live)` takes a boolean. Migration: delete the invocation from scripts, CI jobs and runbooks and read the event's source-map resolution in Sentry itself. `voltro support collect` is unchanged.
+
+  **`voltro update` carries you across this** — codemod `0.67.0/03_support-sentry-removed`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.67.0).
+- **@voltro/cli, @voltro/workflow, @voltro/testing** — `voltro test` runs on vitest 5, and `@voltro/workflow` names `vitest ^5.0.0` as its peer. Migration: set `vitest` and `@vitest/coverage-v8` to `^5.0.0` together in every app that declares them (the coverage provider peer-pins the exact vitest version), install, and run the suite once — vitest 5 clears mocks before each test by default, fails a test whose async assertion was not awaited, and no longer looks a config file up in ancestor directories. Scaffolded templates ship on 5.
+
+  **`voltro update` carries you across this** — codemod `0.67.0/02_vitest-5`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.67.0).
+
+### Added
+
+- **@voltro/ui-shadcn, @voltro/cli, @voltro/devtools, @voltro/devtools-ui** — Add the opt-in Signal brand stylesheet, accessible `SignalHeader` and pausable `SignalField` with reduced-motion and visibility handling. Development and production builds resolve the stylesheet from the same UI-kit installation; the in-browser devtools use the matching plum/violet palette and declare the Tailwind dependency required to compile their source stylesheet locally.
+
+  Code blocks use matching light/dark surfaces, code comparisons retain readable contrast, and the shared routes view uses a direct heading.
+
+  `DocsLayout` supports custom header and introduction slots and an optional desktop sidebar. Its mobile drawer uses native modal focus and Escape behavior; search contains keyboard focus and restores the opener when dismissed.
+
+  `VoltroWordmark` owns product badges and an operator warning tone. `SignalHeader` shares responsive brand geometry and an optional sticky reading surface; `AppShell` accepts a custom header slot. All first-party product headers and footers use this composition, including the compact local Devtools identity.
+
+  Shared `SignalPreferences`, `SignalSearch` and `SignalHeaderAction` align header controls across public and operating apps. Signal fields support both themes; `ProfileMenu` accepts a custom trigger and preserves an explicit System choice.
+
+### Changed
+
+- **@voltro/cli, @voltro/runtime, @voltro/database, @voltro/protocol, @voltro/voltro, @voltro/sql-mssql, @voltro/sql-turso, @voltro/workflow, @voltro/plugin-sso-saml, @voltro/plugin-sentry** — Dependency refresh: Effect 3.22.1 with the matching `@effect/*` patch releases (`@effect/cluster` 0.60.2, `@effect/sql-mssql` 0.54.0, `@effect/platform` 0.97.1, `@effect/rpc` 0.76.2, `@effect/sql` 0.52.1, `@effect/workflow` 0.19.1), `@libsql/client` 0.18.0 — and `@effect/sql-mssql` 0.54.0 flipped its TLS default to encrypt-and-verify, so the mssql dialect now passes `encrypt: false` explicitly for an unset connection to keep the documented modes (unset → plaintext, `sslmode=require` → encrypt without verification) — `@sentry/cli` 3, `xml-encryption` 6, vite 8.2.2, and the tracked minor/patch lines. The mssql patch for `@effect/cluster` — the four SQL fixes plus the shard-release backoff — was regenerated against 0.60.2 (upstream refactored `SqlMessageStorage`, so the 0.60.0 hunks no longer applied) and ships as `patches/@effect__cluster@0.60.2.patch`; `voltro add mssql` writes the new key. Projects scaffolded by the CLI record the pnpm that ran it, which is 12.x on the framework's own toolchain; pnpm 11+ replaced `onlyBuiltDependencies` with `allowBuilds`, and the framework's workspaces declare it.
+
+### Fixed
+
+- **@voltro/cli, @voltro/runtime, @voltro/database, @voltro/voltro** — The tunable readers that take `env = process.env` (`resolveEagerFallbackWarnIntervalMs`, `resolveWorkflowRecordingMode`, `readPollCeilingMs`, and the `SchedulingEnv` / `ReactiveEnv` / `InspectRingsEnv` shapes) accept a bare `NodeJS.ProcessEnv` again. They were typed as all-optional literals, which TypeScript's weak-type check rejects for `Dict<string>` the moment nothing in the compilation augments `ProcessEnv` — an app that compiles framework source with only `@types/node` (a mobile app, which declares no env) failed `tsc` on `dbMetrics.ts`. The parameters now carry an index signature.
+- **@voltro/client, @voltro/web** — The subscription recovery watchdog knows when it was throttled. A browser delays timers in a hidden tab, so the stall timer could fire long after it was due, report the interval it was armed with as the interval waited, warn, and invalidate entries whose deliveries were queued behind the same throttling. It now compares its due time with its fire time: late beyond a tolerance, or firing in a hidden tab, it records one `subscription.recovery-timer-late` per attempt (with `timerLateMs` and `hidden`) and re-arms; the first on-time fire in a visible tab decides. `subscription.recovery-stuck` carries the time actually waited and the number of deferrals.
+
+  The client runtime yields to the event loop through a `MessageChannel` in the browser instead of `setTimeout`, so tasks queued behind Effect's periodic yield are not held to the hidden-tab timer grid. `runtime.resolved` records the channel in use as `scheduler`.
+
+  `socket.frames` marks frame-arrival bursts on the raw socket — the first frame after open and each frame that follows a gap of five seconds or more, at most eight per socket — so an export separates a late arrival from late processing.
+
+  `apiSurface: compatible` — the golden churn in `@voltro/client` and `@voltro/web` is two members added to the `ClientDiagnosticKind` union (`socket.frames`, `subscription.recovery-timer-late`); every existing member is unchanged, the framework is the only producer, and a reader that does not know the new kinds sees two more events it can ignore. Only a switch exhaustive over the vocabulary needs two arms.
+- **@voltro/cli** — Web middleware is precompiled into the server production output and rooted by runtime pruning, preserving its behavior in source-free Docker deployments. Missing transitive imports now fail loudly instead of silently disabling a present middleware; rebuilding after removal clears the previous policy. Runtime tracing also preserves transitive dependencies when a deploy directory is reached through a symlink. Native bundle imports now propagate missing-library and initialization errors instead of returning a circular shim's empty exports. Rebuild and deploy the complete `.framework` output; no application API changes are required.
+
+---
+
+## [0.66.1] — 2026-09-06
+
+### Fixed
+
+- **@voltro/cli** — API serve and web start bundles preserve esbuild's caught-import handling: a missing `require()` inside `try/catch` or a caught dynamic import can use its source fallback without a package.json optional-dependency declaration. This fixes the 0.66.0 minified MySQL/MariaDB serve-build regression at mysql2's optional `cardinal` debug highlighter; no direct `cardinal` dependency is needed after upgrading and rebuilding the API. Unhandled missing dependencies and broken installed exports still fail the build. Regression tests execute minified fallback code and build/import production serve bundles for every registered SQL-driver package, plus MariaDB, without requiring database services.
+
+---
+
 ## [0.66.0] — 2026-09-06
 
 ### ⚠ BREAKING

package/THIRD-PARTY-NOTICES.md

@@ -9,7 +9,7 @@ Generated from the resolved runtime dependency closure (118 packages).
 
 ---
 
-## @aws-sdk/checksums@3.1000.26
+## @aws-sdk/checksums@3.1000.29
 
 License: Apache-2.0
 
@@ -217,7 +217,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/client-s3@3.1107.0
+## @aws-sdk/client-s3@3.1126.0
 
 License: Apache-2.0
 
@@ -425,7 +425,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/core@3.977.6
+## @aws-sdk/core@3.977.9
 
 License: Apache-2.0
 
@@ -633,7 +633,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/credential-provider-env@3.972.67
+## @aws-sdk/credential-provider-env@3.972.70
 
 License: Apache-2.0
 
@@ -841,13 +841,13 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/credential-provider-http@3.972.69
+## @aws-sdk/credential-provider-http@3.972.72
 
 License: Apache-2.0
 
 _(no bundled license text found in the package; see its npm page.)_
 
-## @aws-sdk/credential-provider-ini@3.973.12
+## @aws-sdk/credential-provider-ini@3.973.15
 
 License: Apache-2.0
 
@@ -1055,13 +1055,13 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/credential-provider-login@3.972.74
+## @aws-sdk/credential-provider-login@3.972.77
 
 License: Apache-2.0
 
 _(no bundled license text found in the package; see its npm page.)_
 
-## @aws-sdk/credential-provider-node@3.972.78
+## @aws-sdk/credential-provider-node@3.972.82
 
 License: Apache-2.0
 
@@ -1269,7 +1269,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/credential-provider-process@3.972.67
+## @aws-sdk/credential-provider-process@3.972.70
 
 License: Apache-2.0
 
@@ -1477,7 +1477,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/credential-provider-sso@3.973.11
+## @aws-sdk/credential-provider-sso@3.973.14
 
 License: Apache-2.0
 
@@ -1685,7 +1685,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/credential-provider-web-identity@3.972.73
+## @aws-sdk/credential-provider-web-identity@3.972.76
 
 License: Apache-2.0
 
@@ -1893,7 +1893,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/lib-storage@3.1107.0
+## @aws-sdk/lib-storage@3.1126.0
 
 License: Apache-2.0
 
@@ -2101,7 +2101,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/middleware-sdk-s3@3.972.72
+## @aws-sdk/middleware-sdk-s3@3.972.75
 
 License: Apache-2.0
 
@@ -2309,13 +2309,13 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/nested-clients@3.997.41
+## @aws-sdk/nested-clients@3.997.44
 
 License: Apache-2.0
 
 _(no bundled license text found in the package; see its npm page.)_
 
-## @aws-sdk/s3-request-presigner@3.1107.0
+## @aws-sdk/s3-request-presigner@3.1126.0
 
 License: Apache-2.0
 
@@ -2523,7 +2523,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/signature-v4-multi-region@3.996.43
+## @aws-sdk/signature-v4-multi-region@3.996.46
 
 License: Apache-2.0
 
@@ -2731,7 +2731,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/token-providers@3.1103.0
+## @aws-sdk/token-providers@3.1116.0
 
 License: Apache-2.0
 
@@ -2939,7 +2939,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/types@3.974.2
+## @aws-sdk/types@3.974.5
 
 License: Apache-2.0
 
@@ -3147,7 +3147,7 @@ Apache License
    limitations under the License.
 ```
 
-## @aws-sdk/xml-builder@3.972.37
+## @aws-sdk/xml-builder@3.972.40
 
 License: Apache-2.0
 
@@ -3704,7 +3704,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @azure/core-rest-pipeline@1.23.0
+## @azure/core-rest-pipeline@1.24.0
 
 License: MIT
 
@@ -3900,7 +3900,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @effect/cluster@0.60.0
+## @effect/cluster@0.60.2
 
 License: MIT
 
@@ -3928,7 +3928,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @effect/platform-node@0.108.0
+## @effect/platform-node@0.108.1
 
 License: MIT
 
@@ -3956,7 +3956,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @effect/platform-node-shared@0.61.0
+## @effect/platform-node-shared@0.61.1
 
 License: MIT
 
@@ -3984,7 +3984,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @effect/sql@0.52.0
+## @effect/sql@0.52.1
 
 License: MIT
 
@@ -4012,7 +4012,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @effect/workflow@0.19.0
+## @effect/workflow@0.19.1
 
 License: MIT
 
@@ -4129,13 +4129,13 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## @img/sharp-libvips-linux-x64@1.3.2
+## @img/sharp-libvips-linux-x64@1.3.3
 
 License: LGPL-3.0-or-later
 
 _(no bundled license text found in the package; see its npm page.)_
 
-## @img/sharp-linux-x64@0.35.3
+## @img/sharp-linux-x64@0.35.4
 
 License: Apache-2.0
 
@@ -4576,7 +4576,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/api-logs@0.221.0
+## @opentelemetry/api-logs@0.222.0
 
 License: Apache-2.0
 
@@ -4784,7 +4784,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/context-async-hooks@2.10.0
+## @opentelemetry/context-async-hooks@2.11.0
 
 License: Apache-2.0
 
@@ -4992,7 +4992,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/core@2.9.0
+## @opentelemetry/core@2.10.0
 
 License: Apache-2.0
 
@@ -5200,7 +5200,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/exporter-metrics-otlp-http@0.221.0
+## @opentelemetry/exporter-metrics-otlp-http@0.222.0
 
 License: Apache-2.0
 
@@ -5408,7 +5408,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/exporter-trace-otlp-http@0.221.0
+## @opentelemetry/exporter-trace-otlp-http@0.222.0
 
 License: Apache-2.0
 
@@ -5616,7 +5616,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/otlp-exporter-base@0.221.0
+## @opentelemetry/otlp-exporter-base@0.222.0
 
 License: Apache-2.0
 
@@ -5824,7 +5824,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/otlp-transformer@0.221.0
+## @opentelemetry/otlp-transformer@0.222.0
 
 License: Apache-2.0
 
@@ -6032,7 +6032,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/resources@2.10.0
+## @opentelemetry/resources@2.11.0
 
 License: Apache-2.0
 
@@ -6240,7 +6240,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/sdk-logs@0.221.0
+## @opentelemetry/sdk-logs@0.222.0
 
 License: Apache-2.0
 
@@ -6448,7 +6448,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/sdk-metrics@2.10.0
+## @opentelemetry/sdk-metrics@2.11.0
 
 License: Apache-2.0
 
@@ -6656,7 +6656,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/sdk-trace@2.10.0
+## @opentelemetry/sdk-trace@2.11.0
 
 License: Apache-2.0
 
@@ -6864,7 +6864,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/sdk-trace-base@2.10.0
+## @opentelemetry/sdk-trace-base@2.11.0
 
 License: Apache-2.0
 
@@ -7072,7 +7072,7 @@ Apache License
    limitations under the License.
 ```
 
-## @opentelemetry/sdk-trace-node@2.10.0
+## @opentelemetry/sdk-trace-node@2.11.0
 
 License: Apache-2.0
 
@@ -7544,7 +7544,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @smithy/core@3.31.1
+## @smithy/core@3.33.3
 
 License: Apache-2.0
 
@@ -7960,7 +7960,7 @@ Apache License
    limitations under the License.
 ```
 
-## @smithy/fetch-http-handler@5.6.13
+## @smithy/fetch-http-handler@5.8.0
 
 License: Apache-2.0
 
@@ -8168,7 +8168,7 @@ Apache License
    limitations under the License.
 ```
 
-## @smithy/node-http-handler@4.9.13
+## @smithy/node-http-handler@4.12.1
 
 License: Apache-2.0
 
@@ -8584,7 +8584,7 @@ Apache License
    limitations under the License.
 ```
 
-## @smithy/types@4.16.1
+## @smithy/types@4.18.0
 
 License: Apache-2.0
 
@@ -8820,7 +8820,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @upstash/redis@1.38.2
+## @upstash/redis@1.38.3
 
 License: MIT
 
@@ -9736,7 +9736,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## jose@6.2.8
+## jose@6.2.10
 
 License: MIT
 
@@ -9882,7 +9882,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## multipasta@0.2.7
+## multipasta@0.2.8
 
 License: MIT
 
@@ -9954,7 +9954,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## picomatch@4.0.5
+## picomatch@4.0.7
 
 License: MIT
 
@@ -10142,7 +10142,7 @@ ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
 IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 ```
 
-## sharp@0.35.3
+## sharp@0.35.4
 
 License: Apache-2.0
 
@@ -10761,7 +10761,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## undici@8.9.0
+## undici@8.10.0
 
 License: MIT
 

package/dist/index.js

@@ -1120,7 +1120,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		let e = t.primaryKey?.[0] ?? "id";
 		for (let i of t.columns) {
 			let a = i.references;
-			a === void 0 || !n.has(a.table) || r.push({
+			a !== void 0 && n.has(a.table) && r.push({
 				from: t.name,
 				column: i.name,
 				to: a.table,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/data-transfer",
-  "version": "0.66.0",
+  "version": "0.67.0",
   "description": "Portable export/import for a Voltro app's data + assets — typed-NDJSON row codec, content-addressed assets, framed compression, a resumable chunk ledger, and FK-ordered idempotent import. Dialect-agnostic; the resilient backbone under `voltro data export|import` and native backups.",
   "keywords": [
     "voltro",
@@ -33,11 +33,11 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.66.0",
-    "@voltro/plugin-storage": "0.66.0"
+    "@voltro/database": "0.67.0",
+    "@voltro/plugin-storage": "0.67.0"
   },
   "peerDependencies": {
-    "effect": "^3.22.0"
+    "effect": "^3.22.1"
   },
   "publishConfig": {
     "access": "public"