sof-mssql 1.0.0

package/dist/index.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * SQL on FHIR MS SQL Server library.
+ * Main API for transpiling ViewDefinitions to T-SQL queries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqlOnFhir = exports.Transpiler = exports.QueryGenerator = exports.ViewDefinitionParser = void 0;
+var parser_js_1 = require("./parser.js");
+Object.defineProperty(exports, "ViewDefinitionParser", { enumerable: true, get: function () { return parser_js_1.ViewDefinitionParser; } });
+var queryGenerator_1 = require("./queryGenerator");
+Object.defineProperty(exports, "QueryGenerator", { enumerable: true, get: function () { return queryGenerator_1.QueryGenerator; } });
+var transpiler_1 = require("./fhirpath/transpiler");
+Object.defineProperty(exports, "Transpiler", { enumerable: true, get: function () { return transpiler_1.Transpiler; } });
+const parser_js_2 = require("./parser.js");
+const queryGenerator_2 = require("./queryGenerator");
+/**
+ * Main class for SQL on FHIR operations.
+ */
+class SqlOnFhir {
+    queryGenerator;
+    constructor(options = {}) {
+        this.queryGenerator = new queryGenerator_2.QueryGenerator(options);
+    }
+    /**
+     * Transpile a ViewDefinition to a T-SQL query.
+     *
+     * @param viewDefinition - The ViewDefinition to transpile
+     */
+    transpile(viewDefinition) {
+        let viewDef;
+        if (typeof viewDefinition === "string" ||
+            (typeof viewDefinition === "object" && "resourceType" in viewDefinition)) {
+            viewDef = parser_js_2.ViewDefinitionParser.parseViewDefinition(viewDefinition);
+        }
+        else {
+            viewDef = viewDefinition;
+        }
+        return this.queryGenerator.generateQuery(viewDef);
+    }
+}
+exports.SqlOnFhir = SqlOnFhir;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAYH,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAC7B,mDAAyE;AAAhE,gHAAA,cAAc,OAAA;AACvB,oDAAsE;AAA7D,wGAAA,UAAU,OAAA;AAEnB,2CAAmD;AACnD,qDAAyE;AAQzE;;GAEG;AACH,MAAa,SAAS;IACH,cAAc,CAAiB;IAEhD,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,cAAc,GAAG,IAAI,+BAAc,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,cAAmC;QAC3C,IAAI,OAAuB,CAAC;QAE5B,IACE,OAAO,cAAc,KAAK,QAAQ;YAClC,CAAC,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,IAAI,cAAc,CAAC,EACxE,CAAC;YACD,OAAO,GAAG,gCAAoB,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,cAAgC,CAAC;QAC7C,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;CACF;AA1BD,8BA0BC"}

package/dist/load.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * CLI command for loading NDJSON files into SQL Server.
+ *
+ * @author John Grimes
+ */
+import { Command } from "commander";
+/**
+ * Create the load command.
+ *
+ * @returns Commander command for loading NDJSON files.
+ */
+export declare function createLoadCommand(): Command;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgGpC;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAwC3C"}

