@query-graph/core 1.1.0 → 1.1.1

package/README.md

@@ -716,3 +716,62 @@ relation `many` для него допустим. Для пагинации вл
 
 Полный пример графа, отображения, операции, сгенерированного SQL и замера
 производительности компиляции находится в `benchmark/bench.ts`.
+
+## Batch-связи и двухфазное выполнение
+
+Поля из отдельного запроса подключаются без изменения обычного relational-графа:
+
+```ts
+const childrenQuery = batchQuery({
+  graph: childrenGraph,
+  key: {
+    path: 'parentId',
+    parameter: parentIds,
+  },
+})
+
+const children = batchRelation({
+  name: 'children',
+  from: 'id',
+  query: childrenQuery,
+  cardinality: 'many',
+})
+
+const graph = composeGraph({ root: rootGraph, relations: [children] })
+const plan = graph.compileOraclePlan({
+  select: ['id', 'children.id'],
+  parameters: {},
+  limit: 20,
+})
+```
+
+`batchQuery` принадлежит child-модулю и один раз закрепляет его graph,
+projection path ключа и list-параметр. Поэтому разные root-графы могут
+переиспользовать query, не повторяя внутренний контракт child-запроса.
+
+`composeGraph` оставляет в JavaScript только декларативный фасад. Проверка
+совместимости ключей и параметров, разделение operation на root и batch-шаги и
+компиляция SQL выполняются в Rust. `compileOraclePlan` или
+`compileSqlServerPlan` сразу компилирует только `plan.root`; child SQL создаётся
+при вызове `compileBatch`. Plan сохраняет выбранные dialect и version, поэтому
+отложенный statement компилируется с теми же настройками, что и root.
+
+Для подготовки child bindings каждый шаг в `plan.batches` также содержит имя
+ключевого параметра `keyParameter` и снимок статических `parameters`. Executor
+объединяет их с `{ [batch.keyParameter]: keys }` и сопоставляет полученные значения
+с возвращёнными `statement.bindings`.
+
+Executor потребителя выполняет `plan.root`, собирает уникальные ненулевые
+значения `parentKey` из `plan.batches`, вызывает
+`plan.compileBatch('children', parentIds)`, выполняет child statement и
+связывает строки по `childKey`. `cardinality: 'one'` означает объект или `null`,
+а `many` — массив. Query-graph не подключается к БД, не дедуплицирует ключи, не
+выполняет statements и не гидратирует результат; при пустом наборе ключей
+executor должен пропустить child-запрос.
+
+Ordering, offset и limit корневой operation применяются только к `plan.root`.
+Batch-связь может задать собственный `ordering`, но child pagination не
+добавляется. Batch-поля выбираются только явно (`children.id`); без prefixed
+path соответствующего шага в `plan.batches` нет. Флаги injection в metadata
+показывают executor, какие ключи были добавлены исключительно для связывания и
+не должны попасть в публичный результат.

package/composition.js

