uql-orm 0.34.1 → 0.35.0

package/README.md

@@ -7,7 +7,7 @@
   </picture>
 </a>
 
-<h3>The JSON-native TypeScript ORM</h3>
+<h3>The JSON-native ORM</h3>
 
 <p>Queries are plain JSON, typed to the leaf. Unified across SQL databases and MongoDB.</p>
 

package/dist/migrate/builder/expressions.d.ts

@@ -2,7 +2,7 @@
  * SQL Expressions
  *
  * Type-safe SQL expressions for default values and other uses.
- * Provides a `t` helper with common expressions.
+ * Provides an `expr` helper with common expressions.
  */
 /**
  * Represents a raw SQL expression (not a literal value).
@@ -18,11 +18,11 @@ export declare class SqlExpression {
 }
 /**
  * Helper object for common SQL expressions.
- * Use in migrations: `table.timestamp('createdAt').defaultValue(t.now())`
+ * Use in migrations: `t.timestamp('createdAt').defaultValue(expr.now())`
  */
-export declare const t: {
+export declare const expr: {
     /**
-     * Current timestamp (NOW() or CURRENT_TIMESTAMP depending on dialect).
+     * Current timestamp (CURRENT_TIMESTAMP).
      */
     now(): SqlExpression;
     /**
@@ -34,23 +34,11 @@ export declare const t: {
      */
     currentTime(): SqlExpression;
     /**
-     * NULL value.
-     */
-    null(): SqlExpression;
-    /**
-     * Boolean true.
-     */
-    true(): SqlExpression;
-    /**
-     * Boolean false.
-     */
-    false(): SqlExpression;
-    /**
-     * Generate UUID (Postgres: gen_random_uuid(), MySQL: UUID()).
+     * Generate a UUID. Postgres only - use `expr.mysqlUuid()` on MySQL/MariaDB.
      */
     uuid(): SqlExpression;
     /**
-     * Auto-generate UUID for MySQL.
+     * Generate a UUID on MySQL/MariaDB.
      */
     mysqlUuid(): SqlExpression;
     /**
@@ -59,19 +47,11 @@ export declare const t: {
      */
     raw(sql: string): SqlExpression;
     /**
-     * String literal with proper escaping.
-     */
-    literal(value: string): SqlExpression;
-    /**
-     * Numeric literal.
-     */
-    number(value: number): SqlExpression;
-    /**
-     * Empty JSON object.
+     * Empty JSON object. Postgres only - the `::jsonb` cast is not portable.
      */
     emptyObject(): SqlExpression;
     /**
-     * Empty JSON array.
+     * Empty JSON array. Postgres only - the `::jsonb` cast is not portable.
      */
     emptyArray(): SqlExpression;
     /**

package/dist/migrate/builder/expressions.js

@@ -2,7 +2,7 @@
  * SQL Expressions
  *
  * Type-safe SQL expressions for default values and other uses.
- * Provides a `t` helper with common expressions.
+ * Provides an `expr` helper with common expressions.
  */
 /**
  * Represents a raw SQL expression (not a literal value).
@@ -24,11 +24,11 @@ export class SqlExpression {
 }
 /**
  * Helper object for common SQL expressions.
- * Use in migrations: `table.timestamp('createdAt').defaultValue(t.now())`
+ * Use in migrations: `t.timestamp('createdAt').defaultValue(expr.now())`
  */
-export const t = {
+export const expr = {
     /**
-     * Current timestamp (NOW() or CURRENT_TIMESTAMP depending on dialect).
+     * Current timestamp (CURRENT_TIMESTAMP).
      */
     now() {
         return new SqlExpression('CURRENT_TIMESTAMP');
@@ -46,31 +46,13 @@ export const t = {
         return new SqlExpression('CURRENT_TIME');
     },
     /**
-     * NULL value.
-     */
-    null() {
-        return new SqlExpression('NULL');
-    },
-    /**
-     * Boolean true.
-     */
-    true() {
-        return new SqlExpression('TRUE');
-    },
-    /**
-     * Boolean false.
-     */
-    false() {
-        return new SqlExpression('FALSE');
-    },
-    /**
-     * Generate UUID (Postgres: gen_random_uuid(), MySQL: UUID()).
+     * Generate a UUID. Postgres only - use `expr.mysqlUuid()` on MySQL/MariaDB.
      */
     uuid() {
         return new SqlExpression('gen_random_uuid()');
     },
     /**
-     * Auto-generate UUID for MySQL.
+     * Generate a UUID on MySQL/MariaDB.
      */
     mysqlUuid() {
         return new SqlExpression('UUID()');
@@ -83,27 +65,13 @@ export const t = {
         return new SqlExpression(sql);
     },
     /**
-     * String literal with proper escaping.
-     */
-    literal(value) {
-        // Escape single quotes by doubling them
-        const escaped = value.replace(/'/g, "''");
-        return new SqlExpression(`'${escaped}'`);
-    },
-    /**
-     * Numeric literal.
-     */
-    number(value) {
-        return new SqlExpression(String(value));
-    },
-    /**
-     * Empty JSON object.
+     * Empty JSON object. Postgres only - the `::jsonb` cast is not portable.
      */
     emptyObject() {
         return new SqlExpression("'{}'::jsonb");
     },
     /**
-     * Empty JSON array.
+     * Empty JSON array. Postgres only - the `::jsonb` cast is not portable.
      */
     emptyArray() {
         return new SqlExpression("'[]'::jsonb");

package/dist/migrate/builder/tableBuilder.js

@@ -6,7 +6,7 @@
 import { normalizeIndexColumn } from '../../util/index.js';
 import { derivedIndexName } from '../../util/sql.util.js';
 import { ColumnBuilder } from './columnBuilder.js';
-import { t } from './expressions.js';
+import { expr } from './expressions.js';
 /**
  * Builder for table-level foreign keys.
  */
@@ -137,10 +137,10 @@ export class TableBuilder {
         return column;
     }
     createdAt() {
-        return this.add('createdAt', { category: 'timestamp' }, { defaultValue: t.now() });
+        return this.add('createdAt', { category: 'timestamp' }, { defaultValue: expr.now() });
     }
     updatedAt() {
-        return this.add('updatedAt', { category: 'timestamp' }, { defaultValue: t.now() });
+        return this.add('updatedAt', { category: 'timestamp' }, { defaultValue: expr.now() });
     }
     timestamps() {
         this.createdAt();

package/dist/migrate/migrator.d.ts

@@ -198,10 +198,10 @@ export interface BuilderMigrationDefinition {
  * ```ts
  * export default defineBuilderMigration({
  *   async up(m) {
- *     await m.createTable('users', (table) => {
- *       table.id();
- *       table.string('email', 255).unique();
- *       table.timestamps();
+ *     await m.createTable('users', (t) => {
+ *       t.id();
+ *       t.string('email', { length: 255 }).unique();
+ *       t.timestamps();
  *     });
  *   },
  *   async down(m) {

package/dist/migrate/migrator.js

@@ -571,10 +571,10 @@ export function defineMigration(migration) {
  * ```ts
  * export default defineBuilderMigration({
  *   async up(m) {
- *     await m.createTable('users', (table) => {
- *       table.id();
- *       table.string('email', 255).unique();
- *       table.timestamps();
+ *     await m.createTable('users', (t) => {
+ *       t.id();
+ *       t.string('email', { length: 255 }).unique();
+ *       t.timestamps();
  *     });
  *   },
  *   async down(m) {

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "uql-orm",
   "homepage": "https://uql-orm.dev",
-  "description": "JSON-native TypeScript ORM for Node.js, Bun and Deno. Supports PostgreSQL, PGlite, MySQL, MariaDB, SQLite, CockroachDB, Turso, Neon, Cloudflare D1 and MongoDB. Queries are plain JSON, typed to the leaf.",
+  "description": "JSON-native ORM for Node.js, Bun and Deno. 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.34.1",
+  "version": "0.35.0",
   "type": "module",
   "engines": {
     "node": ">=24"