joist-core 2.3.0 → 2.4.0

package/build/preloading/JsonAggregatePreloader.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsonAggregatePreloader.js","sourceRoot":"","sources":["../../src/preloading/JsonAggregatePreloader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"JsonAggregatePreloader.js","names":[],"sources":["../../src/preloading/JsonAggregatePreloader.ts"],"sourcesContent":["import { type Entity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type ManyToManyEnumField, getMetadata, getMetadataForField } from \"src/EntityMetadata.ts\";\nimport type { ManyToManyLike } from \"src/flush/JoinRows.ts\";\nimport { keyToNumber, keyToTaggedId } from \"src/keys.ts\";\nimport type { EntityOrId, HintNode } from \"src/loading/HintTree.ts\";\nimport type { LoadHint, NestedLoadHint } from \"src/loading/loadHints.ts\";\nimport { type JoinResult, type PreloadHydrator, type PreloadPlugin } from \"src/plugins/PreloadPlugin.ts\";\nimport { canPreload } from \"src/preloading/canPreload.ts\";\nimport { partitionHint } from \"src/preloading/partitionHint.ts\";\nimport { ConditionBuilder } from \"src/queries/ConditionBuilder.ts\";\nimport {\n  type JoinTable,\n  type LateralJoinTable,\n  type ParsedFindQuery,\n  getTables,\n} from \"src/queries/find/QueryParser.ts\";\nimport { AliasAssigner } from \"src/queries/sql/AliasAssigner.ts\";\nimport { kq, kqDot } from \"src/queries/sql/keywords.ts\";\nimport { type RowData } from \"src/RowData.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/**\n * A PreloadPlugin implementation that uses `CROSS LATERAL JOIN` and `json_aggregate`\n * to preload/reduce a subtree of data while still being a single row of data.\n */\nexport class JsonAggregatePreloader implements PreloadPlugin {\n  partitionHint(\n    meta: EntityMetadata | undefined,\n    hint: LoadHint<any>,\n  ): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined] {\n    return partitionHint(meta, hint);\n  }\n\n  addPreloading<T extends Entity>(\n    meta: EntityMetadata,\n    root: HintNode<T>,\n    query: ParsedFindQuery,\n  ): PreloadHydrator | undefined {\n    const assigner = new AliasAssigner(query);\n\n    // Get the existing primary alias\n    const alias = getTables(query)[0].alias;\n    const joins = calcLateralJoins(assigner, { tree: root, alias, meta }, root, alias, meta);\n    // If there are no sql-based preload in the hints, just return\n    if (joins.length === 0) return undefined;\n\n    // Include the aggregate `_b1._ as _prequel`, `_c._ as _randomComment`\n    for (const { alias, relationAlias, join } of joins) {\n      query.selects.push({\n        sql: `${kqDot(alias, \"_\")} as ${kq(relationAlias)}`,\n        aliases: [alias],\n        bindings: [],\n      });\n      query.tables.push(join);\n    }\n\n    return (rows, entities) => {\n      for (let i = 0; i < entities.length; i++) {\n        const parent = entities[i];\n        for (const { relationAlias, hydrator } of joins) {\n          hydrator(parent, parent, readRowValue(rows, i, relationAlias) ?? []);\n        }\n      }\n    };\n  }\n\n  getPreloadJoins<T extends Entity>(meta: EntityMetadata, root: HintNode<T>, query: ParsedFindQuery): JoinResult[] {\n    const assigner = new AliasAssigner(query);\n\n    // Get the existing primary alias\n    const alias = getTables(query)[0].alias;\n    const joins = calcLateralJoins(assigner, { tree: root, alias, meta }, root, alias, meta);\n    // If there are no sql-based preload in the hints, just return\n\n    // Adapt our json aggregate joins to the higher-level JoinResult\n    return joins.map((join) => {\n      return {\n        selects: [{ value: kqDot(join.alias, \"_\"), as: join.relationAlias }],\n        join: join.join,\n        hydrator: (rows, entities) => {\n          for (let i = 0; i < entities.length; i++) {\n            const parent = entities[i];\n            join.hydrator(parent, parent, readRowValue(rows, i, join.relationAlias) ?? []);\n          }\n        },\n      };\n    });\n  }\n}\n\n/** Decodes an array-of-arrays of children entries, and stores them the `parent`'s relation. */\ntype AggregateJsonHydrator = (root: Entity, parent: Entity, arrays: unknown[][]) => void;\n\n/**\n * For a given hint tree `hint`, finds all SQL-able relations and preloads them.\n *\n * Specifically we use `json_agg` & `json_build_array` to `CROSS LATERAL JOIN`\n * children/grand children back as arbitrarily-deeply nested arrays, and then\n * stash the results in the `EntityManager` `joinLoadedRelations` cache, which\n * each join-instrumented relation will check before making its SQL calls.\n *\n * https://sqlfum.pt/?n=60&indent=2&spaces=1&simplify=1&align=0&case=lower&sql=c2VsZWN0IGEuaWQsIGIuXyBhcyBiLCBjMS5fIGFzIGMxLCBhMS5fIGFzIGExIGZyb20gYXV0aG9ycyBhIGNyb3NzIGpvaW4gbGF0ZXJhbCAoIHNlbGVjdCBqc29uX2FnZyhqc29uX2J1aWxkX2FycmF5KGIuaWQsIGIudGl0bGUsIGIuIm9yZGVyIiwgYi5kZWxldGVkX2F0LCBiLmNyZWF0ZWRfYXQsIGIudXBkYXRlZF9hdCwgYi5hdXRob3JfaWQsIGJyLl8pKSBhcyBfIGZyb20gYm9va3MgYiBjcm9zcyBqb2luIGxhdGVyYWwgKCBzZWxlY3QganNvbl9hZ2coanNvbl9idWlsZF9hcnJheShici5pZCwgYnIucmF0aW5nLCBici5pc19wdWJsaWMsIGJyLmlzX3Rlc3QsIGJyLmNyZWF0ZWRfYXQsIGJyLnVwZGF0ZWRfYXQsIGJyLmJvb2tfaWQsIGMuXykpIGFzIF8gZnJvbSBib29rX3Jldmlld3MgYnIgY3Jvc3Mgam9pbiBsYXRlcmFsICggc2VsZWN0IGpzb25fYWdnKGpzb25fYnVpbGRfYXJyYXkoYy5pZCwgYy50ZXh0LCBjLmNyZWF0ZWRfYXQsIGMudXBkYXRlZF9hdCwgYy51c2VyX2lkLCBjLnBhcmVudF9hdXRob3JfaWQsIGMucGFyZW50X2Jvb2tfaWQsIGMucGFyZW50X2Jvb2tfcmV2aWV3X2lkLCBjLnBhcmVudF9wdWJsaXNoZXJfaWQpKSBhcyBfIGZyb20gY29tbWVudHMgYyB3aGVyZSBjLnBhcmVudF9ib29rX3Jldmlld19pZCA9IGJyLmlkICkgYyB3aGVyZSBici5ib29rX2lkID0gYi5pZCApIGJyIHdoZXJlIGIuYXV0aG9yX2lkID0gYS5pZCApIGIgY3Jvc3Mgam9pbiBsYXRlcmFsICggc2VsZWN0IGpzb25fYWdnKGpzb25fYnVpbGRfYXJyYXkoYzEuaWQsIGMxLnRleHQsIGMxLmNyZWF0ZWRfYXQsIGMxLnVwZGF0ZWRfYXQsIGMxLnVzZXJfaWQsIGMxLnBhcmVudF9hdXRob3JfaWQsIGMxLnBhcmVudF9ib29rX2lkLCBjMS5wYXJlbnRfYm9va19yZXZpZXdfaWQsIGMxLnBhcmVudF9wdWJsaXNoZXJfaWQpKSBhcyBfIGZyb20gY29tbWVudHMgYzEgd2hlcmUgYzEucGFyZW50X2F1dGhvcl9pZCA9IGEuaWQgKSBjMSBjcm9zcyBqb2luIGxhdGVyYWwgKCBzZWxlY3QganNvbl9hZ2coanNvbl9idWlsZF9hcnJheShhMS5pZCwgYTEuZmlyc3RfbmFtZSwgYTEubGFzdF9uYW1lLCBhMS5zc24sIGExLmluaXRpYWxzLCBhMS5udW1iZXJfb2ZfYm9va3MsIGExLmJvb2tfY29tbWVudHMsIGExLmlzX3BvcHVsYXIsIGExLmFnZSwgYTEuZ3JhZHVhdGVkLCBhMS5uaWNrX25hbWVzLCBhMS53YXNfZXZlcl9wb3B1bGFyLCBhMS5hZGRyZXNzLCBhMS5idXNpbmVzc19hZGRyZXNzLCBhMS5xdW90ZXMsIGExLm51bWJlcl9vZl9hdG9tcywgYTEuZGVsZXRlZF9hdCwgYTEubnVtYmVyX29mX3B1YmxpY19yZXZpZXdzLCBhMS4ibnVtYmVyT2ZQdWJsaWNSZXZpZXdzMiIsIGExLnRhZ3Nfb2ZfYWxsX2Jvb2tzLCBhMS5jcmVhdGVkX2F0LCBhMS51cGRhdGVkX2F0LCBhMS5mYXZvcml0ZV9zaGFwZSwgYTEuZmF2b3JpdGVfY29sb3JzLCBhMS5tZW50b3JfaWQsIGExLmN1cnJlbnRfZHJhZnRfYm9va19pZCwgYTEuZmF2b3JpdGVfYm9va19pZCwgYTEucHVibGlzaGVyX2lkKSkgYXMgXyBmcm9tIGF1dGhvcnMgYTEgd2hlcmUgYTEuaWQgPSBhLm1lbnRvcl9pZCApIGExIHdoZXJlIGEuaWQgPSAxOw%3D%3D\n */\n\n/**\n * Given a `parent` like Author, and a hint of `{ books: ..., comments: ... }`, create `CROSS JOIN LATERAL`s\n * that will pull in the `books` & `comments` children.\n */\nfunction calcLateralJoins<I extends EntityOrId>(\n  assigner: AliasAssigner,\n  root: { tree: HintNode<I>; alias: string; meta: EntityMetadata },\n  tree: HintNode<I>,\n  parentAlias: string,\n  parentMeta: EntityMetadata,\n  pathPrefix: string = \"\",\n): AggregateJoinResult[] {\n  const results: AggregateJoinResult[] = [];\n\n  // Join in SQL-able hints from parent\n  Object.entries(tree.hints).forEach(([key, subTree]) => {\n    const field = parentMeta.allFields[key];\n    // AsyncProperties don't have fields, which is fine, skip for now...\n    if (field && canPreload(parentMeta, field)) {\n      // Enum m2ms have no \"other\" entity to join/hydrate; just aggregate the join table's enum ids.\n      if (field.kind === \"m2mEnum\") {\n        results.push(calcEnumLateralJoin(assigner, root, subTree, parentAlias, field, key, pathPrefix));\n        return;\n      }\n      const otherMeta = field.otherMetadata();\n      const otherField = otherMeta.allFields[field.otherFieldName];\n\n      // Short table alias for column refs inside the subquery, e.g. `_b1`\n      const otherAlias = `_${assigner.getAlias(otherMeta.tableName)}`;\n      // Readable path-based column alias for the outer AS clause, e.g. `_books_reviews`\n      const pathKey = key.toLowerCase();\n      const relationAlias = `_${assigner.getLiteralAlias(`${pathPrefix}${pathKey}`)}`;\n\n      // Do the recursion up-front, so we can work it into our own join/hydrator\n      const subJoins = calcLateralJoins(assigner, root, subTree, otherAlias, otherMeta, `${pathPrefix}${pathKey}_`);\n\n      // Get all fields with serdes and flatten out the columns, skipping `lazy` columns (fetched on-demand)\n      const columns = Object.values(otherMeta.allFields)\n        .filter((f) => f.serde && !(f.kind === \"primitive\" && f.lazy))\n        .flatMap((f) => f.serde!.columns);\n      const selects = [\n        ...columns.map((c) => kqDot(otherAlias, c.columnName)),\n        // We eventually need to handle parent types/subtypes here...\n        // Combine any grandchilden\n        ...subJoins.map((sb) => kqDot(sb.alias, \"_\")),\n      ];\n\n      const aliasMaybeSuffix = kq(`${parentAlias}${field.aliasSuffix}`);\n\n      const cb = new ConditionBuilder();\n      let m2mTable: JoinTable | undefined;\n      let m2mAlias: string | undefined;\n      if (otherField.kind === \"m2o\") {\n        cb.addRawCondition({\n          aliases: [otherAlias, parentAlias],\n          condition: `${kqDot(otherAlias, otherField.serde.columns[0].columnName)} = ${kqDot(parentAlias, \"id\")}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"poly\") {\n        // Get the component that points to us\n        // const comp = otherField.components.find((c) => getAllMetas(parentMeta).some((m) => m.cstr === c.otherMetadata().cstr)) ??\n        const comp =\n          otherField.components.find((c) => parentMeta.cstr === c.otherMetadata().cstr) ??\n          fail(`No component found for ${field.fieldName} -> ${otherField.fieldName}`);\n        cb.addRawCondition({\n          aliases: [otherAlias, parentAlias],\n          condition: `${kqDot(otherAlias, comp.columnName)} = ${kqDot(parentAlias, \"id\")}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"o2m\" || otherField.kind === \"lo2m\") {\n        cb.addRawCondition({\n          aliases: [otherAlias, aliasMaybeSuffix],\n          condition: `${kqDot(otherAlias, \"id\")} = ${aliasMaybeSuffix}.${kq(field.serde!.columns[0].columnName)}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"o2o\") {\n        cb.addRawCondition({\n          aliases: [otherAlias, aliasMaybeSuffix],\n          condition: `${kqDot(otherAlias, \"id\")} = ${aliasMaybeSuffix}.${kq(field.serde!.columns[0].columnName)}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"m2m\") {\n        m2mAlias = assigner.getAlias(otherField.joinTableName);\n        // Get the m2m row's id to track in JoinRows; id-less tables have no surrogate id.\n        if (otherField.hasJoinTableId) selects.unshift(kqDot(m2mAlias, \"id\"));\n        m2mTable = {\n          join: \"inner\",\n          table: otherField.joinTableName,\n          alias: m2mAlias,\n          col1: kqDot(parentAlias, \"id\"),\n          col2: kqDot(m2mAlias, otherField.columnNames[1]),\n        };\n        cb.addRawCondition({\n          aliases: [m2mAlias, otherAlias],\n          condition: `${kqDot(m2mAlias, otherField.columnNames[0])} = ${kqDot(otherAlias, \"id\")}`,\n          pruneable: true,\n        });\n      } else {\n        throw new Error(`Unsupported otherField.kind ${otherField.kind}`);\n      }\n\n      const needsSubSelect = subTree.entities.size !== root.tree.entities.size;\n      if (needsSubSelect) {\n        cb.addRawCondition({\n          aliases: [root.alias],\n          condition: `${kqDot(root.alias, \"id\")} = ANY(?)`,\n          bindings: [\n            [...subTree.entities]\n              .filter((e) => typeof e === \"string\" || !e.isNewEntity)\n              .map((e) => keyToNumber(root.meta, typeof e === \"string\" ? e : e.id)),\n          ],\n          pruneable: true,\n        });\n      }\n\n      // For m2m, order by the join-row's id so preloaded results match the order the lazy batch\n      // loader returns (which orders by join-row id). Id-less join tables have no surrogate id,\n      // so order by the other entity's FK column (matching the lazy loader & getOthers). Otherwise,\n      // order by the target entity's id.\n      const orderBy =\n        otherField.kind === \"m2m\" && !otherField.hasJoinTableId\n          ? `${kq(m2mAlias!)}.${kq(otherField.columnNames[0])}`\n          : `${kq(m2mAlias ?? otherAlias)}.id`;\n\n      const join: LateralJoinTable = {\n        join: \"lateral\",\n        alias: otherAlias,\n        // Do we need to say which alias we're coming from, to avoid having it pruned?\n        // ...maybe not because preloading is always on the primary table?\n        fromAlias: \"unset\",\n        table: otherMeta.tableName,\n        query: {\n          selects: [`json_agg(json_build_array(${selects.join(\", \")}) order by ${orderBy}) as _`],\n          tables: [\n            { join: \"primary\", table: otherMeta.tableName, alias: otherAlias },\n            ...(m2mTable ? [m2mTable] : []),\n            ...subJoins.map((sj) => sj.join),\n          ],\n          condition: cb.toExpressionFilter(),\n          orderBys: [],\n        },\n      };\n\n      // Pre-compute column names so we don't re-read them per entity\n      const columnNames = columns.map((c) => c.columnName);\n      // If we've snuck the m2m row id into the json array, ignore it (id-less tables have no id)\n      const m2mOffset = field.kind === \"m2m\" && field.hasJoinTableId ? 1 : 0;\n\n      const hydrator: AggregateJsonHydrator = (root, parent, arrays) => {\n        const { em } = root;\n\n        // If we had overlapping load hints, i.e. `author.books` for [a1, a2] and `author.comments` for [a1], and\n        // we're processing the arrays of comments, but for a root author like `a2` that didn't ask for our load\n        // hint, then skip it to keep the relation unloaded.\n        if (subTree.entitiesKind === \"instances\" && !subTree.entities.has(root as any)) return;\n        if (subTree.entitiesKind === \"ids\" && !subTree.entities.has(root.idTagged as any)) return;\n\n        // We get back an array of [[1, title], [2, title], [3, title]]\n        const children = arrays.map((array) => {\n          const taggedId = keyToTaggedId(otherMeta, array[m2mOffset] as any)!;\n          const row: Record<string, any> = {};\n          for (let i = 0; i < columns.length; i++) {\n            row[columnNames[i]] = columns[i].mapFromJsonAgg(array[m2mOffset + i]);\n          }\n          const entity =\n            em.findExistingInstance<Entity>(taggedId) ??\n            (em.hydrate(otherMeta.cstr, [row], { overwriteExisting: false }) as Entity[])[0];\n          // Tell the internal JoinRow booking-keeping about this m2m row\n          if (field.kind === \"m2m\") {\n            // TODO This `addExisting` needs to be pulled up, out of the `arrays.map`, so we can do a `loadRows`-ish\n            // call that passes all now-known m2m rows into JoinRows as a single list, so that it can mark any\n            // deleted-from-under-us m2m rows as deleted.\n            const m2m = (parent as any)[key];\n            getEmInternalApi(em)\n              .joinRows(m2m)\n              .addPreloadedRow(m2m, field.hasJoinTableId ? (array[0] as any) : undefined, parent, entity);\n          }\n          // Within each child, look for grandchildren\n          subJoins.forEach((sub, i) => {\n            // array[i] could be null if there are no grandchildren, but still call `sub` to\n            // process it so that we store the empty array into the em.joinLoadedRelations, to\n            // avoid the relation.load method later doing a SQL for rows we know are not there.\n            sub.hydrator(root, entity, (array[m2mOffset + columns.length + i] as any) ?? []);\n          });\n          return entity;\n        });\n        // Cache the entities so `.load`s will see them\n        getEmInternalApi(em).setPreloadedRelation(parent.idTagged, key, children);\n      };\n\n      results.push({ alias: otherAlias, relationAlias, join, hydrator });\n    }\n  });\n\n  return results;\n}\n\n/**\n * Builds the `CROSS JOIN LATERAL` that aggregates an enum-m2m join table (e.g. `publisher_logo_colors`)\n * into a json array of enum ids, e.g. `[[1], [3]]` (or `[[1, id], [3, id]]` for id-ful join tables).\n */\nfunction calcEnumLateralJoin<I extends EntityOrId>(\n  assigner: AliasAssigner,\n  root: { tree: HintNode<I>; alias: string; meta: EntityMetadata },\n  subTree: HintNode<I>,\n  parentAlias: string,\n  field: ManyToManyEnumField,\n  key: string,\n  pathPrefix: string,\n): AggregateJoinResult {\n  const [entityColumn, enumColumn] = field.columnNames;\n  const jtAlias = `_${assigner.getAlias(field.joinTableName)}`;\n  const relationAlias = `_${assigner.getLiteralAlias(`${pathPrefix}${key.toLowerCase()}`)}`;\n\n  const parts = [kqDot(jtAlias, enumColumn)];\n  if (field.hasJoinTableId) parts.push(kqDot(jtAlias, \"id\"));\n\n  const cb = new ConditionBuilder();\n  cb.addRawCondition({\n    aliases: [jtAlias, parentAlias],\n    condition: `${kqDot(jtAlias, entityColumn)} = ${kqDot(parentAlias, \"id\")}`,\n    pruneable: true,\n  });\n\n  const needsSubSelect = subTree.entities.size !== root.tree.entities.size;\n  if (needsSubSelect) {\n    cb.addRawCondition({\n      aliases: [root.alias],\n      condition: `${kqDot(root.alias, \"id\")} = ANY(?)`,\n      bindings: [\n        [...subTree.entities]\n          .filter((e) => typeof e === \"string\" || !e.isNewEntity)\n          .map((e) => keyToNumber(root.meta, typeof e === \"string\" ? e : e.id)),\n      ],\n      pruneable: true,\n    });\n  }\n\n  const orderBy = `${kq(jtAlias)}.${kq(field.hasJoinTableId ? \"id\" : enumColumn)}`;\n  const join: LateralJoinTable = {\n    join: \"lateral\",\n    alias: jtAlias,\n    fromAlias: \"unset\",\n    table: field.joinTableName,\n    query: {\n      selects: [`json_agg(json_build_array(${parts.join(\", \")}) order by ${orderBy}) as _`],\n      tables: [{ join: \"primary\", table: field.joinTableName, alias: jtAlias }],\n      condition: cb.toExpressionFilter(),\n      orderBys: [],\n    },\n  };\n\n  const hydrator: AggregateJsonHydrator = (root, parent, arrays) => {\n    const { em } = root;\n    if (subTree.entitiesKind === \"instances\" && !subTree.entities.has(root as any)) return;\n    if (subTree.entitiesKind === \"ids\" && !subTree.entities.has(root.idTagged as any)) return;\n    const like: ManyToManyLike = {\n      entity: parent,\n      joinTableName: field.joinTableName,\n      columnName: entityColumn,\n      otherColumnName: enumColumn,\n      fieldName: key,\n      meta: getMetadataForField(getMetadata(parent), key),\n      otherEnum: field.enumDetailType,\n      hasJoinTableId: field.hasJoinTableId,\n    };\n    const api = getEmInternalApi(em);\n    const joinRows = api.joinRows(like);\n    const codes: any[] = [];\n    for (const array of arrays) {\n      const enumId = array[0] as number;\n      joinRows.addPreloadedRow(like, field.hasJoinTableId ? (array[1] as number) : undefined, parent, enumId);\n      codes.push(field.enumDetailType.findById(enumId)!.code);\n    }\n    api.setPreloadedRelation(parent.idTagged, key, codes);\n  };\n\n  return { alias: jtAlias, relationAlias, join, hydrator };\n}\n\n/** A preload-loadable join for a given child, with potentially grand-child joins contained within it. */\ntype AggregateJoinResult = {\n  /** The short table alias used for column references inside the subquery, e.g. `_b1`. */\n  alias: string;\n  /** The readable relation-name alias used in the outer `AS` clause, e.g. `_prequel`. */\n  relationAlias: string;\n  /** The SQL for this child's lateral join, which itself might have recursive lateral joins. */\n  join: LateralJoinTable;\n  /** The hydrator for this child's lateral join, which itself might recursively hydrator subjoins. */\n  hydrator: AggregateJsonHydrator;\n};\n\n/** Reads one column from either classic POJO rows or a lazy `RowData` result. */\nfunction readRowValue(rows: any[] | RowData, rowIndex: number, columnName: string): any {\n  return Array.isArray(rows) ? rows[rowIndex][columnName] : rows.get(rowIndex, columnName);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,IAAa,yBAAb,MAA6D;CAC3D,cACE,MACA,MACoE;EACpE,OAAO,cAAc,MAAM,IAAI;CACjC;CAEA,cACE,MACA,MACA,OAC6B;EAC7B,MAAM,WAAW,IAAI,cAAc,KAAK;EAGxC,MAAM,QAAQ,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;EAClC,MAAM,QAAQ,iBAAiB,UAAU;GAAE,MAAM;GAAM;GAAO;EAAK,GAAG,MAAM,OAAO,IAAI;EAEvF,IAAI,MAAM,WAAW,GAAG,OAAO,KAAA;EAG/B,KAAK,MAAM,EAAE,OAAO,eAAe,UAAU,OAAO;GAClD,MAAM,QAAQ,KAAK;IACjB,KAAK,GAAG,MAAM,OAAO,GAAG,EAAE,MAAM,GAAG,aAAa;IAChD,SAAS,CAAC,KAAK;IACf,UAAU,CAAC;GACb,CAAC;GACD,MAAM,OAAO,KAAK,IAAI;EACxB;EAEA,QAAQ,MAAM,aAAa;GACzB,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;IACxC,MAAM,SAAS,SAAS;IACxB,KAAK,MAAM,EAAE,eAAe,cAAc,OACxC,SAAS,QAAQ,QAAQ,aAAa,MAAM,GAAG,aAAa,KAAK,CAAC,CAAC;GAEvE;EACF;CACF;CAEA,gBAAkC,MAAsB,MAAmB,OAAsC;EAC/G,MAAM,WAAW,IAAI,cAAc,KAAK;EAGxC,MAAM,QAAQ,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;EAKlC,OAJc,iBAAiB,UAAU;GAAE,MAAM;GAAM;GAAO;EAAK,GAAG,MAAM,OAAO,IAIxE,CAAC,CAAC,KAAK,SAAS;GACzB,OAAO;IACL,SAAS,CAAC;KAAE,OAAO,MAAM,KAAK,OAAO,GAAG;KAAG,IAAI,KAAK;IAAc,CAAC;IACnE,MAAM,KAAK;IACX,WAAW,MAAM,aAAa;KAC5B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;MACxC,MAAM,SAAS,SAAS;MACxB,KAAK,SAAS,QAAQ,QAAQ,aAAa,MAAM,GAAG,KAAK,aAAa,KAAK,CAAC,CAAC;KAC/E;IACF;GACF;EACF,CAAC;CACH;AACF;;;;;;;;;;;;;;;AAoBA,SAAS,iBACP,UACA,MACA,MACA,aACA,YACA,aAAqB,IACE;CACvB,MAAM,UAAiC,CAAC;CAGxC,OAAO,QAAQ,KAAK,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,aAAa;EACrD,MAAM,QAAQ,WAAW,UAAU;EAEnC,IAAI,SAAS,WAAW,YAAY,KAAK,GAAG;GAE1C,IAAI,MAAM,SAAS,WAAW;IAC5B,QAAQ,KAAK,oBAAoB,UAAU,MAAM,SAAS,aAAa,OAAO,KAAK,UAAU,CAAC;IAC9F;GACF;GACA,MAAM,YAAY,MAAM,cAAc;GACtC,MAAM,aAAa,UAAU,UAAU,MAAM;GAG7C,MAAM,aAAa,IAAI,SAAS,SAAS,UAAU,SAAS;GAE5D,MAAM,UAAU,IAAI,YAAY;GAChC,MAAM,gBAAgB,IAAI,SAAS,gBAAgB,GAAG,aAAa,SAAS;GAG5E,MAAM,WAAW,iBAAiB,UAAU,MAAM,SAAS,YAAY,WAAW,GAAG,aAAa,QAAQ,EAAE;GAG5G,MAAM,UAAU,OAAO,OAAO,UAAU,SAAS,CAAC,CAC/C,QAAQ,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,eAAe,EAAE,KAAK,CAAC,CAC7D,SAAS,MAAM,EAAE,MAAO,OAAO;GAClC,MAAM,UAAU,CACd,GAAG,QAAQ,KAAK,MAAM,MAAM,YAAY,EAAE,UAAU,CAAC,GAGrD,GAAG,SAAS,KAAK,OAAO,MAAM,GAAG,OAAO,GAAG,CAAC,CAC9C;GAEA,MAAM,mBAAmB,GAAG,GAAG,cAAc,MAAM,aAAa;GAEhE,MAAM,KAAK,IAAI,iBAAiB;GAChC,IAAI;GACJ,IAAI;GACJ,IAAI,WAAW,SAAS,OACtB,GAAG,gBAAgB;IACjB,SAAS,CAAC,YAAY,WAAW;IACjC,WAAW,GAAG,MAAM,YAAY,WAAW,MAAM,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,MAAM,aAAa,IAAI;IACpG,WAAW;GACb,CAAC;QACI,IAAI,WAAW,SAAS,QAAQ;IAGrC,MAAM,OACJ,WAAW,WAAW,MAAM,MAAM,WAAW,SAAS,EAAE,cAAc,CAAC,CAAC,IAAI,KAC5E,KAAK,0BAA0B,MAAM,UAAU,MAAM,WAAW,WAAW;IAC7E,GAAG,gBAAgB;KACjB,SAAS,CAAC,YAAY,WAAW;KACjC,WAAW,GAAG,MAAM,YAAY,KAAK,UAAU,EAAE,KAAK,MAAM,aAAa,IAAI;KAC7E,WAAW;IACb,CAAC;GACH,OAAO,IAAI,WAAW,SAAS,SAAS,WAAW,SAAS,QAC1D,GAAG,gBAAgB;IACjB,SAAS,CAAC,YAAY,gBAAgB;IACtC,WAAW,GAAG,MAAM,YAAY,IAAI,EAAE,KAAK,iBAAiB,GAAG,GAAG,MAAM,MAAO,QAAQ,EAAE,CAAC,UAAU;IACpG,WAAW;GACb,CAAC;QACI,IAAI,WAAW,SAAS,OAC7B,GAAG,gBAAgB;IACjB,SAAS,CAAC,YAAY,gBAAgB;IACtC,WAAW,GAAG,MAAM,YAAY,IAAI,EAAE,KAAK,iBAAiB,GAAG,GAAG,MAAM,MAAO,QAAQ,EAAE,CAAC,UAAU;IACpG,WAAW;GACb,CAAC;QACI,IAAI,WAAW,SAAS,OAAO;IACpC,WAAW,SAAS,SAAS,WAAW,aAAa;IAErD,IAAI,WAAW,gBAAgB,QAAQ,QAAQ,MAAM,UAAU,IAAI,CAAC;IACpE,WAAW;KACT,MAAM;KACN,OAAO,WAAW;KAClB,OAAO;KACP,MAAM,MAAM,aAAa,IAAI;KAC7B,MAAM,MAAM,UAAU,WAAW,YAAY,EAAE;IACjD;IACA,GAAG,gBAAgB;KACjB,SAAS,CAAC,UAAU,UAAU;KAC9B,WAAW,GAAG,MAAM,UAAU,WAAW,YAAY,EAAE,EAAE,KAAK,MAAM,YAAY,IAAI;KACpF,WAAW;IACb,CAAC;GACH,OACE,MAAM,IAAI,MAAM,+BAA+B,WAAW,MAAM;GAIlE,IADuB,QAAQ,SAAS,SAAS,KAAK,KAAK,SAAS,MAElE,GAAG,gBAAgB;IACjB,SAAS,CAAC,KAAK,KAAK;IACpB,WAAW,GAAG,MAAM,KAAK,OAAO,IAAI,EAAE;IACtC,UAAU,CACR,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAClB,QAAQ,MAAM,OAAO,MAAM,YAAY,CAAC,EAAE,WAAW,CAAC,CACtD,KAAK,MAAM,YAAY,KAAK,MAAM,OAAO,MAAM,WAAW,IAAI,EAAE,EAAE,CAAC,CACxE;IACA,WAAW;GACb,CAAC;GAOH,MAAM,UACJ,WAAW,SAAS,SAAS,CAAC,WAAW,iBACrC,GAAG,GAAG,QAAS,EAAE,GAAG,GAAG,WAAW,YAAY,EAAE,MAChD,GAAG,GAAG,YAAY,UAAU,EAAE;GAEpC,MAAM,OAAyB;IAC7B,MAAM;IACN,OAAO;IAGP,WAAW;IACX,OAAO,UAAU;IACjB,OAAO;KACL,SAAS,CAAC,6BAA6B,QAAQ,KAAK,IAAI,EAAE,aAAa,QAAQ,OAAO;KACtF,QAAQ;MACN;OAAE,MAAM;OAAW,OAAO,UAAU;OAAW,OAAO;MAAW;MACjE,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAC;MAC7B,GAAG,SAAS,KAAK,OAAO,GAAG,IAAI;KACjC;KACA,WAAW,GAAG,mBAAmB;KACjC,UAAU,CAAC;IACb;GACF;GAGA,MAAM,cAAc,QAAQ,KAAK,MAAM,EAAE,UAAU;GAEnD,MAAM,YAAY,MAAM,SAAS,SAAS,MAAM,iBAAiB,IAAI;GAErE,MAAM,YAAmC,MAAM,QAAQ,WAAW;IAChE,MAAM,EAAE,OAAO;IAKf,IAAI,QAAQ,iBAAiB,eAAe,CAAC,QAAQ,SAAS,IAAI,IAAW,GAAG;IAChF,IAAI,QAAQ,iBAAiB,SAAS,CAAC,QAAQ,SAAS,IAAI,KAAK,QAAe,GAAG;IAGnF,MAAM,WAAW,OAAO,KAAK,UAAU;KACrC,MAAM,WAAW,cAAc,WAAW,MAAM,UAAiB;KACjE,MAAM,MAA2B,CAAC;KAClC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,IAAI,YAAY,MAAM,QAAQ,EAAE,CAAC,eAAe,MAAM,YAAY,EAAE;KAEtE,MAAM,SACJ,GAAG,qBAA6B,QAAQ,KACvC,GAAG,QAAQ,UAAU,MAAM,CAAC,GAAG,GAAG,EAAE,mBAAmB,MAAM,CAAC,CAAC,CAAc;KAEhF,IAAI,MAAM,SAAS,OAAO;MAIxB,MAAM,MAAO,OAAe;MAC5B,iBAAiB,EAAE,CAAC,CACjB,SAAS,GAAG,CAAC,CACb,gBAAgB,KAAK,MAAM,iBAAkB,MAAM,KAAa,KAAA,GAAW,QAAQ,MAAM;KAC9F;KAEA,SAAS,SAAS,KAAK,MAAM;MAI3B,IAAI,SAAS,MAAM,QAAS,MAAM,YAAY,QAAQ,SAAS,MAAc,CAAC,CAAC;KACjF,CAAC;KACD,OAAO;IACT,CAAC;IAED,iBAAiB,EAAE,CAAC,CAAC,qBAAqB,OAAO,UAAU,KAAK,QAAQ;GAC1E;GAEA,QAAQ,KAAK;IAAE,OAAO;IAAY;IAAe;IAAM;GAAS,CAAC;EACnE;CACF,CAAC;CAED,OAAO;AACT;;;;;AAMA,SAAS,oBACP,UACA,MACA,SACA,aACA,OACA,KACA,YACqB;CACrB,MAAM,CAAC,cAAc,cAAc,MAAM;CACzC,MAAM,UAAU,IAAI,SAAS,SAAS,MAAM,aAAa;CACzD,MAAM,gBAAgB,IAAI,SAAS,gBAAgB,GAAG,aAAa,IAAI,YAAY,GAAG;CAEtF,MAAM,QAAQ,CAAC,MAAM,SAAS,UAAU,CAAC;CACzC,IAAI,MAAM,gBAAgB,MAAM,KAAK,MAAM,SAAS,IAAI,CAAC;CAEzD,MAAM,KAAK,IAAI,iBAAiB;CAChC,GAAG,gBAAgB;EACjB,SAAS,CAAC,SAAS,WAAW;EAC9B,WAAW,GAAG,MAAM,SAAS,YAAY,EAAE,KAAK,MAAM,aAAa,IAAI;EACvE,WAAW;CACb,CAAC;CAGD,IADuB,QAAQ,SAAS,SAAS,KAAK,KAAK,SAAS,MAElE,GAAG,gBAAgB;EACjB,SAAS,CAAC,KAAK,KAAK;EACpB,WAAW,GAAG,MAAM,KAAK,OAAO,IAAI,EAAE;EACtC,UAAU,CACR,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAClB,QAAQ,MAAM,OAAO,MAAM,YAAY,CAAC,EAAE,WAAW,CAAC,CACtD,KAAK,MAAM,YAAY,KAAK,MAAM,OAAO,MAAM,WAAW,IAAI,EAAE,EAAE,CAAC,CACxE;EACA,WAAW;CACb,CAAC;CAGH,MAAM,UAAU,GAAG,GAAG,OAAO,EAAE,GAAG,GAAG,MAAM,iBAAiB,OAAO,UAAU;CAC7E,MAAM,OAAyB;EAC7B,MAAM;EACN,OAAO;EACP,WAAW;EACX,OAAO,MAAM;EACb,OAAO;GACL,SAAS,CAAC,6BAA6B,MAAM,KAAK,IAAI,EAAE,aAAa,QAAQ,OAAO;GACpF,QAAQ,CAAC;IAAE,MAAM;IAAW,OAAO,MAAM;IAAe,OAAO;GAAQ,CAAC;GACxE,WAAW,GAAG,mBAAmB;GACjC,UAAU,CAAC;EACb;CACF;CAEA,MAAM,YAAmC,MAAM,QAAQ,WAAW;EAChE,MAAM,EAAE,OAAO;EACf,IAAI,QAAQ,iBAAiB,eAAe,CAAC,QAAQ,SAAS,IAAI,IAAW,GAAG;EAChF,IAAI,QAAQ,iBAAiB,SAAS,CAAC,QAAQ,SAAS,IAAI,KAAK,QAAe,GAAG;EACnF,MAAM,OAAuB;GAC3B,QAAQ;GACR,eAAe,MAAM;GACrB,YAAY;GACZ,iBAAiB;GACjB,WAAW;GACX,MAAM,oBAAoB,YAAY,MAAM,GAAG,GAAG;GAClD,WAAW,MAAM;GACjB,gBAAgB,MAAM;EACxB;EACA,MAAM,MAAM,iBAAiB,EAAE;EAC/B,MAAM,WAAW,IAAI,SAAS,IAAI;EAClC,MAAM,QAAe,CAAC;EACtB,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,SAAS,MAAM;GACrB,SAAS,gBAAgB,MAAM,MAAM,iBAAkB,MAAM,KAAgB,KAAA,GAAW,QAAQ,MAAM;GACtG,MAAM,KAAK,MAAM,eAAe,SAAS,MAAM,CAAC,CAAE,IAAI;EACxD;EACA,IAAI,qBAAqB,OAAO,UAAU,KAAK,KAAK;CACtD;CAEA,OAAO;EAAE,OAAO;EAAS;EAAe;EAAM;CAAS;AACzD;;AAeA,SAAS,aAAa,MAAuB,UAAkB,YAAyB;CACtF,OAAO,MAAM,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC,cAAc,KAAK,IAAI,UAAU,UAAU;AACzF"}

