@voltro/database 0.62.1 → 0.62.3

package/CHANGELOG.md

@@ -39,6 +39,35 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.62.3] — 2026-09-03
+
+### Added
+
+- **@voltro/runtime** — `EffectStore` now exposes the complete Promise-store mutation surface plus transactions that roll back while preserving an inner Effect Cause. `defineSubscriber` accepts `eachReplica: true` so local per-replica work can state its topology explicitly; it cannot be combined with `once`.
+
+### Fixed
+
+- **@voltro/cli** — `voltro build` no longer starts Vite's HMR WebSocket while pre-rendering. A `RedirectError` from a static loader is now emitted as redirect metadata and served by `voltro start` with its exact status and `Location`; unrelated loader errors still fail the build.
+- **@voltro/cli, @voltro/database, @voltro/plugin-storage** — `voltro doctor` now resolves grouped event bindings and narrows its hand-roll, junction, ownership, nullable-write, singleton-read, and UI reachability checks to evidence they can actually prove. Ids owned by external systems can be declared with `.externalId()`; plugin references and non-FK asset references carry that metadata automatically.
+
+---
+
+## [0.62.2] — 2026-09-03
+
+### Added
+
+- **@voltro/client, @voltro/web, @voltro/runtime, @voltro/cli, @voltro/devtools, @voltro/workflow** — Reconnect incidents now have one bounded, payload-free evidence path: browser diagnostics retain runtime/socket/protocol/subscription transitions across a reload, the subscriptions panel exposes recovery progress and stuck re-issues, and `voltro support collect` joins that export to inspect snapshots and exact browser-to-replica socket ids. The opt-in browser fault harness can reproduce a bounded transport cut without a proxy; logs and traces remain excluded from the support bundle unless explicitly requested.
+
+  Workflow admission rows now retain queue-time app/schema provenance. `voltro workflows flow validate` checks queued payloads against the current release without returning them, while `flow retry <intentId>` re-arms one retained dead letter after its fix. Support bundles also inventory project `conflictColumns` callsites, and `voltro support sentry <eventId>` delegates source-map resolution diagnosis to Sentry's own CLI.
+- **@voltro/runtime** — Successful rpc WebSocket upgrades now emit structured open and close records carrying the serving `replicaId` and a stable per-socket `connectionId`, so connection cuts can be correlated to an api replica without debug traffic.
+
+### Fixed
+
+- **@voltro/client, @voltro/web, @voltro/react-native** — Subscription recovery now re-issues transport-failed active subscriptions only after the rpc protocol has cleared the previous socket error. A longer outage could previously reopen the WebSocket, immediately reject every re-issued subscription against the stale error, and leave the screen degraded until a reload.
+- **@voltro/workflow, @voltro/cli, @voltro/devtools-ui** — Queued workflow starts whose stored payload no longer decodes now signal `onFailure` once and remain visible as dead-letter intents instead of retrying forever. Inspect or remove them with `voltro workflows flow` and `voltro workflows flow discard <intentId>`; a valid later debounce arrival for the same key replaces the obsolete payload and resumes normal draining.
+
+---
+
 ## [0.62.1] — 2026-09-02
 
 ### Fixed
@@ -46,6 +75,11 @@ _Changes staged for the next release accumulate here (rolled up from
 - **@voltro/client, @voltro/web, @voltro/react-native** — `useSubscriptionHealth` now clears failures when replacement subscriptions succeed after a reconnect; each api keeps one error bus across transport, auth-refresh, and subject-reconnect generations.
 - **@voltro/client, @voltro/web, @voltro/react-native** — Active subscriptions whose fibers ended in a transport failure are now re-issued when the rpc socket opens again, preserving their last rows and resume revision; `useConnectionStatus` stays degraded until every affected subscription delivers a later snapshot or delta.
 
+  **Correction:** In 0.62.1 that reissue runs on the raw WebSocket `open`, before
+  the rpc protocol clears the previous socket error. After a longer outage the
+  reissued fibers can therefore fail immediately and remain terminal. The next
+  patch moves recovery behind the protocol-ready `onOpen` effect.
+
 ### Internal (no consumer-facing effect)
 
 - **@voltro/local-first** — Release dependency floors now exclude the vulnerable `fast-uri` and `@xmldom/xmldom` ranges, and the local-first test toolchain uses the patched Tiptap release.

package/dist/{frameworkLiveTables-CwDemhjW.js → frameworkLiveTables-CewCJ809.js}

@@ -38,6 +38,13 @@ var r = (e) => {
 			nullable: !0
 		});
 	}
