@spine-event-engine/client-node 2.0.0-snapshot.2

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,mBAAmB,IAAI,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE/F;;GAEG;AACH,MAAM,mBAAmB,GAAkC,sBAAsB,CAAC;AAElF,OAAO,EACL,YAAY,GAUb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,WAAW,EACX,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/query/entity-query.d.ts

@@ -0,0 +1,180 @@
+import { type Message, type MessageShape } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { type ActorContext } from "@spine-event-engine/proto";
+import { type Query } from "@spine-event-engine/proto/client";
+import { EntityColumn, type EntityColumnOperator, type EntityColumnValue } from "../entity/entity-column.js";
+type EntityColumnCollection<Schema extends GenMessage<Message>> = Readonly<Record<string, EntityColumn<Schema>>>;
+type PredicateColumn<Predicate> = Predicate extends EntityPredicate<infer Column> ? Column : never;
+type ColumnSchema<Column> = Column extends EntityColumn<infer Schema> ? Schema : never;
+type ColumnName<Column> = Column extends EntityColumn<GenMessage<Message>, infer Name> ? Name : never;
+type StateName<Schema extends GenMessage<Message>> = Exclude<keyof MessageShape<Schema>, "$typeName" | "$unknown"> & string;
+/**
+ * Represents one typed leaf comparison in an Entity query predicate.
+ */
+export interface EntityComparisonPredicate<Column extends EntityColumn = EntityColumn> {
+    /**
+     * Identifies this predicate as a leaf comparison.
+     */
+    readonly kind: "comparison";
+    /**
+     * Identifies the column compared by this predicate.
+     */
+    readonly column: Column;
+    /**
+     * Identifies the comparison operator applied to the column.
+     */
+    readonly operator: EntityColumnOperator<Column>;
+    /**
+     * Stores the value compared with the column.
+     */
+    readonly value: Exclude<EntityColumnValue<Column>, undefined>;
+}
+/**
+ * Represents a nested conjunction or disjunction in an Entity query predicate.
+ */
+export interface EntityGroup<Column extends EntityColumn = EntityColumn> {
+    /**
+     * Identifies the logical operation that combines the predicates.
+     */
+    readonly kind: "all" | "either";
+    /**
+     * Lists the predicates combined by this group.
+     */
+    readonly predicates: readonly EntityPredicate<Column>[];
+}
+/**
+ * Represents a typed predicate accepted by the Entity query builder.
+ */
+export type EntityPredicate<Column extends EntityColumn = EntityColumn> = EntityComparisonPredicate<Column> | EntityGroup<Column>;
+/**
+ * Builds a typed Entity query for the frozen Spine wire contract.
+ */
+export declare class EntityQueryBuilder<Schema extends GenMessage<Message>, Columns extends EntityColumnCollection<Schema>> {
+    #private;
+    /**
+     * Creates a builder for one Entity query.
+     *
+     * @param input Schema, registered columns, and actor context for the query.
+     */
+    constructor(input: {
+        readonly schema: Schema;
+        readonly columns: Columns;
+        readonly context: ActorContext;
+    });
+    /**
+     * Adds Entity IDs to the query target.
+     *
+     * @param ids Entity IDs to include.
+     * @returns This builder.
+     */
+    byId(...ids: readonly unknown[]): this;
+    /**
+     * Adds a typed predicate. Repeated calls are combined with `ALL`.
+     *
+     * @param predicate Predicate owned by this builder's registered columns.
+     * @returns This builder.
+     */
+    where<Predicate extends EntityPredicate>(predicate: ColumnSchema<PredicateColumn<Predicate>> extends Schema ? ColumnName<PredicateColumn<Predicate>> extends keyof Columns ? Predicate : never : never): this;
+    /**
+     * Adds top-level state fields returned by the server.
+     *
+     * @param paths Generated property names of state fields.
+     * @returns This builder.
+     */
+    mask(...paths: readonly StateName<Schema>[]): this;
+    /**
+     * Adds one ordering clause in caller order.
+     *
+     * @param column Ordered column owned by this builder's Entity schema.
+     * @param direction Sort direction, ascending by default.
+     * @returns This builder.
+     */
+    orderBy<Column extends EntityColumn<Schema>>(column: "greaterThan" extends EntityColumnOperator<Column> ? Column : never, direction?: "asc" | "desc"): this;
+    /**
+     * Sets a positive result limit that requires ordering.
+     *
+     * @param value Positive maximum number of returned entities.
+     * @returns This builder.
+     */
+    limit(value: number): this;
+    /**
+     * Builds the `spine.client.Query` message.
+     *
+     * @returns The wire query message.
+     */
+    build(): Query;
+}
+/**
+ * Creates typed predicates and builders for Entity queries.
+ */
+export declare const EntityQuery: Readonly<{
+    /**
+     * Creates an equality predicate for a descriptor-backed Entity column.
+     *
+     * @param column Column to compare.
+     * @param value Value to match.
+     * @returns Immutable equality predicate.
+     */
+    eq<Column extends EntityColumn>(column: Column, value: Exclude<EntityColumnValue<Column>, undefined>): EntityComparisonPredicate<Column>;
+    /**
+     * Creates a greater-than predicate for an ordered Entity column.
+     *
+     * @param column Ordered column to compare.
+     * @param value Lower exclusive bound.
+     * @returns Immutable greater-than predicate.
+     */
+    gt<Column extends EntityColumn>(column: "greaterThan" extends EntityColumnOperator<Column> ? Column : never, value: Exclude<EntityColumnValue<Column>, undefined>): EntityComparisonPredicate<Column>;
+    /**
+     * Creates a less-than predicate for an ordered Entity column.
+     *
+     * @param column Ordered column to compare.
+     * @param value Upper exclusive bound.
+     * @returns Immutable less-than predicate.
+     */
+    lt<Column extends EntityColumn>(column: "lessThan" extends EntityColumnOperator<Column> ? Column : never, value: Exclude<EntityColumnValue<Column>, undefined>): EntityComparisonPredicate<Column>;
+    /**
+     * Creates a greater-than-or-equal predicate for an ordered Entity column.
+     *
+     * @param column Ordered column to compare.
+     * @param value Lower inclusive bound.
+     * @returns Immutable inclusive lower-bound predicate.
+     */
+    ge<Column extends EntityColumn>(column: "greaterOrEqual" extends EntityColumnOperator<Column> ? Column : never, value: Exclude<EntityColumnValue<Column>, undefined>): EntityComparisonPredicate<Column>;
+    /**
+     * Creates a less-than-or-equal predicate for an ordered Entity column.
+     *
+     * @param column Ordered column to compare.
+     * @param value Upper inclusive bound.
+     * @returns Immutable inclusive upper-bound predicate.
+     */
+    le<Column extends EntityColumn>(column: "lessOrEqual" extends EntityColumnOperator<Column> ? Column : never, value: Exclude<EntityColumnValue<Column>, undefined>): EntityComparisonPredicate<Column>;
+    /**
+     * Combines predicates conjunctively.
+     *
+     * @param first First predicate in the group.
+     * @param rest Remaining predicates in the group.
+     * @returns Immutable conjunction predicate.
+     */
+    all<First extends EntityPredicate, Rest extends readonly EntityPredicate[]>(first: First, ...rest: Rest): EntityGroup<PredicateColumn<First | Rest[number]>>;
+    /**
+     * Combines predicates disjunctively.
+     *
+     * @param first First predicate in the group.
+     * @param rest Remaining predicates in the group.
+     * @returns Immutable disjunction predicate.
+     */
+    either<First extends EntityPredicate, Rest extends readonly EntityPredicate[]>(first: First, ...rest: Rest): EntityGroup<PredicateColumn<First | Rest[number]>>;
+    /**
+     * Creates a builder for one Entity schema.
+     *
+     * @param input Schema, registered columns, and actor context for the query.
+     * @returns A mutable query builder.
+     */
+    select<Schema extends GenMessage<Message>, Columns extends EntityColumnCollection<Schema>>(input: {
+        readonly schema: Schema;
+        readonly columns: Columns;
+        readonly context: ActorContext;
+    }): EntityQueryBuilder<Schema, Columns>;
+}>;
+export {};
+//# sourceMappingURL=entity-query.d.ts.map

