sof-mssql 1.0.0

package/dist/tests/utils/reporter.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Custom Vitest reporter for SQL-on-FHIR test result collection.
+ *
+ * Collects test results during Vitest execution and formats them according
+ * to the FHIR sql-on-fhir-v2 test report schema. Results are stored globally
+ * and can be accessed after test completion for report generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Custom Vitest reporter that collects SQL-on-FHIR test results.
+ */
+class SqlOnFhirReporter {
+    options;
+    testReport = {};
+    constructor(options = {}) {
+        this.options = {
+            outputPath: "out/test-report.json",
+            autoWriteReport: true,
+            printSummary: true,
+            ...options,
+        };
+    }
+    /**
+     * Called when all tests have finished running.
+     * @deprecated use onTestRunEnd instead
+     */
+    onFinished(files, _errors, _coverage) {
+        if (!files)
+            return;
+        // Collect results from global storage set by dynamic tests
+        if (typeof global !== "undefined" && global.testResults) {
+            this.testReport = global.testResults;
+        }
+        // Also collect from Vitest task results as fallback
+        this.collectFromVitestTasks(files);
+        // Print summary if enabled
+        if (this.options.printSummary) {
+            this.printTestSummary(files);
+        }
+        // Write report file if enabled
+        if (this.options.autoWriteReport && this.options.outputPath) {
+            this.writeReport(this.options.outputPath);
+        }
+    }
+    /**
+     * Print a summary of test results to the console.
+     */
+    printTestSummary(files) {
+        const stats = this.calculateTestStatistics(files);
+        if (stats.skipped > 0) {
+            console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+            console.log("SQL on FHIR Test Summary");
+            console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+            console.log(`Passed:  ${stats.passed}`);
+            console.log(`Failed:  ${stats.failed}`);
+            console.log(`Skipped: ${stats.skipped}`);
+            console.log(`Total:   ${stats.total}`);
+            // Check for test name pattern filtering (used in CI)
+            if (process.argv.some((arg) => arg.includes("testNamePattern"))) {
+                console.log("\nNote: Tests tagged with #experimental were excluded from this run.");
+                console.log("These tests cover features outside the scope of this implementation.");
+            }
+            console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+        }
+    }
+    /**
+     * Calculate test statistics from Vitest task results.
+     */
+    calculateTestStatistics(files) {
+        let passed = 0;
+        let failed = 0;
+        let skipped = 0;
+        for (const file of files) {
+            if (!file.tasks)
+                continue;
+            for (const task of file.tasks) {
+                const stats = this.countTestsInTask(task);
+                passed += stats.passed;
+                failed += stats.failed;
+                skipped += stats.skipped;
+            }
+        }
+        return {
+            passed,
+            failed,
+            skipped,
+            total: passed + failed + skipped,
+        };
+    }
+    /**
+     * Recursively count test results in a task.
+     */
+    countTestsInTask(task) {
+        let passed = 0;
+        let failed = 0;
+        let skipped = 0;
+        if (task.type === "test") {
+            if (task.mode === "skip" || task.result?.state === "skip") {
+                skipped++;
+            }
+            else if (task.result?.state === "pass") {
+                passed++;
+            }
+            else if (task.result?.state === "fail") {
+                failed++;
+            }
+        }
+        else if ("tasks" in task && task.tasks) {
+            for (const subtask of task.tasks) {
+                const stats = this.countTestsInTask(subtask);
+                passed += stats.passed;
+                failed += stats.failed;
+                skipped += stats.skipped;
+            }
+        }
+        return { passed, failed, skipped };
+    }
+    /**
+     * Write the test report to a JSON file.
+     */
+    writeReport(outputPath) {
+        try {
+            // Ensure the output directory exists
+            const outputDir = (0, path_1.dirname)(outputPath);
+            (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+            const reportJson = JSON.stringify(this.testReport, null, 2);
+            (0, fs_1.writeFileSync)(outputPath, reportJson, "utf8");
+        }
+        catch (error) {
+            console.error(`Failed to write test report to ${outputPath}:`, error);
+        }
+    }
+    /**
+     * Collect test results from Vitest task results as fallback.
+     * Groups tests by their source file (e.g., "basic.json", "collection.json").
+     */
+    collectFromVitestTasks(files) {
+        for (const file of files) {
+            if (!file.tasks)
+                continue;
+            for (const task of file.tasks) {
+                if (task.type === "suite" &&
+                    task.name === "SQL on FHIR compliance tests") {
+                    this.collectTestsFromParentSuite(task);
+                }
+            }
+        }
+    }
+    /**
+     * Collect tests from the parent "SQL on FHIR compliance tests" suite.
+     * Processes child suites and groups tests by filename.
+     */
+    collectTestsFromParentSuite(parentSuite) {
+        if (!("tasks" in parentSuite) || !parentSuite.tasks)
+            return;
+        // The parent suite contains child suites for each test file
+        // (e.g., "basic", "collection", "foreach")
+        for (const childSuite of parentSuite.tasks) {
+            if (childSuite.type !== "suite")
+                continue;
+            // Derive filename from suite name (e.g., "basic" → "basic.json")
+            const fileName = `${childSuite.name}.json`;
+            const suiteTests = this.collectTestsFromSuite(childSuite, false);
+            if (suiteTests.length > 0) {
+                this.testReport[fileName] = {
+                    tests: suiteTests,
+                };
+            }
+        }
+    }
+    /**
+     * Collect test results from a test suite.
+     *
+     * Note: This is a fallback mechanism. The primary test result collection
+     * happens in the DynamicVitestGenerator which stores results in global.testResults.
+     * This method extracts the plain test title from the formatted test name.
+     *
+     * @param suite The test suite to collect from
+     * @param recursive Whether to recursively collect from nested suites
+     */
+    collectTestsFromSuite(suite, recursive = true) {
+        const tests = [];
+        if ("tasks" in suite && suite.tasks) {
+            for (const task of suite.tasks) {
+                if (task.type === "test") {
+                    // Extract plain title from formatted name: "(suite) title #tag" -> "title"
+                    const plainTitle = this.extractPlainTitle(task.name);
+                    tests.push({
+                        name: plainTitle,
+                        result: {
+                            passed: task.result?.state === "pass",
+                        },
+                    });
+                }
+                else if (task.type === "suite" && recursive) {
+                    // Recursively collect from nested suites only if recursive is true
+                    tests.push(...this.collectTestsFromSuite(task, recursive));
+                }
+            }
+        }
+        return tests;
+    }
+    /**
+     * Extract the plain test title from a formatted test name.
+     * Formatted: "(suite) title #tag1 #tag2"
+     * Plain: "title"
+     */
+    extractPlainTitle(formattedName) {
+        // Remove suite prefix: "(suite) " -> ""
+        let title = formattedName.replace(/^\([^)]+\)\s+/, "");
+        // Remove tags: " #tag1 #tag2" -> ""
+        title = title.replace(/\s+#\S+/g, "");
+        return title.trim();
+    }
+    /**
+     * Clear the collected test results.
+     */
+    clearResults() {
+        this.testReport = {};
+        if (typeof global !== "undefined") {
+            global.testResults = {};
+        }
+    }
+    // Optional Vitest reporter methods (can be implemented as needed)
+    onInit(_ctx) {
+        // Clear results when reporter initializes
+        this.clearResults();
+    }
+    onUserConsoleLog(_log) {
+        // Pass through console logs
+    }
+    onWatcherStart() {
+        // Called when in watch mode
+    }
+    onWatcherRerun(_files, _trigger) {
+        // Called on file changes in watch mode
+        this.clearResults();
+    }
+}
+// Used in vitest.config.ts as a custom reporter
+exports.default = SqlOnFhirReporter;
+//# sourceMappingURL=reporter.js.map

package/dist/tests/utils/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../src/tests/utils/reporter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAEH,2BAA8C;AAC9C,+BAA+B;AAc/B;;GAEG;AACH,MAAM,iBAAiB;IACJ,OAAO,CAA2B;IAC3C,UAAU,GAAe,EAAE,CAAC;IAEpC,YAAY,UAAoC,EAAE;QAChD,IAAI,CAAC,OAAO,GAAG;YACb,UAAU,EAAE,sBAAsB;YAClC,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,UAAU,CACR,KAAwB,EACxB,OAAmB,EACnB,SAAmB;QAEnB,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,2DAA2D;QAC3D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAK,MAAc,CAAC,WAAW,EAAE,CAAC;YACjE,IAAI,CAAC,UAAU,GAAI,MAAc,CAAC,WAAW,CAAC;QAChD,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAEnC,2BAA2B;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAuB;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAElD,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAEvC,qDAAqD;YACrD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAC;gBACF,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,KAAuB;QAMrD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAE1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;gBACvB,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM;YACN,MAAM;YACN,OAAO;YACP,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAgB;QAKvC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC1D,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC;gBACzC,MAAM,EAAE,CAAC;YACX,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC;gBACzC,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;gBACvB,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB;QAC5B,IAAI,CAAC;YACH,qCAAqC;YACrC,MAAM,SAAS,GAAG,IAAA,cAAO,EAAC,UAAU,CAAC,CAAC;YACtC,IAAA,cAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5D,IAAA,kBAAa,EAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAAC,KAAuB;QACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAE1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,IACE,IAAI,CAAC,IAAI,KAAK,OAAO;oBACrB,IAAI,CAAC,IAAI,KAAK,8BAA8B,EAC5C,CAAC;oBACD,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,2BAA2B,CAAC,WAAuB;QACzD,IAAI,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK;YAAE,OAAO;QAE5D,4DAA4D;QAC5D,2CAA2C;QAC3C,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS;YAE1C,iEAAiE;YACjE,MAAM,QAAQ,GAAG,GAAG,UAAU,CAAC,IAAI,OAAO,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAEjE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG;oBAC1B,KAAK,EAAE,UAAU;iBAClB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACK,qBAAqB,CAC3B,KAAiB,EACjB,SAAS,GAAG,IAAI;QAEhB,MAAM,KAAK,GAAsB,EAAE,CAAC;QAEpC,IAAI,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACzB,2EAA2E;oBAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACrD,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE;4BACN,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM;yBACtC;qBACF,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,SAAS,EAAE,CAAC;oBAC9C,mEAAmE;oBACnE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,aAAqB;QAC7C,wCAAwC;QACxC,IAAI,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACvD,oCAAoC;QACpC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,MAAc,CAAC,WAAW,GAAG,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAE,IAAS;QACf,0CAA0C;QAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,gBAAgB,CAAE,IAAS;QACzB,4BAA4B;IAC9B,CAAC;IAED,cAAc;QACZ,4BAA4B;IAC9B,CAAC;IAED,cAAc,CAAE,MAAgB,EAAE,QAAiB;QACjD,uCAAuC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;CACF;AAED,gDAAgD;AAChD,kBAAe,iBAAiB,CAAC"}

package/dist/tests/utils/sqlOnFhir.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared utilities for SQL-on-FHIR Vitest tests.
+ *
+ * Provides functions for ViewDefinition transpilation, SQL execution,
+ * result comparison, and other common test operations.
+ */
+import { ViewDefinition } from "../../types";
+/**
+ * Result of executing a ViewDefinition with column metadata.
+ */
+export interface ViewDefinitionResult {
+    results: any[];
+    columns: string[];
+}
+/**
+ * Execute a ViewDefinition against the database and return the results with column metadata.
+ *
+ * @param viewDefinition - The ViewDefinition to transpile and execute
+ * @param testId - Unique test identifier for data isolation
+ * @returns Object containing results array and column names in SQL order
+ */
+export declare function executeViewDefinition(viewDefinition: ViewDefinition, testId: string): Promise<ViewDefinitionResult>;
+/**
+ * Compare actual results with expected results, handling various data types and formats.
+ *
+ * @param actualResults - The actual query results
+ * @param expectedResults - The expected results from the test case
+ * @param expectedColumns - Optional array of expected column names
+ * @param actualColumns - Optional array of actual column names from SQL metadata
+ * @returns true if results match, false otherwise
+ */
+export declare function compareResults(actualResults: any[], expectedResults: any[], expectedColumns?: string[], actualColumns?: string[]): boolean;
+//# sourceMappingURL=sqlOnFhir.d.ts.map

package/dist/tests/utils/sqlOnFhir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlOnFhir.d.ts","sourceRoot":"","sources":["../../../src/tests/utils/sqlOnFhir.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkB7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAqC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,GAAG,EAAE,EACpB,eAAe,EAAE,GAAG,EAAE,EACtB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAkDT"}

package/dist/tests/utils/sqlOnFhir.js

@@ -0,0 +1,281 @@
+"use strict";
+/**
+ * Shared utilities for SQL-on-FHIR Vitest tests.
+ *
+ * Provides functions for ViewDefinition transpilation, SQL execution,
+ * result comparison, and other common test operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeViewDefinition = executeViewDefinition;
+exports.compareResults = compareResults;
+const mssql_1 = require("mssql");
+const queryGenerator_1 = require("../../queryGenerator");
+const database_1 = require("./database");
+let queryGeneratorInstance = null;
+/**
+ * Get or create the QueryGenerator instance with database configuration.
+ */
+function getQueryGeneratorInstance() {
+    queryGeneratorInstance ??= new queryGenerator_1.QueryGenerator({
+        tableName: process.env.MSSQL_TEST_TABLE ?? "fhir_resources_test",
+        schemaName: process.env.MSSQL_SCHEMA ?? "dbo",
+        resourceIdColumn: "id",
+        resourceJsonColumn: "json",
+    });
+    return queryGeneratorInstance;
+}
+/**
+ * Execute a ViewDefinition against the database and return the results with column metadata.
+ *
+ * @param viewDefinition - The ViewDefinition to transpile and execute
+ * @param testId - Unique test identifier for data isolation
+ * @returns Object containing results array and column names in SQL order
+ */
+async function executeViewDefinition(viewDefinition, testId) {
+    try {
+        // Get database connection
+        const pool = (0, database_1.getDatabasePool)();
+        const queryGenerator = getQueryGeneratorInstance();
+        // Generate T-SQL query with test_id filter
+        const transpilationResult = queryGenerator.generateQuery(viewDefinition, testId);
+        const sql = transpilationResult.sql;
+        // Log the generated SQL for debugging
+        console.log("Generated SQL:", sql);
+        // Execute the query
+        const request = new mssql_1.Request(pool);
+        const queryResult = await request.query(sql);
+        // Extract column names from the query result metadata
+        // This preserves the actual SQL column order
+        const columns = Object.keys(queryResult.recordset.columns || {});
+        // Extract boolean column names from ViewDefinition
+        const booleanColumns = extractBooleanColumns(viewDefinition);
+        // Parse JSON strings and convert boolean columns in results
+        return {
+            results: parseJsonStringsInResults(queryResult.recordset, booleanColumns),
+            columns,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to execute ViewDefinition: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Compare actual results with expected results, handling various data types and formats.
+ *
+ * @param actualResults - The actual query results
+ * @param expectedResults - The expected results from the test case
+ * @param expectedColumns - Optional array of expected column names
+ * @param actualColumns - Optional array of actual column names from SQL metadata
+ * @returns true if results match, false otherwise
+ */
+function compareResults(actualResults, expectedResults, expectedColumns, actualColumns) {
+    // Check column ordering if specified
+    if (expectedColumns && expectedColumns.length > 0) {
+        // Use actualColumns from SQL metadata if provided, otherwise fall back to Object.keys
+        const columnsToCheck = actualColumns ??
+            (actualResults.length > 0 ? Object.keys(actualResults[0]) : []);
+        if (!arraysEqual(columnsToCheck, expectedColumns)) {
+            console.log("Column mismatch:");
+            console.log("  Expected:", expectedColumns);
+            console.log("  Actual:  ", columnsToCheck);
+            return false;
+        }
+    }
+    // Normalize objects by sorting keys before comparing
+    const normalizeObject = (obj) => {
+        if (obj === null || typeof obj !== "object")
+            return obj;
+        if (Array.isArray(obj))
+            return obj.map(normalizeObject);
+        const sorted = {};
+        Object.keys(obj)
+            .sort((a, b) => a.localeCompare(b))
+            .forEach((key) => {
+            sorted[key] = normalizeObject(obj[key]);
+        });
+        return sorted;
+    };
+    // Sort both arrays to ignore row ordering, using normalized objects for consistent sorting
+    const sortedActual = [...actualResults]
+        .map(normalizeObject)
+        .sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b)));
+    const sortedExpected = [...expectedResults]
+        .map(normalizeObject)
+        .sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b)));
+    // Check if lengths match
+    if (sortedActual.length !== sortedExpected.length) {
+        return false;
+    }
+    // Compare each result object
+    for (let i = 0; i < sortedActual.length; i++) {
+        if (!deepEqual(sortedActual[i], sortedExpected[i])) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Deep equality comparison with special handling for FHIR data types.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (bothNullOrUndefined(a, b))
+        return true;
+    if (eitherNullOrUndefined(a, b))
+        return false;
+    if (typeof a !== typeof b) {
+        return handleBooleanNumberConversion(a, b);
+    }
+    if (typeof a === "object") {
+        return compareObjects(a, b);
+    }
+    return false;
+}
+/**
+ * Check if both values are null or undefined.
+ */
+function bothNullOrUndefined(a, b) {
+    return (a === null || a === undefined) && (b === null || b === undefined);
+}
+/**
+ * Check if either value is null or undefined (but not both).
+ */
+function eitherNullOrUndefined(a, b) {
+    return a === null || a === undefined || b === null || b === undefined;
+}
+/**
+ * Handle boolean/number conversions for SQL Server BIT columns.
+ */
+function handleBooleanNumberConversion(a, b) {
+    if (typeof a === "boolean" && typeof b === "number") {
+        return (a ? 1 : 0) === b;
+    }
+    if (typeof b === "boolean" && typeof a === "number") {
+        return (b ? 1 : 0) === a;
+    }
+    return false;
+}
+/**
+ * Compare objects (arrays or plain objects).
+ */
+function compareObjects(a, b) {
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a)) {
+        return compareArrays(a, b);
+    }
+    return comparePlainObjects(a, b);
+}
+/**
+ * Compare two arrays element by element.
+ */
+function compareArrays(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!deepEqual(a[i], b[i]))
+            return false;
+    }
+    return true;
+}
+/**
+ * Compare two plain objects key by key.
+ */
+function comparePlainObjects(a, b) {
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    return keysA.every((key) => deepEqual(a[key], b[key]));
+}
+/**
+ * Check if two arrays are equal (same elements in same order).
+ */
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return a.every((val, i) => val === b[i]);
+}
+/**
+ * Extract boolean column names from ViewDefinition.
+ *
+ * @param viewDefinition - The ViewDefinition to extract from
+ * @returns Set of column names that are declared as boolean type
+ */
+function extractBooleanColumns(viewDefinition) {
+    const booleanColumns = new Set();
+    // Recursively extract columns from select definitions
+    function extractFromSelect(selectDef) {
+        if (selectDef.column) {
+            for (const col of selectDef.column) {
+                if (col.type === "boolean") {
+                    booleanColumns.add(col.name);
+                }
+            }
+        }
+        if (selectDef.select) {
+            for (const nestedSelect of selectDef.select) {
+                extractFromSelect(nestedSelect);
+            }
+        }
+        if (selectDef.forEach) {
+            for (const forEachDef of selectDef.forEach) {
+                extractFromSelect(forEachDef);
+            }
+        }
+        if (selectDef.unionAll) {
+            for (const unionDef of selectDef.unionAll) {
+                extractFromSelect(unionDef);
+            }
+        }
+    }
+    if (viewDefinition.select) {
+        for (const selectDef of viewDefinition.select) {
+            extractFromSelect(selectDef);
+        }
+    }
+    return booleanColumns;
+}
+/**
+ * Parse JSON strings in query results into actual arrays/objects.
+ * Also converts numeric boolean values (0/1) to actual booleans for columns marked as boolean type.
+ *
+ * SQL Server may return some values as JSON strings that need to be parsed.
+ * SQL Server also returns CASE expressions as TINYINT (0/1) instead of boolean.
+ *
+ * @param results - The query results to parse
+ * @param booleanColumns - Set of column names that should be treated as booleans
+ */
+function parseJsonStringsInResults(results, booleanColumns) {
+    return results.map((row) => {
+        const parsedRow = {};
+        for (const [key, value] of Object.entries(row)) {
+            // Convert numeric boolean values to actual booleans
+            if (booleanColumns.has(key) && typeof value === "number") {
+                parsedRow[key] = Boolean(value);
+            }
+            else if (typeof value === "string" && looksLikeJson(value)) {
+                try {
+                    parsedRow[key] = JSON.parse(value);
+                }
+                catch {
+                    // If parsing fails, keep the original string
+                    parsedRow[key] = value;
+                }
+            }
+            else {
+                parsedRow[key] = value;
+            }
+        }
+        return parsedRow;
+    });
+}
+/**
+ * Check if a string looks like JSON (starts with [ or {).
+ */
+function looksLikeJson(value) {
+    const trimmed = value.trim();
+    return trimmed.startsWith("[") || trimmed.startsWith("{");
+}
+//# sourceMappingURL=sqlOnFhir.js.map

