uql-orm 0.47.1 → 0.48.0

package/dist/util/dialect.util.d.ts

@@ -1,6 +1,13 @@
 import { type CascadeType, type EntityData, type EntityIndexMeta, type EntityMeta, type FieldKey, type FieldOptions, type JsonUpdateOp, type OnFieldCallback, type Query, type QueryAggMap, type QueryAggregateOp, type QueryExclude, type QueryGroupMap, type QueryOptions, QueryRaw, type QuerySearch, type QuerySelect, type QuerySelectValue, type QuerySizeComparisonOps, type QuerySortMap, type QueryVectorSearch, type QueryWhere, type QueryWhereMap, type RelationKey } from '../type/index.js';
 export type CallbackKey = keyof Pick<FieldOptions, 'onInsert' | 'onUpdate'>;
 export declare function filterFieldKeys<E>(meta: EntityMeta<E>, payload: EntityData<E>, callbackKey: CallbackKey): FieldKey<E>[];
+/** Appends `record`'s not-yet-`seen` insertable keys (real, caller-written, defined value) to `keys`. */
+/**
+ * The insertable keys `record` itself carries, as a string, for grouping rows by the statement they
+ * can share. Only the row's own keys: the `onInsert` columns {@link getInsertFieldKeys} appends are a
+ * property of the entity, identical for every row, so they cannot tell two rows apart.
+ */
+export declare function insertShapeOf<E>(meta: EntityMeta<E>, record: EntityData<E>): string;
 /**
  * Resolves the columns of an INSERT statement: the union of the persistable fields provided by
  * any record (in first-seen order), plus every `onInsert` field. Records missing one of these

package/dist/util/dialect.util.js

@@ -16,6 +16,20 @@ function isInsertableField(meta, record, key) {
     return !!field && !isDatabaseWritten(field) && record[key] !== undefined;
 }
 /** Appends `record`'s not-yet-`seen` insertable keys (real, caller-written, defined value) to `keys`. */
+/**
+ * The insertable keys `record` itself carries, as a string, for grouping rows by the statement they
+ * can share. Only the row's own keys: the `onInsert` columns {@link getInsertFieldKeys} appends are a
+ * property of the entity, identical for every row, so they cannot tell two rows apart.
+ */
+export function insertShapeOf(meta, record) {
+    let shape = '';
+    for (const key of getKeys(record)) {
+        if (isInsertableField(meta, record, key)) {
+            shape += `${key},`;
+        }
+    }
+    return shape;
+}
 function addInsertFieldKeys(meta, record, seen, keys) {
     for (const key of getKeys(record)) {
         if (!seen.has(key) && isInsertableField(meta, record, key)) {

package/dist/util/fieldOption.util.d.ts

@@ -34,7 +34,7 @@ declare const FIELD_OPTION_FAMILY: {
     readonly comment: '*';
 };
 /**
- * The only options a `virtual` field reaches: it is skipped in DDL and dropped from every insert and
+ * The only options an inlined computed field reaches: it is skipped in DDL and dropped from every insert and
  * update, so the whole persistence half of the options above is dead on one. Stated as what survives
  * rather than on each option that dies, because it is one fact rather than nineteen - and because an
  * option added without a thought then lands on the safe side of it.

package/dist/util/fieldOption.util.js

@@ -34,7 +34,7 @@ const FIELD_OPTION_FAMILY = {
     comment: '*',
 };
 /**
- * The only options a `virtual` field reaches: it is skipped in DDL and dropped from every insert and
+ * The only options an inlined computed field reaches: it is skipped in DDL and dropped from every insert and
  * update, so the whole persistence half of the options above is dead on one. Stated as what survives
  * rather than on each option that dies, because it is one fact rather than nineteen - and because an
  * option added without a thought then lands on the safe side of it.

package/package.json

@@ -3,7 +3,7 @@
   "homepage": "https://uql-orm.dev",
   "description": "The JSON-native TypeScript ORM for Bun, Browsers, Edge, Deno, Node, Workers. Supports PostgreSQL, PGlite, MySQL, MariaDB, SQLite, CockroachDB, Turso, Neon, Cloudflare D1 and MongoDB. Queries are plain JSON, typed to the leaf.",
   "license": "MIT",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "type": "module",
   "engines": {
     "node": ">=24"