@spooky-sync/query-builder 0.0.1-canary.11 → 0.0.1-canary.111

package/dist/index.js

@@ -355,24 +355,31 @@ function buildQueryFromOptions(method, tableName, options, schema, patches) {
 	const vars = {};
 	if (parsedWhere && Object.keys(parsedWhere).length > 0) {
 		const conditions = [];
-		for (const [key, value] of Object.entries(parsedWhere)) {
-			const varName = key;
+		const buildCondition = (field, value, varName) => {
 			if (value && typeof value === "object" && "_op" in value && "_val" in value) {
 				const { _op, _val, _swap } = value;
-				let rightSide = "";
+				let rightSide;
 				if (typeof _val === "string" && _val.startsWith("$")) rightSide = _val;
 				else {
 					vars[varName] = _val;
 					rightSide = `$${varName}`;
 				}
-				if (_swap) conditions.push(`${rightSide} ${_op} ${key}`);
-				else conditions.push(`${key} ${_op} ${rightSide}`);
-			} else {
-				vars[varName] = value;
-				conditions.push(`${key} = $${varName}`);
+				return _swap ? `${rightSide} ${_op} ${field}` : `${field} ${_op} ${rightSide}`;
+			}
+			vars[varName] = value;
+			return `${field} = $${varName}`;
+		};
+		for (const [key, value] of Object.entries(parsedWhere)) {
+			if (key === "_or" && Array.isArray(value)) {
+				const orParts = [];
+				let i = 0;
+				for (const branch of value) if (branch && typeof branch === "object") for (const [bField, bVal] of Object.entries(branch)) orParts.push(buildCondition(bField, bVal, `or${i++}`));
+				if (orParts.length > 0) conditions.push(`(${orParts.join(" OR ")})`);
+				continue;
 			}
+			conditions.push(buildCondition(key, value, key));
 		}
-		query += ` WHERE ${conditions.join(" AND ")}`;
+		if (conditions.length > 0) query += ` WHERE ${conditions.join(" AND ")}`;
 	}
 	if (method === "UPDATE" && patches) query += ` PATCH ${JSON.stringify(patches)}`;
 	if (!isLiveQuery) {
@@ -387,8 +394,112 @@ function buildQueryFromOptions(method, tableName, options, schema, patches) {
 	return {
 		query,
 		hash: cyrb53(`${query}::${Object.entries(vars).map(([key, value]) => `${key}=${value}`).join("&")}`, 0),
-		vars: Object.keys(vars).length > 0 ? vars : void 0
+		vars: Object.keys(vars).length > 0 ? vars : void 0,
+		plan: method === "SELECT" ? buildQueryPlan(tableName, options, schema) : void 0
+	};
+}
+/**
+* Build the engine-neutral {@link QueryPlan} for a SELECT. Mirrors the string
+* assembly in {@link buildQueryFromOptions} / {@link buildSubquery} exactly so a
+* non-SurrealQL backend produces results identical to the SurrealQL path.
+*/
+function buildQueryPlan(tableName, options, schema) {
+	const plan = { table: tableName };
+	if (options.select && options.select.length > 0 && !options.select.includes("*")) plan.select = options.select.filter((f) => f !== "*");
+	const parsedWhere = options.where ? parseObjectIdsToRecordId(options.where, tableName) : void 0;
+	if (parsedWhere && Object.keys(parsedWhere).length > 0) {
+		const nodes = buildWhereNodes(parsedWhere);
+		if (nodes.length > 0) plan.where = nodes;
+	}
+	if (options.orderBy && Object.keys(options.orderBy).length > 0) plan.orderBy = Object.entries(options.orderBy).map(([field, direction]) => [field, direction]);
+	if (options.limit !== void 0) plan.limit = options.limit;
+	if (options.offset !== void 0) plan.offset = options.offset;
+	if (options.related && options.related.length > 0) plan.relations = options.related.map((rel) => buildRelationPlan(rel, schema));
+	return plan;
+}
+/**
+* Engine-neutral counterpart of {@link buildSubquery}. Resolves the same
+* cardinality / foreign-key / nested-relation metadata but returns a structured
+* {@link RelationPlan} instead of a SurrealQL subquery string.
+*/
+function buildRelationPlan(rel, schema) {
+	const { relatedTable, alias, modifier, cardinality } = rel;
+	const foreignKeyField = rel.foreignKeyField || alias || relatedTable;
+	const plan = {
+		alias: alias || relatedTable,
+		table: relatedTable,
+		cardinality,
+		foreignKeyField
+	};
+	if (modifier) {
+		const modifierBuilder = new SchemaAwareQueryModifierBuilderImpl(relatedTable, schema);
+		modifier(modifierBuilder);
+		const subOptions = modifierBuilder._getOptions();
+		if (subOptions.select && subOptions.select.length > 0 && !subOptions.select.includes("*")) plan.select = subOptions.select.filter((f) => f !== "*");
+		if (subOptions.where && Object.keys(subOptions.where).length > 0) {
+			const nodes = buildWhereNodes(parseObjectIdsToRecordId(subOptions.where, relatedTable));
+			if (nodes.length > 0) plan.where = nodes;
+		}
+		if (subOptions.orderBy && Object.keys(subOptions.orderBy).length > 0) plan.orderBy = Object.entries(subOptions.orderBy).map(([field, direction]) => [field, direction]);
+		if (subOptions.limit !== void 0) plan.limit = subOptions.limit;
+		if (subOptions.related && subOptions.related.length > 0) plan.relations = subOptions.related.map((nestedRel) => {
+			const relationship = schema.relationships.find((r) => r.from === relatedTable && r.field === nestedRel.alias);
+			if (relationship) {
+				const nestedForeignKeyField = relationship.cardinality === "many" ? relatedTable : nestedRel.alias;
+				return {
+					...nestedRel,
+					relatedTable: relationship.to,
+					cardinality: relationship.cardinality,
+					foreignKeyField: nestedForeignKeyField
+				};
+			}
+			return nestedRel;
+		}).map((nestedRel) => buildRelationPlan(nestedRel, schema));
+	}
+	if (cardinality === "one" && plan.limit === void 0) plan.limit = 1;
+	return plan;
+}
+/**
+* Convert a parsed WHERE object (string IDs already → RecordId) into the
+* engine-neutral {@link WhereNode}[] conjunction. Mirrors the `_or` / comparison
+* / equality handling in {@link buildQueryFromOptions}. A `$`-prefixed `_val`
+* becomes a `paramRef` (with the leading `$` stripped).
+*/
+function buildWhereNodes(parsedWhere) {
+	const toComparison = (field, value) => {
+		if (value && typeof value === "object" && "_op" in value && "_val" in value) {
+			const { _op, _val, _swap } = value;
+			if (typeof _val === "string" && _val.startsWith("$")) return {
+				field,
+				op: _op,
+				value: void 0,
+				paramRef: _val.slice(1),
+				swap: _swap
+			};
+			return {
+				field,
+				op: _op,
+				value: _val,
+				swap: _swap
+			};
+		}
+		return {
+			field,
+			op: "=",
+			value
+		};
 	};
+	const nodes = [];
+	for (const [key, value] of Object.entries(parsedWhere)) {
+		if (key === "_or" && Array.isArray(value)) {
+			const or = [];
+			for (const branch of value) if (branch && typeof branch === "object") for (const [bField, bVal] of Object.entries(branch)) or.push(toComparison(bField, bVal));
+			if (or.length > 0) nodes.push({ or });
+			continue;
+		}
+		nodes.push(toComparison(key, value));
+	}
+	return nodes;
 }
 /**
 * Build a subquery for a related field

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["RecordId"],"sources":["../src/query-builder.ts"],"sourcesContent":["import { RecordId } from 'surrealdb';\nimport type {\n  GenericModel,\n  QueryInfo,\n  QueryOptions,\n  QueryModifier,\n  RelatedQuery,\n  SchemaAwareQueryModifier,\n  SchemaAwareQueryModifierBuilder,\n} from './types';\nimport type {\n  TableNames,\n  GetTable,\n  TableModel,\n  TableRelationships,\n  GetRelationship,\n  SchemaStructure,\n  TableFieldNames,\n  ColumnSchema,\n} from './table-schema';\n\n/**\n * Parse a string ID to RecordId\n * - If it's in the format \"table:id\", use it as-is\n * - If it's just an ID without \":\", prepend the table name\n * @param value - The value to parse (could be a string ID)\n * @param tableName - The table name to use if the ID doesn't contain \":\"\n * @param fieldName - The field name to determine if this is an ID field\n */\nfunction parseStringToRecordId(value: unknown, tableName?: string, fieldName?: string): unknown {\n  if (typeof value !== 'string') return value;\n\n  // If it already contains \":\", parse it as a full record ID\n  if (value.includes(':')) {\n    const [table, ...idParts] = value.split(':');\n    const id = idParts.join(':'); // Handle IDs that contain colons\n    return new RecordId(table, id);\n  }\n\n  // If this is an \"id\" field and we have a table name, prepend it\n  if (fieldName === 'id' && tableName) {\n    return new RecordId(tableName, value);\n  }\n\n  // Otherwise, return as-is (it might not be an ID at all)\n  return value;\n}\n\n/**\n * Recursively parse string IDs to RecordId in an object\n * @param obj - The object to parse\n * @param tableName - The table name to use for ID fields without \":\"\n */\nfunction parseObjectIdsToRecordId(obj: unknown, tableName?: string): unknown {\n  if (obj === null || obj === undefined) return obj;\n\n  if (typeof obj === 'string') {\n    return parseStringToRecordId(obj, tableName);\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => parseObjectIdsToRecordId(item, tableName));\n  }\n\n  if (typeof obj === 'object' && obj.constructor === Object) {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      // Parse recursively, passing the field name to identify ID fields\n      result[key] =\n        typeof value === 'string'\n          ? parseStringToRecordId(value, tableName, key)\n          : parseObjectIdsToRecordId(value, tableName);\n    }\n    return result;\n  }\n\n  return obj;\n}\n\nexport type Executor<T extends { columns: Record<string, ColumnSchema> }, R = void> = (\n  query: InnerQuery<T, boolean>\n) => R;\n\nexport class InnerQuery<\n  T extends { columns: Record<string, ColumnSchema> },\n  IsOne extends boolean,\n  R = void,\n> {\n  private _hash: number;\n  private _mainQuery: QueryInfo;\n  private _selectQuery: QueryInfo;\n  private _selectLiveQuery: QueryInfo;\n  private _subqueries: InnerQuery<{ columns: Record<string, ColumnSchema> }, boolean>[];\n\n  constructor(\n    private readonly _tableName: string,\n    private readonly options: QueryOptions<TableModel<T>, IsOne>,\n    private readonly schema: SchemaStructure,\n    private readonly executor: Executor<any, R>\n  ) {\n    this._selectQuery = buildQueryFromOptions('SELECT', this._tableName, this.options, this.schema);\n\n    this._mainQuery = buildQueryFromOptions(\n      'SELECT',\n      this._tableName,\n      { ...this.options, related: [] },\n      this.schema\n    );\n\n    this._hash = this._selectQuery.hash;\n\n    this._selectLiveQuery = buildQueryFromOptions(\n      'LIVE SELECT',\n      this._tableName,\n      this.options,\n      this.schema\n    );\n\n    this._subqueries = extractSubqueryQueryInfos(\n      schema,\n      this._tableName,\n      this.options,\n      this.executor\n    );\n  }\n\n  get mainQuery(): QueryInfo {\n    return this._mainQuery;\n  }\n\n  get subqueries(): InnerQuery<{ columns: Record<string, ColumnSchema> }, boolean>[] {\n    return this._subqueries;\n  }\n\n  get selectQuery(): QueryInfo {\n    return this._selectQuery;\n  }\n\n  get selectLiveQuery(): QueryInfo {\n    return this._selectLiveQuery;\n  }\n\n  get tableName(): string {\n    return this._tableName;\n  }\n\n  get hash(): number {\n    return this._hash;\n  }\n\n  get isOne(): boolean {\n    return this.options.isOne ?? false;\n  }\n\n  public run(): R {\n    return this.executor(this);\n  }\n\n  public buildUpdateQuery(patches: any[]): QueryInfo {\n    return buildQueryFromOptions('UPDATE', this._tableName, this.options, this.schema, patches);\n  }\n\n  public buildDeleteQuery(): QueryInfo {\n    return buildQueryFromOptions('DELETE', this._tableName, this.options, this.schema);\n  }\n\n  public getOptions(): QueryOptions<TableModel<T>, IsOne> {\n    return this.options;\n  }\n}\n\n/**\n * Helper type to get the model type for a related table\n */\ntype GetRelatedModel<S extends SchemaStructure, RelatedTableName extends string> =\n  RelatedTableName extends TableNames<S> ? TableModel<GetTable<S, RelatedTableName>> : never;\n\n/**\n * Helper type to extract field names from RelatedFields\n */\nexport type ExtractFieldNames<RelatedFields extends RelatedFieldsMap> = keyof RelatedFields;\n\nexport type RelatedFieldMapEntry = {\n  to: string;\n  cardinality: 'one' | 'many';\n  relatedFields: RelatedFieldsMap;\n};\n\nexport type RelatedFieldsMap = Record<string, RelatedFieldMapEntry>;\n\n/**\n * Helper type to build the related fields object based on accumulated relationships\n */\nexport type BuildRelatedFields<\n  S extends SchemaStructure,\n  RelatedFields extends RelatedFieldsMap,\n> = {\n  [K in keyof RelatedFields]: QueryResult<\n    S,\n    RelatedFields[K]['to'],\n    RelatedFields[K]['relatedFields'],\n    RelatedFields[K]['cardinality'] extends 'one' ? true : false\n  >;\n};\n\nexport type BuildResultModelOne<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap,\n> = Omit<TableModel<GetTable<S, TableName>>, ExtractFieldNames<RelatedFields>> &\n  BuildRelatedFields<S, RelatedFields>;\n\nexport type BuildResultModelMany<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap,\n> = (Omit<TableModel<GetTable<S, TableName>>, ExtractFieldNames<RelatedFields>> &\n  BuildRelatedFields<S, RelatedFields>)[];\n\n/**\n * The final result type combining base model with related fields\n * Excludes related field keys from the base model to avoid type conflicts\n */\nexport type QueryResult<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap,\n  IsOne extends boolean,\n> = IsOne extends true\n  ? BuildResultModelOne<S, TableName, RelatedFields>\n  : BuildResultModelMany<S, TableName, RelatedFields>;\n\nexport class FinalQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends RelatedFieldsMap,\n  IsOne extends boolean,\n  R = void,\n> {\n  private _innerQuery: InnerQuery<T, IsOne, R>;\n\n  constructor(\n    private readonly tableName: TableName,\n    private readonly options: QueryOptions<TableModel<T>, IsOne>,\n    private readonly schema: S,\n    private readonly executor: Executor<T, R>\n  ) {\n    this._innerQuery = new InnerQuery<T, IsOne, R>(\n      this.tableName,\n      this.options,\n      this.schema,\n      this.executor\n    );\n  }\n\n  run(): R {\n    return this.executor(this._innerQuery);\n  }\n\n  buildUpdateQuery(patches: any[]): QueryInfo {\n    return this._innerQuery.buildUpdateQuery(patches);\n  }\n\n  buildDeleteQuery(): QueryInfo {\n    return this._innerQuery.buildDeleteQuery();\n  }\n\n  selectLive(): QueryInfo {\n    return this._innerQuery.selectLiveQuery;\n  }\n\n  get innerQuery(): InnerQuery<T, IsOne, R> {\n    return this._innerQuery;\n  }\n\n  get isOne(): boolean {\n    return this.options.isOne ?? false;\n  }\n\n  get hash(): number {\n    return this._innerQuery.hash;\n  }\n}\n\n/**\n * Schema-aware query modifier builder implementation\n * This version provides full type safety for nested relationships\n */\nclass SchemaAwareQueryModifierBuilderImpl<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap = {},\n> implements SchemaAwareQueryModifierBuilder<S, TableName, RelatedFields> {\n  private options: QueryOptions<TableModel<GetTable<S, TableName>>, boolean> = {};\n\n  constructor(\n    private readonly tableName: TableName,\n    private readonly schema: S\n  ) {}\n\n  where(conditions: Partial<TableModel<GetTable<S, TableName>>>): this {\n    this.options.where = { ...this.options.where, ...conditions };\n    return this;\n  }\n\n  select(...fields: ((keyof TableModel<GetTable<S, TableName>> & string) | '*')[]): this {\n    if (this.options.select) {\n      throw new Error('Select can only be called once per query');\n    }\n    this.options.select = fields;\n    return this;\n  }\n\n  limit(count: number): this {\n    this.options.limit = count;\n    return this;\n  }\n\n  offset(count: number): this {\n    this.options.offset = count;\n    return this;\n  }\n\n  orderBy(\n    field: keyof TableModel<GetTable<S, TableName>> & string,\n    direction: 'asc' | 'desc' = 'asc'\n  ): this {\n    this.options.orderBy = {\n      ...this.options.orderBy,\n      [field]: direction,\n    } as Partial<Record<keyof TableModel<GetTable<S, TableName>>, 'asc' | 'desc'>>;\n    return this;\n  }\n\n  // Schema-aware implementation for nested relationships with full type inference\n  related<\n    Field extends TableRelationships<S, TableName>['field'],\n    Rel extends GetRelationship<S, TableName, Field>,\n    RelatedFields2 extends RelatedFieldsMap = {},\n  >(\n    relatedField: Field,\n    modifier?: SchemaAwareQueryModifier<S, Rel['to'], RelatedFields2>\n  ): SchemaAwareQueryModifierBuilderImpl<\n    S,\n    TableName,\n    RelatedFields & {\n      [K in Field]: {\n        to: Rel['to'];\n        cardinality: Rel['cardinality'];\n        relatedFields: RelatedFields2;\n      };\n    }\n  > {\n    if (!this.options.related) {\n      this.options.related = [];\n    }\n\n    const exists = this.options.related.some((r) => (r.alias || r.relatedTable) === relatedField);\n\n    if (!exists) {\n      // Look up the relationship from schema\n      const relationship = this.schema.relationships.find(\n        (r) => r.from === this.tableName && r.field === relatedField\n      );\n\n      if (!relationship) {\n        throw new Error(\n          `Relationship '${String(relatedField)}' not found for table '${this.tableName}'`\n        );\n      }\n\n      const relatedTable = relationship.to;\n      const cardinality = relationship.cardinality;\n      const foreignKeyField = cardinality === 'many' ? this.tableName : relatedField;\n\n      this.options.related.push({\n        relatedTable,\n        alias: relatedField as string,\n        modifier: modifier as QueryModifier<GenericModel>,\n        cardinality,\n        foreignKeyField: foreignKeyField as string,\n      } as RelatedQuery & { foreignKeyField: string });\n    }\n    return this as any;\n  }\n\n  _getOptions(): QueryOptions<TableModel<GetTable<S, TableName>>, boolean> {\n    return this.options;\n  }\n}\n\n/**\n * Fluent query builder for constructing queries with chainable methods\n * Now with full type inference from schema constant AND related field accumulation!\n */\nexport class QueryBuilder<\n  const S extends SchemaStructure,\n  const TableName extends TableNames<S>,\n  const R = void,\n  const RelatedFields extends RelatedFieldsMap = {},\n  const IsOne extends boolean = false,\n> {\n  constructor(\n    private readonly schema: S,\n    private readonly tableName: TableName,\n    private readonly executer: Executor<GetTable<S, TableName>, R> = () => undefined as R,\n    private options: QueryOptions<TableModel<GetTable<S, TableName>>, IsOne> = {}\n  ) {}\n\n  /**\n   * Add additional where conditions\n   */\n  where(\n    conditions: Partial<TableModel<GetTable<S, TableName>>>\n  ): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.where = { ...this.options.where, ...conditions };\n    return this;\n  }\n\n  /**\n   * Specify fields to select\n   */\n  select(\n    ...fields: ((keyof TableModel<GetTable<S, TableName>> & string) | '*')[]\n  ): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    if (this.options.select) {\n      throw new Error('Select can only be called once per query');\n    }\n    this.options.select = fields;\n    return this;\n  }\n\n  /**\n   * Add ordering to the query (only for non-live queries)\n   */\n  orderBy(\n    field: TableFieldNames<GetTable<S, TableName>>,\n    direction: 'asc' | 'desc' = 'asc'\n  ): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.orderBy = {\n      ...this.options.orderBy,\n      [field]: direction,\n    } as Partial<Record<keyof TableModel<GetTable<S, TableName>>, 'asc' | 'desc'>>;\n    return this;\n  }\n\n  /**\n   * Add limit to the query (only for non-live queries)\n   */\n  limit(count: number): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.limit = count;\n    return this;\n  }\n\n  /**\n   * Add offset to the query (only for non-live queries)\n   */\n  offset(count: number): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.offset = count;\n    return this;\n  }\n\n  one(): QueryBuilder<S, TableName, R, RelatedFields, true> {\n    return new QueryBuilder<S, TableName, R, RelatedFields, true>(\n      this.schema,\n      this.tableName,\n      this.executer,\n      { ...this.options, isOne: true }\n    );\n  }\n\n  /**\n   * Include related data via subqueries\n   * Field and cardinality are validated against schema relationships\n   * Now accumulates the related field in the type!\n   */\n  related<\n    Field extends TableRelationships<S, TableName>['field'],\n    Rel extends GetRelationship<S, TableName, Field>,\n    RelatedFields2 extends RelatedFieldsMap = {},\n  >(\n    field: Field,\n    modifierOrCardinality?:\n      | SchemaAwareQueryModifier<S, Rel['to'], RelatedFields2>\n      | Rel['cardinality'],\n    modifier?: SchemaAwareQueryModifier<S, Rel['to'], RelatedFields2>\n  ): QueryBuilder<\n    S,\n    TableName,\n    R,\n    RelatedFields & {\n      [K in Field]: {\n        to: Rel['to'];\n        cardinality: Rel['cardinality'];\n        relatedFields: RelatedFields2;\n      };\n    },\n    IsOne\n  > {\n    if (!this.options.related) {\n      this.options.related = [];\n    }\n\n    // Check if field already exists\n    const exists = this.options.related.some((r) => (r.alias || r.relatedTable) === field);\n\n    if (exists) {\n      return this as any;\n    }\n\n    // Look up relationship metadata from schema\n    const relationship = this.schema.relationships.find(\n      (r) => r.from === this.tableName && r.field === field\n    );\n\n    if (!relationship) {\n      throw new Error(`Relationship '${String(field)}' not found for table '${this.tableName}'`);\n    }\n\n    // Determine cardinality and modifier based on arguments\n    let actualCardinality: 'one' | 'many';\n    let actualModifier: SchemaAwareQueryModifier<S, Rel['to']> | undefined;\n\n    if (typeof modifierOrCardinality === 'function') {\n      // Signature: related(field, modifier)\n      actualCardinality = relationship.cardinality;\n      actualModifier = modifierOrCardinality;\n    } else if (modifierOrCardinality === 'one' || modifierOrCardinality === 'many') {\n      // Signature: related(field, cardinality, modifier)\n      actualCardinality = modifierOrCardinality;\n      actualModifier = modifier;\n    } else {\n      // Signature: related(field)\n      actualCardinality = relationship.cardinality;\n      actualModifier = undefined;\n    }\n\n    // Determine foreign key field based on cardinality\n    let foreignKeyField: string =\n      actualCardinality === 'many' ? (this.tableName as string) : (field as string);\n\n    if (actualCardinality === 'many') {\n      // For one-to-many, we need to find the field on the child table that points back to the parent\n      // We look for a relationship from Child -> Parent\n      const reverseRelationships = this.schema.relationships.filter(\n        (r) => r.from === relationship.to && r.to === this.tableName && r.cardinality === 'one'\n      );\n\n      if (reverseRelationships.length > 0) {\n        // Prioritize field that matches parent table name\n        const exactMatch = reverseRelationships.find((r) => r.field === this.tableName);\n        if (exactMatch) {\n          foreignKeyField = exactMatch.field;\n        } else {\n          foreignKeyField = reverseRelationships[0].field;\n        }\n      } else {\n        // Fallback heuristics\n        if (this.tableName.startsWith(`${relationship.to}_`)) {\n          // If parent table is \"game_database\" and child is \"game\", try \"database\"\n          foreignKeyField = this.tableName.slice(relationship.to.length + 1);\n        }\n      }\n    }\n\n    // Cast the schema-aware modifier to the runtime type\n    // At runtime, QueryModifierBuilderImpl will work correctly with the schema\n    const wrappedModifier = actualModifier as QueryModifier<GenericModel> | undefined;\n\n    this.options.related.push({\n      relatedTable: relationship.to,\n      alias: field as string,\n      modifier: wrappedModifier,\n      cardinality: actualCardinality,\n      foreignKeyField: foreignKeyField as any,\n    } as RelatedQuery & { foreignKeyField: string });\n\n    return this as any;\n  }\n\n  /**\n   * Get the current query options\n   */\n  getOptions(): QueryOptions<TableModel<GetTable<S, TableName>>, IsOne> {\n    return this.options;\n  }\n\n  /**\n   * Build query methods for SELECT and LIVE SELECT (custom implementation)\n   * @returns FinalQuery object with select() method for custom usage\n   */\n  build(): FinalQuery<S, TableName, GetTable<S, TableName>, RelatedFields, IsOne, R> {\n    return new FinalQuery<S, TableName, GetTable<S, TableName>, RelatedFields, IsOne, R>(\n      this.tableName,\n      this.options,\n      this.schema,\n      this.executer\n    );\n  }\n}\n\nexport function cyrb53(str: string, seed: number = 0): number {\n  let h1 = 0xdeadbeef ^ seed,\n    h2 = 0x41c6ce57 ^ seed;\n  for (let i = 0, ch; i < str.length; i++) {\n    ch = str.charCodeAt(i);\n    h1 = Math.imul(h1 ^ ch, 2654435761);\n    h2 = Math.imul(h2 ^ ch, 1597334677);\n  }\n  h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507);\n  h1 ^= Math.imul(h2 ^ (h2 >>> 13), 3266489909);\n  h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507);\n  h2 ^= Math.imul(h1 ^ (h1 >>> 13), 3266489909);\n\n  return 4294967296 * (2097151 & h2) + (h1 >>> 0);\n}\n\nexport function extractSubqueryQueryInfos<S extends SchemaStructure>(\n  schema: S,\n  parentTableName: string,\n  options: QueryOptions<GenericModel, boolean>,\n  executer: Executor<{ columns: Record<string, ColumnSchema> }>\n): InnerQuery<{ columns: Record<string, ColumnSchema> }, boolean>[] {\n  if (!options.related) {\n    return [];\n  }\n\n  return options.related.map((rel) => {\n    // Get base options from modifier\n    const subOptions =\n      rel\n        .modifier?.(new SchemaAwareQueryModifierBuilderImpl(rel.relatedTable, schema))\n        ._getOptions() ?? {};\n\n    // Find relationship to determine how to filter\n    const relationship = schema.relationships.find(\n      (r) => r.from === parentTableName && r.field === rel.alias\n    );\n\n    if (relationship) {\n      // Determine foreign key field\n      // rel.alias is guaranteed to be defined if relationship is found (matched r.field)\n      let foreignKeyField = rel.alias!;\n\n      if (relationship.cardinality === 'many') {\n        // For one-to-many, we need to find the field on the child table that points back to the parent\n        // We look for a relationship from Child -> Parent\n        const reverseRelationships = schema.relationships.filter(\n          (r) => r.from === rel.relatedTable && r.to === parentTableName && r.cardinality === 'one'\n        );\n\n        if (reverseRelationships.length > 0) {\n          // Prioritize field that matches parent table name\n          const exactMatch = reverseRelationships.find((r) => r.field === parentTableName);\n          if (exactMatch) {\n            foreignKeyField = exactMatch.field;\n          } else {\n            foreignKeyField = reverseRelationships[0].field;\n          }\n        } else {\n          // Fallback heuristics\n          if (parentTableName.startsWith(`${rel.relatedTable}_`)) {\n            // If parent table is \"game_database\" and child is \"game\", try \"database\"\n            foreignKeyField = parentTableName.slice(rel.relatedTable.length + 1);\n          } else {\n            // Default to parent table name\n            foreignKeyField = parentTableName;\n          }\n        }\n      }\n\n      // Add parent filter to where clause\n      subOptions.where = subOptions.where || {};\n\n      if (relationship.cardinality === 'many') {\n        // One-to-Many: Child has foreign key to parent\n        // WHERE $parentIds ∋ child.parent_id\n        (subOptions.where as any)[foreignKeyField] = { _op: '∋', _val: '$parentIds', _swap: true };\n      } else {\n        // One-to-One: Parent has foreign key to child\n        // WHERE $parent_<foreignKeyField> ∋ child.id\n        // We use a dynamic variable name derived from the foreign key field on the parent\n        (subOptions.where as any).id = {\n          _op: '∋',\n          _val: `$parent_${foreignKeyField}`,\n          _swap: true,\n        };\n      }\n    }\n\n    return new InnerQuery(rel.relatedTable, subOptions, schema, executer);\n  });\n}\n\n/**\n * Build a query string from query options\n * @param method - The query method (SELECT or LIVE SELECT)\n * @param tableName - The table name to query\n * @param options - The query options (where, select, orderBy, etc.)\n * @param schema - Optional schema for resolving nested relationships\n * @returns QueryInfo with the generated SQL and variables\n */\nexport function buildQueryFromOptions<TModel extends GenericModel, IsOne extends boolean>(\n  method: 'SELECT' | 'LIVE SELECT' | 'LIVE SELECT DIFF' | 'UPDATE' | 'DELETE',\n  tableName: string,\n  options: QueryOptions<TModel, IsOne>,\n  schema: SchemaStructure,\n  patches?: any[]\n): QueryInfo {\n  if (options.isOne) {\n    options.limit = 1;\n  }\n  const isLiveQuery = method === 'LIVE SELECT' || method === 'LIVE SELECT DIFF';\n\n  // Parse where conditions to convert string IDs to RecordId\n  const parsedWhere = options.where\n    ? parseObjectIdsToRecordId(options.where, tableName)\n    : undefined;\n\n  // Build SELECT clause\n  let selectClause = '*';\n\n  if (method === 'LIVE SELECT DIFF') {\n    selectClause = '';\n  } else {\n    if (options.select && options.select.length > 0) {\n      selectClause = options.select.join(', ');\n    }\n  }\n\n  // Build related subqueries (fetch clauses)\n  let fetchClauses = '';\n  if (!isLiveQuery && options.related && options.related.length > 0) {\n    const subqueries = options.related.map((rel) => buildSubquery(rel, schema));\n    fetchClauses = ', ' + subqueries.join(', ');\n  }\n\n  // Start building the query\n  let query = '';\n\n  if (method === 'UPDATE') {\n    query = `UPDATE ${tableName}`;\n  } else if (method === 'DELETE') {\n    query = `DELETE FROM ${tableName}`;\n  } else {\n    query = `${method}${selectClause ? ` ${selectClause}` : ''}${fetchClauses} FROM ${tableName}`;\n  }\n\n  // Build WHERE clause\n  const vars: Record<string, unknown> = {};\n  if (parsedWhere && Object.keys(parsedWhere).length > 0) {\n    const conditions: string[] = [];\n    for (const [key, value] of Object.entries(parsedWhere)) {\n      const varName = key;\n\n      // Handle operator objects { _op, _val }\n      if (value && typeof value === 'object' && '_op' in value && '_val' in value) {\n        const { _op, _val, _swap } = value as { _op: string; _val: unknown; _swap?: boolean };\n\n        let rightSide = '';\n        if (typeof _val === 'string' && _val.startsWith('$')) {\n          rightSide = _val;\n        } else {\n          vars[varName] = _val;\n          rightSide = `$${varName}`;\n        }\n\n        if (_swap) {\n          conditions.push(`${rightSide} ${_op} ${key}`);\n        } else {\n          conditions.push(`${key} ${_op} ${rightSide}`);\n        }\n      } else {\n        vars[varName] = value;\n        conditions.push(`${key} = $${varName}`);\n      }\n    }\n    query += ` WHERE ${conditions.join(' AND ')}`;\n  }\n\n  // Add PATCH for UPDATE\n  if (method === 'UPDATE' && patches) {\n    query += ` PATCH ${JSON.stringify(patches)}`;\n  }\n\n  // Add ORDER BY, LIMIT, START only for non-live queries and non-update/delete queries (unless supported)\n  // SurrealDB UPDATE/DELETE supports WHERE, but LIMIT/START/ORDER BY might be restricted or behave differently.\n  // For now, let's allow them if they are set, as SurrealDB supports them for DELETE/UPDATE.\n  if (!isLiveQuery) {\n    if (options.orderBy && Object.keys(options.orderBy).length > 0) {\n      const orderClauses = Object.entries(options.orderBy).map(\n        ([field, direction]) => `${field} ${direction}`\n      );\n      query += ` ORDER BY ${orderClauses.join(', ')}`;\n    }\n\n    if (options.limit !== undefined) {\n      query += ` LIMIT ${options.limit}`;\n    }\n\n    if (options.offset !== undefined) {\n      query += ` START ${options.offset}`;\n    }\n  }\n\n  query += ';';\n\n  return {\n    query,\n    hash: cyrb53(\n      `${query}::${Object.entries(vars)\n        .map(([key, value]) => `${key}=${value}`)\n        .join('&')}`,\n      0\n    ),\n    vars: Object.keys(vars).length > 0 ? vars : undefined,\n  };\n}\n\n/**\n * Build a subquery for a related field\n */\nfunction buildSubquery(\n  rel: RelatedQuery & { foreignKeyField?: string },\n  schema: SchemaStructure\n): string {\n  const { relatedTable, alias, modifier, cardinality } = rel;\n  const foreignKeyField = rel.foreignKeyField || alias;\n\n  let subquerySelect = '*';\n  let subqueryWhere = '';\n  let subqueryOrderBy = '';\n  let subqueryLimit = '';\n\n  // If there's a modifier, apply it to get the sub-options\n  if (modifier) {\n    const modifierBuilder = new SchemaAwareQueryModifierBuilderImpl(relatedTable, schema);\n    modifier(modifierBuilder);\n    const subOptions = modifierBuilder._getOptions();\n\n    // Build sub-select\n    if (subOptions.select && subOptions.select.length > 0) {\n      subquerySelect = subOptions.select.join(', ');\n    }\n\n    // Build sub-where\n    if (subOptions.where && Object.keys(subOptions.where).length > 0) {\n      const parsedSubWhere = parseObjectIdsToRecordId(subOptions.where, relatedTable) as Record<\n        string,\n        unknown\n      >;\n      const conditions = Object.entries(parsedSubWhere).map(([key, value]) => {\n        if (value instanceof RecordId) {\n          return `${key} = ${value.toString()}`;\n        }\n        return `${key} = ${JSON.stringify(value)}`;\n      });\n      subqueryWhere = ` AND ${conditions.join(' AND ')}`;\n    }\n\n    // Build sub-orderBy\n    if (subOptions.orderBy && Object.keys(subOptions.orderBy).length > 0) {\n      const orderClauses = Object.entries(subOptions.orderBy).map(\n        ([field, direction]) => `${field} ${direction}`\n      );\n      subqueryOrderBy = ` ORDER BY ${orderClauses.join(', ')}`;\n    }\n\n    // Build sub-limit\n    if (subOptions.limit !== undefined) {\n      subqueryLimit = ` LIMIT ${subOptions.limit}`;\n    }\n\n    // Handle nested relationships\n    if (subOptions.related && subOptions.related.length > 0) {\n      // Resolve nested relationship metadata if schema is available\n      const resolvedNestedRels = subOptions.related.map((nestedRel) => {\n        if (schema) {\n          // Look up the actual relationship metadata from schema\n          const relationship = schema.relationships.find(\n            (r) => r.from === relatedTable && r.field === nestedRel.alias\n          );\n\n          if (relationship) {\n            // Use the resolved table name and add foreign key field\n            const nestedForeignKeyField =\n              relationship.cardinality === 'many' ? relatedTable : nestedRel.alias;\n\n            return {\n              ...nestedRel,\n              relatedTable: relationship.to,\n              cardinality: relationship.cardinality,\n              foreignKeyField: nestedForeignKeyField,\n            } as RelatedQuery & { foreignKeyField: string };\n          }\n        }\n        return nestedRel;\n      });\n\n      const nestedSubqueries = resolvedNestedRels.map((nestedRel) =>\n        buildSubquery(nestedRel, schema)\n      );\n      subquerySelect += ', ' + nestedSubqueries.join(', ');\n    }\n  }\n\n  // Determine the WHERE condition based on cardinality\n  let whereCondition: string;\n  if (cardinality === 'one') {\n    // For one-to-one, the related table's id matches parent's foreign key field\n    whereCondition = `WHERE id=$parent.${foreignKeyField}`;\n    // Add LIMIT 1 for one-to-one relationships if not already set\n    if (!subqueryLimit) {\n      subqueryLimit = ' LIMIT 1';\n    }\n  } else {\n    // For one-to-many, the related table has a foreign key field pointing to parent's id\n    whereCondition = `WHERE ${foreignKeyField}=$parent.id`;\n  }\n\n  // Build the complete subquery\n  let subquery = `(SELECT ${subquerySelect} FROM ${relatedTable} ${whereCondition}${subqueryWhere}${subqueryOrderBy}${subqueryLimit})`;\n\n  // For one-to-one relationships, select the first element\n  if (cardinality === 'one') {\n    subquery += '[0]';\n  }\n\n  subquery += ` AS ${alias}`;\n\n  return subquery;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["RecordId"],"sources":["../src/query-builder.ts"],"sourcesContent":["import { RecordId } from 'surrealdb';\nimport type {\n  GenericModel,\n  QueryInfo,\n  QueryOptions,\n  QueryModifier,\n  RelatedQuery,\n  SchemaAwareQueryModifier,\n  SchemaAwareQueryModifierBuilder,\n  WhereInput,\n  QueryPlan,\n  RelationPlan,\n  WhereNode,\n  WhereComparison,\n  ComparisonOp,\n} from './types';\nimport type {\n  TableNames,\n  GetTable,\n  TableModel,\n  TableRelationships,\n  GetRelationship,\n  SchemaStructure,\n  TableFieldNames,\n  ColumnSchema,\n} from './table-schema';\n\n/**\n * Parse a string ID to RecordId\n * - If it's in the format \"table:id\", use it as-is\n * - If it's just an ID without \":\", prepend the table name\n * @param value - The value to parse (could be a string ID)\n * @param tableName - The table name to use if the ID doesn't contain \":\"\n * @param fieldName - The field name to determine if this is an ID field\n */\nfunction parseStringToRecordId(value: unknown, tableName?: string, fieldName?: string): unknown {\n  if (typeof value !== 'string') return value;\n\n  // If it already contains \":\", parse it as a full record ID\n  if (value.includes(':')) {\n    const [table, ...idParts] = value.split(':');\n    const id = idParts.join(':'); // Handle IDs that contain colons\n    return new RecordId(table, id);\n  }\n\n  // If this is an \"id\" field and we have a table name, prepend it\n  if (fieldName === 'id' && tableName) {\n    return new RecordId(tableName, value);\n  }\n\n  // Otherwise, return as-is (it might not be an ID at all)\n  return value;\n}\n\n/**\n * Recursively parse string IDs to RecordId in an object\n * @param obj - The object to parse\n * @param tableName - The table name to use for ID fields without \":\"\n */\nfunction parseObjectIdsToRecordId(obj: unknown, tableName?: string): unknown {\n  if (obj === null || obj === undefined) return obj;\n\n  if (typeof obj === 'string') {\n    return parseStringToRecordId(obj, tableName);\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => parseObjectIdsToRecordId(item, tableName));\n  }\n\n  if (typeof obj === 'object' && obj.constructor === Object) {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      // Parse recursively, passing the field name to identify ID fields\n      result[key] =\n        typeof value === 'string'\n          ? parseStringToRecordId(value, tableName, key)\n          : parseObjectIdsToRecordId(value, tableName);\n    }\n    return result;\n  }\n\n  return obj;\n}\n\nexport type Executor<T extends { columns: Record<string, ColumnSchema> }, R = void> = (\n  query: InnerQuery<T, boolean>\n) => R;\n\nexport class InnerQuery<\n  T extends { columns: Record<string, ColumnSchema> },\n  IsOne extends boolean,\n  R = void,\n> {\n  private _hash: number;\n  private _mainQuery: QueryInfo;\n  private _selectQuery: QueryInfo;\n  private _selectLiveQuery: QueryInfo;\n  private _subqueries: InnerQuery<{ columns: Record<string, ColumnSchema> }, boolean>[];\n\n  constructor(\n    private readonly _tableName: string,\n    private readonly options: QueryOptions<TableModel<T>, IsOne>,\n    private readonly schema: SchemaStructure,\n    private readonly executor: Executor<any, R>\n  ) {\n    this._selectQuery = buildQueryFromOptions('SELECT', this._tableName, this.options, this.schema);\n\n    this._mainQuery = buildQueryFromOptions(\n      'SELECT',\n      this._tableName,\n      { ...this.options, related: [] },\n      this.schema\n    );\n\n    this._hash = this._selectQuery.hash;\n\n    this._selectLiveQuery = buildQueryFromOptions(\n      'LIVE SELECT',\n      this._tableName,\n      this.options,\n      this.schema\n    );\n\n    this._subqueries = extractSubqueryQueryInfos(\n      schema,\n      this._tableName,\n      this.options,\n      this.executor\n    );\n  }\n\n  get mainQuery(): QueryInfo {\n    return this._mainQuery;\n  }\n\n  get subqueries(): InnerQuery<{ columns: Record<string, ColumnSchema> }, boolean>[] {\n    return this._subqueries;\n  }\n\n  get selectQuery(): QueryInfo {\n    return this._selectQuery;\n  }\n\n  get selectLiveQuery(): QueryInfo {\n    return this._selectLiveQuery;\n  }\n\n  get tableName(): string {\n    return this._tableName;\n  }\n\n  get hash(): number {\n    return this._hash;\n  }\n\n  get isOne(): boolean {\n    return this.options.isOne ?? false;\n  }\n\n  public run(): R {\n    return this.executor(this);\n  }\n\n  public buildUpdateQuery(patches: any[]): QueryInfo {\n    return buildQueryFromOptions('UPDATE', this._tableName, this.options, this.schema, patches);\n  }\n\n  public buildDeleteQuery(): QueryInfo {\n    return buildQueryFromOptions('DELETE', this._tableName, this.options, this.schema);\n  }\n\n  public getOptions(): QueryOptions<TableModel<T>, IsOne> {\n    return this.options;\n  }\n}\n\n/**\n * Helper type to get the model type for a related table\n */\ntype _GetRelatedModel<S extends SchemaStructure, RelatedTableName extends string> =\n  RelatedTableName extends TableNames<S> ? TableModel<GetTable<S, RelatedTableName>> : never;\n\n/**\n * Helper type to extract field names from RelatedFields\n */\nexport type ExtractFieldNames<RelatedFields extends RelatedFieldsMap> = keyof RelatedFields;\n\nexport type RelatedFieldMapEntry = {\n  to: string;\n  cardinality: 'one' | 'many';\n  relatedFields: RelatedFieldsMap;\n};\n\nexport type RelatedFieldsMap = Record<string, RelatedFieldMapEntry>;\n\n/**\n * Helper type to build the related fields object based on accumulated relationships\n */\nexport type BuildRelatedFields<\n  S extends SchemaStructure,\n  RelatedFields extends RelatedFieldsMap,\n> = {\n  [K in keyof RelatedFields]: QueryResult<\n    S,\n    RelatedFields[K]['to'],\n    RelatedFields[K]['relatedFields'],\n    RelatedFields[K]['cardinality'] extends 'one' ? true : false\n  >;\n};\n\nexport type BuildResultModelOne<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap,\n> = Omit<TableModel<GetTable<S, TableName>>, ExtractFieldNames<RelatedFields>> &\n  BuildRelatedFields<S, RelatedFields>;\n\nexport type BuildResultModelMany<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap,\n> = (Omit<TableModel<GetTable<S, TableName>>, ExtractFieldNames<RelatedFields>> &\n  BuildRelatedFields<S, RelatedFields>)[];\n\n/**\n * The final result type combining base model with related fields\n * Excludes related field keys from the base model to avoid type conflicts\n */\nexport type QueryResult<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap,\n  IsOne extends boolean,\n> = IsOne extends true\n  ? BuildResultModelOne<S, TableName, RelatedFields>\n  : BuildResultModelMany<S, TableName, RelatedFields>;\n\nexport class FinalQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  // oxlint-disable-next-line no-unused-vars -- RelatedFields is used externally for type inference\n  RelatedFields extends RelatedFieldsMap,\n  IsOne extends boolean,\n  R = void,\n> {\n  private _innerQuery: InnerQuery<T, IsOne, R>;\n\n  constructor(\n    private readonly tableName: TableName,\n    private readonly options: QueryOptions<TableModel<T>, IsOne>,\n    private readonly schema: S,\n    private readonly executor: Executor<T, R>\n  ) {\n    this._innerQuery = new InnerQuery<T, IsOne, R>(\n      this.tableName,\n      this.options,\n      this.schema,\n      this.executor\n    );\n  }\n\n  run(): R {\n    return this.executor(this._innerQuery);\n  }\n\n  buildUpdateQuery(patches: any[]): QueryInfo {\n    return this._innerQuery.buildUpdateQuery(patches);\n  }\n\n  buildDeleteQuery(): QueryInfo {\n    return this._innerQuery.buildDeleteQuery();\n  }\n\n  selectLive(): QueryInfo {\n    return this._innerQuery.selectLiveQuery;\n  }\n\n  get innerQuery(): InnerQuery<T, IsOne, R> {\n    return this._innerQuery;\n  }\n\n  get isOne(): boolean {\n    return this.options.isOne ?? false;\n  }\n\n  get hash(): number {\n    return this._innerQuery.hash;\n  }\n}\n\n/**\n * Schema-aware query modifier builder implementation\n * This version provides full type safety for nested relationships\n */\nclass SchemaAwareQueryModifierBuilderImpl<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  RelatedFields extends RelatedFieldsMap = {},\n> implements SchemaAwareQueryModifierBuilder<S, TableName, RelatedFields> {\n  private options: QueryOptions<TableModel<GetTable<S, TableName>>, boolean> = {};\n\n  constructor(\n    private readonly tableName: TableName,\n    private readonly schema: S\n  ) {}\n\n  where(conditions: WhereInput<TableModel<GetTable<S, TableName>>>): this {\n    this.options.where = { ...this.options.where, ...conditions };\n    return this;\n  }\n\n  select(...fields: ((keyof TableModel<GetTable<S, TableName>> & string) | '*')[]): this {\n    if (this.options.select) {\n      throw new Error('Select can only be called once per query');\n    }\n    this.options.select = fields;\n    return this;\n  }\n\n  limit(count: number): this {\n    this.options.limit = count;\n    return this;\n  }\n\n  offset(count: number): this {\n    this.options.offset = count;\n    return this;\n  }\n\n  orderBy(\n    field: keyof TableModel<GetTable<S, TableName>> & string,\n    direction: 'asc' | 'desc' = 'asc'\n  ): this {\n    this.options.orderBy = {\n      ...this.options.orderBy,\n      [field]: direction,\n    } as Partial<Record<keyof TableModel<GetTable<S, TableName>>, 'asc' | 'desc'>>;\n    return this;\n  }\n\n  // Schema-aware implementation for nested relationships with full type inference\n  related<\n    Field extends TableRelationships<S, TableName>['field'],\n    Rel extends GetRelationship<S, TableName, Field>,\n    RelatedFields2 extends RelatedFieldsMap = {},\n  >(\n    relatedField: Field,\n    modifier?: SchemaAwareQueryModifier<S, Rel['to'], RelatedFields2>\n  ): SchemaAwareQueryModifierBuilderImpl<\n    S,\n    TableName,\n    RelatedFields & {\n      [K in Field]: {\n        to: Rel['to'];\n        cardinality: Rel['cardinality'];\n        relatedFields: RelatedFields2;\n      };\n    }\n  > {\n    if (!this.options.related) {\n      this.options.related = [];\n    }\n\n    const exists = this.options.related.some((r) => (r.alias || r.relatedTable) === relatedField);\n\n    if (!exists) {\n      // Look up the relationship from schema\n      const relationship = this.schema.relationships.find(\n        (r) => r.from === this.tableName && r.field === relatedField\n      );\n\n      if (!relationship) {\n        throw new Error(\n          `Relationship '${String(relatedField)}' not found for table '${this.tableName}'`\n        );\n      }\n\n      const relatedTable = relationship.to;\n      const cardinality = relationship.cardinality;\n      const foreignKeyField = cardinality === 'many' ? this.tableName : relatedField;\n\n      this.options.related.push({\n        relatedTable,\n        alias: relatedField as string,\n        modifier: modifier as QueryModifier<GenericModel>,\n        cardinality,\n        foreignKeyField: foreignKeyField as string,\n      } as RelatedQuery & { foreignKeyField: string });\n    }\n    return this as any;\n  }\n\n  _getOptions(): QueryOptions<TableModel<GetTable<S, TableName>>, boolean> {\n    return this.options;\n  }\n}\n\n/**\n * Fluent query builder for constructing queries with chainable methods\n * Now with full type inference from schema constant AND related field accumulation!\n */\nexport class QueryBuilder<\n  const S extends SchemaStructure,\n  const TableName extends TableNames<S>,\n  const R = void,\n  const RelatedFields extends RelatedFieldsMap = {},\n  const IsOne extends boolean = false,\n> {\n  constructor(\n    private readonly schema: S,\n    private readonly tableName: TableName,\n    private readonly executer: Executor<GetTable<S, TableName>, R> = () => undefined as R,\n    private options: QueryOptions<TableModel<GetTable<S, TableName>>, IsOne> = {}\n  ) {}\n\n  /**\n   * Add additional where conditions\n   */\n  where(\n    conditions: WhereInput<TableModel<GetTable<S, TableName>>>\n  ): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.where = { ...this.options.where, ...conditions };\n    return this;\n  }\n\n  /**\n   * Specify fields to select\n   */\n  select(\n    ...fields: ((keyof TableModel<GetTable<S, TableName>> & string) | '*')[]\n  ): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    if (this.options.select) {\n      throw new Error('Select can only be called once per query');\n    }\n    this.options.select = fields;\n    return this;\n  }\n\n  /**\n   * Add ordering to the query (only for non-live queries)\n   */\n  orderBy(\n    field: TableFieldNames<GetTable<S, TableName>>,\n    direction: 'asc' | 'desc' = 'asc'\n  ): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.orderBy = {\n      ...this.options.orderBy,\n      [field]: direction,\n    } as Partial<Record<keyof TableModel<GetTable<S, TableName>>, 'asc' | 'desc'>>;\n    return this;\n  }\n\n  /**\n   * Add limit to the query (only for non-live queries)\n   */\n  limit(count: number): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.limit = count;\n    return this;\n  }\n\n  /**\n   * Add offset to the query (only for non-live queries)\n   */\n  offset(count: number): QueryBuilder<S, TableName, R, RelatedFields, IsOne> {\n    this.options.offset = count;\n    return this;\n  }\n\n  one(): QueryBuilder<S, TableName, R, RelatedFields, true> {\n    return new QueryBuilder<S, TableName, R, RelatedFields, true>(\n      this.schema,\n      this.tableName,\n      this.executer,\n      { ...this.options, isOne: true }\n    );\n  }\n\n  /**\n   * Include related data via subqueries\n   * Field and cardinality are validated against schema relationships\n   * Now accumulates the related field in the type!\n   */\n  related<\n    Field extends TableRelationships<S, TableName>['field'],\n    Rel extends GetRelationship<S, TableName, Field>,\n    RelatedFields2 extends RelatedFieldsMap = {},\n  >(\n    field: Field,\n    modifierOrCardinality?:\n      | SchemaAwareQueryModifier<S, Rel['to'], RelatedFields2>\n      | Rel['cardinality'],\n    modifier?: SchemaAwareQueryModifier<S, Rel['to'], RelatedFields2>\n  ): QueryBuilder<\n    S,\n    TableName,\n    R,\n    RelatedFields & {\n      [K in Field]: {\n        to: Rel['to'];\n        cardinality: Rel['cardinality'];\n        relatedFields: RelatedFields2;\n      };\n    },\n    IsOne\n  > {\n    if (!this.options.related) {\n      this.options.related = [];\n    }\n\n    // Check if field already exists\n    const exists = this.options.related.some((r) => (r.alias || r.relatedTable) === field);\n\n    if (exists) {\n      return this as any;\n    }\n\n    // Look up relationship metadata from schema\n    const relationship = this.schema.relationships.find(\n      (r) => r.from === this.tableName && r.field === field\n    );\n\n    if (!relationship) {\n      throw new Error(`Relationship '${String(field)}' not found for table '${this.tableName}'`);\n    }\n\n    // Determine cardinality and modifier based on arguments\n    let actualCardinality: 'one' | 'many';\n    let actualModifier: SchemaAwareQueryModifier<S, Rel['to']> | undefined;\n\n    if (typeof modifierOrCardinality === 'function') {\n      // Signature: related(field, modifier)\n      actualCardinality = relationship.cardinality;\n      actualModifier = modifierOrCardinality;\n    } else if (modifierOrCardinality === 'one' || modifierOrCardinality === 'many') {\n      // Signature: related(field, cardinality, modifier)\n      actualCardinality = modifierOrCardinality;\n      actualModifier = modifier;\n    } else {\n      // Signature: related(field)\n      actualCardinality = relationship.cardinality;\n      actualModifier = undefined;\n    }\n\n    // Determine foreign key field based on cardinality\n    let foreignKeyField: string =\n      actualCardinality === 'many' ? (this.tableName as string) : (field as string);\n\n    if (actualCardinality === 'many') {\n      // For one-to-many, we need to find the field on the child table that points back to the parent\n      // We look for a relationship from Child -> Parent\n      const reverseRelationships = this.schema.relationships.filter(\n        (r) => r.from === relationship.to && r.to === this.tableName && r.cardinality === 'one'\n      );\n\n      if (reverseRelationships.length > 0) {\n        // Prioritize field that matches parent table name\n        const exactMatch = reverseRelationships.find((r) => r.field === this.tableName);\n        if (exactMatch) {\n          foreignKeyField = exactMatch.field;\n        } else {\n          foreignKeyField = reverseRelationships[0].field;\n        }\n      } else {\n        // Fallback heuristics\n        if (this.tableName.startsWith(`${relationship.to}_`)) {\n          // If parent table is \"game_database\" and child is \"game\", try \"database\"\n          foreignKeyField = this.tableName.slice(relationship.to.length + 1);\n        }\n      }\n    }\n\n    // Cast the schema-aware modifier to the runtime type\n    // At runtime, QueryModifierBuilderImpl will work correctly with the schema\n    const wrappedModifier = actualModifier as QueryModifier<GenericModel> | undefined;\n\n    this.options.related.push({\n      relatedTable: relationship.to,\n      alias: field as string,\n      modifier: wrappedModifier,\n      cardinality: actualCardinality,\n      foreignKeyField: foreignKeyField as any,\n    } as RelatedQuery & { foreignKeyField: string });\n\n    return this as any;\n  }\n\n  /**\n   * Get the current query options\n   */\n  getOptions(): QueryOptions<TableModel<GetTable<S, TableName>>, IsOne> {\n    return this.options;\n  }\n\n  /**\n   * Build query methods for SELECT and LIVE SELECT (custom implementation)\n   * @returns FinalQuery object with select() method for custom usage\n   */\n  build(): FinalQuery<S, TableName, GetTable<S, TableName>, RelatedFields, IsOne, R> {\n    return new FinalQuery<S, TableName, GetTable<S, TableName>, RelatedFields, IsOne, R>(\n      this.tableName,\n      this.options,\n      this.schema,\n      this.executer\n    );\n  }\n}\n\nexport function cyrb53(str: string, seed: number = 0): number {\n  let h1 = 0xdeadbeef ^ seed,\n    h2 = 0x41c6ce57 ^ seed;\n  for (let i = 0, ch; i < str.length; i++) {\n    ch = str.charCodeAt(i);\n    h1 = Math.imul(h1 ^ ch, 2654435761);\n    h2 = Math.imul(h2 ^ ch, 1597334677);\n  }\n  h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507);\n  h1 ^= Math.imul(h2 ^ (h2 >>> 13), 3266489909);\n  h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507);\n  h2 ^= Math.imul(h1 ^ (h1 >>> 13), 3266489909);\n\n  return 4294967296 * (2097151 & h2) + (h1 >>> 0);\n}\n\nexport function extractSubqueryQueryInfos<S extends SchemaStructure>(\n  schema: S,\n  parentTableName: string,\n  options: QueryOptions<GenericModel, boolean>,\n  executer: Executor<{ columns: Record<string, ColumnSchema> }>\n): InnerQuery<{ columns: Record<string, ColumnSchema> }, boolean>[] {\n  if (!options.related) {\n    return [];\n  }\n\n  return options.related.map((rel) => {\n    // Get base options from modifier\n    const subOptions =\n      rel\n        .modifier?.(new SchemaAwareQueryModifierBuilderImpl(rel.relatedTable, schema))\n        ._getOptions() ?? {};\n\n    // Find relationship to determine how to filter\n    const relationship = schema.relationships.find(\n      (r) => r.from === parentTableName && r.field === rel.alias\n    );\n\n    if (relationship) {\n      // Determine foreign key field\n      // rel.alias is guaranteed to be defined if relationship is found (matched r.field)\n      // oxlint-disable-next-line no-non-null-assertion -- alias is guaranteed defined when relationship is found\n      let foreignKeyField = rel.alias!;\n\n      if (relationship.cardinality === 'many') {\n        // For one-to-many, we need to find the field on the child table that points back to the parent\n        // We look for a relationship from Child -> Parent\n        const reverseRelationships = schema.relationships.filter(\n          (r) => r.from === rel.relatedTable && r.to === parentTableName && r.cardinality === 'one'\n        );\n\n        if (reverseRelationships.length > 0) {\n          // Prioritize field that matches parent table name\n          const exactMatch = reverseRelationships.find((r) => r.field === parentTableName);\n          if (exactMatch) {\n            foreignKeyField = exactMatch.field;\n          } else {\n            foreignKeyField = reverseRelationships[0].field;\n          }\n        } else {\n          // Fallback heuristics\n          if (parentTableName.startsWith(`${rel.relatedTable}_`)) {\n            // If parent table is \"game_database\" and child is \"game\", try \"database\"\n            foreignKeyField = parentTableName.slice(rel.relatedTable.length + 1);\n          } else {\n            // Default to parent table name\n            foreignKeyField = parentTableName;\n          }\n        }\n      }\n\n      // Add parent filter to where clause\n      subOptions.where = subOptions.where || {};\n\n      if (relationship.cardinality === 'many') {\n        // One-to-Many: Child has foreign key to parent\n        // WHERE $parentIds ∋ child.parent_id\n        (subOptions.where as any)[foreignKeyField] = { _op: '∋', _val: '$parentIds', _swap: true };\n      } else {\n        // One-to-One: Parent has foreign key to child\n        // WHERE $parent_<foreignKeyField> ∋ child.id\n        // We use a dynamic variable name derived from the foreign key field on the parent\n        (subOptions.where as any).id = {\n          _op: '∋',\n          _val: `$parent_${foreignKeyField}`,\n          _swap: true,\n        };\n      }\n    }\n\n    return new InnerQuery(rel.relatedTable, subOptions, schema, executer);\n  });\n}\n\n/**\n * Build a query string from query options\n * @param method - The query method (SELECT or LIVE SELECT)\n * @param tableName - The table name to query\n * @param options - The query options (where, select, orderBy, etc.)\n * @param schema - Optional schema for resolving nested relationships\n * @returns QueryInfo with the generated SQL and variables\n */\nexport function buildQueryFromOptions<TModel extends GenericModel, IsOne extends boolean>(\n  method: 'SELECT' | 'LIVE SELECT' | 'LIVE SELECT DIFF' | 'UPDATE' | 'DELETE',\n  tableName: string,\n  options: QueryOptions<TModel, IsOne>,\n  schema: SchemaStructure,\n  patches?: any[]\n): QueryInfo {\n  if (options.isOne) {\n    options.limit = 1;\n  }\n  const isLiveQuery = method === 'LIVE SELECT' || method === 'LIVE SELECT DIFF';\n\n  // Parse where conditions to convert string IDs to RecordId\n  const parsedWhere = options.where\n    ? parseObjectIdsToRecordId(options.where, tableName)\n    : undefined;\n\n  // Build SELECT clause\n  let selectClause = '*';\n\n  if (method === 'LIVE SELECT DIFF') {\n    selectClause = '';\n  } else {\n    if (options.select && options.select.length > 0) {\n      selectClause = options.select.join(', ');\n    }\n  }\n\n  // Build related subqueries (fetch clauses)\n  let fetchClauses = '';\n  if (!isLiveQuery && options.related && options.related.length > 0) {\n    const subqueries = options.related.map((rel) => buildSubquery(rel, schema));\n    fetchClauses = ', ' + subqueries.join(', ');\n  }\n\n  // Start building the query\n  let query = '';\n\n  if (method === 'UPDATE') {\n    query = `UPDATE ${tableName}`;\n  } else if (method === 'DELETE') {\n    query = `DELETE FROM ${tableName}`;\n  } else {\n    query = `${method}${selectClause ? ` ${selectClause}` : ''}${fetchClauses} FROM ${tableName}`;\n  }\n\n  // Build WHERE clause\n  const vars: Record<string, unknown> = {};\n  if (parsedWhere && Object.keys(parsedWhere).length > 0) {\n    const conditions: string[] = [];\n\n    // Build a single condition for `field`, binding its value under `varName`.\n    // Supports operator objects `{ _op, _val, _swap }` (e.g. `{ _op: '<=', _val:\n    // 5 }`); a `$`-prefixed string `_val` references an existing param verbatim.\n    // Plain values mean equality (`field = $varName`).\n    const buildCondition = (field: string, value: unknown, varName: string): string => {\n      if (value && typeof value === 'object' && '_op' in value && '_val' in value) {\n        const { _op, _val, _swap } = value as { _op: string; _val: unknown; _swap?: boolean };\n        let rightSide: string;\n        if (typeof _val === 'string' && _val.startsWith('$')) {\n          rightSide = _val;\n        } else {\n          vars[varName] = _val;\n          rightSide = `$${varName}`;\n        }\n        return _swap ? `${rightSide} ${_op} ${field}` : `${field} ${_op} ${rightSide}`;\n      }\n      vars[varName] = value;\n      return `${field} = $${varName}`;\n    };\n\n    for (const [key, value] of Object.entries(parsedWhere)) {\n      // OR-group: `{ _or: [ {field: val}, {field: {_op,_val}}, ... ] }` compiles\n      // to one parenthesised `(c1 OR c2 ...)` conjunct. Each branch condition gets\n      // a unique, position-indexed param name (`or0`, `or1`, …) so it never\n      // collides with a top-level condition on the same field (e.g. a `white =\n      // $white` filter alongside an opponent `_or` on white/black) — keeping the\n      // surql + vars, and thus the query hash, stable and deterministic.\n      if (key === '_or' && Array.isArray(value)) {\n        const orParts: string[] = [];\n        let i = 0;\n        for (const branch of value) {\n          if (branch && typeof branch === 'object') {\n            for (const [bField, bVal] of Object.entries(branch as Record<string, unknown>)) {\n              orParts.push(buildCondition(bField, bVal, `or${i++}`));\n            }\n          }\n        }\n        if (orParts.length > 0) conditions.push(`(${orParts.join(' OR ')})`);\n        continue;\n      }\n\n      conditions.push(buildCondition(key, value, key));\n    }\n\n    if (conditions.length > 0) query += ` WHERE ${conditions.join(' AND ')}`;\n  }\n\n  // Add PATCH for UPDATE\n  if (method === 'UPDATE' && patches) {\n    query += ` PATCH ${JSON.stringify(patches)}`;\n  }\n\n  // Add ORDER BY, LIMIT, START only for non-live queries and non-update/delete queries (unless supported)\n  // SurrealDB UPDATE/DELETE supports WHERE, but LIMIT/START/ORDER BY might be restricted or behave differently.\n  // For now, let's allow them if they are set, as SurrealDB supports them for DELETE/UPDATE.\n  if (!isLiveQuery) {\n    if (options.orderBy && Object.keys(options.orderBy).length > 0) {\n      const orderClauses = Object.entries(options.orderBy).map(\n        ([field, direction]) => `${field} ${direction}`\n      );\n      query += ` ORDER BY ${orderClauses.join(', ')}`;\n    }\n\n    if (options.limit !== undefined) {\n      query += ` LIMIT ${options.limit}`;\n    }\n\n    if (options.offset !== undefined) {\n      query += ` START ${options.offset}`;\n    }\n  }\n\n  query += ';';\n\n  return {\n    query,\n    hash: cyrb53(\n      `${query}::${Object.entries(vars)\n        .map(([key, value]) => `${key}=${value}`)\n        .join('&')}`,\n      0\n    ),\n    vars: Object.keys(vars).length > 0 ? vars : undefined,\n    // Engine-neutral plan mirrors the SELECT above for non-SurrealQL backends.\n    // Only SELECT carries a plan; the isOne→limit=1 mutation above is already\n    // reflected in `options.limit`, so the plan sees it too.\n    plan: method === 'SELECT' ? buildQueryPlan(tableName, options, schema) : undefined,\n  };\n}\n\n/**\n * Build the engine-neutral {@link QueryPlan} for a SELECT. Mirrors the string\n * assembly in {@link buildQueryFromOptions} / {@link buildSubquery} exactly so a\n * non-SurrealQL backend produces results identical to the SurrealQL path.\n */\nfunction buildQueryPlan<TModel extends GenericModel, IsOne extends boolean>(\n  tableName: string,\n  options: QueryOptions<TModel, IsOne>,\n  schema: SchemaStructure\n): QueryPlan {\n  const plan: QueryPlan = { table: tableName };\n\n  if (options.select && options.select.length > 0 && !options.select.includes('*')) {\n    plan.select = options.select.filter((f) => f !== '*') as string[];\n  }\n\n  const parsedWhere = options.where\n    ? (parseObjectIdsToRecordId(options.where, tableName) as Record<string, unknown>)\n    : undefined;\n  if (parsedWhere && Object.keys(parsedWhere).length > 0) {\n    const nodes = buildWhereNodes(parsedWhere);\n    if (nodes.length > 0) plan.where = nodes;\n  }\n\n  if (options.orderBy && Object.keys(options.orderBy).length > 0) {\n    plan.orderBy = Object.entries(options.orderBy).map(\n      ([field, direction]) => [field, direction as 'asc' | 'desc']\n    );\n  }\n\n  if (options.limit !== undefined) plan.limit = options.limit;\n  if (options.offset !== undefined) plan.offset = options.offset;\n\n  if (options.related && options.related.length > 0) {\n    plan.relations = options.related.map((rel) => buildRelationPlan(rel, schema));\n  }\n\n  return plan;\n}\n\n/**\n * Engine-neutral counterpart of {@link buildSubquery}. Resolves the same\n * cardinality / foreign-key / nested-relation metadata but returns a structured\n * {@link RelationPlan} instead of a SurrealQL subquery string.\n */\nfunction buildRelationPlan(\n  rel: RelatedQuery & { foreignKeyField?: string },\n  schema: SchemaStructure\n): RelationPlan {\n  const { relatedTable, alias, modifier, cardinality } = rel;\n  // Same fallback chain as buildSubquery (`rel.foreignKeyField || alias`); the\n  // top-level foreignKeyField is already reverse-resolved by `.related()`.\n  const foreignKeyField = (rel.foreignKeyField || alias || relatedTable) as string;\n\n  const plan: RelationPlan = {\n    alias: (alias || relatedTable) as string,\n    table: relatedTable,\n    cardinality,\n    foreignKeyField,\n  };\n\n  if (modifier) {\n    const modifierBuilder = new SchemaAwareQueryModifierBuilderImpl(relatedTable, schema);\n    modifier(modifierBuilder as any);\n    const subOptions = modifierBuilder._getOptions();\n\n    if (subOptions.select && subOptions.select.length > 0 && !subOptions.select.includes('*')) {\n      plan.select = subOptions.select.filter((f) => f !== '*') as string[];\n    }\n\n    if (subOptions.where && Object.keys(subOptions.where).length > 0) {\n      const parsedSubWhere = parseObjectIdsToRecordId(subOptions.where, relatedTable) as Record<\n        string,\n        unknown\n      >;\n      const nodes = buildWhereNodes(parsedSubWhere);\n      if (nodes.length > 0) plan.where = nodes;\n    }\n\n    if (subOptions.orderBy && Object.keys(subOptions.orderBy).length > 0) {\n      plan.orderBy = Object.entries(subOptions.orderBy).map(\n        ([field, direction]) => [field, direction as 'asc' | 'desc']\n      );\n    }\n\n    if (subOptions.limit !== undefined) plan.limit = subOptions.limit;\n\n    // Nested relations: re-resolve exactly as buildSubquery does — the child's\n    // foreignKeyField comes from the relatedTable-based lookup, not the reverse\n    // heuristic used for top-level relations.\n    if (subOptions.related && subOptions.related.length > 0) {\n      const resolvedNestedRels = subOptions.related.map((nestedRel) => {\n        const relationship = schema.relationships.find(\n          (r) => r.from === relatedTable && r.field === nestedRel.alias\n        );\n        if (relationship) {\n          const nestedForeignKeyField =\n            relationship.cardinality === 'many' ? relatedTable : (nestedRel.alias as string);\n          return {\n            ...nestedRel,\n            relatedTable: relationship.to,\n            cardinality: relationship.cardinality,\n            foreignKeyField: nestedForeignKeyField,\n          } as RelatedQuery & { foreignKeyField: string };\n        }\n        return nestedRel;\n      });\n      plan.relations = resolvedNestedRels.map((nestedRel) => buildRelationPlan(nestedRel, schema));\n    }\n  }\n\n  // one-to-one gets an implicit per-parent LIMIT 1 (matches buildSubquery).\n  if (cardinality === 'one' && plan.limit === undefined) {\n    plan.limit = 1;\n  }\n\n  return plan;\n}\n\n/**\n * Convert a parsed WHERE object (string IDs already → RecordId) into the\n * engine-neutral {@link WhereNode}[] conjunction. Mirrors the `_or` / comparison\n * / equality handling in {@link buildQueryFromOptions}. A `$`-prefixed `_val`\n * becomes a `paramRef` (with the leading `$` stripped).\n */\nfunction buildWhereNodes(parsedWhere: Record<string, unknown>): WhereNode[] {\n  const toComparison = (field: string, value: unknown): WhereComparison => {\n    if (value && typeof value === 'object' && '_op' in value && '_val' in value) {\n      const { _op, _val, _swap } = value as ComparisonOp;\n      if (typeof _val === 'string' && _val.startsWith('$')) {\n        return { field, op: _op, value: undefined, paramRef: _val.slice(1), swap: _swap };\n      }\n      return { field, op: _op, value: _val, swap: _swap };\n    }\n    return { field, op: '=', value };\n  };\n\n  const nodes: WhereNode[] = [];\n  for (const [key, value] of Object.entries(parsedWhere)) {\n    if (key === '_or' && Array.isArray(value)) {\n      const or: WhereComparison[] = [];\n      for (const branch of value) {\n        if (branch && typeof branch === 'object') {\n          for (const [bField, bVal] of Object.entries(branch as Record<string, unknown>)) {\n            or.push(toComparison(bField, bVal));\n          }\n        }\n      }\n      if (or.length > 0) nodes.push({ or });\n      continue;\n    }\n    nodes.push(toComparison(key, value));\n  }\n  return nodes;\n}\n\n/**\n * Build a subquery for a related field\n */\nfunction buildSubquery(\n  rel: RelatedQuery & { foreignKeyField?: string },\n  schema: SchemaStructure\n): string {\n  const { relatedTable, alias, modifier, cardinality } = rel;\n  const foreignKeyField = rel.foreignKeyField || alias;\n\n  let subquerySelect = '*';\n  let subqueryWhere = '';\n  let subqueryOrderBy = '';\n  let subqueryLimit = '';\n\n  // If there's a modifier, apply it to get the sub-options\n  if (modifier) {\n    const modifierBuilder = new SchemaAwareQueryModifierBuilderImpl(relatedTable, schema);\n    modifier(modifierBuilder);\n    const subOptions = modifierBuilder._getOptions();\n\n    // Build sub-select\n    if (subOptions.select && subOptions.select.length > 0) {\n      subquerySelect = subOptions.select.join(', ');\n    }\n\n    // Build sub-where\n    if (subOptions.where && Object.keys(subOptions.where).length > 0) {\n      const parsedSubWhere = parseObjectIdsToRecordId(subOptions.where, relatedTable) as Record<\n        string,\n        unknown\n      >;\n      const conditions = Object.entries(parsedSubWhere).map(([key, value]) => {\n        if (value instanceof RecordId) {\n          return `${key} = ${value.toString()}`;\n        }\n        return `${key} = ${JSON.stringify(value)}`;\n      });\n      subqueryWhere = ` AND ${conditions.join(' AND ')}`;\n    }\n\n    // Build sub-orderBy\n    if (subOptions.orderBy && Object.keys(subOptions.orderBy).length > 0) {\n      const orderClauses = Object.entries(subOptions.orderBy).map(\n        ([field, direction]) => `${field} ${direction}`\n      );\n      subqueryOrderBy = ` ORDER BY ${orderClauses.join(', ')}`;\n    }\n\n    // Build sub-limit\n    if (subOptions.limit !== undefined) {\n      subqueryLimit = ` LIMIT ${subOptions.limit}`;\n    }\n\n    // Handle nested relationships\n    if (subOptions.related && subOptions.related.length > 0) {\n      // Resolve nested relationship metadata if schema is available\n      const resolvedNestedRels = subOptions.related.map((nestedRel) => {\n        if (schema) {\n          // Look up the actual relationship metadata from schema\n          const relationship = schema.relationships.find(\n            (r) => r.from === relatedTable && r.field === nestedRel.alias\n          );\n\n          if (relationship) {\n            // Use the resolved table name and add foreign key field\n            const nestedForeignKeyField =\n              relationship.cardinality === 'many' ? relatedTable : nestedRel.alias;\n\n            return {\n              ...nestedRel,\n              relatedTable: relationship.to,\n              cardinality: relationship.cardinality,\n              foreignKeyField: nestedForeignKeyField,\n            } as RelatedQuery & { foreignKeyField: string };\n          }\n        }\n        return nestedRel;\n      });\n\n      const nestedSubqueries = resolvedNestedRels.map((nestedRel) =>\n        buildSubquery(nestedRel, schema)\n      );\n      subquerySelect += ', ' + nestedSubqueries.join(', ');\n    }\n  }\n\n  // Determine the WHERE condition based on cardinality\n  let whereCondition: string;\n  if (cardinality === 'one') {\n    // For one-to-one, the related table's id matches parent's foreign key field\n    whereCondition = `WHERE id=$parent.${foreignKeyField}`;\n    // Add LIMIT 1 for one-to-one relationships if not already set\n    if (!subqueryLimit) {\n      subqueryLimit = ' LIMIT 1';\n    }\n  } else {\n    // For one-to-many, the related table has a foreign key field pointing to parent's id\n    whereCondition = `WHERE ${foreignKeyField}=$parent.id`;\n  }\n\n  // Build the complete subquery\n  let subquery = `(SELECT ${subquerySelect} FROM ${relatedTable} ${whereCondition}${subqueryWhere}${subqueryOrderBy}${subqueryLimit})`;\n\n  // For one-to-one relationships, select the first element\n  if (cardinality === 'one') {\n    subquery += '[0]';\n  }\n\n  subquery += ` AS ${alias}`;\n\n  return subquery;\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -354,24 +354,31 @@ function buildQueryFromOptions(method, tableName, options, schema, patches) {
 	const vars = {};
 	if (parsedWhere && Object.keys(parsedWhere).length > 0) {
 		const conditions = [];
-		for (const [key, value] of Object.entries(parsedWhere)) {
-			const varName = key;
+		const buildCondition = (field, value, varName) => {
 			if (value && typeof value === "object" && "_op" in value && "_val" in value) {
 				const { _op, _val, _swap } = value;
-				let rightSide = "";
+				let rightSide;
 				if (typeof _val === "string" && _val.startsWith("$")) rightSide = _val;
 				else {
 					vars[varName] = _val;
 					rightSide = `$${varName}`;
 				}
-				if (_swap) conditions.push(`${rightSide} ${_op} ${key}`);
-				else conditions.push(`${key} ${_op} ${rightSide}`);
-			} else {
-				vars[varName] = value;
-				conditions.push(`${key} = $${varName}`);
+				return _swap ? `${rightSide} ${_op} ${field}` : `${field} ${_op} ${rightSide}`;
+			}
+			vars[varName] = value;
+			return `${field} = $${varName}`;
+		};
+		for (const [key, value] of Object.entries(parsedWhere)) {
+			if (key === "_or" && Array.isArray(value)) {
+				const orParts = [];
+				let i = 0;
+				for (const branch of value) if (branch && typeof branch === "object") for (const [bField, bVal] of Object.entries(branch)) orParts.push(buildCondition(bField, bVal, `or${i++}`));
+				if (orParts.length > 0) conditions.push(`(${orParts.join(" OR ")})`);
+				continue;
 			}
+			conditions.push(buildCondition(key, value, key));
 		}
-		query += ` WHERE ${conditions.join(" AND ")}`;
+		if (conditions.length > 0) query += ` WHERE ${conditions.join(" AND ")}`;
 	}
 	if (method === "UPDATE" && patches) query += ` PATCH ${JSON.stringify(patches)}`;
 	if (!isLiveQuery) {
@@ -386,8 +393,112 @@ function buildQueryFromOptions(method, tableName, options, schema, patches) {
 	return {
 		query,
 		hash: cyrb53(`${query}::${Object.entries(vars).map(([key, value]) => `${key}=${value}`).join("&")}`, 0),
-		vars: Object.keys(vars).length > 0 ? vars : void 0
+		vars: Object.keys(vars).length > 0 ? vars : void 0,
+		plan: method === "SELECT" ? buildQueryPlan(tableName, options, schema) : void 0
+	};
+}
+/**
+* Build the engine-neutral {@link QueryPlan} for a SELECT. Mirrors the string
+* assembly in {@link buildQueryFromOptions} / {@link buildSubquery} exactly so a
+* non-SurrealQL backend produces results identical to the SurrealQL path.
+*/
+function buildQueryPlan(tableName, options, schema) {
+	const plan = { table: tableName };
+	if (options.select && options.select.length > 0 && !options.select.includes("*")) plan.select = options.select.filter((f) => f !== "*");
+	const parsedWhere = options.where ? parseObjectIdsToRecordId(options.where, tableName) : void 0;
+	if (parsedWhere && Object.keys(parsedWhere).length > 0) {
+		const nodes = buildWhereNodes(parsedWhere);
+		if (nodes.length > 0) plan.where = nodes;
+	}
+	if (options.orderBy && Object.keys(options.orderBy).length > 0) plan.orderBy = Object.entries(options.orderBy).map(([field, direction]) => [field, direction]);
+	if (options.limit !== void 0) plan.limit = options.limit;
+	if (options.offset !== void 0) plan.offset = options.offset;
+	if (options.related && options.related.length > 0) plan.relations = options.related.map((rel) => buildRelationPlan(rel, schema));
+	return plan;
+}
+/**
+* Engine-neutral counterpart of {@link buildSubquery}. Resolves the same
+* cardinality / foreign-key / nested-relation metadata but returns a structured
+* {@link RelationPlan} instead of a SurrealQL subquery string.
+*/
+function buildRelationPlan(rel, schema) {
+	const { relatedTable, alias, modifier, cardinality } = rel;
+	const foreignKeyField = rel.foreignKeyField || alias || relatedTable;
+	const plan = {
+		alias: alias || relatedTable,
+		table: relatedTable,
+		cardinality,
+		foreignKeyField
+	};
+	if (modifier) {
+		const modifierBuilder = new SchemaAwareQueryModifierBuilderImpl(relatedTable, schema);
+		modifier(modifierBuilder);
+		const subOptions = modifierBuilder._getOptions();
+		if (subOptions.select && subOptions.select.length > 0 && !subOptions.select.includes("*")) plan.select = subOptions.select.filter((f) => f !== "*");
+		if (subOptions.where && Object.keys(subOptions.where).length > 0) {
+			const nodes = buildWhereNodes(parseObjectIdsToRecordId(subOptions.where, relatedTable));
+			if (nodes.length > 0) plan.where = nodes;
+		}
+		if (subOptions.orderBy && Object.keys(subOptions.orderBy).length > 0) plan.orderBy = Object.entries(subOptions.orderBy).map(([field, direction]) => [field, direction]);
+		if (subOptions.limit !== void 0) plan.limit = subOptions.limit;
+		if (subOptions.related && subOptions.related.length > 0) plan.relations = subOptions.related.map((nestedRel) => {
+			const relationship = schema.relationships.find((r) => r.from === relatedTable && r.field === nestedRel.alias);
+			if (relationship) {
+				const nestedForeignKeyField = relationship.cardinality === "many" ? relatedTable : nestedRel.alias;
+				return {
+					...nestedRel,
+					relatedTable: relationship.to,
+					cardinality: relationship.cardinality,
+					foreignKeyField: nestedForeignKeyField
+				};
+			}
+			return nestedRel;
+		}).map((nestedRel) => buildRelationPlan(nestedRel, schema));
+	}
+	if (cardinality === "one" && plan.limit === void 0) plan.limit = 1;
+	return plan;
+}
+/**
+* Convert a parsed WHERE object (string IDs already → RecordId) into the
+* engine-neutral {@link WhereNode}[] conjunction. Mirrors the `_or` / comparison
+* / equality handling in {@link buildQueryFromOptions}. A `$`-prefixed `_val`
+* becomes a `paramRef` (with the leading `$` stripped).
+*/
+function buildWhereNodes(parsedWhere) {
+	const toComparison = (field, value) => {
+		if (value && typeof value === "object" && "_op" in value && "_val" in value) {
+			const { _op, _val, _swap } = value;
+			if (typeof _val === "string" && _val.startsWith("$")) return {
+				field,
+				op: _op,
+				value: void 0,
+				paramRef: _val.slice(1),
+				swap: _swap
+			};
+			return {
+				field,
+				op: _op,
+				value: _val,
+				swap: _swap
+			};
+		}
+		return {
+			field,
+			op: "=",
+			value
+		};
 	};
+	const nodes = [];
+	for (const [key, value] of Object.entries(parsedWhere)) {
+		if (key === "_or" && Array.isArray(value)) {
+			const or = [];
+			for (const branch of value) if (branch && typeof branch === "object") for (const [bField, bVal] of Object.entries(branch)) or.push(toComparison(bField, bVal));
+			if (or.length > 0) nodes.push({ or });
+			continue;
+		}
+		nodes.push(toComparison(key, value));
+	}
+	return nodes;
 }
 /**
 * Build a subquery for a related field