package/dist/tests/utils/sqlOnFhir.js.map

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

package/dist/tests/utils/testContext.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Test context management for parallel test execution.
+ *
+ * Provides unique test IDs for database isolation during concurrent test runs.
+ */
+/**
+ * Generate a unique test ID for database isolation.
+ *
+ * The test ID is composed of:
+ * - Process ID (to handle multi-process execution)
+ * - Timestamp (for temporal uniqueness)
+ * - Counter (for uniqueness within same millisecond)
+ * - UUID (for guaranteed uniqueness)
+ *
+ * @returns Unique test identifier
+ */
+export declare function generateTestId(): string;
+//# sourceMappingURL=testContext.d.ts.map

package/dist/tests/utils/testContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testContext.d.ts","sourceRoot":"","sources":["../../../src/tests/utils/testContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/tests/utils/testContext.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Test context management for parallel test execution.
+ *
+ * Provides unique test IDs for database isolation during concurrent test runs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestId = generateTestId;
+const crypto_1 = require("crypto");
+let testIdCounter = 0;
+/**
+ * Generate a unique test ID for database isolation.
+ *
+ * The test ID is composed of:
+ * - Process ID (to handle multi-process execution)
+ * - Timestamp (for temporal uniqueness)
+ * - Counter (for uniqueness within same millisecond)
+ * - UUID (for guaranteed uniqueness)
+ *
+ * @returns Unique test identifier
+ */
+function generateTestId() {
+    return `test_${process.pid}_${Date.now()}_${testIdCounter++}_${(0, crypto_1.randomUUID)()}`;
+}
+//# sourceMappingURL=testContext.js.map

