uql-orm 0.15.2 → 0.15.3

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file. Please add
 
 date format is [yyyy-mm-dd]
 
+## [0.15.3] - 2026-07-11
+
+CockroachDB integration tests added, fixing upsert, ID generation, and `$text` search, and adding full vector search support. Two related Bun SQL driver bugs (CockroachDB JSON updates, MariaDB upsert `created`) are also fixed.
+
+### Features
+
+- **CockroachDB vector search** - `$sort`/`$vector` uses the same pgvector-compatible distance operators as Postgres (`<=>`/`<->`/`<#>`), and schema generation emits CockroachDB's native `CREATE VECTOR INDEX` syntax.
+
+### Fixes
+
+- **CockroachDB `upsertOne` / `upsertMany`** - previously errored with `column "xmax" does not exist`; now works, with `created` always `undefined` (CockroachDB has no insert-vs-update signal).
+- **CockroachDB auto-generated IDs** - the default primary key used `SERIAL` (CockroachDB's `unique_rowid()`), producing values beyond `Number.MAX_SAFE_INTEGER` that get corrupted as JS numbers. Now uses a sequential `IDENTITY` column instead.
+- **CockroachDB `$text` search** - now generates `to_tsvector`/`to_tsquery`, which CockroachDB supports.
+- **CockroachDB via Bun SQL** - `$merge`/`$push` on a JSONB column could silently corrupt the value or throw, since it didn't get the same wire-encoding fix Postgres has on the Bun driver. Fixed.
+- **MariaDB via Bun SQL** - upsert's `created` could report `false` on a fresh insert; now correctly `undefined`.
+
 ## [0.15.2] - 2026-07-10
 
 `insertOne` / `insertMany` now return the right IDs on every database (and `undefined` instead of a made-up one when the driver reports none), a batch may mix records with different columns, and oversized batches are split automatically to stay under the driver's bind-parameter limit.

package/README.md

@@ -7,7 +7,7 @@
 
 [![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)
 
-**[UQL](https://uql-orm.dev)** is the smartest ORM: serializable queries, no codegen, and one API across PostgreSQL, MySQL, SQLite, MariaDB, and MongoDB. Define entities once, query everywhere.
+**[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.
 
 <!-- DEMO: Record an animated GIF showing IDE autocompletion for $select/$populate/$where and embed here. Example: ![demo](/assets/demo.gif) -->
 

package/dist/bunSql/bunSqlCockroachDialect.d.ts

@@ -0,0 +1,13 @@
+import { CockroachDialect } from '../cockroachdb/cockroachDialect.js';
+import type { DialectOptions } from '../dialect/abstractDialect.js';
+/**
+ * CockroachDB Dialect specialization for the `bun:sql` driver, which routes CockroachDB
+ * connections through its own Postgres wire-protocol implementation (see
+ * `bunSql.util.ts#normalizeBunOpts`), so it needs the identical fix as {@link BunSqlPostgresDialect}:
+ * without it, `$merge`/`$push` on a JSONB column silently produce the wrong value or throw
+ * (verified directly against a live CockroachDB instance via `bun:sql`).
+ */
+export declare class BunSqlCockroachDialect extends CockroachDialect {
+    constructor(options?: DialectOptions);
+}
+//# sourceMappingURL=bunSqlCockroachDialect.d.ts.map

package/dist/bunSql/bunSqlCockroachDialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunSqlCockroachDialect.d.ts","sourceRoot":"","sources":["../../src/bunSql/bunSqlCockroachDialect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,YAAY,OAAO,GAAE,cAAmB,EASvC;CACF"}

package/dist/bunSql/bunSqlCockroachDialect.js

@@ -0,0 +1,22 @@
+import { CockroachDialect } from '../cockroachdb/cockroachDialect.js';
+import { POSTGRES_WIRE_DRIVER_CAPABILITIES } from '../postgres/postgresWireDriverCapabilities.js';
+/**
+ * CockroachDB Dialect specialization for the `bun:sql` driver, which routes CockroachDB
+ * connections through its own Postgres wire-protocol implementation (see
+ * `bunSql.util.ts#normalizeBunOpts`), so it needs the identical fix as {@link BunSqlPostgresDialect}:
+ * without it, `$merge`/`$push` on a JSONB column silently produce the wrong value or throw
+ * (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,
+            },
+        });
+    }
+}
+//# sourceMappingURL=bunSqlCockroachDialect.js.map

package/dist/bunSql/bunSqlCockroachDialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunSqlCockroachDialect.js","sourceRoot":"","sources":["../../src/bunSql/bunSqlCockroachDialect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,EAAE,iCAAiC,EAAE,MAAM,+CAA+C,CAAC;AAElG;;;;;;GAMG;AACH,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAC1D,YAAY,OAAO,GAAmB,EAAE;QACtC,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,kBAAkB,EAAE;gBAClB,GAAG,iCAAiC;gBACpC,gBAAgB,EAAE,IAAI;gBACtB,GAAG,OAAO,CAAC,kBAAkB;aAC9B;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/bunSql/bunSqlQuerierPool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bunSqlQuerierPool.d.ts","sourceRoot":"","sources":["../../src/bunSql/bunSqlQuerierPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,GAAG,EAAE,MAAM,KAAK,CAAC;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAWpF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,qBAAa,iBAAkB,SAAQ,sBAAsB,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAK5F,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO;IAJ9B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC,YACW,MAAM,EAAE,GAAG,CAAC,OAAO,EAC5B,KAAK,CAAC,EAAE,YAAY,EAQrB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,aAAa,CAWxB;IAEK,UAAU,2BASf;IAEK,GAAG,kBAER;CACF"}
+{"version":3,"file":"bunSqlQuerierPool.d.ts","sourceRoot":"","sources":["../../src/bunSql/bunSqlQuerierPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,GAAG,EAAE,MAAM,KAAK,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAYpF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,qBAAa,iBAAkB,SAAQ,sBAAsB,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAK5F,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO;IAJ9B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC,YACW,MAAM,EAAE,GAAG,CAAC,OAAO,EAC5B,KAAK,CAAC,EAAE,YAAY,EAQrB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,aAAa,CAWxB;IAEK,UAAU,2BASf;IAEK,GAAG,kBAER;CACF"}

package/dist/bunSql/bunSqlQuerierPool.js

@@ -1,9 +1,9 @@
 import { SQL } from 'bun';
-import { CockroachDialect } from '../cockroachdb/cockroachDialect.js';
 import { MariaDialect } from '../maria/mariaDialect.js';
 import { MySqlDialect } from '../mysql/mysqlDialect.js';
 import { AbstractSqlQuerierPool } from '../querier/index.js';
 import { getAffectedRows, inferDialectName, isPoolableDialect, normalizeBunOpts, normalizeRows, } from './bunSql.util.js';
+import { BunSqlCockroachDialect } from './bunSqlCockroachDialect.js';
 import { BunSqliteDialect } from './bunSqliteDialect.js';
 import { BunSqlPostgresDialect } from './bunSqlPostgresDialect.js';
 import { BunSqlQuerier } from './bunSqlQuerier.js';
@@ -12,7 +12,7 @@ const DialectMap = {
     mysql: MySqlDialect,
     mariadb: MariaDialect,
     sqlite: BunSqliteDialect,
-    cockroachdb: CockroachDialect,
+    cockroachdb: BunSqlCockroachDialect,
 };
 export class BunSqlQuerierPool extends AbstractSqlQuerierPool {
     config;

package/dist/bunSql/bunSqlQuerierPool.js.map

@@ -1 +1 @@
-{"version":3,"file":"bunSqlQuerierPool.js","sourceRoot":"","sources":["../../src/bunSql/bunSqlQuerierPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,GAAG,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,UAAU,GAAyD;IACvE,QAAQ,EAAE,qBAAqB;IAC/B,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,gBAAgB;IACxB,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,OAAO,iBAAkB,SAAQ,sBAAyD;IAKnF,MAAM;IAJR,GAAG,CAAM;IACT,cAAc,CAAiB;IAExC,YACW,MAAmB,EAC5B,KAAoB;QAEpB,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;sBAJ5E,MAAM;QAKf,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC;QAElC,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO;YACL,KAAK,EAAE,CAAC,IAAY,EAAE,MAAkB,EAAE,EAAE,CAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAe,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvF,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC;gBACxB,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC;aAC/B,CAAC,CAAC;YACL,EAAE,EAAE,GAAG,EAAE;gBACP,+BAA+B;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;YAC7B,gFAAgF;YAChF,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,GAAkB,CAAC;YACjC,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC,CAAC;QACF,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"bunSqlQuerierPool.js","sourceRoot":"","sources":["../../src/bunSql/bunSqlQuerierPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,GAAG,EAAE,MAAM,KAAK,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,UAAU,GAAyD;IACvE,QAAQ,EAAE,qBAAqB;IAC/B,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,gBAAgB;IACxB,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF,MAAM,OAAO,iBAAkB,SAAQ,sBAAyD;IAKnF,MAAM;IAJR,GAAG,CAAM;IACT,cAAc,CAAiB;IAExC,YACW,MAAmB,EAC5B,KAAoB;QAEpB,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;sBAJ5E,MAAM;QAKf,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC;QAElC,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO;YACL,KAAK,EAAE,CAAC,IAAY,EAAE,MAAkB,EAAE,EAAE,CAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAe,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvF,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC;gBACxB,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC;aAC/B,CAAC,CAAC;YACL,EAAE,EAAE,GAAG,EAAE;gBACP,+BAA+B;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;YAC7B,gFAAgF;YAChF,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,GAAkB,CAAC;YACjC,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC,CAAC;QACF,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/cockroachdb/cockroachDialect.d.ts

@@ -1,15 +1,18 @@
-import { PostgresDialect } from '../postgres/postgresDialect.js';
-import type { VectorDistance } from '../type/index.js';
+import type { DialectOptions } from '../dialect/abstractDialect.js';
+import { PgLikeSqlDialect } from '../dialect/pgLikeSqlDialect.js';
 /**
  * CockroachDB Dialect.
- * Completely leverages PostgresDialect directly since they share wire compatibility.
- * CockroachDB natively supports `(xmax = 0)` to allow Postgres-compatible ORMs
- * to perform `upsert` queries without custom overrides.
+ * Shares AST/quoting/JSONB/full-text-search/vector-search/upsert logic with Postgres via
+ * {@link PgLikeSqlDialect} (wire- and SQL-compatible for all of that, including pgvector's
+ * `<=>`/`<->`/`<#>` operators, which CockroachDB implements natively). Unlike Postgres, CockroachDB
+ * has no `xmax`/`ctid` system columns, so it uses `PgLikeSqlDialect.upsert`'s default as-is (no
+ * `created` detection) rather than Postgres's `xmax`-based override; no `vectorExtension` either,
+ * since the vector type is native (no `CREATE EXTENSION` needed); and vector indexes use
+ * CockroachDB's own `CREATE VECTOR INDEX` syntax (no access-method keyword) rather than pgvector's
+ * `CREATE INDEX ... USING ivfflat/hnsw`.
  */
-export declare class CockroachDialect extends PostgresDialect {
+export declare class CockroachDialect extends PgLikeSqlDialect {
     readonly dialectName = "cockroachdb";
-    readonly serialPrimaryKey = "SERIAL PRIMARY KEY";
-    readonly vectorOpsClass: Readonly<Record<VectorDistance, string>> | undefined;
-    readonly vectorExtension: string | undefined;
+    constructor(options?: DialectOptions);
 }
 //# sourceMappingURL=cockroachDialect.d.ts.map

package/dist/cockroachdb/cockroachDialect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cockroachDialect.d.ts","sourceRoot":"","sources":["../../src/cockroachdb/cockroachDialect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,SAAkB,WAAW,iBAAiB;IAE9C,SAAkB,gBAAgB,wBAAwB;IAE1D,SAAkB,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAa;IAEnG,SAAkB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAa;CACnE"}
+{"version":3,"file":"cockroachDialect.d.ts","sourceRoot":"","sources":["../../src/cockroachdb/cockroachDialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,SAAkB,WAAW,iBAAiB;IAE9C,YAAY,OAAO,GAAE,cAAmB,EAQvC;CACF"}

package/dist/cockroachdb/cockroachDialect.js

@@ -1,14 +1,25 @@
-import { PostgresDialect } from '../postgres/postgresDialect.js';
+import { PgLikeSqlDialect } from '../dialect/pgLikeSqlDialect.js';
 /**
  * CockroachDB Dialect.
- * Completely leverages PostgresDialect directly since they share wire compatibility.
- * CockroachDB natively supports `(xmax = 0)` to allow Postgres-compatible ORMs
- * to perform `upsert` queries without custom overrides.
+ * Shares AST/quoting/JSONB/full-text-search/vector-search/upsert logic with Postgres via
+ * {@link PgLikeSqlDialect} (wire- and SQL-compatible for all of that, including pgvector's
+ * `<=>`/`<->`/`<#>` operators, which CockroachDB implements natively). Unlike Postgres, CockroachDB
+ * has no `xmax`/`ctid` system columns, so it uses `PgLikeSqlDialect.upsert`'s default as-is (no
+ * `created` detection) rather than Postgres's `xmax`-based override; no `vectorExtension` either,
+ * since the vector type is native (no `CREATE EXTENSION` needed); and vector indexes use
+ * CockroachDB's own `CREATE VECTOR INDEX` syntax (no access-method keyword) rather than pgvector's
+ * `CREATE INDEX ... USING ivfflat/hnsw`.
  */
-export class CockroachDialect extends PostgresDialect {
+export class CockroachDialect extends PgLikeSqlDialect {
     dialectName = 'cockroachdb';
-    serialPrimaryKey = 'SERIAL PRIMARY KEY';
-    vectorOpsClass = undefined;
-    vectorExtension = undefined;
+    constructor(options = {}) {
+        super({
+            ...options,
+            driverCapabilities: {
+                vectorIndexStyle: 'native',
+                ...options.driverCapabilities,
+            },
+        });
+    }
 }
 //# sourceMappingURL=cockroachDialect.js.map

package/dist/cockroachdb/cockroachDialect.js.map

@@ -1 +1 @@
-{"version":3,"file":"cockroachDialect.js","sourceRoot":"","sources":["../../src/cockroachdb/cockroachDialect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACjC,WAAW,GAAG,aAAa,CAAC;IAE5B,gBAAgB,GAAG,oBAAoB,CAAC;IAExC,cAAc,GAAyD,SAAS,CAAC;IAEjF,eAAe,GAAuB,SAAS,CAAC;CACnE"}
+{"version":3,"file":"cockroachDialect.js","sourceRoot":"","sources":["../../src/cockroachdb/cockroachDialect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IAClC,WAAW,GAAG,aAAa,CAAC;IAE9C,YAAY,OAAO,GAAmB,EAAE;QACtC,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,kBAAkB,EAAE;gBAClB,gBAAgB,EAAE,QAAQ;gBAC1B,GAAG,OAAO,CAAC,kBAAkB;aAC9B;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/dialect/pgLikeSqlDialect.d.ts

@@ -0,0 +1,59 @@
+import { type DialectFeatures, type EntityMeta, type FieldOptions, type JsonUpdateOp, type QueryComparisonOptions, type QueryConflictPaths, type QueryContext, type QueryOptions, type QuerySizeComparisonOps, type QueryVectorSearch, type Type, type VectorDistance } from '../type/index.js';
+import { AbstractSqlDialect } from './abstractSqlDialect.js';
+/**
+ * Shared AST/quoting/JSONB/full-text-search/vector-search implementation between Postgres and
+ * CockroachDB (wire- and SQL-compatible for everything below, including `to_tsvector`/`to_tsquery`
+ * and pgvector's `<=>`/`<->`/`<#>` distance operators, which CockroachDB implements natively).
+ * `xmax`-based upsert `created` detection is Postgres-only (CockroachDB has no `xmax`/`ctid`) and
+ * stays in {@link PostgresDialect}, along with the `vectorExtension`/`vectorIndexStyle` values that
+ * differ (Postgres needs `CREATE EXTENSION vector` and pgvector's `USING ivfflat/hnsw` index
+ * syntax; CockroachDB's vector type and `CREATE VECTOR INDEX` syntax are both native).
+ */
+export declare abstract class PgLikeSqlDialect extends AbstractSqlDialect {
+    /** Default {@link DialectFeatures} for Postgres-wire dialects. */
+    protected readonly featureDefaults: DialectFeatures;
+    readonly quoteChar = "\"";
+    readonly serialPrimaryKey: string;
+    readonly tableOptions = "";
+    readonly beginTransactionCommand = "BEGIN";
+    readonly commitTransactionCommand = "COMMIT";
+    readonly rollbackTransactionCommand = "ROLLBACK";
+    readonly alterColumnStrategy = "separate-clauses";
+    readonly insertIdSource = "returning";
+    readonly maxBindValues: number;
+    readonly vectorOpsClass: Readonly<Record<VectorDistance, string>> | undefined;
+    normalizeValue(value: unknown): unknown;
+    placeholder(index: number): string;
+    insert<E>(ctx: QueryContext, entity: Type<E>, payload: E | E[], opts?: QueryOptions): void;
+    upsert<E>(ctx: QueryContext, entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E | E[]): void;
+    /**
+     * Shared `INSERT ... ON CONFLICT (...) DO UPDATE/NOTHING RETURNING ...` builder, mirroring
+     * {@link AbstractSqlDialect.onConflictUpsert}'s "assemble everything, don't hand back fragments"
+     * shape for the `$N`-placeholder Postgres-wire dialects. `extraReturning` lets {@link PostgresDialect}
+     * append `(xmax = 0) AS "_created"` to detect insert-vs-update; CockroachDB has no `xmax`/`ctid`
+     * system columns, so it uses the default (empty) and `created` stays `undefined` in the result.
+     */
+    protected buildUpsertOnConflict<E>(ctx: QueryContext, entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E | E[], extraReturning?: string): void;
+    /** Full-text search: both dialects support `to_tsvector(...) @@ to_tsquery(...)`. */
+    compare<E>(ctx: QueryContext, entity: Type<E>, key: string, val: unknown, opts?: QueryComparisonOptions): void;
+    protected jsonAll(ctx: QueryContext, jsonField: string, value: unknown): string;
+    protected jsonSize(ctx: QueryContext, jsonField: string, value: number | QuerySizeComparisonOps): string;
+    protected jsonElemMatch(ctx: QueryContext, jsonField: string, match: Record<string, unknown>): string;
+    protected get regexpOp(): string;
+    protected ilikeExpr(f: string, ph: string): string;
+    protected get neOp(): string;
+    protected formatIn(ctx: QueryContext, values: unknown[], negate: boolean): string;
+    protected numericCast(expr: string): string;
+    protected formatPersistableValue<E>(ctx: QueryContext, field: FieldOptions, value: unknown): void;
+    protected formatJsonUpdate<E>(ctx: QueryContext, escapedCol: string, value: JsonUpdateOp<E>): void;
+    /**
+     * Helper to add a JSON value to context with appropriate stringification and cast.
+     */
+    private jsonVal;
+    escape(value: unknown): string;
+    /** pgvector distance operators (also implemented natively by CockroachDB). */
+    private static readonly VECTOR_OPS;
+    /** Emit a pgvector-style distance expression: `"col" <op> $N::<vectorType>`. */
+    protected appendVectorSort<E>(ctx: QueryContext, meta: EntityMeta<E>, key: string, search: QueryVectorSearch): void;
+}
+//# sourceMappingURL=pgLikeSqlDialect.d.ts.map

package/dist/dialect/pgLikeSqlDialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgLikeSqlDialect.d.ts","sourceRoot":"","sources":["../../src/dialect/pgLikeSqlDialect.ts"],"names":[],"mappings":"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"}

package/dist/dialect/pgLikeSqlDialect.js

@@ -0,0 +1,236 @@
+import { getMeta } from '../entity/index.js';
+import { QueryRaw, } from '../type/index.js';
+import { escapeAnsiSqlLiteral } from '../util/ansiSqlLiteral.js';
+import { hasKeys, isJsonType } from '../util/index.js';
+import { AbstractSqlDialect } from './abstractSqlDialect.js';
+import { buildElemMatchConditions } from './jsonArrayElemMatchUtils.js';
+/**
+ * Shared AST/quoting/JSONB/full-text-search/vector-search implementation between Postgres and
+ * CockroachDB (wire- and SQL-compatible for everything below, including `to_tsvector`/`to_tsquery`
+ * and pgvector's `<=>`/`<->`/`<#>` distance operators, which CockroachDB implements natively).
+ * `xmax`-based upsert `created` detection is Postgres-only (CockroachDB has no `xmax`/`ctid`) and
+ * stays in {@link PostgresDialect}, along with the `vectorExtension`/`vectorIndexStyle` values that
+ * differ (Postgres needs `CREATE EXTENSION vector` and pgvector's `USING ivfflat/hnsw` index
+ * syntax; CockroachDB's vector type and `CREATE VECTOR INDEX` syntax are both native).
+ */
+export class PgLikeSqlDialect extends AbstractSqlDialect {
+    /** Default {@link DialectFeatures} for Postgres-wire dialects. */
+    featureDefaults = {
+        explicitJsonCast: false,
+        nativeArrays: true,
+        supportsJsonb: true,
+        ifNotExists: true,
+        indexIfNotExists: true,
+        dropTableCascade: true,
+        renameColumn: true,
+        foreignKeyAlter: true,
+        columnComment: false,
+        vectorIndexStyle: 'create',
+        vectorSupportsLength: true,
+        supportsTimestamptz: true,
+        defaultStringAsText: true,
+    };
+    quoteChar = '"';
+    // Shared default for both dialects. CockroachDB docs flag sequential PKs as a hotspotting risk
+    // under heavy concurrent insert load (writes concentrate on one range); this default still beats
+    // `SERIAL` (CockroachDB's `unique_rowid()`, a ~64-bit value that overflows JS's safe-integer
+    // range). High-throughput CockroachDB users should override this per-entity with a UUID PK.
+    serialPrimaryKey = 'BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY';
+    tableOptions = '';
+    beginTransactionCommand = 'BEGIN';
+    commitTransactionCommand = 'COMMIT';
+    rollbackTransactionCommand = 'ROLLBACK';
+    alterColumnStrategy = 'separate-clauses';
+    insertIdSource = 'returning';
+    maxBindValues = 65535;
+    vectorOpsClass = {
+        cosine: 'vector_cosine_ops',
+        l2: 'vector_l2_ops',
+        inner: 'vector_ip_ops',
+        l1: 'vector_l1_ops',
+        hamming: 'bit_hamming_ops',
+    };
+    normalizeValue(value) {
+        if (value != null && typeof value === 'object' && Array.isArray(value)) {
+            return this.features.nativeArrays ? value : toPgArray(value);
+        }
+        return super.normalizeValue(value);
+    }
+    placeholder(index) {
+        return `$${index}`;
+    }
+    insert(ctx, entity, payload, opts) {
+        super.insert(ctx, entity, payload, opts);
+        ctx.append(' ' + this.returningId(entity));
+    }
+    upsert(ctx, entity, conflictPaths, payload) {
+        this.buildUpsertOnConflict(ctx, entity, conflictPaths, payload);
+    }
+    /**
+     * Shared `INSERT ... ON CONFLICT (...) DO UPDATE/NOTHING RETURNING ...` builder, mirroring
+     * {@link AbstractSqlDialect.onConflictUpsert}'s "assemble everything, don't hand back fragments"
+     * shape for the `$N`-placeholder Postgres-wire dialects. `extraReturning` lets {@link PostgresDialect}
+     * append `(xmax = 0) AS "_created"` to detect insert-vs-update; CockroachDB has no `xmax`/`ctid`
+     * system columns, so it uses the default (empty) and `created` stays `undefined` in the result.
+     */
+    buildUpsertOnConflict(ctx, entity, conflictPaths, payload, extraReturning = '') {
+        const meta = getMeta(entity);
+        const update = this.getUpsertUpdateAssignments(ctx, meta, conflictPaths, payload, (name) => `EXCLUDED.${name}`);
+        const keysStr = this.getUpsertConflictPathsStr(meta, conflictPaths);
+        const onConflict = update ? `DO UPDATE SET ${update}` : 'DO NOTHING';
+        super.insert(ctx, entity, payload);
+        ctx.append(` ON CONFLICT (${keysStr}) ${onConflict} ${this.returningId(entity)}${extraReturning}`);
+    }
+    /** Full-text search: both dialects support `to_tsvector(...) @@ to_tsquery(...)`. */
+    compare(ctx, entity, key, val, opts = {}) {
+        if (key === '$text') {
+            const meta = getMeta(entity);
+            const search = val;
+            const fields = (search.$fields ?? [])
+                .map((fKey) => {
+                const field = meta.fields[fKey];
+                const columnName = this.resolveColumnName(fKey, field);
+                return this.escapeId(columnName);
+            })
+                .join(` || ' ' || `);
+            ctx.append(`to_tsvector(${fields}) @@ to_tsquery(`);
+            ctx.addValue(search.$value);
+            ctx.append(')');
+            return;
+        }
+        super.compare(ctx, entity, key, val, opts);
+    }
+    jsonAll(ctx, jsonField, value) {
+        return `${jsonField} @> ${this.jsonVal(ctx, value)}`;
+    }
+    jsonSize(ctx, jsonField, value) {
+        const tmpCtx = this.createContext();
+        this.buildSizeComparison(tmpCtx, () => tmpCtx.append(`jsonb_array_length(${jsonField})`), value);
+        ctx.pushValue(...tmpCtx.values);
+        return tmpCtx.sql;
+    }
+    jsonElemMatch(ctx, jsonField, match) {
+        // Primitive element match: keys are operators (e.g. { $startsWith: 'ad' } on a string[])
+        const isPrimitiveElement = Object.keys(match).some((k) => k.startsWith('$'));
+        if (isPrimitiveElement) {
+            const conditions = Object.entries(match).map(([op, opVal]) => this.buildJsonFieldCondition(ctx, () => 'elem', '', op, opVal));
+            return `EXISTS (SELECT 1 FROM jsonb_array_elements_text(${jsonField}) AS elem WHERE ${conditions.join(' AND ')})`;
+        }
+        const hasOperators = Object.values(match).some((v) => v && typeof v === 'object' && !Array.isArray(v) && Object.keys(v).some((k) => k.startsWith('$')));
+        if (!hasOperators) {
+            return `${jsonField} @> ${this.jsonVal(ctx, [match])}`;
+        }
+        const conditions = buildElemMatchConditions(match, (field, op, opVal) => this.buildJsonFieldCondition(ctx, (f) => `elem->>'${this.escapeJsonKey(f)}'`, field, op, opVal), (field, val) => `elem->>'${this.escapeJsonKey(field)}' = ${this.addValue(ctx.values, val)}`);
+        return `EXISTS (SELECT 1 FROM jsonb_array_elements(${jsonField}) AS elem WHERE ${conditions.join(' AND ')})`;
+    }
+    get regexpOp() {
+        return '~';
+    }
+    ilikeExpr(f, ph) {
+        return `${f} ILIKE ${ph}`;
+    }
+    get neOp() {
+        return 'IS DISTINCT FROM';
+    }
+    formatIn(ctx, values, negate) {
+        if (values.length === 0)
+            return negate ? ' NOT IN (NULL)' : ' IN (NULL)';
+        const ph = this.addValue(ctx.values, values);
+        return negate ? ` <> ALL(${ph})` : ` = ANY(${ph})`;
+    }
+    numericCast(expr) {
+        return `(${expr})::numeric`;
+    }
+    formatPersistableValue(ctx, field, value) {
+        if (value instanceof QueryRaw) {
+            super.formatPersistableValue(ctx, field, value);
+            return;
+        }
+        if (isJsonType(field.type)) {
+            ctx.append(this.jsonVal(ctx, value, field.type));
+            return;
+        }
+        if (field.type === 'vector' && Array.isArray(value)) {
+            ctx.addValue(`[${value.join(',')}]`);
+            ctx.append('::vector');
+            return;
+        }
+        super.formatPersistableValue(ctx, field, value);
+    }
+    formatJsonUpdate(ctx, escapedCol, value) {
+        let expr = escapedCol;
+        if (hasKeys(value.$merge)) {
+            expr = `COALESCE(${escapedCol}, '{}'::jsonb) || ${this.jsonVal(ctx, value.$merge)}`;
+        }
+        if (hasKeys(value.$push)) {
+            const push = value.$push;
+            for (const [key, v] of Object.entries(push)) {
+                const currentExpr = expr;
+                const ph = this.jsonVal(ctx, v);
+                expr = `jsonb_set(${currentExpr}, '{${this.escapeJsonKey(key)}}', COALESCE((${currentExpr})->'${this.escapeJsonKey(key)}', '[]'::jsonb) || jsonb_build_array(${ph}))`;
+            }
+        }
+        if (value.$unset?.length) {
+            for (const key of value.$unset) {
+                expr = `(${expr}) - '${this.escapeJsonKey(key)}'`;
+            }
+        }
+        ctx.append(`${escapedCol} = ${expr}`);
+    }
+    /**
+     * Helper to add a JSON value to context with appropriate stringification and cast.
+     */
+    jsonVal(ctx, value, type = 'jsonb') {
+        if (value instanceof QueryRaw)
+            return this.addValue(ctx.values, value);
+        if (value == null)
+            return `${this.addValue(ctx.values, null)}::${type}`;
+        const json = JSON.stringify(value);
+        const ph = this.addValue(ctx.values, json);
+        return this.features.explicitJsonCast ? `(${ph}::text)::${type}` : `${ph}::${type}`;
+    }
+    escape(value) {
+        return escapeAnsiSqlLiteral(value);
+    }
+    /** pgvector distance operators (also implemented natively by CockroachDB). */
+    static VECTOR_OPS = {
+        cosine: '<=>',
+        l2: '<->',
+        inner: '<#>',
+        l1: '<+>',
+        hamming: '<~>',
+    };
+    /** Emit a pgvector-style distance expression: `"col" <op> $N::<vectorType>`. */
+    appendVectorSort(ctx, meta, key, search) {
+        const { colName, distance, vectorCast } = this.resolveVectorSortParams(meta, key, search);
+        const op = PgLikeSqlDialect.VECTOR_OPS[distance];
+        ctx.append(`${this.escapeId(colName)} ${op} `);
+        ctx.addValue(`[${search.$vector.join(',')}]`);
+        ctx.append(`::${vectorCast}`);
+    }
+}
+/**
+ * Converts a JS array to a Postgres array literal string: `{"val1","val2"}`.
+ * Safely handles nesting and escaping of special characters.
+ */
+function toPgArray(arr) {
+    const elements = arr.map((val) => {
+        if (val == null)
+            return 'NULL';
+        if (Array.isArray(val))
+            return toPgArray(val);
+        if (typeof val === 'boolean')
+            return val ? 'true' : 'false';
+        if (val instanceof Uint8Array || (typeof Buffer !== 'undefined' && Buffer.isBuffer(val))) {
+            const hex = Array.from(val)
+                .map((b) => b.toString(16).padStart(2, '0'))
+                .join('');
+            return `"\\\\x${hex}"`;
+        }
+        const str = String(val);
+        const escaped = str.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        return `"${escaped}"`;
+    });
+    return `{${elements.join(',')}}`;
+}
+//# sourceMappingURL=pgLikeSqlDialect.js.map

package/dist/dialect/pgLikeSqlDialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgLikeSqlDialect.js","sourceRoot":"","sources":["../../src/dialect/pgLikeSqlDialect.ts"],"names":[],"mappings":"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"}

package/dist/entity/decorator/index-decorator.js

@@ -1,4 +1,4 @@
-import { appendEntityIndex, ensureMeta } from '../metadata/definition.js';
+import { defineIndex } from '../metadata/definition.js';
 /**
  * Define a composite index on an entity class.
  *
@@ -21,7 +21,7 @@ import { appendEntityIndex, ensureMeta } from '../metadata/definition.js';
  */
 export function Index(columns, options = {}) {
     return (target) => {
-        appendEntityIndex(ensureMeta(target), { ...options, columns });
+        defineIndex(target, { ...options, columns });
     };
 }
 //# sourceMappingURL=index-decorator.js.map

package/dist/entity/decorator/index-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-decorator.js","sourceRoot":"","sources":["../../../src/entity/decorator/index-decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAgB1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CAAI,OAAiB,EAAE,OAAO,GAA0B,EAAE;IAC7E,OAAO,CAAC,MAAe,EAAQ,EAAE;QAC/B,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index-decorator.js","sourceRoot":"","sources":["../../../src/entity/decorator/index-decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAgBxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CAAI,OAAiB,EAAE,OAAO,GAA0B,EAAE;IAC7E,OAAO,CAAC,MAAe,EAAQ,EAAE;QAC/B,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC"}

package/dist/entity/decorator/index.d.ts

@@ -1,4 +1,4 @@
-export { defineEntity, defineField, defineFilter, defineHook, defineId, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
+export { defineEntity, defineField, defineFilter, defineHook, defineId, defineIndex, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
 export * from './entity.js';
 export * from './field.js';
 export * from './filter.js';

package/dist/entity/decorator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/entity/decorator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/entity/decorator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/entity/decorator/index.js

@@ -1,4 +1,4 @@
-export { defineEntity, defineField, defineFilter, defineHook, defineId, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
+export { defineEntity, defineField, defineFilter, defineHook, defineId, defineIndex, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
 export * from './entity.js';
 export * from './field.js';
 export * from './filter.js';

package/dist/entity/decorator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entity/decorator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entity/decorator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/entity/metadata/definition.d.ts

@@ -8,6 +8,7 @@ export declare function defineField<E>(entity: Type<E>, key: string, opts?: Fiel
 export declare function defineId<E>(entity: Type<E>, key: string, opts: FieldOptions): EntityMeta<E>;
 export declare function defineRelation<E>(entity: Type<E>, key: string, opts: RelationOptions<E>): EntityMeta<E>;
 export declare function defineHook<E>(entity: Type<E>, methodName: string, event: HookEvent): EntityMeta<E>;
+export declare function defineIndex<E>(entity: Type<E>, index: EntityIndexMeta): EntityMeta<E>;
 export declare function defineFilter<E>(entity: Type<E>, name: string, opts: FilterOptions<E>): EntityMeta<E>;
 export declare function defineEntity<E>(entity: Type<E>, opts?: EntityOptions<E>): EntityMeta<E>;
 export declare function getEntities(): Type<unknown>[];

package/dist/entity/metadata/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/entity/metadata/definition.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,aAAa,EAEb,YAAY,EAEZ,aAAa,EACb,SAAS,EAMT,eAAe,EACf,IAAI,EACL,MAAM,qBAAqB,CAAC;AAe7B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAGtF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAUnG;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAQ3F;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAWvG;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAMlG;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAapG;AAyDD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,aAAa,CAAC,CAAC,CAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CA0C3F;AAED,wBAAgB,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAO7C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAQ5D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAUzD;AAsLD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,CAUtE"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/entity/metadata/definition.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,aAAa,EAEb,YAAY,EAEZ,aAAa,EACb,SAAS,EAMT,eAAe,EACf,IAAI,EACL,MAAM,qBAAqB,CAAC;AAe7B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAGtF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAUnG;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAQ3F;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAWvG;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAMlG;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,CAIrF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAapG;AAyDD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,aAAa,CAAC,CAAC,CAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CA0C3F;AAED,wBAAgB,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAO7C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAQ5D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAUzD;AAsLD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,CAUtE"}

package/dist/entity/metadata/definition.js

@@ -58,6 +58,11 @@ export function defineHook(entity, methodName, event) {
     meta.hooks[event].push({ methodName });
     return meta;
 }
+export function defineIndex(entity, index) {
+    const meta = ensureMeta(entity);
+    appendEntityIndex(meta, index);
+    return meta;
+}
 export function defineFilter(entity, name, opts) {
     const meta = ensureMeta(entity);
     if (name === 'softDelete') {