@_linked/core 1.3.0 → 2.0.0-next.20260310082533

package/lib/cjs/queries/PropertyPath.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyPath = void 0;
+exports.walkPropertyPath = walkPropertyPath;
+const ShapeClass_js_1 = require("../utils/ShapeClass.js");
+/**
+ * A value object representing a sequence of property traversals from a root shape.
+ *
+ * Each segment is a PropertyShape representing one hop in the traversal.
+ * For example, `friends.name` on PersonShape produces a PropertyPath with
+ * two segments: [friendsPropertyShape, namePropertyShape].
+ *
+ * This is used by FieldSet and QueryBuilder to describe which properties
+ * to select/filter, independent of proxy tracing.
+ */
+class PropertyPath {
+    constructor(rootShape, segments) {
+        this.rootShape = rootShape;
+        this.segments = segments;
+    }
+    /** Append a property traversal hop, returning a new PropertyPath. */
+    prop(property) {
+        return new PropertyPath(this.rootShape, [...this.segments, property]);
+    }
+    /** The terminal (leaf) property of this path. */
+    get terminal() {
+        return this.segments[this.segments.length - 1];
+    }
+    /** The depth (number of hops) of this path. */
+    get depth() {
+        return this.segments.length;
+    }
+    /** String representation using property labels joined by dots. */
+    toString() {
+        return this.segments.map((s) => s.label).join('.');
+    }
+    /** Two PropertyPaths are equal if they have the same root shape and same segment sequence. */
+    equals(other) {
+        if (this.rootShape.id !== other.rootShape.id)
+            return false;
+        if (this.segments.length !== other.segments.length)
+            return false;
+        return this.segments.every((s, i) => s.id === other.segments[i].id);
+    }
+}
+exports.PropertyPath = PropertyPath;
+/**
+ * Resolve a dot-separated property path string into a PropertyPath.
+ *
+ * Walks the shape's property shapes by label, following valueShape references
+ * to traverse into nested shapes.
+ *
+ * Example: `walkPropertyPath(PersonShape, 'friends.name')` resolves
+ * [friendsPropertyShape, namePropertyShape].
+ *
+ * @throws If any segment cannot be resolved.
+ */
+function walkPropertyPath(shape, path) {
+    const labels = path.split('.');
+    const segments = [];
+    let currentShape = shape;
+    for (const label of labels) {
+        const propertyShape = currentShape.getPropertyShape(label);
+        if (!propertyShape) {
+            throw new Error(`Property '${label}' not found on shape '${currentShape.label || currentShape.id}' while resolving path '${path}'`);
+        }
+        segments.push(propertyShape);
+        // If there are more segments to resolve, follow the valueShape
+        if (segments.length < labels.length) {
+            if (!propertyShape.valueShape) {
+                throw new Error(`Property '${label}' on shape '${currentShape.label || currentShape.id}' has no valueShape; cannot traverse further in path '${path}'`);
+            }
+            const shapeClass = (0, ShapeClass_js_1.getShapeClass)(propertyShape.valueShape);
+            if (!shapeClass || !shapeClass.shape) {
+                throw new Error(`Cannot resolve valueShape '${propertyShape.valueShape.id}' for property '${label}' in path '${path}'`);
+            }
+            currentShape = shapeClass.shape;
+        }
+    }
+    return new PropertyPath(shape, segments);
+}
+//# sourceMappingURL=PropertyPath.js.map

package/lib/cjs/queries/PropertyPath.js.map

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

package/lib/cjs/queries/ProxiedPathBuilder.d.ts