@@ -0,0 +1,126 @@
+'use strict'
+
+const BATCH_QUERY_KEYS = new Set(['graph', 'key'])
+const BATCH_QUERY_KEY_KEYS = new Set(['path', 'parameter'])
+const BATCH_RELATION_KEYS = new Set(['name', 'from', 'query', 'cardinality', 'parameters', 'ordering'])
+const COMPOSE_KEYS = new Set(['root', 'relations'])
+const batchQueryBrand = Symbol('BatchQuery')
+const batchBrand = Symbol('BatchRelation')
+
+function configurationOf(factory, value, allowedKeys) {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+    throw new TypeError(`${factory} expects a configuration object`)
+  }
+
+  const unknownKeys = Reflect.ownKeys(value).filter((key) => typeof key !== 'string' || !allowedKeys.has(key))
+  if (unknownKeys.length > 0) {
+    const label = unknownKeys.length === 1 ? 'field' : 'fields'
+    const keys = unknownKeys.map((key) => JSON.stringify(String(key))).join(', ')
+    throw new TypeError(`${factory} received unknown configuration ${label} ${keys}`)
+  }
+
+  return value
+}
+
+function nonEmptyString(value, label) {
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw new TypeError(`${label} must be a non-empty string`)
+  }
+  return value
+}
+
+function relationalGraph(value, label) {
+  if (value === null || typeof value !== 'object' || typeof value.compose !== 'function') {
+    throw new TypeError(`${label} must be a RelationalQueryGraph`)
+  }
+  return value
+}
+
+function batchQueryOf(value, label) {
+  if (value === null || typeof value !== 'object' || value[batchQueryBrand] !== true) {
+    throw new TypeError(`${label} must be created by batchQuery`)
+  }
+  return value
+}
+
+function batchQuery(value) {
+  const configuration = configurationOf('batchQuery', value, BATCH_QUERY_KEYS)
+  const graph = relationalGraph(configuration.graph, 'batchQuery.graph')
+  const keyConfiguration = configurationOf('batchQuery.key', configuration.key, BATCH_QUERY_KEY_KEYS)
+  const path = nonEmptyString(keyConfiguration.path, 'batchQuery.key.path')
+  const parameter = nonEmptyString(
+    typeof keyConfiguration.parameter === 'string' ? keyConfiguration.parameter : keyConfiguration.parameter?.name,
+    'batchQuery.key.parameter',
+  )
+
+  return Object.freeze({
+    graph,
+    key: Object.freeze({
+      path,
+      parameter,
+    }),
+    [batchQueryBrand]: true,
+  })
+}
+
+function batchRelation(value) {
+  const configuration = configurationOf('batchRelation', value, BATCH_RELATION_KEYS)
+  const name = nonEmptyString(configuration.name, 'batchRelation.name')
+  if (name.includes('.')) {
+    throw new TypeError('batchRelation.name must be a single projection path segment')
+  }
+
+  const from = nonEmptyString(configuration.from, 'batchRelation.from')
+  const query = batchQueryOf(configuration.query, 'batchRelation.query')
+
+  if (configuration.cardinality !== 'one' && configuration.cardinality !== 'many') {
+    throw new TypeError("batchRelation.cardinality must be 'one' or 'many'")
+  }
+  if (
+    configuration.parameters !== undefined &&
+    (configuration.parameters === null ||
+      typeof configuration.parameters !== 'object' ||
+      Array.isArray(configuration.parameters))
+  ) {
+    throw new TypeError('batchRelation.parameters must be an object')
+  }
+  if (configuration.ordering !== undefined) {
+    nonEmptyString(configuration.ordering, 'batchRelation.ordering')
+  }
+
+  return Object.freeze({
+    name,
+    from,
+    query,
+    cardinality: configuration.cardinality,
+    parameters: Object.freeze({ ...configuration.parameters }),
+    ...(configuration.ordering === undefined ? {} : { ordering: configuration.ordering }),
+    [batchBrand]: true,
+  })
+}
+
+function composeGraph(value) {
+  const configuration = configurationOf('composeGraph', value, COMPOSE_KEYS)
+  const root = relationalGraph(configuration.root, 'composeGraph.root')
+  if (!Array.isArray(configuration.relations)) {
+    throw new TypeError('composeGraph.relations must be an array')
+  }
+
+  return configuration.relations.reduce((graph, relation, index) => {
+    if (relation?.[batchBrand] !== true) {
+      throw new TypeError(`composeGraph.relations[${index}] must be created by batchRelation`)
+    }
+
+    return graph.withBatchRelation(relation.query.graph, {
+      name: relation.name,
+      from: relation.from,
+      to: relation.query.key.path,
+      parameter: relation.query.key.parameter,
+      cardinality: relation.cardinality,
+      parameters: relation.parameters,
+      ...(relation.ordering === undefined ? {} : { ordering: relation.ordering }),
+    })
+  }, root.compose())
+}
+
+module.exports = { batchQuery, batchRelation, composeGraph }

package/definition.js

@@ -102,6 +102,9 @@ exports.relation = relation
 exports.constraint = constraint
 exports.ordering = objectDsl.ordering
 exports.project = project
+exports.batchQuery = objectDsl.batchQuery
+exports.batchRelation = objectDsl.batchRelation
+exports.composeGraph = objectDsl.composeGraph
 exports.dimension = dimension
 exports.measure = measure
 exports.asc = objectDsl.asc

package/dsl.d.ts

@@ -512,6 +512,278 @@ export interface RelationalQueryGraph<Definition extends GraphDefinitionInput =
   ): import('./index.js').CompiledSqlStatement
 }
 
