@generazioneai/genquery 0.1.0

package/dist/adapters/typeorm/where.js

@@ -0,0 +1,297 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySearchByInside = applySearchByInside;
+const typeorm_1 = require("typeorm");
+const errors_1 = require("../../errors");
+const escape_1 = require("./escape");
+function qualify(alias, field) {
+    return `"${alias}"."${field}"`;
+}
+function buildString(alias, field, search, params) {
+    const col = qualify(alias, field);
+    const like = search.caseSensitive ? "LIKE" : "ILIKE";
+    switch (search.mode) {
+        case "exact": {
+            const p = params.next();
+            if (search.contained) {
+                return {
+                    sql: `${col} ${like} :${p}`,
+                    params: { [p]: `%${(0, escape_1.escapeLike)(search.value)}%` },
+                };
+            }
+            if (search.caseSensitive) {
+                return {
+                    sql: `${col} = :${p}`,
+                    params: { [p]: search.value },
+                };
+            }
+            // Case-insensitive equality via ILIKE on the escaped literal (no wildcards).
+            return {
+                sql: `${col} ILIKE :${p}`,
+                params: { [p]: (0, escape_1.escapeLike)(search.value) },
+            };
+        }
+        case "nativeregex": {
+            const p = params.next();
+            const op = search.caseSensitive ? "~" : "~*";
+            return {
+                sql: `${col} ${op} :${p}`,
+                params: { [p]: search.value },
+            };
+        }
+        case "splitword": {
+            const words = (0, escape_1.splitWords)(search.value);
+            if (words.length === 0) {
+                return { sql: "1=1", params: {} };
+            }
+            const parts = [];
+            const out = {};
+            for (const w of words) {
+                const p = params.next();
+                const pattern = search.contained
+                    ? `%${(0, escape_1.escapeLike)(w)}%`
+                    : (0, escape_1.escapeLike)(w);
+                parts.push(`${col} ${like} :${p}`);
+                out[p] = pattern;
+            }
+            return { sql: `(${parts.join(" OR ")})`, params: out };
+        }
+    }
+}
+function buildNumber(alias, field, search, params) {
+    const col = qualify(alias, field);
+    const p = params.next();
+    const op = search.op === "==" ? "=" : search.op;
+    return { sql: `${col} ${op} :${p}`, params: { [p]: search.value } };
+}
+function buildDate(alias, field, search, params) {
+    const col = qualify(alias, field);
+    if (search.kind === "exact") {
+        const p = params.next();
+        return { sql: `${col} = :${p}`, params: { [p]: search.value } };
+    }
+    // range
+    const clauses = [];
+    const out = {};
+    if (search.after) {
+        const p = params.next();
+        clauses.push(`${col} > :${p}`);
+        out[p] = search.after;
+    }
+    if (search.before) {
+        const p = params.next();
+        clauses.push(`${col} < :${p}`);
+        out[p] = search.before;
+    }
+    return { sql: clauses.join(" AND "), params: out };
+}
+function buildLeaf(cond, ctx) {
+    switch (cond.kind) {
+        case "string":
+            return buildString(ctx.currentAlias, cond.field, cond.search, ctx.params);
+        case "number":
+            return buildNumber(ctx.currentAlias, cond.field, cond.search, ctx.params);
+        case "bool": {
+            const p = ctx.params.next();
+            return {
+                sql: `${qualify(ctx.currentAlias, cond.field)} = :${p}`,
+                params: { [p]: cond.search.value },
+            };
+        }
+        case "date":
+            return buildDate(ctx.currentAlias, cond.field, cond.search, ctx.params);
+        case "enum": {
+            const p = ctx.params.next();
+            return {
+                sql: `${qualify(ctx.currentAlias, cond.field)} = :${p}`,
+                params: { [p]: cond.search.value },
+            };
+        }
+        case "null": {
+            const col = qualify(ctx.currentAlias, cond.field);
+            return {
+                sql: `${col} IS ${cond.check.isNull ? "" : "NOT "}NULL`,
+                params: {},
+            };
+        }
+        case "empty": {
+            const col = qualify(ctx.currentAlias, cond.field);
+            const sql = cond.check.isEmpty
+                ? `(${col} IS NULL OR ${col} = '')`
+                : `(${col} IS NOT NULL AND ${col} <> '')`;
+            return { sql, params: {} };
+        }
+    }
+}
+function joinPath(parent, child) {
+    return parent ? `${parent}.${child}` : child;
+}
+function applyCondition(qb, cond, ctx, isFirst) {
+    if (cond.kind === "relation") {
+        if (cond.op === "some") {
+            const path = joinPath(ctx.currentPath, cond.field);
+            const relAlias = ctx.aliases.get(path);
+            if (!relAlias) {
+                throw new Error(`genquery/typeorm: missing join for relation path '${path}'`);
+            }
+            const subCtx = {
+                ...ctx,
+                currentAlias: relAlias,
+                currentPath: path,
+                currentEntity: cond.targetEntity,
+            };
+            const brackets = new typeorm_1.Brackets((sub) => applySearchByInside(sub, cond.nested, subCtx));
+            if (isFirst)
+                qb.where(brackets);
+            else
+                qb.andWhere(brackets);
+            return;
+        }
+        // every / none → EXISTS / NOT EXISTS subquery
+        const fragment = buildExistsSubquery(cond, ctx);
+        Object.assign(ctx.paramBag, fragment.params);
+        if (isFirst)
+            qb.where(fragment.sql, fragment.params);
+        else
+            qb.andWhere(fragment.sql, fragment.params);
+        return;
+    }
+    const fragment = buildLeaf(cond, ctx);
+    Object.assign(ctx.paramBag, fragment.params);
+    if (isFirst)
+        qb.where(fragment.sql, fragment.params);
+    else
+        qb.andWhere(fragment.sql, fragment.params);
+}
+/**
+ * Build a `[NOT] EXISTS (SELECT 1 FROM target WHERE ...)` fragment for
+ * `every` / `none` relation conditions. Resolves FK columns through TypeORM's
+ * own EntityMetadata so we don't reinvent relation introspection.
+ *
+ * Restrictions (Phase 1):
+ *  - One-to-many and many-to-one (and one-to-one) relations are supported.
+ *  - Many-to-many goes through a junction table and isn't supported here yet.
+ *  - The nested `searchBy` must contain only leaf conditions and OR — nested
+ *    relation filters inside `every`/`none` are not yet supported.
+ */
+function buildExistsSubquery(cond, ctx) {
+    const parentMeta = ctx.connection.getMetadata(ctx.currentEntity);
+    const relMeta = parentMeta.relations.find((r) => r.propertyName === cond.field);
+    if (!relMeta) {
+        throw new Error(`genquery/typeorm: no TypeORM relation metadata for '${ctx.currentEntity}.${cond.field}'`);
+    }
+    if (relMeta.isManyToMany) {
+        throw new errors_1.QueryValidationError(`Relation '${cond.field}' is many-to-many; '${cond.op}' filtering isn't supported yet for M2M relations`, cond.field);
+    }
+    const targetMeta = relMeta.inverseEntityMetadata;
+    const targetTable = targetMeta.tableName;
+    const subAlias = `${ctx.currentAlias}__${cond.field}__sub`;
+    // Determine the join condition between parent alias and the subquery alias.
+    let joinSql;
+    if (relMeta.joinColumns.length > 0) {
+        // Owning side (many-to-one / owning one-to-one): FK column lives on the
+        // parent table, references target's referenced column.
+        const fk = relMeta.joinColumns[0];
+        const parentCol = fk.databaseName;
+        const targetCol = fk.referencedColumn?.databaseName
+            ?? targetMeta.primaryColumns[0].databaseName;
+        joinSql = `"${subAlias}"."${targetCol}" = "${ctx.currentAlias}"."${parentCol}"`;
+    }
+    else if (relMeta.inverseRelation) {
+        // Inverse side (one-to-many / inverse one-to-one): FK lives on the target.
+        const fk = relMeta.inverseRelation.joinColumns[0];
+        if (!fk) {
+            throw new Error(`genquery/typeorm: cannot resolve foreign key for relation '${cond.field}'`);
+        }
+        const targetFk = fk.databaseName;
+        const parentPk = fk.referencedColumn?.databaseName
+            ?? parentMeta.primaryColumns[0].databaseName;
+        joinSql = `"${subAlias}"."${targetFk}" = "${ctx.currentAlias}"."${parentPk}"`;
+    }
+    else {
+        throw new Error(`genquery/typeorm: cannot resolve join columns for relation '${cond.field}'`);
+    }
+    const subCtx = {
+        ...ctx,
+        currentAlias: subAlias,
+        currentPath: joinPath(ctx.currentPath, cond.field),
+        currentEntity: cond.targetEntity,
+    };
+    const nestedFrag = buildSearchByFragment(cond.nested, subCtx);
+    let whereContent = joinSql;
+    if (nestedFrag.sql) {
+        const inner = cond.op === "every" ? `NOT (${nestedFrag.sql})` : nestedFrag.sql;
+        whereContent = `${joinSql} AND ${inner}`;
+    }
+    else if (cond.op === "every") {
+        // every(no conditions) ≡ "no related rows that violate nothing", i.e. true.
+        // Special-case: no WHERE on the nested side means `every` is trivially
+        // satisfied (no row can violate an empty predicate).
+        return { sql: "1=1", params: {} };
+    }
+    const exists = cond.op === "some" ? "EXISTS" : "NOT EXISTS";
+    const sql = `${exists} (SELECT 1 FROM "${targetTable}" "${subAlias}" WHERE ${whereContent})`;
+    return { sql, params: nestedFrag.params };
+}
+/**
+ * Build a SQL fragment representing an entire ParsedSearchBy (conditions
+ * AND-ed together, with the OR group AND-ed in). Used inside EXISTS
+ * subqueries where we need raw SQL rather than a builder mutation.
+ *
+ * Throws if a nested relation appears — those need their own EXISTS subquery
+ * with metadata resolution, which Phase 1 doesn't support inside every/none.
+ */
+function buildSearchByFragment(searchBy, ctx) {
+    const andParts = [];
+    const params = {};
+    for (const cond of searchBy.conditions) {
+        if (cond.kind === "relation") {
+            throw new errors_1.QueryValidationError(`Nested relation filter '${cond.field}' inside 'every'/'none' is not supported in this version`, joinPath(ctx.currentPath, cond.field));
+        }
+        const frag = buildLeaf(cond, ctx);
+        andParts.push(frag.sql);
+        Object.assign(params, frag.params);
+    }
+    if (searchBy.or.length > 0) {
+        const orParts = [];
+        for (const sub of searchBy.or) {
+            const subFrag = buildSearchByFragment(sub, ctx);
+            if (subFrag.sql)
+                orParts.push(`(${subFrag.sql})`);
+            Object.assign(params, subFrag.params);
+        }
+        if (orParts.length > 0)
+            andParts.push(`(${orParts.join(" OR ")})`);
+    }
+    return { sql: andParts.join(" AND "), params };
+}
+/**
+ * Apply a `ParsedSearchBy` inside a TypeORM `Brackets` callback. Caller is
+ * responsible for wrapping with `qb.andWhere(new Brackets(b => applySearchByInside(b, ..., ctx)))`.
+ */
+function applySearchByInside(qb, searchBy, ctx) {
+    let first = true;
+    for (const cond of searchBy.conditions) {
+        applyCondition(qb, cond, ctx, first);
+        first = false;
+    }
+    if (searchBy.or.length > 0) {
+        const orBrackets = new typeorm_1.Brackets((orQb) => {
+            let orFirst = true;
+            for (const sub of searchBy.or) {
+                const sub_brackets = new typeorm_1.Brackets((b) => applySearchByInside(b, sub, ctx));
+                if (orFirst)
+                    orQb.where(sub_brackets);
+                else
+                    orQb.orWhere(sub_brackets);
+                orFirst = false;
+            }
+        });
+        if (first)
+            qb.where(orBrackets);
+        else
+            qb.andWhere(orBrackets);
+        first = false;
+    }
+}
+//# sourceMappingURL=where.js.map

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

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