package/build/preloading/canPreload.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../EntityMetadata.cjs");
+//#region src/preloading/canPreload.ts
+function canPreload(meta, field) {
+	if (field.kind === "m2mEnum") return true;
+	if (field.kind === "o2m" || field.kind === "o2o" || field.kind === "m2o" || field.kind === "m2m") {
+		const otherMeta = field.otherMetadata();
+		if (!!otherMeta.baseType || otherMeta.subTypes.length > 0) return false;
+		const otherField = otherMeta.allFields[field.otherFieldName];
+		if (!otherField) return false;
+		if (otherField.kind === "poly" && !otherField.components.some((c) => c.otherMetadata() === meta)) return false;
+		return true;
+	}
+	return false;
+}
+//#endregion
+exports.canPreload = canPreload;
+
+//# sourceMappingURL=canPreload.cjs.map

package/build/preloading/canPreload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"canPreload.cjs","names":[],"sources":["../../src/preloading/canPreload.ts"],"sourcesContent":["import {\n  type EntityMetadata,\n  type Field,\n  type ManyToManyEnumField,\n  type ManyToManyField,\n  type ManyToOneField,\n  type OneToManyField,\n  type OneToOneField,\n} from \"src/EntityMetadata.ts\";\n\nexport function canPreload(\n  meta: EntityMetadata,\n  field: Field,\n): field is OneToManyField | ManyToOneField | ManyToManyField | ManyToManyEnumField | OneToOneField {\n  // Enum m2ms have no \"other\" entity table (the join target is an enum), so they're always preloadable.\n  if (field.kind === \"m2mEnum\") return true;\n  if (field.kind === \"o2m\" || field.kind === \"o2o\" || field.kind === \"m2o\" || field.kind === \"m2m\") {\n    const otherMeta = field.otherMetadata();\n    // We don't support preloading tables with inheritance yet\n    if (!!otherMeta.baseType || otherMeta.subTypes.length > 0) return false;\n    // If `otherField` is missing, this could be a large collection which currently can't be loaded...\n    const otherField = otherMeta.allFields[field.otherFieldName];\n    if (!otherField) return false;\n    // If otherField is a poly that points to a sub/base component, we don't support that yet\n    if (otherField.kind === \"poly\" && !otherField.components.some((c) => c.otherMetadata() === meta)) return false;\n    return true;\n  }\n  return false;\n}\n"],"mappings":";;;AAUA,SAAgB,WACd,MACA,OACkG;CAElG,IAAI,MAAM,SAAS,WAAW,OAAO;CACrC,IAAI,MAAM,SAAS,SAAS,MAAM,SAAS,SAAS,MAAM,SAAS,SAAS,MAAM,SAAS,OAAO;EAChG,MAAM,YAAY,MAAM,cAAc;EAEtC,IAAI,CAAC,CAAC,UAAU,YAAY,UAAU,SAAS,SAAS,GAAG,OAAO;EAElE,MAAM,aAAa,UAAU,UAAU,MAAM;EAC7C,IAAI,CAAC,YAAY,OAAO;EAExB,IAAI,WAAW,SAAS,UAAU,CAAC,WAAW,WAAW,MAAM,MAAM,EAAE,cAAc,MAAM,IAAI,GAAG,OAAO;EACzG,OAAO;CACT;CACA,OAAO;AACT"}