+export type BatchCardinality = RelationCardinality
+
+export interface BatchRelationWire {
+  name: string
+  from: string
+  to: string
+  parameter: string
+  cardinality: BatchCardinality
+  parameters?: Record<string, unknown>
+  ordering?: string
+}
+
+type ListDefinitionParameter<Definition extends GraphDefinitionInput> =
+  DefinitionParameter<Definition> extends infer Parameter extends ParameterDefinition
+    ? Parameter extends { shape: 'list' }
+      ? Parameter
+      : never
+    : never
+
+type ListParameterReference<Definition extends GraphDefinitionInput> =
+  | ListDefinitionParameter<Definition>
+  | ListDefinitionParameter<Definition>['name']
+
+type ParameterReferenceName<Reference> = Reference extends { name: infer Name extends string }
+  ? Name
+  : Reference extends string
+    ? Reference
+    : never
+
+type ResolveListParameter<Definition extends GraphDefinitionInput, Reference> = Extract<
+  ListDefinitionParameter<Definition>,
+  { name: ParameterReferenceName<Reference> }
+>
+
+type BatchStaticParameterCandidate<
+  Parameter extends ParameterDefinition,
+  KeyName extends string,
+> = Parameter extends ParameterDefinition ? (Parameter['name'] extends KeyName ? never : Parameter) : never
+
+type BatchStaticParameter<
+  Definition extends GraphDefinitionInput,
+  KeyName extends string,
+> = BatchStaticParameterCandidate<DefinitionParameter<Definition>, KeyName>
+
+type BatchStaticParameters<Definition extends GraphDefinitionInput, KeyName extends string> = {
+  [Parameter in RequiredParameter<
+    BatchStaticParameter<Definition, KeyName>
+  > as Parameter['name']]-?: ParameterValue<Parameter>
+} & {
+  [Parameter in OptionalParameter<
+    BatchStaticParameter<Definition, KeyName>
+  > as Parameter['name']]?: ParameterValue<Parameter>
+}
+
+type BatchStaticParameterInput<Definition extends GraphDefinitionInput, KeyName extends string> = [
+  BatchStaticParameter<Definition, KeyName>,
+] extends [never]
+  ? { parameters?: never }
+  : [RequiredParameter<BatchStaticParameter<Definition, KeyName>>] extends [never]
+    ? { parameters?: BatchStaticParameters<Definition, KeyName> }
+    : { parameters: BatchStaticParameters<Definition, KeyName> }
+
+declare const batchQueryType: unique symbol
+
+export interface BatchQuery<
+  Child extends RelationalQueryGraph = RelationalQueryGraph,
+  KeyPath extends string = string,
+  KeyParameter extends ParameterDefinition & { shape: 'list' } = ListParameterRef,
+> {
+  readonly graph: Child
+  readonly key: {
+    readonly path: KeyPath
+    readonly parameter: KeyParameter['name']
+  }
+  readonly [batchQueryType]?: KeyParameter
+}
+
+export type BatchQueryConfiguration<
+  Child extends RelationalQueryGraph,
+  KeyPath extends DefinitionProjectionPath<DefinitionOf<Child>>,
+  ParameterReference extends ListParameterReference<DefinitionOf<Child>>,
+> = {
+  graph: Child
+  key: {
+    path: KeyPath
+    parameter: ParameterReference
+  }
+}
+
+type CompatibleBatchQueryConfiguration<
+  Child extends RelationalQueryGraph,
+  KeyPath extends DefinitionProjectionPath<DefinitionOf<Child>>,
+  KeyParameter extends ParameterDefinition & { shape: 'list' },
+> =
+  EqualScalarType<ProjectionScalarTypeAtPath<DefinitionOf<Child>, KeyPath>, KeyParameter['scalarType']> extends true
+    ? unknown
+    : never
+
+export function batchQuery<
+  const Child extends RelationalQueryGraph,
+  const KeyPath extends DefinitionProjectionPath<DefinitionOf<Child>>,
+  const ParameterReference extends ListParameterReference<DefinitionOf<Child>>,
+>(
+  configuration: BatchQueryConfiguration<Child, KeyPath, ParameterReference> &
+    CompatibleBatchQueryConfiguration<
+      Child,
+      KeyPath,
+      ResolveListParameter<DefinitionOf<Child>, NoInfer<ParameterReference>>
+    >,
+): BatchQuery<Child, KeyPath, ResolveListParameter<DefinitionOf<Child>, ParameterReference>>
+
+type BatchQueryGraph<Query extends BatchQuery> =
+  Query extends BatchQuery<infer Child, infer _KeyPath, infer _KeyParameter> ? Child : never
+
+type BatchQueryKeyPath<Query extends BatchQuery> =
+  Query extends BatchQuery<infer _Child, infer KeyPath, infer _KeyParameter> ? KeyPath : never
+
+type BatchQueryKeyParameter<Query extends BatchQuery> =
+  Query extends BatchQuery<infer _Child, infer _KeyPath, infer KeyParameter> ? KeyParameter : never
+
+declare const batchRelationType: unique symbol
+
+export interface BatchRelation<
+  Name extends string = string,
+  Query extends BatchQuery = BatchQuery,
+  From extends string = string,
+  Cardinality extends BatchCardinality = BatchCardinality,
+> {
+  readonly name: Name
+  readonly from: From
+  readonly query: Query
+  readonly cardinality: Cardinality
+  readonly parameters: BatchStaticParameters<
+    DefinitionOf<BatchQueryGraph<Query>>,
+    BatchQueryKeyParameter<Query>['name']
+  >
+  readonly ordering?: DefinitionOrderingName<DefinitionOf<BatchQueryGraph<Query>>>
+  readonly [batchRelationType]?: Query
+}
+
+export type BatchRelationConfiguration<
+  Name extends string,
+  Query extends BatchQuery,
+  From extends string,
+  Cardinality extends BatchCardinality,
+> = {
+  name: Name
+  from: From
+  query: Query
+  cardinality: Cardinality
+  ordering?: DefinitionOrderingName<DefinitionOf<BatchQueryGraph<Query>>>
+} & BatchStaticParameterInput<DefinitionOf<BatchQueryGraph<Query>>, BatchQueryKeyParameter<Query>['name']>
+
+export function batchRelation<
+  const Name extends string,
+  const Query extends BatchQuery,
+  const From extends string,
+  const Cardinality extends BatchCardinality,
+>(
+  configuration: BatchRelationConfiguration<Name, Query, From, Cardinality>,
+): BatchRelation<Name, Query, From, Cardinality>
+
+type ProjectionScalarTypeAtPath<Definition extends GraphDefinitionInput, Path extends string> =
+  ProjectionFieldByPath<DefinitionProjectionField<Definition>, Path> extends infer Field
+    ? Field extends ProjectionTypeMetadata<infer _Path, infer Type, infer _Nullability, infer _SelectedByDefault>
+      ? Type
+      : Field extends ProjectionFieldDefinition<infer _Path, infer Type>
+        ? Type
+        : never
+    : never
+
+type EqualScalarType<Left, Right> = [Left] extends [Right] ? ([Right] extends [Left] ? true : false) : false
+
+type CompatibleBatchRelation<Root extends RelationalQueryGraph, Relation extends BatchRelation> =
+  Relation extends BatchRelation<infer Name, infer Query, infer From, infer _Cardinality>
+    ? From extends DefinitionProjectionPath<DefinitionOf<Root>>
+      ? Extract<DefinitionProjectionPath<DefinitionOf<Root>>, Name | `${Name}.${string}`> extends never
+        ? EqualScalarType<
+            ProjectionScalarTypeAtPath<DefinitionOf<Root>, From>,
+            ProjectionScalarTypeAtPath<DefinitionOf<BatchQueryGraph<Query>>, BatchQueryKeyPath<Query>>
+          > extends true
+          ? EqualScalarType<
+              ProjectionScalarTypeAtPath<DefinitionOf<BatchQueryGraph<Query>>, BatchQueryKeyPath<Query>>,
+              BatchQueryKeyParameter<Query>['scalarType']
+            > extends true
+            ? Relation
+            : never
+          : never
+        : never
+      : never
+    : never
+
+type CompatibleBatchRelations<Root extends RelationalQueryGraph, Relations extends readonly BatchRelation[]> = {
+  readonly [Index in keyof Relations]: Relations[Index] extends BatchRelation
+    ? CompatibleBatchRelation<Root, Relations[Index]>
+    : never
+}
+
+type RelationName<Relations extends readonly BatchRelation[]> = Relations[number]['name']
+type ChildPathsForRelation<Relation extends BatchRelation> = Relation extends BatchRelation
+  ? `${Relation['name']}.${DefinitionProjectionPath<DefinitionOf<BatchQueryGraph<Relation['query']>>>}`
+  : never
+type ChildPaths<Relations extends readonly BatchRelation[]> = ChildPathsForRelation<Relations[number]>
+
+export type ComposedSelection<Root extends RelationalQueryGraph, Relations extends readonly BatchRelation[]> =
+  | DefinitionProjectionPath<DefinitionOf<Root>>
+  | ChildPaths<Relations>
+
+export interface BatchPlanMetadata<Relation extends BatchRelation = BatchRelation> {
+  name: Relation['name']
+  parentKey: Relation['from']
+  childKey: BatchQueryKeyPath<Relation['query']>
+  keyParameter: BatchQueryKeyParameter<Relation['query']>['name']
+  parameters: Readonly<Relation['parameters']>
+  cardinality: Relation['cardinality']
+  parentKeyInjected: boolean
+  childKeyInjected: boolean
+}
+
+type BatchRelationNamed<Relation extends BatchRelation, Name extends string> = Relation extends BatchRelation
+  ? Relation['name'] extends Name
+    ? Relation
+    : never
+  : never
+
+type BatchRelationByName<Relations extends readonly BatchRelation[], Name extends string> = BatchRelationNamed<
+  Relations[number],
+  Name
+>
+
+type BatchKeyValue<Relation extends BatchRelation> = ScalarParameterValue<
+  BatchQueryKeyParameter<Relation['query']>['scalarType']
+>
+
+export interface CompiledQueryPlan<Relations extends readonly BatchRelation[] = readonly BatchRelation[]> {
+  readonly root: import('./index.js').CompiledSqlStatement
+  readonly batches: readonly BatchPlanMetadata<Relations[number]>[]
+  compileBatch<const Name extends RelationName<Relations>>(
+    name: Name,
+    keys: readonly BatchKeyValue<BatchRelationByName<Relations, Name>>[],
+  ): import('./index.js').CompiledSqlStatement
+}
+
+export type ComposedQueryOperation<
+  Root extends RelationalQueryGraph,
+  Relations extends readonly BatchRelation[],
+> = QueryOperationBase<ComposedSelection<Root, Relations>, DefinitionOrderingName<DefinitionOf<Root>>> &
+  OperationParameterInput<DefinitionOf<Root>>
+
+export interface ComposedQueryGraph<
+  Root extends RelationalQueryGraph = RelationalQueryGraph,
+  Relations extends readonly BatchRelation[] = readonly BatchRelation[],
+> {
+  readonly name: string
+  compileOraclePlan(
+    operation: ComposedQueryOperation<Root, Relations>,
+    options?: OracleCompileOptions,
+  ): CompiledQueryPlan<Relations>
+  compileSqlServerPlan(
+    operation: ComposedQueryOperation<Root, Relations>,
+    options?: SqlServerCompileOptions,
+  ): CompiledQueryPlan<Relations>
+}
+
+export function composeGraph<
+  const Root extends RelationalQueryGraph,
+  const Relations extends readonly BatchRelation[],
+>(configuration: {
+  root: Root
+  relations: Relations & CompatibleBatchRelations<Root, Relations>
+}): ComposedQueryGraph<Root, Relations>
+
 export interface ScalarOutputTypeMap {
   boolean: unknown
   int32: unknown
@@ -753,14 +1025,60 @@ type BuildProjectionResult<Entry> = [Entry] extends [never]
     }
 
 export type ResultOf<