package/dist/tests/utils/testContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testContext.js","sourceRoot":"","sources":["../../../src/tests/utils/testContext.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAiBH,wCAEC;AAjBD,mCAAoC;AAEpC,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,SAAgB,cAAc;IAC5B,OAAO,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,aAAa,EAAE,IAAI,IAAA,mBAAU,GAAE,EAAE,CAAC;AAChF,CAAC"}

package/dist/tests/utils/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Type definitions for test reporting.
+ *
+ * Matches the SQL on FHIR test report schema:
+ * https://raw.githubusercontent.com/FHIR/sql-on-fhir-v2/refs/heads/master/test_report/test-report.schema.json
+ */
+export interface TestReportEntry {
+    /** The name/description of the test case. */
+    name: string;
+    /** The test execution result. */
+    result: {
+        /** Whether the test passed (true) or failed (false). */
+        passed: boolean;
+        /** Optional error message if the test failed. */
+        error?: string;
+        /** Optional additional details about the test result. */
+        details?: Record<string, unknown>;
+    };
+}
+export interface TestReportSuite {
+    /** Array of test cases within this test suite. */
+    tests: TestReportEntry[];
+}
+export interface TestReport {
+    /**
+     * Each property represents a test suite file (e.g., 'basic.json', 'common.json').
+     * The report should be a flat object where each key represents a test suite file.
+     */
+    [suiteName: string]: TestReportSuite;
+}
+//# sourceMappingURL=types.d.ts.map