package/build/preloading/canPreload.d.cts

@@ -0,0 +1,6 @@
+import { EntityMetadata, Field, ManyToManyEnumField, ManyToManyField, ManyToOneField, OneToManyField, OneToOneField } from "../EntityMetadata.cjs";
+//#region src/preloading/canPreload.d.ts
+declare function canPreload(meta: EntityMetadata, field: Field): field is OneToManyField | ManyToOneField | ManyToManyField | ManyToManyEnumField | OneToOneField;
+//#endregion
+export { canPreload };
+//# sourceMappingURL=canPreload.d.cts.map

package/build/preloading/canPreload.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canPreload.d.cts","names":[],"sources":["../../src/preloading/canPreload.ts"],"mappings":";;iBAUgB,WACd,MAAM,gBACN,OAAO,QACN,SAAS,iBAAiB,iBAAiB,kBAAkB,sBAAsB"}

package/build/preloading/canPreload.d.mts

@@ -0,0 +1,6 @@
+import { EntityMetadata, Field, ManyToManyEnumField, ManyToManyField, ManyToOneField, OneToManyField, OneToOneField } from "../EntityMetadata.mjs";
+//#region src/preloading/canPreload.d.ts
+declare function canPreload(meta: EntityMetadata, field: Field): field is OneToManyField | ManyToOneField | ManyToManyField | ManyToManyEnumField | OneToOneField;
+//#endregion
+export { canPreload };
+//# sourceMappingURL=canPreload.d.mts.map

