sof-mssql 2.1.0 → 2.3.0

package/dist/queryGenerator/treeWalker/operators/unionAll.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Walker for UnionAll nodes.
+ *
+ * Emits a local derived table with one SELECT per branch, joined by
+ * `UNION ALL`, wrapped as `CROSS APPLY (...) AS ua_<n>`. CTEs from any
+ * branch (e.g. enclosed Repeats) bubble up to the top-level WITH clause.
+ *
+ * Branches must produce the same column names and types (SoF spec
+ * requirement). The walker aligns them positionally — branch[0]'s names
+ * become the outer projection.
+ *
+ * If the same node also has `column[]` or `select[]` alongside `unionAll`,
+ * those are emitted as outer siblings (they live in the SELECT list at the
+ * same level as the ua_<n> projection, evaluated in the parent scope).
+ */
+import type { ViewDefinitionSelect } from "../../../types.js";
+import type { ColumnExpressionGenerator } from "../../ColumnExpressionGenerator.js";
+import type { Context, Fragment } from "../types.js";
+export interface UnionAllDeps {
+    columnGenerator: ColumnExpressionGenerator;
+}
+/**
+ * Walker for UnionAll nodes.
+ *
+ * Walks each branch of `node.unionAll` in the current context and assembles
+ * them into a `CROSS APPLY (...) AS ua_<n>` derived table where each branch
+ * contributes a `SELECT … FROM (SELECT 1 AS _) AS _seed …` statement joined
+ * by `UNION ALL`.  Branch columns are aligned positionally to branch[0]'s
+ * names, satisfying the SoF spec requirement that all branches produce the
+ * same column names and types.
+ *
+ * CTEs from any branch (e.g. produced by enclosed Repeat nodes) bubble up
+ * into the returned Fragment's `ctes` list so they appear in the top-level
+ * `WITH` clause.
+ *
+ * If the same node also carries `column[]` or `select[]` alongside
+ * `unionAll`, those are emitted as outer siblings in the enclosing SELECT
+ * scope and merged with the union fragment via `mergeSiblings`.
+ *
+ * @param node - The UnionAll select node; `node.unionAll` must be a non-empty
+ *   array of branch select nodes.
+ * @param ctx - The current walker context, passed unchanged to every branch
+ *   and to any sibling column/select processing.
+ * @param walk - The recursive walk function used to visit each branch and any
+ *   outer sibling select nodes.
+ * @param deps - Dependencies containing the `ColumnExpressionGenerator` used
+ *   to project any outer sibling `column[]` entries.
+ * @returns A Fragment whose `fromExtensions` contains the `CROSS APPLY`
+ *   derived-table clause, `ctes` aggregates all branch CTEs, and `columns`
+ *   contains the outer projection (plus any sibling columns).
+ * @throws {Error} When `node.unionAll` is empty.
+ */
+export declare function walkUnionAll(node: ViewDefinitionSelect, ctx: Context, walk: (n: ViewDefinitionSelect, c: Context) => Fragment, deps: UnionAllDeps): Fragment;
+//# sourceMappingURL=unionAll.d.ts.map

package/dist/queryGenerator/treeWalker/operators/unionAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unionAll.d.ts","sourceRoot":"","sources":["../../../../src/queryGenerator/treeWalker/operators/unionAll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAGpF,OAAO,KAAK,EACV,OAAO,EAEP,QAAQ,EAET,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,yBAAyB,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,OAAO,KAAK,QAAQ,EACvD,IAAI,EAAE,YAAY,GACjB,QAAQ,CAWV"}

