@generazioneai/genquery 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, GenerazioneAi S.R.L. and genquery contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,218 @@
+# genquery
+
+ORM-agnostic JSON query language with pluggable adapters.
+
+Frontends send a `GenQueryInput` object. The backend validates it against a `Schema` and an adapter translates the result into ORM operations. The first adapter targets TypeORM (PostgreSQL-flavored SQL).
+
+## Install
+
+```bash
+npm install @generazioneai/genquery
+# TypeORM adapter (optional)
+npm install typeorm
+```
+
+## Quick start (TypeORM)
+
+```typescript
+import "reflect-metadata";
+import { DataSource } from "typeorm";
+import { createTypeORMEngine } from "@generazioneai/genquery/typeorm";
+
+// 1. Initialize TypeORM with your entity classes
+const dataSource = new DataSource({ /* ... */ entities: [User, Post] });
+await dataSource.initialize();
+
+// 2. One line to set up the schema, adapter, and engine
+const engine = createTypeORMEngine(dataSource);
+
+// 3. Run a query from a request body
+const qb = dataSource.getRepository(User).createQueryBuilder("User");
+
+const result = engine.run(
+  {
+    searchBy: { firstName: "mario" },
+    orderBy:  "createdAt",
+    pagination: { page: 0, perPage: 20 },
+  },
+  qb,   // target QueryBuilder — entity name + entity type both read from this
+);
+
+const users = await result.getMany();
+```
+
+`createTypeORMEngine` is a thin wrapper around `schemaFromTypeORM` → `new TypeORMAdapter` → `new GenQueryEngine`. The root entity (`"User"` in this case) is derived from `qb.expressionMap.mainAlias.metadata.name` at runtime, and the TS entity type is read from `SelectQueryBuilder<User>`. If you need to override or your adapter can't introspect, the 3-arg form still works: `engine.run(input, "User", qb)`.
+
+Need fine-grained control? You can still build it manually:
+
+```typescript
+const schema  = schemaFromTypeORM(dataSource, { overrides: { User: { meta: "string" } } });
+const adapter = new TypeORMAdapter(schema, { paramPrefix: "q" });
+const engine  = new GenQueryEngine({ adapter });   // schema is read from the adapter
+```
+
+Or pass the same options to `createTypeORMEngine`:
+
+```typescript
+const engine = createTypeORMEngine(dataSource, {
+  schema:  { overrides: { User: { meta: "string" } } },
+  adapter: { paramPrefix: "q" },
+});
+```
+
+## Core concepts
+
+### Schema
+
+The `Schema` describes your data model independently of any ORM. The parser uses it to reject unknown fields; the adapter uses it to know which fields are dates vs strings vs relations.
+
+With TypeORM, derive it from the DataSource — no duplication:
+
+```typescript
+import { schemaFromTypeORM } from "@generazioneai/genquery/typeorm";
+
+const schema = schemaFromTypeORM(dataSource);
+// optional: restrict to specific entities
+const schema = schemaFromTypeORM(dataSource, { entities: [User, Post] });
+// optional: override fields with non-standard column types
+const schema = schemaFromTypeORM(dataSource, {
+  overrides: { User: { preferences: "string" } },
+});
+```
+
+Or declare one explicitly (no ORM, or fine-grained control):
+
+```typescript
+const schema: Schema = {
+  entities: {
+    EntityName: {
+      name: "EntityName",
+      primaryKey: "id",           // optional, defaults to "id"
+      fields: {
+        fieldName: { type: "string" | "number" | "boolean" | "date" },
+      },
+      relations: {
+        relationName: { target: "OtherEntity", kind: "one" | "many" },
+      },
+    },
+  },
+};
+```
+
+### Query input
+
+A `GenQueryInput` is a plain JSON object with five optional top-level keys.
+
+The entity type is inferred automatically from the `target` argument when it has a recognizable shape (e.g. a TypeORM `SelectQueryBuilder<User>`). No explicit generic is required — autocomplete and value-shape checking flow from the QueryBuilder's entity type:
+
+```typescript
+const qb = dataSource.getRepository(User).createQueryBuilder("User");
+// qb is SelectQueryBuilder<User> — entity type flows into the call below
+
+engine.run(
+  {
+    searchBy: {
+      firstName: "mario",                              // OK
+      age: { operation: ">=", value: 18 },             // OK — number → comparison
+      birthDate: { after: "2000-01-01T00:00:00Z" },    // OK — date → range
+      posts: { title: "typescript" },                  // OK — relation → recursive
+      // age: "x",       // ✗ type error: number field can't take a string
+      // nope: "x",      // ✗ type error: 'nope' isn't a field on User
+    },
+    orderBy: { field: "lastName", order: "asc" },     // ✓ field constrained to User keys
+    select:  { firstName: true },                      // ✓ only primitive fields
+    include: { posts: "all" },                         // ✓ only relations
+  },
+  qb,
+);
+```
+
+The inference distinguishes fields (primitives → searchable / selectable) from relations (objects/arrays → includable / recursive search), and picks the right value shape per field type (string/number/boolean/Date/enum).
+
+If your target type doesn't expose the entity (e.g. an adapter whose target is `undefined`), the input falls back to a loose form where any key/value is accepted — the runtime parser still validates everything against the schema.
+
+Top-level keys:
+
+| Key | Default | Purpose |
+|-----|---------|---------|
+| `searchBy` | — | Filter conditions (AND + OR) |
+| `orderBy` | — | Sort field and direction |
+| `select` | `"all"` | Which fields to return |
+| `include` | `"none"` | Which relations to join |
+| `pagination` | `"all"` | Page / limit |
+
+Full query language reference: [docs/query-reference.md](docs/query-reference.md)
+
+### Engine
+
+`GenQueryEngine` is the public entry point. It asserts that the schema passed to it and the schema held by the adapter are the same instance.
+
+```typescript
+const engine = new GenQueryEngine({ adapter });   // schema comes from the adapter
+
+// parse + apply (rootEntity derived from target when the adapter supports it)
+engine.run(input, target);
+// or explicit rootEntity:
+engine.run(input, rootEntity, target);
+
+// parse only (requires explicit rootEntity — no target to infer from)
+const parsed = engine.parse(input, rootEntity);
+
+// apply a previously parsed query
+engine.runParsed(parsed, target);
+```
+
+### Errors
+
+Parse failures throw `QueryValidationError` with a `path` field pointing to the offending location in the input (e.g. `"searchBy.posts.title.value"`).
+
+```typescript
+import { QueryValidationError } from "@generazioneai/genquery";
+
+try {
+  engine.run(input, "User", qb);
+} catch (e) {
+  if (e instanceof QueryValidationError) {
+    console.error(e.path, e.message);
+  }
+}
+```
+
+## Examples
+
+See [docs/examples.md](docs/examples.md) for full worked examples covering:
+- String search modes (splitword, exact, nativeregex)
+- Date ranges
+- Numeric comparisons
+- OR conditions
+- Relation filtering and inclusion
+- Pagination and sorting
+
+## Architecture
+
+Three layers, strictly separated:
+
+```
+Wire types (types.ts)
+  └─ Parser validates + normalizes → Parsed types (parsed.ts)
+       └─ Adapter consumes ParsedQuery + Schema → ORM output
+```
+
+Adapters never see wire types. New adapters implement `Adapter<TTarget, TResult>` (re-exported from the package root).
+
+See [docs/custom-adapter.md](docs/custom-adapter.md) for instructions.
+
+## Documentation
+
+| File | Contents |
+|------|----------|
+| [docs/getting-started.md](docs/getting-started.md) | Installation, setup, first query |
+| [docs/query-reference.md](docs/query-reference.md) | Full query language reference |
+| [docs/typeorm-adapter.md](docs/typeorm-adapter.md) | TypeORM adapter options and internals |
+| [docs/custom-adapter.md](docs/custom-adapter.md) | Building a custom adapter |
+| [docs/examples.md](docs/examples.md) | End-to-end examples |
+| [spec.md](spec.md) | Source-of-truth wire format spec |
+
+## License
+
+[BSD 3-Clause](LICENSE)