package/build/preloading/canPreload.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canPreload.d.mts","names":[],"sources":["../../src/preloading/canPreload.ts"],"mappings":";;iBAUgB,WACd,MAAM,gBACN,OAAO,QACN,SAAS,iBAAiB,iBAAiB,kBAAkB,sBAAsB"}

package/build/preloading/canPreload.js

@@ -1,24 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.canPreload = canPreload;
+import "../EntityMetadata.js";
+//#region src/preloading/canPreload.ts
 function canPreload(meta, field) {
-    // Enum m2ms have no "other" entity table (the join target is an enum), so they're always preloadable.
-    if (field.kind === "m2mEnum")
-        return true;
-    if (field.kind === "o2m" || field.kind === "o2o" || field.kind === "m2o" || field.kind === "m2m") {
-        const otherMeta = field.otherMetadata();
-        // We don't support preloading tables with inheritance yet
-        if (!!otherMeta.baseType || otherMeta.subTypes.length > 0)
-            return false;
-        // If `otherField` is missing, this could be a large collection which currently can't be loaded...
-        const otherField = otherMeta.allFields[field.otherFieldName];
-        if (!otherField)
-            return false;
-        // If otherField is a poly that points to a sub/base component, we don't support that yet
-        if (otherField.kind === "poly" && !otherField.components.some((c) => c.otherMetadata() === meta))
-            return false;
-        return true;
-    }
-    return false;
+	if (field.kind === "m2mEnum") return true;
+	if (field.kind === "o2m" || field.kind === "o2o" || field.kind === "m2o" || field.kind === "m2m") {
+		const otherMeta = field.otherMetadata();
+		if (!!otherMeta.baseType || otherMeta.subTypes.length > 0) return false;
+		const otherField = otherMeta.allFields[field.otherFieldName];
+		if (!otherField) return false;
+		if (otherField.kind === "poly" && !otherField.components.some((c) => c.otherMetadata() === meta)) return false;
+		return true;
+	}
+	return false;
 }