package/dist/datetime.d.ts

@@ -0,0 +1,4 @@
+import type { DateTimeInput } from "./types";
+export declare function parseDateTime(input: DateTimeInput, path: string): Date;
+export declare function looksLikeDateTime(v: unknown): boolean;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,SAAS,CAAC;AA4BlE,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAuDtE;AAkBD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAErD"}

package/dist/datetime.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDateTime = parseDateTime;
+exports.looksLikeDateTime = looksLikeDateTime;
+const errors_1 = require("./errors");
+const ISO_OFFSET_RE = /^(Z|[+-]\d{2}(:?\d{2})?(:?:\d{2})?)$/;
+function normalizeOffset(offset, path) {
+    if (offset === "Z")
+        return "Z";
+    if (!ISO_OFFSET_RE.test(offset)) {
+        throw new errors_1.QueryValidationError(`Invalid offset '${offset}' (expected 'Z' or '±HH:MM' / '±HHMM' / '±HH')`, path);
+    }
+    // Ensure leading sign
+    if (!offset.startsWith("+") && !offset.startsWith("-")) {
+        offset = "+" + offset;
+    }
+    // Expand "+HH" -> "+HH:00" and "+HHMM" -> "+HH:MM"
+    const sign = offset[0];
+    const rest = offset.slice(1).replace(":", "");
+    if (rest.length === 2)
+        return `${sign}${rest}:00`;
+    if (rest.length === 4)
+        return `${sign}${rest.slice(0, 2)}:${rest.slice(2)}`;
+    return offset;
+}
+function pad(n, len = 2) {
+    return String(n).padStart(len, "0");
+}
+function parseDateTime(input, path) {
+    if (typeof input === "string") {
+        const d = new Date(input);
+        if (Number.isNaN(d.getTime())) {
+            throw new errors_1.QueryValidationError(`Invalid ISO 8601 datetime '${input}'`, path);
+        }
+        return d;
+    }
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new errors_1.QueryValidationError(`Expected ISO string or datetime object`, path);
+    }
+    const obj = input;
+    const year = obj.year ?? 1970;
+    const month = obj.month ?? 1;
+    const day = obj.day ?? 1;
+    const hours = obj.hours ?? 0;
+    const minutes = obj.minutes ?? 0;
+    const seconds = obj.seconds ?? 0;
+    const offset = normalizeOffset(obj.offset ?? "Z", `${path}.offset`);
+    for (const [k, v] of Object.entries({
+        year,
+        month,
+        day,
+        hours,
+        minutes,
+        seconds,
+    })) {
+        if (typeof v !== "number" || !Number.isFinite(v) || !Number.isInteger(v)) {
+            throw new errors_1.QueryValidationError(`'${k}' must be an integer (got ${JSON.stringify(v)})`, path);
+        }
+    }
+    const iso = `${pad(year, 4)}-${pad(month)}-${pad(day)}T${pad(hours)}:${pad(minutes)}:${pad(seconds)}${offset}`;
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime())) {
+        throw new errors_1.QueryValidationError(`Invalid datetime components (built '${iso}')`, path);
+    }
+    return d;
+}
+function isDateTimeObject(v) {
+    if (v === null || typeof v !== "object" || Array.isArray(v))
+        return false;
+    const keys = new Set([
+        "year",
+        "month",
+        "day",
+        "hours",
+        "minutes",
+        "seconds",
+        "offset",
+    ]);
+    // Treat as datetime object only if every key belongs to the set.
+    // (Otherwise it might be a `{before, after}` range.)
+    return Object.keys(v).every((k) => keys.has(k));
+}
+function looksLikeDateTime(v) {
+    return typeof v === "string" || isDateTimeObject(v);
+}
+//# sourceMappingURL=datetime.js.map