package/dist/adapters/base.d.ts

@@ -0,0 +1,32 @@
+import type { ParsedQuery } from "../parsed";
+import type { Schema } from "../schema";
+/**
+ * Adapters translate a `ParsedQuery` into ORM-specific operations.
+ *
+ * The interface is intentionally generic in both the host-provided target
+ * (e.g. a TypeORM `SelectQueryBuilder`, a Prisma client, ...) and the produced
+ * result (e.g. the same query builder mutated in place, a Prisma `findMany`
+ * argument object, ...). Each adapter declares the concrete shapes through
+ * its own module.
+ */
+export interface Adapter<TTarget, TResult> {
+    /** Stable adapter identifier (e.g. "typeorm", "prisma"). Useful for logging. */
+    readonly name: string;
+    /** Returns the schema the adapter was built against. */
+    readonly schema: Schema;
+    /**
+     * Apply the parsed query against `target`. Implementations are free to
+     * mutate `target` and return it, or to build a fresh value.
+     */
+    apply(target: TTarget, query: ParsedQuery): TResult;
+    /**
+     * Optionally derive the root entity name from a target. When implemented,
+     * `engine.run(input, target)` can be called without an explicit
+     * `rootEntity` string — the engine asks the adapter to extract it from the
+     * target (e.g. TypeORM exposes it via `qb.expressionMap.mainAlias.metadata`).
+     * Return `undefined` if the target lacks the metadata; the engine will
+     * throw a helpful error.
+     */
+    getRootEntity?(target: TTarget): string | undefined;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO,CAAC,OAAO,EAAE,OAAO;IACvC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAEpD;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACrD"}

package/dist/adapters/base.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":""}

package/dist/adapters/typeorm/adapter.d.ts

@@ -0,0 +1,35 @@
+import { type ObjectLiteral, type SelectQueryBuilder } from "typeorm";
+import type { ParsedQuery } from "../../parsed";
+import { type Schema } from "../../schema";
+import type { Adapter } from "../base";
+export interface TypeORMAdapterOptions {
+    /** Override the parameter name prefix used in generated SQL. */
+    paramPrefix?: string;
+}
+/**
+ * Applies a parsed GenQuery to a TypeORM `SelectQueryBuilder`. The builder is
+ * mutated in place and returned for convenience.
+ *
+ * Typical use:
+ *
+ *   const qb = userRepo.createQueryBuilder("user");
+ *   adapter.apply(qb, parsed);
+ *   const rows = await qb.getMany();
+ */
+export declare class TypeORMAdapter implements Adapter<SelectQueryBuilder<ObjectLiteral>, SelectQueryBuilder<ObjectLiteral>> {
+    readonly schema: Schema;
+    private readonly options;
+    readonly name = "typeorm";
+    constructor(schema: Schema, options?: TypeORMAdapterOptions);
+    /**
+     * Derive the root entity name from a TypeORM `SelectQueryBuilder`. Returns
+     * the entity class name as TypeORM knows it (e.g. `"User"`), so the engine
+     * can look it up in the schema without the caller having to repeat it.
+     */
+    getRootEntity(qb: SelectQueryBuilder<ObjectLiteral>): string | undefined;
+    apply<T extends ObjectLiteral>(qb: SelectQueryBuilder<T>, query: ParsedQuery): SelectQueryBuilder<T>;
+    private applyRootSelect;
+    private applyJoin;
+    private applyPagination;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/typeorm/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/typeorm/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAEL,KAAK,MAAM,EAGZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,cACX,YACE,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;aAK7D,MAAM,EAAE,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,QAAQ,CAAC,IAAI,aAAa;gBAGR,MAAM,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B;IAGtD;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,kBAAkB,CAAC,aAAa,CAAC,GAAG,MAAM,GAAG,SAAS;IAIxE,KAAK,CAAC,CAAC,SAAS,aAAa,EAC3B,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,WAAW,GACjB,kBAAkB,CAAC,CAAC,CAAC;IA8CxB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,eAAe;CAWxB"}

package/dist/adapters/typeorm/adapter.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeORMAdapter = void 0;
+const typeorm_1 = require("typeorm");
+const schema_1 = require("../../schema");
+const aliases_1 = require("./aliases");
+const joins_1 = require("./joins");
+const params_1 = require("./params");
+const where_1 = require("./where");
+/**
+ * Applies a parsed GenQuery to a TypeORM `SelectQueryBuilder`. The builder is
+ * mutated in place and returned for convenience.
+ *
+ * Typical use:
+ *
+ *   const qb = userRepo.createQueryBuilder("user");
+ *   adapter.apply(qb, parsed);
+ *   const rows = await qb.getMany();
+ */
+class TypeORMAdapter {
+    constructor(schema, options = {}) {
+        this.schema = schema;
+        this.options = options;
+        this.name = "typeorm";
+    }
+    /**
+     * Derive the root entity name from a TypeORM `SelectQueryBuilder`. Returns
+     * the entity class name as TypeORM knows it (e.g. `"User"`), so the engine
+     * can look it up in the schema without the caller having to repeat it.
+     */
+    getRootEntity(qb) {
+        return qb.expressionMap?.mainAlias?.metadata?.name;
+    }
+    apply(qb, query) {
+        const rootEntity = (0, schema_1.getEntity)(this.schema, query.rootEntity);
+        const aliases = new aliases_1.AliasRegistry(qb.alias);
+        const params = new params_1.ParamCounter(this.options.paramPrefix);
+        // 1. Root selection (must happen before leftJoinAndSelect calls, since
+        //    `.select()` replaces the entire selection list).
+        this.applyRootSelect(qb, rootEntity, query.select, aliases.root());
+        // 2. Plan + apply all joins (includes + searchBy relations).
+        const plans = (0, joins_1.planJoins)(query, this.schema, aliases);
+        for (const plan of plans) {
+            this.applyJoin(qb, plan);
+        }
+        // 3. WHERE.
+        if (query.searchBy) {
+            const ctx = {
+                schema: this.schema,
+                aliases,
+                params,
+                paramBag: {},
+                currentAlias: aliases.root(),
+                currentPath: "",
+                currentEntity: query.rootEntity,
+                connection: qb.connection,
+            };
+            qb.andWhere(new typeorm_1.Brackets((sub) => (0, where_1.applySearchByInside)(sub, query.searchBy, ctx)));
+        }
+        // 4. ORDER BY.
+        if (query.orderBy) {
+            qb.addOrderBy(`${aliases.root()}.${query.orderBy.field}`, query.orderBy.order.toUpperCase());
+        }
+        // 5. Pagination.
+        this.applyPagination(qb, query.pagination);
+        return qb;
+    }
+    applyRootSelect(qb, entity, select, rootAlias) {
+        if (select.kind === "all")
+            return; // default behaviour
+        const pk = (0, schema_1.primaryKeyOf)(entity);
+        if (select.kind === "none") {
+            qb.select([`${rootAlias}.${pk}`]);
+            return;
+        }
+        // fields
+        const set = new Set(select.fields);
+        set.add(pk); // keep primary key so hydration + relations still work
+        qb.select([...set].map((f) => `${rootAlias}.${f}`));
+    }
+    applyJoin(qb, plan) {
+        const targetEntity = (0, schema_1.getEntity)(this.schema, plan.targetEntity);
+        switch (plan.selection.kind) {
+            case "none":
+                qb.leftJoin(plan.propertyPath, plan.alias);
+                return;
+            case "all":
+                qb.leftJoinAndSelect(plan.propertyPath, plan.alias);
+                return;
+            case "fields": {
+                qb.leftJoin(plan.propertyPath, plan.alias);
+                const pk = (0, schema_1.primaryKeyOf)(targetEntity);
+                const set = new Set(plan.selection.fields);
+                set.add(pk);
+                qb.addSelect([...set].map((f) => `${plan.alias}.${f}`));
+                return;
+            }
+        }
+    }
+    applyPagination(qb, pagination) {
+        if (pagination.kind === "all")
+            return;
+        if (pagination.kind === "first") {
+            qb.skip(0).take(1);
+            return;
+        }
+        qb.skip(pagination.page * pagination.perPage).take(pagination.perPage);
+    }
+}
+exports.TypeORMAdapter = TypeORMAdapter;
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/typeorm/adapter.js.map

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

package/dist/adapters/typeorm/aliases.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Manages join aliases for a single query. Each (path, alias) pair is unique
+ * within a query builder; aliases are derived from the relation path and a
+ * monotonic counter to avoid collisions and to stay under Postgres' identifier
+ * limit (63 chars).
+ */
+export declare class AliasRegistry {
+    private rootAlias;
+    private byPath;
+    private counter;
+    constructor(rootAlias: string);
+    /** Returns the alias for `path` if a join was previously registered. */
+    get(path: string): string | undefined;
+    /** Returns the alias for the root entity. */
+    root(): string;
+    /**
+     * Register an alias for `path`. `path` is expected to be a dot-joined chain
+     * of relation names (e.g. "posts.comments"). The alias incorporates the path
+     * but is truncated and suffixed with a counter for uniqueness.
+     */
+    register(path: string): string;
+    /** Iterate registered (path, alias) pairs in insertion order. */
+    entries(): IterableIterator<[string, string]>;
+}
+//# sourceMappingURL=aliases.d.ts.map

package/dist/adapters/typeorm/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../../src/adapters/typeorm/aliases.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,aAAa;IAIZ,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAAK;gBAEA,SAAS,EAAE,MAAM;IAErC,wEAAwE;IACxE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrC,6CAA6C;IAC7C,IAAI,IAAI,MAAM;IAId;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY9B,iEAAiE;IACjE,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAG9C"}

package/dist/adapters/typeorm/aliases.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AliasRegistry = void 0;
+/**
+ * Manages join aliases for a single query. Each (path, alias) pair is unique
+ * within a query builder; aliases are derived from the relation path and a
+ * monotonic counter to avoid collisions and to stay under Postgres' identifier
+ * limit (63 chars).
+ */
+class AliasRegistry {
+    constructor(rootAlias) {
+        this.rootAlias = rootAlias;
+        this.byPath = new Map();
+        this.counter = 0;
+    }
+    /** Returns the alias for `path` if a join was previously registered. */
+    get(path) {
+        return this.byPath.get(path);
+    }
+    /** Returns the alias for the root entity. */
+    root() {
+        return this.rootAlias;
+    }
+    /**
+     * Register an alias for `path`. `path` is expected to be a dot-joined chain
+     * of relation names (e.g. "posts.comments"). The alias incorporates the path
+     * but is truncated and suffixed with a counter for uniqueness.
+     */
+    register(path) {
+        const existing = this.byPath.get(path);
+        if (existing)
+            return existing;
+        const suffix = String(this.counter++);
+        const base = `${this.rootAlias}_${path.replace(/\./g, "_")}`;
+        // Stay well under Postgres' 63-char identifier limit.
+        const trimmed = base.length > 50 ? base.slice(0, 50) : base;
+        const alias = `${trimmed}_${suffix}`;
+        this.byPath.set(path, alias);
+        return alias;
+    }
+    /** Iterate registered (path, alias) pairs in insertion order. */
+    entries() {
+        return this.byPath.entries();
+    }
+}
+exports.AliasRegistry = AliasRegistry;
+//# sourceMappingURL=aliases.js.map

package/dist/adapters/typeorm/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../../src/adapters/typeorm/aliases.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,aAAa;IAIxB,YAAoB,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;QAH7B,WAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACnC,YAAO,GAAG,CAAC,CAAC;IAEoB,CAAC;IAEzC,wEAAwE;IACxE,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,6CAA6C;IAC7C,IAAI;QACF,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAY;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7D,sDAAsD;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,MAAM,KAAK,GAAG,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iEAAiE;IACjE,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF;AArCD,sCAqCC"}

package/dist/adapters/typeorm/create.d.ts

@@ -0,0 +1,29 @@
+import type { DataSource, ObjectLiteral, SelectQueryBuilder } from "typeorm";
+import { GenQueryEngine } from "../../engine";
+import { type TypeORMAdapterOptions } from "./adapter";
+import { type SchemaFromTypeORMOptions } from "./schema-from-typeorm";
+export interface CreateTypeORMEngineOptions {
+    /** Options forwarded to `schemaFromTypeORM` (entity filter, overrides, ...). */
+    schema?: SchemaFromTypeORMOptions;
+    /** Options forwarded to the `TypeORMAdapter` constructor (paramPrefix, ...). */
+    adapter?: TypeORMAdapterOptions;
+}
+/**
+ * One-line setup for the common case: read the schema from TypeORM, build the
+ * adapter and the engine.
+ *
+ *   await dataSource.initialize();
+ *   const engine = createTypeORMEngine(dataSource);
+ *
+ * For per-entity type overrides or custom adapter parameters:
+ *
+ *   const engine = createTypeORMEngine(dataSource, {
+ *     schema:  { entities: [User, Post], overrides: { User: { meta: "string" } } },
+ *     adapter: { paramPrefix: "q" },
+ *   });
+ *
+ * The DataSource must be initialized before calling this — `entityMetadatas`
+ * is empty otherwise.
+ */
+export declare function createTypeORMEngine(dataSource: DataSource, options?: CreateTypeORMEngineOptions): GenQueryEngine<SelectQueryBuilder<ObjectLiteral>, SelectQueryBuilder<ObjectLiteral>>;
+//# sourceMappingURL=create.d.ts.map

package/dist/adapters/typeorm/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/adapters/typeorm/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,gFAAgF;IAChF,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,0BAA+B,GACvC,cAAc,CACf,kBAAkB,CAAC,aAAa,CAAC,EACjC,kBAAkB,CAAC,aAAa,CAAC,CAClC,CAIA"}

package/dist/adapters/typeorm/create.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTypeORMEngine = createTypeORMEngine;
+const engine_1 = require("../../engine");
+const adapter_1 = require("./adapter");
+const schema_from_typeorm_1 = require("./schema-from-typeorm");
+/**
+ * One-line setup for the common case: read the schema from TypeORM, build the
+ * adapter and the engine.
+ *
+ *   await dataSource.initialize();
+ *   const engine = createTypeORMEngine(dataSource);
+ *
+ * For per-entity type overrides or custom adapter parameters:
+ *
+ *   const engine = createTypeORMEngine(dataSource, {
+ *     schema:  { entities: [User, Post], overrides: { User: { meta: "string" } } },
+ *     adapter: { paramPrefix: "q" },
+ *   });
+ *
+ * The DataSource must be initialized before calling this — `entityMetadatas`
+ * is empty otherwise.
+ */
+function createTypeORMEngine(dataSource, options = {}) {
+    const schema = (0, schema_from_typeorm_1.schemaFromTypeORM)(dataSource, options.schema);
+    const adapter = new adapter_1.TypeORMAdapter(schema, options.adapter);
+    return new engine_1.GenQueryEngine({ adapter });
+}
+//# sourceMappingURL=create.js.map

package/dist/adapters/typeorm/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/adapters/typeorm/create.ts"],"names":[],"mappings":";;AAgCA,kDAUC;AAzCD,yCAA8C;AAC9C,uCAAuE;AACvE,+DAG+B;AAS/B;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,mBAAmB,CACjC,UAAsB,EACtB,UAAsC,EAAE;IAKxC,MAAM,MAAM,GAAG,IAAA,uCAAiB,EAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,wBAAc,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,OAAO,IAAI,uBAAc,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/adapters/typeorm/escape.d.ts

@@ -0,0 +1,5 @@
+/** Escape user input that will be embedded in a LIKE/ILIKE pattern. */
+export declare function escapeLike(value: string): string;
+/** Split a search string by whitespace, dropping empty parts. */
+export declare function splitWords(value: string): string[];
+//# sourceMappingURL=escape.d.ts.map

package/dist/adapters/typeorm/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../../src/adapters/typeorm/escape.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAElD"}

package/dist/adapters/typeorm/escape.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeLike = escapeLike;
+exports.splitWords = splitWords;
+/** Escape user input that will be embedded in a LIKE/ILIKE pattern. */
+function escapeLike(value) {
+    return value.replace(/\\/g, "\\\\").replace(/%/g, "\\%").replace(/_/g, "\\_");
+}
+/** Split a search string by whitespace, dropping empty parts. */
+function splitWords(value) {
+    return value.split(/\s+/).filter((s) => s.length > 0);
+}
+//# sourceMappingURL=escape.js.map

package/dist/adapters/typeorm/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../../src/adapters/typeorm/escape.ts"],"names":[],"mappings":";;AACA,gCAEC;AAGD,gCAEC;AARD,uEAAuE;AACvE,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,iEAAiE;AACjE,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/adapters/typeorm/index.d.ts

@@ -0,0 +1,4 @@
+export { TypeORMAdapter, type TypeORMAdapterOptions } from "./adapter";
+export { schemaFromTypeORM, type SchemaFromTypeORMOptions, } from "./schema-from-typeorm";
+export { createTypeORMEngine, type CreateTypeORMEngineOptions, } from "./create";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/typeorm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/typeorm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,UAAU,CAAC"}

package/dist/adapters/typeorm/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTypeORMEngine = exports.schemaFromTypeORM = exports.TypeORMAdapter = void 0;
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "TypeORMAdapter", { enumerable: true, get: function () { return adapter_1.TypeORMAdapter; } });
+var schema_from_typeorm_1 = require("./schema-from-typeorm");
+Object.defineProperty(exports, "schemaFromTypeORM", { enumerable: true, get: function () { return schema_from_typeorm_1.schemaFromTypeORM; } });
+var create_1 = require("./create");
+Object.defineProperty(exports, "createTypeORMEngine", { enumerable: true, get: function () { return create_1.createTypeORMEngine; } });
+//# sourceMappingURL=index.js.map