+//#endregion
+export { canPreload };
+
 //# sourceMappingURL=canPreload.js.map

package/build/preloading/canPreload.js.map

@@ -1 +1 @@
-{"version":3,"file":"canPreload.js","sourceRoot":"","sources":["../../src/preloading/canPreload.ts"],"names":[],"mappings":";;AAUA,gCAkBC;AAlBD,SAAgB,UAAU,CACxB,IAAoB,EACpB,KAAY;IAEZ,sGAAsG;IACtG,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjG,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QACxC,0DAA0D;QAC1D,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACxE,kGAAkG;QAClG,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9B,yFAAyF;QACzF,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,KAAK,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/G,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"canPreload.js","names":[],"sources":["../../src/preloading/canPreload.ts"],"sourcesContent":["import {\n  type EntityMetadata,\n  type Field,\n  type ManyToManyEnumField,\n  type ManyToManyField,\n  type ManyToOneField,\n  type OneToManyField,\n  type OneToOneField,\n} from \"src/EntityMetadata.ts\";\n\nexport function canPreload(\n  meta: EntityMetadata,\n  field: Field,\n): field is OneToManyField | ManyToOneField | ManyToManyField | ManyToManyEnumField | OneToOneField {\n  // Enum m2ms have no \"other\" entity table (the join target is an enum), so they're always preloadable.\n  if (field.kind === \"m2mEnum\") return true;\n  if (field.kind === \"o2m\" || field.kind === \"o2o\" || field.kind === \"m2o\" || field.kind === \"m2m\") {\n    const otherMeta = field.otherMetadata();\n    // We don't support preloading tables with inheritance yet\n    if (!!otherMeta.baseType || otherMeta.subTypes.length > 0) return false;\n    // If `otherField` is missing, this could be a large collection which currently can't be loaded...\n    const otherField = otherMeta.allFields[field.otherFieldName];\n    if (!otherField) return false;\n    // If otherField is a poly that points to a sub/base component, we don't support that yet\n    if (otherField.kind === \"poly\" && !otherField.components.some((c) => c.otherMetadata() === meta)) return false;\n    return true;\n  }\n  return false;\n}\n"],"mappings":";;AAUA,SAAgB,WACd,MACA,OACkG;CAElG,IAAI,MAAM,SAAS,WAAW,OAAO;CACrC,IAAI,MAAM,SAAS,SAAS,MAAM,SAAS,SAAS,MAAM,SAAS,SAAS,MAAM,SAAS,OAAO;EAChG,MAAM,YAAY,MAAM,cAAc;EAEtC,IAAI,CAAC,CAAC,UAAU,YAAY,UAAU,SAAS,SAAS,GAAG,OAAO;EAElE,MAAM,aAAa,UAAU,UAAU,MAAM;EAC7C,IAAI,CAAC,YAAY,OAAO;EAExB,IAAI,WAAW,SAAS,UAAU,CAAC,WAAW,WAAW,MAAM,MAAM,EAAE,cAAc,MAAM,IAAI,GAAG,OAAO;EACzG,OAAO;CACT;CACA,OAAO;AACT"}

package/build/preloading/partitionHint.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_normalizeHints = require("../normalizeHints.cjs");
+const require_relations_ReactiveReference = require("../relations/ReactiveReference.cjs");
+require("../relations/index.cjs");
+const require_getProperties = require("../getProperties.cjs");
+require("../EntityMetadata.cjs");
+const require_preloading_canPreload = require("./canPreload.cjs");
+//#region src/preloading/partitionHint.ts
+/** Partitions a hint into SQL-able and non-SQL-able hints. */
+function partitionHint(meta, hint) {
+	let sql = void 0;
+	let non = void 0;
+	for (const [key, subHint] of Object.entries(require_normalizeHints.normalizeHint(hint))) {
+		const field = meta?.allFields[key];
+		if (field && require_preloading_canPreload.canPreload(meta, field)) {
+			if (field.kind === "m2mEnum") (sql ??= {})[key] ??= {};
+			else {
+				const [_sql, _non] = partitionHint(field.otherMetadata(), subHint);
+				deepMerge((sql ??= {})[key] ??= {}, _sql ?? {});
+				if (_non) deepMerge((non ??= {})[key] ??= {}, _non);
+			}
+		} else {
+			const p = meta && require_getProperties.getProperties(meta)[key];
+			if (p && p.loadHint) {
+				if (p instanceof require_relations_ReactiveReference.ReactiveReferenceImpl) {
+					const [_sql, _non] = partitionHint(p.otherMeta, subHint);
+					deepMerge((sql ??= {})[key] ??= {}, _sql ?? {});
+					if (_non) deepMerge((non ??= {})[key] ??= {}, _non);
+					continue;
+				}
+			}
+			deepMerge((non ??= {})[key] ??= {}, require_normalizeHints.deepNormalizeHint(subHint));
+		}
+	}
+	return [sql, non];
+}
+function deepMerge(a, b) {
+	for (const [key, value] of Object.entries(b)) deepMerge(a[key] ??= {}, value);
+}
+//#endregion
+exports.partitionHint = partitionHint;
+
+//# sourceMappingURL=partitionHint.cjs.map

package/build/preloading/partitionHint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitionHint.cjs","names":["normalizeHint","canPreload","getProperties","ReactiveReferenceImpl","deepNormalizeHint"],"sources":["../../src/preloading/partitionHint.ts"],"sourcesContent":["import { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { getProperties } from \"src/getProperties.ts\";\nimport type { LoadHint, NestedLoadHint } from \"src/loading/loadHints.ts\";\nimport { deepNormalizeHint, normalizeHint } from \"src/normalizeHints.ts\";\nimport { canPreload } from \"src/preloading/canPreload.ts\";\nimport { ReactiveReferenceImpl } from \"src/relations/index.ts\";\n\n/** Partitions a hint into SQL-able and non-SQL-able hints. */\nexport function partitionHint(\n  meta: EntityMetadata | undefined,\n  hint: LoadHint<any>,\n): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined] {\n  let sql: NestedLoadHint<any> | undefined = undefined;\n  let non: NestedLoadHint<any> | undefined = undefined;\n  for (const [key, subHint] of Object.entries(normalizeHint(hint))) {\n    const field = meta?.allFields[key];\n    if (field && canPreload(meta!, field)) {\n      if (field.kind === \"m2mEnum\") {\n        // Enum m2ms are a leaf relation (enum codes have no sub-hint to recurse into).\n        (sql ??= {})[key] ??= {};\n      } else {\n        const [_sql, _non] = partitionHint(field.otherMetadata(), subHint);\n        deepMerge(((sql ??= {})[key] ??= {}), _sql ?? {});\n        if (_non) deepMerge(((non ??= {})[key] ??= {}), _non);\n      }\n    } else {\n      // If this isn't a raw SQL relation, but it exposes a load-hint, inline that into our SQL.\n      // This will get the non-SQL relation's underlying SQL data preloaded.\n      const p = meta && getProperties(meta)[key];\n      if (p && p.loadHint) {\n        // Maybe we could have `PersistedAsyncReferenceImpl` internally/dynamically return us the right\n        // load hint, instead of special casing it like this? Like it could internally check \"needs calc?\"\n        if (p instanceof ReactiveReferenceImpl) {\n          // Instead of using p.loadHint, we'll just follow the FK in the database and go to the subHint\n          const [_sql, _non] = partitionHint(p.otherMeta, subHint);\n          deepMerge(((sql ??= {})[key] ??= {}), _sql ?? {});\n          if (_non) deepMerge(((non ??= {})[key] ??= {}), _non);\n          continue;\n        } else {\n          // It's not clear what to do with the subHint here, if anything--ideally it could stitch\n          // on top of load hint but only in the places that made sense. But we'd risk over-fetching.\n          // ...also we don't want to preload ReactiveField full hint vs. just using their\n          // calculated values.\n          // const [_sql, _non] = partitionHint(meta, p.loadHint);\n          // if (_sql) deepMerge((sql ??= {}), _sql);\n          // if (_non) deepMerge((non ??= {}), _non);\n        }\n      }\n      // Even if we did some SQL preloads, the subHint needs to go through the non-sql path.\n      deepMerge(((non ??= {})[key] ??= {}), deepNormalizeHint(subHint));\n    }\n  }\n  return [sql, non];\n}\n\nfunction deepMerge<T extends object>(a: T, b: T): void {\n  for (const [key, value] of Object.entries(b)) {\n    deepMerge(((a as any)[key] ??= {}), value);\n  }\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,cACd,MACA,MACoE;CACpE,IAAI,MAAuC,KAAA;CAC3C,IAAI,MAAuC,KAAA;CAC3C,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQA,uBAAAA,cAAc,IAAI,CAAC,GAAG;EAChE,MAAM,QAAQ,MAAM,UAAU;EAC9B,IAAI,SAASC,8BAAAA,WAAW,MAAO,KAAK,GAAG;GACrC,IAAI,MAAM,SAAS,WAEjB,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC;QAClB;IACL,MAAM,CAAC,MAAM,QAAQ,cAAc,MAAM,cAAc,GAAG,OAAO;IACjE,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,IAAI;GACtD;EACF,OAAO;GAGL,MAAM,IAAI,QAAQC,sBAAAA,cAAc,IAAI,CAAC,CAAC;GACtC,IAAI,KAAK,EAAE,UAGL;QAAA,aAAaC,oCAAAA,uBAAuB;KAEtC,MAAM,CAAC,MAAM,QAAQ,cAAc,EAAE,WAAW,OAAO;KACvD,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,QAAQ,CAAC,CAAC;KAChD,IAAI,MAAM,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,IAAI;KACpD;IACF;;GAWF,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAIC,uBAAAA,kBAAkB,OAAO,CAAC;EAClE;CACF;CACA,OAAO,CAAC,KAAK,GAAG;AAClB;AAEA,SAAS,UAA4B,GAAM,GAAY;CACrD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,CAAC,GACzC,UAAW,EAAW,SAAS,CAAC,GAAI,KAAK;AAE7C"}