package/dist/load.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI command for loading NDJSON files into SQL Server.
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoadCommand = createLoadCommand;
+const commander_1 = require("commander");
+const index_js_1 = require("./loader/index.js");
+/**
+ * Get database configuration for dry-run mode.
+ *
+ * @param commandOptions - Command options.
+ * @returns Database configuration with dummy values.
+ */
+function getDryRunDatabaseConfig(commandOptions) {
+    return {
+        host: commandOptions.host ?? "localhost",
+        port: commandOptions.port ?? 1433,
+        user: commandOptions.user ?? "sa",
+        password: commandOptions.password ?? "dummy",
+        database: commandOptions.database ?? "dummy",
+        trustServerCertificate: commandOptions.trustServerCertificate,
+    };
+}
+/**
+ * Build loader options from command options.
+ *
+ * @param directory - Directory to load from.
+ * @param commandOptions - Command options.
+ * @returns Loader options.
+ */
+function buildLoaderOptions(directory, commandOptions) {
+    const database = commandOptions.dryRun
+        ? getDryRunDatabaseConfig(commandOptions)
+        : (0, index_js_1.getDatabaseConfigFromEnv)({
+            host: commandOptions.host,
+            port: commandOptions.port,
+            user: commandOptions.user,
+            password: commandOptions.password,
+            database: commandOptions.database,
+            trustServerCertificate: commandOptions.trustServerCertificate,
+        });
+    return {
+        directory,
+        database,
+        pattern: commandOptions.pattern,
+        resourceType: commandOptions.resourceType,
+        tableName: commandOptions.tableName,
+        schemaName: commandOptions.schemaName,
+        createTable: commandOptions.createTable,
+        truncate: commandOptions.truncate,
+        batchSize: commandOptions.batchSize,
+        parallel: commandOptions.parallel,
+        continueOnError: commandOptions.continueOnError,
+        dryRun: commandOptions.dryRun,
+        verbose: commandOptions.verbose,
+        quiet: commandOptions.quiet,
+        progress: commandOptions.progress,
+    };
+}
+/**
+ * Handle the load command action.
+ *
+ * @param directory - Directory to load from.
+ * @param commandOptions - Command options.
+ */
+async function handleLoadCommand(directory, commandOptions) {
+    try {
+        const options = buildLoaderOptions(directory, commandOptions);
+        const summary = await (0, index_js_1.loadNdjsonFiles)(options);
+        if (summary.filesFailed > 0) {
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+/**
+ * Create the load command.
+ *
+ * @returns Commander command for loading NDJSON files.
+ */
+function createLoadCommand() {
+    const command = new commander_1.Command("load");
+    command
+        .description("Load NDJSON files into SQL Server")
+        .argument("<directory>", "Directory containing NDJSON files")
+        .option("--host <host>", "Database server hostname")
+        .option("--port <port>", "Database server port", parseInt)
+        .option("--user <user>", "Database username")
+        .option("--password <password>", "Database password")
+        .option("--database <database>", "Database name")
+        .option("--trust-server-certificate", "Trust server certificate", false)
+        .option("--pattern <pattern>", "File naming pattern (default: {ResourceType}.ndjson)")
+        .option("--resource-type <type>", "Only load specific resource type")
+        .option("--table-name <name>", "Table name (default: fhir_resources)")
+        .option("--schema-name <name>", "Schema name (default: dbo)")
+        .option("--no-create-table", "Do not create table if it doesn't exist")
+        .option("--truncate", "Truncate table before loading", false)
+        .option("--batch-size <size>", "Number of rows per batch", parseInt, 1000)
+        .option("--parallel <count>", "Number of files to process in parallel", parseInt, 4)
+        .option("--continue-on-error", "Continue loading other files if one fails", false)
+        .option("--dry-run", "Show what would be loaded without loading", false)
+        .option("--verbose", "Enable verbose logging", false)
+        .option("--quiet", "Minimal output", false)
+        .option("--progress", "Show progress bar", false)
+        .action(handleLoadCommand);
+    return command;
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

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

package/dist/loader/connection.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Database connection management for NDJSON loader.
+ *
+ * @author John Grimes
+ */
+import { type ConnectionPool } from "mssql";
+import type { DatabaseConfig } from "./types.js";
+/**
+ * Create a connection pool to the SQL Server database.
+ *
+ * @param config - Database connection configuration.
+ * @returns Promise that resolves to the connection pool.
+ */
+export declare function createConnectionPool(config: DatabaseConfig): Promise<ConnectionPool>;
+/**
+ * Close a connection pool safely.
+ *
+ * @param pool - The connection pool to close.
+ */
+export declare function closeConnectionPool(pool: ConnectionPool): Promise<void>;
+/**
+ * Test database connection.
+ *
+ * @param pool - The connection pool to test.
+ * @returns Promise that resolves to true if connection is successful.
+ */
+export declare function testConnection(pool: ConnectionPool): Promise<boolean>;
+/**
+ * Get database connection configuration from environment variables.
+ * Falls back to provided defaults or throws if required variables are missing.
+ *
+ * @param overrides - Optional configuration overrides.
+ * @returns Database configuration.
+ */
+export declare function getDatabaseConfigFromEnv(overrides?: Partial<DatabaseConfig>): DatabaseConfig;
+//# sourceMappingURL=connection.d.ts.map

package/dist/loader/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/loader/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAY,EAAE,KAAK,cAAc,EAA4B,MAAM,OAAO,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3E;AAED;;;;;;GAMG;AAEH,wBAAgB,wBAAwB,CACtC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,CA8BhB"}

package/dist/loader/connection.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Database connection management for NDJSON loader.
+ *
+ * @author John Grimes
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnectionPool = createConnectionPool;
+exports.closeConnectionPool = closeConnectionPool;
+exports.testConnection = testConnection;
+exports.getDatabaseConfigFromEnv = getDatabaseConfigFromEnv;
+const mssql_1 = __importDefault(require("mssql"));
+/**
+ * Create a connection pool to the SQL Server database.
+ *
+ * @param config - Database connection configuration.
+ * @returns Promise that resolves to the connection pool.
+ */
+async function createConnectionPool(config) {
+    // Build the mssql configuration object.
+    const sqlConfig = {
+        server: config.host,
+        port: config.port ?? 1433,
+        user: config.user,
+        password: config.password,
+        database: config.database,
+        options: {
+            trustServerCertificate: config.trustServerCertificate ?? false,
+            // Enable multiple active result sets for parallel operations.
+            enableArithAbort: true,
+        },
+        pool: {
+            // Configure connection pool for bulk operations.
+            max: 10,
+            min: 0,
+            idleTimeoutMillis: 30000,
+        },
+    };
+    // Create and connect the pool.
+    const pool = new mssql_1.default.ConnectionPool(sqlConfig);
+    await pool.connect();
+    return pool;
+}
+/**
+ * Close a connection pool safely.
+ *
+ * @param pool - The connection pool to close.
+ */
+async function closeConnectionPool(pool) {
+    try {
+        await pool.close();
+    }
+    catch {
+        // Silently ignore errors when closing - we're likely cleaning up anyway.
+    }
+}
+/**
+ * Test database connection.
+ *
+ * @param pool - The connection pool to test.
+ * @returns Promise that resolves to true if connection is successful.
+ */
+async function testConnection(pool) {
+    try {
+        const result = await pool.request().query("SELECT 1 AS test");
+        return result.recordset.length === 1;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get database connection configuration from environment variables.
+ * Falls back to provided defaults or throws if required variables are missing.
+ *
+ * @param overrides - Optional configuration overrides.
+ * @returns Database configuration.
+ */
+// eslint-disable-next-line complexity -- Configuration parsing is inherently complex
+function getDatabaseConfigFromEnv(overrides) {
+    const host = overrides?.host ?? process.env.MSSQL_HOST;
+    const user = overrides?.user ?? process.env.MSSQL_USER;
+    const password = overrides?.password ?? process.env.MSSQL_PASSWORD;
+    const database = overrides?.database ?? process.env.MSSQL_DATABASE;
+    if (!host || !user || !password || !database) {
+        throw new Error("Missing required database configuration. " +
+            "Provide via --host, --user, --password, --database flags " +
+            "or MSSQL_HOST, MSSQL_USER, MSSQL_PASSWORD, MSSQL_DATABASE environment variables.");
+    }
+    const port = overrides?.port ??
+        (process.env.MSSQL_PORT ? parseInt(process.env.MSSQL_PORT, 10) : 1433);
+    const trustServerCertificate = overrides?.trustServerCertificate ??
+        process.env.MSSQL_TRUST_SERVER_CERTIFICATE === "true";
+    return {
+        host,
+        port,
+        user,
+        password,
+        database,
+        trustServerCertificate,
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/loader/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/loader/connection.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;AAWH,oDA4BC;AAOD,kDAMC;AAQD,wCAOC;AAUD,4DAgCC;AA3GD,kDAA2E;AAG3E;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,MAAsB;IAEtB,wCAAwC;IACxC,MAAM,SAAS,GAAc;QAC3B,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE;YACP,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,IAAI,KAAK;YAC9D,8DAA8D;YAC9D,gBAAgB,EAAE,IAAI;SACvB;QACD,IAAI,EAAE;YACJ,iDAAiD;YACjD,GAAG,EAAE,EAAE;YACP,GAAG,EAAE,CAAC;YACN,iBAAiB,EAAE,KAAK;SACzB;KACF,CAAC;IAEF,+BAA+B;IAC/B,MAAM,IAAI,GAAG,IAAI,eAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,mBAAmB,CAAC,IAAoB;IAC5D,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAAC,IAAoB;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,qFAAqF;AACrF,SAAgB,wBAAwB,CACtC,SAAmC;IAEnC,MAAM,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACvD,MAAM,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACvD,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACnE,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAEnE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,2CAA2C;YACzC,2DAA2D;YAC3D,kFAAkF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GACR,SAAS,EAAE,IAAI;QACf,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEzE,MAAM,sBAAsB,GAC1B,SAAS,EAAE,sBAAsB;QACjC,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,MAAM,CAAC;IAExD,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,QAAQ;QACR,QAAQ;QACR,sBAAsB;KACvB,CAAC;AACJ,CAAC"}

package/dist/loader/discovery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * File discovery for NDJSON loader.
+ * Scans directories and matches files against configurable patterns.
+ *
+ * @author John Grimes
+ */
+import type { DiscoveredFile, LoaderOptions } from "./types.js";
+/**
+ * Discover NDJSON files in a directory matching the specified pattern.
+ *
+ * @param options - Loader options containing directory and pattern.
+ * @returns Array of discovered files with metadata.
+ */
+export declare function discoverFiles(options: LoaderOptions): DiscoveredFile[];
+/**
+ * Parse a filename against a pattern to extract resource type.
+ *
+ * Pattern placeholders:
+ * - {ResourceType} - Required, matches the FHIR resource type.
+ *
+ * Example:
+ * - Pattern: "{ResourceType}.ndjson" matches "Patient.ndjson" → { resourceType: "Patient" }
+ *
+ * @param filename - The filename to parse.
+ * @param pattern - The pattern to match against.
+ * @returns Metadata if the filename matches, undefined otherwise.
+ */
+export declare function parseFilename(filename: string, pattern: string): {
+    resourceType: string;
+} | undefined;
+/**
+ * Group discovered files by resource type.
+ *
+ * @param files - Array of discovered files.
+ * @returns Map of resource type to files.
+ */
+export declare function groupFilesByResourceType(files: DiscoveredFile[]): Map<string, DiscoveredFile[]>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/loader/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/loader/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAShE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE,CAwCtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA+BtC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EAAE,GACtB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAU/B"}

package/dist/loader/discovery.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * File discovery for NDJSON loader.
+ * Scans directories and matches files against configurable patterns.
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverFiles = discoverFiles;
+exports.parseFilename = parseFilename;
+exports.groupFilesByResourceType = groupFilesByResourceType;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Default file pattern.
+ * Format: {ResourceType}.ndjson
+ * Example: Patient.ndjson
+ */
+const DEFAULT_PATTERN = "{ResourceType}.ndjson";
+/**
+ * Discover NDJSON files in a directory matching the specified pattern.
+ *
+ * @param options - Loader options containing directory and pattern.
+ * @returns Array of discovered files with metadata.
+ */
+function discoverFiles(options) {
+    const pattern = options.pattern ?? DEFAULT_PATTERN;
+    const files = [];
+    // Get all files from the directory.
+    const entries = (0, fs_1.readdirSync)(options.directory);
+    for (const entry of entries) {
+        const filePath = (0, path_1.join)(options.directory, entry);
+        const stats = (0, fs_1.statSync)(filePath);
+        // Skip directories.
+        if (stats.isDirectory()) {
+            continue;
+        }
+        // Parse the filename against the pattern.
+        const metadata = parseFilename(entry, pattern);
+        // Skip files that don't match the pattern.
+        if (!metadata) {
+            continue;
+        }
+        // Apply resource type filter if specified.
+        if (options.resourceType &&
+            metadata.resourceType !== options.resourceType) {
+            continue;
+        }
+        files.push({
+            path: filePath,
+            resourceType: metadata.resourceType,
+            size: stats.size,
+        });
+    }
+    return files;
+}
+/**
+ * Parse a filename against a pattern to extract resource type.
+ *
+ * Pattern placeholders:
+ * - {ResourceType} - Required, matches the FHIR resource type.
+ *
+ * Example:
+ * - Pattern: "{ResourceType}.ndjson" matches "Patient.ndjson" → { resourceType: "Patient" }
+ *
+ * @param filename - The filename to parse.
+ * @param pattern - The pattern to match against.
+ * @returns Metadata if the filename matches, undefined otherwise.
+ */
+function parseFilename(filename, pattern) {
+    // Convert the pattern to a regular expression.
+    // Replace {ResourceType} with a named capture group that matches word characters.
+    // FHIR resource types are PascalCase (e.g., Patient, Observation).
+    let regexPattern = pattern.replace("{ResourceType}", "(?<resourceType>[A-Z][A-Za-z0-9]*)");
+    // Escape special regex characters in the pattern (dots, etc.).
+    regexPattern = regexPattern.replace(/\./g, "\\.");
+    // Anchor the pattern to match the entire filename.
+    regexPattern = `^${regexPattern}$`;
+    const regex = new RegExp(regexPattern);
+    const match = regex.exec(filename);
+    if (!match?.groups) {
+        return undefined;
+    }
+    const { resourceType } = match.groups;
+    if (!resourceType) {
+        return undefined;
+    }
+    return {
+        resourceType,
+    };
+}
+/**
+ * Group discovered files by resource type.
+ *
+ * @param files - Array of discovered files.
+ * @returns Map of resource type to files.
+ */
+function groupFilesByResourceType(files) {
+    const grouped = new Map();
+    for (const file of files) {
+        const existing = grouped.get(file.resourceType) ?? [];
+        existing.push(file);
+        grouped.set(file.resourceType, existing);
+    }
+    return grouped;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/loader/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/loader/discovery.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAmBH,sCAwCC;AAeD,sCAkCC;AAQD,4DAYC;AA9HD,2BAA2C;AAC3C,+BAA4B;AAG5B;;;;GAIG;AACH,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAsB;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;IACnD,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,oCAAoC;IACpC,MAAM,OAAO,GAAG,IAAA,gBAAW,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC;QAEjC,oBAAoB;QACpB,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAE/C,2CAA2C;QAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,IACE,OAAO,CAAC,YAAY;YACpB,QAAQ,CAAC,YAAY,KAAK,OAAO,CAAC,YAAY,EAC9C,CAAC;YACD,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,aAAa,CAC3B,QAAgB,EAChB,OAAe;IAEf,+CAA+C;IAC/C,kFAAkF;IAClF,mEAAmE;IACnE,IAAI,YAAY,GAAG,OAAO,CAAC,OAAO,CAChC,gBAAgB,EAChB,oCAAoC,CACrC,CAAC;IAEF,+DAA+D;IAC/D,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAElD,mDAAmD;IACnD,YAAY,GAAG,IAAI,YAAY,GAAG,CAAC;IAEnC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IAEtC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,KAAuB;IAEvB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/loader/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Main orchestration for NDJSON loader.
+ * Coordinates file discovery, table management, and loading operations.
+ *
+ * @author John Grimes
+ */
+import type { LoaderOptions, LoaderSummary } from "./types.js";
+/**
+ * Load NDJSON files from a directory into SQL Server.
+ *
+ * @param options - Loader options.
+ * @returns Promise that resolves to the loader summary.
+ */
+export declare function loadNdjsonFiles(options: LoaderOptions): Promise<LoaderSummary>;
+/**
+ * Export all loader functionality.
+ */
+export * from "./types.js";
+export * from "./connection.js";
+export * from "./discovery.js";
+export * from "./tables.js";
+export * from "./stream.js";
+export * from "./progress.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/loader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,aAAa,EAEb,aAAa,EACd,MAAM,YAAY,CAAC;AAiNpB;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CA6BxB;AAED;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}