@vibeorm/sql 5.10.0 → 5.11.0

package/dist/key-list.d.ts

@@ -42,6 +42,44 @@ export declare function postgresKeyListElementTypeOf(params: {
 export declare function keyListBindsUntypedRows(params: {
     members: readonly KeyListMember[];
 }): boolean;
+/** How MySQL types a key it reads back from JSON text; see {@link mysqlJsonKeyTypeOf}. */
+export type MysqlJsonKeyType = "text" | "signed" | "unsigned";
+/**
+ * How MySQL turns the text of a key column, read back out of JSON, into a
+ * value its foreign-key column compares with through its index, or
+ * `undefined` for a key type nobody measured. `"text"`: the unquoted JSON
+ * string, compared under the column's collation like a bound literal.
+ * `"signed"` / `"unsigned"`: `CAST(… AS SIGNED | UNSIGNED)`, exact over the
+ * whole 64-bit range (text against a BIGINT column compares as a double).
+ * Dates, decimals, floats, booleans, bytes and enums are not admitted.
+ */
+export declare function mysqlJsonKeyTypeOf(params: {
+    member: KeyListMember;
+}): MysqlJsonKeyType | undefined;
+/**
+ * Does the token of a key read back from JSON (the key's text, written on the
+ * to-one's own row) need a text cast? A key the JSON carries as a number must
+ * travel as text, or a 64-bit integer would reach the client rounded; a MySQL
+ * string key is text already, and `CAST(… AS CHAR)` would convert it to the
+ * CONNECTION's character set, where a `utf8mb3` connection turns every
+ * character outside the BMP into `?` and two keys into one.
+ */
+export declare function jsonKeyTokenCast(params: {
+    dialect: SqlDialect;
+    member: KeyListMember;
+}): boolean;
+/**
+ * Can `dialect` type every one of `members` from its JSON text, as
+ * `SelectStatement.fromJsonKeys` must? PostgreSQL casts the text to the
+ * key-list's base type (not a `DateTime` without a declared native type,
+ * whose column may be a zone-less `timestamp`); MySQL admits the types of
+ * {@link mysqlJsonKeyTypeOf}. The renderer throws for a member this refuses,
+ * so the runtime asks here before it builds a dictionary level.
+ */
+export declare function jsonKeysTyped(params: {
+    dialect: SqlDialect;
+    members: readonly KeyListMember[];
+}): boolean;
 /**
  * The cast after a bulk-insert column's array placeholder (`$n::<cast>[]`),
  * or `undefined` when the column has none and the insert must keep VALUES.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeorm/sql",
-  "version": "5.10.0",
+  "version": "5.11.0",
   "description": "Dialect-aware SQL layer for VibeORM v2 — SQL AST, renderers and capability tables for postgres, sqlite and mysql",
   "keywords": [
     "orm",
@@ -50,7 +50,7 @@
     "bun": ">=1.2.0"
   },
   "dependencies": {
-    "@vibeorm/schema": "^5.10.0"
+    "@vibeorm/schema": "^5.11.0"
   },
   "publishConfig": {
     "access": "public"