+	externalId() {
+		if (this.rejectIfRaw("externalId"), this.definition.type === "reference" || this.definition.type === "id") throw Error(`.externalId() requires a scalar non-primary-key column (got ${this.definition.type}) — \`reference()\` is local by definition and \`id()\` identifies this row.`);
+		return new e({
+			...this.definition,
+			externalId: !0
+		});
+	}
 	encrypted() {
 		return this.rejectIfRaw("encrypted"), new e({
 			...this.definition,

package/dist/index.d.ts

@@ -946,6 +946,13 @@ export declare class ColumnBuilder<TsType, Type extends ColumnType, HasDefault e
      */
     private rejectIfRaw;
     nullable(): ColumnBuilder<TsType | null, Type, HasDefault>;
+    /**
+     * Declare that this scalar id points outside the app's local database graph.
+     * Use it for provider, gateway, hardware, polymorphic, or cross-installation
+     * identifiers that intentionally must not become `reference()` columns.
+     * This is schema metadata only and does not change the SQL column.
+     */
+    externalId(): this;
     /**
      * Encrypt this column's value at rest (AES-256-GCM). The runtime
      * store middleware transparently encrypts on write + decrypts on
@@ -1382,6 +1389,12 @@ export declare interface ColumnDefinition<TsType, Type extends ColumnType = Colu
      * overhead.
      */
     readonly fkAutoIndex?: boolean;
+    /**
+     * This id-shaped scalar names something outside the local relational graph.
+     * Set by `.externalId()` so schema audits do not guess a local FK from the
+     * column name. Metadata only; it emits no constraint or DDL.
+     */
+    readonly externalId?: boolean;
     readonly jsonType?: unknown;
     /**
      * Closed value set, set by `text().oneOf([...])`. When present:

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as e, $t as t, A as n, At as r, B as i, Bt as a, C as o, Ct as s, D as c, Dt as l, E as u, Et as d, F as f, Ft as p, G as m, Gt as h, H as g, Ht as _, I as ee, It as te, J as ne, Jt as v, K as y, Kt as re, L as b, Lt as ie, M as ae, Mt as oe, N as x, Nt as se, O as ce, Ot as le, P as ue, Pt as de, Q as fe, Qt as pe, R as me, Rt as he, S as ge, St as _e, T as ve, Tt as ye, U as be, Ut as S, V as xe, Vt as Se, W as Ce, Wt as we, X as Te, Xt as Ee, Y as De, Yt as Oe, Z as ke, Zt as Ae, _ as je, _t as Me, a as Ne, at as Pe, b as Fe, bt as Ie, c as Le, ct as Re, d as ze, dt as Be, en as C, et as Ve, f as He, ft as Ue, g as We, gt as Ge, h as w, ht as Ke, it as T, j as qe, jt as Je, k as Ye, kt as Xe, l as Ze, lt as Qe, m as $e, mt as et, n as tt, nt, o as rt, ot as it, p as at, pt as ot, q as E, qt as st, r as ct, rt as lt, s as ut, st as dt, t as ft, tn as pt, tt as mt, u as ht, ut as gt, v as _t, vt, w as yt, wt as bt, x as xt, xt as St, y as Ct, yt as wt, z as Tt, zt as Et } from "./frameworkLiveTables-CwDemhjW.js";
+import { $ as e, $t as t, A as n, At as r, B as i, Bt as a, C as o, Ct as s, D as c, Dt as l, E as u, Et as d, F as f, Ft as p, G as m, Gt as h, H as g, Ht as _, I as ee, It as te, J as ne, Jt as v, K as y, Kt as re, L as b, Lt as ie, M as ae, Mt as oe, N as x, Nt as se, O as ce, Ot as le, P as ue, Pt as de, Q as fe, Qt as pe, R as me, Rt as he, S as ge, St as _e, T as ve, Tt as ye, U as be, Ut as S, V as xe, Vt as Se, W as Ce, Wt as we, X as Te, Xt as Ee, Y as De, Yt as Oe, Z as ke, Zt as Ae, _ as je, _t as Me, a as Ne, at as Pe, b as Fe, bt as Ie, c as Le, ct as Re, d as ze, dt as Be, en as C, et as Ve, f as He, ft as Ue, g as We, gt as Ge, h as w, ht as Ke, it as T, j as qe, jt as Je, k as Ye, kt as Xe, l as Ze, lt as Qe, m as $e, mt as et, n as tt, nt, o as rt, ot as it, p as at, pt as ot, q as E, qt as st, r as ct, rt as lt, s as ut, st as dt, t as ft, tn as pt, tt as mt, u as ht, ut as gt, v as _t, vt, w as yt, wt as bt, x as xt, xt as St, y as Ct, yt as wt, z as Tt, zt as Et } from "./frameworkLiveTables-CewCJ809.js";
 import { timestampMs as Dt, timestampMsOrNull as Ot } from "./wire.js";
 import { Cause as kt, Chunk as At, Data as jt, Effect as D, Exit as Mt, Metric as O, MetricBoundaries as Nt, Option as k, Runtime as Pt, Schedule as Ft, Schema as A, Stream as It } from "effect";
 import { createHash as Lt } from "node:crypto";

package/dist/sql.d.ts

@@ -428,6 +428,12 @@ declare interface ColumnDefinition<TsType, Type extends ColumnType = ColumnType,
      * overhead.
      */
     readonly fkAutoIndex?: boolean;
+    /**
+     * This id-shaped scalar names something outside the local relational graph.
+     * Set by `.externalId()` so schema audits do not guess a local FK from the
+     * column name. Metadata only; it emits no constraint or DDL.
+     */
+    readonly externalId?: boolean;
     readonly jsonType?: unknown;
     /**
      * Closed value set, set by `text().oneOf([...])`. When present:

package/dist/sql.js

@@ -1,4 +1,4 @@
-import { $ as e, $t as t, Ht as n, Ut as r, a as i, at as a, c as o, d as s, en as c, et as l, g as u, h as d, i as f, it as p, o as m, r as h, s as g, tt as _, u as v, vt as y, wt as b, y as x } from "./frameworkLiveTables-CwDemhjW.js";
+import { $ as e, $t as t, Ht as n, Ut as r, a as i, at as a, c as o, d as s, en as c, et as l, g as u, h as d, i as f, it as p, o as m, r as h, s as g, tt as _, u as v, vt as y, wt as b, y as x } from "./frameworkLiveTables-CewCJ809.js";
 import { Effect as S, Schedule as C } from "effect";
 import { createHash as w } from "node:crypto";
 import { createLogger as T } from "@voltro/logger";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/database",
-  "version": "0.62.1",
+  "version": "0.62.3",
   "description": "Browser-safe schema DSL, query builder, and cross-dialect migration planner for Voltro — one schema, every SQL backend.",
   "keywords": [
     "voltro",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@effect/sql": "^0.52.0",
-    "@voltro/logger": "0.62.1",
+    "@voltro/logger": "0.62.3",
     "typeid-js": "^1.2.0",
     "ulidx": "^2.4.1"
   },