@@ -0,0 +1,14 @@
+import { Shape, ShapeConstructor } from '../shapes/Shape.js';
+import { QueryBuilderObject } from './SelectQuery.js';
+/**
+ * Creates the proxy object used as the `p` parameter in query callbacks.
+ *
+ * Property access on the returned proxy (e.g., `p.name`, `p.friends.name`)
+ * creates QueryBuilderObject chains that trace the path of requested properties.
+ * This is the shared foundation for both the DSL (`Person.select(p => p.name)`)
+ * and the future QueryBuilder API.
+ *
+ * Originally extracted from SelectQueryFactory.getQueryShape() to enable reuse
+ * across the DSL and dynamic query building.
+ */
+export declare function createProxiedPathBuilder<S extends Shape>(shape: ShapeConstructor<S> | QueryBuilderObject): QueryBuilderObject;

package/lib/cjs/queries/ProxiedPathBuilder.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProxiedPathBuilder = createProxiedPathBuilder;
+const SelectQuery_js_1 = require("./SelectQuery.js");
+/**
+ * Creates the proxy object used as the `p` parameter in query callbacks.
+ *
+ * Property access on the returned proxy (e.g., `p.name`, `p.friends.name`)
+ * creates QueryBuilderObject chains that trace the path of requested properties.
+ * This is the shared foundation for both the DSL (`Person.select(p => p.name)`)
+ * and the future QueryBuilder API.
+ *
+ * Originally extracted from SelectQueryFactory.getQueryShape() to enable reuse
+ * across the DSL and dynamic query building.
+ */
+function createProxiedPathBuilder(shape) {
+    if (shape instanceof SelectQuery_js_1.QueryBuilderObject) {
+        // When a QueryBuilderObject is passed directly (e.g. QueryPrimitives
+        // used as the shape for where-clause evaluation), use it as-is.
+        return shape;
+    }
+    // Create a dummy shape instance and wrap it in a QueryShape proxy.
+    // The proxy intercepts property access and resolves each property name
+    // to its PropertyShape, building a chain of QueryBuilderObjects that
+    // records which path was traversed.
+    const dummyShape = new shape();
+    return SelectQuery_js_1.QueryShape.create(dummyShape);
+}
+//# sourceMappingURL=ProxiedPathBuilder.js.map

package/lib/cjs/queries/ProxiedPathBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxiedPathBuilder.js","sourceRoot":"","sources":["../../../src/queries/ProxiedPathBuilder.ts"],"names":[],"mappings":";;AAcA,4DAcC;AA3BD,qDAAgE;AAEhE;;;;;;;;;;GAUG;AACH,SAAgB,wBAAwB,CACtC,KAA+C;IAE/C,IAAI,KAAK,YAAY,mCAAkB,EAAE,CAAC;QACxC,qEAAqE;QACrE,gEAAgE;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,mEAAmE;IACnE,uEAAuE;IACvE,qEAAqE;IACrE,oCAAoC;IACpC,MAAM,UAAU,GAAG,IAAI,KAAK,EAAE,CAAC;IAC/B,OAAO,2BAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC"}

package/lib/cjs/queries/QueryBuilder.d.ts

