uql-orm 0.53.0 → 0.55.0

package/dist/util/string.util.js

@@ -6,14 +6,10 @@ export function kebabCase(val) {
     return resp;
 }
 export function upperFirst(text) {
-    if (!text)
-        return text;
-    return text[0].toUpperCase() + text.slice(1);
+    return text.charAt(0).toUpperCase() + text.slice(1);
 }
 export function lowerFirst(text) {
-    if (!text)
-        return text;
-    return text[0].toLowerCase() + text.slice(1);
+    return text.charAt(0).toLowerCase() + text.slice(1);
 }
 export function snakeCase(val) {
     if (val === null || val === undefined)

package/dist/util/wideNumber.d.ts

@@ -0,0 +1,14 @@
+import type { RawRow } from '../type/index.js';
+/**
+ * A wide number as a JS number where that number is exact, and as its exact decimal text where it is
+ * not - past 2^53, where a number silently rounds. The one rule every driver decodes a BIGINT by, and
+ * hydration a numeric column a driver handed back as text: never a wrong number. `type: BigInt` is the
+ * declared way to a typed exact integer.
+ */
+export declare function decodeWideNumber(value: string | bigint): number | string;
+/**
+ * {@link decodeWideNumber} over every `bigint` cell of a row, for the drivers that hand a BIGINT back
+ * as one (`bun:sql` with `bigint: true`, `mariadb`). In place: the row is the driver's fresh object, and
+ * a copy per row cost more than the decode it carried.
+ */
+export declare function decodeBigInts(row: RawRow): RawRow;

package/dist/util/wideNumber.js

@@ -0,0 +1,24 @@
+/**
+ * A wide number as a JS number where that number is exact, and as its exact decimal text where it is
+ * not - past 2^53, where a number silently rounds. The one rule every driver decodes a BIGINT by, and
+ * hydration a numeric column a driver handed back as text: never a wrong number. `type: BigInt` is the
+ * declared way to a typed exact integer.
+ */
+export function decodeWideNumber(value) {
+    const decoded = Number(value);
+    return Math.abs(decoded) <= Number.MAX_SAFE_INTEGER ? decoded : String(value);
+}
+/**
+ * {@link decodeWideNumber} over every `bigint` cell of a row, for the drivers that hand a BIGINT back
+ * as one (`bun:sql` with `bigint: true`, `mariadb`). In place: the row is the driver's fresh object, and
+ * a copy per row cost more than the decode it carried.
+ */
+export function decodeBigInts(row) {
+    for (const key in row) {
+        const value = row[key];
+        if (typeof value === 'bigint') {
+            row[key] = decodeWideNumber(value);
+        }
+    }
+    return row;
+}

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, SQL Server, Turso, Neon, Cloudflare D1 and MongoDB. Queries are plain JSON, typed to the leaf.",
   "license": "MIT",
-  "version": "0.53.0",
+  "version": "0.55.0",
   "type": "module",
   "engines": {
     "node": ">=24"

package/dist/cockroachdb/crdbQuerier.d.ts

@@ -1,8 +0,0 @@
-import type { PoolClient } from 'pg';
-import { AbstractPgQuerier } from '../postgres/abstractPgQuerier.js';
-import type { CockroachDialect } from './cockroachDialect.js';
-/**
- * Querier for CockroachDB utilizing the standard `pg` PoolClient.
- */
-export declare class CrdbQuerier extends AbstractPgQuerier<PoolClient, CockroachDialect> {
-}

package/dist/cockroachdb/crdbQuerier.js

@@ -1,6 +0,0 @@
-import { AbstractPgQuerier } from '../postgres/abstractPgQuerier.js';
-/**
- * Querier for CockroachDB utilizing the standard `pg` PoolClient.
- */
-export class CrdbQuerier extends AbstractPgQuerier {
-}

package/dist/libsql/libsqlQuerier.d.ts

@@ -1,10 +0,0 @@
-import { HranaQuerier } from '../sqlite/hranaQuerier.js';
-/**
- * Querier for the `@libsql/client` driver.
- *
- * @remarks Empty subclass by design: that client speaks the Hrana protocol, so the whole
- * implementation is inherited. Kept as a distinct type for `LibsqlQuerierPool` and as a hook for
- * future libsql-specific behavior.
- */
-export declare class LibsqlQuerier extends HranaQuerier {
-}

package/dist/libsql/libsqlQuerier.js

@@ -1,10 +0,0 @@
-import { HranaQuerier } from '../sqlite/hranaQuerier.js';
-/**
- * Querier for the `@libsql/client` driver.
- *
- * @remarks Empty subclass by design: that client speaks the Hrana protocol, so the whole
- * implementation is inherited. Kept as a distinct type for `LibsqlQuerierPool` and as a hook for
- * future libsql-specific behavior.
- */
-export class LibsqlQuerier extends HranaQuerier {
-}

package/dist/mongo/mongodbNativeDialect.d.ts

@@ -1,9 +0,0 @@
-import { MongoDialect } from './mongoDialect.js';
-/**
- * MongoDB Dialect specialization for the official `mongodb` driver.
- *
- * @remarks Empty subclass by design: distinct type for `MongodbQuerierPool` and a hook
- * for future driver-specific behavior.
- */
-export declare class MongodbNativeDialect extends MongoDialect {
-}

package/dist/mongo/mongodbNativeDialect.js

@@ -1,9 +0,0 @@
-import { MongoDialect } from './mongoDialect.js';
-/**
- * MongoDB Dialect specialization for the official `mongodb` driver.
- *
- * @remarks Empty subclass by design: distinct type for `MongodbQuerierPool` and a hook
- * for future driver-specific behavior.
- */
-export class MongodbNativeDialect extends MongoDialect {
-}

package/dist/mysql/mysql2Dialect.d.ts

@@ -1,9 +0,0 @@
-import { MySqlDialect } from './mysqlDialect.js';
-/**
- * MySQL Dialect specialization for the `mysql2` driver.
- *
- * @remarks Empty subclass by design: distinct type for `Mysql2QuerierPool` and a place
- * for future mysql2-specific query or capability overrides.
- */
-export declare class MySql2Dialect extends MySqlDialect {
-}

package/dist/mysql/mysql2Dialect.js

@@ -1,9 +0,0 @@
-import { MySqlDialect } from './mysqlDialect.js';
-/**
- * MySQL Dialect specialization for the `mysql2` driver.
- *
- * @remarks Empty subclass by design: distinct type for `Mysql2QuerierPool` and a place
- * for future mysql2-specific query or capability overrides.
- */
-export class MySql2Dialect extends MySqlDialect {
-}

package/dist/neon/neonDialect.d.ts

@@ -1,10 +0,0 @@
-import { PostgresDialect } from '../postgres/postgresDialect.js';
-/**
- * Postgres dialect marker for the `@neondatabase/serverless` driver.
- *
- * @remarks Extends {@link PostgresDialect} with identical defaults (`explicitJsonCast: false`,
- * `nativeArrays: true`, etc.). Kept as a distinct class for `NeonQuerierPool` typing and for
- * Neon-only capability tweaks later without affecting `pg` or Bun pools.
- */
-export declare class NeonDialect extends PostgresDialect {
-}

package/dist/neon/neonDialect.js

@@ -1,10 +0,0 @@
-import { PostgresDialect } from '../postgres/postgresDialect.js';
-/**
- * Postgres dialect marker for the `@neondatabase/serverless` driver.
- *
- * @remarks Extends {@link PostgresDialect} with identical defaults (`explicitJsonCast: false`,
- * `nativeArrays: true`, etc.). Kept as a distinct class for `NeonQuerierPool` typing and for
- * Neon-only capability tweaks later without affecting `pg` or Bun pools.
- */
-export class NeonDialect extends PostgresDialect {
-}

package/dist/neon/neonQuerier.d.ts

@@ -1,5 +0,0 @@
-import type { PoolClient } from '@neondatabase/serverless';
-import { AbstractPgQuerier } from '../postgres/abstractPgQuerier.js';
-import type { PostgresDialect } from '../postgres/postgresDialect.js';
-export declare class NeonQuerier extends AbstractPgQuerier<PoolClient, PostgresDialect> {
-}

package/dist/neon/neonQuerier.js

@@ -1,3 +0,0 @@
-import { AbstractPgQuerier } from '../postgres/abstractPgQuerier.js';
-export class NeonQuerier extends AbstractPgQuerier {
-}

package/dist/pglite/pgliteDialect.d.ts

@@ -1,14 +0,0 @@
-import { PostgresDialect } from '../postgres/postgresDialect.js';
-/**
- * Postgres dialect for PGlite, the WASM Postgres build.
- *
- * @remarks Keeps every {@link PostgresDialect} default, `dialectName` included: PGlite *is* Postgres,
- * so the introspector, schema generator and CLI must all resolve to the Postgres ones. Both driver
- * capabilities are inherited deliberately rather than by omission. `nativeArrays: true` holds because
- * PGlite registers an array serializer for every built-in array type at boot and resolves each
- * parameter's type from a server-side `Describe` before binding; `explicitJsonCast: false` holds
- * because `PgLikeSqlDialect` already emits `$n::jsonb`, which is what makes that `Describe` report
- * JSONB and select PGlite's `JSON.stringify` serializer. A bare `$n` would bind `[object Object]`.
- */
-export declare class PgliteDialect extends PostgresDialect {
-}

package/dist/pglite/pgliteDialect.js

@@ -1,14 +0,0 @@
-import { PostgresDialect } from '../postgres/postgresDialect.js';
-/**
- * Postgres dialect for PGlite, the WASM Postgres build.
- *
- * @remarks Keeps every {@link PostgresDialect} default, `dialectName` included: PGlite *is* Postgres,
- * so the introspector, schema generator and CLI must all resolve to the Postgres ones. Both driver
- * capabilities are inherited deliberately rather than by omission. `nativeArrays: true` holds because
- * PGlite registers an array serializer for every built-in array type at boot and resolves each
- * parameter's type from a server-side `Describe` before binding; `explicitJsonCast: false` holds
- * because `PgLikeSqlDialect` already emits `$n::jsonb`, which is what makes that `Describe` report
- * JSONB and select PGlite's `JSON.stringify` serializer. A bare `$n` would bind `[object Object]`.
- */
-export class PgliteDialect extends PostgresDialect {
-}

package/dist/postgres/abstractPgQuerier.d.ts

@@ -1,24 +0,0 @@
-import type { AbstractSqlDialect } from '../dialect/index.js';
-import { AbstractPoolQuerier } from '../querier/abstractPoolQuerier.js';
-import type { ExtraOptions, RawRow } from '../type/index.js';
-export interface PgAnyClient {
-    query(text: string, values?: unknown[]): Promise<{
-        rows: RawRow[];
-        rowCount: number | null;
-    }>;
-    query(stream: object): AsyncIterable<RawRow> & {
-        destroy(): void;
-    };
-    /** Any truthy argument makes `pg-pool` evict the client instead of returning it to the idle list. */
-    release(discard?: boolean): void | Promise<void>;
-}
-/**
- * Shared base class for Postgres-compatible queriers (standard pg, CockroachDB, Neon).
- */
-export declare abstract class AbstractPgQuerier<C extends PgAnyClient, D extends AbstractSqlDialect> extends AbstractPoolQuerier<C> {
-    constructor(connect: () => Promise<C>, dialect: D, extra?: ExtraOptions);
-    internalAll<T>(query: string, values?: unknown[]): Promise<T[]>;
-    internalRun(query: string, values?: unknown[]): Promise<import("../type/query.js").QueryUpdateResult>;
-    internalStream<T>(query: string, values?: unknown[]): AsyncGenerator<Awaited<T>, void, unknown>;
-    protected releaseConn(conn: C, discard: boolean): Promise<void>;
-}

package/dist/postgres/abstractPgQuerier.js

@@ -1,32 +0,0 @@
-import { AbstractPoolQuerier } from '../querier/abstractPoolQuerier.js';
-/**
- * Shared base class for Postgres-compatible queriers (standard pg, CockroachDB, Neon).
- */
-export class AbstractPgQuerier extends AbstractPoolQuerier {
-    constructor(connect, dialect, extra) {
-        super(dialect, connect, extra);
-    }
-    async internalAll(query, values) {
-        const res = await this.getConn().query(query, values);
-        return res.rows;
-    }
-    async internalRun(query, values) {
-        const res = await this.getConn().query(query, values);
-        return this.buildUpdateResult({ rows: res.rows, changes: res.rowCount ?? 0 });
-    }
-    async *internalStream(query, values) {
-        const { default: QueryStream } = await import('pg-query-stream');
-        const stream = this.getConn().query(new QueryStream(query, values));
-        try {
-            for await (const row of stream) {
-                yield row;
-            }
-        }
-        finally {
-            stream.destroy();
-        }
-    }
-    async releaseConn(conn, discard) {
-        await conn.release(discard);
-    }
-}

package/dist/postgres/pgDialect.d.ts

@@ -1,10 +0,0 @@
-import { PostgresDialect } from './postgresDialect.js';
-/**
- * Postgres dialect for the Node.js `pg` driver.
- *
- * @remarks Uses base {@link PostgresDialect} capabilities: native JS arrays for `ANY` / `ALL`
- * (`nativeArrays: true`) and `$n::jsonb` without a text re-cast. Bun SQL Postgres needs
- * `BunSqlQuerierPool` from `uql-orm/bunSql` instead (wire array literals + text json cast).
- */
-export declare class PgDialect extends PostgresDialect {
-}

package/dist/postgres/pgDialect.js

@@ -1,10 +0,0 @@
-import { PostgresDialect } from './postgresDialect.js';
-/**
- * Postgres dialect for the Node.js `pg` driver.
- *
- * @remarks Uses base {@link PostgresDialect} capabilities: native JS arrays for `ANY` / `ALL`
- * (`nativeArrays: true`) and `$n::jsonb` without a text re-cast. Bun SQL Postgres needs
- * `BunSqlQuerierPool` from `uql-orm/bunSql` instead (wire array literals + text json cast).
- */
-export class PgDialect extends PostgresDialect {
-}

package/dist/turso/tursoQuerier.d.ts

@@ -1,10 +0,0 @@
-import { HranaQuerier } from '../sqlite/hranaQuerier.js';
-/**
- * Querier for remote Turso Cloud databases over `@tursodatabase/serverless/compat`.
- *
- * @remarks Empty subclass by design: that compat client speaks the Hrana protocol, so the whole
- * implementation is inherited. Kept as a distinct type so `TursoQuerierPool` does not expose a
- * libsql-named class.
- */
-export declare class TursoQuerier extends HranaQuerier {
-}

package/dist/turso/tursoQuerier.js

@@ -1,10 +0,0 @@
-import { HranaQuerier } from '../sqlite/hranaQuerier.js';
-/**
- * Querier for remote Turso Cloud databases over `@tursodatabase/serverless/compat`.
- *
- * @remarks Empty subclass by design: that compat client speaks the Hrana protocol, so the whole
- * implementation is inherited. Kept as a distinct type so `TursoQuerierPool` does not expose a
- * libsql-named class.
- */
-export class TursoQuerier extends HranaQuerier {
-}