package/dist/query/entity-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-query.d.ts","sourceRoot":"","sources":["../../src/query/entity-query.ts"],"names":[],"mappings":"AAcA,OAAO,EAOL,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAa/D,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAcL,KAAK,KAAK,EACX,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,KAAK,sBAAsB,CAAC,MAAM,SAAS,UAAU,CAAC,OAAO,CAAC,IAAI,QAAQ,CACxE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CACrC,CAAC;AACF,KAAK,eAAe,CAAC,SAAS,IAAI,SAAS,SAAS,eAAe,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AACnG,KAAK,YAAY,CAAC,MAAM,IAAI,MAAM,SAAS,YAAY,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AACvF,KAAK,UAAU,CAAC,MAAM,IACpB,MAAM,SAAS,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAK9E,KAAK,SAAS,CAAC,MAAM,SAAS,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAC1D,MAAM,YAAY,CAAC,MAAM,CAAC,EAC1B,WAAW,GAAG,UAAU,CACzB,GACC,MAAM,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY;IAGnF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY;IAGrE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY,IACpE,yBAAyB,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE1D;;GAEG;AACH,qBAAa,kBAAkB,CAC7B,MAAM,SAAS,UAAU,CAAC,OAAO,CAAC,EAClC,OAAO,SAAS,sBAAsB,CAAC,MAAM,CAAC;;IAW9C;;;;OAIG;gBACS,KAAK,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;KAChC;IAMD;;;;;OAKG;IACH,IAAI,CAAC,GAAG,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAQtC;;;;;OAKG;IACH,KAAK,CAAC,SAAS,SAAS,eAAe,EACrC,SAAS,EAAE,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,GAC9D,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,OAAO,GAC1D,SAAS,GACT,KAAK,GACP,KAAK,GACR,IAAI;IAUP;;;;;OAKG;IACH,IAAI,CAAC,GAAG,KAAK,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI;IAWlD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,SAAS,YAAY,CAAC,MAAM,CAAC,EACzC,MAAM,EAAE,aAAa,SAAS,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,EAC3E,SAAS,GAAE,KAAK,GAAG,MAAc,GAChC,IAAI;IAMP;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ1B;;;;OAIG;IACH,KAAK,IAAI,KAAK;CA2Df;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC;IAGjC;;;;;;OAMG;IACH,EAAE,CAAC,MAAM,SAAS,YAAY,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GACnD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,EAAE,CAAC,MAAM,SAAS,YAAY,EAC5B,MAAM,EAAE,aAAa,SAAS,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,EAC3E,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GACnD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,EAAE,CAAC,MAAM,SAAS,YAAY,EAC5B,MAAM,EAAE,UAAU,SAAS,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,EACxE,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GACnD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,EAAE,CAAC,MAAM,SAAS,YAAY,EAC5B,MAAM,EAAE,gBAAgB,SAAS,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,EAC9E,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GACnD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,EAAE,CAAC,MAAM,SAAS,YAAY,EAC5B,MAAM,EAAE,aAAa,SAAS,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,EAC3E,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GACnD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,SAAS,eAAe,EAAE,IAAI,SAAS,SAAS,eAAe,EAAE,EACxE,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,IAAI,GACZ,WAAW,CAAC,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtD;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,SAAS,eAAe,EAAE,IAAI,SAAS,SAAS,eAAe,EAAE,EAC3E,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,IAAI,GACZ,WAAW,CAAC,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,MAAM,CACJ,MAAM,SAAS,UAAU,CAAC,OAAO,CAAC,EAClC,OAAO,SAAS,sBAAsB,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE;QACP,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;KAChC,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAqEC,CAAC"}