package/build/preloading/partitionHint.d.cts

@@ -0,0 +1,8 @@
+import { LoadHint, NestedLoadHint } from "../loading/loadHints.cjs";
+import { EntityMetadata } from "../EntityMetadata.cjs";
+//#region src/preloading/partitionHint.d.ts
+/** Partitions a hint into SQL-able and non-SQL-able hints. */
+declare function partitionHint(meta: EntityMetadata | undefined, hint: LoadHint<any>): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined];
+//#endregion
+export { partitionHint };
+//# sourceMappingURL=partitionHint.d.cts.map

package/build/preloading/partitionHint.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitionHint.d.cts","names":[],"sources":["../../src/preloading/partitionHint.ts"],"mappings":";;;;iBAQgB,cACd,MAAM,4BACN,MAAM,iBACJ,iCAAiC"}

package/build/preloading/partitionHint.d.mts

@@ -0,0 +1,8 @@
+import { LoadHint, NestedLoadHint } from "../loading/loadHints.mjs";
+import { EntityMetadata } from "../EntityMetadata.mjs";
+//#region src/preloading/partitionHint.d.ts
+/** Partitions a hint into SQL-able and non-SQL-able hints. */
+declare function partitionHint(meta: EntityMetadata | undefined, hint: LoadHint<any>): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined];
+//#endregion
+export { partitionHint };
+//# sourceMappingURL=partitionHint.d.mts.map

package/build/preloading/partitionHint.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitionHint.d.mts","names":[],"sources":["../../src/preloading/partitionHint.ts"],"mappings":";;;;iBAQgB,cACd,MAAM,4BACN,MAAM,iBACJ,iCAAiC"}

package/build/preloading/partitionHint.js

@@ -1,62 +1,42 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.partitionHint = partitionHint;
-const getProperties_1 = require("../getProperties");
-const normalizeHints_1 = require("../normalizeHints");
-const relations_1 = require("../relations");
-const canPreload_1 = require("./canPreload");
+import { deepNormalizeHint, normalizeHint } from "../normalizeHints.js";
+import { ReactiveReferenceImpl } from "../relations/ReactiveReference.js";
+import "../relations/index.js";
+import { getProperties } from "../getProperties.js";
+import "../EntityMetadata.js";
+import { canPreload } from "./canPreload.js";
+//#region src/preloading/partitionHint.ts
 /** Partitions a hint into SQL-able and non-SQL-able hints. */
 function partitionHint(meta, hint) {
-    let sql = undefined;
-    let non = undefined;
-    for (const [key, subHint] of Object.entries((0, normalizeHints_1.normalizeHint)(hint))) {
-        const field = meta?.allFields[key];
-        if (field && (0, canPreload_1.canPreload)(meta, field)) {
-            if (field.kind === "m2mEnum") {
-                // Enum m2ms are a leaf relation (enum codes have no sub-hint to recurse into).
-                (sql ??= {})[key] ??= {};
-            }
-            else {
-                const [_sql, _non] = partitionHint(field.otherMetadata(), subHint);
-                deepMerge(((sql ??= {})[key] ??= {}), _sql ?? {});
-                if (_non)
-                    deepMerge(((non ??= {})[key] ??= {}), _non);
-            }
-        }
-        else {
-            // If this isn't a raw SQL relation, but it exposes a load-hint, inline that into our SQL.
-            // This will get the non-SQL relation's underlying SQL data preloaded.
-            const p = meta && (0, getProperties_1.getProperties)(meta)[key];
-            if (p && p.loadHint) {
-                // Maybe we could have `PersistedAsyncReferenceImpl` internally/dynamically return us the right
-                // load hint, instead of special casing it like this? Like it could internally check "needs calc?"
-                if (p instanceof relations_1.ReactiveReferenceImpl) {
-                    // Instead of using p.loadHint, we'll just follow the FK in the database and go to the subHint
-                    const [_sql, _non] = partitionHint(p.otherMeta, subHint);
-                    deepMerge(((sql ??= {})[key] ??= {}), _sql ?? {});
-                    if (_non)
-                        deepMerge(((non ??= {})[key] ??= {}), _non);
-                    continue;
-                }
-                else {
-                    // It's not clear what to do with the subHint here, if anything--ideally it could stitch
-                    // on top of load hint but only in the places that made sense. But we'd risk over-fetching.
-                    // ...also we don't want to preload ReactiveField full hint vs. just using their
-                    // calculated values.
-                    // const [_sql, _non] = partitionHint(meta, p.loadHint);
-                    // if (_sql) deepMerge((sql ??= {}), _sql);
-                    // if (_non) deepMerge((non ??= {}), _non);
-                }
-            }
-            // Even if we did some SQL preloads, the subHint needs to go through the non-sql path.
-            deepMerge(((non ??= {})[key] ??= {}), (0, normalizeHints_1.deepNormalizeHint)(subHint));
-        }
-    }
-    return [sql, non];
+	let sql = void 0;
+	let non = void 0;
+	for (const [key, subHint] of Object.entries(normalizeHint(hint))) {
+		const field = meta?.allFields[key];
+		if (field && canPreload(meta, field)) {
+			if (field.kind === "m2mEnum") (sql ??= {})[key] ??= {};
+			else {
+				const [_sql, _non] = partitionHint(field.otherMetadata(), subHint);
+				deepMerge((sql ??= {})[key] ??= {}, _sql ?? {});
+				if (_non) deepMerge((non ??= {})[key] ??= {}, _non);
+			}
+		} else {
+			const p = meta && getProperties(meta)[key];
+			if (p && p.loadHint) {
+				if (p instanceof ReactiveReferenceImpl) {
+					const [_sql, _non] = partitionHint(p.otherMeta, subHint);
+					deepMerge((sql ??= {})[key] ??= {}, _sql ?? {});
+					if (_non) deepMerge((non ??= {})[key] ??= {}, _non);
+					continue;
+				}
+			}
+			deepMerge((non ??= {})[key] ??= {}, deepNormalizeHint(subHint));
+		}
+	}
+	return [sql, non];
 }
 function deepMerge(a, b) {
-    for (const [key, value] of Object.entries(b)) {
-        deepMerge((a[key] ??= {}), value);
-    }
+	for (const [key, value] of Object.entries(b)) deepMerge(a[key] ??= {}, value);
 }
+//#endregion
+export { partitionHint };
+
 //# sourceMappingURL=partitionHint.js.map

package/build/preloading/partitionHint.js.map

