@voltro/database 0.86.0 → 0.87.0

package/dist/index.d.ts

@@ -293,7 +293,8 @@ export declare const AUTO_FILLED_COLUMNS: readonly ["id", "tenantId", "createdAt
 
 declare type AutoFilledColumn = (typeof AUTO_FILLED_COLUMNS)[number];
 
-export declare const avg: (column: string, alias?: string) => AggregateColumn;
+/** `AVG(column)` — always a `number` (a mean is not exact), `null` over no rows. */
+export declare const avg: (column: string, alias?: string) => AggregateColumn<number | null>;
 
 export declare const avgOver: (column: string, alias?: string) => WindowBuilder;
 
@@ -905,6 +906,24 @@ export declare const changeUpdate: (table: string, before: Row, after: Row, meta
  */
 export declare const chunkRowsForInsert: <T extends Record<string, unknown>>(rows: ReadonlyArray<T>, limits: BulkInsertLimits | undefined) => ReadonlyArray<ReadonlyArray<T>>;
 
+/**
+ * The id of the key a ciphertext names, read off the value without any key —
+ * what lets a status count values per key instead of decrypting each one.
+ *
+ * The id is the LAST `:`-separated part of the envelope
+ * (`enc:v2:<r|c>:<iv>:<tag>:<ct>:<kid>`, `enc:v1:<iv>:<tag>:<ct>:<kid>`), after
+ * everything a release without key ids reads. That placement is deliberate:
+ * such a release takes the first parts and ignores the rest, so during a
+ * rolling deploy, and after a rollback, it still reads what the keyring wrote.
+ * The id is a lookup hint, not an authenticated field: a value whose id was
+ * altered still has to pass GCM under some key of the keyring, and a reader
+ * that verifies (the retire gate) decrypts rather than trusts it.
+ *
+ * `undefined` for a value written before ids, and for anything that is not a
+ * ciphertext.
+ */
+export declare const ciphertextKeyId: (value: unknown) => string | undefined;
+
 /**
  * Claim the attribution for an echo, or `undefined` if this write did not
  * originate here.
@@ -2562,6 +2581,14 @@ export declare interface DataStore {
      * up, on `FluentStore.query`, which is what handlers actually call.
      */
     query(descriptor: QueryDescriptor): Promise<ReadonlyArray<Row>>;
+    /** Server-internal constraint/integrity read on this exact store view.
+     * Bypasses request row visibility only; preserves tenant, deletion/expiry
+     * scopes, codecs, physical namespace and in-flight transaction writes.
+     * Never use its rows as an application response or mutation authorization.
+     * Optional for custom stores: a consumer requiring complete coverage must
+     * refuse when absent, never fall back to an ordinary filtered query.
+     */
+    integrityQuery?(descriptor: QueryDescriptor): Promise<ReadonlyArray<Row>>;
     /** Insert a row. Emits an insert ChangeEvent (deferred if inside `transactional()`). */
     insert(table: string, row: Row): Promise<Row>;
     /**
@@ -2581,8 +2608,14 @@ export declare interface DataStore {
      *   - memory store:                       loop + per-row emit
      *
      * An empty `rows` array is a no-op that returns `[]` (no statement, no events).
+     *
+     * `{ returning: 'none' }` is for a caller that does not read the result: it
+     * resolves to `[]`. The rows are written, and their change events emitted,
+     * exactly as without it; the store reads the inserted rows back only when
+     * change events or an in-transaction recorder need them
+     * (`writeImagesObserved`). A wrapper store forwards `options` unchanged.
      */
-    insertMany(table: string, rows: ReadonlyArray<Row>): Promise<ReadonlyArray<Row>>;
+    insertMany(table: string, rows: ReadonlyArray<Row>, options?: InsertManyOptions): Promise<ReadonlyArray<Row>>;
     /**
      * In-place JSON merge: set `value` at `path` inside the JSON column
      * (`path` is the column name, optionally with a nested dot-path, e.g.
@@ -2978,12 +3011,13 @@ export declare interface DataStore {
      * not. Without a savepoint the two are incompatible, so `--atomic` simply
      * could not import such a bundle on those engines.
      *
-     * Only the TRANSACTIONAL views implement it, and only for the engines that
-     * need it: the mysql family and sqlite leave a transaction usable after a
-     * failed statement, so wrapping every row there would buy nothing and cost a
-     * round trip per row. Callers guard with `if (store.savepoint)` and run `fn`
-     * directly otherwise — which is also correct outside a transaction, where
-     * there is nothing to protect.
+     * Every shipped memory and SQL TRANSACTIONAL view implements it. Besides
+     * statement-abort recovery, it isolates a compound operation whose typed
+     * application error may be handled inside the outer transaction. Rollback
+     * discards that operation's buffered committed-change events as well as rows;
+     * earlier events and successful nesting remain intact. Root stores have no
+     * savepoint. Custom stores may omit it; operations requiring local atomicity
+     * must refuse rather than run without protection.
      *
      * Failures propagate: the savepoint is rolled back and the error rethrown, so
      * the caller's own error handling is unchanged.
@@ -3192,6 +3226,9 @@ export declare interface DbOpSample {
  */
 export declare const decimal: (precision: number, scale?: number) => ColumnBuilder<string, "decimal">;
 
+/** Equality key for exact fixed-point decimal strings; null for invalid input. */
+export declare const decimalEqualityKey: (value: unknown) => string | null;
+
 /**
  * Declare that an enum value was renamed. Place this NEXT TO the
  * `dbEnum(...)` declaration whose value array now carries the new label:
@@ -3276,6 +3313,12 @@ export declare const decodeRowsForTable: <T extends Record<string, unknown>>(row
  */
 export declare const decodeRowsFromSchema: <T extends Record<string, unknown>>(rows: ReadonlyArray<T>, tableName: string, dialect: DecoderDialectId, query?: QueryDescriptor) => ReadonlyArray<T>;
 
+/**
+ * Decode the rows of a SELECT: by the query's aggregations when it has them,
+ * by the table's columns otherwise. Every dialect store's read path calls this.
+ */
+export declare const decodeSelectRows: <T extends Record<string, unknown>>(rows: ReadonlyArray<T>, query: QueryDescriptor, dialect: DecoderDialectId) => ReadonlyArray<T>;
+
 /**
  * Decrypt every `.encrypted()` column's value on read. A value that
  * isn't a framework ciphertext (legacy plaintext, `null`) passes
@@ -3816,6 +3859,9 @@ export declare const encodeFieldValue: (cipher: FieldCipher, value: unknown, bin
  */
 export declare const encodeRowForSchema: <T extends Record<string, unknown>>(row: T, tableName: string, types?: ReadonlyArray<ColumnType>) => T;
 
+/** 16 bytes → the 26-character lowercase Crockford-base32 suffix of the spec. */
+export declare const encodeTypeIdSuffix: (src: Uint8Array) => string;
+
 /** The UNBOUND envelope: `enc:v1:<iv>:<tag>:<ct>`. */
 export declare const ENCRYPTED_PREFIX = "enc:v1:";
 
@@ -3975,6 +4021,13 @@ export declare interface FallbackLogger {
     readonly debug: (message: string, fields?: Record<string, unknown>) => void;
 }
 
+/**
+ * A key id: a short slug, so it can ride inside every envelope. Explicit ids
+ * are chosen by the operator (`VOLTRO_FIELD_ENCRYPTION_KEYS`); derived ids are
+ * `k` + 10 hex characters of a fingerprint that is not the key.
+ */
+export declare const FIELD_KEY_ID_PATTERN: RegExp;
+
 /**
  * Where a ciphertext BELONGS — the table, the column and, when the row's
  * identity is known at write time, the row. Fed to AES-GCM as additional
@@ -4008,6 +4061,16 @@ export declare interface FieldBinding {
  *  its string form and a read of the numeric column agree. */
 export declare const fieldBinding: (table: string, column: string, rowId?: unknown) => FieldBinding;
 
+/**
+ * Every address a column's values may have been sealed under: its own, and the
+ * names a DECLARED rename says it had — `table('new').renamedFrom('old')`, a
+ * column's `.renamedFrom('old')`. A rename is catalog-only, so the rows keep the
+ * bytes bound to the old name; without this every value of a renamed column
+ * stopped opening. Only declared names are added: a value moved anywhere else
+ * still refuses. The own address comes first — a re-key seals under it.
+ */
+export declare const fieldBindingsOf: (table: TableLike, column: string, rowId?: unknown) => ReadonlyArray<FieldBinding>;
+
 /** The cipher the store middleware injects. Operates on opaque strings. */
 export declare interface FieldCipher {
     /**
@@ -4030,6 +4093,15 @@ export declare interface FieldCipher {
      * a cipher with one key.
      */
     readonly sealedWithPreviousKey?: (ciphertext: string, binding?: FieldBinding) => boolean;
+    /** The id of the key new values are sealed under — a keyring's active key. */
+    readonly activeKeyId?: string;
+    /**
+     * The id of the key that opens this value: the one the value names when that
+     * key opens it, otherwise the key of the keyring that does (a value written
+     * before ciphertexts carried an id). `undefined` when no key of the keyring
+     * opens it.
+     */
+    readonly keyIdOf?: (ciphertext: string, binding?: FieldBinding) => string | undefined;
 }
 
 /**
@@ -4714,6 +4786,17 @@ export declare const insertIgnoreRowOutcome: <T extends AnyTable>(store: TypedIn
     readonly outcome: "inserted" | "ignored";
 }>;
 
+/** Options of {@link DataStore.insertMany}. */
+export declare interface InsertManyOptions {
+    /**
+     * `'rows'` (the default) resolves to the inserted rows as stored. `'none'`
+     * resolves to `[]`, so a store need not send the rows back: a bulk insert
+     * into a table no change event or recorder observes then costs one
+     * statement per chunk and no result rows.
+     */
+    readonly returning?: 'rows' | 'none';
+}
+
 /**
  * Insert MANY rows, typed against the table — `insertRow`'s batch, and nothing
  * else: it forwards to `store.insertMany` unchanged, so the chunking, the
@@ -4734,8 +4817,9 @@ export declare const insertIgnoreRowOutcome: <T extends AnyTable>(store: TypedIn
  *
  * An empty array is a legal no-op, so a caller does not have to guard the call
  * — `store.insertMany` decides what that means, and it means "insert nothing".
+ * `{ returning: 'none' }` is forwarded as well: it resolves to `[]`.
  */
-export declare const insertManyRows: <T extends AnyTable>(store: TypedInsertManyStore, table: T, rows: ReadonlyArray<InferInsertRow<T>>) => Promise<ReadonlyArray<InferRow<T>>>;
+export declare const insertManyRows: <T extends AnyTable>(store: TypedInsertManyStore, table: T, rows: ReadonlyArray<InferInsertRow<T>>, options?: InsertManyOptions) => Promise<ReadonlyArray<InferRow<T>>>;
 
 /**
  * Insert a row, typed against the table: the payload must carry every required
@@ -6181,6 +6265,10 @@ Joins extends JoinsMap = {}> {
      * on sqlite (its writers are serialised already).
      */
     forUpdate: () => Query<RowOf, IxNames, Joins>;
+    /** Hold a shared SQL row lock until transaction end; concurrent readers may
+     * proceed. SQLite-family stores retain their transaction isolation without
+     * row-lock SQL, and memory retains optimistic validation. */
+    forShare: () => Query<RowOf, IxNames, Joins>;
     /**
      * Cross-tenant: opt OUT of the runtime's automatic
      * `tenantId = <subject.tenantId>` scope on `tenant()` tables. Use for
@@ -6561,13 +6649,14 @@ export declare interface QueryDescriptor<R = Row> {
     readonly includeExpired?: boolean;
     /**
      * Lock the matched rows for the rest of the enclosing transaction — set by
-     * `.forUpdate()`. `SELECT … FOR UPDATE` on postgres / mysql / mariadb,
-     * `WITH (UPDLOCK, ROWLOCK)` on mssql; sqlite serialises writers already and
+     * `.forUpdate()` for exclusive intent, `.forShare()` for concurrent readers
+     * that must fence writers. SQL dialects retain the lock until transaction end;
+     * sqlite serialises writers already and
      * emits nothing. Outside a transaction the lock is released as the statement
      * ends, which is harmless and useless — the point is a read-modify-write
      * whose read and write share one transaction.
      */
-    readonly lock?: 'update';
+    readonly lock?: 'update' | 'share';
     /**
      * Opt OUT of the runtime's automatic tenant scope on `tenant()` tables.
      * Set by `.unscoped()`. Honored by the runtime, same as `includeDeleted`.
@@ -7063,6 +7152,15 @@ export declare interface ReferenceOptions {
     readonly column?: string;
 }
 
+/**
+ * Refuse an UPDATE that changes the id of a row with `.encrypted()` columns.
+ * Each sealed value is bound to its row's id: an update that moved the row to a
+ * new id left every sealed value in it bound to the old one, reported success,
+ * and from then on every read of the row failed. Move such a row by writing it
+ * under the new id (insert, then delete the old one) — the store seals it there.
+ */
+export declare const refuseIdChangeOfSealedRow: (patch: Row, table: TableLike | undefined, rowId: unknown) => void;
+
 /**
  * Build the error a dialect store throws when the framework refuses a write.
  *
@@ -7286,7 +7384,10 @@ export declare const resolveActorSnapshot: (store: ActorLookupStore, subjectId:
 export declare type ResolveAggregateResult<A, RowOf, Joins extends JoinsMap> = A extends {
     readonly op: 'min' | 'max';
     readonly column: infer C extends string;
-} ? ResolveJoinedSource<C, RowOf, Joins> | null : A extends AggregateColumn<infer T> ? T : never;
+} ? ResolveJoinedSource<C, RowOf, Joins> | null : A extends {
+    readonly op: 'sum';
+    readonly column: infer C extends string;
+} ? [NonNullable<ResolveJoinedSource<C, RowOf, Joins>>] extends [string] ? string | null : number | null : A extends AggregateColumn<infer T> ? T : never;
 
 /**
  * Pick the branch mechanism. Prioritises the Neon copy-on-write fast-path when
@@ -8385,7 +8486,13 @@ export declare interface SubqueryInPredicate {
  */
 export declare type SubqueryResults = Map< QueryDescriptor, Set<unknown> | number>;
 
-export declare const sum: (column: string, alias?: string) => AggregateColumn;
+/** `SUM(column)` — a `number` over `integer()` / `real()`, the exact decimal
+ *  STRING over `decimal()` / `bigint()` (the column's own type), `null` over no
+ *  rows. On a typed query the result type follows the column. */
+export declare const sum: <C extends string>(column: C, alias?: string) => AggregateColumn<number | null> & {
+    readonly op: "sum";
+    readonly column: C;
+};
 
 export declare const sumOver: (column: string, alias?: string) => WindowBuilder;
 
@@ -9277,7 +9384,7 @@ export declare interface TypedInsertIgnoreOutcomeStore {
 
 /** The minimal store surface `insertManyRows` needs. */
 export declare interface TypedInsertManyStore {
-    readonly insertMany: (table: string, rows: ReadonlyArray<Row>) => Promise<ReadonlyArray<Row>>;
+    readonly insertMany: (table: string, rows: ReadonlyArray<Row>, options?: InsertManyOptions) => Promise<ReadonlyArray<Row>>;
 }
 
 /** The minimal store surface `insertRow` needs — satisfied by `ctx.store`. */
@@ -9305,6 +9412,14 @@ export declare interface TypedUpsertStore {
     readonly upsert: (table: string, row: Row, options: UpsertOptions) => Promise<Row>;
 }
 
+/**
+ * A fresh TypeID for `prefix`: `user_01h455vb4pex5vsknk084sn02q`. This is what
+ * the `typeid` id scheme writes on insert; call it yourself when a row's id
+ * has to exist before the insert (a self-referencing `createdBy`, a child row
+ * written in the same flow).
+ */
+export declare const typeId: (prefix: string) => string;
+
 /**
  * `(SELECT ...) UNION (SELECT ...) ...` — dedup-merge. Q6.
  *
@@ -9460,6 +9575,9 @@ export declare const upsertUpdatePatch: (row: Row, existing: Row, options: Upser
 /** Shared driver lowering: omit undefined values and refuse identity rewrites. */
 export declare const upsertUpdateValues: (options: UpsertOptions) => Record<string, unknown>;
 
+/** The 16 bytes of a fresh UUIDv7 (RFC 9562), monotonic within this process. */
+export declare const uuidV7Bytes: (now?: number) => Uint8Array;
+
 /**
  * Validate one column-name key on a table's fields map. Throws on
  * empty / invalid characters / > 63 bytes. Records a WARN above 50.
@@ -9706,6 +9824,9 @@ export declare const VOLTRO_LOCAL_FIRST_MIXIN_ID: "voltro/localFirst";
  */
 export declare const _voltroApiKeysTable: SchemaTable;
 
+/** Finalized role-observation history survives graceful replica shutdown. */
+export declare const _voltroApiRoleWorkloadBucketsTable: SchemaTable;
+
 export declare const _voltroCdcOffsetsTable: TableLike;
 
 /**
@@ -10001,6 +10122,18 @@ export declare interface WriteAttribution {
     readonly via?: 'agent';
 }
 
+/**
+ * Does anything read the row images of a write to `table`? A set-based write
+ * (`updateMany` / `deleteMany`) answers with a count; the stores fetch its rows
+ * back — `RETURNING *`, `OUTPUT`, a SELECT first — only to hand them to change
+ * events and in-transaction recorders. A `.nonReactive()` table that no
+ * recorder watches has neither, and the rows then crossed the wire for nobody:
+ * every retired aggregate generation, `rowData` included, on every refresh.
+ *
+ * Asked per statement, not cached: recorders register and suspend at runtime.
+ */
+export declare const writeImagesObserved: (table: string) => boolean;
+
 export declare type WriteRecorder = (port: TxnRecorderPort, write: RecordedWrite) => Promise<void>;
 
 /** Are recorders suspended right here? Exported so a caller can SAY so. */

package/dist/index.js

@@ -2,81 +2,82 @@ import { ColumnBuilder as e, SELF_REFERENCE_TARGET as t, array as n, bigint as r
 import { pluginRef as P, pluginRefSpecOf as F } from "./pluginRef.js";
 import { columnRef as I, isColumnReference as L } from "./columnReference.js";
 import { authoredError as R, authoredMessageOf as z, causeBranches as B, classifyConstraintViolation as V, describeCharsetRefusal as H, describeDriverError as U, describeRowBindings as W, extractDbCause as G, isForeignKeyViolation as K, isQueryTimeout as q, wireSafeCause as J } from "./dbCause.js";
-import { compareDecimal as Y } from "./decimalComparison.js";
-import { MATCHES_NO_ROWS as X, and as Z, arrayContains as Q, arrayHas as $, arrayOverlaps as ee, collectSubqueries as te, contains as ne, eq as re, evaluatePredicate as ie, exists as ae, gt as oe, gte as se, inSet as ce, inSubquery as le, isNotNull as ue, isNull as de, jsonField as fe, lt as pe, lte as me, neq as he, not as ge, notExists as _e, notInSet as ve, notInSubquery as ye, or as be, preparePredicate as xe, spatialPredicate as Se, startsWith as Ce, walkLeaves as we } from "./predicate.js";
-import { resolveActorSnapshot as Te } from "./actorSnapshot.js";
-import { allEnumRenames as Ee, clearEnumRenames as De, declareEnumRename as Oe, getEnumRenames as ke } from "./enumRenames.js";
-import { deserializeArraysOnRead as Ae, serializeArraysForWrite as je } from "./arrayCodec.js";
-import { BOUND_ENCRYPTED_PREFIX as Me, ENCRYPTED_PREFIX as Ne, FieldDecryptionError as Pe, decodeFieldValue as Fe, decryptFieldsOnRead as Ie, encodeFieldValue as Le, encryptFieldsForWrite as Re, encryptFieldsForWriteBatch as ze, encryptedColumnsOf as Be, fieldBinding as Ve, isBoundCiphertext as He, isEncrypted as Ue, isFieldDecryptionError as We, isRawEncoding as Ge } from "./fieldEncryption.js";
-import { refuseWrite as Ke, storeRefusalOf as qe } from "./storeRefusal.js";
-import { MAX_IDENTIFIER_LENGTH as Je, WARN_IDENTIFIER_LENGTH as Ye, drainIdentifierWarnings as Xe, validateColumnName as Ze, validateIndexName as Qe, validateTableName as $e, validateTypeIdPrefix as et } from "./identifierLimits.js";
-import { generateSnowflake as tt, resetSnowflake as nt } from "./snowflake.js";
-import { deriveTypeIdPrefix as rt, generateId as it, resolveIdScheme as at } from "./idGenerator.js";
-import { defineMixin as ot, mixin as st, resolveMixinGraph as ct } from "./mixins.js";
-import { AUTO_FILLED_COLUMNS as lt, jsonIndex as ut, table as dt, vectorDistanceToOpclass as ft } from "./table.js";
-import { DEFAULT_ACQUIRE_TIMEOUT_MS as pt, isMysqlFamily as mt, isSqliteFamily as ht, quoteIdent as gt } from "./dialect.js";
-import { allRegisteredTables as _t, clearTableRegistry as vt, ensureTableRegistered as yt, getTable as bt, isTableReactive as xt, registerTable as St, requireTable as Ct, unregisterTable as wt } from "./tableRegistry.js";
-import { avg as Tt, avgOver as Et, column as Dt, count as Ot, countDistinct as kt, databaseHandle as At, denseRank as jt, except as Mt, intersect as Nt, lag as Pt, lead as Ft, max as It, min as Lt, orderClausesOf as Rt, paginateBy as zt, paginateById as Bt, queryFor as Vt, rank as Ht, resolveFullTextIndex as Ut, rowNumber as Wt, sum as Gt, sumOver as Kt, union as qt, unionAll as Jt } from "./queryBuilder.js";
-import { isView as Yt, queryForView as Xt, view as Zt, viewSql as Qt } from "./view.js";
-import { INITIAL_VERSION as $t, VersionConflict as en, planVersionedUpdate as tn, settleVersionedUpdate as nn, versionColumnOf as rn } from "./optimisticVersion.js";
-import { timestampMs as an, timestampMsOrNull as on } from "./wire.js";
-import { columnSchema as sn, rowSchema as cn } from "./rowSchema.js";
-import { inferForeignKey as ln, isEmptyRelationsSpec as un, isRelationsSpec as dn, many as fn, manyToMany as pn, one as mn, relations as hn, validateRelationConfig as gn } from "./relations.js";
-import { allRegisteredRelations as _n, clearRelationsRegistry as vn, getRelation as yn, getRelations as bn, registerDiscoveredRelations as xn, registerRelations as Sn, validateRegisteredRelations as Cn } from "./relationsRegistry.js";
-import { DEFAULT_SUBJECT_GRAPH_DEPTH as wn, deriveSubjectGraph as Tn, formatSubjectGraph as En } from "./subjectGraph.js";
-import { decodeRowsForTable as Dn, decodeRowsFromSchema as On, encodeRowForSchema as kn } from "./rowDecoder.js";
-import { upsertUpdatePatch as An, upsertUpdateValues as jn } from "./upsertUpdate.js";
-import { isCompositeRowKey as Mn, rowKeyColumns as Nn, rowKeyIdentity as Pn } from "./rowKey.js";
-import { jsonPatchAssignments as Fn } from "./jsonPatchAssignments.js";
-import { applyJsonPatch as In, compileJsonPatch as Ln, normalizeJsonPatchValue as Rn } from "./jsonPatch.js";
-import { EagerCardinalityError as zn, attachEagerLoads as Bn, hasEagerLoads as Vn, oneCardinalityMessage as Hn } from "./joinCompiler.js";
-import { coerceValueForSqlite as Un } from "./sqliteValueCoercion.js";
-import { TenantNamespaceInvalid as Wn, TenantNamespaceUnresolved as Gn, qualifyTable as Kn, resolveTenantNamespace as qn, sanitizeIdentifierFragment as Jn } from "./namespace.js";
-import { coercePredicateValue as Yn, coercePredicateValues as Xn } from "./predicateCoercion.js";
-import { compilePredicate as Zn, compileRawFragment as Qn, compileRowProjection as $n, compileSelect as er, escapeLike as tr } from "./sqlCompiler.js";
-import { coercePredicateForSqlite as nr, compileEagerJson as rr } from "./jsonEagerCompiler.js";
-import { registerCoreTables as ir, requireActors as ar, requireTenants as or } from "./coreTablesRegistry.js";
-import { actorsTable as sr } from "./coreTables.js";
-import { changeDelete as cr, changeInsert as lr, changeSoftDelete as ur, changeUpdate as dr, externalChangeEvent as fr } from "./changeEvent.js";
-import { committedChangeBatchOf as pr, emitCommittedChanges as mr } from "./committedChanges.js";
-import { CHANGE_CLAIM_TTL_ENV as hr, DEFAULT_CHANGE_CLAIM_TTL_HOURS as gr, OccurrenceCounter as _r, changeDigest as vr, composeChangeKey as yr, occurrenceWindowMs as br, parseChangeKey as xr } from "./changeIdentity.js";
-import { attributionFields as Sr, currentWriteAttribution as Cr, runWithWriteAttribution as wr, withCapturedAttribution as Tr } from "./writeAttribution.js";
-import { attributionKey as Er, beginLocalWrite as Dr, claimPendingAttribution as Or, clearPendingAttribution as kr, endLocalWrite as Ar, pendingAttributionCount as jr, registerPendingAttribution as Mr, resolveEchoAttribution as Nr } from "./pendingAttribution.js";
-import { ID_COLUMN_MAX_LENGTH as Pr, derivedRowId as Fr, derivedRowIdLength as Ir } from "./derivedRowId.js";
-import { clearWriteRecorders as Lr, recordsTable as Rr, registerWriteRecorder as zr, runWriteRecorders as Br, suspendWriteRecorders as Vr, suspendWriteRecordersEffect as Hr, unregisterWriteRecorder as Ur, writeRecordersSuspended as Wr } from "./writeRecorder.js";
-import { DEFAULT_EAGER_FALLBACK_WARN_INTERVAL_MS as Gr, dbMetricTagCacheSizeForTests as Kr, dbOperationsInFlight as qr, makeEagerFallbackReporter as Jr, observeDbOp as Yr, recordDbOp as Xr, resetDbMetricTagCacheForTests as Zr, resolveEagerFallbackWarnIntervalMs as Qr } from "./dbMetrics.js";
-import { SHARED_TRANSACTION_SERVICE as $r, TransactionAbortedError as ei, isTransactionAbortedError as ti, makeTransactionAbortTracker as ni, onTransaction as ri, runRetryingTransaction as ii, runSavepoint as ai, runStoreTransaction as oi, settleTransactionExit as si, transactionRetrySchedule as ci } from "./transactionOutcome.js";
-import { MSSQL_TRANSIENT_NUMBERS as li, MYSQL_TRANSIENT_CODES as ui, POSTGRES_TRANSIENT_STATES as di, SQLITE_TRANSIENT_CODES as fi, TURSO_TRANSIENT_MESSAGE as pi, isTransientContention as mi } from "./transientContention.js";
-import { VOLTRO_EXPIRES_MIXIN_ID as hi, expires as gi } from "./expiresMixin.js";
-import { VOLTRO_LOCAL_FIRST_MIXIN_ID as _i, isLocalFirst as vi, localFirst as yi, localFirstTables as bi } from "./localFirstMixin.js";
-import { TableStreamError as xi, streamTable as Si } from "./stream.js";
-import { hybridSearch as Ci } from "./hybridSearch.js";
-import { computeEmbedding as wi, vectorEmbedding as Ti } from "./vectorEmbedding.js";
-import { BranchNameInvalid as Ei, BranchTransitionInvalid as Di, branchNamespaceName as Oi, enforceBranchLimits as ki, isBranchNamespace as Ai, isNeonConnection as ji, nextBranchState as Mi, planBranch as Ni, planBranchProvision as Pi, planBranchTeardown as Fi, planBranchTeardownFor as Ii, planNeonBranchProvision as Li, planNeonBranchTeardown as Ri, resolveBranchMechanism as zi } from "./branching.js";
-import { admitBranch as Bi, makeNamespaceBranchExecutor as Vi, provisionBranch as Hi, teardownBranch as Ui } from "./branchExecute.js";
-import { TenantRegionUnavailable as Wi, TenantResidencyUnresolved as Gi, bindResidentStore as Ki, clearResidencyConfig as qi, getResidencyConfig as Ji, isRegionServable as Yi, provisionResidentTenant as Xi, residentPlacement as Zi, resolveTenantHome as Qi, setResidencyConfig as $i } from "./residency.js";
-import { auditAllTableIndexes as ea, auditTableIndexes as ta, formatIndexAuditIssue as na } from "./indexAudit.js";
-import { defineSeed as ra, fireSchemaChangeSeeds as ia, fireTenantCreateSeeds as aa, isSeedDefinition as oa, setSchemaChangeSeedHook as sa, setTenantCreateSeedHook as ca } from "./seed.js";
-import { defineMigration as la, isMigrationDefinition as ua } from "./migration.js";
-import { FILE_MIGRATION_PATTERN as da, IrreversibleMigrationError as fa, MIGRATION_PHASES as pa, MigrationExpectationFailed as ma, MigrationNeedsSqlClient as ha, MigrationSkipped as ga, RewriteUnstableError as _a, TransactionBrokenByBodyError as va, irreversible as ya, irreversibleReason as ba, isFileMigration as xa, migration as Sa } from "./migrations/fileBased.js";
-import { DEFAULT_SOFT_DROP_RETENTION_DAYS as Ca, FRAMEWORK_LIVE_TABLES as wa, STAGING_TABLE_PREFIX as Ta, agedSoftDropSnapshots as Ea, describeAgedSoftDropSnapshots as Da, isFrameworkOwnedLiveTable as Oa, isSoftDropSnapshotName as ka, isStagingTableName as Aa, softDropSnapshotStamp as ja } from "./migrations/frameworkLiveTables.js";
-import { sqlError as Ma } from "./sqlError.js";
-import { _voltroApiKeysTable as Na, _voltroDevicesTable as Pa, _voltroIdempotencyTable as Fa, _voltroKvTable as Ia, _voltroMigrationPlansTable as La, _voltroMigrationsTable as Ra, _voltroPluginMigrationsTable as za, _voltroReplicaObservationsTable as Ba, _voltroSchemaOwnerTable as Va, _voltroSeedsTable as Ha, _voltroTenantSelectionsTable as Ua, frameworkTables as Wa } from "./frameworkTables.js";
-import { TENANT_SELECTIONS_TABLE as Ga, deleteTenantSelection as Ka, readTenantSelection as qa, tenantSelectionId as Ja, writeTenantSelection as Ya } from "./tenantSelection.js";
-import { REPLACE_IN_PROGRESS_TABLE as Xa, STAGING_STALE_MINUTES as Za, _voltroReplaceInProgressTable as Qa, interruptedReplaceRefusal as $a, stagingLeftoverReport as eo, stagingLeftovers as to, stagingNamesOf as no, stagingStaleAfterMs as ro } from "./replaceInProgress.js";
-import { stampGeneratedId as io, stampGeneratedIds as ao } from "./stampId.js";
-import { BULK_INSERT_LIMITS as oo, bulkInsertLimitsFor as so, chunkRowsForInsert as co, columnsPerRow as lo } from "./bulkInsertLimits.js";
-import { missingConflictColumns as uo, missingRequiredColumns as fo } from "./requiredColumns.js";
-import { insertIgnoreRowOutcome as po, insertManyRows as mo, insertRow as ho, updateManyRow as go, upsertRow as _o, upsertRowOutcome as vo } from "./typedStore.js";
-import { CHANGE_LISTENER_CEILING as yo, raiseChangeListenerCeiling as bo } from "./changeListenerCeiling.js";
-import { isPrimaryKeyConflictError as xo, primaryKeyConflictError as So } from "./storeErrors.js";
-import { connectionIdentity as Co, normaliseTarget as wo, sameDatabase as To } from "./connectionIdentity.js";
-import { clearRetentions as Eo, listRetentionConflicts as Do, listRetentions as Oo, registerRetention as ko, retentionTtlMsFromEnv as Ao, sweepRetention as jo } from "./retention.js";
-import { CDC_OFFSETS_TABLE as Mo, _voltroCdcOffsetsTable as No, _voltroMssqlCdcOffsetsTable as Po } from "./cdcOffsetsTables.js";
-import { DATA_TRANSFERS_TABLE as Fo, _voltroDataTransfersTable as Io, describeTransferRun as Lo } from "./dataTransfers.js";
-import { SCOPE_KEY_MAX_LENGTH as Ro, scopeKeyOf as zo } from "./scopeKey.js";
-import { SqlClient as Bo } from "effect/sql";
+import { compareDecimal as Y, decimalEqualityKey as X } from "./decimalComparison.js";
+import { MATCHES_NO_ROWS as Z, and as Q, arrayContains as $, arrayHas as ee, arrayOverlaps as te, collectSubqueries as ne, contains as re, eq as ie, evaluatePredicate as ae, exists as oe, gt as se, gte as ce, inSet as le, inSubquery as ue, isNotNull as de, isNull as fe, jsonField as pe, lt as me, lte as he, neq as ge, not as _e, notExists as ve, notInSet as ye, notInSubquery as be, or as xe, preparePredicate as Se, spatialPredicate as Ce, startsWith as we, walkLeaves as Te } from "./predicate.js";
+import { resolveActorSnapshot as Ee } from "./actorSnapshot.js";
+import { allEnumRenames as De, clearEnumRenames as Oe, declareEnumRename as ke, getEnumRenames as Ae } from "./enumRenames.js";
+import { deserializeArraysOnRead as je, serializeArraysForWrite as Me } from "./arrayCodec.js";
+import { BOUND_ENCRYPTED_PREFIX as Ne, ENCRYPTED_PREFIX as Pe, FIELD_KEY_ID_PATTERN as Fe, FieldDecryptionError as Ie, ciphertextKeyId as Le, decodeFieldValue as Re, decryptFieldsOnRead as ze, encodeFieldValue as Be, encryptFieldsForWrite as Ve, encryptFieldsForWriteBatch as He, encryptedColumnsOf as Ue, fieldBinding as We, fieldBindingsOf as Ge, isBoundCiphertext as Ke, isEncrypted as qe, isFieldDecryptionError as Je, isRawEncoding as Ye, refuseIdChangeOfSealedRow as Xe } from "./fieldEncryption.js";
+import { refuseWrite as Ze, storeRefusalOf as Qe } from "./storeRefusal.js";
+import { MAX_IDENTIFIER_LENGTH as $e, WARN_IDENTIFIER_LENGTH as et, drainIdentifierWarnings as tt, validateColumnName as nt, validateIndexName as rt, validateTableName as it, validateTypeIdPrefix as at } from "./identifierLimits.js";
+import { encodeTypeIdSuffix as ot, typeId as st, uuidV7Bytes as ct } from "./typeId.js";
+import { generateSnowflake as lt, resetSnowflake as ut } from "./snowflake.js";
+import { deriveTypeIdPrefix as dt, generateId as ft, resolveIdScheme as pt } from "./idGenerator.js";
+import { defineMixin as mt, mixin as ht, resolveMixinGraph as gt } from "./mixins.js";
+import { AUTO_FILLED_COLUMNS as _t, jsonIndex as vt, table as yt, vectorDistanceToOpclass as bt } from "./table.js";
+import { DEFAULT_ACQUIRE_TIMEOUT_MS as xt, isMysqlFamily as St, isSqliteFamily as Ct, quoteIdent as wt } from "./dialect.js";
+import { allRegisteredTables as Tt, clearTableRegistry as Et, ensureTableRegistered as Dt, getTable as Ot, isTableReactive as kt, registerTable as At, requireTable as jt, unregisterTable as Mt } from "./tableRegistry.js";
+import { avg as Nt, avgOver as Pt, column as Ft, count as It, countDistinct as Lt, databaseHandle as Rt, denseRank as zt, except as Bt, intersect as Vt, lag as Ht, lead as Ut, max as Wt, min as Gt, orderClausesOf as Kt, paginateBy as qt, paginateById as Jt, queryFor as Yt, rank as Xt, resolveFullTextIndex as Zt, rowNumber as Qt, sum as $t, sumOver as en, union as tn, unionAll as nn } from "./queryBuilder.js";
+import { isView as rn, queryForView as an, view as on, viewSql as sn } from "./view.js";
+import { INITIAL_VERSION as cn, VersionConflict as ln, planVersionedUpdate as un, settleVersionedUpdate as dn, versionColumnOf as fn } from "./optimisticVersion.js";
+import { timestampMs as pn, timestampMsOrNull as mn } from "./wire.js";
+import { columnSchema as hn, rowSchema as gn } from "./rowSchema.js";
+import { inferForeignKey as _n, isEmptyRelationsSpec as vn, isRelationsSpec as yn, many as bn, manyToMany as xn, one as Sn, relations as Cn, validateRelationConfig as wn } from "./relations.js";
+import { allRegisteredRelations as Tn, clearRelationsRegistry as En, getRelation as Dn, getRelations as On, registerDiscoveredRelations as kn, registerRelations as An, validateRegisteredRelations as jn } from "./relationsRegistry.js";
+import { DEFAULT_SUBJECT_GRAPH_DEPTH as Mn, deriveSubjectGraph as Nn, formatSubjectGraph as Pn } from "./subjectGraph.js";
+import { decodeRowsForTable as Fn, decodeRowsFromSchema as In, decodeSelectRows as Ln, encodeRowForSchema as Rn } from "./rowDecoder.js";
+import { upsertUpdatePatch as zn, upsertUpdateValues as Bn } from "./upsertUpdate.js";
+import { isCompositeRowKey as Vn, rowKeyColumns as Hn, rowKeyIdentity as Un } from "./rowKey.js";
+import { jsonPatchAssignments as Wn } from "./jsonPatchAssignments.js";
+import { applyJsonPatch as Gn, compileJsonPatch as Kn, normalizeJsonPatchValue as qn } from "./jsonPatch.js";
+import { EagerCardinalityError as Jn, attachEagerLoads as Yn, hasEagerLoads as Xn, oneCardinalityMessage as Zn } from "./joinCompiler.js";
+import { coerceValueForSqlite as Qn } from "./sqliteValueCoercion.js";
+import { TenantNamespaceInvalid as $n, TenantNamespaceUnresolved as er, qualifyTable as tr, resolveTenantNamespace as nr, sanitizeIdentifierFragment as rr } from "./namespace.js";
+import { coercePredicateValue as ir, coercePredicateValues as ar } from "./predicateCoercion.js";
+import { compilePredicate as or, compileRawFragment as sr, compileRowProjection as cr, compileSelect as lr, escapeLike as ur } from "./sqlCompiler.js";
+import { coercePredicateForSqlite as dr, compileEagerJson as fr } from "./jsonEagerCompiler.js";
+import { registerCoreTables as pr, requireActors as mr, requireTenants as hr } from "./coreTablesRegistry.js";
+import { actorsTable as gr } from "./coreTables.js";
+import { changeDelete as _r, changeInsert as vr, changeSoftDelete as yr, changeUpdate as br, externalChangeEvent as xr } from "./changeEvent.js";
+import { committedChangeBatchOf as Sr, emitCommittedChanges as Cr } from "./committedChanges.js";
+import { CHANGE_CLAIM_TTL_ENV as wr, DEFAULT_CHANGE_CLAIM_TTL_HOURS as Tr, OccurrenceCounter as Er, changeDigest as Dr, composeChangeKey as Or, occurrenceWindowMs as kr, parseChangeKey as Ar } from "./changeIdentity.js";
+import { attributionFields as jr, currentWriteAttribution as Mr, runWithWriteAttribution as Nr, withCapturedAttribution as Pr } from "./writeAttribution.js";
+import { attributionKey as Fr, beginLocalWrite as Ir, claimPendingAttribution as Lr, clearPendingAttribution as Rr, endLocalWrite as zr, pendingAttributionCount as Br, registerPendingAttribution as Vr, resolveEchoAttribution as Hr } from "./pendingAttribution.js";
+import { ID_COLUMN_MAX_LENGTH as Ur, derivedRowId as Wr, derivedRowIdLength as Gr } from "./derivedRowId.js";
+import { clearWriteRecorders as Kr, recordsTable as qr, registerWriteRecorder as Jr, runWriteRecorders as Yr, suspendWriteRecorders as Xr, suspendWriteRecordersEffect as Zr, unregisterWriteRecorder as Qr, writeImagesObserved as $r, writeRecordersSuspended as ei } from "./writeRecorder.js";
+import { DEFAULT_EAGER_FALLBACK_WARN_INTERVAL_MS as ti, dbMetricTagCacheSizeForTests as ni, dbOperationsInFlight as ri, makeEagerFallbackReporter as ii, observeDbOp as ai, recordDbOp as oi, resetDbMetricTagCacheForTests as si, resolveEagerFallbackWarnIntervalMs as ci } from "./dbMetrics.js";
+import { SHARED_TRANSACTION_SERVICE as li, TransactionAbortedError as ui, isTransactionAbortedError as di, makeTransactionAbortTracker as fi, onTransaction as pi, runRetryingTransaction as mi, runSavepoint as hi, runStoreTransaction as gi, settleTransactionExit as _i, transactionRetrySchedule as vi } from "./transactionOutcome.js";
+import { MSSQL_TRANSIENT_NUMBERS as yi, MYSQL_TRANSIENT_CODES as bi, POSTGRES_TRANSIENT_STATES as xi, SQLITE_TRANSIENT_CODES as Si, TURSO_TRANSIENT_MESSAGE as Ci, isTransientContention as wi } from "./transientContention.js";
+import { VOLTRO_EXPIRES_MIXIN_ID as Ti, expires as Ei } from "./expiresMixin.js";
+import { VOLTRO_LOCAL_FIRST_MIXIN_ID as Di, isLocalFirst as Oi, localFirst as ki, localFirstTables as Ai } from "./localFirstMixin.js";
+import { TableStreamError as ji, streamTable as Mi } from "./stream.js";
+import { hybridSearch as Ni } from "./hybridSearch.js";
+import { computeEmbedding as Pi, vectorEmbedding as Fi } from "./vectorEmbedding.js";
+import { BranchNameInvalid as Ii, BranchTransitionInvalid as Li, branchNamespaceName as Ri, enforceBranchLimits as zi, isBranchNamespace as Bi, isNeonConnection as Vi, nextBranchState as Hi, planBranch as Ui, planBranchProvision as Wi, planBranchTeardown as Gi, planBranchTeardownFor as Ki, planNeonBranchProvision as qi, planNeonBranchTeardown as Ji, resolveBranchMechanism as Yi } from "./branching.js";
+import { admitBranch as Xi, makeNamespaceBranchExecutor as Zi, provisionBranch as Qi, teardownBranch as $i } from "./branchExecute.js";
+import { TenantRegionUnavailable as ea, TenantResidencyUnresolved as ta, bindResidentStore as na, clearResidencyConfig as ra, getResidencyConfig as ia, isRegionServable as aa, provisionResidentTenant as oa, residentPlacement as sa, resolveTenantHome as ca, setResidencyConfig as la } from "./residency.js";
+import { auditAllTableIndexes as ua, auditTableIndexes as da, formatIndexAuditIssue as fa } from "./indexAudit.js";
+import { defineSeed as pa, fireSchemaChangeSeeds as ma, fireTenantCreateSeeds as ha, isSeedDefinition as ga, setSchemaChangeSeedHook as _a, setTenantCreateSeedHook as va } from "./seed.js";
+import { defineMigration as ya, isMigrationDefinition as ba } from "./migration.js";
+import { FILE_MIGRATION_PATTERN as xa, IrreversibleMigrationError as Sa, MIGRATION_PHASES as Ca, MigrationExpectationFailed as wa, MigrationNeedsSqlClient as Ta, MigrationSkipped as Ea, RewriteUnstableError as Da, TransactionBrokenByBodyError as Oa, irreversible as ka, irreversibleReason as Aa, isFileMigration as ja, migration as Ma } from "./migrations/fileBased.js";
+import { DEFAULT_SOFT_DROP_RETENTION_DAYS as Na, FRAMEWORK_LIVE_TABLES as Pa, STAGING_TABLE_PREFIX as Fa, agedSoftDropSnapshots as Ia, describeAgedSoftDropSnapshots as La, isFrameworkOwnedLiveTable as Ra, isSoftDropSnapshotName as za, isStagingTableName as Ba, softDropSnapshotStamp as Va } from "./migrations/frameworkLiveTables.js";
+import { sqlError as Ha } from "./sqlError.js";
+import { _voltroApiKeysTable as Ua, _voltroApiRoleWorkloadBucketsTable as Wa, _voltroDevicesTable as Ga, _voltroIdempotencyTable as Ka, _voltroKvTable as qa, _voltroMigrationPlansTable as Ja, _voltroMigrationsTable as Ya, _voltroPluginMigrationsTable as Xa, _voltroReplicaObservationsTable as Za, _voltroSchemaOwnerTable as Qa, _voltroSeedsTable as $a, _voltroTenantSelectionsTable as eo, frameworkTables as to } from "./frameworkTables.js";
+import { TENANT_SELECTIONS_TABLE as no, deleteTenantSelection as ro, readTenantSelection as io, tenantSelectionId as ao, writeTenantSelection as oo } from "./tenantSelection.js";
+import { REPLACE_IN_PROGRESS_TABLE as so, STAGING_STALE_MINUTES as co, _voltroReplaceInProgressTable as lo, interruptedReplaceRefusal as uo, stagingLeftoverReport as fo, stagingLeftovers as po, stagingNamesOf as mo, stagingStaleAfterMs as ho } from "./replaceInProgress.js";
+import { stampGeneratedId as go, stampGeneratedIds as _o } from "./stampId.js";
+import { BULK_INSERT_LIMITS as vo, bulkInsertLimitsFor as yo, chunkRowsForInsert as bo, columnsPerRow as xo } from "./bulkInsertLimits.js";
+import { missingConflictColumns as So, missingRequiredColumns as Co } from "./requiredColumns.js";
+import { insertIgnoreRowOutcome as wo, insertManyRows as To, insertRow as Eo, updateManyRow as Do, upsertRow as Oo, upsertRowOutcome as ko } from "./typedStore.js";
+import { CHANGE_LISTENER_CEILING as Ao, raiseChangeListenerCeiling as jo } from "./changeListenerCeiling.js";
+import { isPrimaryKeyConflictError as Mo, primaryKeyConflictError as No } from "./storeErrors.js";
+import { connectionIdentity as Po, normaliseTarget as Fo, sameDatabase as Io } from "./connectionIdentity.js";
+import { clearRetentions as Lo, listRetentionConflicts as Ro, listRetentions as zo, registerRetention as Bo, retentionTtlMsFromEnv as Vo, sweepRetention as Ho } from "./retention.js";
+import { CDC_OFFSETS_TABLE as Uo, _voltroCdcOffsetsTable as Wo, _voltroMssqlCdcOffsetsTable as Go } from "./cdcOffsetsTables.js";
+import { DATA_TRANSFERS_TABLE as Ko, _voltroDataTransfersTable as qo, describeTransferRun as Jo } from "./dataTransfers.js";
+import { SCOPE_KEY_MAX_LENGTH as Yo, scopeKeyOf as Xo } from "./scopeKey.js";
+import { SqlClient as Zo } from "effect/sql";
 //#region src/index.ts
-var Vo = "postgres";
+var Qo = "postgres";
 //#endregion
-export { lt as AUTO_FILLED_COLUMNS, Me as BOUND_ENCRYPTED_PREFIX, oo as BULK_INSERT_LIMITS, Ei as BranchNameInvalid, Di as BranchTransitionInvalid, Mo as CDC_OFFSETS_TABLE, hr as CHANGE_CLAIM_TTL_ENV, yo as CHANGE_LISTENER_CEILING, e as ColumnBuilder, Fo as DATA_TRANSFERS_TABLE, pt as DEFAULT_ACQUIRE_TIMEOUT_MS, gr as DEFAULT_CHANGE_CLAIM_TTL_HOURS, Gr as DEFAULT_EAGER_FALLBACK_WARN_INTERVAL_MS, Ca as DEFAULT_SOFT_DROP_RETENTION_DAYS, wn as DEFAULT_SUBJECT_GRAPH_DEPTH, Ne as ENCRYPTED_PREFIX, Vo as ENGINE, zn as EagerCardinalityError, da as FILE_MIGRATION_PATTERN, wa as FRAMEWORK_LIVE_TABLES, Pe as FieldDecryptionError, Pr as ID_COLUMN_MAX_LENGTH, $t as INITIAL_VERSION, fa as IrreversibleMigrationError, X as MATCHES_NO_ROWS, Je as MAX_IDENTIFIER_LENGTH, pa as MIGRATION_PHASES, li as MSSQL_TRANSIENT_NUMBERS, ui as MYSQL_TRANSIENT_CODES, ma as MigrationExpectationFailed, ha as MigrationNeedsSqlClient, ga as MigrationSkipped, _r as OccurrenceCounter, di as POSTGRES_TRANSIENT_STATES, Xa as REPLACE_IN_PROGRESS_TABLE, _a as RewriteUnstableError, Ro as SCOPE_KEY_MAX_LENGTH, t as SELF_REFERENCE_TARGET, $r as SHARED_TRANSACTION_SERVICE, fi as SQLITE_TRANSIENT_CODES, Za as STAGING_STALE_MINUTES, Ta as STAGING_TABLE_PREFIX, Bo as SqlClient, Ga as TENANT_SELECTIONS_TABLE, pi as TURSO_TRANSIENT_MESSAGE, xi as TableStreamError, Wn as TenantNamespaceInvalid, Gn as TenantNamespaceUnresolved, Wi as TenantRegionUnavailable, Gi as TenantResidencyUnresolved, ei as TransactionAbortedError, va as TransactionBrokenByBodyError, hi as VOLTRO_EXPIRES_MIXIN_ID, _i as VOLTRO_LOCAL_FIRST_MIXIN_ID, en as VersionConflict, Ye as WARN_IDENTIFIER_LENGTH, Na as _voltroApiKeysTable, No as _voltroCdcOffsetsTable, Io as _voltroDataTransfersTable, Pa as _voltroDevicesTable, Fa as _voltroIdempotencyTable, Ia as _voltroKvTable, La as _voltroMigrationPlansTable, Ra as _voltroMigrationsTable, Po as _voltroMssqlCdcOffsetsTable, za as _voltroPluginMigrationsTable, Qa as _voltroReplaceInProgressTable, Ba as _voltroReplicaObservationsTable, Va as _voltroSchemaOwnerTable, Ha as _voltroSeedsTable, Ua as _voltroTenantSelectionsTable, sr as actorsTable, Bi as admitBranch, Ea as agedSoftDropSnapshots, Ee as allEnumRenames, _n as allRegisteredRelations, _t as allRegisteredTables, Z as and, In as applyJsonPatch, n as array, Q as arrayContains, $ as arrayHas, ee as arrayOverlaps, Bn as attachEagerLoads, Sr as attributionFields, Er as attributionKey, ea as auditAllTableIndexes, ta as auditTableIndexes, R as authoredError, z as authoredMessageOf, Tt as avg, Et as avgOver, Dr as beginLocalWrite, r as bigint, Ki as bindResidentStore, i as boolean, Oi as branchNamespaceName, so as bulkInsertLimitsFor, a as bytes, B as causeBranches, cr as changeDelete, vr as changeDigest, lr as changeInsert, ur as changeSoftDelete, dr as changeUpdate, co as chunkRowsForInsert, Or as claimPendingAttribution, V as classifyConstraintViolation, De as clearEnumRenames, kr as clearPendingAttribution, vn as clearRelationsRegistry, qi as clearResidencyConfig, Eo as clearRetentions, vt as clearTableRegistry, Lr as clearWriteRecorders, nr as coercePredicateForSqlite, Yn as coercePredicateValue, Xn as coercePredicateValues, Un as coerceValueForSqlite, te as collectSubqueries, Dt as column, I as columnRef, sn as columnSchema, lo as columnsPerRow, pr as committedChangeBatchOf, Y as compareDecimal, rr as compileEagerJson, Ln as compileJsonPatch, Zn as compilePredicate, Qn as compileRawFragment, $n as compileRowProjection, er as compileSelect, yr as composeChangeKey, wi as computeEmbedding, Co as connectionIdentity, ne as contains, Ot as count, kt as countDistinct, o as crdtCounter, s as crdtDoc, c as crdtManagedColumns, l as crdtManagedColumnsOf, u as crdtSealed, d as crdtText, Cr as currentWriteAttribution, At as databaseHandle, f as date, p as dbEnum, Kr as dbMetricTagCacheSizeForTests, qr as dbOperationsInFlight, m as decimal, Oe as declareEnumRename, Fe as decodeFieldValue, Dn as decodeRowsForTable, On as decodeRowsFromSchema, Ie as decryptFieldsOnRead, la as defineMigration, ot as defineMixin, ra as defineSeed, Ka as deleteTenantSelection, jt as denseRank, Tn as deriveSubjectGraph, rt as deriveTypeIdPrefix, Fr as derivedRowId, Ir as derivedRowIdLength, Da as describeAgedSoftDropSnapshots, H as describeCharsetRefusal, U as describeDriverError, W as describeRowBindings, Lo as describeTransferRun, Ae as deserializeArraysOnRead, Xe as drainIdentifierWarnings, h as dropped, mr as emitCommittedChanges, Le as encodeFieldValue, kn as encodeRowForSchema, Re as encryptFieldsForWrite, ze as encryptFieldsForWriteBatch, Be as encryptedColumnsOf, Ar as endLocalWrite, ki as enforceBranchLimits, yt as ensureTableRegistered, re as eq, tr as escapeLike, ie as evaluatePredicate, Mt as except, ae as exists, gi as expires, fr as externalChangeEvent, G as extractDbCause, Ve as fieldBinding, ia as fireSchemaChangeSeeds, aa as fireTenantCreateSeeds, na as formatIndexAuditIssue, En as formatSubjectGraph, Wa as frameworkTables, it as generateId, tt as generateSnowflake, g as geography, _ as geometry, ke as getEnumRenames, yn as getRelation, bn as getRelations, Ji as getResidencyConfig, bt as getTable, oe as gt, se as gte, Vn as hasEagerLoads, Ci as hybridSearch, v as id, ce as inSet, le as inSubquery, ln as inferForeignKey, po as insertIgnoreRowOutcome, mo as insertManyRows, ho as insertRow, y as integer, $a as interruptedReplaceRefusal, Nt as intersect, b as interval, ya as irreversible, ba as irreversibleReason, He as isBoundCiphertext, Ai as isBranchNamespace, L as isColumnReference, Mn as isCompositeRowKey, un as isEmptyRelationsSpec, Ue as isEncrypted, We as isFieldDecryptionError, xa as isFileMigration, K as isForeignKeyViolation, Oa as isFrameworkOwnedLiveTable, vi as isLocalFirst, ua as isMigrationDefinition, mt as isMysqlFamily, ji as isNeonConnection, ue as isNotNull, de as isNull, xo as isPrimaryKeyConflictError, q as isQueryTimeout, Ge as isRawEncoding, Yi as isRegionServable, dn as isRelationsSpec, oa as isSeedDefinition, ka as isSoftDropSnapshotName, ht as isSqliteFamily, Aa as isStagingTableName, xt as isTableReactive, ti as isTransactionAbortedError, mi as isTransientContention, Yt as isView, x as json, fe as jsonField, ut as jsonIndex, Fn as jsonPatchAssignments, Pt as lag, Ft as lead, Do as listRetentionConflicts, Oo as listRetentions, yi as localFirst, bi as localFirstTables, pe as lt, me as lte, Jr as makeEagerFallbackReporter, Vi as makeNamespaceBranchExecutor, ni as makeTransactionAbortTracker, fn as many, pn as manyToMany, S as materializeFields, It as max, Sa as migration, Lt as min, uo as missingConflictColumns, fo as missingRequiredColumns, st as mixin, he as neq, Mi as nextBranchState, wo as normaliseTarget, Rn as normalizeJsonPatchValue, ge as not, _e as notExists, ve as notInSet, ye as notInSubquery, C as numeric, Yr as observeDbOp, br as occurrenceWindowMs, ri as onTransaction, mn as one, Hn as oneCardinalityMessage, be as or, Rt as orderClausesOf, zt as paginateBy, Bt as paginateById, xr as parseChangeKey, jr as pendingAttributionCount, w as persistedColumns, Ni as planBranch, Pi as planBranchProvision, Fi as planBranchTeardown, Ii as planBranchTeardownFor, Li as planNeonBranchProvision, Ri as planNeonBranchTeardown, tn as planVersionedUpdate, P as pluginRef, F as pluginRefSpecOf, xe as preparePredicate, So as primaryKeyConflictError, Hi as provisionBranch, Xi as provisionResidentTenant, Kn as qualifyTable, Vt as queryFor, Xt as queryForView, gt as quoteIdent, bo as raiseChangeListenerCeiling, Ht as rank, T as raw, qa as readTenantSelection, E as readableByColumns, D as real, Xr as recordDbOp, Rr as recordsTable, O as reference, Ke as refuseWrite, ir as registerCoreTables, xn as registerDiscoveredRelations, Mr as registerPendingAttribution, Sn as registerRelations, ko as registerRetention, St as registerTable, zr as registerWriteRecorder, hn as relations, ar as requireActors, Ct as requireTable, or as requireTenants, Zr as resetDbMetricTagCacheForTests, nt as resetSnowflake, Zi as residentPlacement, Te as resolveActorSnapshot, zi as resolveBranchMechanism, Qr as resolveEagerFallbackWarnIntervalMs, Nr as resolveEchoAttribution, Ut as resolveFullTextIndex, at as resolveIdScheme, ct as resolveMixinGraph, Qi as resolveTenantHome, qn as resolveTenantNamespace, Ao as retentionTtlMsFromEnv, Nn as rowKeyColumns, Pn as rowKeyIdentity, Wt as rowNumber, cn as rowSchema, ii as runRetryingTransaction, ai as runSavepoint, oi as runStoreTransaction, wr as runWithWriteAttribution, Br as runWriteRecorders, To as sameDatabase, Jn as sanitizeIdentifierFragment, zo as scopeKeyOf, k as selfReference, je as serializeArraysForWrite, A as serverOnlyColumns, $i as setResidencyConfig, sa as setSchemaChangeSeedHook, ca as setTenantCreateSeedHook, si as settleTransactionExit, nn as settleVersionedUpdate, ja as softDropSnapshotStamp, Se as spatialPredicate, Ma as sqlError, eo as stagingLeftoverReport, to as stagingLeftovers, no as stagingNamesOf, ro as stagingStaleAfterMs, io as stampGeneratedId, ao as stampGeneratedIds, Ce as startsWith, qe as storeRefusalOf, Si as streamTable, Gt as sum, Kt as sumOver, Vr as suspendWriteRecorders, Hr as suspendWriteRecordersEffect, jo as sweepRetention, dt as table, Ui as teardownBranch, Ja as tenantSelectionId, j as text, M as timestamp, an as timestampMs, on as timestampMsOrNull, ci as transactionRetrySchedule, qt as union, Jt as unionAll, wt as unregisterTable, Ur as unregisterWriteRecorder, go as updateManyRow, _o as upsertRow, vo as upsertRowOutcome, An as upsertUpdatePatch, jn as upsertUpdateValues, Ze as validateColumnName, Qe as validateIndexName, Cn as validateRegisteredRelations, gn as validateRelationConfig, $e as validateTableName, et as validateTypeIdPrefix, N as vector, ft as vectorDistanceToOpclass, Ti as vectorEmbedding, rn as versionColumnOf, Zt as view, Qt as viewSql, we as walkLeaves, J as wireSafeCause, Tr as withCapturedAttribution, Wr as writeRecordersSuspended, Ya as writeTenantSelection };
+export { _t as AUTO_FILLED_COLUMNS, Ne as BOUND_ENCRYPTED_PREFIX, vo as BULK_INSERT_LIMITS, Ii as BranchNameInvalid, Li as BranchTransitionInvalid, Uo as CDC_OFFSETS_TABLE, wr as CHANGE_CLAIM_TTL_ENV, Ao as CHANGE_LISTENER_CEILING, e as ColumnBuilder, Ko as DATA_TRANSFERS_TABLE, xt as DEFAULT_ACQUIRE_TIMEOUT_MS, Tr as DEFAULT_CHANGE_CLAIM_TTL_HOURS, ti as DEFAULT_EAGER_FALLBACK_WARN_INTERVAL_MS, Na as DEFAULT_SOFT_DROP_RETENTION_DAYS, Mn as DEFAULT_SUBJECT_GRAPH_DEPTH, Pe as ENCRYPTED_PREFIX, Qo as ENGINE, Jn as EagerCardinalityError, Fe as FIELD_KEY_ID_PATTERN, xa as FILE_MIGRATION_PATTERN, Pa as FRAMEWORK_LIVE_TABLES, Ie as FieldDecryptionError, Ur as ID_COLUMN_MAX_LENGTH, cn as INITIAL_VERSION, Sa as IrreversibleMigrationError, Z as MATCHES_NO_ROWS, $e as MAX_IDENTIFIER_LENGTH, Ca as MIGRATION_PHASES, yi as MSSQL_TRANSIENT_NUMBERS, bi as MYSQL_TRANSIENT_CODES, wa as MigrationExpectationFailed, Ta as MigrationNeedsSqlClient, Ea as MigrationSkipped, Er as OccurrenceCounter, xi as POSTGRES_TRANSIENT_STATES, so as REPLACE_IN_PROGRESS_TABLE, Da as RewriteUnstableError, Yo as SCOPE_KEY_MAX_LENGTH, t as SELF_REFERENCE_TARGET, li as SHARED_TRANSACTION_SERVICE, Si as SQLITE_TRANSIENT_CODES, co as STAGING_STALE_MINUTES, Fa as STAGING_TABLE_PREFIX, Zo as SqlClient, no as TENANT_SELECTIONS_TABLE, Ci as TURSO_TRANSIENT_MESSAGE, ji as TableStreamError, $n as TenantNamespaceInvalid, er as TenantNamespaceUnresolved, ea as TenantRegionUnavailable, ta as TenantResidencyUnresolved, ui as TransactionAbortedError, Oa as TransactionBrokenByBodyError, Ti as VOLTRO_EXPIRES_MIXIN_ID, Di as VOLTRO_LOCAL_FIRST_MIXIN_ID, ln as VersionConflict, et as WARN_IDENTIFIER_LENGTH, Ua as _voltroApiKeysTable, Wa as _voltroApiRoleWorkloadBucketsTable, Wo as _voltroCdcOffsetsTable, qo as _voltroDataTransfersTable, Ga as _voltroDevicesTable, Ka as _voltroIdempotencyTable, qa as _voltroKvTable, Ja as _voltroMigrationPlansTable, Ya as _voltroMigrationsTable, Go as _voltroMssqlCdcOffsetsTable, Xa as _voltroPluginMigrationsTable, lo as _voltroReplaceInProgressTable, Za as _voltroReplicaObservationsTable, Qa as _voltroSchemaOwnerTable, $a as _voltroSeedsTable, eo as _voltroTenantSelectionsTable, gr as actorsTable, Xi as admitBranch, Ia as agedSoftDropSnapshots, De as allEnumRenames, Tn as allRegisteredRelations, Tt as allRegisteredTables, Q as and, Gn as applyJsonPatch, n as array, $ as arrayContains, ee as arrayHas, te as arrayOverlaps, Yn as attachEagerLoads, jr as attributionFields, Fr as attributionKey, ua as auditAllTableIndexes, da as auditTableIndexes, R as authoredError, z as authoredMessageOf, Nt as avg, Pt as avgOver, Ir as beginLocalWrite, r as bigint, na as bindResidentStore, i as boolean, Ri as branchNamespaceName, yo as bulkInsertLimitsFor, a as bytes, B as causeBranches, _r as changeDelete, Dr as changeDigest, vr as changeInsert, yr as changeSoftDelete, br as changeUpdate, bo as chunkRowsForInsert, Le as ciphertextKeyId, Lr as claimPendingAttribution, V as classifyConstraintViolation, Oe as clearEnumRenames, Rr as clearPendingAttribution, En as clearRelationsRegistry, ra as clearResidencyConfig, Lo as clearRetentions, Et as clearTableRegistry, Kr as clearWriteRecorders, dr as coercePredicateForSqlite, ir as coercePredicateValue, ar as coercePredicateValues, Qn as coerceValueForSqlite, ne as collectSubqueries, Ft as column, I as columnRef, hn as columnSchema, xo as columnsPerRow, Sr as committedChangeBatchOf, Y as compareDecimal, fr as compileEagerJson, Kn as compileJsonPatch, or as compilePredicate, sr as compileRawFragment, cr as compileRowProjection, lr as compileSelect, Or as composeChangeKey, Pi as computeEmbedding, Po as connectionIdentity, re as contains, It as count, Lt as countDistinct, o as crdtCounter, s as crdtDoc, c as crdtManagedColumns, l as crdtManagedColumnsOf, u as crdtSealed, d as crdtText, Mr as currentWriteAttribution, Rt as databaseHandle, f as date, p as dbEnum, ni as dbMetricTagCacheSizeForTests, ri as dbOperationsInFlight, m as decimal, X as decimalEqualityKey, ke as declareEnumRename, Re as decodeFieldValue, Fn as decodeRowsForTable, In as decodeRowsFromSchema, Ln as decodeSelectRows, ze as decryptFieldsOnRead, ya as defineMigration, mt as defineMixin, pa as defineSeed, ro as deleteTenantSelection, zt as denseRank, Nn as deriveSubjectGraph, dt as deriveTypeIdPrefix, Wr as derivedRowId, Gr as derivedRowIdLength, La as describeAgedSoftDropSnapshots, H as describeCharsetRefusal, U as describeDriverError, W as describeRowBindings, Jo as describeTransferRun, je as deserializeArraysOnRead, tt as drainIdentifierWarnings, h as dropped, Cr as emitCommittedChanges, Be as encodeFieldValue, Rn as encodeRowForSchema, ot as encodeTypeIdSuffix, Ve as encryptFieldsForWrite, He as encryptFieldsForWriteBatch, Ue as encryptedColumnsOf, zr as endLocalWrite, zi as enforceBranchLimits, Dt as ensureTableRegistered, ie as eq, ur as escapeLike, ae as evaluatePredicate, Bt as except, oe as exists, Ei as expires, xr as externalChangeEvent, G as extractDbCause, We as fieldBinding, Ge as fieldBindingsOf, ma as fireSchemaChangeSeeds, ha as fireTenantCreateSeeds, fa as formatIndexAuditIssue, Pn as formatSubjectGraph, to as frameworkTables, ft as generateId, lt as generateSnowflake, g as geography, _ as geometry, Ae as getEnumRenames, Dn as getRelation, On as getRelations, ia as getResidencyConfig, Ot as getTable, se as gt, ce as gte, Xn as hasEagerLoads, Ni as hybridSearch, v as id, le as inSet, ue as inSubquery, _n as inferForeignKey, wo as insertIgnoreRowOutcome, To as insertManyRows, Eo as insertRow, y as integer, uo as interruptedReplaceRefusal, Vt as intersect, b as interval, ka as irreversible, Aa as irreversibleReason, Ke as isBoundCiphertext, Bi as isBranchNamespace, L as isColumnReference, Vn as isCompositeRowKey, vn as isEmptyRelationsSpec, qe as isEncrypted, Je as isFieldDecryptionError, ja as isFileMigration, K as isForeignKeyViolation, Ra as isFrameworkOwnedLiveTable, Oi as isLocalFirst, ba as isMigrationDefinition, St as isMysqlFamily, Vi as isNeonConnection, de as isNotNull, fe as isNull, Mo as isPrimaryKeyConflictError, q as isQueryTimeout, Ye as isRawEncoding, aa as isRegionServable, yn as isRelationsSpec, ga as isSeedDefinition, za as isSoftDropSnapshotName, Ct as isSqliteFamily, Ba as isStagingTableName, kt as isTableReactive, di as isTransactionAbortedError, wi as isTransientContention, rn as isView, x as json, pe as jsonField, vt as jsonIndex, Wn as jsonPatchAssignments, Ht as lag, Ut as lead, Ro as listRetentionConflicts, zo as listRetentions, ki as localFirst, Ai as localFirstTables, me as lt, he as lte, ii as makeEagerFallbackReporter, Zi as makeNamespaceBranchExecutor, fi as makeTransactionAbortTracker, bn as many, xn as manyToMany, S as materializeFields, Wt as max, Ma as migration, Gt as min, So as missingConflictColumns, Co as missingRequiredColumns, ht as mixin, ge as neq, Hi as nextBranchState, Fo as normaliseTarget, qn as normalizeJsonPatchValue, _e as not, ve as notExists, ye as notInSet, be as notInSubquery, C as numeric, ai as observeDbOp, kr as occurrenceWindowMs, pi as onTransaction, Sn as one, Zn as oneCardinalityMessage, xe as or, Kt as orderClausesOf, qt as paginateBy, Jt as paginateById, Ar as parseChangeKey, Br as pendingAttributionCount, w as persistedColumns, Ui as planBranch, Wi as planBranchProvision, Gi as planBranchTeardown, Ki as planBranchTeardownFor, qi as planNeonBranchProvision, Ji as planNeonBranchTeardown, un as planVersionedUpdate, P as pluginRef, F as pluginRefSpecOf, Se as preparePredicate, No as primaryKeyConflictError, Qi as provisionBranch, oa as provisionResidentTenant, tr as qualifyTable, Yt as queryFor, an as queryForView, wt as quoteIdent, jo as raiseChangeListenerCeiling, Xt as rank, T as raw, io as readTenantSelection, E as readableByColumns, D as real, oi as recordDbOp, qr as recordsTable, O as reference, Xe as refuseIdChangeOfSealedRow, Ze as refuseWrite, pr as registerCoreTables, kn as registerDiscoveredRelations, Vr as registerPendingAttribution, An as registerRelations, Bo as registerRetention, At as registerTable, Jr as registerWriteRecorder, Cn as relations, mr as requireActors, jt as requireTable, hr as requireTenants, si as resetDbMetricTagCacheForTests, ut as resetSnowflake, sa as residentPlacement, Ee as resolveActorSnapshot, Yi as resolveBranchMechanism, ci as resolveEagerFallbackWarnIntervalMs, Hr as resolveEchoAttribution, Zt as resolveFullTextIndex, pt as resolveIdScheme, gt as resolveMixinGraph, ca as resolveTenantHome, nr as resolveTenantNamespace, Vo as retentionTtlMsFromEnv, Hn as rowKeyColumns, Un as rowKeyIdentity, Qt as rowNumber, gn as rowSchema, mi as runRetryingTransaction, hi as runSavepoint, gi as runStoreTransaction, Nr as runWithWriteAttribution, Yr as runWriteRecorders, Io as sameDatabase, rr as sanitizeIdentifierFragment, Xo as scopeKeyOf, k as selfReference, Me as serializeArraysForWrite, A as serverOnlyColumns, la as setResidencyConfig, _a as setSchemaChangeSeedHook, va as setTenantCreateSeedHook, _i as settleTransactionExit, dn as settleVersionedUpdate, Va as softDropSnapshotStamp, Ce as spatialPredicate, Ha as sqlError, fo as stagingLeftoverReport, po as stagingLeftovers, mo as stagingNamesOf, ho as stagingStaleAfterMs, go as stampGeneratedId, _o as stampGeneratedIds, we as startsWith, Qe as storeRefusalOf, Mi as streamTable, $t as sum, en as sumOver, Xr as suspendWriteRecorders, Zr as suspendWriteRecordersEffect, Ho as sweepRetention, yt as table, $i as teardownBranch, ao as tenantSelectionId, j as text, M as timestamp, pn as timestampMs, mn as timestampMsOrNull, vi as transactionRetrySchedule, st as typeId, tn as union, nn as unionAll, Mt as unregisterTable, Qr as unregisterWriteRecorder, Do as updateManyRow, Oo as upsertRow, ko as upsertRowOutcome, zn as upsertUpdatePatch, Bn as upsertUpdateValues, ct as uuidV7Bytes, nt as validateColumnName, rt as validateIndexName, jn as validateRegisteredRelations, wn as validateRelationConfig, it as validateTableName, at as validateTypeIdPrefix, N as vector, bt as vectorDistanceToOpclass, Fi as vectorEmbedding, fn as versionColumnOf, on as view, sn as viewSql, Te as walkLeaves, J as wireSafeCause, Pr as withCapturedAttribution, $r as writeImagesObserved, ei as writeRecordersSuspended, oo as writeTenantSelection };