-  Subject extends GraphDefinitionInput | QueryGraph | RelationalQueryGraph,
+  Subject extends GraphDefinitionInput | QueryGraph | RelationalQueryGraph | ComposedQueryGraph,
   Operation = undefined,
   TypeMap extends ScalarOutputTypeMap = DefaultScalarOutputTypeMap,
 > =
-  DefinitionOf<Subject> extends infer Definition extends GraphDefinitionInput
-    ? BuildProjectionResult<ProjectionEntry<Definition, SelectedProjectionField<Definition, Operation>, TypeMap>>
+  Subject extends ComposedQueryGraph<infer Root, infer Relations>
+    ? ComposedResult<Root, Relations, Operation, TypeMap>
+    : DefinitionOf<
+          Extract<Subject, GraphDefinitionInput | QueryGraph | RelationalQueryGraph>
+        > extends infer Definition extends GraphDefinitionInput
+      ? BuildProjectionResult<ProjectionEntry<Definition, SelectedProjectionField<Definition, Operation>, TypeMap>>
+      : never
+
+type SelectedPaths<Operation> = Operation extends { select: readonly (infer Path extends string)[] } ? Path : never
+
+type RootOperation<Operation, Relations extends readonly BatchRelation[]> = Operation extends {
+  select: readonly string[]
+}
+  ? { select: readonly Exclude<SelectedPaths<Operation>, ChildPaths<Relations>>[] }
+  : undefined
+
+type SelectedChildPath<Operation, Name extends string> =
+  Extract<SelectedPaths<Operation>, `${Name}.${string}`> extends `${Name}.${infer Path}` ? Path : never
+
+type ChildOperation<Operation, Name extends string> = {
+  select: readonly SelectedChildPath<Operation, Name>[]
+}
+
+type SelectedRelationCandidate<Relation extends BatchRelation, Operation> = Relation extends BatchRelation
+  ? Extract<SelectedPaths<Operation>, `${Relation['name']}.${string}`> extends never
+    ? never
+    : Relation
+  : never
+
+type SelectedRelation<Relations extends readonly BatchRelation[], Operation> = SelectedRelationCandidate<
+  Relations[number],
+  Operation
+>
+
+type BatchResult<Relation extends BatchRelation, Operation, TypeMap extends ScalarOutputTypeMap> =
+  ResultOf<BatchQueryGraph<Relation['query']>, ChildOperation<Operation, Relation['name']>, TypeMap> extends infer Child
+    ? Relation['cardinality'] extends 'many'
+      ? Child[]
+      : Child | null
     : never
 