@@ -0,0 +1,141 @@
+import { Shape, ShapeConstructor } from '../shapes/Shape.js';
+import { SelectQuery, QueryBuildFn, WhereClause, QueryResponseToResultType, SelectAllQueryResponse, QueryComponentLike } from './SelectQuery.js';
+import type { RawSelectInput } from './IRDesugar.js';
+import type { NodeReferenceValue } from './QueryFactory.js';
+import { FieldSet, FieldSetFieldJSON } from './FieldSet.js';
+/** JSON representation of a QueryBuilder. */
+export type QueryBuilderJSON = {
+    shape: string;
+    fields?: FieldSetFieldJSON[];
+    limit?: number;
+    offset?: number;
+    subject?: string;
+    subjects?: string[];
+    singleResult?: boolean;
+    orderDirection?: 'ASC' | 'DESC';
+};
+/**
+ * An immutable, fluent query builder for select queries.
+ *
+ * Every mutation method (`.select()`, `.where()`, `.limit()`, etc.) returns
+ * a **new** QueryBuilder instance — the original is never modified.
+ *
+ * Implements `PromiseLike` so queries execute on `await`:
+ * ```ts
+ * const results = await QueryBuilder.from(Person).select(p => p.name);
+ * ```
+ *
+ * Generates IR directly via FieldSet, guaranteeing identical output to the existing DSL.
+ */
+export declare class QueryBuilder<S extends Shape = Shape, R = any, Result = any> implements PromiseLike<Result>, Promise<Result> {
+    private readonly _shape;
+    private readonly _selectFn?;
+    private readonly _whereFn?;
+    private readonly _sortByFn?;
+    private readonly _sortDirection?;
+    private readonly _limit?;
+    private readonly _offset?;
+    private readonly _subject?;
+    private readonly _subjects?;
+    private readonly _singleResult?;
+    private readonly _selectAllLabels?;
+    private readonly _fieldSet?;
+    private readonly _preloads?;
+    private constructor();
+    /** Create a shallow clone with overrides. */
+    private clone;
+    /**
+     * Create a QueryBuilder for the given shape.
+     *
+     * Accepts a shape class (e.g. `Person`), a NodeShape instance,
+     * or a shape IRI string (resolved via the shape registry).
+     */
+    static from<S extends Shape>(shape: ShapeConstructor<S> | string): QueryBuilder<S>;
+    /** Set the select projection via a callback, labels, or FieldSet. */
+    select<NewR>(fn: QueryBuildFn<S, NewR>): QueryBuilder<S, NewR, QueryResponseToResultType<NewR, S>[]>;
+    select(labels: string[]): QueryBuilder<S>;
+    select<NewR>(fieldSet: FieldSet<NewR>): QueryBuilder<S, NewR, QueryResponseToResultType<NewR, S>[]>;
+    /** Select all decorated properties of the shape. */
+    selectAll(): QueryBuilder<S, any, QueryResponseToResultType<SelectAllQueryResponse<S>, S>[]>;
+    /** Add a where clause. */
+    where(fn: WhereClause<S>): QueryBuilder<S, R, Result>;
+    /** Set sort order. */
+    orderBy<OR>(fn: QueryBuildFn<S, OR>, direction?: 'ASC' | 'DESC'): QueryBuilder<S, R, Result>;
+    /**
+     * Alias for orderBy — matches the existing DSL's `sortBy` method name.
+     */
+    sortBy<OR>(fn: QueryBuildFn<S, OR>, direction?: 'ASC' | 'DESC'): QueryBuilder<S, R, Result>;
+    /** Set result limit. */
+    limit(n: number): QueryBuilder<S, R, Result>;
+    /** Set result offset. */
+    offset(n: number): QueryBuilder<S, R, Result>;
+    /** Target a single entity by ID. Implies singleResult; unwraps array Result type. */
+    for(id: string | NodeReferenceValue): QueryBuilder<S, R, Result extends (infer E)[] ? E : Result>;
+    /** Target multiple entities by ID, or all if no ids given. */
+    forAll(ids?: (string | NodeReferenceValue)[]): QueryBuilder<S, R, Result>;
+    /** Limit to one result. Unwraps array Result type to single element. */
+    one(): QueryBuilder<S, R, Result extends (infer E)[] ? E : Result>;
+    /**
+     * Preload a component's query fields at the given property path.
+     *
+     * This merges the component's query paths into this query's selection,
+     * wrapping them in an OPTIONAL block (handled by the IR pipeline).
+     *
+     * Equivalent to the DSL's `.preloadFor()`:
+     * ```ts
+     * // DSL style
+     * Person.select(p => p.bestFriend.preloadFor(PersonCard))
+     * // QueryBuilder style
+     * QueryBuilder.from(Person).select(p => [p.name]).preload('bestFriend', PersonCard)
+     * ```
+     *
+     * NOTE: Preloads hold live component references and are not serializable.
+     * They are injected into the selectFn at build time (see buildFactory()),
+     * so changes to preload handling must account for the selectFn wrapping logic.
+     */
+    preload<CS extends Shape, CR>(path: string, component: QueryComponentLike<CS, CR>): QueryBuilder<S, R, Result>;
+    /**
+     * Returns the current selection as a FieldSet.
+     * If the selection was set via a FieldSet, returns that directly.
+     * If set via selectAll labels, constructs a FieldSet from them.
+     * If set via a callback, eagerly evaluates it through the proxy to produce a FieldSet.
+     */
+    fields(): FieldSet | undefined;
+    /**
+     * Serialize this QueryBuilder to a plain JSON object.
+     *
+     * Selections are serializable regardless of how they were set (FieldSet,
+     * string[], selectAll, or callback). Callback-based selections are eagerly
+     * evaluated through the proxy to produce a FieldSet.
+     *
+     * The `where` and `orderBy` callbacks are not serialized (only the direction
+     * is preserved for orderBy).
+     */
+    toJSON(): QueryBuilderJSON;
+    /**
+     * Reconstruct a QueryBuilder from a JSON object.
+     * Resolves shape IRI via getShapeClass() and field paths as label selections.
+     */
+    static fromJSON<S extends Shape = Shape>(json: QueryBuilderJSON): QueryBuilder<S>;
+    /**
+     * Get the raw pipeline input.
+     *
+     * Constructs RawSelectInput directly from FieldSet entries.
+     */
+    toRawInput(): RawSelectInput;
+    /**
+     * Build RawSelectInput directly from FieldSet entries.
+     */
+    private _buildDirectRawInput;
+    /** Build the IR (run the full pipeline: desugar → canonicalize → lower). */
+    build(): SelectQuery;
+    /** Execute the query and return results. */
+    exec(): Promise<Result>;
+    /** `await` triggers execution. */
+    then<TResult1 = Result, TResult2 = never>(onfulfilled?: ((value: Result) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    /** Catch errors from execution. Chain off then() to avoid re-executing. */
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): Promise<Result | TResult>;
+    /** Finally handler after execution. Chain off then() to avoid re-executing. */
+    finally(onfinally?: (() => void) | null): Promise<Result>;
+    get [Symbol.toStringTag](): string;
+}

package/lib/cjs/queries/QueryBuilder.js

@@ -0,0 +1,334 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryBuilder = void 0;
+const resolveShape_js_1 = require("./resolveShape.js");
+const SelectQuery_js_1 = require("./SelectQuery.js");
+const IRPipeline_js_1 = require("./IRPipeline.js");
+const queryDispatch_js_1 = require("./queryDispatch.js");
+const FieldSet_js_1 = require("./FieldSet.js");
+/**
+ * An immutable, fluent query builder for select queries.
+ *
+ * Every mutation method (`.select()`, `.where()`, `.limit()`, etc.) returns
+ * a **new** QueryBuilder instance — the original is never modified.
+ *
+ * Implements `PromiseLike` so queries execute on `await`:
+ * ```ts
+ * const results = await QueryBuilder.from(Person).select(p => p.name);
+ * ```
+ *
+ * Generates IR directly via FieldSet, guaranteeing identical output to the existing DSL.
+ */
+class QueryBuilder {
+    constructor(init) {
+        this._shape = init.shape;
+        this._selectFn = init.selectFn;
+        this._whereFn = init.whereFn;
+        this._sortByFn = init.sortByFn;
+        this._sortDirection = init.sortDirection;
+        this._limit = init.limit;
+        this._offset = init.offset;
+        this._subject = init.subject;
+        this._subjects = init.subjects;
+        this._singleResult = init.singleResult;
+        this._selectAllLabels = init.selectAllLabels;
+        this._fieldSet = init.fieldSet;
+        this._preloads = init.preloads;
+    }
+    /** Create a shallow clone with overrides. */
+    clone(overrides = {}) {
+        return new QueryBuilder(Object.assign({ shape: this._shape, selectFn: this._selectFn, whereFn: this._whereFn, sortByFn: this._sortByFn, sortDirection: this._sortDirection, limit: this._limit, offset: this._offset, subject: this._subject, subjects: this._subjects, singleResult: this._singleResult, selectAllLabels: this._selectAllLabels, fieldSet: this._fieldSet, preloads: this._preloads }, overrides));
+    }
+    // ---------------------------------------------------------------------------
+    // Static constructors
+    // ---------------------------------------------------------------------------
+    /**
+     * Create a QueryBuilder for the given shape.
+     *
+     * Accepts a shape class (e.g. `Person`), a NodeShape instance,
+     * or a shape IRI string (resolved via the shape registry).
+     */
+    static from(shape) {
+        const resolved = (0, resolveShape_js_1.resolveShape)(shape);
+        return new QueryBuilder({ shape: resolved });
+    }
+    select(fnOrLabelsOrFieldSet) {
+        if (fnOrLabelsOrFieldSet instanceof FieldSet_js_1.FieldSet) {
+            const labels = fnOrLabelsOrFieldSet.labels();
+            const selectFn = ((p) => labels.map((label) => p[label]));
+            return this.clone({ selectFn, selectAllLabels: undefined, fieldSet: fnOrLabelsOrFieldSet });
+        }
+        if (Array.isArray(fnOrLabelsOrFieldSet)) {
+            const labels = fnOrLabelsOrFieldSet;
+            const selectFn = ((p) => labels.map((label) => p[label]));
+            return this.clone({ selectFn, selectAllLabels: undefined, fieldSet: undefined });
+        }
+        return this.clone({ selectFn: fnOrLabelsOrFieldSet, selectAllLabels: undefined, fieldSet: undefined });
+    }
+    /** Select all decorated properties of the shape. */
+    selectAll() {
+        const propertyLabels = this._shape.shape
+            .getUniquePropertyShapes()
+            .map((ps) => ps.label);
+        const selectFn = ((p) => propertyLabels.map((label) => p[label]));
+        return this.clone({ selectFn, selectAllLabels: propertyLabels });
+    }
+    /** Add a where clause. */
+    where(fn) {
+        return this.clone({ whereFn: fn });
+    }
+    /** Set sort order. */
+    orderBy(fn, direction = 'ASC') {
+        return this.clone({ sortByFn: fn, sortDirection: direction });
+    }
+    /**
+     * Alias for orderBy — matches the existing DSL's `sortBy` method name.
+     */
+    sortBy(fn, direction = 'ASC') {
+        return this.orderBy(fn, direction);
+    }
+    /** Set result limit. */
+    limit(n) {
+        return this.clone({ limit: n });
+    }
+    /** Set result offset. */
+    offset(n) {
+        return this.clone({ offset: n });
+    }
+    /** Target a single entity by ID. Implies singleResult; unwraps array Result type. */
+    for(id) {
+        const subject = typeof id === 'string' ? { id } : id;
+        return this.clone({ subject, subjects: undefined, singleResult: true });
+    }
+    /** Target multiple entities by ID, or all if no ids given. */
+    forAll(ids) {
+        if (!ids) {
+            return this.clone({ subject: undefined, subjects: undefined, singleResult: false });
+        }
+        const subjects = ids.map((id) => (typeof id === 'string' ? { id } : id));
+        return this.clone({ subject: undefined, subjects, singleResult: false });
+    }
+    /** Limit to one result. Unwraps array Result type to single element. */
+    one() {
+        return this.clone({ limit: 1, singleResult: true });
+    }
+    /**
+     * Preload a component's query fields at the given property path.
+     *
+     * This merges the component's query paths into this query's selection,
+     * wrapping them in an OPTIONAL block (handled by the IR pipeline).
+     *
+     * Equivalent to the DSL's `.preloadFor()`:
+     * ```ts
+     * // DSL style
+     * Person.select(p => p.bestFriend.preloadFor(PersonCard))
+     * // QueryBuilder style
+     * QueryBuilder.from(Person).select(p => [p.name]).preload('bestFriend', PersonCard)
+     * ```
+     *
+     * NOTE: Preloads hold live component references and are not serializable.
+     * They are injected into the selectFn at build time (see buildFactory()),
+     * so changes to preload handling must account for the selectFn wrapping logic.
+     */
+    preload(path, component) {
+        const newPreloads = [...(this._preloads || []), { path, component }];
+        return this.clone({ preloads: newPreloads });
+    }
+    /**
+     * Returns the current selection as a FieldSet.
+     * If the selection was set via a FieldSet, returns that directly.
+     * If set via selectAll labels, constructs a FieldSet from them.
+     * If set via a callback, eagerly evaluates it through the proxy to produce a FieldSet.
+     */
+    fields() {
+        if (this._fieldSet) {
+            return this._fieldSet;
+        }
+        if (this._selectAllLabels) {
+            return FieldSet_js_1.FieldSet.for(this._shape.shape, this._selectAllLabels);
+        }
+        if (this._selectFn) {
+            // Eagerly evaluate the callback through FieldSet.for(ShapeClass, callback)
+            // The callback is pure — same proxy always produces same paths.
+            return FieldSet_js_1.FieldSet.for(this._shape, this._selectFn);
+        }
+        return undefined;
+    }
+    // ---------------------------------------------------------------------------
+    // Serialization
+    // ---------------------------------------------------------------------------
+    /**
+     * Serialize this QueryBuilder to a plain JSON object.
+     *
+     * Selections are serializable regardless of how they were set (FieldSet,
+     * string[], selectAll, or callback). Callback-based selections are eagerly
+     * evaluated through the proxy to produce a FieldSet.
+     *
+     * The `where` and `orderBy` callbacks are not serialized (only the direction
+     * is preserved for orderBy).
+     */
+    toJSON() {
+        var _a;
+        const shapeId = ((_a = this._shape.shape) === null || _a === void 0 ? void 0 : _a.id) || '';
+        const json = {
+            shape: shapeId,
+        };
+        // Serialize fields — fields() already handles _selectAllLabels, so
+        // no separate branch is needed (T1: dead else-if removed).
+        const fs = this.fields();
+        if (fs) {
+            json.fields = fs.toJSON().fields;
+        }
+        if (this._limit !== undefined) {
+            json.limit = this._limit;
+        }
+        if (this._offset !== undefined) {
+            json.offset = this._offset;
+        }
+        if (this._subject && typeof this._subject === 'object' && 'id' in this._subject) {
+            json.subject = this._subject.id;
+        }
+        if (this._subjects && this._subjects.length > 0) {
+            json.subjects = this._subjects.map((s) => s.id);
+        }
+        if (this._singleResult) {
+            json.singleResult = true;
+        }
+        if (this._sortDirection) {
+            json.orderDirection = this._sortDirection;
+        }
+        return json;
+    }
+    /**
+     * Reconstruct a QueryBuilder from a JSON object.
+     * Resolves shape IRI via getShapeClass() and field paths as label selections.
+     */
+    static fromJSON(json) {
+        let builder = QueryBuilder.from(json.shape);
+        if (json.fields && json.fields.length > 0) {
+            const fieldSet = FieldSet_js_1.FieldSet.fromJSON({
+                shape: json.shape,
+                fields: json.fields,
+            });
+            builder = builder.select(fieldSet);
+        }
+        if (json.limit !== undefined) {
+            builder = builder.limit(json.limit);
+        }
+        if (json.offset !== undefined) {
+            builder = builder.offset(json.offset);
+        }
+        if (json.subject) {
+            builder = builder.for(json.subject);
+        }
+        if (json.subjects && json.subjects.length > 0) {
+            builder = builder.forAll(json.subjects);
+        }
+        if (json.singleResult && !json.subject) {
+            builder = builder.one();
+        }
+        // Restore orderDirection. The sort key callback isn't serializable,
+        // so we only store the direction. When a sort key is later re-applied
+        // via .orderBy(), the direction will be available.
+        if (json.orderDirection) {
+            // Access private clone() — safe because fromJSON is in the same class.
+            builder = builder.clone({ sortDirection: json.orderDirection });
+        }
+        return builder;
+    }
+    // ---------------------------------------------------------------------------
+    // Build & execute
+    // ---------------------------------------------------------------------------
+    /**
+     * Get the raw pipeline input.
+     *
+     * Constructs RawSelectInput directly from FieldSet entries.
+     */
+    toRawInput() {
+        return this._buildDirectRawInput();
+    }
+    /**
+     * Build RawSelectInput directly from FieldSet entries.
+     */
+    _buildDirectRawInput() {
+        let fs = this.fields();
+        // When preloads exist, trace them through the proxy and merge with the FieldSet.
+        if (this._preloads && this._preloads.length > 0) {
+            const preloadFn = (p) => {
+                const results = [];
+                for (const entry of this._preloads) {
+                    results.push(p[entry.path].preloadFor(entry.component));
+                }
+                return results;
+            };
+            const preloadFs = FieldSet_js_1.FieldSet.for(this._shape, preloadFn);
+            if (fs) {
+                fs = FieldSet_js_1.FieldSet.createFromEntries(fs.shape, [
+                    ...fs.entries,
+                    ...preloadFs.entries,
+                ]);
+            }
+            else {
+                fs = preloadFs;
+            }
+        }
+        const entries = fs ? fs.entries : [];
+        // Evaluate where callback
+        let where;
+        if (this._whereFn) {
+            where = (0, SelectQuery_js_1.processWhereClause)(this._whereFn, this._shape);
+        }
+        // Evaluate sort callback
+        let sortBy;
+        if (this._sortByFn) {
+            sortBy = (0, SelectQuery_js_1.evaluateSortCallback)(this._shape, this._sortByFn, this._sortDirection || 'ASC');
+        }
+        const input = {
+            entries,
+            subject: this._subject,
+            limit: this._limit,
+            offset: this._offset,
+            shape: this._shape,
+            sortBy,
+            singleResult: this._singleResult ||
+                !!(this._subject &&
+                    typeof this._subject === 'object' &&
+                    'id' in this._subject),
+        };
+        if (where) {
+            input.where = where;
+        }
+        if (this._subjects && this._subjects.length > 0) {
+            input.subjects = this._subjects;
+        }
+        return input;
+    }
+    /** Build the IR (run the full pipeline: desugar → canonicalize → lower). */
+    build() {
+        return (0, IRPipeline_js_1.buildSelectQuery)(this.toRawInput());
+    }
+    /** Execute the query and return results. */
+    exec() {
+        return (0, queryDispatch_js_1.getQueryDispatch)().selectQuery(this.build());
+    }
+    // ---------------------------------------------------------------------------
+    // Promise-compatible interface
+    // ---------------------------------------------------------------------------
+    /** `await` triggers execution. */
+    then(onfulfilled, onrejected) {
+        return this.exec().then(onfulfilled, onrejected);
+    }
+    /** Catch errors from execution. Chain off then() to avoid re-executing. */
+    catch(onrejected) {
+        return this.then().catch(onrejected);
+    }
+    /** Finally handler after execution. Chain off then() to avoid re-executing. */
+    finally(onfinally) {
+        return this.then().finally(onfinally);
+    }
+    get [Symbol.toStringTag]() {
+        return 'QueryBuilder';
+    }
+}
+exports.QueryBuilder = QueryBuilder;
+//# sourceMappingURL=QueryBuilder.js.map

package/lib/cjs/queries/QueryBuilder.js.map

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