@vibeorm/sql 3.0.0 → 4.0.0

package/dist/ast.d.ts

@@ -16,7 +16,10 @@ export type ColRef = {
     readonly table?: string;
     readonly name: string;
     /**
-     * Projection-only wire transform, postgres only. `castText` renders
+     * 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
@@ -26,7 +29,7 @@ export type ColRef = {
      * 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 —
@@ -637,13 +640,17 @@ 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
+ * `"col"::text AS "col"` (postgres only) for `Float[]`/`Json[]`. `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/index.d.ts

@@ -20,8 +20,15 @@ export { renderSqliteFtsUpdateTrigger, sqliteFtsUpdateUpgrade } from "./dialects
 export { SQLITE_SESSION_SQL } from "./dialects/sqlite-session.ts";
 export { sql, isSqlFragment, renderSqlFragment, compileSql, sqlUsesIncoming, mapConflictColumns } from "./composable.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 } 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 +49,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";