package/dist/datetime.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,52 @@
+import type { Adapter } from "./adapters/base";
+import type { ParsedQuery } from "./parsed";
+import type { Schema } from "./schema";
+import type { GenQueryInput } from "./types";
+export interface GenQueryEngineOptions<TTarget, TResult> {
+    adapter: Adapter<TTarget, TResult>;
+}
+type IsAny<T> = 0 extends 1 & T ? true : false;
+/** True for TypeORM's wide ObjectLiteral default — treat as "unspecified". */
+type IsLooseRecord<T> = IsAny<T> extends true ? true : [T] extends [Record<string, any>] ? [Record<string, any>] extends [T] ? true : false : false;
+/**
+ * Inspect the target's structural shape. If it looks like a TypeORM
+ * `SelectQueryBuilder<T>` (has `getMany(): Promise<T[]>`), pull out T.
+ * Falls back to `unknown` (loose mode) for any other adapter target.
+ */
+type InferEntityFromTarget<X> = X extends {
+    getMany(): Promise<infer A>;
+} ? A extends (infer T)[] ? IsLooseRecord<T> extends true ? unknown : T : unknown : unknown;
+/**
+ * Combines parsing + an adapter into a single entry point. The engine is
+ * generic over the adapter so the signature of `run` matches the chosen
+ * backend (e.g. `SelectQueryBuilder<T>` in/out for TypeORM).
+ *
+ * The schema is read from the adapter — there is one source of truth.
+ */
+export declare class GenQueryEngine<TTarget, TResult> {
+    readonly schema: Schema;
+    readonly adapter: Adapter<TTarget, TResult>;
+    constructor(options: GenQueryEngineOptions<TTarget, TResult>);
+    /**
+     * Parse only — useful when you want to inspect / cache the parsed form.
+     *
+     * Pass an entity class as the generic parameter to get autocomplete on
+     * fields / relations (e.g. `engine.parse<User>(input, "User")`).
+     */
+    parse<T = unknown>(input: GenQueryInput<T>, rootEntity: string): ParsedQuery;
+    /**
+     * Parse and apply.
+     *
+     * The entity type is inferred from the `target` argument when it has a
+     * recognizable shape (e.g. a TypeORM `SelectQueryBuilder<User>`). When the
+     * adapter implements `getRootEntity`, the `rootEntity` string is optional —
+     * the engine asks the adapter to derive it from the target. Pass an explicit
+     * `rootEntity` to override (or when the adapter can't introspect).
+     */
+    run<X extends TTarget>(input: GenQueryInput<InferEntityFromTarget<X>>, target: X): TResult;
+    run<X extends TTarget>(input: GenQueryInput<InferEntityFromTarget<X>>, rootEntity: string, target: X): TResult;
+    /** Apply a previously parsed query. */
+    runParsed(parsed: ParsedQuery, target: TTarget): TResult;
+}
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,qBAAqB,CAAC,OAAO,EAAE,OAAO;IACrD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAE/C,8EAA8E;AAC9E,KAAK,aAAa,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,GACzC,IAAI,GACJ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAC/B,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAC/B,IAAI,GACJ,KAAK,GACP,KAAK,CAAC;AAEZ;;;;GAIG;AACH,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS;IACxC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7B,GACG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAC3B,OAAO,GACP,CAAC,GACH,OAAO,GACT,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,qBAAa,cAAc,CAAC,OAAO,EAAE,OAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAEhC,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC;IAK5D;;;;;OAKG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW;IAI5E;;;;;;;;OAQG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EACnB,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAC9C,MAAM,EAAE,CAAC,GACR,OAAO;IACV,GAAG,CAAC,CAAC,SAAS,OAAO,EACnB,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAC9C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,GACR,OAAO;IA2BV,uCAAuC;IACvC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;CAGzD"}