+type ComposedResult<
+  Root extends RelationalQueryGraph,
+  Relations extends readonly BatchRelation[],
+  Operation,
+  TypeMap extends ScalarOutputTypeMap,
+> = ResultOf<Root, RootOperation<Operation, Relations>, TypeMap> & {
+  [Relation in SelectedRelation<Relations, Operation> as Relation['name']]: BatchResult<Relation, Operation, TypeMap>
+}
+
 export type SqlServerVersion = '2008' | '2012' | '2016' | '2019' | '2022'
 export type OracleVersion = '11g' | '12c' | '19c' | '21c' | '23ai'
 
@@ -772,7 +1090,7 @@ export interface OracleCompileOptions {
   version?: OracleVersion
 }
 
-export type QueryGraphErrorPhase = 'definition' | 'mapping' | 'operation' | 'sql'
+export type QueryGraphErrorPhase = 'definition' | 'mapping' | 'composition' | 'operation' | 'sql'
 
 export interface QueryGraphDiagnostic {
   code: string

package/dsl.js

@@ -740,3 +740,6 @@ exports.defineGraphModule = defineGraphModule
 exports.defineGraph = defineGraph
 exports.defineSummaryGraph = defineSummaryGraph
 exports.firstBy = firstBy
+exports.batchQuery = require('./composition.js').batchQuery
+exports.batchRelation = require('./composition.js').batchRelation
+exports.composeGraph = require('./composition.js').composeGraph

package/index.d.ts

@@ -1,5 +1,24 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+export declare class CompiledQueryPlan {
+  get root(): CompiledSqlStatement
+  get batches(): Array<CompiledBatchStep>
+  compileBatch(name: string, keys: readonly unknown[]): CompiledSqlStatement
+}
+
+export declare class ComposedQueryGraph {
+  get name(): string
+  withBatchRelation(graph: RelationalQueryGraph, relation: import('./dsl.js').BatchRelationWire): ComposedQueryGraph
+  compileSqlServerPlan(
+    operation: import('./definition.js').QueryOperation,
+    options?: import('./definition.js').SqlServerCompileOptions,
+  ): CompiledQueryPlan
+  compileOraclePlan(
+    operation: import('./definition.js').QueryOperation,
+    options?: import('./definition.js').OracleCompileOptions,
+  ): CompiledQueryPlan
+}
+
 export declare class QueryGraph {
   get name(): string
   get root(): string
@@ -15,6 +34,7 @@ export declare class QueryGraph {
 
 export declare class RelationalQueryGraph {
   get name(): string
+  compose(): ComposedQueryGraph
   compileSqlServer(
     operation: import('./definition.js').QueryOperation,
     options?: import('./definition.js').SqlServerCompileOptions,
@@ -25,6 +45,17 @@ export declare class RelationalQueryGraph {
   ): CompiledSqlStatement
 }
 
+export interface CompiledBatchStep {
+  name: string
+  parentKey: string
+  childKey: string
+  keyParameter: string
+  parameters: Readonly<Record<string, unknown>>
+  cardinality: import('./dsl.js').BatchCardinality
+  parentKeyInjected: boolean
+  childKeyInjected: boolean
+}
+
 export interface CompiledSqlColumn {
   name: string
   path: string
@@ -58,3 +89,5 @@ export interface SqlBinding {
   scalarType: import('./definition.js').ScalarType
   index?: number
 }
+
+export { batchQuery, batchRelation, composeGraph } from './dsl.js'

package/index.js

@@ -80,8 +80,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-android-arm64')
         const bindingPackageVersion = require('@query-graph/core-android-arm64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -96,8 +96,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-android-arm-eabi')
         const bindingPackageVersion = require('@query-graph/core-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -116,8 +116,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-win32-x64-msvc')
         const bindingPackageVersion = require('@query-graph/core-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -132,8 +132,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-win32-ia32-msvc')
         const bindingPackageVersion = require('@query-graph/core-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -148,8 +148,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-win32-arm64-msvc')
         const bindingPackageVersion = require('@query-graph/core-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +167,8 @@ function requireNative() {
     try {
       const binding = require('@query-graph/core-darwin-universal')
       const bindingPackageVersion = require('@query-graph/core-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -183,8 +183,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-darwin-x64')
         const bindingPackageVersion = require('@query-graph/core-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -199,8 +199,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-darwin-arm64')
         const bindingPackageVersion = require('@query-graph/core-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -219,8 +219,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-freebsd-x64')
         const bindingPackageVersion = require('@query-graph/core-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -235,8 +235,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-freebsd-arm64')
         const bindingPackageVersion = require('@query-graph/core-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -256,8 +256,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-x64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -272,8 +272,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-x64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -290,8 +290,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-arm64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -306,8 +306,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-arm64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -324,8 +324,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-arm-musleabihf')
           const bindingPackageVersion = require('@query-graph/core-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -340,8 +340,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@query-graph/core-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -358,8 +358,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-loong64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -374,8 +374,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-loong64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -392,8 +392,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-riscv64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -408,8 +408,8 @@ function requireNative() {
         try {
           const binding = require('@query-graph/core-linux-riscv64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -425,8 +425,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-linux-ppc64-gnu')
         const bindingPackageVersion = require('@query-graph/core-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -441,8 +441,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-linux-s390x-gnu')
         const bindingPackageVersion = require('@query-graph/core-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -461,8 +461,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-openharmony-arm64')
         const bindingPackageVersion = require('@query-graph/core-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -477,8 +477,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-openharmony-x64')
         const bindingPackageVersion = require('@query-graph/core-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -493,8 +493,8 @@ function requireNative() {
       try {
         const binding = require('@query-graph/core-openharmony-arm')
         const bindingPackageVersion = require('@query-graph/core-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '1.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -557,6 +557,12 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.CompiledQueryPlan = nativeBinding.CompiledQueryPlan
+module.exports.ComposedQueryGraph = nativeBinding.ComposedQueryGraph
 module.exports.QueryGraph = nativeBinding.QueryGraph
 module.exports.RelationalQueryGraph = nativeBinding.RelationalQueryGraph
 module.exports.registerDefinition = nativeBinding.registerDefinition
+
+module.exports.batchQuery = require('./composition.js').batchQuery
+module.exports.batchRelation = require('./composition.js').batchRelation
+module.exports.composeGraph = require('./composition.js').composeGraph

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@query-graph/core",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Native query graph planner and SQL compiler for Node.js",
   "workspaces": [
     "packages/*"
@@ -41,6 +41,7 @@
     "node-addon"
   ],
   "files": [
+    "composition.js",
     "definition.d.ts",
     "definition.js",
     "dsl.d.ts",
@@ -135,9 +136,9 @@
   },
   "packageManager": "yarn@4.13.0",
   "optionalDependencies": {
-    "@query-graph/core-win32-x64-msvc": "1.1.0",
-    "@query-graph/core-darwin-x64": "1.1.0",
-    "@query-graph/core-linux-x64-gnu": "1.1.0",
-    "@query-graph/core-darwin-arm64": "1.1.0"
+    "@query-graph/core-win32-x64-msvc": "1.1.1",
+    "@query-graph/core-darwin-x64": "1.1.1",
+    "@query-graph/core-linux-x64-gnu": "1.1.1",
+    "@query-graph/core-darwin-arm64": "1.1.1"
   }
 }