@@ -1 +1 @@
-{"version":3,"file":"partitionHint.js","sourceRoot":"","sources":["../../src/preloading/partitionHint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"partitionHint.js","names":[],"sources":["../../src/preloading/partitionHint.ts"],"sourcesContent":["import { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { getProperties } from \"src/getProperties.ts\";\nimport type { LoadHint, NestedLoadHint } from \"src/loading/loadHints.ts\";\nimport { deepNormalizeHint, normalizeHint } from \"src/normalizeHints.ts\";\nimport { canPreload } from \"src/preloading/canPreload.ts\";\nimport { ReactiveReferenceImpl } from \"src/relations/index.ts\";\n\n/** Partitions a hint into SQL-able and non-SQL-able hints. */\nexport function partitionHint(\n  meta: EntityMetadata | undefined,\n  hint: LoadHint<any>,\n): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined] {\n  let sql: NestedLoadHint<any> | undefined = undefined;\n  let non: NestedLoadHint<any> | undefined = undefined;\n  for (const [key, subHint] of Object.entries(normalizeHint(hint))) {\n    const field = meta?.allFields[key];\n    if (field && canPreload(meta!, field)) {\n      if (field.kind === \"m2mEnum\") {\n        // Enum m2ms are a leaf relation (enum codes have no sub-hint to recurse into).\n        (sql ??= {})[key] ??= {};\n      } else {\n        const [_sql, _non] = partitionHint(field.otherMetadata(), subHint);\n        deepMerge(((sql ??= {})[key] ??= {}), _sql ?? {});\n        if (_non) deepMerge(((non ??= {})[key] ??= {}), _non);\n      }\n    } else {\n      // If this isn't a raw SQL relation, but it exposes a load-hint, inline that into our SQL.\n      // This will get the non-SQL relation's underlying SQL data preloaded.\n      const p = meta && getProperties(meta)[key];\n      if (p && p.loadHint) {\n        // Maybe we could have `PersistedAsyncReferenceImpl` internally/dynamically return us the right\n        // load hint, instead of special casing it like this? Like it could internally check \"needs calc?\"\n        if (p instanceof ReactiveReferenceImpl) {\n          // Instead of using p.loadHint, we'll just follow the FK in the database and go to the subHint\n          const [_sql, _non] = partitionHint(p.otherMeta, subHint);\n          deepMerge(((sql ??= {})[key] ??= {}), _sql ?? {});\n          if (_non) deepMerge(((non ??= {})[key] ??= {}), _non);\n          continue;\n        } else {\n          // It's not clear what to do with the subHint here, if anything--ideally it could stitch\n          // on top of load hint but only in the places that made sense. But we'd risk over-fetching.\n          // ...also we don't want to preload ReactiveField full hint vs. just using their\n          // calculated values.\n          // const [_sql, _non] = partitionHint(meta, p.loadHint);\n          // if (_sql) deepMerge((sql ??= {}), _sql);\n          // if (_non) deepMerge((non ??= {}), _non);\n        }\n      }\n      // Even if we did some SQL preloads, the subHint needs to go through the non-sql path.\n      deepMerge(((non ??= {})[key] ??= {}), deepNormalizeHint(subHint));\n    }\n  }\n  return [sql, non];\n}\n\nfunction deepMerge<T extends object>(a: T, b: T): void {\n  for (const [key, value] of Object.entries(b)) {\n    deepMerge(((a as any)[key] ??= {}), value);\n  }\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,cACd,MACA,MACoE;CACpE,IAAI,MAAuC,KAAA;CAC3C,IAAI,MAAuC,KAAA;CAC3C,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,cAAc,IAAI,CAAC,GAAG;EAChE,MAAM,QAAQ,MAAM,UAAU;EAC9B,IAAI,SAAS,WAAW,MAAO,KAAK,GAAG;GACrC,IAAI,MAAM,SAAS,WAEjB,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC;QAClB;IACL,MAAM,CAAC,MAAM,QAAQ,cAAc,MAAM,cAAc,GAAG,OAAO;IACjE,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,IAAI;GACtD;EACF,OAAO;GAGL,MAAM,IAAI,QAAQ,cAAc,IAAI,CAAC,CAAC;GACtC,IAAI,KAAK,EAAE,UAGL;QAAA,aAAa,uBAAuB;KAEtC,MAAM,CAAC,MAAM,QAAQ,cAAc,EAAE,WAAW,OAAO;KACvD,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,QAAQ,CAAC,CAAC;KAChD,IAAI,MAAM,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,IAAI;KACpD;IACF;;GAWF,UAAW,CAAC,QAAQ,CAAC,EAAA,CAAG,SAAS,CAAC,GAAI,kBAAkB,OAAO,CAAC;EAClE;CACF;CACA,OAAO,CAAC,KAAK,GAAG;AAClB;AAEA,SAAS,UAA4B,GAAM,GAAY;CACrD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,CAAC,GACzC,UAAW,EAAW,SAAS,CAAC,GAAI,KAAK;AAE7C"}

package/build/queries/ConditionBuilder.cjs

@@ -0,0 +1,106 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_queries_skipCondition = require("./skipCondition.cjs");
+const require_queries_valueFilters = require("./valueFilters.cjs");
+const require_utils = require("../utils.cjs");
+const require_EntityManager = require("../EntityManager.cjs");
+//#region src/queries/ConditionBuilder.ts
+/** Converts domain-level values like string ids/enums into their db equivalent. */
+var ConditionBuilder = class {
+	/** Simple, single-column conditions, which will be AND-d together. */
+	conditions = [];
+	/** Complex expressions, which will also be AND-d together with `conditions`. */
+	expressions = [];
+	/** Accepts a raw user-facing DSL filter, and parses it into a `ParsedExpressionFilter`. */
+	maybeAddExpression(expression) {
+		const parsed = parseExpression(expression);
+		if (parsed) this.expressions.push(parsed);
+	}
+	/** Adds an already-db-level condition to the simple conditions list. */
+	addSimpleCondition(condition) {
+		this.conditions.push(condition);
+	}
+	/** Adds an already-db-level condition to the simple conditions list. */
+	addRawCondition(condition) {
+		this.conditions.push({
+			kind: "raw",
+			bindings: [],
+			...condition
+		});
+	}
+	/** Adds an already-db-level expression to the expressions list. */
+	addParsedExpression(parsed) {
+		this.expressions.push(parsed);
+	}
+	/**
+	* Adds a user-facing `ParsedValueFilter` to the inline conditions.
+	*
+	* Unless it's something like `in: [a1, null]`, in which case we split it into two `is-null` and `in` conditions.
+	*/
+	addValueFilter(alias, column, filter) {
+		if (filter.kind === "in" && filter.value.includes(null)) {
+			const isNull = {
+				kind: "column",
+				alias,
+				column: column.columnName,
+				dbType: column.dbType,
+				cond: { kind: "is-null" }
+			};
+			const inValues = {
+				kind: "column",
+				alias,
+				column: column.columnName,
+				dbType: column.dbType,
+				cond: {
+					kind: "in",
+					value: filter.value.filter((v) => v !== null).map((v) => column.mapToDb(v))
+				}
+			};
+			this.expressions.push({
+				kind: "exp",
+				op: "or",
+				conditions: [isNull, inValues]
+			});
+		} else {
+			const cond = {
+				kind: "column",
+				alias,
+				column: column.columnName,
+				dbType: column.dbType,
+				cond: require_queries_valueFilters.mapToDb(column, filter)
+			};
+			this.conditions.push(cond);
+		}
+	}
+	/** Combines our collected `conditions` and `expressions` into a single `ParsedExpressionFilter`. */
+	toExpressionFilter() {
+		const { expressions, conditions } = this;
+		const allSimple = [...conditions];
+		if (allSimple.length === 0 && expressions.length === 1) return expressions[0];
+		else if (expressions.length === 1 && expressions[0].op === "and") return {
+			kind: "exp",
+			op: "and",
+			conditions: [...allSimple, ...expressions[0].conditions]
+		};
+		else if (allSimple.length > 0 || expressions.length > 0) return {
+			kind: "exp",
+			op: "and",
+			conditions: [...allSimple, ...expressions]
+		};
+	}
+};
+/** Parses user-facing `{ and: ... }` or `{ or: ... }` into a `ParsedExpressionFilter`. */
+function parseExpression(expression) {
+	const [op, expressions] = "and" in expression && expression.and ? ["and", expression.and] : "or" in expression && expression.or ? ["or", expression.or] : require_utils.fail(`Invalid expression ${expression}`);
+	const conditions = expressions.map((exp) => exp && ("and" in exp || "or" in exp) ? parseExpression(exp) : exp);
+	const [skip, valid] = require_utils.partition(conditions, (cond) => cond === void 0 || cond === require_queries_skipCondition.skipCondition);
+	if (skip.length > 0 && expression.pruneIfUndefined === "any" || valid.length === 0) return;
+	return {
+		kind: "exp",
+		op,
+		conditions: valid.filter(require_EntityManager.isDefined)
+	};
+}
+//#endregion
+exports.ConditionBuilder = ConditionBuilder;
+
+//# sourceMappingURL=ConditionBuilder.cjs.map

package/build/queries/ConditionBuilder.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionBuilder.cjs","names":["mapToDb","fail","partition","skipCondition","isDefined"],"sources":["../../src/queries/ConditionBuilder.ts"],"sourcesContent":["import { isDefined } from \"src/EntityManager.ts\";\nimport type { ConditionGroup, ConditionInput } from \"src/queries/conditions.ts\";\nimport type {\n  ColumnCondition,\n  ParsedExpressionCondition,\n  ParsedExpressionFilter,\n  ParsedValueFilter,\n  RawCondition,\n} from \"src/queries/parsedConditions.ts\";\nimport { skipCondition } from \"src/queries/skipCondition.ts\";\nimport { mapToDb } from \"src/queries/valueFilters.ts\";\nimport type { Column } from \"src/serde/columns.ts\";\nimport { fail, partition } from \"src/utils.ts\";\n\ntype PartialSome<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\n\n/** Converts domain-level values like string ids/enums into their db equivalent. */\nexport class ConditionBuilder {\n  /** Simple, single-column conditions, which will be AND-d together. */\n  private conditions: (ColumnCondition | RawCondition)[] = [];\n  /** Complex expressions, which will also be AND-d together with `conditions`. */\n  private expressions: ParsedExpressionFilter[] = [];\n\n  /** Accepts a raw user-facing DSL filter, and parses it into a `ParsedExpressionFilter`. */\n  maybeAddExpression(expression: ConditionGroup<ConditionInput>): void {\n    const parsed = parseExpression(expression);\n    if (parsed) this.expressions.push(parsed);\n  }\n\n  /** Adds an already-db-level condition to the simple conditions list. */\n  addSimpleCondition(condition: ColumnCondition): void {\n    this.conditions.push(condition);\n  }\n\n  /** Adds an already-db-level condition to the simple conditions list. */\n  addRawCondition(condition: PartialSome<RawCondition, \"kind\" | \"bindings\">): void {\n    this.conditions.push({\n      kind: \"raw\",\n      bindings: [],\n      ...condition,\n    });\n  }\n\n  /** Adds an already-db-level expression to the expressions list. */\n  addParsedExpression(parsed: ParsedExpressionFilter): void {\n    this.expressions.push(parsed);\n  }\n\n  /**\n   * Adds a user-facing `ParsedValueFilter` to the inline conditions.\n   *\n   * Unless it's something like `in: [a1, null]`, in which case we split it into two `is-null` and `in` conditions.\n   */\n  addValueFilter(alias: string, column: Column, filter: ParsedValueFilter<any>): void {\n    if (filter.kind === \"in\" && filter.value.includes(null)) {\n      // If the filter contains a null, we need to split it into an `is-null` and `in` condition\n      const isNull = {\n        kind: \"column\",\n        alias,\n        column: column.columnName,\n        dbType: column.dbType,\n        cond: { kind: \"is-null\" },\n      } satisfies ColumnCondition;\n      const inValues = {\n        kind: \"column\",\n        alias,\n        column: column.columnName,\n        dbType: column.dbType,\n        cond: {\n          kind: \"in\",\n          // Filter out the nulls from the in condition\n          value: filter.value.filter((v) => v !== null).map((v) => column.mapToDb(v)),\n        },\n      } satisfies ColumnCondition;\n      // Now OR them back together\n      this.expressions.push({ kind: \"exp\", op: \"or\", conditions: [isNull, inValues] });\n    } else {\n      const cond = {\n        kind: \"column\",\n        alias,\n        column: column.columnName,\n        dbType: column.dbType,\n        // Rewrite the user-facing domain values to db values\n        cond: mapToDb(column, filter),\n      } satisfies ColumnCondition;\n      this.conditions.push(cond);\n    }\n  }\n\n  /** Combines our collected `conditions` and `expressions` into a single `ParsedExpressionFilter`. */\n  toExpressionFilter(): ParsedExpressionFilter | undefined {\n    const { expressions, conditions } = this;\n    const allSimple: ParsedExpressionCondition[] = [...conditions];\n    if (allSimple.length === 0 && expressions.length === 1) {\n      // If no inline conditions, and just 1 opt expression, just use that\n      return expressions[0];\n    } else if (expressions.length === 1 && expressions[0].op === \"and\") {\n      // Merge the 1 `AND` expression with the other simple conditions\n      return { kind: \"exp\", op: \"and\", conditions: [...allSimple, ...expressions[0].conditions] };\n    } else if (allSimple.length > 0 || expressions.length > 0) {\n      // Combine the conditions within the `em.find` join literal & the `conditions` as ANDs\n      return { kind: \"exp\", op: \"and\", conditions: [...allSimple, ...expressions] };\n    }\n    return undefined;\n  }\n}\n\n/** Parses user-facing `{ and: ... }` or `{ or: ... }` into a `ParsedExpressionFilter`. */\nfunction parseExpression(expression: ConditionGroup<ConditionInput>): ParsedExpressionFilter | undefined {\n  // Look for `{ and: [...] }` or `{ or: [...] }`\n  const [op, expressions] =\n    \"and\" in expression && expression.and\n      ? [\"and\" as const, expression.and]\n      : \"or\" in expression && expression.or\n        ? [\"or\" as const, expression.or]\n        : fail(`Invalid expression ${expression}`);\n  // Potentially recurse into nested expressions\n  const conditions = expressions.map((exp) => (exp && (\"and\" in exp || \"or\" in exp) ? parseExpression(exp) : exp));\n  const [skip, valid] = partition(conditions, (cond) => cond === undefined || cond === skipCondition);\n  if ((skip.length > 0 && expression.pruneIfUndefined === \"any\") || valid.length === 0) {\n    return undefined;\n  }\n  return { kind: \"exp\", op, conditions: valid.filter(isDefined) };\n}\n"],"mappings":";;;;;;;AAiBA,IAAa,mBAAb,MAA8B;;CAE5B,aAAyD,CAAC;;CAE1D,cAAgD,CAAC;;CAGjD,mBAAmB,YAAkD;EACnE,MAAM,SAAS,gBAAgB,UAAU;EACzC,IAAI,QAAQ,KAAK,YAAY,KAAK,MAAM;CAC1C;;CAGA,mBAAmB,WAAkC;EACnD,KAAK,WAAW,KAAK,SAAS;CAChC;;CAGA,gBAAgB,WAAiE;EAC/E,KAAK,WAAW,KAAK;GACnB,MAAM;GACN,UAAU,CAAC;GACX,GAAG;EACL,CAAC;CACH;;CAGA,oBAAoB,QAAsC;EACxD,KAAK,YAAY,KAAK,MAAM;CAC9B;;;;;;CAOA,eAAe,OAAe,QAAgB,QAAsC;EAClF,IAAI,OAAO,SAAS,QAAQ,OAAO,MAAM,SAAS,IAAI,GAAG;GAEvD,MAAM,SAAS;IACb,MAAM;IACN;IACA,QAAQ,OAAO;IACf,QAAQ,OAAO;IACf,MAAM,EAAE,MAAM,UAAU;GAC1B;GACA,MAAM,WAAW;IACf,MAAM;IACN;IACA,QAAQ,OAAO;IACf,QAAQ,OAAO;IACf,MAAM;KACJ,MAAM;KAEN,OAAO,OAAO,MAAM,QAAQ,MAAM,MAAM,IAAI,CAAC,CAAC,KAAK,MAAM,OAAO,QAAQ,CAAC,CAAC;IAC5E;GACF;GAEA,KAAK,YAAY,KAAK;IAAE,MAAM;IAAO,IAAI;IAAM,YAAY,CAAC,QAAQ,QAAQ;GAAE,CAAC;EACjF,OAAO;GACL,MAAM,OAAO;IACX,MAAM;IACN;IACA,QAAQ,OAAO;IACf,QAAQ,OAAO;IAEf,MAAMA,6BAAAA,QAAQ,QAAQ,MAAM;GAC9B;GACA,KAAK,WAAW,KAAK,IAAI;EAC3B;CACF;;CAGA,qBAAyD;EACvD,MAAM,EAAE,aAAa,eAAe;EACpC,MAAM,YAAyC,CAAC,GAAG,UAAU;EAC7D,IAAI,UAAU,WAAW,KAAK,YAAY,WAAW,GAEnD,OAAO,YAAY;OACd,IAAI,YAAY,WAAW,KAAK,YAAY,EAAE,CAAC,OAAO,OAE3D,OAAO;GAAE,MAAM;GAAO,IAAI;GAAO,YAAY,CAAC,GAAG,WAAW,GAAG,YAAY,EAAE,CAAC,UAAU;EAAE;OACrF,IAAI,UAAU,SAAS,KAAK,YAAY,SAAS,GAEtD,OAAO;GAAE,MAAM;GAAO,IAAI;GAAO,YAAY,CAAC,GAAG,WAAW,GAAG,WAAW;EAAE;CAGhF;AACF;;AAGA,SAAS,gBAAgB,YAAgF;CAEvG,MAAM,CAAC,IAAI,eACT,SAAS,cAAc,WAAW,MAC9B,CAAC,OAAgB,WAAW,GAAG,IAC/B,QAAQ,cAAc,WAAW,KAC/B,CAAC,MAAe,WAAW,EAAE,IAC7BC,cAAAA,KAAK,sBAAsB,YAAY;CAE/C,MAAM,aAAa,YAAY,KAAK,QAAS,QAAQ,SAAS,OAAO,QAAQ,OAAO,gBAAgB,GAAG,IAAI,GAAI;CAC/G,MAAM,CAAC,MAAM,SAASC,cAAAA,UAAU,aAAa,SAAS,SAAS,KAAA,KAAa,SAASC,8BAAAA,aAAa;CAClG,IAAK,KAAK,SAAS,KAAK,WAAW,qBAAqB,SAAU,MAAM,WAAW,GACjF;CAEF,OAAO;EAAE,MAAM;EAAO;EAAI,YAAY,MAAM,OAAOC,sBAAAA,SAAS;CAAE;AAChE"}