package/dist/queryGenerator/treeWalker/operators/unionAll.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Walker for UnionAll nodes.
+ *
+ * Emits a local derived table with one SELECT per branch, joined by
+ * `UNION ALL`, wrapped as `CROSS APPLY (...) AS ua_<n>`. CTEs from any
+ * branch (e.g. enclosed Repeats) bubble up to the top-level WITH clause.
+ *
+ * Branches must produce the same column names and types (SoF spec
+ * requirement). The walker aligns them positionally — branch[0]'s names
+ * become the outer projection.
+ *
+ * If the same node also has `column[]` or `select[]` alongside `unionAll`,
+ * those are emitted as outer siblings (they live in the SELECT list at the
+ * same level as the ua_<n> projection, evaluated in the parent scope).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkUnionAll = walkUnionAll;
+const aliasGenerator_js_1 = require("../aliasGenerator.js");
+const mergeSiblings_js_1 = require("../mergeSiblings.js");
+const columnsOnly_js_1 = require("./columnsOnly.js");
+/**
+ * Walker for UnionAll nodes.
+ *
+ * Walks each branch of `node.unionAll` in the current context and assembles
+ * them into a `CROSS APPLY (...) AS ua_<n>` derived table where each branch
+ * contributes a `SELECT … FROM (SELECT 1 AS _) AS _seed …` statement joined
+ * by `UNION ALL`.  Branch columns are aligned positionally to branch[0]'s
+ * names, satisfying the SoF spec requirement that all branches produce the
+ * same column names and types.
+ *
+ * CTEs from any branch (e.g. produced by enclosed Repeat nodes) bubble up
+ * into the returned Fragment's `ctes` list so they appear in the top-level
+ * `WITH` clause.
+ *
+ * If the same node also carries `column[]` or `select[]` alongside
+ * `unionAll`, those are emitted as outer siblings in the enclosing SELECT
+ * scope and merged with the union fragment via `mergeSiblings`.
+ *
+ * @param node - The UnionAll select node; `node.unionAll` must be a non-empty
+ *   array of branch select nodes.
+ * @param ctx - The current walker context, passed unchanged to every branch
+ *   and to any sibling column/select processing.
+ * @param walk - The recursive walk function used to visit each branch and any
+ *   outer sibling select nodes.
+ * @param deps - Dependencies containing the `ColumnExpressionGenerator` used
+ *   to project any outer sibling `column[]` entries.
+ * @returns A Fragment whose `fromExtensions` contains the `CROSS APPLY`
+ *   derived-table clause, `ctes` aggregates all branch CTEs, and `columns`
+ *   contains the outer projection (plus any sibling columns).
+ * @throws {Error} When `node.unionAll` is empty.
+ */
+function walkUnionAll(node, ctx, walk, deps) {
+    const branches = node.unionAll ?? [];
+    if (branches.length === 0)
+        throw new Error("walkUnionAll: empty unionAll");
+    const branchFragments = branches.map((b) => walk(b, ctx));
+    const uaFragment = buildUnionAllFragment(branchFragments, ctx);
+    const outerSiblings = collectOuterSiblings(node, ctx, walk, deps);
+    return outerSiblings.length === 0
+        ? uaFragment
+        : (0, mergeSiblings_js_1.mergeSiblings)([...outerSiblings, uaFragment], ctx);
+}
+function buildUnionAllFragment(branchFragments, ctx) {
+    const uaAlias = (0, aliasGenerator_js_1.freshAlias)(ctx, "ua");
+    const allCtes = branchFragments.flatMap((f) => f.ctes);
+    const referenceColumns = branchFragments[0].columns;
+    const branchSqls = branchFragments.map((f) => renderBranchSelect(f, referenceColumns));
+    const unionDerivedTable = `(\n  ${branchSqls.join("\n  UNION ALL\n  ")}\n) AS ${uaAlias}`;
+    const uaColumns = referenceColumns.map((c) => ({
+        name: c.name,
+        sqlExpr: `${uaAlias}.[${c.name}]`,
+    }));
+    return {
+        ctes: allCtes,
+        fromExtensions: `\nCROSS APPLY ${unionDerivedTable}`,
+        columns: uaColumns,
+        partitionKeys: ctx.partitionKeys,
+    };
+}
+function collectOuterSiblings(node, ctx, walk, deps) {
+    const out = [];
+    if (node.column && node.column.length > 0) {
+        out.push({
+            ctes: [],
+            fromExtensions: "",
+            columns: (0, columnsOnly_js_1.projectColumns)(node.column, ctx, deps.columnGenerator),
+            partitionKeys: ctx.partitionKeys,
+        });
+    }
+    if (node.select) {
+        for (const child of node.select)
+            out.push(walk(child, ctx));
+    }
+    return out;
+}
+/**
+ * Renders one branch's SELECT inside the unionAll derived table.
+ *
+ * The seed `(SELECT 1 AS _) AS _seed` ensures the branch always has a
+ * FROM clause to attach its CROSS/OUTER APPLY chain to, and keeps the SQL
+ * uniform whether the branch has operators or not. No unique suffix is
+ * needed because each SELECT in a UNION ALL has its own independent FROM
+ * scope — `_seed` in one branch cannot collide with `_seed` in another.
+ *
+ * Columns are re-aliased to branch[0]'s names so the outer projection by
+ * name works for every branch row.
+ */
+function renderBranchSelect(fragment, referenceColumns) {
+    const projection = referenceColumns
+        .map((ref, i) => {
+        const branchCol = fragment.columns[i];
+        if (!branchCol) {
+            throw new Error(`unionAll branch is missing column at index ${i} (expected '${ref.name}')`);
+        }
+        return `${branchCol.sqlExpr} AS [${ref.name}]`;
+    })
+        .join(", ");
+    return `SELECT ${projection} FROM (SELECT 1 AS _) AS _seed${fragment.fromExtensions}`;
+}
+//# sourceMappingURL=unionAll.js.map

