@vibeorm/sql 4.0.0 → 4.2.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/dialect.d.ts

@@ -93,6 +93,19 @@ export type ConflictKeyEquality = {
      */
     readonly duplicatesInOneStatement: "reject" | "lastWriteWins";
 };
+/**
+ * How an INSERT that names no column renders, when every value is its column
+ * default. `defaultValues`: `INSERT INTO t DEFAULT VALUES`, exactly one row per
+ * statement; `conflictClause` says whether a conflict clause may follow it
+ * (postgres: yes; sqlite's grammar has no upsert clause after DEFAULT VALUES).
+ * `emptyRow`: `INSERT INTO t () VALUES ()`, any number of rows (mysql).
+ */
+export type EmptyInsertSyntax = {
+    readonly form: "defaultValues";
+    readonly conflictClause: boolean;
+} | {
+    readonly form: "emptyRow";
+};
 export type SqlDialect = {
     readonly name: Dialect;
     /** Frozen feature table — consumed by runtime, migrate, generator, tests. */
@@ -230,6 +243,8 @@ export type SqlDialect = {
      * rows are grouped by column set into separate statements there (M4).
      */
     readonly rowDefaultKeyword: boolean;
+    /** How an INSERT that names no column renders ({@link EmptyInsertSyntax}). */
+    readonly emptyInsert: EmptyInsertSyntax;
     /**
      * How a {@link ChainStatement} (an ordered chain of read and data-modifying
      * steps ending in one SELECT — round-trip campaign EPIC 4/F) renders, or

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.
@@ -38,7 +40,7 @@ export type { ResultDecoder, ResultReadDecoder, ResultParameterEncoder, ResultSc
 export { compileExclusion, renderExclusionSetup, renderExclusionDdl, renderExclusionCatalog, renderExclusionProbe } from "./exclusion.ts";
 export type { AdvisoryLockKey, AdvisoryLockStatement, AggFn, AggRef, AggSelect, ChainResult, ChainRowSource, ChainStatement, ChainStep, ChainStepStatement, ChainTally, ChainVeto, ColRef, ComparisonOp, CountSubquery, DeleteStatement, ExcludedRef, InnerJoin, KeyTableJoin, KeyTableMember, InsertSelectStatement, InsertStatement, ReturningColumn, JsonFilterOp, LateralJoin, ListSetOperation, OnConflictClause, OnConflictDoNothing, OnConflictUpdate, OrderByAggregate, OrderByColumn, OrderBySubquery, OrderTerm, RowLock, RowNumberProjection, DbNowMarker, JsonParamCell, SelectExpr, SelectStatement, SetOperation, SetOperator, SqlExpr, SqlStatement, StepColumnRef, TableRef, UpdateStatement, } from "./ast.ts";
 export { ADVISORY_LOCK_RESULT_COLUMN, CHAIN_VETO_PREFIX, CHAIN_VETO_TOKEN_PATTERN, SQL_DEFAULT_CELL, chainVetoToken, dbNowMarker, excludedRef, isDbNowMarker, isExcludedRef, isJsonParamCell, isListSetOperation, isSetOperation, isSqlDefaultCell, isStepColumnRef, jsonParamCell, returningColumnName, stepColumnRef, } from "./ast.ts";
-export type { AdvisoryLockFunctions, AdvisoryLockModeFunctions, RowLockSyntax, SqlDialect, } from "./dialect.ts";
+export type { AdvisoryLockFunctions, AdvisoryLockModeFunctions, RowLockSyntax, EmptyInsertSyntax, SqlDialect, } from "./dialect.ts";
 export { ADVISORY_KEY_BOUNDS, describeRowLock, renderAdvisoryLock, renderRowLockClause } from "./locks.ts";
 export { JSON_TRANSPORT, projectionOutputName } from "./json-transport.ts";
 export { postgresDialect } from "./dialects/postgres.ts";