uql-orm 0.20.2 → 0.22.0

package/README.md

@@ -1,141 +1,78 @@
-<!-- ![code](/assets/code.webp 'code') -->
+<div align="center">
 
-<picture>
-  <source srcset="assets/logo-dark.svg" media="(prefers-color-scheme: dark)">
-  <a href="https://uql-orm.dev"><img src="assets/logo.svg" alt="uql" width="80" /></a>
-</picture>
+<a href="https://uql-orm.dev">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/rogerpadilla/uql/main/assets/logo-dark.svg">
+    <img src="https://raw.githubusercontent.com/rogerpadilla/uql/main/assets/logo.svg" alt="UQL" width="90">
+  </picture>
+</a>
 
-[![tests](https://github.com/rogerpadilla/uql/actions/workflows/tests.yml/badge.svg)](https://github.com/rogerpadilla/uql/actions/workflows/tests.yml) [![Coverage Status](https://coveralls.io/repos/github/rogerpadilla/uql/badge.svg?branch=main)](https://coveralls.io/github/rogerpadilla/uql?branch=main) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/rogerpadilla/uql/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/uql-orm.svg)](https://www.npmjs.com/package/uql-orm)
+<h3>The smartest TypeScript ORM</h3>
 
-**[UQL](https://uql-orm.dev)** is the perfectionist ORM: serializable queries, no codegen, and one API across PostgreSQL, MySQL, SQLite, MariaDB, and MongoDB. Define entities once, query everywhere.
+<p>Type-safe to the leaf, serializable queries, no codegen, <a href="https://uql-orm.dev/benchmark">extremely fast</a>, and unified API across Postgres, CockroachDB, MySQL, SQLite, MongoDB, MariaDB, and the edge.</p>
 
-<!-- DEMO: Record an animated GIF showing IDE autocompletion for $select/$populate/$where and embed here. Example: ![demo](/assets/demo.gif) -->
+<p>
+  <a href="https://uql-orm.dev"><b>Website</b></a> ·
+  <a href="https://uql-orm.dev/getting-started">Quick Start</a> ·
+  <a href="https://uql-orm.dev/benchmark">Benchmark</a> ·
+  <a href="https://uql-orm.dev/comparison">Compare ORMs</a> ·
+  <a href="https://uql-orm.dev/blog/in-search-of-the-perfect-orm">Blog</a>
+</p>
 
-```ts
-await querier.findMany(User, {
-  $select: { id: true, email: true },
-  $where: { email: { $endsWith: '@uql-orm.dev' } },
-  $limit: 10,
-});
-```
+[![tests](https://github.com/rogerpadilla/uql/actions/workflows/tests.yml/badge.svg)](https://github.com/rogerpadilla/uql/actions/workflows/tests.yml)
+[![Coverage Status](https://coveralls.io/repos/github/rogerpadilla/uql/badge.svg?branch=main)](https://coveralls.io/github/rogerpadilla/uql?branch=main)
+[![npm version](https://img.shields.io/npm/v/uql-orm.svg)](https://www.npmjs.com/package/uql-orm)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/rogerpadilla/uql/blob/main/LICENSE.md)
 
-Full docs: **[uql-orm.dev](https://uql-orm.dev)**
+</div>
 
 ---
 
-## Why UQL?
-
-- **Queries are data, not method chains.** A UQL query is a plain JSON object. Build them dynamically, store them, or send them from client to server without a DSL.
-- **No codegen, no build step.** Entities are TypeScript classes, so your code *is* the schema. No `.prisma` files or generated clients to keep in sync.
-- **One API everywhere.** The same syntax runs on PostgreSQL, MySQL, MariaDB, SQLite, LibSQL, Neon, Cloudflare D1, MongoDB, and Bun's native SQL.
-- **Fast by design.** Fastest in [all 8 categories](https://uql-orm.dev/benchmark) of our [open benchmark](https://github.com/rogerpadilla/ts-orm-benchmark): on average ~2.1× faster than the runner-up, reaching over 3.9M ops/s on SELECTs.
-
-## Features
-
-| Feature | Docs |
-| :--- | :--- |
-| Unified API across SQL + MongoDB | [Install](https://uql-orm.dev/getting-started) |
-| Type-safe queries with autocomplete | [Querying](https://uql-orm.dev/querying/querier) |
-| Entity-first migrations & autoSync | [Migrations](https://uql-orm.dev/migrations) |
-| Soft-delete, lifecycle hooks, relations | [Entities](https://uql-orm.dev/entities/basic) |
-| Query filters, multi-tenancy & row-level security | [Filters](https://uql-orm.dev/querying/filters) · [Multi-tenancy](https://uql-orm.dev/multi-tenancy) |
-| Aggregate queries, grouping, HAVING | [Aggregate](https://uql-orm.dev/querying/aggregate) |
-| Batch inserts with reliable IDs on every database | [Insert IDs](https://uql-orm.dev/querying/querier#insert-ids) |
-| Semantic search & vector similarity | [Semantic Search](https://uql-orm.dev/ai-semantic-search) |
-| Parallel reads & raw SQL on the pool | [Parallel reads](https://uql-orm.dev/querying/querier#parallel-reads-on-the-pool) · [Raw SQL](https://uql-orm.dev/querying/raw-sql) |
-| Streaming, transactions | [Streaming](https://uql-orm.dev/querying/streaming) · [Transactions](https://uql-orm.dev/querying/transactions) |
-| REST API from your entities (any framework) | [HTTP](https://uql-orm.dev/extensions-http) |
-| Typed browser client, NestJS module | [Browser](https://uql-orm.dev/extensions-browser) · [NestJS](https://uql-orm.dev/nestjs) |
-
-## Install
-
 ```sh
-npm install uql-orm pg   # or mysql2, mariadb, better-sqlite3, mongodb, @libsql/client
-```
-
-Supports PostgreSQL, MySQL, MariaDB, SQLite, CockroachDB, LibSQL/Turso, Neon, MongoDB, Cloudflare D1, and Bun SQL.
-
-## Define Entities
-
-[Declare](https://uql-orm.dev/entities/basic) your classes with decorators. UQL uses this metadata for type-safe querying and DDL generation.
-
-```ts
-import { v7 as uuidv7 } from 'uuid';
-import { Entity, Id, Field, OneToOne, OneToMany, type Relation } from 'uql-orm';
-
-@Entity()
-export class User {
-  @Id({ type: 'uuid', onInsert: uuidv7 })
-  id?: string;
-
-  @Field({ index: true, unique: true })
-  email?: string;
-
-  @OneToOne({ entity: () => Profile, mappedBy: (p) => p.user, cascade: true })
-  profile?: Relation<Profile>;
-
-  @OneToMany({ entity: () => Post, mappedBy: (p) => p.author })
-  posts?: Relation<Post>[];
-}
+npm install uql-orm pg   # or mysql2, mariadb, better-sqlite3, mongodb, @tursodatabase/serverless, @libsql/client
 ```
 
-> **Imperative API:** `defineEntity(User, { fields: { id: { type: 'uuid', isId: true } }, ... })`. No decorators needed. See [Imperative Definition](https://uql-orm.dev/entities/imperative).
-
-## Querying
+Decorators also need `reflect-metadata` ([setup](https://uql-orm.dev/getting-started)); the
+[imperative API](https://uql-orm.dev/entities/imperative) needs nothing extra.
 
 ```ts
 await querier.findMany(User, {
-  $select: { id: true, name: true },
+  $select: { id: true, email: true },
+  $populate: { posts: { $select: { title: true } } },
   $where: { email: { $endsWith: '@uql-orm.dev' } },
   $limit: 10,
 });
 ```
 
-25+ comparison operators (`$eq`, `$in`, `$between`, `$like`, `$elemMatch`), logical operators (`$and`, `$or`, `$not`, `$nor`), and type-safe JSON/JSONB dot-notation queries. Operators are gated per field type - string operators require string fields, ordering operators comparable fields, array operators array fields - and JSON dot-paths on typed `Json<T>` fields resolve each path's value type, so `{ age: { $like: 'x' } }` or a typo'd path is a compile error, not a runtime surprise.
-
-Independent reads run directly on the pool - each call gets its own connection, so `Promise.all` fans out in parallel:
-
-```ts
-const [users, total] = await Promise.all([
-  pool.findMany(User, { $where: { status: 'active' } }),
-  pool.count(User),
-]);
-```
-
-> [Querying](https://uql-orm.dev/querying/querier) · [Parallel reads](https://uql-orm.dev/querying/querier#parallel-reads-on-the-pool) · [Operators](https://uql-orm.dev/querying/comparison-operators) · [JSON](https://uql-orm.dev/querying/json)
+That query is a serializable value. Build it dynamically, store it, diff it, or send it
+from the browser to the server. The same object runs on every supported database.
 
-## Transactions
-
-Functional `pool.transaction()` or `@Transactional()` decorator with centralized serialization:
-
-```ts
-const userId = await pool.transaction(async (q) => {
-  const id = await q.insertOne(User, { email: 'a@b.com' });
-  await q.insertOne(Profile, { userId: id, bio: '...' });
-  return id;
-});
-```
-
-## Migrations
+## Why UQL?
 
-Entity-first migrations: modify TypeScript classes, UQL auto-generates DDL by diffing code against the live database:
+- **The fastest.** Wins [all 8 categories](https://uql-orm.dev/benchmark) of our [open benchmark](https://github.com/rogerpadilla/ts-orm-benchmark), beating even query builders like Knex and Kysely: ~2.3× faster than the runner-up on average, close to 4M ops/s on simple SELECTs.
+- **Light.** Zero dependencies, under 1 MB installed, every dialect included.
+- **Queries are data, not method chains.** Plain JSON in, typed rows out. There's no DSL to learn and nothing to compile.
+- **Type-safe to the leaf.** Operators are gated per field type, and JSON/JSONB dot-paths resolve each path's value type, so `{ age: { $like: 'x' } }` or a typo'd path is a compile error instead of a runtime surprise.
+- **No codegen.** Entities are TypeScript classes, so your code *is* the schema. No `.prisma` file to regenerate, no generated client to keep in sync.
+- **One API everywhere.** PostgreSQL, CockroachDB, MySQL, MariaDB, SQLite, Turso, LibSQL, Neon, Cloudflare D1, Bun SQL, and MongoDB.
+- **First ORM with a native Turso driver.** Turso Cloud over pure `fetch()` with zero native dependencies, so it runs on Cloudflare Workers and Vercel Edge, plus the embedded Rust engine for local-first apps.
+- **The hard things are built in.** [Semantic and vector search](https://uql-orm.dev/ai-semantic-search), [non-bypassable multi-tenant filters](https://uql-orm.dev/multi-tenancy), [entity-first migrations](https://uql-orm.dev/migrations), [soft-delete with restore](https://uql-orm.dev/entities/soft-delete), [streaming](https://uql-orm.dev/querying/streaming), and [a REST API from your entities](https://uql-orm.dev/extensions-http).
 
-```bash
-npx uql-migrate generate:entities add_user_nickname   # generate from entities
-npx uql-migrate up                                      # apply
-npx uql-migrate drift:check                             # detect drift
-```
+## Get started
 
-Safe `autoSync()` mode adds new tables/columns and blocks destructive changes in development.
+**[uql-orm.dev](https://uql-orm.dev)** has the full docs. Good places to start:
 
-> [Migrations](https://uql-orm.dev/migrations)
+- [Quick Start](https://uql-orm.dev/getting-started) - install, define an entity, run a query
+- [Querying](https://uql-orm.dev/querying/querier) - operators, relations, aggregates, transactions
+- [Entities](https://uql-orm.dev/entities/basic) - decorators, relations, hooks, or the decorator-free [imperative API](https://uql-orm.dev/entities/imperative)
+- [Switching to UQL](https://uql-orm.dev/switching-to-uql) - coming from Prisma, Drizzle, TypeORM, or MikroORM
 
----
+Release notes live in [CHANGELOG.md](https://github.com/rogerpadilla/uql/blob/main/CHANGELOG.md).
 
 ## Made with UQL
 
-### [Variability.ai](https://variability.ai)
+**[Variability.ai](https://variability.ai)** - AI meeting recorder and video summarizer for Zoom, Meet, and Teams. Instant summaries with action items in 45+ languages.
 
-AI meeting recorder and video summarizer for Zoom, Meet, Teams, and more. Generates instant summaries with action items in 45+ languages.
+Built something? [Open a PR](https://github.com/rogerpadilla/uql/blob/main/CONTRIBUTING.md) and add it here.
 
-[![Made with UQL](https://img.shields.io/badge/made%20with-UQL-6e6e6e?style=flat)](https://uql-orm.dev)
+[![Made with UQL](https://img.shields.io/badge/made%20with-UQL-4F46E5?style=flat)](https://uql-orm.dev)

package/dist/browser/http/bus.d.ts

@@ -1,4 +1,3 @@
 import type { RequestCallback, RequestNotification } from '../type/index.js';
 export declare function notify(notification: RequestNotification): void;
 export declare function on(cb: RequestCallback): () => void;
-//# sourceMappingURL=bus.d.ts.map

package/dist/browser/http/bus.js

@@ -11,4 +11,3 @@ export function on(cb) {
         subscriptors.splice(index, 1);
     };
 }
-//# sourceMappingURL=bus.js.map

package/dist/browser/http/http.d.ts

@@ -19,4 +19,3 @@ export declare function remove<T>(url: string, opts?: RequestOptions): Promise<R
  * (fetch only normalizes the classic verbs).
  */
 export declare function query<T>(url: string, payload: unknown, opts?: RequestOptions): Promise<RequestSuccessResponse<T>>;
-//# sourceMappingURL=http.d.ts.map

package/dist/browser/http/http.js

@@ -67,4 +67,3 @@ function request(url, init, opts) {
         notify({ phase: 'complete', opts });
     });
 }
-//# sourceMappingURL=http.js.map

package/dist/browser/http/index.d.ts

@@ -1,3 +1,2 @@
 export * from './bus.js';
 export * from './http.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/browser/http/index.js

@@ -1,3 +1,2 @@
 export * from './bus.js';
 export * from './http.js';
-//# sourceMappingURL=index.js.map

package/dist/browser/index.d.ts

@@ -2,4 +2,3 @@ export * from './http/index.js';
 export * from './options.js';
 export * from './querier/index.js';
 export * from './type/index.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.js

@@ -2,4 +2,3 @@ export * from './http/index.js';
 export * from './options.js';
 export * from './querier/index.js';
 export * from './type/index.js';
-//# sourceMappingURL=index.js.map

package/dist/browser/options.d.ts

@@ -2,4 +2,3 @@ import type { ClientQuerier, ClientQuerierPool } from './type/index.js';
 export declare function setQuerierPool<T extends ClientQuerierPool>(pool: T): void;
 export declare function getQuerierPool(): ClientQuerierPool;
 export declare function getQuerier(): ClientQuerier;
-//# sourceMappingURL=options.d.ts.map

package/dist/browser/options.js

@@ -11,4 +11,3 @@ export function getQuerierPool() {
 export function getQuerier() {
     return getQuerierPool().getQuerier();
 }
-//# sourceMappingURL=options.js.map

package/dist/browser/querier/httpQuerier.d.ts

@@ -35,4 +35,3 @@ export declare class HttpQuerier implements ClientQuerier {
     protected read<T>(path: string, q: Record<string, unknown> | undefined, opts?: RequestOptions): Promise<RequestSuccessResponse<T>>;
     protected buildOptions(opts?: RequestOptions): RequestOptions | undefined;
 }
-//# sourceMappingURL=httpQuerier.d.ts.map

package/dist/browser/querier/httpQuerier.js

@@ -84,4 +84,3 @@ export class HttpQuerier {
         return { ...opts, headers: { ...this.defaults.headers, ...opts?.headers } };
     }
 }
-//# sourceMappingURL=httpQuerier.js.map

package/dist/browser/querier/index.d.ts

@@ -1,2 +1 @@
 export * from './httpQuerier.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/browser/querier/index.js

@@ -1,2 +1 @@
 export * from './httpQuerier.js';
-//# sourceMappingURL=index.js.map

package/dist/browser/type/clientQuerier.d.ts

@@ -25,4 +25,3 @@ export interface ClientQuerier {
     deleteOneById<E extends object>(entity: Type<E>, id: IdValue<E>, opts?: QueryOptions & RequestOptions): Promise<RequestSuccessResponse<number>>;
     deleteMany<E extends object>(entity: Type<E>, qm: QuerySearch<E>, opts?: QueryOptions & RequestOptions): Promise<RequestSuccessResponse<number>>;
 }
-//# sourceMappingURL=clientQuerier.d.ts.map

package/dist/browser/type/clientQuerier.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=clientQuerier.js.map

package/dist/browser/type/clientQuerierPool.d.ts

@@ -2,4 +2,3 @@ import type { ClientQuerier } from './clientQuerier.js';
 export type ClientQuerierPool = {
     getQuerier(): ClientQuerier;
 };
-//# sourceMappingURL=clientQuerierPool.d.ts.map

package/dist/browser/type/clientQuerierPool.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=clientQuerierPool.js.map

package/dist/browser/type/index.d.ts

@@ -1,4 +1,3 @@
 export * from './clientQuerier.js';
 export * from './clientQuerierPool.js';
 export * from './request.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/browser/type/index.js

@@ -1,4 +1,3 @@
 export * from './clientQuerier.js';
 export * from './clientQuerierPool.js';
 export * from './request.js';
-//# sourceMappingURL=index.js.map

package/dist/browser/type/request.d.ts

@@ -25,4 +25,3 @@ type RequestErrorNotification = {
 export type RequestNotification = RequestSuccessNotification | RequestErrorNotification;
 export type RequestCallback = (msg: RequestNotification) => void;
 export {};
-//# sourceMappingURL=request.d.ts.map

package/dist/browser/type/request.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=request.js.map

package/dist/browser/uql-browser.min.js

@@ -1,4 +1,4 @@
-var H=[];function I(Q){for(let V of H)V(Q)}function S(Q){H.push(Q);let V=H.length-1;return()=>{H.splice(V,1)}}class Y extends Error{status;constructor(Q,V){super(Q);this.status=V;this.name="RequestError"}}function M(Q,V){return x(Q,{method:"get"},V)}function A(Q,V,B){let X=JSON.stringify(V);return x(Q,{method:"post",body:X},B)}function N(Q,V,B){let X=JSON.stringify(V);return x(Q,{method:"patch",body:X},B)}function J(Q,V,B){let X=JSON.stringify(V);return x(Q,{method:"put",body:X},B)}function L(Q,V){return x(Q,{method:"delete"},V)}function K(Q,V,B){let X=JSON.stringify(V);return x(Q,{method:"QUERY",body:X},B)}function x(Q,V,B){if(I({phase:"start",opts:B}),V.headers={accept:"application/json","content-type":"application/json",...B?.headers},B?.signal)V.signal=B.signal;return fetch(Q,V).then((X)=>X.json().then((Z)=>{if(X.status>=200&&X.status<300)return I({phase:"success",opts:B}),Z;let C=Z,z={message:C?.error?.message??X.statusText,code:C?.error?.code??X.status};throw I({phase:"error",error:z,opts:B}),new Y(z.message,z.code)})).finally(()=>{I({phase:"complete",opts:B})})}function W(Q){return Q?Object.keys(Q):[]}function T(Q){let V=Q.charAt(0).toLowerCase();for(let B=1;B<Q.length;++B)V+=Q[B]===Q[B].toUpperCase()?"-"+Q[B].toLowerCase():Q[B];return V}var $={findMany:{method:"GET",path:""},findOne:{method:"GET",path:"/one"},count:{method:"GET",path:"/count"},findOneById:{method:"GET",path:"/:id"},insertOne:{method:"POST",path:""},insertMany:{method:"POST",path:"/many"},saveOne:{method:"PUT",path:""},saveMany:{method:"PUT",path:"/many"},updateMany:{method:"PATCH",path:""},updateOneById:{method:"PATCH",path:"/:id"},deleteOneById:{method:"DELETE",path:"/:id"},deleteMany:{method:"DELETE",path:""}},k=W($),v=new Map(k.filter((Q)=>$[Q].method==="GET"&&$[Q].path!=="/:id").map((Q)=>[$[Q].path,Q]));function D(Q){return T(Q.name)}var _=["$select","$populate","$exclude","$where","$sort"],u=new Set([..._,"$skip","$limit","hardDelete","count"]);function G(Q){if(!Q)return"";let V=new URLSearchParams;for(let X of W(Q)){let Z=Q[X];if(Z===void 0)continue;V.append(X,typeof Z==="object"&&Z!==null?JSON.stringify(Z):String(Z))}let B=V.toString();return B?`?${B}`:""}class f{basePath;defaults;constructor(Q,V={}){this.basePath=Q;this.defaults=V}findOneById(Q,V,B,X){let Z=this.getBasePath(Q),F=G(B);return M(`${Z}/${V}${F}`,this.buildOptions(X))}findOne(Q,V,B){return this.read(`${this.getBasePath(Q)}${$.findOne.path}`,V,B)}findMany(Q,V,B){let X={...V};if(B?.count)X.count=!0;return this.read(this.getBasePath(Q),X,B)}async findManyAndCount(Q,V,B){let X=await this.findMany(Q,V,{...B,count:!0});if(typeof X.count!=="number")throw TypeError("findManyAndCount response has an invalid count");return{...X,count:X.count}}count(Q,V,B){return this.read(`${this.getBasePath(Q)}${$.count.path}`,V,B)}insertOne(Q,V,B){let X=this.getBasePath(Q);return A(X,V,this.buildOptions(B))}insertMany(Q,V,B){let X=this.getBasePath(Q);return A(`${X}${$.insertMany.path}`,V,this.buildOptions(B))}updateOneById(Q,V,B,X){let Z=this.getBasePath(Q);return N(`${Z}/${V}`,B,this.buildOptions(X))}updateMany(Q,V,B,X){let Z=this.getBasePath(Q),F=G(V);return N(`${Z}${F}`,B,this.buildOptions(X))}saveOne(Q,V,B){let X=this.getBasePath(Q);return J(X,V,this.buildOptions(B))}saveMany(Q,V,B){let X=this.getBasePath(Q);return J(`${X}${$.saveMany.path}`,V,this.buildOptions(B))}deleteOneById(Q,V,B={}){let X=this.getBasePath(Q),Z=B.hardDelete?G({hardDelete:B.hardDelete}):"";return L(`${X}/${V}${Z}`,this.buildOptions(B))}deleteMany(Q,V,B={}){let X=this.getBasePath(Q),Z=G(B.hardDelete?{...V,hardDelete:B.hardDelete}:V);return L(`${X}${Z}`,this.buildOptions(B))}getBasePath(Q){return`${this.basePath}/${D(Q)}`}read(Q,V,B){if(this.defaults.readMethod==="QUERY")return K(Q,V??{},this.buildOptions(B));return M(`${Q}${G(V)}`,this.buildOptions(B))}buildOptions(Q){if(!this.defaults.headers&&!Q?.headers)return Q;return{...Q,headers:{...this.defaults.headers,...Q?.headers}}}}var P={getQuerier:()=>new f("/api")};function r(Q){P=Q}function c(){return P}function s(){return c().getQuerier()}export{r as setQuerierPool,L as remove,K as query,J as put,A as post,N as patch,S as on,I as notify,c as getQuerierPool,s as getQuerier,M as get,Y as RequestError,f as HttpQuerier};
+var W=[];function F(B){for(let V of W)V(B)}function g(B){W.push(B);let V=W.length-1;return()=>{W.splice(V,1)}}class f extends Error{status;constructor(B,V){super(B);this.status=V;this.name="RequestError"}}function Q(B,V){return G(B,{method:"get"},V)}function N(B,V,I){let X=JSON.stringify(V);return G(B,{method:"post",body:X},I)}function J(B,V,I){let X=JSON.stringify(V);return G(B,{method:"patch",body:X},I)}function L(B,V,I){let X=JSON.stringify(V);return G(B,{method:"put",body:X},I)}function x(B,V){return G(B,{method:"delete"},V)}function T(B,V,I){let X=JSON.stringify(V);return G(B,{method:"QUERY",body:X},I)}function G(B,V,I){if(F({phase:"start",opts:I}),V.headers={accept:"application/json","content-type":"application/json",...I?.headers},I?.signal)V.signal=I.signal;return fetch(B,V).then((X)=>X.json().then((Z)=>{if(X.status>=200&&X.status<300)return F({phase:"success",opts:I}),Z;let Y=Z,M={message:Y?.error?.message??X.statusText,code:Y?.error?.code??X.status};throw F({phase:"error",error:M,opts:I}),new f(M.message,M.code)})).finally(()=>{F({phase:"complete",opts:I})})}function z(B){return B?Object.keys(B):[]}function K(B){let V=B.charAt(0).toLowerCase();for(let I=1;I<B.length;++I)V+=B[I]===B[I].toUpperCase()?"-"+B[I].toLowerCase():B[I];return V}var $={findMany:{method:"GET",path:""},findOne:{method:"GET",path:"/one"},count:{method:"GET",path:"/count"},findOneById:{method:"GET",path:"/:id"},insertOne:{method:"POST",path:""},insertMany:{method:"POST",path:"/many"},saveOne:{method:"PUT",path:""},saveMany:{method:"PUT",path:"/many"},updateMany:{method:"PATCH",path:""},updateOneById:{method:"PATCH",path:"/:id"},deleteOneById:{method:"DELETE",path:"/:id"},deleteMany:{method:"DELETE",path:""}},P=z($),b=new Map(P.filter((B)=>$[B].method==="GET"&&$[B].path!=="/:id").map((B)=>[$[B].path,B]));function k(B){return K(B.name)}var c=["$select","$populate","$exclude","$where","$sort"],v=new Set([...c,"$skip","$limit","hardDelete","count"]);function A(B){if(!B)return"";let V=new URLSearchParams;for(let X of z(B)){let Z=B[X];if(Z===void 0)continue;V.append(X,typeof Z==="object"&&Z!==null?JSON.stringify(Z):String(Z))}let I=V.toString();return I?`?${I}`:""}class C{basePath;defaults;constructor(B,V={}){this.basePath=B;this.defaults=V}findOneById(B,V,I,X){let Z=this.getBasePath(B),H=A(I);return Q(`${Z}/${V}${H}`,this.buildOptions(X))}findOne(B,V,I){return this.read(`${this.getBasePath(B)}${$.findOne.path}`,V,I)}findMany(B,V,I){let X={...V};if(I?.count)X.count=!0;return this.read(this.getBasePath(B),X,I)}async findManyAndCount(B,V,I){let X=await this.findMany(B,V,{...I,count:!0});if(typeof X.count!=="number")throw TypeError("findManyAndCount response has an invalid count");return{...X,count:X.count}}count(B,V,I){return this.read(`${this.getBasePath(B)}${$.count.path}`,V,I)}insertOne(B,V,I){let X=this.getBasePath(B);return N(X,V,this.buildOptions(I))}insertMany(B,V,I){let X=this.getBasePath(B);return N(`${X}${$.insertMany.path}`,V,this.buildOptions(I))}updateOneById(B,V,I,X){let Z=this.getBasePath(B);return J(`${Z}/${V}`,I,this.buildOptions(X))}updateMany(B,V,I,X){let Z=this.getBasePath(B),H=A(V);return J(`${Z}${H}`,I,this.buildOptions(X))}saveOne(B,V,I){let X=this.getBasePath(B);return L(X,V,this.buildOptions(I))}saveMany(B,V,I){let X=this.getBasePath(B);return L(`${X}${$.saveMany.path}`,V,this.buildOptions(I))}deleteOneById(B,V,I={}){let X=this.getBasePath(B),Z=I.hardDelete?A({hardDelete:I.hardDelete}):"";return x(`${X}/${V}${Z}`,this.buildOptions(I))}deleteMany(B,V,I={}){let X=this.getBasePath(B),Z=A(I.hardDelete?{...V,hardDelete:I.hardDelete}:V);return x(`${X}${Z}`,this.buildOptions(I))}getBasePath(B){return`${this.basePath}/${k(B)}`}read(B,V,I){if(this.defaults.readMethod==="QUERY")return T(B,V??{},this.buildOptions(I));return Q(`${B}${A(V)}`,this.buildOptions(I))}buildOptions(B){if(!this.defaults.headers&&!B?.headers)return B;return{...B,headers:{...this.defaults.headers,...B?.headers}}}}var D={getQuerier:()=>new C("/api")};function y(B){D=B}function _(){return D}function p(){return _().getQuerier()}export{y as setQuerierPool,x as remove,T as query,L as put,N as post,J as patch,g as on,F as notify,_ as getQuerierPool,p as getQuerier,Q as get,f as RequestError,C as HttpQuerier};
 
-//# debugId=0AC20FD4BEDEBDE564756E2164756E21
+//# debugId=89C8E712B5A364FC64756E2164756E21
 //# sourceMappingURL=uql-browser.min.js.map

package/dist/browser/uql-browser.min.js.map

@@ -12,6 +12,6 @@
     "import { HttpQuerier } from './querier/httpQuerier.js';\nimport type { ClientQuerier, ClientQuerierPool } from './type/index.js';\n\nlet defaultPool: ClientQuerierPool = {\n  getQuerier: () => new HttpQuerier('/api'),\n};\n\nexport function setQuerierPool<T extends ClientQuerierPool>(pool: T) {\n  defaultPool = pool;\n}\n\nexport function getQuerierPool(): ClientQuerierPool {\n  return defaultPool;\n}\n\nexport function getQuerier(): ClientQuerier {\n  return getQuerierPool().getQuerier();\n}\n"
   ],
   "mappings": "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",
-  "debugId": "0AC20FD4BEDEBDE564756E2164756E21",
+  "debugId": "89C8E712B5A364FC64756E2164756E21",
   "names": []
 }

package/dist/bunSql/bunSql.util.d.ts

@@ -27,4 +27,3 @@ export declare function normalizeRows<T>(res: BunSqlResult<T>): T[];
  * Handles BigInt-to-number coercion for cross-dialect consistency.
  */
 export declare function getInsertId(res: BunSqlResult): PrimaryKey | undefined;
-//# sourceMappingURL=bunSql.util.d.ts.map

package/dist/bunSql/bunSql.util.js

@@ -98,4 +98,3 @@ export function normalizeRows(res) {
 export function getInsertId(res) {
     return typeof res.lastInsertRowid === 'bigint' ? Number(res.lastInsertRowid) : res.lastInsertRowid;
 }
-//# sourceMappingURL=bunSql.util.js.map

package/dist/bunSql/bunSqlCockroachDialect.d.ts

@@ -1,5 +1,5 @@
 import { CockroachDialect } from '../cockroachdb/cockroachDialect.js';
-import type { DialectOptions } from '../dialect/abstractDialect.js';
+import type { DialectFeatures } from '../type/index.js';
 /**
  * CockroachDB Dialect specialization for the `bun:sql` driver, which routes CockroachDB
  * connections through its own Postgres wire-protocol implementation (see
@@ -8,6 +8,5 @@ import type { DialectOptions } from '../dialect/abstractDialect.js';
  * (verified directly against a live CockroachDB instance via `bun:sql`).
  */
 export declare class BunSqlCockroachDialect extends CockroachDialect {
-    constructor(options?: DialectOptions);
+    protected readonly featureOverrides: Partial<DialectFeatures>;
 }
-//# sourceMappingURL=bunSqlCockroachDialect.d.ts.map

package/dist/bunSql/bunSqlCockroachDialect.js

@@ -8,15 +8,8 @@ import { POSTGRES_WIRE_DRIVER_CAPABILITIES } from '../postgres/postgresWireDrive
  * (verified directly against a live CockroachDB instance via `bun:sql`).
  */
 export class BunSqlCockroachDialect extends CockroachDialect {
-    constructor(options = {}) {
-        super({
-            ...options,
-            driverCapabilities: {
-                ...POSTGRES_WIRE_DRIVER_CAPABILITIES,
-                explicitJsonCast: true,
-                ...options.driverCapabilities,
-            },
-        });
-    }
+    featureOverrides = {
+        ...POSTGRES_WIRE_DRIVER_CAPABILITIES,
+        explicitJsonCast: true,
+    };
 }
-//# sourceMappingURL=bunSqlCockroachDialect.js.map

package/dist/bunSql/bunSqlPostgresDialect.d.ts

@@ -1,5 +1,5 @@
-import type { DialectOptions } from '../dialect/abstractDialect.js';
 import { PostgresDialect } from '../postgres/postgresDialect.js';
+import type { DialectFeatures } from '../type/index.js';
 /**
  * Postgres Dialect specialization for the `bun:sql` driver.
  *
@@ -7,6 +7,5 @@ import { PostgresDialect } from '../postgres/postgresDialect.js';
  * reliably; `PgDialect` omits the text re-cast.
  */
 export declare class BunSqlPostgresDialect extends PostgresDialect {
-    constructor(options?: DialectOptions);
+    protected readonly featureOverrides: Partial<DialectFeatures>;
 }
-//# sourceMappingURL=bunSqlPostgresDialect.d.ts.map

package/dist/bunSql/bunSqlPostgresDialect.js

@@ -7,15 +7,8 @@ import { POSTGRES_WIRE_DRIVER_CAPABILITIES } from '../postgres/postgresWireDrive
  * reliably; `PgDialect` omits the text re-cast.
  */
 export class BunSqlPostgresDialect extends PostgresDialect {
-    constructor(options = {}) {
-        super({
-            ...options,
-            driverCapabilities: {
-                ...POSTGRES_WIRE_DRIVER_CAPABILITIES,
-                explicitJsonCast: true,
-                ...options.driverCapabilities,
-            },
-        });
-    }
+    featureOverrides = {
+        ...POSTGRES_WIRE_DRIVER_CAPABILITIES,
+        explicitJsonCast: true,
+    };
 }
-//# sourceMappingURL=bunSqlPostgresDialect.js.map

package/dist/bunSql/bunSqlQuerier.d.ts

@@ -11,4 +11,3 @@ export declare class BunSqlQuerier extends AbstractPoolQuerier<ReservedSQL> {
     private execute;
     protected releaseConn(conn: ReservedSQL): Promise<void>;
 }
-//# sourceMappingURL=bunSqlQuerier.d.ts.map

package/dist/bunSql/bunSqlQuerier.js

@@ -34,4 +34,3 @@ export class BunSqlQuerier extends AbstractPoolQuerier {
         }
     }
 }
-//# sourceMappingURL=bunSqlQuerier.js.map

package/dist/bunSql/bunSqlQuerierPool.d.ts

@@ -16,4 +16,3 @@ export declare class BunSqlQuerierPool extends AbstractSqlQuerierPool<BunSqlQuer
     getQuerier(): Promise<BunSqlQuerier>;
     end(): Promise<void>;
 }
-//# sourceMappingURL=bunSqlQuerierPool.d.ts.map

package/dist/bunSql/bunSqlQuerierPool.js

@@ -55,4 +55,3 @@ export class BunSqlQuerierPool extends AbstractSqlQuerierPool {
         await this.sql.close();
     }
 }
-//# sourceMappingURL=bunSqlQuerierPool.js.map

package/dist/bunSql/bunSqliteDialect.d.ts

@@ -4,4 +4,3 @@ import { SqliteDialect } from '../sqlite/sqliteDialect.js';
  */
 export declare class BunSqliteDialect extends SqliteDialect {
 }
-//# sourceMappingURL=bunSqliteDialect.d.ts.map

package/dist/bunSql/bunSqliteDialect.js

@@ -4,4 +4,3 @@ import { SqliteDialect } from '../sqlite/sqliteDialect.js';
  */
 export class BunSqliteDialect extends SqliteDialect {
 }
-//# sourceMappingURL=bunSqliteDialect.js.map

package/dist/bunSql/index.d.ts

@@ -2,4 +2,3 @@ export * from './bunSqliteDialect.js';
 export * from './bunSqlPostgresDialect.js';
 export * from './bunSqlQuerier.js';
 export * from './bunSqlQuerierPool.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/bunSql/index.js

@@ -2,4 +2,3 @@ export * from './bunSqliteDialect.js';
 export * from './bunSqlPostgresDialect.js';
 export * from './bunSqlQuerier.js';
 export * from './bunSqlQuerierPool.js';
-//# sourceMappingURL=index.js.map

package/dist/cockroachdb/cockroachDialect.d.ts

@@ -1,6 +1,5 @@
-import type { DialectOptions } from '../dialect/abstractDialect.js';
 import { PgLikeSqlDialect } from '../dialect/pgLikeSqlDialect.js';
-import type { VectorDistance } from '../type/index.js';
+import type { IndexFeature, IndexSchema, VectorDistance } from '../type/index.js';
 /**
  * CockroachDB Dialect.
  * Shares AST/quoting/JSONB/full-text-search/vector-search/upsert logic with Postgres via
@@ -14,7 +13,23 @@ import type { VectorDistance } from '../type/index.js';
  */
 export declare class CockroachDialect extends PgLikeSqlDialect {
     readonly dialectName = "cockroachdb";
-    readonly vectorOpsClass: ReadonlyMap<VectorDistance, string> | undefined;
-    constructor(options?: DialectOptions);
+    readonly vectorMetrics: ReadonlyMap<VectorDistance, {
+        op: string;
+        opsSuffix: string;
+    }>;
+    /**
+     * `NULLS FIRST/LAST` answers "unimplemented: this syntax" and `jsonb_path_ops` "operator class is
+     * not supported" (both verified on v26.2), so neither is offered here.
+     */
+    protected readonly indexFeatures: Set<IndexFeature>;
+    /**
+     * CockroachDB's vector index is native and has its own syntax: `CREATE VECTOR INDEX ... ("col"
+     * vector_cosine_ops)`, with no access-method keyword, and tuning knobs of its own names that UQL
+     * does not map. `type: 'vector'` is its trigger, the same generic value MariaDB's inline index uses.
+     */
+    private isNativeVectorIndex;
+    protected isVectorIndex(index: IndexSchema): boolean;
+    protected indexKeyword(index: IndexSchema): string;
+    protected indexAccessMethod(index: IndexSchema): string;
+    protected indexTuning(index: IndexSchema): string;
 }
-//# sourceMappingURL=cockroachDialect.d.ts.map

package/dist/cockroachdb/cockroachDialect.js

@@ -12,25 +12,39 @@ import { PgLikeSqlDialect } from '../dialect/pgLikeSqlDialect.js';
  */
 export class CockroachDialect extends PgLikeSqlDialect {
     dialectName = 'cockroachdb';
-    // CockroachDB only implements 3 of pgvector's 5 distance metrics. Verified live (both `<+>`/`<~>`
-    // query operators and `vector_l1_ops`/`bit_hamming_ops` index opclasses throw "unimplemented:
-    // operator class ... is not supported") and confirmed in CockroachDB's own docs, "Known
-    // limitations": https://www.cockroachlabs.com/docs/stable/vector-indexes - tracked upstream at
-    // https://github.com/cockroachdb/cockroach/issues/147839. Re-check that issue before adding
-    // `l1`/`hamming` here; they're omitted on purpose, not an oversight.
-    vectorOpsClass = new Map([
-        ['cosine', 'vector_cosine_ops'],
-        ['l2', 'vector_l2_ops'],
-        ['inner', 'vector_ip_ops'],
+    // CockroachDB implements 3 of pgvector's 4 metrics: `<+>` and `vector_l1_ops` throw
+    // "unimplemented: operator class ... is not supported" (verified live on v26.2), which its own docs
+    // list under "Known limitations": https://www.cockroachlabs.com/docs/stable/vector-indexes -
+    // tracked upstream at https://github.com/cockroachdb/cockroach/issues/147839. Re-check that issue
+    // before adding `l1` here; it is omitted on purpose, not an oversight.
+    vectorMetrics = new Map([
+        ['cosine', { op: '<=>', opsSuffix: 'cosine' }],
+        ['l2', { op: '<->', opsSuffix: 'l2' }],
+        ['inner', { op: '<#>', opsSuffix: 'ip' }],
     ]);
-    constructor(options = {}) {
-        super({
-            ...options,
-            driverCapabilities: {
-                vectorIndexStyle: 'native',
-                ...options.driverCapabilities,
-            },
-        });
+    /**
+     * `NULLS FIRST/LAST` answers "unimplemented: this syntax" and `jsonb_path_ops` "operator class is
+     * not supported" (both verified on v26.2), so neither is offered here.
+     */
+    indexFeatures = new Set(['expression', 'include']);
+    /**
+     * CockroachDB's vector index is native and has its own syntax: `CREATE VECTOR INDEX ... ("col"
+     * vector_cosine_ops)`, with no access-method keyword, and tuning knobs of its own names that UQL
+     * does not map. `type: 'vector'` is its trigger, the same generic value MariaDB's inline index uses.
+     */
+    isNativeVectorIndex(index) {
+        return index.type === 'vector';
+    }
+    isVectorIndex(index) {
+        return this.isNativeVectorIndex(index) || super.isVectorIndex(index);
+    }
+    indexKeyword(index) {
+        return this.isNativeVectorIndex(index) ? 'VECTOR INDEX' : super.indexKeyword(index);
+    }
+    indexAccessMethod(index) {
+        return this.isNativeVectorIndex(index) ? '' : super.indexAccessMethod(index);
+    }
+    indexTuning(index) {
+        return this.isNativeVectorIndex(index) ? '' : super.indexTuning(index);
     }
 }
-//# sourceMappingURL=cockroachDialect.js.map