package/build/queries/ConditionBuilder.d.cts

@@ -0,0 +1,31 @@
+import { ColumnCondition, ParsedExpressionFilter, ParsedValueFilter, RawCondition } from "./parsedConditions.cjs";
+import { ConditionGroup, ConditionInput } from "./conditions.cjs";
+import { Column } from "../serde/columns.cjs";
+//#region src/queries/ConditionBuilder.d.ts
+type PartialSome<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** Converts domain-level values like string ids/enums into their db equivalent. */
+declare class ConditionBuilder {
+  /** Simple, single-column conditions, which will be AND-d together. */
+  private conditions;
+  /** Complex expressions, which will also be AND-d together with `conditions`. */
+  private expressions;
+  /** Accepts a raw user-facing DSL filter, and parses it into a `ParsedExpressionFilter`. */
+  maybeAddExpression(expression: ConditionGroup<ConditionInput>): void;
+  /** Adds an already-db-level condition to the simple conditions list. */
+  addSimpleCondition(condition: ColumnCondition): void;
+  /** Adds an already-db-level condition to the simple conditions list. */
+  addRawCondition(condition: PartialSome<RawCondition, "kind" | "bindings">): void;
+  /** Adds an already-db-level expression to the expressions list. */
+  addParsedExpression(parsed: ParsedExpressionFilter): void;
+  /**
+   * Adds a user-facing `ParsedValueFilter` to the inline conditions.
+   *
+   * Unless it's something like `in: [a1, null]`, in which case we split it into two `is-null` and `in` conditions.
+   */
+  addValueFilter(alias: string, column: Column, filter: ParsedValueFilter<any>): void;
+  /** Combines our collected `conditions` and `expressions` into a single `ParsedExpressionFilter`. */
+  toExpressionFilter(): ParsedExpressionFilter | undefined;
+}
+//#endregion
+export { ConditionBuilder };
+//# sourceMappingURL=ConditionBuilder.d.cts.map

package/build/queries/ConditionBuilder.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionBuilder.d.cts","names":[],"sources":["../../src/queries/ConditionBuilder.ts"],"mappings":";;;;KAcK,YAAY,GAAG,gBAAgB,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,GAAG;;cAGzD;;UAEH;;UAEA;;EAGR,mBAAmB,YAAY,eAAe;;EAM9C,mBAAmB,WAAW;;EAK9B,gBAAgB,WAAW,YAAY;;EASvC,oBAAoB,QAAQ;;;;;;EAS5B,eAAe,eAAe,QAAQ,QAAQ,QAAQ;;EAqCtD,sBAAsB"}

package/build/queries/ConditionBuilder.d.mts

@@ -0,0 +1,31 @@
+import { ColumnCondition, ParsedExpressionFilter, ParsedValueFilter, RawCondition } from "./parsedConditions.mjs";
+import { ConditionGroup, ConditionInput } from "./conditions.mjs";
+import { Column } from "../serde/columns.mjs";
+//#region src/queries/ConditionBuilder.d.ts
+type PartialSome<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** Converts domain-level values like string ids/enums into their db equivalent. */
+declare class ConditionBuilder {
+  /** Simple, single-column conditions, which will be AND-d together. */
+  private conditions;
+  /** Complex expressions, which will also be AND-d together with `conditions`. */
+  private expressions;
+  /** Accepts a raw user-facing DSL filter, and parses it into a `ParsedExpressionFilter`. */
+  maybeAddExpression(expression: ConditionGroup<ConditionInput>): void;
+  /** Adds an already-db-level condition to the simple conditions list. */
+  addSimpleCondition(condition: ColumnCondition): void;
+  /** Adds an already-db-level condition to the simple conditions list. */
+  addRawCondition(condition: PartialSome<RawCondition, "kind" | "bindings">): void;
+  /** Adds an already-db-level expression to the expressions list. */
+  addParsedExpression(parsed: ParsedExpressionFilter): void;
+  /**
+   * Adds a user-facing `ParsedValueFilter` to the inline conditions.
+   *
+   * Unless it's something like `in: [a1, null]`, in which case we split it into two `is-null` and `in` conditions.
+   */
+  addValueFilter(alias: string, column: Column, filter: ParsedValueFilter<any>): void;
+  /** Combines our collected `conditions` and `expressions` into a single `ParsedExpressionFilter`. */
+  toExpressionFilter(): ParsedExpressionFilter | undefined;
+}
+//#endregion
+export { ConditionBuilder };
+//# sourceMappingURL=ConditionBuilder.d.mts.map

package/build/queries/ConditionBuilder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionBuilder.d.mts","names":[],"sources":["../../src/queries/ConditionBuilder.ts"],"mappings":";;;;KAcK,YAAY,GAAG,gBAAgB,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,GAAG;;cAGzD;;UAEH;;UAEA;;EAGR,mBAAmB,YAAY,eAAe;;EAM9C,mBAAmB,WAAW;;EAK9B,gBAAgB,WAAW,YAAY;;EASvC,oBAAoB,QAAQ;;;;;;EAS5B,eAAe,eAAe,QAAQ,QAAQ,QAAQ;;EAqCtD,sBAAsB"}