@rapiq/typeorm 2.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 Peter Placzek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @rapiq/typeorm
+
+Part of [rapiq](https://github.com/tada5hi/rapiq) — typed REST queries: build, transport, validate, execute.
+
+Applies a parsed [`Query`](https://rapiq.tada5hi.net/guide/query-ast) directly to a TypeORM `SelectQueryBuilder` — filters become parameterized `WHERE` conditions, relations become joins, fields/sort/pagination map to `select`/`orderBy`/`take`+`skip`.
+
+## Installation
+
+```sh
+npm install @rapiq/core @rapiq/sql @rapiq/typeorm
+```
+
+## Usage
+
+```typescript
+import { TypeormAdapter } from '@rapiq/typeorm';
+
+const queryBuilder = dataSource.getRepository(User).createQueryBuilder('user');
+
+const adapter = new TypeormAdapter({
+    queryBuilder,
+    relations: { joinAndSelect: true },
+});
+
+const { pagination } = adapter.execute(query);
+
+const [entities, total] = await queryBuilder.getManyAndCount();
+```
+
+The `queryBuilder` (the builder to write into) is bound at construction; `adapter.execute(query)` then walks the parsed `Query`, collects the state into its sub-adapters, and applies it to that builder — returning the applied pagination (e.g. for the response `meta` block). State is cleared before each call by default (pass `{ clear: false }` as the second argument to apply several queries onto the same builder).
+
+Construct the adapter **per request**, like the `SelectQueryBuilder` you hand it — it holds per-call state. The shareable, long-lived part is your config (`relations`, …), spread into the per-request options with the request's builder as `queryBuilder`.
+
+The SQL dialect is resolved from the attached builder's connection type; joins are applied idempotently and validated against the entity metadata. Options: `relations.joinAndSelect` (hydrate related entities), `relations.joinType` (`'left'` default / `'inner'`), and an `onJoin(path, alias, queryBuilder)` hook per applied join. Per-parameter visitors from [@rapiq/sql](https://www.npmjs.com/package/@rapiq/sql) work against the adapter's sub-adapters (`adapter.filters`, `adapter.sort`, …) when only part of a query applies.
+
+Typically the query comes from a [URL decoder](https://www.npmjs.com/package/@rapiq/codec-url) validating `req.query` against a schema — see the [end-to-end example](https://rapiq.tada5hi.net/guide/recipes/express-typeorm) in the docs.
+
+Migrating from typeorm-extension's `applyQuery`? The defaults mirror its contract (`leftJoinAndSelect`, returned pagination) — see the [migration guide](https://rapiq.tada5hi.net/guide/migration-typeorm-extension).
+
+## Documentation
+
+Full guide (options, dialect detection, alias convention): [rapiq.tada5hi.net/packages/typeorm](https://rapiq.tada5hi.net/packages/typeorm)
+
+## License
+
+Published under the [MIT License](https://github.com/tada5hi/rapiq/blob/master/LICENSE).

package/dist/index.d.mts

@@ -0,0 +1,116 @@
+import { DialectOptions, ExecuteOptions, FieldsBaseAdapter, FiltersBaseAdapter, IRootAdapter, PaginationBaseAdapter, RelationsAdapterBaseOptions, RelationsBaseAdapter, SortBaseAdapter } from "@rapiq/sql";
+import { IQuery } from "@rapiq/core";
+import { SelectQueryBuilder } from "typeorm";
+//#region src/adapter/types.d.ts
+type RelationsAdapterJoinType = 'left' | 'inner';
+type RelationsAdapterOptions = RelationsAdapterBaseOptions & {
+  /**
+   * Join strategy for relations.
+   * Defaults to 'left' so records with absent relations are kept
+   * (matches typeorm-extension's leftJoinAndSelect behavior).
+   */
+  joinType?: RelationsAdapterJoinType;
+  /**
+   * Invoked for every join this adapter applies (skipped joins,
+   * e.g. pre-existing ones, do not trigger it). Useful to extend
+   * the query per join, e.g. `queryBuilder.addGroupBy(`${alias}.id`)`.
+   */
+  onJoin?: (path: string, alias: string, queryBuilder: SelectQueryBuilder<any>) => void;
+};
+type TypeormAdapterOptions = {
+  /**
+   * The query builder to apply the parsed query to.
+   */
+  queryBuilder: SelectQueryBuilder<any>;
+  relations?: RelationsAdapterOptions;
+};
+type TypeormAdapterOutput = {
+  /**
+   * The pagination actually applied to the query builder,
+   * e.g. for the response meta block.
+   */
+  pagination: {
+    limit: number | undefined;
+    offset: number | undefined;
+  };
+};
+//#endregion
+//#region src/adapter/relations.d.ts
+declare class RelationsAdapter extends RelationsBaseAdapter {
+  protected queryBuilder: SelectQueryBuilder<any>;
+  protected options: RelationsAdapterOptions;
+  constructor(queryBuilder: SelectQueryBuilder<any>, options?: RelationsAdapterOptions);
+  execute(): void;
+  protected join(input: string): boolean;
+  protected applyJoin(property: string, alias: string): void;
+}
+//#endregion
+//#region src/adapter/fields.d.ts
+declare class FieldsAdapter extends FieldsBaseAdapter {
+  protected queryBuilder: SelectQueryBuilder<any>;
+  constructor(queryBuilder: SelectQueryBuilder<any>, relations: RelationsAdapter);
+  rootAlias(): string | undefined;
+  escapeField(field: string): string;
+  execute(): void;
+}
+//#endregion
+//#region src/adapter/filters.d.ts
+declare class FiltersAdapter extends FiltersBaseAdapter<RelationsAdapter> {
+  protected queryBuilder: SelectQueryBuilder<any>;
+  protected dialect: DialectOptions;
+  protected paramNamespace: string;
+  constructor(queryBuilder: SelectQueryBuilder<any>, relations: RelationsAdapter);
+  clear(): void;
+  rootAlias(): string | undefined;
+  escapeField(field: string): string;
+  paramPlaceholder(index: number): string;
+  isRegexpSupported(): boolean;
+  regexp(field: string, placeholder: string, ignoreCase: boolean): string;
+  caseFold(input: string): string;
+  isCaseFoldable(field: string): boolean;
+  child(): this;
+  execute(): void;
+}
+//#endregion
+//#region src/adapter/sort.d.ts
+declare class SortAdapter extends SortBaseAdapter {
+  protected queryBuilder: SelectQueryBuilder<any>;
+  constructor(queryBuilder: SelectQueryBuilder<any>, relations: RelationsAdapter);
+  rootAlias(): string | undefined;
+  escapeField(field: string): string;
+  execute(): void;
+}
+//#endregion
+//#region src/adapter/pagination.d.ts
+declare class PaginationAdapter extends PaginationBaseAdapter {
+  protected queryBuilder: SelectQueryBuilder<any>;
+  constructor(queryBuilder: SelectQueryBuilder<any>);
+  execute(): void;
+}
+//#endregion
+//#region src/adapter/module.d.ts
+declare class TypeormAdapter implements IRootAdapter<TypeormAdapterOutput> {
+  readonly relations: RelationsAdapter;
+  readonly fields: FieldsAdapter;
+  readonly filters: FiltersAdapter;
+  readonly pagination: PaginationAdapter;
+  readonly sort: SortAdapter;
+  constructor(options: TypeormAdapterOptions);
+  clear(): void;
+  /**
+   * Walk `query` into the sub-adapters and apply the accumulated state
+   * to the queryBuilder query builder (bound at construction).
+   */
+  execute(query: IQuery, options?: ExecuteOptions): TypeormAdapterOutput;
+}
+//#endregion
+//#region src/dialect.d.ts
+/**
+ * Resolve the {@link DialectOptions} preset matching the query builder's
+ * connection type. The postgres preset is the documented last-resort
+ * default when the connection type has no matching preset.
+ */
+declare function resolveQueryDialect(query: SelectQueryBuilder<any>): DialectOptions;
+//#endregion
+export { FieldsAdapter, FiltersAdapter, PaginationAdapter, RelationsAdapter, RelationsAdapterJoinType, RelationsAdapterOptions, SortAdapter, TypeormAdapter, TypeormAdapterOptions, TypeormAdapterOutput, resolveQueryDialect };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapter/types.ts","../src/adapter/relations.ts","../src/adapter/fields.ts","../src/adapter/filters.ts","../src/adapter/sort.ts","../src/adapter/pagination.ts","../src/adapter/module.ts","../src/dialect.ts"],"mappings":";;;;KAUY;KAEA,0BAA0B;;;;;;EAMlC,WAAW;;;;;;EAOX,UAAU,cAAc,eAAe,cAAc;;KAG7C;;;;EAIR,cAAc;EACd,YAAY;;KAGJ;;;;;EAKR;IACI;IACA;;;;;cChCK,yBAAyB;YACxB,cAAe;YAEf,SAAU;cAGhB,cAAc,yBACd,UAAS;EAQb;YAYU,KAAK;YA0CL,UAAU,kBAAkB;;;;cCrE7B,sBAAsB;YACrB,cAAe;cAEb,cAAc,yBAAyB,WAAW;EAM9D;EAIA,YAAY;EAOZ;;;;cC+DS,uBAAuB,mBAAmB;YACzC,cAAe;YAEf,SAAU;YAEV;cAEE,cAAc,yBAAyB,WAAW;EAQrD;EAQT;EAIA,YAAY;EAIZ,iBAAiB;EAIR;EAIT,OAAO,eAAe,qBAAqB;EAQlC,SAAS;EAQT,eAAe;EAcxB;EAWA;;;;cCnKS,oBAAoB;YACnB,cAAe;cAEb,cAAc,yBAAyB,WAAW;EAM9D;EAIA,YAAY;EAOZ;;;;cCrBS,0BAA0B;YACzB,cAAe;cAEb,cAAc;EAMjB;;;;cCFA,0BAA0B,aAAa;WAChC,WAAY;WAEZ,QAAS;WAET,SAAU;WAEV,YAAa;WAEb,MAAO;cAEX,SAAS;EAQrB;;;;;EAYA,QACI,OAAO,QACP,UAAS,iBACT;;;;;;;;;iBCnCQ,oBACZ,OAAO,0BACP"}

package/dist/index.mjs

@@ -0,0 +1,270 @@
+import { FieldsBaseAdapter, FiltersBaseAdapter, PaginationBaseAdapter, QueryVisitor, RelationsBaseAdapter, SortBaseAdapter, pg, resolveDialect, splitFirst } from "@rapiq/sql";
+import { AdapterError } from "@rapiq/core";
+//#region src/adapter/fields.ts
+var FieldsAdapter = class extends FieldsBaseAdapter {
+	queryBuilder;
+	constructor(queryBuilder, relations) {
+		super(relations);
+		this.queryBuilder = queryBuilder;
+	}
+	rootAlias() {
+		return this.queryBuilder.alias;
+	}
+	escapeField(field) {
+		return field;
+	}
+	execute() {
+		const columns = this.getColumns();
+		if (columns.length > 0) this.queryBuilder.select(columns);
+	}
+};
+//#endregion
+//#region src/dialect.ts
+/**
+* Resolve the {@link DialectOptions} preset matching the query builder's
+* connection type. The postgres preset is the documented last-resort
+* default when the connection type has no matching preset.
+*/
+function resolveQueryDialect(query) {
+	const dialect = resolveDialect(query.connection.options.type);
+	if (dialect) return dialect;
+	return pg;
+}
+//#endregion
+//#region src/adapter/filters.ts
+/**
+* Column types whose values are strings and therefore participate in
+* case-insensitive equality folding. Non-string columns never fold —
+* lower() on them is wasted work at best and a type error at worst
+* (e.g. `lower(integer)` on postgres).
+*/
+const CASE_FOLDABLE_COLUMN_TYPES = /* @__PURE__ */ new Set([
+	"varchar",
+	"character varying",
+	"varying character",
+	"char varying",
+	"nvarchar",
+	"national varchar",
+	"char",
+	"nchar",
+	"national char",
+	"character",
+	"native character",
+	"text",
+	"tinytext",
+	"mediumtext",
+	"longtext",
+	"ntext",
+	"citext",
+	"string"
+]);
+function isCaseFoldableColumnType(type) {
+	if (type === String) return true;
+	return typeof type === "string" && CASE_FOLDABLE_COLUMN_TYPES.has(type);
+}
+/**
+* TypeORM parameters are global to the query builder and last-write-wins,
+* so every filter application needs its own namespace: positional names
+* like `:0` would silently rebind a caller-owned `:0` parameter — or, on
+* a re-run, the previous run's clauses.
+*/
+let PARAM_NAMESPACE_SEQ = 0;
+function nextParamNamespace() {
+	PARAM_NAMESPACE_SEQ += 1;
+	return `rapiq_${PARAM_NAMESPACE_SEQ}_`;
+}
+/**
+* Resolve a (possibly relation-dotted) property path to its column,
+* descending through relation metadata segment by segment; embedded
+* paths resolve through the plain column lookup per step.
+*/
+function findColumnByPropertyPath(metadata, path) {
+	let current = metadata;
+	const segments = path.split(".");
+	for (let i = 0; i < segments.length; i++) {
+		const segment = segments[i];
+		if (!segment) return;
+		const column = current.findColumnWithPropertyPath(segments.slice(i).join("."));
+		if (column) return column;
+		const relation = current.findRelationWithPropertyPath(segment);
+		if (!relation) return;
+		current = relation.inverseEntityMetadata;
+	}
+}
+var FiltersAdapter = class FiltersAdapter extends FiltersBaseAdapter {
+	queryBuilder;
+	dialect;
+	paramNamespace;
+	constructor(queryBuilder, relations) {
+		super(relations);
+		this.queryBuilder = queryBuilder;
+		this.dialect = resolveQueryDialect(queryBuilder);
+		this.paramNamespace = nextParamNamespace();
+	}
+	clear() {
+		super.clear();
+		this.paramNamespace = nextParamNamespace();
+	}
+	rootAlias() {
+		return this.queryBuilder.alias;
+	}
+	escapeField(field) {
+		return this.queryBuilder.escape(field);
+	}
+	paramPlaceholder(index) {
+		return `:${this.paramNamespace}${index - 1}`;
+	}
+	isRegexpSupported() {
+		return typeof this.dialect.regexp !== "undefined";
+	}
+	regexp(field, placeholder, ignoreCase) {
+		if (this.dialect.regexp) return this.dialect.regexp(field, placeholder, ignoreCase);
+		throw AdapterError.featureUnsupported("regexp");
+	}
+	caseFold(input) {
+		if (this.dialect.caseFold) return this.dialect.caseFold(input);
+		return super.caseFold(input);
+	}
+	isCaseFoldable(field) {
+		const { mainAlias } = this.queryBuilder.expressionMap;
+		if (!mainAlias || !mainAlias.hasMetadata) return super.isCaseFoldable(field);
+		const column = findColumnByPropertyPath(mainAlias.metadata, field);
+		if (!column) return super.isCaseFoldable(field);
+		return isCaseFoldableColumnType(column.type);
+	}
+	child() {
+		const child = new FiltersAdapter(this.queryBuilder, this.relations);
+		this.setChildAttributes(child);
+		child.paramNamespace = this.paramNamespace;
+		return child;
+	}
+	execute() {
+		const [sql, params] = this.getQueryAndParameters();
+		if (sql) {
+			const parameters = {};
+			for (const [i, param] of params.entries()) parameters[`${this.paramNamespace}${i}`] = param;
+			this.queryBuilder.andWhere(sql, parameters);
+		}
+	}
+};
+//#endregion
+//#region src/adapter/relations.ts
+var RelationsAdapter = class extends RelationsBaseAdapter {
+	queryBuilder;
+	options;
+	constructor(queryBuilder, options = {}) {
+		super(options);
+		this.queryBuilder = queryBuilder;
+		this.options = options;
+	}
+	execute() {
+		for (const relation of this.value) {
+			if (relation.executed) continue;
+			if (this.join(relation.path)) relation.executed = true;
+		}
+	}
+	join(input) {
+		let relationFullName = input;
+		let path;
+		let meta = this.queryBuilder.expressionMap.mainAlias.metadata;
+		let parentAlias = this.queryBuilder.alias;
+		const { joinAttributes } = this.queryBuilder.expressionMap;
+		while (relationFullName) {
+			let relationName;
+			[relationName, relationFullName] = splitFirst(relationFullName);
+			path = path ? `${path}.${relationName}` : relationName;
+			const relation = meta.findRelationWithPropertyPath(relationName);
+			if (!relation) return false;
+			const alias = this.buildAlias(path);
+			if (!joinAttributes.some((joinAttribute) => joinAttribute.alias.name === alias)) {
+				this.applyJoin(`${parentAlias}.${relationName}`, alias);
+				if (this.options.onJoin) this.options.onJoin(path, alias, this.queryBuilder);
+			}
+			meta = relation.inverseEntityMetadata;
+			parentAlias = alias;
+		}
+		return true;
+	}
+	applyJoin(property, alias) {
+		const inner = this.options.joinType === "inner";
+		if (this.options.joinAndSelect) if (inner) this.queryBuilder.innerJoinAndSelect(property, alias);
+		else this.queryBuilder.leftJoinAndSelect(property, alias);
+		else if (inner) this.queryBuilder.innerJoin(property, alias);
+		else this.queryBuilder.leftJoin(property, alias);
+	}
+};
+//#endregion
+//#region src/adapter/sort.ts
+var SortAdapter = class extends SortBaseAdapter {
+	queryBuilder;
+	constructor(queryBuilder, relations) {
+		super(relations);
+		this.queryBuilder = queryBuilder;
+	}
+	rootAlias() {
+		return this.queryBuilder.alias;
+	}
+	escapeField(field) {
+		return field;
+	}
+	execute() {
+		if (Object.keys(this.value).length > 0) this.queryBuilder.orderBy(this.value);
+	}
+};
+//#endregion
+//#region src/adapter/pagination.ts
+var PaginationAdapter = class extends PaginationBaseAdapter {
+	queryBuilder;
+	constructor(queryBuilder) {
+		super();
+		this.queryBuilder = queryBuilder;
+	}
+	execute() {
+		if (typeof this.limit !== "undefined") this.queryBuilder.take(this.limit ?? void 0);
+		if (typeof this.offset !== "undefined") this.queryBuilder.skip(this.offset ?? void 0);
+	}
+};
+//#endregion
+//#region src/adapter/module.ts
+var TypeormAdapter = class {
+	relations;
+	fields;
+	filters;
+	pagination;
+	sort;
+	constructor(options) {
+		this.relations = new RelationsAdapter(options.queryBuilder, options.relations);
+		this.fields = new FieldsAdapter(options.queryBuilder, this.relations);
+		this.filters = new FiltersAdapter(options.queryBuilder, this.relations);
+		this.pagination = new PaginationAdapter(options.queryBuilder);
+		this.sort = new SortAdapter(options.queryBuilder, this.relations);
+	}
+	clear() {
+		this.fields.clear();
+		this.filters.clear();
+		this.pagination.clear();
+		this.sort.clear();
+		this.relations.clear();
+	}
+	/**
+	* Walk `query` into the sub-adapters and apply the accumulated state
+	* to the queryBuilder query builder (bound at construction).
+	*/
+	execute(query, options = {}) {
+		if (options.clear ?? true) this.clear();
+		query.accept(new QueryVisitor(this, options.visitor));
+		this.fields.execute();
+		this.filters.execute();
+		this.pagination.execute();
+		this.sort.execute();
+		this.relations.execute();
+		return { pagination: {
+			limit: this.pagination.limit,
+			offset: this.pagination.offset
+		} };
+	}
+};
+//#endregion
+export { FieldsAdapter, FiltersAdapter, PaginationAdapter, RelationsAdapter, SortAdapter, TypeormAdapter, resolveQueryDialect };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/adapter/fields.ts","../src/dialect.ts","../src/adapter/filters.ts","../src/adapter/relations.ts","../src/adapter/sort.ts","../src/adapter/pagination.ts","../src/adapter/module.ts"],"sourcesContent":["/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { FieldsBaseAdapter } from '@rapiq/sql';\nimport type { SelectQueryBuilder } from 'typeorm';\nimport type { RelationsAdapter } from './relations';\n\nexport class FieldsAdapter extends FieldsBaseAdapter {\n    protected queryBuilder : SelectQueryBuilder<any>;\n\n    constructor(queryBuilder: SelectQueryBuilder<any>, relations: RelationsAdapter) {\n        super(relations);\n\n        this.queryBuilder = queryBuilder;\n    }\n\n    rootAlias(): string | undefined {\n        return this.queryBuilder.alias;\n    }\n\n    escapeField(field: string) {\n        // selection keys must stay `alias.property` — TypeORM resolves\n        // them against its alias map and escapes on its own; pre-escaped\n        // names break column resolution and entity hydration.\n        return field;\n    }\n\n    execute() {\n        const columns = this.getColumns();\n        if (columns.length > 0) {\n            this.queryBuilder.select(columns);\n        }\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { DialectOptions } from '@rapiq/sql';\nimport { pg, resolveDialect } from '@rapiq/sql';\nimport type { SelectQueryBuilder } from 'typeorm';\n\n/**\n * Resolve the {@link DialectOptions} preset matching the query builder's\n * connection type. The postgres preset is the documented last-resort\n * default when the connection type has no matching preset.\n */\nexport function resolveQueryDialect(\n    query: SelectQueryBuilder<any>,\n) : DialectOptions {\n    const dialect = resolveDialect(query.connection.options.type);\n    if (dialect) {\n        return dialect;\n    }\n\n    return pg;\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { AdapterError } from '@rapiq/core';\nimport type { DialectOptions } from '@rapiq/sql';\nimport { FiltersBaseAdapter } from '@rapiq/sql';\nimport type { ColumnType, EntityMetadata, SelectQueryBuilder } from 'typeorm';\nimport { resolveQueryDialect } from '../dialect';\nimport type { RelationsAdapter } from './relations';\n\n/**\n * Column types whose values are strings and therefore participate in\n * case-insensitive equality folding. Non-string columns never fold —\n * lower() on them is wasted work at best and a type error at worst\n * (e.g. `lower(integer)` on postgres).\n */\nconst CASE_FOLDABLE_COLUMN_TYPES = new Set<string>([\n    'varchar', \n    'character varying', \n    'varying character', \n    'char varying',\n    'nvarchar', \n    'national varchar',\n    'char', \n    'nchar', \n    'national char', \n    'character', \n    'native character',\n    'text', \n    'tinytext', \n    'mediumtext', \n    'longtext', \n    'ntext', \n    'citext',\n    'string',\n]);\n\nfunction isCaseFoldableColumnType(type: ColumnType) : boolean {\n    if (type === String) {\n        return true;\n    }\n\n    return typeof type === 'string' && CASE_FOLDABLE_COLUMN_TYPES.has(type);\n}\n\n/**\n * TypeORM parameters are global to the query builder and last-write-wins,\n * so every filter application needs its own namespace: positional names\n * like `:0` would silently rebind a caller-owned `:0` parameter — or, on\n * a re-run, the previous run's clauses.\n */\nlet PARAM_NAMESPACE_SEQ = 0;\n\nfunction nextParamNamespace() : string {\n    PARAM_NAMESPACE_SEQ += 1;\n\n    return `rapiq_${PARAM_NAMESPACE_SEQ}_`;\n}\n\n/**\n * Resolve a (possibly relation-dotted) property path to its column,\n * descending through relation metadata segment by segment; embedded\n * paths resolve through the plain column lookup per step.\n */\nfunction findColumnByPropertyPath(metadata: EntityMetadata, path: string) {\n    let current = metadata;\n    const segments = path.split('.');\n\n    for (let i = 0; i < segments.length; i++) {\n        const segment = segments[i];\n        if (!segment) {\n            return undefined;\n        }\n\n        const column = current.findColumnWithPropertyPath(segments.slice(i).join('.'));\n        if (column) {\n            return column;\n        }\n\n        const relation = current.findRelationWithPropertyPath(segment);\n        if (!relation) {\n            return undefined;\n        }\n\n        current = relation.inverseEntityMetadata;\n    }\n\n    return undefined;\n}\n\nexport class FiltersAdapter extends FiltersBaseAdapter<RelationsAdapter> {\n    protected queryBuilder : SelectQueryBuilder<any>;\n\n    protected dialect : DialectOptions;\n\n    protected paramNamespace : string;\n\n    constructor(queryBuilder: SelectQueryBuilder<any>, relations: RelationsAdapter) {\n        super(relations);\n\n        this.queryBuilder = queryBuilder;\n        this.dialect = resolveQueryDialect(queryBuilder);\n        this.paramNamespace = nextParamNamespace();\n    }\n\n    override clear() {\n        super.clear();\n\n        // a fresh namespace per run: clauses a previous run left on the\n        // builder keep their own bindings instead of being rebound.\n        this.paramNamespace = nextParamNamespace();\n    }\n\n    rootAlias(): string | undefined {\n        return this.queryBuilder.alias;\n    }\n\n    escapeField(field: string) {\n        return this.queryBuilder.escape(field);\n    }\n\n    paramPlaceholder(index: number) : string {\n        return `:${this.paramNamespace}${index - 1}`;\n    }\n\n    override isRegexpSupported() : boolean {\n        return typeof this.dialect.regexp !== 'undefined';\n    }\n\n    regexp(field: string, placeholder: string, ignoreCase: boolean): string {\n        if (this.dialect.regexp) {\n            return this.dialect.regexp(field, placeholder, ignoreCase);\n        }\n\n        throw AdapterError.featureUnsupported('regexp');\n    }\n\n    override caseFold(input: string) : string {\n        if (this.dialect.caseFold) {\n            return this.dialect.caseFold(input);\n        }\n\n        return super.caseFold(input);\n    }\n\n    override isCaseFoldable(field: string) : boolean {\n        const { mainAlias } = this.queryBuilder.expressionMap;\n        if (!mainAlias || !mainAlias.hasMetadata) {\n            return super.isCaseFoldable(field);\n        }\n\n        const column = findColumnByPropertyPath(mainAlias.metadata, field);\n        if (!column) {\n            return super.isCaseFoldable(field);\n        }\n\n        return isCaseFoldableColumnType(column.type);\n    }\n\n    child(): this {\n        const child = new FiltersAdapter(this.queryBuilder, this.relations);\n\n        this.setChildAttributes(child);\n        // children share the placeholder indexer, so they must also\n        // share the namespace their placeholders are rendered with.\n        child.paramNamespace = this.paramNamespace;\n\n        return child as this;\n    }\n\n    execute() {\n        const [sql, params] = this.getQueryAndParameters();\n\n        if (sql) {\n            const parameters : Record<string, unknown> = {};\n            for (const [i, param] of params.entries()) {\n                parameters[`${this.paramNamespace}${i}`] = param;\n            }\n\n            // The builder may already carry an application-owned predicate\n            // (for example a tenant or authorization scope). Rapiq filters\n            // narrow that query; they must never replace its baseline WHERE.\n            this.queryBuilder.andWhere(sql, parameters);\n        }\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { RelationsBaseAdapter, splitFirst } from '@rapiq/sql';\nimport type { SelectQueryBuilder } from 'typeorm';\nimport type { RelationsAdapterOptions } from './types';\n\nexport class RelationsAdapter extends RelationsBaseAdapter {\n    protected queryBuilder : SelectQueryBuilder<any>;\n\n    protected options : RelationsAdapterOptions;\n\n    constructor(\n        queryBuilder: SelectQueryBuilder<any>,\n        options: RelationsAdapterOptions = {},\n    ) {\n        super(options);\n\n        this.queryBuilder = queryBuilder;\n        this.options = options;\n    }\n\n    execute() : void {\n        for (const relation of this.value) {\n            if (relation.executed) {\n                continue;\n            }\n\n            if (this.join(relation.path)) {\n                relation.executed = true;\n            }\n        }\n    }\n\n    protected join(input: string): boolean {\n        let relationFullName : string | undefined = input;\n        let path : string | undefined;\n        let meta = this.queryBuilder.expressionMap.mainAlias!.metadata;\n        let parentAlias = this.queryBuilder.alias;\n\n        const { joinAttributes } = this.queryBuilder.expressionMap;\n\n        while (relationFullName) {\n            let relationName : string;\n            [relationName, relationFullName] = splitFirst(relationFullName);\n\n            path = path ?\n                `${path}.${relationName}` :\n                relationName;\n\n            const relation = meta.findRelationWithPropertyPath(relationName);\n            if (!relation) {\n                return false;\n            }\n\n            const alias = this.buildAlias(path);\n\n            const joined = joinAttributes.some(\n                (joinAttribute) => joinAttribute.alias.name === alias,\n            );\n\n            if (!joined) {\n                this.applyJoin(`${parentAlias}.${relationName}`, alias);\n\n                if (this.options.onJoin) {\n                    this.options.onJoin(path, alias, this.queryBuilder);\n                }\n            }\n\n            meta = relation.inverseEntityMetadata;\n            parentAlias = alias;\n        }\n\n        return true;\n    }\n\n    protected applyJoin(property: string, alias: string) : void {\n        const inner = this.options.joinType === 'inner';\n\n        if (this.options.joinAndSelect) {\n            if (inner) {\n                this.queryBuilder.innerJoinAndSelect(property, alias);\n            } else {\n                this.queryBuilder.leftJoinAndSelect(property, alias);\n            }\n        } else if (inner) {\n            this.queryBuilder.innerJoin(property, alias);\n        } else {\n            this.queryBuilder.leftJoin(property, alias);\n        }\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { SortBaseAdapter } from '@rapiq/sql';\nimport type { SelectQueryBuilder } from 'typeorm';\nimport type { RelationsAdapter } from './relations';\n\nexport class SortAdapter extends SortBaseAdapter {\n    protected queryBuilder : SelectQueryBuilder<any>;\n\n    constructor(queryBuilder: SelectQueryBuilder<any>, relations: RelationsAdapter) {\n        super(relations);\n\n        this.queryBuilder = queryBuilder;\n    }\n\n    rootAlias(): string | undefined {\n        return this.queryBuilder.alias;\n    }\n\n    escapeField(field: string) {\n        // order-by keys must stay `alias.property` — TypeORM resolves\n        // them against its alias map and escapes on its own; pre-escaped\n        // names break entity hydration as soon as a join is present.\n        return field;\n    }\n\n    execute() {\n        // a query without sorts leaves a caller-owned ORDER BY untouched —\n        // the same preservation contract the filters adapter applies to\n        // WHERE. TypeORM's orderBy({}) would REPLACE the builder state.\n        if (Object.keys(this.value).length > 0) {\n            this.queryBuilder.orderBy(this.value);\n        }\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PaginationBaseAdapter } from '@rapiq/sql';\nimport type { SelectQueryBuilder } from 'typeorm';\n\nexport class PaginationAdapter extends PaginationBaseAdapter {\n    protected queryBuilder : SelectQueryBuilder<any>;\n\n    constructor(queryBuilder: SelectQueryBuilder<any>) {\n        super();\n\n        this.queryBuilder = queryBuilder;\n    }\n\n    override execute() {\n        // a query without pagination leaves caller-owned take/skip\n        // untouched — the same preservation contract the filters adapter\n        // applies to WHERE. The adapter/builder pair is per-request;\n        // resetting a previous run is not this method's job. Nullish\n        // (not falsy) coalescing: an explicit 0 is a value, not absence.\n        if (typeof this.limit !== 'undefined') {\n            this.queryBuilder.take(this.limit ?? undefined);\n        }\n\n        if (typeof this.offset !== 'undefined') {\n            this.queryBuilder.skip(this.offset ?? undefined);\n        }\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { IQuery } from '@rapiq/core';\nimport type { ExecuteOptions, IRootAdapter } from '@rapiq/sql';\nimport { QueryVisitor } from '@rapiq/sql';\nimport { RelationsAdapter } from './relations';\nimport { FieldsAdapter } from './fields';\nimport { FiltersAdapter } from './filters';\nimport { SortAdapter } from './sort';\nimport type { TypeormAdapterOptions, TypeormAdapterOutput } from './types';\nimport { PaginationAdapter } from './pagination';\n\nexport class TypeormAdapter implements IRootAdapter<TypeormAdapterOutput> {\n    public readonly relations : RelationsAdapter;\n\n    public readonly fields : FieldsAdapter;\n\n    public readonly filters : FiltersAdapter;\n\n    public readonly pagination : PaginationAdapter;\n\n    public readonly sort : SortAdapter;\n\n    constructor(options: TypeormAdapterOptions) {\n        this.relations = new RelationsAdapter(options.queryBuilder, options.relations);\n        this.fields = new FieldsAdapter(options.queryBuilder, this.relations);\n        this.filters = new FiltersAdapter(options.queryBuilder, this.relations);\n        this.pagination = new PaginationAdapter(options.queryBuilder);\n        this.sort = new SortAdapter(options.queryBuilder, this.relations);\n    }\n\n    clear() {\n        this.fields.clear();\n        this.filters.clear();\n        this.pagination.clear();\n        this.sort.clear();\n        this.relations.clear();\n    }\n\n    /**\n     * Walk `query` into the sub-adapters and apply the accumulated state\n     * to the queryBuilder query builder (bound at construction).\n     */\n    execute(\n        query: IQuery,\n        options: ExecuteOptions = {},\n    ) : TypeormAdapterOutput {\n        if (options.clear ?? true) {\n            this.clear();\n        }\n\n        query.accept(new QueryVisitor(this, options.visitor));\n\n        this.fields.execute();\n        this.filters.execute();\n        this.pagination.execute();\n        this.sort.execute();\n        this.relations.execute();\n\n        return {\n            pagination: {\n                limit: this.pagination.limit,\n                offset: this.pagination.offset,\n            },\n        };\n    }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "@rapiq/typeorm",
+    "version": "2.0.0-beta.0",
+    "description": "A typeorm adapter for rapiq.",
+    "type": "module",
+    "main": "dist/index.mjs",
+    "types": "dist/index.d.mts",
+    "exports": {
+        "./package.json": "./package.json",
+        ".": {
+            "types": "./dist/index.d.mts",
+            "import": "./dist/index.mjs"
+        }
+    },
+    "files": [
+        "dist/"
+    ],
+    "devDependencies": {
+        "@rapiq/core": "^2.0.0-beta.0",
+        "@rapiq/parser-simple": "^2.0.0-beta.0",
+        "@rapiq/sql": "^2.0.0-beta.0",
+        "@swc/core": "^1.15.43",
+        "ansis": "^4.2.0",
+        "better-sqlite3": "^12.6.0",
+        "mysql2": "^3.22.6",
+        "reflect-metadata": "^0.2.2",
+        "typeorm": "^1.1.0",
+        "unplugin-swc": "^1.5.9"
+    },
+    "peerDependencies": {
+        "@rapiq/core": "^2.0.0-beta.0",
+        "@rapiq/sql": "^2.0.0-beta.0",
+        "typeorm": "^1.1.0"
+    },
+    "scripts": {
+        "build:types": "tsc --noEmit -p tsconfig.build.json",
+        "build:js": "tsdown",
+        "build": "npm run build:types && npm run build:js",
+        "test": "vitest --config test/vitest.config.ts --run",
+        "test:coverage": "vitest --config test/vitest.config.ts --run --coverage",
+        "prepublishOnly": "npm run build"
+    },
+    "author": {
+        "name": "Peter Placzek",
+        "email": "contact@tada5hi.net",
+        "url": "https://github.com/tada5hi"
+    },
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public",
+        "tag": "beta"
+    },
+    "keywords": [],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Tada5hi/rapiq.git",
+        "directory": "packages/typeorm"
+    },
+    "bugs": {
+        "url": "https://github.com/Tada5hi/rapiq/issues"
+    },
+    "homepage": "https://github.com/Tada5hi/rapiq#readme"
+}