package/dist/query/entity-query.js

@@ -0,0 +1,435 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { clone, create, getOption, hasOption, ScalarType, toBinary, } from "@bufbuild/protobuf";
+import { BoolValueSchema, AnySchema, BytesValueSchema, DoubleValueSchema, FloatValueSchema, Int32ValueSchema, Int64ValueSchema, StringValueSchema, UInt32ValueSchema, UInt64ValueSchema, } from "@bufbuild/protobuf/wkt";
+import { ActorContextSchema, VersionSchema, type_url_prefix, } from "@spine-event-engine/proto";
+import { CompositeFilterSchema, CompositeFilter_CompositeOperator, FilterSchema, Filter_Operator, IdFilterSchema, OrderBySchema, OrderBy_Direction, QueryIdSchema, QuerySchema, ResponseFormatSchema, TargetFiltersSchema, TargetSchema, } from "@spine-event-engine/proto/client";
+import { EntityColumn, } from "../entity/entity-column.js";
+const maximumPredicateDepth = 64;
+const maximumPredicateNodes = 10_000;
+/**
+ * Builds a typed Entity query for the frozen Spine wire contract.
+ */
+export class EntityQueryBuilder {
+    #schema;
+    #context;
+    #columns;
+    #ids = [];
+    #predicates = [];
+    #mask = [];
+    #order = [];
+    #limit;
+    /**
+     * Creates a builder for one Entity query.
+     *
+     * @param input Schema, registered columns, and actor context for the query.
+     */
+    constructor(input) {
+        this.#schema = input.schema;
+        this.#columns = input.columns;
+        this.#context = clone(ActorContextSchema, input.context);
+    }
+    /**
+     * Adds Entity IDs to the query target.
+     *
+     * @param ids Entity IDs to include.
+     * @returns This builder.
+     */
+    byId(...ids) {
+        if (ids.length === 0 || ids.some((id) => id === undefined)) {
+            throw new TypeError("Entity query ID filter must not be empty.");
+        }
+        this.#ids.push(...ids);
+        return this;
+    }
+    /**
+     * Adds a typed predicate. Repeated calls are combined with `ALL`.
+     *
+     * @param predicate Predicate owned by this builder's registered columns.
+     * @returns This builder.
+     */
+    where(predicate) {
+        if (this.#predicates.length >= maximumPredicateNodes) {
+            throw new TypeError(`Entity query predicate exceeds maximum node count ${String(maximumPredicateNodes)}.`);
+        }
+        this.#predicates.push(predicate);
+        return this;
+    }
+    /**
+     * Adds top-level state fields returned by the server.
+     *
+     * @param paths Generated property names of state fields.
+     * @returns This builder.
+     */
+    mask(...paths) {
+        for (const path of paths) {
+            const field = EntityQueryWire.findField(this.#schema, path);
+            if (field === undefined) {
+                throw new TypeError(`Entity query mask path "${path}" is not a state field.`);
+            }
+            this.#mask.push(field.name);
+        }
+        return this;
+    }
+    /**
+     * Adds one ordering clause in caller order.
+     *
+     * @param column Ordered column owned by this builder's Entity schema.
+     * @param direction Sort direction, ascending by default.
+     * @returns This builder.
+     */
+    orderBy(column, direction = "asc") {
+        EntityQueryWire.requireOwnedColumn(this.#schema, this.#columns, column);
+        this.#order.push({ column, direction });
+        return this;
+    }
+    /**
+     * Sets a positive result limit that requires ordering.
+     *
+     * @param value Positive maximum number of returned entities.
+     * @returns This builder.
+     */
+    limit(value) {
+        if (!Number.isSafeInteger(value) || value <= 0) {
+            throw new TypeError("Entity query limit must be a positive integer.");
+        }
+        this.#limit = value;
+        return this;
+    }
+    /**
+     * Builds the `spine.client.Query` message.
+     *
+     * @returns The wire query message.
+     */
+    build() {
+        if (this.#limit !== undefined && this.#order.length === 0) {
+            throw new TypeError("Entity query limit requires ordering.");
+        }
+        const filters = this.#filters();
+        const format = this.#format();
+        return create(QuerySchema, {
+            id: create(QueryIdSchema, { value: EntityQueryWire.nextId() }),
+            target: create(TargetSchema, {
+                type: EntityQueryWire.typeUrl(this.#schema),
+                criterion: filters === undefined
+                    ? { case: "includeAll", value: true }
+                    : { case: "filters", value: filters },
+            }),
+            context: clone(ActorContextSchema, this.#context),
+            ...(format === undefined ? {} : { format }),
+        });
+    }
+    #filters() {
+        const idField = this.#schema.fields[0];
+        if (this.#ids.length > 0 && idField === undefined) {
+            throw new TypeError("Entity query target has no ID field.");
+        }
+        const predicates = EntityQueryCompiler.compileGroups(this.#predicates, this.#schema, this.#columns);
+        if (this.#ids.length === 0 && predicates.length === 0)
+            return undefined;
+        return create(TargetFiltersSchema, {
+            ...(this.#ids.length === 0
+                ? {}
+                : {
+                    idFilter: create(IdFilterSchema, {
+                        id: this.#ids.map((id) => EntityQueryWire.packField(idField, id)),
+                    }),
+                }),
+            filter: [...predicates],
+        });
+    }
+    #format() {
+        if (this.#mask.length === 0 && this.#order.length === 0 && this.#limit === undefined) {
+            return undefined;
+        }
+        return create(ResponseFormatSchema, {
+            ...(this.#mask.length === 0 ? {} : { fieldMask: { paths: [...this.#mask] } }),
+            orderBy: this.#order.map(({ column, direction }) => create(OrderBySchema, {
+                column: column.name,
+                direction: direction === "desc" ? OrderBy_Direction.DESCENDING : OrderBy_Direction.ASCENDING,
+            })),
+            limit: this.#limit ?? 0,
+        });
+    }
+}
+/**
+ * Creates typed predicates and builders for Entity queries.
+ */
+export const EntityQuery = Object.freeze({
+    eq(column, value) {
+        return EntityQueryCompiler.comparison(column, "equal", value);
+    },
+    gt(column, value) {
+        return EntityQueryCompiler.comparison(column, "greaterThan", value);
+    },
+    lt(column, value) {
+        return EntityQueryCompiler.comparison(column, "lessThan", value);
+    },
+    ge(column, value) {
+        return EntityQueryCompiler.comparison(column, "greaterOrEqual", value);
+    },
+    le(column, value) {
+        return EntityQueryCompiler.comparison(column, "lessOrEqual", value);
+    },
+    all(first, ...rest) {
+        return EntityQueryCompiler.group("all", first, rest);
+    },
+    either(first, ...rest) {
+        return EntityQueryCompiler.group("either", first, rest);
+    },
+    select(input) {
+        return new EntityQueryBuilder(input);
+    },
+});
+/**
+ * Internal compiler for predicates, descriptors, and wire query messages.
+ */
+const EntityQueryCompiler = Object.freeze({
+    comparison(column, operator, value) {
+        if (!column.operators.includes(operator)) {
+            throw new TypeError(`Entity column "${column.name}" does not support ${operator}.`);
+        }
+        EntityQueryWire.requireValue(column, value);
+        return Object.freeze({ kind: "comparison", column, operator, value });
+    },
+    group(kind, first, rest) {
+        return Object.freeze({
+            kind,
+            predicates: Object.freeze([first, ...rest]),
+        });
+    },
+    compileGroups(roots, schema, columns) {
+        const compiled = new WeakMap();
+        const seen = new WeakSet();
+        const pending = [];
+        let scheduled = 0;
+        for (let index = roots.length - 1; index >= 0; index -= 1) {
+            pending.push({ predicate: roots[index], depth: 0, expanded: false });
+            scheduled += 1;
+        }
+        while (pending.length > 0) {
+            const current = pending.pop();
+            if (current === undefined)
+                break;
+            const predicate = EntityQueryWire.requirePredicate(current.predicate);
+            if (current.expanded) {
+                if (predicate.kind === "comparison") {
+                    throw new TypeError("Entity query predicate compilation state is invalid.");
+                }
+                const simple = [];
+                const nested = [];
+                for (const child of predicate.predicates) {
+                    const childResult = compiled.get(child);
+                    if (childResult === undefined)
+                        throw new TypeError("Entity query predicate is incomplete.");
+                    if (childResult.kind === "comparison")
+                        simple.push(childResult.filter);
+                    else
+                        nested.push(childResult.filter);
+                }
+                compiled.set(predicate, {
+                    kind: "group",
+                    filter: create(CompositeFilterSchema, {
+                        operator: predicate.kind === "either"
+                            ? CompositeFilter_CompositeOperator.EITHER
+                            : CompositeFilter_CompositeOperator.ALL,
+                        filter: simple,
+                        compositeFilter: nested,
+                    }),
+                });
+                continue;
+            }
+            if (seen.has(predicate))
+                throw new TypeError("Entity query predicate must not contain cycles.");
+            seen.add(predicate);
+            if (current.depth > maximumPredicateDepth) {
+                throw new TypeError(`Entity query predicate exceeds maximum depth ${String(maximumPredicateDepth)}.`);
+            }
+            if (predicate.kind === "comparison") {
+                EntityQueryWire.requireOwnedColumn(schema, columns, predicate.column);
+                compiled.set(predicate, {
+                    kind: "comparison",
+                    filter: EntityQueryWire.compileComparison(predicate),
+                });
+                continue;
+            }
+            if (predicate.predicates.length === 0) {
+                throw new TypeError(`${predicate.kind.toUpperCase()} predicate must not be empty.`);
+            }
+            if (scheduled + predicate.predicates.length > maximumPredicateNodes) {
+                throw new TypeError(`Entity query predicate exceeds maximum node count ${String(maximumPredicateNodes)}.`);
+            }
+            scheduled += predicate.predicates.length;
+            pending.push({ ...current, expanded: true });
+            for (let index = predicate.predicates.length - 1; index >= 0; index -= 1) {
+                if (!Object.hasOwn(predicate.predicates, index)) {
+                    throw new TypeError("Entity query predicate entries must be defined.");
+                }
+                pending.push({
+                    predicate: predicate.predicates[index],
+                    depth: current.depth + 1,
+                    expanded: false,
+                });
+            }
+        }
+        return roots.map((root) => {
+            const result = compiled.get(root);
+            if (result === undefined)
+                throw new TypeError("Entity query predicate is incomplete.");
+            return result.kind === "group"
+                ? result.filter
+                : create(CompositeFilterSchema, {
+                    operator: CompositeFilter_CompositeOperator.ALL,
+                    filter: [result.filter],
+                });
+        });
+    },
+});
+/**
+ * Validates and compiles Entity query details.
+ */
+const EntityQueryWire = Object.freeze({
+    requirePredicate(value) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new TypeError("Entity query predicate must be an object.");
+        }
+        const predicate = value;
+        if (predicate.kind === "comparison") {
+            if (!(predicate.column instanceof EntityColumn)) {
+                throw new TypeError("Entity query comparison column is required.");
+            }
+            return predicate;
+        }
+        if (predicate.kind !== "all" && predicate.kind !== "either") {
+            throw new TypeError("Entity query predicate kind must be recognized.");
+        }
+        if (!Array.isArray(predicate.predicates)) {
+            throw new TypeError(`${predicate.kind.toUpperCase()} predicate predicates must be an array.`);
+        }
+        return predicate;
+    },
+    compileComparison(predicate) {
+        return create(FilterSchema, {
+            fieldPath: { fieldName: [predicate.column.name] },
+            value: EntityQueryWire.packColumn(predicate.column, predicate.value),
+            operator: EntityQueryWire.wireOperator(predicate.operator),
+        });
+    },
+    wireOperator(operator) {
+        switch (operator) {
+            case "equal":
+                return Filter_Operator.EQUAL;
+            case "greaterThan":
+                return Filter_Operator.GREATER_THAN;
+            case "lessThan":
+                return Filter_Operator.LESS_THAN;
+            case "greaterOrEqual":
+                return Filter_Operator.GREATER_OR_EQUAL;
+            case "lessOrEqual":
+                return Filter_Operator.LESS_OR_EQUAL;
+            default:
+                throw new TypeError("Entity query comparison operator is not recognized.");
+        }
+    },
+    packColumn(column, value) {
+        if (column.source === "system") {
+            if (column.name === "version")
+                return EntityQueryWire.packMessage(VersionSchema, value);
+            return EntityQueryWire.packMessage(BoolValueSchema, create(BoolValueSchema, { value: value }));
+        }
+        if (column.descriptor === undefined) {
+            throw new TypeError("Entity query application column descriptor is required.");
+        }
+        return EntityQueryWire.packField(column.descriptor, value);
+    },
+    packField(field, value) {
+        if (field === undefined)
+            throw new TypeError("Entity query field descriptor is required.");
+        if (field.fieldKind === "message") {
+            return EntityQueryWire.packMessage(field.message, value);
+        }
+        if (field.fieldKind === "enum") {
+            return EntityQueryWire.packMessage(Int32ValueSchema, create(Int32ValueSchema, { value: value }));
+        }
+        if (field.fieldKind !== "scalar")
+            throw new TypeError("Entity query field kind is unsupported.");
+        const schema = EntityQueryWire.scalarSchema(field.scalar);
+        return EntityQueryWire.packMessage(schema, create(schema, { value }));
+    },
+    scalarSchema(scalar) {
+        switch (scalar) {
+            case ScalarType.BOOL:
+                return BoolValueSchema;
+            case ScalarType.BYTES:
+                return BytesValueSchema;
+            case ScalarType.DOUBLE:
+                return DoubleValueSchema;
+            case ScalarType.FLOAT:
+                return FloatValueSchema;
+            case ScalarType.INT64:
+            case ScalarType.SFIXED64:
+            case ScalarType.SINT64:
+                return Int64ValueSchema;
+            case ScalarType.UINT64:
+            case ScalarType.FIXED64:
+                return UInt64ValueSchema;
+            case ScalarType.UINT32:
+            case ScalarType.FIXED32:
+                return UInt32ValueSchema;
+            case ScalarType.STRING:
+                return StringValueSchema;
+            default:
+                return Int32ValueSchema;
+        }
+    },
+    requireOwnedColumn(schema, columns, column) {
+        if (column.schema !== schema ||
+            !Object.values(columns).some((candidate) => candidate === column)) {
+            throw new TypeError("Entity query column does not belong to the selected target.");
+        }
+    },
+    requireValue(column, value) {
+        const valid = value !== undefined &&
+            (column.valueKind === "message"
+                ? typeof value === "object" &&
+                    value !== null &&
+                    Reflect.get(value, "$typeName") === column.messageType
+                : column.valueKind === "bytes"
+                    ? value instanceof Uint8Array
+                    : column.valueKind === "enum" || column.valueKind === "number"
+                        ? typeof value === "number" && Number.isFinite(value)
+                        : typeof value === column.valueKind);
+        if (!valid)
+            throw new TypeError(`Entity query value for "${column.name}" has the wrong type.`);
+    },
+    findField(schema, name) {
+        return schema.fields.find((field) => field.name === name || field.localName === name);
+    },
+    nextId() {
+        return `query-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+    },
+    typeUrl(schema) {
+        const prefix = hasOption(schema.file, type_url_prefix)
+            ? getOption(schema.file, type_url_prefix)
+            : "type.googleapis.com";
+        return `${prefix.replace(/\/+$/u, "")}/${schema.typeName}`;
+    },
+    packMessage(schema, value) {
+        return create(AnySchema, {
+            typeUrl: EntityQueryWire.typeUrl(schema),
+            value: toBinary(schema, value, { writeUnknownFields: false }),
+        });
+    },
+});
+//# sourceMappingURL=entity-query.js.map

package/dist/query/entity-query.js.map

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