@vibeorm/sql 3.0.0 → 4.1.0

package/dist/ast.d.ts

@@ -16,17 +16,21 @@ export type ColRef = {
     readonly table?: string;
     readonly name: string;
     /**
-     * Projection-only wire transform, 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
+     * 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`.
+     * `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;
      * the runtime parses the array literal text itself). Never set on
      * filter/order refs.
      */
-    readonly transform?: "castText" | "encodeBase64";
+    readonly transform?: "castText" | "encodeBase64" | "jsonText";
     /**
      * Comparison/order/aggregate cast, sqlite Decimal only (SQL review B4):
      * Decimal stores as exact TEXT there and text comparison is lexicographic —
@@ -74,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
@@ -464,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";
 } | {
@@ -637,13 +649,18 @@ export declare function excludedRef(params: {
 /** Is this SET cell an {@link ExcludedRef}? */
 export declare function isExcludedRef(value: unknown): value is ExcludedRef;
 /**
- * One RETURNING column: a bare column name renders `"col"`; the object form
- * renders `"col"::text AS "col"` (postgres only) — the `Float[]`/`Json[]`
- * projection rule {@link ColRef.transform} documents, applied to RETURNING.
+ * One RETURNING column: a bare column name renders `"col"`; `castText` renders
+ * 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.
  */
 export type ReturningColumn = string | {
     readonly name: string;
     readonly castText: true;
+} | {
+    readonly name: string;
+    readonly transform: "jsonText";
 };
 /** The column name a {@link ReturningColumn} exposes in the result row. */
 export declare function returningColumnName(column: ReturningColumn): string;

package/dist/codecs.d.ts

@@ -122,6 +122,15 @@ export declare function parseDateTimeText(params: {
 export declare function timeOfDayCodec(params: {
     nativeType: string | undefined;
 }): ScalarCodec | undefined;
+/**
+ * Parse stored JSON text at the centralized codec boundary. A supplied context
+ * marks a bound field: its error contains only that context, never the document
+ * or the native parser cause. Without context, legacy codec errors are unchanged.
+ */
+export declare function parseJsonText(params: {
+    text: string;
+    context?: Readonly<Record<string, unknown>>;
+}): unknown;
 /**
  * The SHORTEST decimal that round-trips through float32 to the same value as
  * `value` — what postgres itself prints for a `real` (`0.1`, `3.4028235e+38`).

package/dist/dialect.d.ts

@@ -198,6 +198,8 @@ export type SqlDialect = {
      * {@link JsonParamCell} cells and the json-filter operands.
      */
     readonly jsonParamCast: string;
+    /** Physical types for standalone validated scalar values, without column inference. */
+    readonly valueCastTypes: Readonly<Record<ScalarType, string>>;
     /**
      * Statement that reads back the id generated by the previous INSERT, for
      * dialects without RETURNING. `null` where RETURNING covers it. The single
@@ -283,6 +285,14 @@ export type SqlDialect = {
     placeholder(params: {
         index: number;
     }): string;
+    /**
+     * Project a JSON document as text while preserving SQL NULL. PostgreSQL
+     * casts to text, MySQL casts to CHAR and SQLite keeps its stored text. The
+     * expression is already rendered SQL, not an identifier or a bound value.
+     */
+    jsonTextProjection(params: {
+        expression: string;
+    }): string;
     /**
      * The database-clock expression for `DbNowMarker` sites: `now()` on
      * postgres, `NOW(6)` on mysql, and on sqlite an ISO-8601 `strftime` whose

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,9 +20,17 @@ 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 { decode } from "./result-decoder.ts";
-export type { ResultDecoder, Decoded, ExtendedDateTime } from "./result-decoder.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";
+export { createReusableSqlQuery, createReusableSqlCommand, isReusableSqlQuery, isReusableSqlCommand, compileReusableSqlQuery, compileReusableSqlCommand } from "./query-plan.ts";
+export { isSqlParam, createSqlInput, sqlInputContract, createSqlInputScope, sealSqlInputScope, assertSqlParamBuilding, sqlParamContract } from "./sql-input.ts";
+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, 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.
  *
@@ -42,10 +51,11 @@ export { tableDefinitionParts } from "./dialects/sqlite-table-definition.ts";
 export { renderPredicate } from "./predicate.ts";
 export type { PredicateModel, PredicateUsage } from "./predicate.ts";
 export { DIALECT_CAPABILITIES, MYSQL_CAPABILITIES, POSTGRES_CAPABILITIES, SQLITE_CAPABILITIES, } from "./capabilities.ts";
-export { DIALECT_CODECS, MYSQL_CODECS, POSTGRES_CODECS, SQLITE_CODECS, decodeIsNoop, enumMembershipCodec, float32Codec, parseDateTimeText, postgresArrayElementFromText, shortestFloat32, timeOfDayCodec, } from "./codecs.ts";
+export { DIALECT_CODECS, MYSQL_CODECS, POSTGRES_CODECS, SQLITE_CODECS, decodeIsNoop, enumMembershipCodec, float32Codec, parseDateTimeText, parseJsonText, postgresArrayElementFromText, shortestFloat32, timeOfDayCodec, } from "./codecs.ts";
 export type { CodecTable, ScalarCodec, WireFidelity } from "./codecs.ts";
 export { renderExpr, renderFragment, renderProjection, renderStatement } from "./render.ts";
 export type { RenderedQuery } from "./render.ts";
+export { snapshotSqlValue } from "./parameter-snapshot.ts";
 export { ParamCollector } from "./params.ts";
 export { NATIVE_RLS, renderRlsColumnType, renderRlsContext, renderRlsDisable, renderRlsDropPolicy, renderRlsEnable, renderRlsForce, renderRlsNoForce, renderRlsPolicy, renderRlsPredicate, renderRlsRole } from "./dialects/postgres-rls.ts";
 export type { RlsContextStatement, RlsDisableStatement, RlsDropPolicyStatement, RlsEnableStatement, RlsForceStatement, RlsNoForceStatement, RlsPolicyStatement, RlsRoleStatement } from "./ast.ts";