package/dist/engine.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenQueryEngine = void 0;
+const parser_1 = require("./parser");
+/**
+ * Combines parsing + an adapter into a single entry point. The engine is
+ * generic over the adapter so the signature of `run` matches the chosen
+ * backend (e.g. `SelectQueryBuilder<T>` in/out for TypeORM).
+ *
+ * The schema is read from the adapter — there is one source of truth.
+ */
+class GenQueryEngine {
+    constructor(options) {
+        this.adapter = options.adapter;
+        this.schema = options.adapter.schema;
+    }
+    /**
+     * Parse only — useful when you want to inspect / cache the parsed form.
+     *
+     * Pass an entity class as the generic parameter to get autocomplete on
+     * fields / relations (e.g. `engine.parse<User>(input, "User")`).
+     */
+    parse(input, rootEntity) {
+        return (0, parser_1.parseQuery)(input, this.schema, rootEntity);
+    }
+    run(input, arg2, arg3) {
+        let rootEntity;
+        let target;
+        if (typeof arg2 === "string") {
+            rootEntity = arg2;
+            target = arg3;
+        }
+        else {
+            target = arg2;
+            const derived = this.adapter.getRootEntity?.(target);
+            if (!derived) {
+                throw new Error("GenQueryEngine.run: rootEntity not provided and the adapter " +
+                    `('${this.adapter.name}') could not derive it from the target. ` +
+                    "Pass rootEntity explicitly: engine.run(input, rootEntity, target).");
+            }
+            rootEntity = derived;
+        }
+        const parsed = (0, parser_1.parseQuery)(input, this.schema, rootEntity);
+        return this.adapter.apply(target, parsed);
+    }
+    /** Apply a previously parsed query. */
+    runParsed(parsed, target) {
+        return this.adapter.apply(target, parsed);
+    }
+}
+exports.GenQueryEngine = GenQueryEngine;
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":";;;AACA,qCAAsC;AAqCtC;;;;;;GAMG;AACH,MAAa,cAAc;IAIzB,YAAY,OAAgD;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAc,KAAuB,EAAE,UAAkB;QAC5D,OAAO,IAAA,mBAAU,EAAC,KAAsB,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAoBD,GAAG,CACD,KAAoB,EACpB,IAAsB,EACtB,IAAc;QAEd,IAAI,UAAkB,CAAC;QACvB,IAAI,MAAe,CAAC;QACpB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,UAAU,GAAG,IAAI,CAAC;YAClB,MAAM,GAAG,IAAe,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,8DAA8D;oBAC5D,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,0CAA0C;oBAChE,oEAAoE,CACvE,CAAC;YACJ,CAAC;YACD,UAAU,GAAG,OAAO,CAAC;QACvB,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,uCAAuC;IACvC,SAAS,CAAC,MAAmB,EAAE,MAAe;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;CACF;AAnED,wCAmEC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Thrown when the input query is structurally invalid or refers to unknown
+ * fields/relations.
+ */
+export declare class QueryValidationError extends Error {
+    /** Dot-path to the offending location inside the input query. */
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C"}

package/dist/errors.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryValidationError = void 0;
+/**
+ * Thrown when the input query is structurally invalid or refers to unknown
+ * fields/relations.
+ */
+class QueryValidationError extends Error {
+    constructor(message, path) {
+        super(`${message} (at ${path || "<root>"})`);
+        this.name = "QueryValidationError";
+        this.path = path;
+    }
+}
+exports.QueryValidationError = QueryValidationError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAI7C,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,GAAG,OAAO,QAAQ,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AATD,oDASC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./types";
+export * from "./parsed";
+export * from "./schema";
+export * from "./errors";
+export { parseQuery } from "./parser";
+export { GenQueryEngine, type GenQueryEngineOptions } from "./engine";
+export type { Adapter } from "./adapters/base";
+export { parseDateTime } from "./datetime";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDateTime = exports.GenQueryEngine = exports.parseQuery = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./parsed"), exports);
+__exportStar(require("./schema"), exports);
+__exportStar(require("./errors"), exports);
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseQuery", { enumerable: true, get: function () { return parser_1.parseQuery; } });
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "GenQueryEngine", { enumerable: true, get: function () { return engine_1.GenQueryEngine; } });
+var datetime_1 = require("./datetime");
+Object.defineProperty(exports, "parseDateTime", { enumerable: true, get: function () { return datetime_1.parseDateTime; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,2CAAyB;AACzB,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,mCAAsE;AAA7D,wGAAA,cAAc,OAAA;AAEvB,uCAA2C;AAAlC,yGAAA,aAAa,OAAA"}