package/dist/queryGenerator/treeWalker/operators/unionAll.js.map

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

package/dist/queryGenerator/treeWalker/render.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Renders a root Fragment into the final T-SQL statement:
+ *
+ *   WITH <ctes> SELECT <cols> FROM <root> <fromExtensions> WHERE <pred>
+ */
+import type { TranspilerContext } from "../../fhirpath/transpiler.js";
+import type { ViewDefinition } from "../../types.js";
+import type { WhereClauseBuilder } from "../WhereClauseBuilder.js";
+import type { Fragment } from "./types.js";
+export interface RenderOptions {
+    resourceAlias: string;
+    schemaName: string;
+    tableName: string;
+    testId?: string;
+    whereClauseBuilder: WhereClauseBuilder;
+    transpilerCtx: TranspilerContext;
+}
+/**
+ * Renders a root Fragment into the final T-SQL statement.
+ *
+ * Assembles the optional `WITH <ctes>` preamble, the `SELECT <cols>` list,
+ * the `FROM <table>` clause, any `fromExtensions` (APPLY / JOIN chains), and
+ * the optional `WHERE` predicate built by `WhereClauseBuilder`.
+ *
+ * @param fragment - The root Fragment produced by walking the select tree.
+ * @param viewDef - The ViewDefinition supplying the resource type, WHERE
+ *   predicates, and other metadata needed to construct the WHERE clause.
+ * @param options - Render options including table/schema names, resource alias,
+ *   optional test-isolation ID, the where-clause builder, and the transpiler
+ *   context.
+ * @returns The complete T-SQL query string ready for execution.
+ */
+export declare function renderRoot(fragment: Fragment, viewDef: ViewDefinition, options: RenderOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/queryGenerator/treeWalker/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/queryGenerator/treeWalker/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,aAAa,GACrB,MAAM,CA6BR"}

package/dist/queryGenerator/treeWalker/render.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Renders a root Fragment into the final T-SQL statement:
+ *
+ *   WITH <ctes> SELECT <cols> FROM <root> <fromExtensions> WHERE <pred>
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRoot = renderRoot;
+/**
+ * Renders a root Fragment into the final T-SQL statement.
+ *
+ * Assembles the optional `WITH <ctes>` preamble, the `SELECT <cols>` list,
+ * the `FROM <table>` clause, any `fromExtensions` (APPLY / JOIN chains), and
+ * the optional `WHERE` predicate built by `WhereClauseBuilder`.
+ *
+ * @param fragment - The root Fragment produced by walking the select tree.
+ * @param viewDef - The ViewDefinition supplying the resource type, WHERE
+ *   predicates, and other metadata needed to construct the WHERE clause.
+ * @param options - Render options including table/schema names, resource alias,
+ *   optional test-isolation ID, the where-clause builder, and the transpiler
+ *   context.
+ * @returns The complete T-SQL query string ready for execution.
+ */
+function renderRoot(fragment, viewDef, options) {
+    const { resourceAlias, schemaName, tableName } = options;
+    const tableRef = `[${schemaName}].[${tableName}]`;
+    const cteSection = fragment.ctes.length > 0
+        ? `WITH\n${fragment.ctes.map((c) => `${c.alias} AS (\n${c.body}\n)`).join(",\n")}\n`
+        : "";
+    const selectList = fragment.columns
+        .map((c) => `${c.sqlExpr} AS [${c.name}]`)
+        .join(",\n  ");
+    const fromClause = `FROM ${tableRef} AS [${resourceAlias}]`;
+    const whereClause = options.whereClauseBuilder.buildWhereClause(viewDef.resource, resourceAlias, options.testId, viewDef.where, options.transpilerCtx);
+    let body = `SELECT\n  ${selectList}\n${fromClause}${fragment.fromExtensions}`;
+    if (whereClause !== null) {
+        body += `\n${whereClause}`;
+    }
+    return `${cteSection}${body}`;
+}
+//# sourceMappingURL=render.js.map

package/dist/queryGenerator/treeWalker/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/queryGenerator/treeWalker/render.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA+BH,gCAiCC;AAhDD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,UAAU,CACxB,QAAkB,EAClB,OAAuB,EACvB,OAAsB;IAEtB,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,UAAU,MAAM,SAAS,GAAG,CAAC;IAElD,MAAM,UAAU,GACd,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACtB,CAAC,CAAC,SAAS,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;QACpF,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC;SACzC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjB,MAAM,UAAU,GAAG,QAAQ,QAAQ,QAAQ,aAAa,GAAG,CAAC;IAE5D,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAC7D,OAAO,CAAC,QAAQ,EAChB,aAAa,EACb,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,aAAa,CACtB,CAAC;IAEF,IAAI,IAAI,GAAG,aAAa,UAAU,KAAK,UAAU,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC9E,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/queryGenerator/treeWalker/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Core types for the tree-walker query generator.
+ *
+ * Each select-tree node produces a Fragment; sibling fragments are merged
+ * via partition-key joins. Context threads through descent, accumulating
+ * the current JSON source, partition keys, and APPLY chain.
+ */
+import type { TranspilerContext } from "../../fhirpath/transpiler.js";
+export declare const SQL_INT = "INT";
+export declare const SQL_NVARCHAR_4000 = "NVARCHAR(4000)";
+export declare const SQL_NVARCHAR_MAX = "NVARCHAR(MAX)";
+export type NodeKind = "ColumnsOnly" | "Group" | "ForEach" | "ForEachOrNull" | "Repeat" | "UnionAll";
+export interface PartitionKey {
+    /** Logical name, e.g. "id", "fe_0_key", "repeat_2_path". */
+    name: string;
+    /** SQL expression that yields it in the *defining* scope. */
+    sqlExpr: string;
+    /** Type used when projecting it through a CTE column list. */
+    sqlType: string;
+}
+export interface ProjectedColumn {
+    /** Bracketed identifier as it appears in the final SELECT list. */
+    name: string;
+    sqlExpr: string;
+}
+export interface CteDefinition {
+    alias: string;
+    /** Full SQL body without the "alias AS (...)" wrapper. */
+    body: string;
+}
+export interface Context {
+    resourceAlias: string;
+    /** Current JSON source expression, e.g. "r.json", "forEach_0.value". */
+    source: string;
+    /** Ordered, monotonically appended as the walker descends. */
+    partitionKeys: PartitionKey[];
+    /**
+     * CROSS/OUTER APPLY chain accumulated above this point, needed so any
+     * enclosed Repeat CTE anchor can reach `ctx.source`. Each element starts
+     * with "\n".
+     */
+    ancestorApplies: string;
+    /** Shared mutable counter for unique CTE/alias names across the whole compile. */
+    cteCounter: {
+        value: number;
+    };
+    /** Pass-through context for the FHIRPath transpiler. */
+    transpilerCtx: TranspilerContext;
+}
+export interface Fragment {
+    ctes: CteDefinition[];
+    /**
+     * Ordered sequence of FROM-clause extensions: a mix of CROSS/OUTER APPLY
+     * and INNER/LEFT/FULL OUTER JOIN clauses, each prefixed by "\n". Order is
+     * preserved so that aliases are always introduced before they are
+     * referenced (e.g. an INNER JOIN to a Repeat CTE precedes any CROSS APPLY
+     * that reads from the CTE's `item_json`).
+     */
+    fromExtensions: string;
+    columns: ProjectedColumn[];
+    /** Keys exposed by this fragment for use by sibling joins. */
+    partitionKeys: PartitionKey[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/queryGenerator/treeWalker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/queryGenerator/treeWalker/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAClD,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,OAAO,GACP,SAAS,GACT,eAAe,GACf,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,wDAAwD;IACxD,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B"}

package/dist/queryGenerator/treeWalker/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Core types for the tree-walker query generator.
+ *
+ * Each select-tree node produces a Fragment; sibling fragments are merged
+ * via partition-key joins. Context threads through descent, accumulating
+ * the current JSON source, partition keys, and APPLY chain.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQL_NVARCHAR_MAX = exports.SQL_NVARCHAR_4000 = exports.SQL_INT = void 0;
+exports.SQL_INT = "INT";
+exports.SQL_NVARCHAR_4000 = "NVARCHAR(4000)";
+exports.SQL_NVARCHAR_MAX = "NVARCHAR(MAX)";
+//# sourceMappingURL=types.js.map

package/dist/queryGenerator/treeWalker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/queryGenerator/treeWalker/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIU,QAAA,OAAO,GAAG,KAAK,CAAC;AAChB,QAAA,iBAAiB,GAAG,gBAAgB,CAAC;AACrC,QAAA,gBAAgB,GAAG,eAAe,CAAC"}

package/dist/queryGenerator/treeWalker/walker.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Recursive dispatch — visits a select-tree node and produces a Fragment.
+ *
+ * Each node kind has its own walker; this module just dispatches via
+ * classifyNode. Operators not yet implemented throw a clear error.
+ */
+import type { ViewDefinitionSelect } from "../../types.js";
+import type { ColumnExpressionGenerator } from "../ColumnExpressionGenerator.js";
+import type { PathParser } from "../PathParser.js";
+import type { Context, Fragment } from "./types.js";
+export interface WalkerDeps {
+    columnGenerator: ColumnExpressionGenerator;
+    pathParser: PathParser;
+    schemaName: string;
+    tableName: string;
+}
+/**
+ * Creates the recursive walk function used to traverse the select tree.
+ *
+ * The returned `walk` function classifies each `ViewDefinitionSelect` node via
+ * `classifyNode` and dispatches to the appropriate operator walker
+ * (`walkColumnsOnly`, `walkGroup`, `walkForEach`, `walkRepeat`, or
+ * `walkUnionAll`). The same `walk` reference is threaded into every operator
+ * so they can recurse into child nodes without circular imports.
+ *
+ * @param deps - External service dependencies shared across all operator
+ *   walkers: a `ColumnExpressionGenerator`, a `PathParser`, and the target
+ *   schema/table names used by the Repeat CTE builder.
+ * @returns A `walk` function that accepts a node and a `Context` and returns
+ *   the corresponding `Fragment`.
+ * @throws {Error} When a node's kind is not handled (should not occur given
+ *   the exhaustive `classifyNode` discriminants, but TypeScript exhaustiveness
+ *   checking requires the switch to be complete).
+ */
+export declare function makeWalker(deps: WalkerDeps): (node: ViewDefinitionSelect, ctx: Context) => Fragment;
+//# sourceMappingURL=walker.d.ts.map

package/dist/queryGenerator/treeWalker/walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../../../src/queryGenerator/treeWalker/walker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,yBAAyB,CAAC;IAC3C,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,GACf,CAAC,IAAI,EAAE,oBAAoB,EAAE,GAAG,EAAE,OAAO,KAAK,QAAQ,CAuBxD"}

package/dist/queryGenerator/treeWalker/walker.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Recursive dispatch — visits a select-tree node and produces a Fragment.
+ *
+ * Each node kind has its own walker; this module just dispatches via
+ * classifyNode. Operators not yet implemented throw a clear error.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeWalker = makeWalker;
+const classify_js_1 = require("./classify.js");
+const columnsOnly_js_1 = require("./operators/columnsOnly.js");
+const forEach_js_1 = require("./operators/forEach.js");
+const group_js_1 = require("./operators/group.js");
+const repeat_js_1 = require("./operators/repeat.js");
+const unionAll_js_1 = require("./operators/unionAll.js");
+/**
+ * Creates the recursive walk function used to traverse the select tree.
+ *
+ * The returned `walk` function classifies each `ViewDefinitionSelect` node via
+ * `classifyNode` and dispatches to the appropriate operator walker
+ * (`walkColumnsOnly`, `walkGroup`, `walkForEach`, `walkRepeat`, or
+ * `walkUnionAll`). The same `walk` reference is threaded into every operator
+ * so they can recurse into child nodes without circular imports.
+ *
+ * @param deps - External service dependencies shared across all operator
+ *   walkers: a `ColumnExpressionGenerator`, a `PathParser`, and the target
+ *   schema/table names used by the Repeat CTE builder.
+ * @returns A `walk` function that accepts a node and a `Context` and returns
+ *   the corresponding `Fragment`.
+ * @throws {Error} When a node's kind is not handled (should not occur given
+ *   the exhaustive `classifyNode` discriminants, but TypeScript exhaustiveness
+ *   checking requires the switch to be complete).
+ */
+function makeWalker(deps) {
+    function walk(node, ctx) {
+        const kind = (0, classify_js_1.classifyNode)(node);
+        switch (kind) {
+            case "ColumnsOnly":
+                return (0, columnsOnly_js_1.walkColumnsOnly)(node, ctx, deps.columnGenerator);
+            case "Group":
+                return (0, group_js_1.walkGroup)(node, ctx, walk, deps.columnGenerator);
+            case "ForEach":
+            case "ForEachOrNull":
+                return (0, forEach_js_1.walkForEach)(node, ctx, walk, { pathParser: deps.pathParser });
+            case "Repeat":
+                return (0, repeat_js_1.walkRepeat)(node, ctx, walk, {
+                    schemaName: deps.schemaName,
+                    tableName: deps.tableName,
+                });
+            case "UnionAll":
+                return (0, unionAll_js_1.walkUnionAll)(node, ctx, walk, {
+                    columnGenerator: deps.columnGenerator,
+                });
+        }
+    }
+    return walk;
+}
+//# sourceMappingURL=walker.js.map

package/dist/queryGenerator/treeWalker/walker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.js","sourceRoot":"","sources":["../../../src/queryGenerator/treeWalker/walker.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsCH,gCAyBC;AA1DD,+CAA6C;AAC7C,+DAA6D;AAC7D,uDAAqD;AACrD,mDAAiD;AACjD,qDAAmD;AACnD,yDAAuD;AAUvD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,UAAU,CACxB,IAAgB;IAEhB,SAAS,IAAI,CAAC,IAA0B,EAAE,GAAY;QACpD,MAAM,IAAI,GAAG,IAAA,0BAAY,EAAC,IAAI,CAAC,CAAC;QAChC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,aAAa;gBAChB,OAAO,IAAA,gCAAe,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1D,KAAK,OAAO;gBACV,OAAO,IAAA,oBAAS,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1D,KAAK,SAAS,CAAC;YACf,KAAK,eAAe;gBAClB,OAAO,IAAA,wBAAW,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,KAAK,QAAQ;gBACX,OAAO,IAAA,sBAAU,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;oBACjC,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;YACL,KAAK,UAAU;gBACb,OAAO,IAAA,0BAAY,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;oBACnC,eAAe,EAAE,IAAI,CAAC,eAAe;iBACtC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/queryGenerator.d.ts

@@ -1,6 +1,9 @@
 /**
  * T-SQL query generator for ViewDefinition structures.
- * Generates SQL queries that can be executed against MS SQL Server.
+ *
+ * Public façade over the tree-walker query compiler. Builds the base
+ * transpiler context (resource alias, constants, optional test id) and
+ * delegates SQL generation to `compileViewDefinition`.
  */
 import { TranspilationResult, ViewDefinition } from "./types.js";
 export interface QueryGeneratorOptions {
@@ -10,112 +13,23 @@ export interface QueryGeneratorOptions {
     resourceJsonColumn?: string;
 }
 /**
- * Main query generator that orchestrates SQL generation from ViewDefinitions.
+ * Compiles a SQL on FHIR `ViewDefinition` to a T-SQL query.
  */
 export declare class QueryGenerator {
     private readonly options;
-    private readonly pathParser;
-    private readonly combinationExpander;
-    private readonly forEachProcessor;
-    private readonly repeatProcessor;
-    private readonly selectClauseBuilder;
-    private readonly whereClauseBuilder;
-    private readonly columnGenerator;
     constructor(options?: QueryGeneratorOptions);
     /**
      * Generate a T-SQL query from a ViewDefinition.
      */
     generateQuery(viewDef: ViewDefinition, testId?: string): TranspilationResult;
     /**
-     * Result of generating all SELECT statements.
-     */
-    private generateAllSelectStatements;
-    /**
-     * Generate a complete SQL statement for a specific combination.
-     *
-     * Routes to the appropriate statement generator based on the directives
-     * present in the combination:
-     * - Repeat statements use recursive CTEs.
-     * - ForEach statements use CROSS APPLY.
-     * - Simple statements have neither.
-     *
-     * @param combination - The select combination to generate.
-     * @param viewDef - The ViewDefinition being processed.
-     * @param context - The transpiler context.
-     * @param isMultiUnion - If true, CTEs are returned separately for consolidation.
-     * @param cteCounter - Shared counter for unique CTE aliases across combinations.
-     * @returns The statement and any CTE definitions (empty if not repeat or single statement).
-     */
-    private generateStatementForCombination;
-    /**
-     * Generate a simple SELECT statement without forEach.
-     */
-    private generateSimpleStatement;
-    /**
-     * Generate a SELECT statement with forEach using CROSS APPLY.
-     */
-    private generateForEachStatement;
-    /**
-     * Generate a SELECT statement with repeat using recursive CTEs.
-     *
-     * The repeat directive generates a recursive CTE that traverses a tree
-     * structure by following one or more paths at each level. The CTE is then
-     * joined to the main query using INNER JOIN.
-     *
-     * If the combination also contains forEach, the forEach is processed after
-     * the repeat CTE, using the repeat context as its source.
-     *
-     * @param combination - The select combination being processed.
-     * @param viewDef - The ViewDefinition.
-     * @param context - The transpiler context.
-     * @param isMultiUnion - If true, return CTE definitions separately for consolidation.
-     * @param cteCounter - Shared counter for unique CTE aliases across combinations.
-     * @returns Statement and CTE definitions.
-     */
-    private generateRepeatStatement;
-    /**
-     * Build select clause and forEach apply clauses for repeat statements.
-     */
-    private buildRepeatSelectAndForEach;
-    /**
-     * Assemble the final repeat statement from its components.
-     */
-    private assembleRepeatStatement;
-    /**
-     * Update forEach source expressions to use repeat CTE instead of resource JSON.
-     *
-     * When forEach is nested inside repeat, the forEach should iterate over
-     * arrays within the repeat context (e.g., repeat_0.item_json) rather than
-     * the root resource JSON.
-     */
-    private updateForEachSourcesForRepeat;
-    /**
-     * Find the repeat select that contains a given forEach select.
-     */
-    private findContainingRepeat;
-    /**
-     * Check if a forEach select is nested within a repeat select.
-     */
-    private isForEachNestedInRepeat;
-    /**
-     * Recursively check if a select is nested within a list of selects.
-     */
-    private isSelectNestedIn;
-    /**
-     * Generate the FROM clause.
-     */
-    private generateFromClause;
-    /**
-     * Create the base transpiler context.
+     * Create the base transpiler context with resource alias and constants.
      */
     private createBaseContext;
     /**
-     * Extract the value from a ViewDefinitionConstant.
+     * Extract the value from a ViewDefinitionConstant. Throws if zero or more
+     * than one `value[x]` element is set.
      */
     private getConstantValue;
-    /**
-     * Collect all column definitions from select elements.
-     */
-    private collectAllColumns;
 }
 //# sourceMappingURL=queryGenerator.d.ts.map

package/dist/queryGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryGenerator.d.ts","sourceRoot":"","sources":["../src/queryGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,EAEL,mBAAmB,EACnB,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;gBAEhD,OAAO,GAAE,qBAA0B;IAmB/C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,mBAAmB;IA8B5E;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA+BnC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,+BAA+B;IAgCvC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsChC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,uBAAuB;IAgD/B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA2CnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8CxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA0B1B"}
+{"version":3,"file":"queryGenerator.d.ts","sourceRoot":"","sources":["../src/queryGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,mBAAmB,EACnB,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAE9C,OAAO,GAAE,qBAA0B;IAU/C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAc5E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CA6CzB"}