@voltro/database 0.62.2 → 0.62.3

package/CHANGELOG.md

@@ -39,6 +39,19 @@ _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

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.2",
+  "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.2",
+    "@voltro/logger": "0.62.3",
     "typeid-js": "^1.2.0",
     "ulidx": "^2.4.1"
   },