@vibeorm/sql 4.0.0 → 4.1.0

package/dist/ast.d.ts

@@ -19,10 +19,11 @@ export type ColRef = {
      * Projection-only wire transform. `jsonText` uses the dialect's JSON text
      * projection to preserve SQL NULL versus the JSON document `null` before
      * driver parsing, without converting a postgres `json` column to `jsonb`.
-     * The other transforms are postgres only. `castText` renders
-     * `"col"::text AS "col"`, `encodeBase64` renders
-     * `encode("col", 'base64') AS "col"`. Two users: the lateral subselect (SQL
-     * review B3 — raw `to_jsonb` would ship BigInt/Decimal as float64 JSON
+     * `castText` renders a dialect text cast and preserves `alias ?? name`,
+     * including timestamp identity before driver Date truncation. PostgreSQL
+     * uses `"col"::text`; SQLite/MySQL use CAST AS TEXT/CHAR. `encodeBase64`
+     * is postgres-only and renders `encode("col", 'base64')`. Other users:
+     * the lateral subselect (SQL review B3: raw `to_jsonb` would ship BigInt/Decimal as float64 JSON
      * numbers and Bytes as `\x` hex text), and every row projection of a
      * `Float[]`/`Json[]` column (bun:sql's array parser refuses float arrays
      * printed with an exponent and json arrays holding integers beyond int32;
@@ -77,6 +78,8 @@ export type AggRef = {
 export type AggSelect = {
     readonly agg: AggRef;
     readonly alias: string;
+    /** Projection-only result cast; native aggregate comparisons and ordering stay typed. */
+    readonly castText?: true;
 };
 /**
  * JSON path predicates (Prisma's Json filter surface). `not` is `equals` with
@@ -467,6 +470,12 @@ export type KeyTableMember = {
 } | {
     readonly kind: "decimal";
     readonly scale: number;
+}
+/** MySQL-only lossless temporal operands in mixed collation-aware key tuples. */
+ | {
+    readonly kind: "timestamp";
+} | {
+    readonly kind: "time";
 } | {
     readonly kind: "citext";
 } | {
@@ -641,7 +650,8 @@ export declare function excludedRef(params: {
 export declare function isExcludedRef(value: unknown): value is ExcludedRef;
 /**
  * One RETURNING column: a bare column name renders `"col"`; `castText` renders
- * `"col"::text AS "col"` (postgres only) for `Float[]`/`Json[]`. `jsonText`
+ * a dialect text cast (postgres `::text`, sqlite `CAST AS TEXT`) for lossless
+ * transport, including timestamps and postgres arrays. `jsonText`
  * applies the dialect's JSON text projection, as {@link ColRef.transform} does
  * for SELECT. Dialects without RETURNING still omit the clause and flag it.
  */

package/dist/dialects/postgres-migration.d.ts

@@ -54,6 +54,8 @@ export declare function renderMigrationSessionRestore(params: {
  * expressions as PostgreSQL itself deparses them (newline-joined so every
  * adapter decodes one plain text column), its partial predicate and the full
  * `pg_get_indexdef` text for the operator to read in an error message.
+ * Complete recovery also reads NULL uniqueness and lossless ordered JSON text
+ * for key and included definitions. PostgreSQL 16/17/18 expose these fields.
  *
  * `indisvalid = false` is the state a cancelled/failed concurrent build
  * leaves behind: the index exists, is skipped by the planner, and is still

package/dist/dialects/sqlite-json-equality.d.ts

@@ -0,0 +1,15 @@
+import type { SqlDialect } from "../dialect.ts";
+/**
+ * Compare both JSON trees by decoded key/index paths, node type and atomic value.
+ * Object order and JSON escape spelling do not matter; array positions do.
+ * Container nodes retain empty-object/array distinctions, and multiplicity stops
+ * duplicate object members from disappearing as they would in a set difference.
+ * SQL NULL remains unknown. The tree input is guarded against non-JSON scalar
+ * text even when SQLite evaluates this expression before the outer type guard.
+ */
+export declare function renderSqliteJsonEquality(params: {
+    dialect: SqlDialect;
+    left: string;
+    right: string;
+}): string;
+//# sourceMappingURL=sqlite-json-equality.d.ts.map

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { cloneTimestampDate, compareTimestampDates, timestampIdentityKey, timestampIdentityText } from "./timestamp-identity.ts";
 export { nativeEnumArrayParameter, isNativeEnumArrayParameter } from "./native-enum-parameter.ts";
 export type { NativeEnumArrayParameter } from "./native-enum-parameter.ts";
 export { isJsonListParameter, jsonListParameter } from "./json-list-parameter.ts";
@@ -19,6 +20,7 @@ export { MODULE_JOURNAL_COLUMN, renderModuleJournal } from "./module-journal.ts"
 export { renderSqliteFtsUpdateTrigger, sqliteFtsUpdateUpgrade } from "./dialects/sqlite-fts.ts";
 export { SQLITE_SESSION_SQL } from "./dialects/sqlite-session.ts";
 export { sql, isSqlFragment, renderSqlFragment, compileSql, sqlUsesIncoming, mapConflictColumns } from "./composable.ts";
+export { registerSqlHandleCheck } from "./sql-handles.ts";
 export type { SqlFragment, SqlTag } from "./composable.ts";
 export { createSqlQuery, createSqlCommand, isSqlQuery, isSqlCommand, compileSqlQuery, compileSqlCommand } from "./query-plan.ts";
 export type { SqlQuery, SqlCommand, SqlPlanRender, CompiledSqlQuery, CompiledSqlCommand, ReusableSqlQuery, ReusableSqlCommand } from "./query-plan.ts";
@@ -27,7 +29,7 @@ export { isSqlParam, createSqlInput, sqlInputContract, createSqlInputScope, seal
 export type { SqlParam, SqlInput, SqlInputMap, SqlInputValue, SqlInputValues, SqlInputTokens, SqlExecutionParams, SqlInputContract, SqlInputScope } from "./sql-input.ts";
 export { isSqlBindingCollector, recordSqlBinding, recordSqlBindingCheck } from "./sql-bindings.ts";
 export type { SqlBindingSource, SqlParameterTransport, SqlBindingEncoder } from "./sql-bindings.ts";
-export { decode, encode, resultScalarContract } from "./result-decoder.ts";
+export { decode, encode, resultScalarContract, sameResultDecoder } from "./result-decoder.ts";
 export type { ResultDecoder, ResultReadDecoder, ResultParameterEncoder, ResultScalarContract, Decoded, ExtendedDateTime } from "./result-decoder.ts";
 /**
  * @vibeorm/sql — dialect-aware SQL layer for VibeORM v2.

package/dist/index.js

@@ -1,4 +1,76 @@
 // @bun
+// packages/sql/src/timestamp-identity.ts
+var identities = new WeakMap;
+function rememberTimestampIdentity(params) {
+  const { date, text } = params;
+  const fraction = /\.(\d+)/.exec(text)?.[1] ?? "";
+  const remainder = fraction.slice(3).replace(/0+$/, "");
+  const canonical = Date.prototype.toISOString.call(date).replace(/(\.\d{3})Z$/, `$1${remainder}Z`);
+  identities.set(date, {
+    milliseconds: Date.prototype.getTime.call(date),
+    text,
+    ...params.numeric === undefined ? {} : { numeric: params.numeric },
+    key: params.key ?? `date:${canonical}`,
+    kind: params.kind ?? "timestamp"
+  });
+  return date;
+}
+function identityOf(params) {
+  const stored = identities.get(params.date);
+  if (stored !== undefined && stored.milliseconds !== Date.prototype.getTime.call(params.date)) {
+    identities.delete(params.date);
+    return;
+  }
+  return stored;
+}
+function timestampIdentityKey(params) {
+  return identityOf(params)?.key ?? `date:${Number.isFinite(Date.prototype.getTime.call(params.date)) ? Date.prototype.toISOString.call(params.date) : "invalid"}`;
+}
+function timestampIdentityText(params) {
+  const identity = identityOf(params);
+  return identity !== undefined && (params.kind === undefined || identity.kind === params.kind) ? identity.text : undefined;
+}
+function sqliteTimestampIdentityValue(params) {
+  const identity = identityOf(params);
+  return identity?.kind === "sqlite" ? identity.numeric ?? identity.text : undefined;
+}
+function compareTimestampDates(params) {
+  const left = identityOf({ date: params.left });
+  const right = identityOf({ date: params.right });
+  if (timestampIdentityKey({ date: params.left }) === timestampIdentityKey({ date: params.right }))
+    return 0;
+  const rank = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+  if (left?.kind === "sqlite" || right?.kind === "sqlite") {
+    return left?.numeric !== undefined && right?.numeric !== undefined ? rank(left.numeric, right.numeric) : null;
+  }
+  const clock = (identity) => {
+    const [, hours, minutes, seconds, offset] = identity.key.split(":");
+    const [whole, fraction = ""] = seconds.split(".");
+    const local = BigInt(Number(hours) * 3600 + Number(minutes) * 60 + Number(whole)) * 1000000000n + BigInt(fraction.padEnd(9, "0"));
+    const zone = Number(offset);
+    return [local - BigInt(zone) * 1000000n, -zone];
+  };
+  if (left?.kind !== undefined && left.kind !== "timestamp" || right?.kind !== undefined && right.kind !== "timestamp") {
+    if (left === undefined || right === undefined || left.kind !== right.kind)
+      return null;
+    const a = clock(left);
+    const b = clock(right);
+    return rank(a[0], b[0]) || rank(a[1], b[1]);
+  }
+  const milliseconds = rank(Date.prototype.getTime.call(params.left), Date.prototype.getTime.call(params.right));
+  if (milliseconds !== 0)
+    return milliseconds;
+  const a = /\.(\d+)/.exec(left?.text ?? "")?.[1]?.slice(3) ?? "";
+  const b = /\.(\d+)/.exec(right?.text ?? "")?.[1]?.slice(3) ?? "";
+  return rank(a.padEnd(Math.max(a.length, b.length), "0"), b.padEnd(Math.max(a.length, b.length), "0"));
+}
+function cloneTimestampDate(params) {
+  const date = new Date(Date.prototype.getTime.call(params.date));
+  const identity = identityOf(params);
+  if (identity !== undefined)
+    identities.set(date, identity);
+  return date;
+}
 // packages/sql/src/native-enum-parameter.ts
 var NATIVE_ENUM_ARRAY_PARAMETER = Symbol("vibeorm.nativeEnumArrayParameter");
 function nativeEnumArrayParameter(params) {
@@ -234,24 +306,24 @@ function parseDateTimeText(params) {
   if (ZONE_LESS_DATETIME.test(trimmed)) {
     const asUtc = new Date(`${trimmed.replace(" ", "T").replace(/(\.\d{3})\d+$/, "$1")}Z`);
     if (!Number.isNaN(asUtc.getTime()))
-      return asUtc;
+      return rememberTimestampIdentity({ date: asUtc, text: trimmed });
   }
   const zoned = PG_ZONED_DATETIME.exec(trimmed);
   if (zoned !== null) {
     const [, date, time, fraction, hours, minutes] = zoned;
     const iso = new Date(`${date}T${time}${(fraction ?? "").slice(0, 4)}${hours}:${minutes ?? "00"}`);
     if (!Number.isNaN(iso.getTime()))
-      return iso;
+      return rememberTimestampIdentity({ date: iso, text: trimmed });
   }
   const parsed = new Date(trimmed);
-  return Number.isNaN(parsed.getTime()) ? undefined : parsed;
+  return Number.isNaN(parsed.getTime()) ? undefined : rememberTimestampIdentity({ date: parsed, text: trimmed });
 }
 var dateNativeCodec = {
   encode: (value) => {
     if (value instanceof Date && !Number.isFinite(value.getTime()) || typeof value === "number" && !Number.isFinite(value) || typeof value === "string" && /^[+-]?infinity$/i.test(value.trim())) {
       throw new VibeError({ code: "VIBE_VALIDATION", message: "DateTime parameters require finite timestamps; use an extended timestamp encoder for infinity" });
     }
-    return value;
+    return value instanceof Date ? timestampIdentityText({ date: value }) ?? value : value;
   },
   decode: (value) => {
     const date = value instanceof Date ? value : typeof value === "string" ? parseDateTimeText({ text: value }) : typeof value === "number" ? new Date(value) : undefined;
@@ -265,16 +337,27 @@ var dateTextCodec = {
     dateNativeCodec.encode(value);
     const date = value instanceof Date ? value : typeof value === "string" ? parseDateTimeText({ text: value }) : typeof value === "number" ? new Date(value) : undefined;
     if (date !== undefined && Number.isFinite(date.getTime()))
-      return date.toISOString();
+      return value instanceof Date ? sqliteTimestampIdentityValue({ date: value }) ?? date.toISOString() : date.toISOString();
     throw new VibeError({ code: "VIBE_VALIDATION", message: "DateTime parameters require a valid finite timestamp" });
   },
-  decode: dateNativeCodec.decode
+  decode: (value) => {
+    const date = dateNativeCodec.decode(value);
+    if (typeof value === "number")
+      return rememberTimestampIdentity({ date, text: date.toISOString(), numeric: value, key: `epoch:${value}`, kind: "sqlite" });
+    return typeof value === "string" ? rememberTimestampIdentity({ date, text: value, key: `date:${value}`, kind: "sqlite" }) : date;
+  }
 };
 var mysqlDateCodec = {
   encode: (value) => {
     dateNativeCodec.encode(value);
-    if (value instanceof Date)
+    if (value instanceof Date) {
+      const text = timestampIdentityText({ date: value, kind: "timestamp" });
+      if (text !== undefined) {
+        const fraction = /\.(\d+)/.exec(text)?.[1] ?? "";
+        return value.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, `.${fraction.padEnd(3, "0")}`);
+      }
       return value;
+    }
     if (typeof value === "number") {
       const parsed = new Date(value);
       if (!Number.isNaN(parsed.getTime()))
@@ -301,18 +384,26 @@ function makeTimeOfDayCodec(params) {
       if (date === undefined || !Number.isFinite(date.getTime())) {
         throw new VibeError({ code: "VIBE_VALIDATION", message: "a time-of-day DateTime parameter requires a valid finite Date", meta: { value } });
       }
-      return `${timeOfDayText(utcMillisecondOfDay(date))}${suffix}`;
+      return timestampIdentityText({ date, kind: params.zoned ? "timetz" : "time" }) ?? `${timeOfDayText(utcMillisecondOfDay(date))}${suffix}`;
     },
     decode: (value) => {
-      if (value instanceof Date && Number.isFinite(value.getTime()))
-        return new Date(utcMillisecondOfDay(value));
+      if (value instanceof Date && Number.isFinite(value.getTime())) {
+        if (timestampIdentityText({ date: value, kind: params.zoned ? "timetz" : "time" }) !== undefined)
+          return value;
+        const milliseconds = utcMillisecondOfDay(value);
+        const text = timeOfDayText(milliseconds);
+        return rememberTimestampIdentity({ date: new Date(milliseconds), text: `${text}${suffix}`, key: `${params.zoned ? "timetz" : "time"}:${text}:0`, kind: params.zoned ? "timetz" : "time" });
+      }
       const match = typeof value === "string" ? TIME_OF_DAY_TEXT.exec(value.trim()) : null;
       if (match !== null) {
         const [, hours, minutes, seconds, fraction, sign, offsetHours, offsetMinutes, offsetSeconds] = match;
         const millisecond = Number(hours) * 3600000 + Number(minutes) * 60000 + Number(seconds ?? 0) * 1000 + Number((fraction ?? "").slice(0, 3).padEnd(3, "0"));
         const offset = sign === undefined ? 0 : (sign === "-" ? -1 : 1) * (Number(offsetHours) * 3600000 + Number(offsetMinutes ?? 0) * 60000 + Number(offsetSeconds ?? 0) * 1000);
         if (millisecond <= MILLISECONDS_PER_DAY) {
-          return new Date(((millisecond - offset) % MILLISECONDS_PER_DAY + MILLISECONDS_PER_DAY) % MILLISECONDS_PER_DAY);
+          const date = new Date(((millisecond - offset) % MILLISECONDS_PER_DAY + MILLISECONDS_PER_DAY) % MILLISECONDS_PER_DAY);
+          const exactFraction = (fraction ?? "").padEnd(3, "0").replace(/(?<=\d{3})0+$/, "");
+          const key = `${params.zoned ? "timetz" : "time"}:${hours}:${minutes}:${seconds ?? "00"}.${exactFraction}:${offset}`;
+          return rememberTimestampIdentity({ date, text: value.trim(), key, kind: params.zoned ? "timetz" : "time" });
         }
       }
       throw new VibeError({ code: "VIBE_DATA_INVALID", message: "a time-of-day DateTime column returned a value that is not a time of day", meta: { value } });
@@ -435,12 +526,27 @@ var DIALECT_CODECS = {
 
 // packages/sql/src/result-decoder.ts
 var scalarContracts = new WeakMap;
+var decoderIdentities = new WeakMap;
+var nullableDecoders = new WeakMap;
+var arrayDecoders = new WeakMap;
+function sameResultDecoder(params) {
+  if (params.left === params.right)
+    return true;
+  const identity = decoderIdentities.get(params.left);
+  return identity !== undefined && identity === decoderIdentities.get(params.right);
+}
+function wrappedIdentity(params) {
+  const identity = decoderIdentities.get(params.decoder);
+  return identity === undefined ? undefined : JSON.stringify([params.kind, identity]);
+}
 function resultScalarContract(params) {
   return scalarContracts.get(params.decoder);
 }
 function registerScalar(params) {
   if (params.contract !== undefined)
     scalarContracts.set(params.decoder, Object.freeze(params.contract));
+  if (params.identity !== undefined)
+    decoderIdentities.set(params.decoder, params.identity);
   return params.decoder;
 }
 function wrappedContract(params) {
@@ -473,7 +579,7 @@ function scalar(type, valid) {
       refuse(encoding, `Invalid ${type} projection value`);
     return result;
   };
-  return registerScalar({ contract: { scalar: type, nullable: false, list: false }, decoder: Object.freeze({
+  return registerScalar({ identity: JSON.stringify(["scalar", type]), contract: { scalar: type, nullable: false, list: false }, decoder: Object.freeze({
     decode: (params) => convert(params, false),
     encode: (params) => {
       const value = type === "Json" ? params.value : convert(params, true);
@@ -485,7 +591,7 @@ function scalar(type, valid) {
 }
 var stringDecoder = scalar("String", (value) => typeof value === "string");
 var dateDecoder = scalar("DateTime", (value) => value instanceof Date && Number.isFinite(value.getTime()));
-var extendedDecoder = registerScalar({ contract: { scalar: "DateTime", nullable: false, list: false }, decoder: Object.freeze({
+var extendedDecoder = registerScalar({ identity: "extended-date-time", contract: { scalar: "DateTime", nullable: false, list: false }, decoder: Object.freeze({
   decode: (params) => {
     if (params.value === "infinity" || params.value === Infinity)
       return "infinity";
@@ -506,15 +612,21 @@ function hasEncoder(decoder) {
   return "encode" in decoder && typeof decoder.encode === "function";
 }
 function nullable({ decoder }) {
+  const cached = nullableDecoders.get(decoder);
+  if (cached !== undefined)
+    return cached;
   const read = (params) => params.value === null ? null : decoder.decode(params);
-  if (!hasEncoder(decoder))
-    return Object.freeze({ decode: read });
-  return registerScalar({ contract: wrappedContract({ decoder, nullable: true }), decoder: Object.freeze({
+  const wrapped = hasEncoder(decoder) ? registerScalar({ identity: wrappedIdentity({ decoder, kind: "nullable" }), contract: wrappedContract({ decoder, nullable: true }), decoder: Object.freeze({
     decode: read,
     encode: (params) => params.value === null ? null : decoder.encode(params)
-  }) });
+  }) }) : Object.freeze({ decode: read });
+  nullableDecoders.set(decoder, wrapped);
+  return wrapped;
 }
 function array({ decoder }) {
+  const cached = arrayDecoders.get(decoder);
+  if (cached !== undefined)
+    return cached;
   const bidirectional = hasEncoder(decoder);
   const read = (params) => {
     const raw = params.value;
@@ -534,16 +646,16 @@ function array({ decoder }) {
       refuse(false, "Expected an array projection");
     return value.map((element) => decoder.decode({ ...params, value: element }));
   };
-  if (!hasEncoder(decoder))
-    return Object.freeze({ decode: read });
-  return registerScalar({ contract: wrappedContract({ decoder, list: true }), decoder: Object.freeze({
+  const wrapped = hasEncoder(decoder) ? registerScalar({ identity: wrappedIdentity({ decoder, kind: "array" }), contract: wrappedContract({ decoder, list: true }), decoder: Object.freeze({
     decode: read,
     encode: (params) => {
       if (!Array.isArray(params.value))
         refuse(true, "Expected an array parameter");
       return params.value.map((value) => decoder.encode({ ...params, value }));
     }
-  }) });
+  }) }) : Object.freeze({ decode: read });
+  arrayDecoders.set(decoder, wrapped);
+  return wrapped;
 }
 var encode = Object.freeze({
   array: ({ encoder }) => Object.freeze({
@@ -569,7 +681,7 @@ var decode = Object.freeze({
   array,
   enum: ({ values }) => {
     const members = new Set(values);
-    return registerScalar({ contract: { scalar: "String", nullable: false, list: false }, decoder: Object.freeze({
+    return registerScalar({ identity: JSON.stringify(["enum", [...members].sort()]), contract: { scalar: "String", nullable: false, list: false }, decoder: Object.freeze({
       decode: ({ value }) => typeof value === "string" && members.has(value) ? value : refuse(false, "Unknown enum projection member"),
       encode: ({ value }) => typeof value === "string" && members.has(value) ? value : refuse(true, "Unknown enum parameter member")
     }) });
@@ -590,10 +702,23 @@ var decode = Object.freeze({
   }
 });
 
+// packages/sql/src/sql-handles.ts
+var checks = new Set;
+function registerSqlHandleCheck(params) {
+  checks.add(params.check);
+}
+function isSqlHandle(value) {
+  for (const check of checks)
+    if (check(value))
+      return true;
+  return false;
+}
+
 // packages/sql/src/sql-input.ts
 var inputs = new WeakMap;
 var tokens = new WeakMap;
 var scopes = new WeakMap;
+registerSqlHandleCheck({ check: (value) => inputs.has(value) || tokens.has(value) || scopes.has(value) });
 function invalid(message) {
   throw new VibeError3({ code: "VIBE_VALIDATION", message });
 }
@@ -691,7 +816,7 @@ function snapshotSqlValue(value, ancestors = new Set, isHandle) {
   };
   if (isSqlParam(value))
     return invalid("SQL input tokens are valid only in admitted reusable builder positions");
-  if (isHandle !== undefined && typeof value === "object" && value !== null && isHandle(value))
+  if (typeof value === "object" && value !== null && (isSqlHandle(value) || isHandle?.(value)))
     return invalid("SQL builder, plan, template, input and fragment handles are not execution values");
   if (value === undefined)
     return invalid("SQL values cannot be undefined; omit a defaulted column or use null");
@@ -700,7 +825,7 @@ function snapshotSqlValue(value, ancestors = new Set, isHandle) {
   if (typeof value === "number")
     return value;
   if (value instanceof Date)
-    return Number.isFinite(value.getTime()) ? new Date(value.getTime()) : invalid("SQL dates must be finite");
+    return Number.isFinite(value.getTime()) ? cloneTimestampDate({ date: value }) : invalid("SQL dates must be finite");
   if (value instanceof Uint8Array)
     return new Uint8Array(value);
   if (typeof value !== "object")
@@ -1407,6 +1532,7 @@ var SQLITE_SESSION_SQL = Object.freeze({
 // packages/sql/src/composable.ts
 import { VibeError as VibeError9 } from "@vibeorm/schema";
 var fragments = new WeakMap;
+registerSqlHandleCheck({ check: (value) => fragments.has(value) });
 function invalid3(message) {
   throw new VibeError9({ code: "VIBE_VALIDATION", message });
 }
@@ -1492,7 +1618,7 @@ function renderSqlFragment(params) {
   const encode = (part) => {
     if (part.value === undefined)
       invalid3("SQL parameters cannot be undefined; use null explicitly");
-    return snapshotSqlValue(part.decoder === undefined ? part.value : part.decoder.encode({ value: part.value, dialect: dialect.name }));
+    return snapshotSqlValue(part.decoder === undefined ? part.value : part.decoder.encode({ value: snapshotSqlValue(part.value), dialect: dialect.name }));
   };
   const recording = isSqlBindingCollector({ collector });
   const recordValue = (part) => recordSqlBinding({
@@ -1580,6 +1706,7 @@ var queries = new WeakMap;
 var commands = new WeakMap;
 var reusableQueries = new WeakMap;
 var reusableCommands = new WeakMap;
+registerSqlHandleCheck({ check: (value) => queries.has(value) || commands.has(value) || reusableQueries.has(value) || reusableCommands.has(value) });
 function invalid4(message) {
   throw new VibeError10({ code: "VIBE_VALIDATION", message });
 }
@@ -2249,7 +2376,7 @@ function assertInt32(params) {
 var JSON_TRANSPORT = Object.freeze({ chunkSize: 100 });
 function projectionOutputName(params) {
   const { column } = params;
-  return column.transform === undefined || column.transform === "jsonText" ? column.alias ?? column.name : column.name;
+  return column.alias ?? column.name;
 }
 // packages/sql/src/dialects/postgres.ts
 var postgresDialect = {
@@ -2398,6 +2525,20 @@ var SQL_DIALECTS = {
 function getSqlDialect(params) {
   return SQL_DIALECTS[params.dialect];
 }
+// packages/sql/src/dialects/sqlite-json-equality.ts
+function renderSqliteJsonEquality(params) {
+  const q = (name) => params.dialect.quoteIdent({ name });
+  const values = q("__vibe_json_values");
+  const tree = q("__vibe_json_tree");
+  const paths = q("__vibe_json_paths");
+  const child = q("__vibe_json_child");
+  const parent = q("__vibe_json_parent");
+  const [side, id, parentId, key, type, atom, path] = ["side", "id", "parent", "key", "type", "atom", "path"].map(q);
+  const left = `${values}.${q("left")}`;
+  const right = `${values}.${q("right")}`;
+  return `(SELECT CASE WHEN ${left} IS NULL THEN NULL ELSE NOT EXISTS (` + `WITH RECURSIVE ${tree} AS (` + `SELECT 1 AS ${side}, ${id}, ${parentId}, ${key}, ${type}, ${atom} FROM json_tree(CASE WHEN json_valid(${left}) THEN ${left} ELSE 'null' END) ` + `UNION ALL SELECT -1 AS ${side}, ${id}, ${parentId}, ${key}, ${type}, ${atom} FROM json_tree(${right})` + `), ${paths} (${side}, ${id}, ${path}, ${type}, ${atom}) AS (` + `SELECT ${side}, ${id}, json_array(), ${type}, ${atom} FROM ${tree} WHERE ${parentId} IS NULL ` + `UNION ALL SELECT ${child}.${side}, ${child}.${id}, json_insert(${parent}.${path}, '$[#]', ${child}.${key}), ${child}.${type}, ${child}.${atom} ` + `FROM ${tree} AS ${child} JOIN ${paths} AS ${parent} ON ${child}.${side} = ${parent}.${side} AND ${child}.${parentId} = ${parent}.${id}` + `) SELECT 1 FROM ${paths} GROUP BY ${path}, CASE WHEN ${type} IN ('integer', 'real') THEN 'number' ELSE ${type} END, ${atom} HAVING SUM(${side}) <> 0` + `) END FROM (SELECT ${params.left} AS ${q("left")}, ${params.right} AS ${q("right")}) AS ${values})`;
+}
+
 // packages/sql/src/dialects/diagnostics.ts
 import { unsupportedCapability as unsupportedCapability12 } from "@vibeorm/schema";
 var QUERIES = Object.freeze({
@@ -2501,7 +2642,7 @@ function requireArg(params) {
 import { unsupportedCapability as unsupportedCapability15 } from "@vibeorm/schema";
 
 // packages/sql/src/dialects/postgres-rls.ts
-import { RlsContextError, VibeError as VibeError14, assertValidSchemaIR, unsupportedCapability as unsupportedCapability14, validateRlsContextIR } from "@vibeorm/schema";
+import { RlsContextError, VibeError as VibeError14, assertNativeRlsAdmission, assertValidSchemaIR, unsupportedCapability as unsupportedCapability14, validateRlsContextIR } from "@vibeorm/schema";
 var NATIVE_RLS = Object.freeze({ policyName: "vibeorm_managed", tableSchema: "public", settingPrefix: "vibeorm.", parentAlias: "parent" });
 var COLUMN_TYPES = {
   String: { default: "text", native: { text: "text", varchar: "varchar", charactervarying: "varchar", uuid: "uuid" } },
@@ -2570,6 +2711,7 @@ function renderRlsColumnType(params) {
 }
 function protectedModel(params) {
   requireRls(params);
+  assertNativeRlsAdmission({ schema: params.schema, dialect: params.dialect.name });
   assertValidSchemaIR({ schema: params.schema });
   const model = params.schema.models.find((entry) => entry.name === params.model);
   if (model === undefined || model.rls === undefined || model.rls === "unprotected") {
@@ -2948,15 +3090,18 @@ function quoteProjection(dialect, column) {
     const alias = dialect.quoteIdent({ name: column.alias ?? column.name });
     return `${dialect.jsonTextProjection({ expression: ref })} AS ${alias}`;
   }
-  if (dialect.name !== "postgres") {
-    throw internalError2({ message: "ColRef.transform is a postgres construct" });
-  }
   const ref = quoteCol(dialect, column);
-  const alias = dialect.quoteIdent({ name: column.name });
+  const alias = dialect.quoteIdent({ name: column.alias ?? column.name });
   if (column.transform === "castText")
-    return `${ref}::text AS ${alias}`;
+    return `${textProjection({ dialect, expression: ref })} AS ${alias}`;
+  if (dialect.name !== "postgres") {
+    throw internalError2({ message: "encodeBase64 is a postgres construct" });
+  }
   return `encode(${ref}, 'base64') AS ${alias}`;
 }
+function textProjection(params) {
+  return params.dialect.name === "postgres" ? `${params.expression}::text` : `CAST(${params.expression} AS ${params.dialect.name === "mysql" ? "CHAR" : "TEXT"})`;
+}
 function renderProjection(params) {
   const { dialect, columns } = params;
   return columns.map((column) => quoteProjection(dialect, column)).join(", ");
@@ -3277,8 +3422,8 @@ function renderJsonFilter(params) {
       if (value !== null) {
         const target = `json_extract(${column}, ${collector.add(path)})`;
         const bound = typeof value === "boolean" ? value ? 1 : 0 : value;
-        const operand = typeof value === "object" ? `json(${collector.add(JSON.stringify(value))})` : collector.add(bound);
-        base = `(${guard} AND ${target} = ${operand})`;
+        const comparison = typeof value === "object" ? renderSqliteJsonEquality({ dialect, left: target, right: collector.add(JSON.stringify(value)) }) : `${target} = ${collector.add(bound)}`;
+        base = `(${guard} AND ${comparison})`;
       }
       return expr.negate === true ? `NOT (${base})` : base;
     };
@@ -3443,11 +3588,8 @@ function applyReturning(params) {
       const name = dialect.quoteIdent({ name: column.name });
       return `${dialect.jsonTextProjection({ expression: name })} AS ${name}`;
     }
-    if (dialect.name !== "postgres") {
-      throw internalError2({ message: "a castText RETURNING column is a postgres construct" });
-    }
     const name = dialect.quoteIdent({ name: column.name });
-    return `${name}::text AS ${name}`;
+    return `${textProjection({ dialect, expression: name })} AS ${name}`;
   }).join(", ");
   return { suffix: ` RETURNING ${columns}`, status: "native" };
 }
@@ -3484,6 +3626,10 @@ function renderKeyTableJoin(params) {
       switch (member.kind) {
         case "integer":
           return dialect.name === "mysql" ? `CAST(${placeholder} AS SIGNED)` : `CAST(${placeholder} AS bigint)`;
+        case "timestamp":
+          return `CAST(${placeholder} AS DATETIME(6))`;
+        case "time":
+          return `CAST(${placeholder} AS TIME(6))`;
         case "decimal":
           return `CAST(${placeholder} AS DECIMAL(65,${member.scale}))`;
         case "citext":
@@ -3513,7 +3659,9 @@ function renderSelect(params) {
   }
   if (statement.aggregates !== undefined) {
     for (const selection of statement.aggregates) {
-      columnList.push(`${renderAggRef(dialect, selection.agg)} AS ${dialect.quoteIdent({ name: selection.alias })}`);
+      const expression = renderAggRef(dialect, selection.agg);
+      const projected = selection.castText === true ? textProjection({ dialect, expression }) : expression;
+      columnList.push(`${projected} AS ${dialect.quoteIdent({ name: selection.alias })}`);
     }
   }
   if (statement.countSubqueries !== undefined) {
@@ -4417,8 +4565,13 @@ function renderIndexStateQuery(params) {
     text: `SELECT c.relname::text AS "index",
        t.relname::text AS "table",
        am.amname::text AS "method",
-       i.indisunique AS "unique",
-       i.indisvalid AS "valid",
+        i.indisunique AS "unique",
+        i.indnullsnotdistinct AS "nullsNotDistinct",
+        pg_catalog.array_to_json(ARRAY(SELECT pg_catalog.pg_get_indexdef(i.indexrelid, k.k, true)
+          FROM pg_catalog.generate_series(1, i.indnkeyatts) AS k(k) ORDER BY k.k))::text AS "keyColumns",
+        pg_catalog.array_to_json(ARRAY(SELECT pg_catalog.pg_get_indexdef(i.indexrelid, k.k, true)
+          FROM pg_catalog.generate_series(i.indnkeyatts + 1, i.indnatts) AS k(k) ORDER BY k.k))::text AS "includedColumns",
+        i.indisvalid AS "valid",
        i.indisready AS "ready",
        pg_catalog.pg_get_expr(i.indpred, i.indrelid) AS "predicate",
        pg_catalog.pg_get_indexdef(i.indexrelid) AS "definition",
@@ -4510,6 +4663,8 @@ export {
   SQL_DIALECTS,
   assertSqlParamBuilding,
   chainVetoToken,
+  cloneTimestampDate,
+  compareTimestampDates,
   compileExclusion,
   compileReusableSqlCommand,
   compileReusableSqlQuery,
@@ -4567,6 +4722,7 @@ export {
   projectionOutputName,
   recordSqlBinding,
   recordSqlBindingCheck,
+  registerSqlHandleCheck,
   renderAdvisoryLock,
   renderCheckProbe,
   renderColumnStateQuery,
@@ -4632,6 +4788,7 @@ export {
   renderStatement,
   resultScalarContract,
   returningColumnName,
+  sameResultDecoder,
   sealSqlInputScope,
   shortestFloat32,
   snapshotSqlValue,
@@ -4648,7 +4805,9 @@ export {
   strictMatchPattern,
   tableDefinitionParts,
   timeOfDayCodec,
+  timestampIdentityKey,
+  timestampIdentityText,
   toPgArrayLiteral
 };
 
-//# debugId=B8D70B32D9F5E99064756E2164756E21
+//# debugId=02AD9A2144138F0F64756E2164756E21