@spooky-sync/query-builder 0.0.1-canary.21 → 0.0.1-canary.210

package/dist/index.mjs

@@ -2,6 +2,36 @@ import { RecordId, RecordId as RecordId$1 } from "surrealdb";
 
 //#region src/query-builder.ts
 /**
+* Reject a query clause that references an `-- @opaque` column.
+*
+* An `@opaque` value is synced down to the client but never held server-side, so
+* the SSP has nothing to evaluate a predicate against. Left unchecked, the
+* failure is silent and asymmetric: the local cache DOES hold the value, so the
+* clause filters correctly on screen while the server-side membership set it is
+* compared against was computed without it. The result reads as rows randomly
+* appearing and vanishing rather than as an error, so fail loudly at the call
+* site instead.
+*
+* `clause` names the offending API ('where', 'orderBy', …) for the message.
+*/
+function assertNotOpaque(schema, tableName, clause, fields) {
+	const table = schema.tables.find((t) => t.name === tableName);
+	if (!table) return;
+	for (const field of fields) if ((table.columns[field] ?? table.columns[field.split(".")[0]])?.opaque) throw new Error(`Cannot use '${field}' in ${clause}(): it is marked '-- @opaque' on ${tableName}, so the sync engine never stores its value and cannot evaluate it. Read the field from query results instead, or remove '-- @opaque' from the schema if you need to query on it.`);
+}
+/** Every column name a `where` clause touches, including `_or` branches. */
+function whereFieldNames(conditions) {
+	const out = [];
+	for (const [key, value] of Object.entries(conditions)) {
+		if (key === "_or") {
+			for (const branch of value ?? []) out.push(...whereFieldNames(branch ?? {}));
+			continue;
+		}
+		out.push(key);
+	}
+	return out;
+}
+/**
 * Parse a string ID to RecordId
 * - If it's in the format "table:id", use it as-is
 * - If it's just an ID without ":", prepend the table name
@@ -124,6 +154,7 @@ var SchemaAwareQueryModifierBuilderImpl = class {
 		this.options = {};
 	}
 	where(conditions) {
+		assertNotOpaque(this.schema, this.tableName, "where", whereFieldNames(conditions));
 		this.options.where = {
 			...this.options.where,
 			...conditions
@@ -144,6 +175,7 @@ var SchemaAwareQueryModifierBuilderImpl = class {
 		return this;
 	}
 	orderBy(field, direction = "asc") {
+		assertNotOpaque(this.schema, this.tableName, "orderBy", [field]);
 		this.options.orderBy = {
 			...this.options.orderBy,
 			[field]: direction
@@ -154,7 +186,10 @@ var SchemaAwareQueryModifierBuilderImpl = class {
 		if (!this.options.related) this.options.related = [];
 		if (!this.options.related.some((r) => (r.alias || r.relatedTable) === relatedField)) {
 			const relationship = this.schema.relationships.find((r) => r.from === this.tableName && r.field === relatedField);
-			if (!relationship) throw new Error(`Relationship '${String(relatedField)}' not found for table '${this.tableName}'`);
+			if (!relationship) {
+				if (typeof console !== "undefined") console.warn(`[sp00ky] .related('${String(relatedField)}') skipped — no such relationship on '${this.tableName}' in the client schema`);
+				return this;
+			}
 			const relatedTable = relationship.to;
 			const cardinality = relationship.cardinality;
 			const foreignKeyField = cardinality === "many" ? this.tableName : relatedField;
@@ -187,6 +222,7 @@ var QueryBuilder = class QueryBuilder {
 	* Add additional where conditions
 	*/
 	where(conditions) {
+		assertNotOpaque(this.schema, this.tableName, "where", whereFieldNames(conditions));
 		this.options.where = {
 			...this.options.where,
 			...conditions
@@ -205,6 +241,7 @@ var QueryBuilder = class QueryBuilder {
 	* Add ordering to the query (only for non-live queries)
 	*/
 	orderBy(field, direction = "asc") {
+		assertNotOpaque(this.schema, this.tableName, "orderBy", [field]);
 		this.options.orderBy = {
 			...this.options.orderBy,
 			[field]: direction
@@ -240,7 +277,10 @@ var QueryBuilder = class QueryBuilder {
 		if (!this.options.related) this.options.related = [];
 		if (this.options.related.some((r) => (r.alias || r.relatedTable) === field)) return this;
 		const relationship = this.schema.relationships.find((r) => r.from === this.tableName && r.field === field);
-		if (!relationship) throw new Error(`Relationship '${String(field)}' not found for table '${this.tableName}'`);
+		if (!relationship) {
+			if (typeof console !== "undefined") console.warn(`[sp00ky] .related('${String(field)}') skipped — no such relationship on '${this.tableName}' in the client schema`);
+			return this;
+		}
 		let actualCardinality;
 		let actualModifier;
 		if (typeof modifierOrCardinality === "function") {
@@ -286,6 +326,26 @@ var QueryBuilder = class QueryBuilder {
 		return new FinalQuery(this.tableName, this.options, this.schema, this.executer);
 	}
 };
+/**
+* The surql param name an `_or` branch condition binds under: the branch FIELD,
+* a `__or` marker and the branch's position. The position alone makes it unique
+* within the query; the field prefix is what lets a consumer type the value by
+* looking the column up (see {@link baseFieldOfParam}). Non-identifier
+* characters (a nested path like `database.owner`) are folded to `_` so the
+* result is a legal param name.
+*/
+function orParamName(field, index) {
+	return `${field.replace(/[^A-Za-z0-9_]/g, "_")}__or${index}`;
+}
+/**
+* Inverse of {@link orParamName}: the field a param name was built from, or the
+* name itself when it is a plain top-level param (`field = $field`). Lets a
+* consumer resolve `white__or0` back to the `white` column.
+*/
+function baseFieldOfParam(name) {
+	const m = /^(.+)__or\d+$/.exec(name);
+	return m ? m[1] : name;
+}
 function cyrb53(str, seed = 0) {
 	let h1 = 3735928559 ^ seed, h2 = 1103547991 ^ seed;
 	for (let i = 0, ch; i < str.length; i++) {
@@ -354,24 +414,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, orParamName(bField, 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 +453,135 @@ 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, true);
+		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).
+*/
+/**
+* @param slaveToParams When true, top-level plain/operator-literal comparisons
+*   ALSO carry a `paramRef` equal to the field name — the same var name
+*   `buildQueryFromOptions` binds the value under (`field = $field`). The
+*   engines then materialize by reading `params[field]` (falling back to the
+*   baked `value` when the param is absent), so a query's rows are slaved to
+*   its `params` (its identity) and can never come from a different query's
+*   baked plan. Only safe at the TOP LEVEL, where the field is a schema column
+*   that survives `parseQueryParams` and the caller passes `params`. NOT used
+*   for relation sub-wheres (rendered with a params-less ctx) or `_or` branches
+*   (bound under synthetic `white__or0` names) - those stay baked.
+*/
+function buildWhereNodes(parsedWhere, slaveToParams = false) {
+	const toComparison = (field, value, slave) => {
+		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 slave ? {
+				field,
+				op: _op,
+				value: _val,
+				paramRef: field,
+				swap: _swap
+			} : {
+				field,
+				op: _op,
+				value: _val,
+				swap: _swap
+			};
+		}
+		return slave ? {
+			field,
+			op: "=",
+			value,
+			paramRef: field
+		} : {
+			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, false));
+			if (or.length > 0) nodes.push({ or });
+			continue;
+		}
+		nodes.push(toComparison(key, value, slaveToParams));
+	}
+	return nodes;
 }
 /**
 * Build a subquery for a related field
@@ -444,5 +638,5 @@ function buildSubquery(rel, schema) {
 }
 
 //#endregion
-export { FinalQuery, InnerQuery, QueryBuilder, RecordId, buildQueryFromOptions, cyrb53 };
+export { FinalQuery, InnerQuery, QueryBuilder, RecordId, baseFieldOfParam, buildQueryFromOptions, cyrb53, orParamName };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","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.mjs","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 * Reject a query clause that references an `-- @opaque` column.\n *\n * An `@opaque` value is synced down to the client but never held server-side, so\n * the SSP has nothing to evaluate a predicate against. Left unchecked, the\n * failure is silent and asymmetric: the local cache DOES hold the value, so the\n * clause filters correctly on screen while the server-side membership set it is\n * compared against was computed without it. The result reads as rows randomly\n * appearing and vanishing rather than as an error, so fail loudly at the call\n * site instead.\n *\n * `clause` names the offending API ('where', 'orderBy', …) for the message.\n */\nfunction assertNotOpaque(\n  schema: SchemaStructure,\n  tableName: string,\n  clause: string,\n  fields: readonly string[]\n): void {\n  const table = schema.tables.find((t) => t.name === tableName);\n  if (!table) return;\n  for (const field of fields) {\n    // A nested path (`meta.secret`) is checked against its root, since the column\n    // flag lives on `meta`. Comparison operators use `{ field: { _op, _val } }`\n    // rather than a name suffix, so the key is always the bare column name.\n    const column: ColumnSchema | undefined =\n      table.columns[field] ?? table.columns[field.split('.')[0]];\n    if (column?.opaque) {\n      throw new Error(\n        `Cannot use '${field}' in ${clause}(): it is marked '-- @opaque' on ` +\n          `${tableName}, so the sync engine never stores its value and cannot ` +\n          `evaluate it. Read the field from query results instead, or remove ` +\n          `'-- @opaque' from the schema if you need to query on it.`\n      );\n    }\n  }\n}\n\n/** Every column name a `where` clause touches, including `_or` branches. */\nfunction whereFieldNames(conditions: Record<string, unknown>): string[] {\n  const out: string[] = [];\n  for (const [key, value] of Object.entries(conditions)) {\n    if (key === '_or') {\n      for (const branch of (value ?? []) as Record<string, unknown>[]) {\n        out.push(...whereFieldNames(branch ?? {}));\n      }\n      continue;\n    }\n    out.push(key);\n  }\n  return out;\n}\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    assertNotOpaque(\n      this.schema,\n      this.tableName,\n      'where',\n      whereFieldNames(conditions as Record<string, unknown>)\n    );\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    assertNotOpaque(this.schema, this.tableName, 'orderBy', [field]);\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        // No such relationship in the client schema — e.g. a table owned by a\n        // devOnly backend (the outbox `job`) that a free/Cloudflare deployment\n        // never provisions, so codegen omits it + its relationships. Skip the\n        // projection instead of throwing, which would take the whole query\n        // (and its other `.related()` siblings — author, comments) down.\n        // Mirrors the server's \"unpermitted subquery → empty\" degradation.\n        if (typeof console !== 'undefined') {\n          console.warn(\n            `[sp00ky] .related('${String(relatedField)}') skipped — no such relationship on '${this.tableName}' in the client schema`\n          );\n        }\n        return this as any;\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    assertNotOpaque(\n      this.schema,\n      this.tableName,\n      'where',\n      whereFieldNames(conditions as Record<string, unknown>)\n    );\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    assertNotOpaque(this.schema, this.tableName, 'orderBy', [field as string]);\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      // See the note on the other `.related()` overload: skip an unknown\n      // relationship (warn) rather than throwing, so a table absent from the\n      // client schema (e.g. the free-plan `job` outbox) can't crash the query.\n      if (typeof console !== 'undefined') {\n        console.warn(\n          `[sp00ky] .related('${String(field)}') skipped — no such relationship on '${this.tableName}' in the client schema`\n        );\n      }\n      return this as any;\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\n/**\n * The surql param name an `_or` branch condition binds under: the branch FIELD,\n * a `__or` marker and the branch's position. The position alone makes it unique\n * within the query; the field prefix is what lets a consumer type the value by\n * looking the column up (see {@link baseFieldOfParam}). Non-identifier\n * characters (a nested path like `database.owner`) are folded to `_` so the\n * result is a legal param name.\n */\nexport function orParamName(field: string, index: number): string {\n  return `${field.replace(/[^A-Za-z0-9_]/g, '_')}__or${index}`;\n}\n\n/**\n * Inverse of {@link orParamName}: the field a param name was built from, or the\n * name itself when it is a plain top-level param (`field = $field`). Lets a\n * consumer resolve `white__or0` back to the `white` column.\n */\nexport function baseFieldOfParam(name: string): string {\n  const m = /^(.+)__or\\d+$/.exec(name);\n  return m ? m[1] : name;\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 (`white__or0`, `black__or1`, …) so\n      // it never collides with a top-level condition on the same field (e.g. a\n      // `white = $white` filter alongside an opponent `_or` on white/black) -\n      // keeping the surql + vars, and thus the query hash, stable and\n      // deterministic. The FIELD is part of the name on purpose: the consumer\n      // types a param by looking its name up in the table's columns\n      // (`parseQueryParams` in @spooky-sync/core), and a name it cannot resolve\n      // used to be dropped from the registration, which left `$or0` unbound and\n      // every `_or` query matching nothing.\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, orParamName(bField, 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    // slaveToParams: top-level filters materialize from `params` (the query's\n    // identity), not a baked literal — see buildWhereNodes. Prevents a query's\n    // rows ever coming from a different query's plan.\n    const nodes = buildWhereNodes(parsedWhere, true);\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 */\n/**\n * @param slaveToParams When true, top-level plain/operator-literal comparisons\n *   ALSO carry a `paramRef` equal to the field name — the same var name\n *   `buildQueryFromOptions` binds the value under (`field = $field`). The\n *   engines then materialize by reading `params[field]` (falling back to the\n *   baked `value` when the param is absent), so a query's rows are slaved to\n *   its `params` (its identity) and can never come from a different query's\n *   baked plan. Only safe at the TOP LEVEL, where the field is a schema column\n *   that survives `parseQueryParams` and the caller passes `params`. NOT used\n *   for relation sub-wheres (rendered with a params-less ctx) or `_or` branches\n *   (bound under synthetic `white__or0` names) - those stay baked.\n */\nfunction buildWhereNodes(\n  parsedWhere: Record<string, unknown>,\n  slaveToParams = false\n): WhereNode[] {\n  const toComparison = (field: string, value: unknown, slave: boolean): 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      // Literal operand: keep `value` as a fallback and add `paramRef: field`\n      // (slave mode) so materialization reads the query's own `params[field]`.\n      return slave\n        ? { field, op: _op, value: _val, paramRef: field, swap: _swap }\n        : { field, op: _op, value: _val, swap: _swap };\n    }\n    return slave ? { field, op: '=', value, paramRef: field } : { 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 branches bind under synthetic `white__or0` names (see\n            // orParamName / buildQueryFromOptions); the plan keeps them baked.\n            or.push(toComparison(bField, bVal, false));\n          }\n        }\n      }\n      if (or.length > 0) nodes.push({ or });\n      continue;\n    }\n    nodes.push(toComparison(key, value, slaveToParams));\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":";;;;;;;;;;;;;;;;AAwCA,SAAS,gBACP,QACA,WACA,QACA,QACM;CACN,MAAM,QAAQ,OAAO,OAAO,MAAM,MAAM,EAAE,SAAS,UAAU;AAC7D,KAAI,CAAC,MAAO;AACZ,MAAK,MAAM,SAAS,OAMlB,MADE,MAAM,QAAQ,UAAU,MAAM,QAAQ,MAAM,MAAM,IAAI,CAAC,MAC7C,OACV,OAAM,IAAI,MACR,eAAe,MAAM,OAAO,OAAO,mCAC9B,UAAU,mLAGhB;;;AAMP,SAAS,gBAAgB,YAA+C;CACtE,MAAM,MAAgB,EAAE;AACxB,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,WAAW,EAAE;AACrD,MAAI,QAAQ,OAAO;AACjB,QAAK,MAAM,UAAW,SAAS,EAAE,CAC/B,KAAI,KAAK,GAAG,gBAAgB,UAAU,EAAE,CAAC,CAAC;AAE5C;;AAEF,MAAI,KAAK,IAAI;;AAEf,QAAO;;;;;;;;;;AAWT,SAAS,sBAAsB,OAAgB,WAAoB,WAA6B;AAC9F,KAAI,OAAO,UAAU,SAAU,QAAO;AAGtC,KAAI,MAAM,SAAS,IAAI,EAAE;EACvB,MAAM,CAAC,OAAO,GAAG,WAAW,MAAM,MAAM,IAAI;AAE5C,SAAO,IAAIA,WAAS,OADT,QAAQ,KAAK,IAAI,CACE;;AAIhC,KAAI,cAAc,QAAQ,UACxB,QAAO,IAAIA,WAAS,WAAW,MAAM;AAIvC,QAAO;;;;;;;AAQT,SAAS,yBAAyB,KAAc,WAA6B;AAC3E,KAAI,QAAQ,QAAQ,QAAQ,OAAW,QAAO;AAE9C,KAAI,OAAO,QAAQ,SACjB,QAAO,sBAAsB,KAAK,UAAU;AAG9C,KAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,SAAS,yBAAyB,MAAM,UAAU,CAAC;AAGrE,KAAI,OAAO,QAAQ,YAAY,IAAI,gBAAgB,QAAQ;EACzD,MAAM,SAAkC,EAAE;AAC1C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,CAE5C,QAAO,OACL,OAAO,UAAU,WACb,sBAAsB,OAAO,WAAW,IAAI,GAC5C,yBAAyB,OAAO,UAAU;AAElD,SAAO;;AAGT,QAAO;;AAOT,IAAa,aAAb,MAIE;CAOA,YACE,AAAiB,YACjB,AAAiB,SACjB,AAAiB,QACjB,AAAiB,UACjB;EAJiB;EACA;EACA;EACA;AAEjB,OAAK,eAAe,sBAAsB,UAAU,KAAK,YAAY,KAAK,SAAS,KAAK,OAAO;AAE/F,OAAK,aAAa,sBAChB,UACA,KAAK,YACL;GAAE,GAAG,KAAK;GAAS,SAAS,EAAE;GAAE,EAChC,KAAK,OACN;AAED,OAAK,QAAQ,KAAK,aAAa;AAE/B,OAAK,mBAAmB,sBACtB,eACA,KAAK,YACL,KAAK,SACL,KAAK,OACN;AAED,OAAK,cAAc,0BACjB,QACA,KAAK,YACL,KAAK,SACL,KAAK,SACN;;CAGH,IAAI,YAAuB;AACzB,SAAO,KAAK;;CAGd,IAAI,aAA+E;AACjF,SAAO,KAAK;;CAGd,IAAI,cAAyB;AAC3B,SAAO,KAAK;;CAGd,IAAI,kBAA6B;AAC/B,SAAO,KAAK;;CAGd,IAAI,YAAoB;AACtB,SAAO,KAAK;;CAGd,IAAI,OAAe;AACjB,SAAO,KAAK;;CAGd,IAAI,QAAiB;AACnB,SAAO,KAAK,QAAQ,SAAS;;CAG/B,AAAO,MAAS;AACd,SAAO,KAAK,SAAS,KAAK;;CAG5B,AAAO,iBAAiB,SAA2B;AACjD,SAAO,sBAAsB,UAAU,KAAK,YAAY,KAAK,SAAS,KAAK,QAAQ,QAAQ;;CAG7F,AAAO,mBAA8B;AACnC,SAAO,sBAAsB,UAAU,KAAK,YAAY,KAAK,SAAS,KAAK,OAAO;;CAGpF,AAAO,aAAiD;AACtD,SAAO,KAAK;;;AAiEhB,IAAa,aAAb,MAQE;CAGA,YACE,AAAiB,WACjB,AAAiB,SACjB,AAAiB,QACjB,AAAiB,UACjB;EAJiB;EACA;EACA;EACA;AAEjB,OAAK,cAAc,IAAI,WACrB,KAAK,WACL,KAAK,SACL,KAAK,QACL,KAAK,SACN;;CAGH,MAAS;AACP,SAAO,KAAK,SAAS,KAAK,YAAY;;CAGxC,iBAAiB,SAA2B;AAC1C,SAAO,KAAK,YAAY,iBAAiB,QAAQ;;CAGnD,mBAA8B;AAC5B,SAAO,KAAK,YAAY,kBAAkB;;CAG5C,aAAwB;AACtB,SAAO,KAAK,YAAY;;CAG1B,IAAI,aAAsC;AACxC,SAAO,KAAK;;CAGd,IAAI,QAAiB;AACnB,SAAO,KAAK,QAAQ,SAAS;;CAG/B,IAAI,OAAe;AACjB,SAAO,KAAK,YAAY;;;;;;;AAQ5B,IAAM,sCAAN,MAI0E;CAGxE,YACE,AAAiB,WACjB,AAAiB,QACjB;EAFiB;EACA;iBAJ0D,EAAE;;CAO/E,MAAM,YAAkE;AACtE,kBACE,KAAK,QACL,KAAK,WACL,SACA,gBAAgB,WAAsC,CACvD;AACD,OAAK,QAAQ,QAAQ;GAAE,GAAG,KAAK,QAAQ;GAAO,GAAG;GAAY;AAC7D,SAAO;;CAGT,OAAO,GAAG,QAA6E;AACrF,MAAI,KAAK,QAAQ,OACf,OAAM,IAAI,MAAM,2CAA2C;AAE7D,OAAK,QAAQ,SAAS;AACtB,SAAO;;CAGT,MAAM,OAAqB;AACzB,OAAK,QAAQ,QAAQ;AACrB,SAAO;;CAGT,OAAO,OAAqB;AAC1B,OAAK,QAAQ,SAAS;AACtB,SAAO;;CAGT,QACE,OACA,YAA4B,OACtB;AACN,kBAAgB,KAAK,QAAQ,KAAK,WAAW,WAAW,CAAC,MAAM,CAAC;AAChE,OAAK,QAAQ,UAAU;GACrB,GAAG,KAAK,QAAQ;IACf,QAAQ;GACV;AACD,SAAO;;CAIT,QAKE,cACA,UAWA;AACA,MAAI,CAAC,KAAK,QAAQ,QAChB,MAAK,QAAQ,UAAU,EAAE;AAK3B,MAAI,CAFW,KAAK,QAAQ,QAAQ,MAAM,OAAO,EAAE,SAAS,EAAE,kBAAkB,aAAa,EAEhF;GAEX,MAAM,eAAe,KAAK,OAAO,cAAc,MAC5C,MAAM,EAAE,SAAS,KAAK,aAAa,EAAE,UAAU,aACjD;AAED,OAAI,CAAC,cAAc;AAOjB,QAAI,OAAO,YAAY,YACrB,SAAQ,KACN,sBAAsB,OAAO,aAAa,CAAC,wCAAwC,KAAK,UAAU,wBACnG;AAEH,WAAO;;GAGT,MAAM,eAAe,aAAa;GAClC,MAAM,cAAc,aAAa;GACjC,MAAM,kBAAkB,gBAAgB,SAAS,KAAK,YAAY;AAElE,QAAK,QAAQ,QAAQ,KAAK;IACxB;IACA,OAAO;IACG;IACV;IACiB;IAClB,CAA+C;;AAElD,SAAO;;CAGT,cAAyE;AACvE,SAAO,KAAK;;;;;;;AAQhB,IAAa,eAAb,MAAa,aAMX;CACA,YACE,AAAiB,QACjB,AAAiB,WACjB,AAAiB,iBAAsD,QACvE,AAAQ,UAAmE,EAAE,EAC7E;EAJiB;EACA;EACA;EACT;;;;;CAMV,MACE,YACqD;AACrD,kBACE,KAAK,QACL,KAAK,WACL,SACA,gBAAgB,WAAsC,CACvD;AACD,OAAK,QAAQ,QAAQ;GAAE,GAAG,KAAK,QAAQ;GAAO,GAAG;GAAY;AAC7D,SAAO;;;;;CAMT,OACE,GAAG,QACkD;AACrD,MAAI,KAAK,QAAQ,OACf,OAAM,IAAI,MAAM,2CAA2C;AAE7D,OAAK,QAAQ,SAAS;AACtB,SAAO;;;;;CAMT,QACE,OACA,YAA4B,OACyB;AACrD,kBAAgB,KAAK,QAAQ,KAAK,WAAW,WAAW,CAAC,MAAgB,CAAC;AAC1E,OAAK,QAAQ,UAAU;GACrB,GAAG,KAAK,QAAQ;IACf,QAAQ;GACV;AACD,SAAO;;;;;CAMT,MAAM,OAAoE;AACxE,OAAK,QAAQ,QAAQ;AACrB,SAAO;;;;;CAMT,OAAO,OAAoE;AACzE,OAAK,QAAQ,SAAS;AACtB,SAAO;;CAGT,MAA0D;AACxD,SAAO,IAAI,aACT,KAAK,QACL,KAAK,WACL,KAAK,UACL;GAAE,GAAG,KAAK;GAAS,OAAO;GAAM,CACjC;;;;;;;CAQH,QAKE,OACA,uBAGA,UAaA;AACA,MAAI,CAAC,KAAK,QAAQ,QAChB,MAAK,QAAQ,UAAU,EAAE;AAM3B,MAFe,KAAK,QAAQ,QAAQ,MAAM,OAAO,EAAE,SAAS,EAAE,kBAAkB,MAAM,CAGpF,QAAO;EAIT,MAAM,eAAe,KAAK,OAAO,cAAc,MAC5C,MAAM,EAAE,SAAS,KAAK,aAAa,EAAE,UAAU,MACjD;AAED,MAAI,CAAC,cAAc;AAIjB,OAAI,OAAO,YAAY,YACrB,SAAQ,KACN,sBAAsB,OAAO,MAAM,CAAC,wCAAwC,KAAK,UAAU,wBAC5F;AAEH,UAAO;;EAIT,IAAI;EACJ,IAAI;AAEJ,MAAI,OAAO,0BAA0B,YAAY;AAE/C,uBAAoB,aAAa;AACjC,oBAAiB;aACR,0BAA0B,SAAS,0BAA0B,QAAQ;AAE9E,uBAAoB;AACpB,oBAAiB;SACZ;AAEL,uBAAoB,aAAa;AACjC,oBAAiB;;EAInB,IAAI,kBACF,sBAAsB,SAAU,KAAK,YAAwB;AAE/D,MAAI,sBAAsB,QAAQ;GAGhC,MAAM,uBAAuB,KAAK,OAAO,cAAc,QACpD,MAAM,EAAE,SAAS,aAAa,MAAM,EAAE,OAAO,KAAK,aAAa,EAAE,gBAAgB,MACnF;AAED,OAAI,qBAAqB,SAAS,GAAG;IAEnC,MAAM,aAAa,qBAAqB,MAAM,MAAM,EAAE,UAAU,KAAK,UAAU;AAC/E,QAAI,WACF,mBAAkB,WAAW;QAE7B,mBAAkB,qBAAqB,GAAG;cAIxC,KAAK,UAAU,WAAW,GAAG,aAAa,GAAG,GAAG,CAElD,mBAAkB,KAAK,UAAU,MAAM,aAAa,GAAG,SAAS,EAAE;;EAOxE,MAAM,kBAAkB;AAExB,OAAK,QAAQ,QAAQ,KAAK;GACxB,cAAc,aAAa;GAC3B,OAAO;GACP,UAAU;GACV,aAAa;GACI;GAClB,CAA+C;AAEhD,SAAO;;;;;CAMT,aAAsE;AACpE,SAAO,KAAK;;;;;;CAOd,QAAmF;AACjF,SAAO,IAAI,WACT,KAAK,WACL,KAAK,SACL,KAAK,QACL,KAAK,SACN;;;;;;;;;;;AAYL,SAAgB,YAAY,OAAe,OAAuB;AAChE,QAAO,GAAG,MAAM,QAAQ,kBAAkB,IAAI,CAAC,MAAM;;;;;;;AAQvD,SAAgB,iBAAiB,MAAsB;CACrD,MAAM,IAAI,gBAAgB,KAAK,KAAK;AACpC,QAAO,IAAI,EAAE,KAAK;;AAGpB,SAAgB,OAAO,KAAa,OAAe,GAAW;CAC5D,IAAI,KAAK,aAAa,MACpB,KAAK,aAAa;AACpB,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,QAAQ,KAAK;AACvC,OAAK,IAAI,WAAW,EAAE;AACtB,OAAK,KAAK,KAAK,KAAK,IAAI,WAAW;AACnC,OAAK,KAAK,KAAK,KAAK,IAAI,WAAW;;AAErC,MAAK,KAAK,KAAK,KAAM,OAAO,IAAK,WAAW;AAC5C,OAAM,KAAK,KAAK,KAAM,OAAO,IAAK,WAAW;AAC7C,MAAK,KAAK,KAAK,KAAM,OAAO,IAAK,WAAW;AAC5C,OAAM,KAAK,KAAK,KAAM,OAAO,IAAK,WAAW;AAE7C,QAAO,cAAc,UAAU,OAAO,OAAO;;AAG/C,SAAgB,0BACd,QACA,iBACA,SACA,UACkE;AAClE,KAAI,CAAC,QAAQ,QACX,QAAO,EAAE;AAGX,QAAO,QAAQ,QAAQ,KAAK,QAAQ;EAElC,MAAM,aACJ,IACG,WAAW,IAAI,oCAAoC,IAAI,cAAc,OAAO,CAAC,CAC7E,aAAa,IAAI,EAAE;EAGxB,MAAM,eAAe,OAAO,cAAc,MACvC,MAAM,EAAE,SAAS,mBAAmB,EAAE,UAAU,IAAI,MACtD;AAED,MAAI,cAAc;GAIhB,IAAI,kBAAkB,IAAI;AAE1B,OAAI,aAAa,gBAAgB,QAAQ;IAGvC,MAAM,uBAAuB,OAAO,cAAc,QAC/C,MAAM,EAAE,SAAS,IAAI,gBAAgB,EAAE,OAAO,mBAAmB,EAAE,gBAAgB,MACrF;AAED,QAAI,qBAAqB,SAAS,GAAG;KAEnC,MAAM,aAAa,qBAAqB,MAAM,MAAM,EAAE,UAAU,gBAAgB;AAChF,SAAI,WACF,mBAAkB,WAAW;SAE7B,mBAAkB,qBAAqB,GAAG;eAIxC,gBAAgB,WAAW,GAAG,IAAI,aAAa,GAAG,CAEpD,mBAAkB,gBAAgB,MAAM,IAAI,aAAa,SAAS,EAAE;QAGpE,mBAAkB;;AAMxB,cAAW,QAAQ,WAAW,SAAS,EAAE;AAEzC,OAAI,aAAa,gBAAgB,OAG/B,CAAC,WAAW,MAAc,mBAAmB;IAAE,KAAK;IAAK,MAAM;IAAc,OAAO;IAAM;OAK1F,CAAC,WAAW,MAAc,KAAK;IAC7B,KAAK;IACL,MAAM,WAAW;IACjB,OAAO;IACR;;AAIL,SAAO,IAAI,WAAW,IAAI,cAAc,YAAY,QAAQ,SAAS;GACrE;;;;;;;;;;AAWJ,SAAgB,sBACd,QACA,WACA,SACA,QACA,SACW;AACX,KAAI,QAAQ,MACV,SAAQ,QAAQ;CAElB,MAAM,cAAc,WAAW,iBAAiB,WAAW;CAG3D,MAAM,cAAc,QAAQ,QACxB,yBAAyB,QAAQ,OAAO,UAAU,GAClD;CAGJ,IAAI,eAAe;AAEnB,KAAI,WAAW,mBACb,gBAAe;UAEX,QAAQ,UAAU,QAAQ,OAAO,SAAS,EAC5C,gBAAe,QAAQ,OAAO,KAAK,KAAK;CAK5C,IAAI,eAAe;AACnB,KAAI,CAAC,eAAe,QAAQ,WAAW,QAAQ,QAAQ,SAAS,EAE9D,gBAAe,OADI,QAAQ,QAAQ,KAAK,QAAQ,cAAc,KAAK,OAAO,CAAC,CAC1C,KAAK,KAAK;CAI7C,IAAI,QAAQ;AAEZ,KAAI,WAAW,SACb,SAAQ,UAAU;UACT,WAAW,SACpB,SAAQ,eAAe;KAEvB,SAAQ,GAAG,SAAS,eAAe,IAAI,iBAAiB,KAAK,aAAa,QAAQ;CAIpF,MAAM,OAAgC,EAAE;AACxC,KAAI,eAAe,OAAO,KAAK,YAAY,CAAC,SAAS,GAAG;EACtD,MAAM,aAAuB,EAAE;EAM/B,MAAM,kBAAkB,OAAe,OAAgB,YAA4B;AACjF,OAAI,SAAS,OAAO,UAAU,YAAY,SAAS,SAAS,UAAU,OAAO;IAC3E,MAAM,EAAE,KAAK,MAAM,UAAU;IAC7B,IAAI;AACJ,QAAI,OAAO,SAAS,YAAY,KAAK,WAAW,IAAI,CAClD,aAAY;SACP;AACL,UAAK,WAAW;AAChB,iBAAY,IAAI;;AAElB,WAAO,QAAQ,GAAG,UAAU,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG;;AAErE,QAAK,WAAW;AAChB,UAAO,GAAG,MAAM,MAAM;;AAGxB,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,YAAY,EAAE;AAYtD,OAAI,QAAQ,SAAS,MAAM,QAAQ,MAAM,EAAE;IACzC,MAAM,UAAoB,EAAE;IAC5B,IAAI,IAAI;AACR,SAAK,MAAM,UAAU,MACnB,KAAI,UAAU,OAAO,WAAW,SAC9B,MAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,OAAkC,CAC5E,SAAQ,KAAK,eAAe,QAAQ,MAAM,YAAY,QAAQ,IAAI,CAAC,CAAC;AAI1E,QAAI,QAAQ,SAAS,EAAG,YAAW,KAAK,IAAI,QAAQ,KAAK,OAAO,CAAC,GAAG;AACpE;;AAGF,cAAW,KAAK,eAAe,KAAK,OAAO,IAAI,CAAC;;AAGlD,MAAI,WAAW,SAAS,EAAG,UAAS,UAAU,WAAW,KAAK,QAAQ;;AAIxE,KAAI,WAAW,YAAY,QACzB,UAAS,UAAU,KAAK,UAAU,QAAQ;AAM5C,KAAI,CAAC,aAAa;AAChB,MAAI,QAAQ,WAAW,OAAO,KAAK,QAAQ,QAAQ,CAAC,SAAS,GAAG;GAC9D,MAAM,eAAe,OAAO,QAAQ,QAAQ,QAAQ,CAAC,KAClD,CAAC,OAAO,eAAe,GAAG,MAAM,GAAG,YACrC;AACD,YAAS,aAAa,aAAa,KAAK,KAAK;;AAG/C,MAAI,QAAQ,UAAU,OACpB,UAAS,UAAU,QAAQ;AAG7B,MAAI,QAAQ,WAAW,OACrB,UAAS,UAAU,QAAQ;;AAI/B,UAAS;AAET,QAAO;EACL;EACA,MAAM,OACJ,GAAG,MAAM,IAAI,OAAO,QAAQ,KAAK,CAC9B,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,GAAG,QAAQ,CACxC,KAAK,IAAI,IACZ,EACD;EACD,MAAM,OAAO,KAAK,KAAK,CAAC,SAAS,IAAI,OAAO;EAI5C,MAAM,WAAW,WAAW,eAAe,WAAW,SAAS,OAAO,GAAG;EAC1E;;;;;;;AAQH,SAAS,eACP,WACA,SACA,QACW;CACX,MAAM,OAAkB,EAAE,OAAO,WAAW;AAE5C,KAAI,QAAQ,UAAU,QAAQ,OAAO,SAAS,KAAK,CAAC,QAAQ,OAAO,SAAS,IAAI,CAC9E,MAAK,SAAS,QAAQ,OAAO,QAAQ,MAAM,MAAM,IAAI;CAGvD,MAAM,cAAc,QAAQ,QACvB,yBAAyB,QAAQ,OAAO,UAAU,GACnD;AACJ,KAAI,eAAe,OAAO,KAAK,YAAY,CAAC,SAAS,GAAG;EAItD,MAAM,QAAQ,gBAAgB,aAAa,KAAK;AAChD,MAAI,MAAM,SAAS,EAAG,MAAK,QAAQ;;AAGrC,KAAI,QAAQ,WAAW,OAAO,KAAK,QAAQ,QAAQ,CAAC,SAAS,EAC3D,MAAK,UAAU,OAAO,QAAQ,QAAQ,QAAQ,CAAC,KAC5C,CAAC,OAAO,eAAe,CAAC,OAAO,UAA4B,CAC7D;AAGH,KAAI,QAAQ,UAAU,OAAW,MAAK,QAAQ,QAAQ;AACtD,KAAI,QAAQ,WAAW,OAAW,MAAK,SAAS,QAAQ;AAExD,KAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,EAC9C,MAAK,YAAY,QAAQ,QAAQ,KAAK,QAAQ,kBAAkB,KAAK,OAAO,CAAC;AAG/E,QAAO;;;;;;;AAQT,SAAS,kBACP,KACA,QACc;CACd,MAAM,EAAE,cAAc,OAAO,UAAU,gBAAgB;CAGvD,MAAM,kBAAmB,IAAI,mBAAmB,SAAS;CAEzD,MAAM,OAAqB;EACzB,OAAQ,SAAS;EACjB,OAAO;EACP;EACA;EACD;AAED,KAAI,UAAU;EACZ,MAAM,kBAAkB,IAAI,oCAAoC,cAAc,OAAO;AACrF,WAAS,gBAAuB;EAChC,MAAM,aAAa,gBAAgB,aAAa;AAEhD,MAAI,WAAW,UAAU,WAAW,OAAO,SAAS,KAAK,CAAC,WAAW,OAAO,SAAS,IAAI,CACvF,MAAK,SAAS,WAAW,OAAO,QAAQ,MAAM,MAAM,IAAI;AAG1D,MAAI,WAAW,SAAS,OAAO,KAAK,WAAW,MAAM,CAAC,SAAS,GAAG;GAKhE,MAAM,QAAQ,gBAJS,yBAAyB,WAAW,OAAO,aAAa,CAIlC;AAC7C,OAAI,MAAM,SAAS,EAAG,MAAK,QAAQ;;AAGrC,MAAI,WAAW,WAAW,OAAO,KAAK,WAAW,QAAQ,CAAC,SAAS,EACjE,MAAK,UAAU,OAAO,QAAQ,WAAW,QAAQ,CAAC,KAC/C,CAAC,OAAO,eAAe,CAAC,OAAO,UAA4B,CAC7D;AAGH,MAAI,WAAW,UAAU,OAAW,MAAK,QAAQ,WAAW;AAK5D,MAAI,WAAW,WAAW,WAAW,QAAQ,SAAS,EAiBpD,MAAK,YAhBsB,WAAW,QAAQ,KAAK,cAAc;GAC/D,MAAM,eAAe,OAAO,cAAc,MACvC,MAAM,EAAE,SAAS,gBAAgB,EAAE,UAAU,UAAU,MACzD;AACD,OAAI,cAAc;IAChB,MAAM,wBACJ,aAAa,gBAAgB,SAAS,eAAgB,UAAU;AAClE,WAAO;KACL,GAAG;KACH,cAAc,aAAa;KAC3B,aAAa,aAAa;KAC1B,iBAAiB;KAClB;;AAEH,UAAO;IACP,CACkC,KAAK,cAAc,kBAAkB,WAAW,OAAO,CAAC;;AAKhG,KAAI,gBAAgB,SAAS,KAAK,UAAU,OAC1C,MAAK,QAAQ;AAGf,QAAO;;;;;;;;;;;;;;;;;;;;AAqBT,SAAS,gBACP,aACA,gBAAgB,OACH;CACb,MAAM,gBAAgB,OAAe,OAAgB,UAAoC;AACvF,MAAI,SAAS,OAAO,UAAU,YAAY,SAAS,SAAS,UAAU,OAAO;GAC3E,MAAM,EAAE,KAAK,MAAM,UAAU;AAC7B,OAAI,OAAO,SAAS,YAAY,KAAK,WAAW,IAAI,CAClD,QAAO;IAAE;IAAO,IAAI;IAAK,OAAO;IAAW,UAAU,KAAK,MAAM,EAAE;IAAE,MAAM;IAAO;AAInF,UAAO,QACH;IAAE;IAAO,IAAI;IAAK,OAAO;IAAM,UAAU;IAAO,MAAM;IAAO,GAC7D;IAAE;IAAO,IAAI;IAAK,OAAO;IAAM,MAAM;IAAO;;AAElD,SAAO,QAAQ;GAAE;GAAO,IAAI;GAAK;GAAO,UAAU;GAAO,GAAG;GAAE;GAAO,IAAI;GAAK;GAAO;;CAGvF,MAAM,QAAqB,EAAE;AAC7B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,YAAY,EAAE;AACtD,MAAI,QAAQ,SAAS,MAAM,QAAQ,MAAM,EAAE;GACzC,MAAM,KAAwB,EAAE;AAChC,QAAK,MAAM,UAAU,MACnB,KAAI,UAAU,OAAO,WAAW,SAC9B,MAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,OAAkC,CAG5E,IAAG,KAAK,aAAa,QAAQ,MAAM,MAAM,CAAC;AAIhD,OAAI,GAAG,SAAS,EAAG,OAAM,KAAK,EAAE,IAAI,CAAC;AACrC;;AAEF,QAAM,KAAK,aAAa,KAAK,OAAO,cAAc,CAAC;;AAErD,QAAO;;;;;AAMT,SAAS,cACP,KACA,QACQ;CACR,MAAM,EAAE,cAAc,OAAO,UAAU,gBAAgB;CACvD,MAAM,kBAAkB,IAAI,mBAAmB;CAE/C,IAAI,iBAAiB;CACrB,IAAI,gBAAgB;CACpB,IAAI,kBAAkB;CACtB,IAAI,gBAAgB;AAGpB,KAAI,UAAU;EACZ,MAAM,kBAAkB,IAAI,oCAAoC,cAAc,OAAO;AACrF,WAAS,gBAAgB;EACzB,MAAM,aAAa,gBAAgB,aAAa;AAGhD,MAAI,WAAW,UAAU,WAAW,OAAO,SAAS,EAClD,kBAAiB,WAAW,OAAO,KAAK,KAAK;AAI/C,MAAI,WAAW,SAAS,OAAO,KAAK,WAAW,MAAM,CAAC,SAAS,GAAG;GAChE,MAAM,iBAAiB,yBAAyB,WAAW,OAAO,aAAa;AAU/E,mBAAgB,QANG,OAAO,QAAQ,eAAe,CAAC,KAAK,CAAC,KAAK,WAAW;AACtE,QAAI,iBAAiBA,WACnB,QAAO,GAAG,IAAI,KAAK,MAAM,UAAU;AAErC,WAAO,GAAG,IAAI,KAAK,KAAK,UAAU,MAAM;KACxC,CACiC,KAAK,QAAQ;;AAIlD,MAAI,WAAW,WAAW,OAAO,KAAK,WAAW,QAAQ,CAAC,SAAS,EAIjE,mBAAkB,aAHG,OAAO,QAAQ,WAAW,QAAQ,CAAC,KACrD,CAAC,OAAO,eAAe,GAAG,MAAM,GAAG,YACrC,CAC2C,KAAK,KAAK;AAIxD,MAAI,WAAW,UAAU,OACvB,iBAAgB,UAAU,WAAW;AAIvC,MAAI,WAAW,WAAW,WAAW,QAAQ,SAAS,GAAG;GAyBvD,MAAM,mBAvBqB,WAAW,QAAQ,KAAK,cAAc;AAC/D,QAAI,QAAQ;KAEV,MAAM,eAAe,OAAO,cAAc,MACvC,MAAM,EAAE,SAAS,gBAAgB,EAAE,UAAU,UAAU,MACzD;AAED,SAAI,cAAc;MAEhB,MAAM,wBACJ,aAAa,gBAAgB,SAAS,eAAe,UAAU;AAEjE,aAAO;OACL,GAAG;OACH,cAAc,aAAa;OAC3B,aAAa,aAAa;OAC1B,iBAAiB;OAClB;;;AAGL,WAAO;KACP,CAE0C,KAAK,cAC/C,cAAc,WAAW,OAAO,CACjC;AACD,qBAAkB,OAAO,iBAAiB,KAAK,KAAK;;;CAKxD,IAAI;AACJ,KAAI,gBAAgB,OAAO;AAEzB,mBAAiB,oBAAoB;AAErC,MAAI,CAAC,cACH,iBAAgB;OAIlB,kBAAiB,SAAS,gBAAgB;CAI5C,IAAI,WAAW,WAAW,eAAe,QAAQ,aAAa,GAAG,iBAAiB,gBAAgB,kBAAkB,cAAc;AAGlI,KAAI,gBAAgB,MAClB,aAAY;AAGd,aAAY,OAAO;AAEnB,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spooky-sync/query-builder",
-  "version": "0.0.1-canary.21",
+  "version": "0.0.1-canary.210",
   "description": "Type-safe query builder for SurrealDB with relationship support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,7 +31,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mono424/spooky.git",
+    "url": "https://github.com/mono424/sp00ky.git",
     "directory": "packages/query-builder"
   },
   "publishConfig": {
@@ -39,7 +39,7 @@
   },
   "packageManager": "pnpm@9.0.0",
   "dependencies": {
-    "surrealdb": "2.0.0"
+    "surrealdb": "2.0.3"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/skills/{spooky-query-builder → sp00ky-query-builder}/SKILL.md

@@ -1,22 +1,22 @@
 ---
-name: spooky-query-builder
+name: sp00ky-query-builder
 description: >-
-  Type-safe query builder for SurrealDB used by the Spooky framework. Use when
+  Type-safe query builder for SurrealDB used by the Sp00ky framework. Use when
   defining schemas (SchemaStructure), building queries with QueryBuilder, handling
-  relationships (one/many cardinality), or working with Spooky type helpers like
+  relationships (one/many cardinality), or working with Sp00ky type helpers like
   TableNames, GetTable, TableModel, and QueryResult.
 metadata:
-  author: spooky-sync
+  author: sp00ky-sync
   version: "0.0.1"
 ---
 
-# Spooky Query Builder
+# Sp00ky Query Builder
 
-`@spooky-sync/query-builder` provides the type-safe schema definition format and query builder used throughout the Spooky framework.
+`@spooky-sync/query-builder` provides the type-safe schema definition format and query builder used throughout the Sp00ky framework.
 
 ## Schema Definition
 
-Spooky schemas are defined as `const` objects satisfying `SchemaStructure`. They are typically generated by the Spooky CLI (`spooky generate`), but can be written by hand.
+Sp00ky schemas are defined as `const` objects satisfying `SchemaStructure`. They are typically generated by the Sp00ky CLI (`spooky generate`), but can be written by hand.
 
 ```typescript
 import type { SchemaStructure } from '@spooky-sync/query-builder';
@@ -122,7 +122,7 @@ Cardinality is inferred from the schema. For `'one'` relationships, the result i
 
 ## Backend Schema
 
-The `backends` field in `SchemaStructure` defines available HTTP backends, their outbox tables, and typed routes. This is generated by `spooky generate` from your `spooky.yml` config and OpenAPI spec.
+The `backends` field in `SchemaStructure` defines available HTTP backends, their outbox tables, and typed routes. This is generated by `spooky generate` from your `sp00ky.yml` config and OpenAPI spec.
 
 ### Schema Structure
 
@@ -149,7 +149,7 @@ export interface HTTPBackendRouteArgsDefinition {
 
 ### Generated Example
 
-Given a `spooky.yml` with an `api` backend and an OpenAPI spec defining a `/spookify` route with an `id` parameter, `spooky generate` produces:
+Given a `sp00ky.yml` with an `api` backend and an OpenAPI spec defining a `/spookify` route with an `id` parameter, `spooky generate` produces:
 
 ```typescript
 export const schema = {

package/src/index.ts

@@ -13,6 +13,8 @@ export {
   type ExtractFieldNames,
   type RelatedFieldMapEntry,
   cyrb53,
+  orParamName,
+  baseFieldOfParam,
 } from './query-builder';
 
 // Type exports
@@ -28,6 +30,15 @@ export type {
   SchemaAwareQueryModifier,
   SchemaAwareQueryModifierBuilder,
   RelatedQuery,
+  ComparisonOp,
+  WhereFieldValue,
+  WhereConditions,
+  WhereInput,
+  QueryPlan,
+  RelationPlan,
+  WhereNode,
+  WhereComparison,
+  WhereOr,
   RelationshipDefinition,
   RelationshipsMetadata,
   RelationshipFields,