@voltro/database 0.86.0 → 0.88.0

package/dist/index.js

@@ -2,81 +2,81 @@ 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";
-//#region src/index.ts
-var Vo = "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 };
+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";
+// src/index.ts
+var Qo = "postgres";
+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 };

package/dist/indexAudit.js

@@ -1,5 +1,5 @@
 import { ansi as e } from "@voltro/logger";
-//#region src/indexAudit.ts
+// src/indexAudit.ts
 var t = (e) => {
 	if (typeof e == "string") return e;
 	if ("jsonPath" in e) {
@@ -7,55 +7,56 @@ var t = (e) => {
 		return `(json:${t}->${n.join(".")}${r ? "::num" : ""})`;
 	}
 	return `(${e.expr})`;
-}, n = (e) => e.map(t), r = (e, n) => {
-	if (e.length !== n.length) return !1;
-	for (let r = 0; r < e.length; r++) if (t(e[r]) !== t(n[r])) return !1;
-	return !0;
-}, i = (e, n) => {
-	if (e.length >= n.length) return !1;
-	for (let r = 0; r < e.length; r++) if (t(e[r]) !== t(n[r])) return !1;
-	return !0;
-}, a = (e) => {
-	let t = [], a = e.appliedIndexes, o = e.tableName;
-	for (let e = 0; e < a.length; e++) {
-		let s = a[e];
-		for (let c = e + 1; c < a.length; c++) {
-			let e = a[c];
-			if (r(s.fields, e.fields)) {
-				let [r, i] = s.name < e.name ? [s, e] : [e, s];
-				t.push({
-					kind: "duplicate-fields",
-					table: o,
-					redundant: r,
-					coveredBy: i,
-					message: `'${o}' has two indexes on the same fields [${n(s.fields).join(", ")}]: '${s.name}' and '${e.name}'. The B-tree engine builds both, costing write throughput + disk space for no read benefit. Drop '${r.name}' (or '${i.name}' if you prefer the other name). Applies to every supported dialect (Postgres / MySQL / MariaDB / MSSQL / SQLite).`
-				});
-			} else i(s.fields, e.fields) ? t.push({
-				kind: "redundant-prefix",
-				table: o,
-				redundant: s,
-				coveredBy: e,
-				message: `'${o}' index '${s.name}' on [${n(s.fields).join(", ")}] is a leading prefix of '${e.name}' on [${n(e.fields).join(", ")}]. Every B-tree dialect we support (Postgres / MySQL / MariaDB / MSSQL / SQLite) can serve a [${n(s.fields).join(", ")}] query from '${e.name}' too via the leading-prefix rule, so '${s.name}' adds write cost without read benefit. Drop '${s.name}' — unless you specifically need a smaller index for cache locality on a write-heavy table (rare; profile first).`
-			}) : i(e.fields, s.fields) && t.push({
-				kind: "redundant-prefix",
-				table: o,
-				redundant: e,
-				coveredBy: s,
-				message: `'${o}' index '${e.name}' on [${n(e.fields).join(", ")}] is a leading prefix of '${s.name}' on [${n(s.fields).join(", ")}]. Every B-tree dialect we support (Postgres / MySQL / MariaDB / MSSQL / SQLite) can serve a [${n(e.fields).join(", ")}] query from '${s.name}' too via the leading-prefix rule, so '${e.name}' adds write cost without read benefit. Drop '${e.name}' — unless you specifically need a smaller index for cache locality on a write-heavy table (rare; profile first).`
+}, n = (e) => e.map(t), r = {
+	btree: !0,
+	gist: !1,
+	gin: !1,
+	brin: !1,
+	hnsw: !1
+}, i = (e) => typeof e == "string" ? JSON.stringify(["column", e]) : "jsonPath" in e ? JSON.stringify([
+	"json",
+	e.jsonPath.column,
+	e.jsonPath.path,
+	e.jsonPath.numeric ?? !1
+]) : JSON.stringify(["expression", e.expr]), a = (e, t) => {
+	if (!r[e.kind ?? "btree"] || !r[t.kind ?? "btree"] || e.fields.length === 0 || e.fields.length > t.fields.length || !e.fields.every((e, n) => i(e) === i(t.fields[n]))) return;
+	let n = e.where?.trim() || void 0, a = t.where?.trim() || void 0;
+	if ((a === void 0 || a === n) && (!e.unique || t.unique && e.fields.length === t.fields.length)) return e.fields.length === t.fields.length ? "duplicate-fields" : "redundant-prefix";
+}, o = (e) => {
+	let t = [], r = e.appliedIndexes, i = e.tableName;
+	for (let e = 0; e < r.length; e++) {
+		let o = r[e];
+		for (let s = e + 1; s < r.length; s++) {
+			let e = r[s], c = a(o, e), l = a(e, o);
+			if (!c && !l) continue;
+			let [u, d, f] = c && (!l || o.name < e.name) ? [
+				o,
+				e,
+				c
+			] : [
+				e,
+				o,
+				l
+			], p = f === "duplicate-fields" ? `has two indexes on the same fields [${n(u.fields).join(", ")}]: '${o.name}' and '${e.name}'.` : `index '${u.name}' on [${n(u.fields).join(", ")}] is a leading prefix of '${d.name}' on [${n(d.fields).join(", ")}].`;
+			t.push({
+				kind: f,
+				table: i,
+				redundant: u,
+				coveredBy: d,
+				message: `'${i}' ${p} '${d.name}' covers its B-tree lookups without losing row coverage or uniqueness. Drop '${u.name}' unless profiling justifies the smaller index for cache locality. Applies to supported B-tree dialects (Postgres / MySQL / MariaDB / MSSQL / SQLite).`
 			});
 		}
 	}
 	return t;
-}, o = (e) => {
+}, s = (e) => {
 	let t = [];
-	for (let n of e) t.push(...a(n));
+	for (let n of e) t.push(...o(n));
 	return t;
-}, s = "\x1B[", c = `${s}38;2;245;158;11m`, l = `${s}38;2;16;185;129m`, u = (t, n) => `${t}${n}${e.reset}`, d = (e, t, n) => e ? typeof t == "function" ? t(n) : u(t, n) : n, f = (t, r = {}) => {
-	let i = r.color ?? !0, a = r.indent ?? "  ", o = (t) => d(i, e.dim, t.padEnd(11)), s = (t) => d(i, (t) => e.bold(e.brand(t)), t), u = (t) => d(i, e.brightRed24, t), f = (e) => d(i, l, e), p = (e) => d(i, c, e), m = (t) => d(i, e.dim, t), h = `${p("index audit")} ${m("·")} ${d(i, e.bold, t.kind)}`, g = t.redundant.fields.length, _ = n(t.coveredBy.fields.slice(g)), v = (e, t) => {
+}, c = "\x1B[", l = `${c}38;2;245;158;11m`, u = `${c}38;2;16;185;129m`, d = (t, n) => `${t}${n}${e.reset}`, f = (e, t, n) => e ? typeof t == "function" ? t(n) : d(t, n) : n, p = (t, r = {}) => {
+	let i = r.color ?? !0, a = r.indent ?? "  ", o = (t) => f(i, e.dim, t.padEnd(11)), s = (t) => f(i, (t) => e.bold(e.brand(t)), t), c = (t) => f(i, e.brightRed24, t), d = (e) => f(i, u, e), p = (e) => f(i, l, e), m = (t) => f(i, e.dim, t), h = `${p("index audit")} ${m("·")} ${f(i, e.bold, t.kind)}`, g = t.redundant.fields.length, _ = n(t.coveredBy.fields.slice(g)), v = (e, t) => {
 		let n = e.slice(0, t), r = e.slice(t), i = [];
-		return n.length > 0 && i.push(f(`[${n.join(", ")}]`)), r.length > 0 && i.push(p(`+ [${r.join(", ")}]`)), i.join(" ");
+		return n.length > 0 && i.push(d(`[${n.join(", ")}]`)), r.length > 0 && i.push(p(`+ [${r.join(", ")}]`)), i.join(" ");
 	}, y = [];
-	return y.push(h), y.push(""), y.push(`${o("table")}${s(t.table)}`), y.push(""), y.push(`${o("redundant")}${u(t.redundant.name)}`), y.push(`${o("")}${v(n(t.redundant.fields), g)}`), y.push(""), y.push(`${o("covered by")}${f(t.coveredBy.name)}`), y.push(`${o("")}${v(n(t.coveredBy.fields), g)}`), _.length > 0 && y.push(`${o("")}${m(`└ extra columns: ${_.join(", ")}`)}`), y.push(""), t.kind === "redundant-prefix" ? (y.push(`${o("why")}B-tree indexes serve queries that filter on a LEADING PREFIX of`), y.push(`${o("")}their column list. The wider index already covers every`), y.push(`${o("")}query the narrower one can serve.`), y.push(`${o("")}${m("Same rule on Postgres / MySQL / MariaDB / MSSQL / SQLite.")}`)) : (y.push(`${o("why")}Two indexes on the same columns under different names.`), y.push(`${o("")}The B-tree engine builds both — same coverage, double cost.`), y.push(`${o("")}${m("Same rule on Postgres / MySQL / MariaDB / MSSQL / SQLite.")}`)), y.push(""), y.push(`${o("cost")}Every ${s("INSERT")} / ${s("UPDATE")} / ${s("DELETE")} on this table writes`), y.push(`${o("")}to ${d(i, e.bold, "both")} B-trees. Pure write overhead, zero read benefit.`), y.push(""), y.push(`${o("fix")}Drop  ${u(t.redundant.name)}`), y.push(`${o("")}${m("Keep only if profiling shows the smaller index gives a")}`), y.push(`${o("")}${m("measurable cache-locality boost on a write-heavy hot path.")}`), y.push(`${o("")}${m("Silence with VOLTRO_INDEX_AUDIT=off if intentional.")}`), y.map((e) => `${a}${e}`).join("\n");
+	return y.push(h), y.push(""), y.push(`${o("table")}${s(t.table)}`), y.push(""), y.push(`${o("redundant")}${c(t.redundant.name)}`), y.push(`${o("")}${v(n(t.redundant.fields), g)}`), y.push(""), y.push(`${o("covered by")}${d(t.coveredBy.name)}`), y.push(`${o("")}${v(n(t.coveredBy.fields), g)}`), _.length > 0 && y.push(`${o("")}${m(`└ extra columns: ${_.join(", ")}`)}`), y.push(""), t.kind === "redundant-prefix" ? (y.push(`${o("why")}B-tree indexes serve queries that filter on a LEADING PREFIX of`), y.push(`${o("")}their column list. The wider index already covers every`), y.push(`${o("")}query the narrower one can serve.`), y.push(`${o("")}${m("Same rule on Postgres / MySQL / MariaDB / MSSQL / SQLite.")}`)) : (y.push(`${o("why")}Two indexes on the same columns under different names.`), y.push(`${o("")}The B-tree engine builds both — same coverage, double cost.`), y.push(`${o("")}${m("Same rule on Postgres / MySQL / MariaDB / MSSQL / SQLite.")}`)), t.redundant.where && y.push(`${o("filter")}${t.redundant.where}`), y.push(`${o("")}Row coverage and uniqueness are preserved by the kept index.`), y.push(""), y.push(`${o("cost")}Matching ${s("INSERT")} / ${s("UPDATE")} / ${s("DELETE")} on this table writes`), y.push(`${o("")}to ${f(i, e.bold, "both")} B-trees. Pure write overhead, zero read benefit.`), y.push(""), y.push(`${o("fix")}Drop  ${c(t.redundant.name)}`), y.push(`${o("")}${m("Keep only if profiling shows the smaller index gives a")}`), y.push(`${o("")}${m("measurable cache-locality boost on a write-heavy hot path.")}`), y.push(`${o("")}${m("Silence with VOLTRO_INDEX_AUDIT=off if intentional.")}`), y.map((e) => `${a}${e}`).join("\n");
 };
-//#endregion
-export { o as auditAllTableIndexes, a as auditTableIndexes, f as formatIndexAuditIssue };
+export { s as auditAllTableIndexes, o as auditTableIndexes, p as formatIndexAuditIssue };

package/dist/indexStorage.js

@@ -1,6 +1,6 @@
 import { resolveGinOpclass as e } from "./ginIndex.js";
 import { vectorDistanceToOpclass as t } from "./table.js";
-//#region src/indexStorage.ts
+// src/indexStorage.ts
 var n = (e, n = "float32") => {
 	let r = e?.hnsw, i = r?.m ?? 16, a = r?.efConstruction ?? 64;
 	for (let [e, t] of Object.entries({
@@ -54,5 +54,4 @@ var n = (e, n = "float32") => {
 		skip: !1
 	};
 };
-//#endregion
 export { r as indexKindForDialect, i as indexStorageShape, a as pgIndexClauses, n as resolveHnswOptions };

package/dist/joinCompiler.js

@@ -3,7 +3,7 @@ import { authoredError as t } from "./dbCause.js";
 import { decimalEqualityKey as n } from "./decimalComparison.js";
 import { inferForeignKey as r, validateRelationConfig as i } from "./relations.js";
 import { getRelations as a } from "./relationsRegistry.js";
-//#region src/joinCompiler.ts
+// src/joinCompiler.ts
 var o = class extends Error {
 	_tag = "EagerCardinalityError";
 	constructor(e) {
@@ -156,5 +156,4 @@ var o = class extends Error {
 		for (let [e, n] of Object.entries(t)) e in r || (r[e] = n);
 	});
 }, y = (e) => e.eager !== void 0 && Object.keys(e.eager).length > 0;
-//#endregion
 export { o as EagerCardinalityError, c as attachEagerLoads, y as hasEagerLoads, s as oneCardinalityMessage };

package/dist/jsonEagerCompiler.js

@@ -10,7 +10,7 @@ import { decodeCell as l } from "./rowDecoder.js";
 import { EagerCardinalityError as u, oneCardinalityMessage as d } from "./joinCompiler.js";
 import { coerceValueForSqlite as f } from "./sqliteValueCoercion.js";
 import { compilePredicate as p } from "./sqlCompiler.js";
-//#region src/jsonEagerCompiler.ts
+// src/jsonEagerCompiler.ts
 var m = (e, t, n) => {
 	if (e.eager === void 0) return null;
 	let r = v(e.table, e.eager, e.sourceTable);
@@ -432,5 +432,4 @@ var m = (e, t, n) => {
 		value: f(t.value)
 	};
 };
-//#endregion
 export { $ as coercePredicateForSqlite, f as coerceValueForSqlite, m as compileEagerJson };

package/dist/jsonPatch.js

@@ -1,4 +1,4 @@
-//#region src/jsonPatch.ts
+// src/jsonPatch.ts
 var e = (e) => typeof e == "object" && !!e && !Array.isArray(e), t = (e) => JSON.parse(JSON.stringify(e ?? null)), n = (n, r, i) => {
 	let [a, ...o] = r.split("."), s = t(i), c = n[a], l = (t, n) => {
 		if (n === o.length) return s;
@@ -74,5 +74,4 @@ var e = (e) => typeof e == "object" && !!e && !Array.isArray(e), t = (e) => JSON
 	}
 	return n`${n(s)} = ${b}`;
 };
-//#endregion
 export { n as applyJsonPatch, r as compileJsonPatch, t as normalizeJsonPatchValue };

package/dist/jsonPatchAssignments.js

@@ -1,6 +1,6 @@
 import { authoredError as e } from "./dbCause.js";
 import { rowKeyColumns as t } from "./rowKey.js";
-//#region src/jsonPatchAssignments.ts
+// src/jsonPatchAssignments.ts
 var n = (n, r, i) => {
 	let a = new Set(t(n).map(([e]) => e)), o = r.split(".")[0];
 	return Object.fromEntries(Object.entries(i ?? {}).filter(([t, n]) => {
@@ -9,5 +9,4 @@ var n = (n, r, i) => {
 		return !0;
 	}));
 };
-//#endregion
 export { n as jsonPatchAssignments };

package/dist/jsonPath.js

@@ -1,5 +1,5 @@
 import { quoteIdent as e } from "./dialect.js";
-//#region src/jsonPath.ts
+// src/jsonPath.ts
 var t = /^[A-Za-z_][A-Za-z0-9_]*$/, n = (e) => "$" + e.map((e) => typeof e == "number" ? `[${e}]` : t.test(e) ? `.${e}` : `."${e.replace(/"/g, "\\\"")}"`).join(""), r = (e) => "{" + e.map((e) => {
 	let t = String(e);
 	return /^[A-Za-z0-9_]+$/.test(t) ? t : `"${t.replace(/(["\\])/g, "\\$1")}"`;
@@ -27,5 +27,4 @@ var t = /^[A-Za-z_][A-Za-z0-9_]*$/, n = (e) => "$" + e.map((e) => typeof e == "n
 		}
 	}
 };
-//#endregion
 export { i as jsonPathSql };

package/dist/localFirstMixin.js

@@ -1,5 +1,5 @@
 import { defineMixin as e } from "./mixins.js";
-//#region src/localFirstMixin.ts
+// src/localFirstMixin.ts
 var t = "voltro/localFirst", n = () => e({
 	id: t,
 	fields: {}
@@ -8,5 +8,4 @@ var t = "voltro/localFirst", n = () => e({
 	for (let n of Object.values(e)) r(n) && t.push(n.tableName);
 	return t;
 };
-//#endregion
 export { t as VOLTRO_LOCAL_FIRST_MIXIN_ID, r as isLocalFirst, n as localFirst, i as localFirstTables };