sof-mssql 2.3.0 → 2.4.0

package/dist/loader/tables.js

@@ -9,12 +9,119 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCreateTableStatements = buildCreateTableStatements;
+exports.resolveColumnJsonDataType = resolveColumnJsonDataType;
+exports.buildJsonTypeMismatchWarning = buildJsonTypeMismatchWarning;
 exports.tableExists = tableExists;
+exports.getExistingJsonColumnType = getExistingJsonColumnType;
+exports.warnIfJsonTypeMismatch = warnIfJsonTypeMismatch;
 exports.createTable = createTable;
 exports.truncateTable = truncateTable;
 exports.ensureTable = ensureTable;
 const mssql_1 = __importDefault(require("mssql"));
 const validation_js_1 = require("../validation.js");
+/**
+ * Build the DDL statements for the resources table and its index.
+ *
+ * This is a pure function so the generated SQL can be unit-tested without a
+ * database. The `json` column is typed with the resolved {@link
+ * ResourceJsonDataType}; with the default `NVARCHAR(MAX)` the output is
+ * byte-for-byte identical to earlier releases (SC-001). Identifiers are assumed
+ * to have been validated by the caller (see {@link createTable}).
+ *
+ * @param schemaName - Schema name (already validated).
+ * @param tableName - Table name (already validated).
+ * @param jsonType - Resolved canonical storage type for the `json` column.
+ * @returns The `CREATE TABLE` and `CREATE INDEX` statements.
+ */
+function buildCreateTableStatements(schemaName, tableName, jsonType) {
+    // Only the json column's type varies; every other part of the DDL is held
+    // constant so the default path is unchanged from earlier releases.
+    const createTable = `
+    CREATE TABLE [${schemaName}].[${tableName}] (
+      [id] INT IDENTITY(1,1) NOT NULL PRIMARY KEY,
+      [resource_type] NVARCHAR(64) NOT NULL,
+      [json] ${jsonType} NOT NULL
+    )
+  `;
+    const createIndex = `
+    CREATE INDEX [IX_${tableName}_resource_type]
+    ON [${schemaName}].[${tableName}] ([resource_type])
+  `;
+    return { createTable, createIndex };
+}
+/**
+ * Render an INFORMATION_SCHEMA column type for a diagnostic message.
+ *
+ * Length-bearing types are shown with their declared length, with the `-1`
+ * sentinel rendered as `MAX`; types reported without a length (such as the
+ * native `JSON` type) are shown as the bare type name.
+ *
+ * @param dataType - The INFORMATION_SCHEMA DATA_TYPE.
+ * @param characterMaximumLength - The INFORMATION_SCHEMA CHARACTER_MAXIMUM_LENGTH.
+ * @returns A readable type such as `VARCHAR(100)`, `NVARCHAR(MAX)` or `JSON`.
+ */
+function formatColumnType(dataType, characterMaximumLength) {
+    const baseType = dataType.trim().toUpperCase();
+    if (characterMaximumLength === null) {
+        return baseType;
+    }
+    const length = characterMaximumLength === -1 ? "MAX" : String(characterMaximumLength);
+    return `${baseType}(${length})`;
+}
+/**
+ * Resolve an INFORMATION_SCHEMA column description to a canonical json type.
+ *
+ * Only two column shapes can faithfully hold a serialised FHIR resource: the
+ * native type (`data_type = 'json'`) and `NVARCHAR(MAX)` (`data_type =
+ * 'nvarchar'` with `character_maximum_length = -1`). Any other shape - a bounded
+ * `NVARCHAR(64)`, a non-Unicode `VARCHAR`, `TEXT`, and so on - is rejected here
+ * rather than silently coerced to `NVARCHAR(MAX)`. Coercion would let the
+ * mismatch check pass and the loader write into a column that cannot hold the
+ * data, surfacing later as a `String or binary data would be truncated` error
+ * or, under non-Unicode `VARCHAR`, silent character corruption. Failing fast
+ * turns that late, data-dependent failure into an early, actionable
+ * configuration error (Constitution Principle IV).
+ *
+ * @param dataType - The INFORMATION_SCHEMA DATA_TYPE.
+ * @param characterMaximumLength - The INFORMATION_SCHEMA CHARACTER_MAXIMUM_LENGTH.
+ * @returns The canonical resource json data type (`JSON` or `NVARCHAR(MAX)`).
+ * @throws Error if the column is neither native `JSON` nor `NVARCHAR(MAX)`. The
+ *   message names the offending type and the two acceptable types.
+ */
+function resolveColumnJsonDataType(dataType, characterMaximumLength) {
+    const normalised = dataType.trim().toLowerCase();
+    if (normalised === "json") {
+        return "JSON";
+    }
+    // NVARCHAR(MAX) is the only nvarchar form that can hold an arbitrarily long
+    // resource; bounded lengths would truncate, so the length is required here.
+    if (normalised === "nvarchar" && characterMaximumLength === -1) {
+        return "NVARCHAR(MAX)";
+    }
+    throw new Error(`Existing [json] column is ` +
+        `${formatColumnType(dataType, characterMaximumLength)}, which cannot ` +
+        `safely hold serialised FHIR resources. Expected NVARCHAR(MAX) or JSON. ` +
+        `Alter or drop the column before loading.`);
+}
+/**
+ * Build a warning for an existing table whose json column type differs from the
+ * requested type.
+ *
+ * @param schemaName - Schema name.
+ * @param tableName - Table name.
+ * @param existingType - The table's current json column type.
+ * @param requestedType - The requested json column type.
+ * @returns A warning message naming both types, or null when they match.
+ */
+function buildJsonTypeMismatchWarning(schemaName, tableName, existingType, requestedType) {
+    if (existingType === requestedType) {
+        return null;
+    }
+    return (`Warning: table [${schemaName}].[${tableName}] already exists with a json ` +
+        `column of type ${existingType}, but ${requestedType} was requested. The ` +
+        `existing table is left unaltered and loading continues into it.`);
+}
 /**
  * Check if a table exists in the database.
  *
@@ -34,31 +141,82 @@ async function tableExists(pool, schemaName, tableName) {
     `);
     return result.recordset[0].count > 0;
 }
+/**
+ * Read the effective json column type for an existing table.
+ *
+ * @param pool - Database connection pool.
+ * @param schemaName - Schema name.
+ * @param tableName - Name of the table.
+ * @returns The canonical json column type, or null if the table or its `json`
+ *   column does not exist.
+ * @throws Error if the column exists but is neither native `JSON` nor
+ *   `NVARCHAR(MAX)` (see {@link resolveColumnJsonDataType}).
+ */
+async function getExistingJsonColumnType(pool, schemaName, tableName) {
+    const result = await pool
+        .request()
+        .input("schemaName", mssql_1.default.NVarChar, schemaName)
+        .input("tableName", mssql_1.default.NVarChar, tableName).query(`
+      SELECT DATA_TYPE, CHARACTER_MAXIMUM_LENGTH
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = @schemaName
+        AND TABLE_NAME = @tableName
+        AND COLUMN_NAME = 'json'
+    `);
+    const row = result.recordset[0];
+    if (!row) {
+        return null;
+    }
+    return resolveColumnJsonDataType(row.DATA_TYPE, row.CHARACTER_MAXIMUM_LENGTH);
+}
+/**
+ * Emit a warning if an existing table's json column type differs from the
+ * requested type. The table is never altered; this only surfaces the mismatch
+ * so it is visible rather than silently ignored (FR-008, SC-005).
+ *
+ * An existing column that is neither native `JSON` nor `NVARCHAR(MAX)` cannot
+ * hold a serialised FHIR resource, so it is rejected outright rather than
+ * warned about: the error is raised here before any rows are loaded.
+ *
+ * @param pool - Database connection pool.
+ * @param schemaName - Schema name.
+ * @param tableName - Name of the table.
+ * @param requestedType - The requested json column type.
+ * @throws Error if the existing `json` column is neither native `JSON` nor
+ *   `NVARCHAR(MAX)` (see {@link resolveColumnJsonDataType}).
+ */
+async function warnIfJsonTypeMismatch(pool, schemaName, tableName, requestedType) {
+    const existingType = await getExistingJsonColumnType(pool, schemaName, tableName);
+    if (existingType === null) {
+        return;
+    }
+    const warning = buildJsonTypeMismatchWarning(schemaName, tableName, existingType, requestedType);
+    if (warning !== null) {
+        // The warning is emitted regardless of quiet mode so the misconfiguration
+        // is always visible (SC-005).
+        console.warn(warning);
+    }
+}
 /**
  * Create the fhir_resources table with an index on resource_type.
- * Table schema: id (INT IDENTITY PRIMARY KEY), resource_type (NVARCHAR(64)), json (NVARCHAR(MAX))
+ * Table schema: id (INT IDENTITY PRIMARY KEY), resource_type (NVARCHAR(64)),
+ * json (the configured storage type, NVARCHAR(MAX) by default).
  *
  * @param pool - Database connection pool.
  * @param schemaName - Schema name.
  * @param tableName - Name of the table to create.
+ * @param jsonType - Storage type for the `json` column (default `NVARCHAR(MAX)`).
  */
-async function createTable(pool, schemaName, tableName) {
-    // Validate identifiers to prevent SQL injection
+async function createTable(pool, schemaName, tableName, jsonType = "NVARCHAR(MAX)") {
+    // Validate identifiers to prevent SQL injection. The json type is already a
+    // canonical, allowlisted value, so it carries no injection risk.
     (0, validation_js_1.validateSqlServerIdentifier)(schemaName, "Schema name");
     (0, validation_js_1.validateSqlServerIdentifier)(tableName, "Table name");
+    const { createTable: createTableSql, createIndex: createIndexSql } = buildCreateTableStatements(schemaName, tableName, jsonType);
     // Create the table.
-    await pool.request().query(`
-    CREATE TABLE [${schemaName}].[${tableName}] (
-      [id] INT IDENTITY(1,1) NOT NULL PRIMARY KEY,
-      [resource_type] NVARCHAR(64) NOT NULL,
-      [json] NVARCHAR(MAX) NOT NULL
-    )
-  `);
+    await pool.request().query(createTableSql);
     // Create an index on resource_type for efficient filtering by resource type.
-    await pool.request().query(`
-    CREATE INDEX [IX_${tableName}_resource_type]
-    ON [${schemaName}].[${tableName}] ([resource_type])
-  `);
+    await pool.request().query(createIndexSql);
 }
 /**
  * Truncate a table (remove all rows).
@@ -76,20 +234,28 @@ async function truncateTable(pool, schemaName, tableName) {
 /**
  * Ensure the fhir_resources table exists, creating it if necessary.
  *
+ * When the table already exists it is never altered; the requested `json`
+ * column type only governs creation of a new table.
+ *
  * @param pool - Database connection pool.
  * @param schemaName - Schema name.
  * @param tableName - Name of the table.
  * @param truncate - Whether to truncate the table if it exists.
+ * @param jsonType - Storage type for the `json` column when creating the table
+ *   (default `NVARCHAR(MAX)`).
  */
-async function ensureTable(pool, schemaName, tableName, truncate = false) {
+async function ensureTable(pool, schemaName, tableName, truncate = false, jsonType = "NVARCHAR(MAX)") {
     const exists = await tableExists(pool, schemaName, tableName);
     if (exists) {
+        // The table already exists, so the requested type cannot take effect. Warn
+        // if it differs from the existing column type, then leave the table as is.
+        await warnIfJsonTypeMismatch(pool, schemaName, tableName, jsonType);
         if (truncate) {
             await truncateTable(pool, schemaName, tableName);
         }
     }
     else {
-        await createTable(pool, schemaName, tableName);
+        await createTable(pool, schemaName, tableName, jsonType);
     }
 }
 //# sourceMappingURL=tables.js.map

package/dist/loader/tables.js.map

@@ -1 +1 @@
-{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/loader/tables.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAaH,kCAeC;AAUD,kCAuBC;AASD,sCAUC;AAUD,kCAeC;AAvGD,kDAAiD;AACjD,oDAA+D;AAE/D;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAoB,EACpB,UAAkB,EAClB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,IAAI;SACtB,OAAO,EAAE;SACT,KAAK,CAAC,YAAY,EAAE,eAAG,CAAC,QAAQ,EAAE,UAAU,CAAC;SAC7C,KAAK,CAAC,WAAW,EAAE,eAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC;;;;KAIlD,CAAC,CAAC;IAEL,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAoB,EACpB,UAAkB,EAClB,SAAiB;IAEjB,gDAAgD;IAChD,IAAA,2CAA2B,EAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACvD,IAAA,2CAA2B,EAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAErD,oBAAoB;IACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC;oBACT,UAAU,MAAM,SAAS;;;;;GAK1C,CAAC,CAAC;IAEH,6EAA6E;IAC7E,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC;uBACN,SAAS;UACtB,UAAU,MAAM,SAAS;GAChC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,IAAoB,EACpB,UAAkB,EAClB,SAAiB;IAEjB,gDAAgD;IAChD,IAAA,2CAA2B,EAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACvD,IAAA,2CAA2B,EAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAErD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,mBAAmB,UAAU,MAAM,SAAS,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAoB,EACpB,UAAkB,EAClB,SAAiB,EACjB,WAAoB,KAAK;IAEzB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/loader/tables.ts"],"names":[],"mappings":"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"}

package/dist/loader/tables.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Unit tests for pure table DDL generation and existing-column-type resolution.
+ *
+ * These exercise the string-building and comparison logic without a database,
+ * so the byte-for-byte DDL contract (SC-001), the native JSON column type
+ * (FR-005) and the type-mismatch decision (FR-008) can be verified in
+ * isolation.
+ *
+ * @author John Grimes
+ */
+export {};
+//# sourceMappingURL=tables.test.d.ts.map

package/dist/loader/tables.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.test.d.ts","sourceRoot":"","sources":["../../src/loader/tables.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/loader/tables.test.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Unit tests for pure table DDL generation and existing-column-type resolution.
+ *
+ * These exercise the string-building and comparison logic without a database,
+ * so the byte-for-byte DDL contract (SC-001), the native JSON column type
+ * (FR-005) and the type-mismatch decision (FR-008) can be verified in
+ * isolation.
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const tables_1 = require("./tables");
+(0, vitest_1.describe)("buildCreateTableStatements", () => {
+    (0, vitest_1.describe)("default NVARCHAR(MAX) json column", () => {
+        const statements = (0, tables_1.buildCreateTableStatements)("dbo", "fhir_resources", "NVARCHAR(MAX)");
+        (0, vitest_1.it)("types the json column as NVARCHAR(MAX) NOT NULL", () => {
+            (0, vitest_1.expect)(statements.createTable).toContain("[json] NVARCHAR(MAX) NOT NULL");
+        });
+        (0, vitest_1.it)("keeps the id column unchanged", () => {
+            (0, vitest_1.expect)(statements.createTable).toContain("[id] INT IDENTITY(1,1) NOT NULL PRIMARY KEY");
+        });
+        (0, vitest_1.it)("keeps the resource_type column unchanged", () => {
+            (0, vitest_1.expect)(statements.createTable).toContain("[resource_type] NVARCHAR(64) NOT NULL");
+        });
+        (0, vitest_1.it)("brackets the schema and table identifiers", () => {
+            (0, vitest_1.expect)(statements.createTable).toContain("[dbo].[fhir_resources]");
+        });
+        (0, vitest_1.it)("builds the resource_type index", () => {
+            (0, vitest_1.expect)(statements.createIndex).toContain("[IX_fhir_resources_resource_type]");
+            (0, vitest_1.expect)(statements.createIndex).toContain("[dbo].[fhir_resources] ([resource_type])");
+        });
+    });
+    (0, vitest_1.describe)("native JSON json column", () => {
+        const statements = (0, tables_1.buildCreateTableStatements)("dbo", "fhir_resources", "JSON");
+        (0, vitest_1.it)("types the json column as JSON NOT NULL", () => {
+            (0, vitest_1.expect)(statements.createTable).toContain("[json] JSON NOT NULL");
+        });
+        (0, vitest_1.it)("does not emit NVARCHAR(MAX) for the json column", () => {
+            (0, vitest_1.expect)(statements.createTable).not.toContain("[json] NVARCHAR(MAX)");
+        });
+        (0, vitest_1.it)("keeps the resource_type column unchanged", () => {
+            (0, vitest_1.expect)(statements.createTable).toContain("[resource_type] NVARCHAR(64) NOT NULL");
+        });
+        (0, vitest_1.it)("leaves the index statement identical to the default", () => {
+            const defaultStatements = (0, tables_1.buildCreateTableStatements)("dbo", "fhir_resources", "NVARCHAR(MAX)");
+            (0, vitest_1.expect)(statements.createIndex).toBe(defaultStatements.createIndex);
+        });
+    });
+    (0, vitest_1.describe)("identifier bracketing", () => {
+        (0, vitest_1.it)("brackets custom schema and table names", () => {
+            const statements = (0, tables_1.buildCreateTableStatements)("analytics", "resources", "JSON");
+            (0, vitest_1.expect)(statements.createTable).toContain("[analytics].[resources]");
+            (0, vitest_1.expect)(statements.createIndex).toContain("[IX_resources_resource_type]");
+            (0, vitest_1.expect)(statements.createIndex).toContain("[analytics].[resources] ([resource_type])");
+        });
+    });
+});
+(0, vitest_1.describe)("resolveColumnJsonDataType", () => {
+    (0, vitest_1.it)("resolves nvarchar with MAX length to NVARCHAR(MAX)", () => {
+        // NVARCHAR(MAX) appears in INFORMATION_SCHEMA as data_type 'nvarchar' with a
+        // character_maximum_length of -1.
+        (0, vitest_1.expect)((0, tables_1.resolveColumnJsonDataType)("nvarchar", -1)).toBe("NVARCHAR(MAX)");
+    });
+    (0, vitest_1.it)("resolves json to JSON", () => {
+        // The native type appears as data_type 'json' with a null maximum length.
+        (0, vitest_1.expect)((0, tables_1.resolveColumnJsonDataType)("json", null)).toBe("JSON");
+    });
+    (0, vitest_1.it)("is case-insensitive on the data type name", () => {
+        (0, vitest_1.expect)((0, tables_1.resolveColumnJsonDataType)("JSON", null)).toBe("JSON");
+        (0, vitest_1.expect)((0, tables_1.resolveColumnJsonDataType)("NVARCHAR", -1)).toBe("NVARCHAR(MAX)");
+    });
+    (0, vitest_1.it)("tolerates surrounding whitespace on the data type name", () => {
+        (0, vitest_1.expect)((0, tables_1.resolveColumnJsonDataType)("  json  ", null)).toBe("JSON");
+        (0, vitest_1.expect)((0, tables_1.resolveColumnJsonDataType)(" nvarchar ", -1)).toBe("NVARCHAR(MAX)");
+    });
+    // An existing column that is neither native JSON nor NVARCHAR(MAX) cannot
+    // faithfully hold a serialised FHIR resource. Such a column must be rejected
+    // at the boundary, naming the offending type, rather than silently coerced to
+    // NVARCHAR(MAX) - coercion would let the loader write into it and lose data
+    // through truncation or, under non-Unicode VARCHAR, character corruption
+    // (Constitution Principle IV).
+    (0, vitest_1.describe)("rejects column types that cannot hold a FHIR resource", () => {
+        (0, vitest_1.it)("throws for a bounded nvarchar, naming the offending type", () => {
+            (0, vitest_1.expect)(() => (0, tables_1.resolveColumnJsonDataType)("nvarchar", 64)).toThrow(/NVARCHAR\(64\)/);
+        });
+        (0, vitest_1.it)("throws for varchar, naming the offending type", () => {
+            (0, vitest_1.expect)(() => (0, tables_1.resolveColumnJsonDataType)("varchar", 100)).toThrow(/VARCHAR\(100\)/);
+        });
+        (0, vitest_1.it)("throws for a max-length varchar, which is still not Unicode-safe", () => {
+            // VARCHAR(MAX) reports a length of -1 but is non-Unicode, so it can
+            // silently corrupt multi-byte characters and must still be rejected.
+            (0, vitest_1.expect)(() => (0, tables_1.resolveColumnJsonDataType)("varchar", -1)).toThrow(/VARCHAR\(MAX\)/);
+        });
+        (0, vitest_1.it)("throws for text, naming the offending type", () => {
+            (0, vitest_1.expect)(() => (0, tables_1.resolveColumnJsonDataType)("text", 2147483647)).toThrow(/TEXT/);
+        });
+        (0, vitest_1.it)("names both acceptable types in the error message", () => {
+            let message = "";
+            try {
+                (0, tables_1.resolveColumnJsonDataType)("varchar", 100);
+            }
+            catch (error) {
+                message = error.message;
+            }
+            (0, vitest_1.expect)(message).toContain("NVARCHAR(MAX)");
+            (0, vitest_1.expect)(message).toContain("JSON");
+        });
+    });
+});
+(0, vitest_1.describe)("buildJsonTypeMismatchWarning", () => {
+    (0, vitest_1.it)("returns null when the existing and requested types are equal", () => {
+        (0, vitest_1.expect)((0, tables_1.buildJsonTypeMismatchWarning)("dbo", "t", "NVARCHAR(MAX)", "NVARCHAR(MAX)")).toBeNull();
+        (0, vitest_1.expect)((0, tables_1.buildJsonTypeMismatchWarning)("dbo", "t", "JSON", "JSON")).toBeNull();
+    });
+    (0, vitest_1.it)("returns a warning naming both types and the table when they differ", () => {
+        const warning = (0, tables_1.buildJsonTypeMismatchWarning)("dbo", "fhir_resources", "NVARCHAR(MAX)", "JSON");
+        (0, vitest_1.expect)(warning).not.toBeNull();
+        (0, vitest_1.expect)(warning).toContain("NVARCHAR(MAX)");
+        (0, vitest_1.expect)(warning).toContain("JSON");
+        (0, vitest_1.expect)(warning).toContain("fhir_resources");
+    });
+    (0, vitest_1.it)("names both the existing and the requested type in either direction", () => {
+        const warning = (0, tables_1.buildJsonTypeMismatchWarning)("dbo", "t", "JSON", "NVARCHAR(MAX)");
+        (0, vitest_1.expect)(warning).toMatch(/JSON/);
+        (0, vitest_1.expect)(warning).toMatch(/NVARCHAR\(MAX\)/);
+    });
+});
+//# sourceMappingURL=tables.test.js.map

package/dist/loader/tables.test.js.map

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

package/dist/loader/types.d.ts

@@ -49,6 +49,15 @@ export interface LoaderOptions {
     tableName?: string;
     /** Schema name (default: dbo). */
     schemaName?: string;
+    /**
+     * Storage type for the resources table `json` column. One of `NVARCHAR(MAX)`
+     * (default) or `JSON`. Matching is case-insensitive and tolerant of
+     * surrounding whitespace. `JSON` selects SQL Server 2025's native JSON type
+     * and requires SQL Server 2025 or later; when omitted the column is created as
+     * `NVARCHAR(MAX)`, exactly as in earlier releases. The value is validated
+     * against the allowlist before any database connection is opened.
+     */
+    resourceJsonDataType?: string;
     /** Create table if it doesn't exist. */
     createTable?: boolean;
     /** Truncate table before loading. */

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

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

package/dist/tests/load.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for the `load` command option mapping.
+ *
+ * Verifies that the `--resource-json-data-type` CLI flag is mapped onto
+ * `LoaderOptions.resourceJsonDataType` and passed through untouched, leaving
+ * validation and normalisation to the loader (FR-007, cli-load contract).
+ *
+ * @author John Grimes
+ */
+export {};
+//# sourceMappingURL=load.test.d.ts.map

package/dist/tests/load.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.test.d.ts","sourceRoot":"","sources":["../../src/tests/load.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/tests/load.test.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Unit tests for the `load` command option mapping.
+ *
+ * Verifies that the `--resource-json-data-type` CLI flag is mapped onto
+ * `LoaderOptions.resourceJsonDataType` and passed through untouched, leaving
+ * validation and normalisation to the loader (FR-007, cli-load contract).
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const load_1 = require("../load");
+(0, vitest_1.describe)("buildLoaderOptions", () => {
+    (0, vitest_1.it)("maps --resource-json-data-type onto resourceJsonDataType", () => {
+        // Dry-run avoids any need for database environment variables.
+        const options = (0, load_1.buildLoaderOptions)("./data", {
+            dryRun: true,
+            resourceJsonDataType: "JSON",
+        });
+        (0, vitest_1.expect)(options.resourceJsonDataType).toBe("JSON");
+    });
+    (0, vitest_1.it)("leaves resourceJsonDataType undefined when the flag is absent", () => {
+        const options = (0, load_1.buildLoaderOptions)("./data", { dryRun: true });
+        (0, vitest_1.expect)(options.resourceJsonDataType).toBeUndefined();
+    });
+    (0, vitest_1.it)("passes the raw value through without normalising", () => {
+        // Normalisation is the loader's responsibility; the CLI layer must not
+        // pre-empt it, so a lower-case value is forwarded verbatim.
+        const options = (0, load_1.buildLoaderOptions)("./data", {
+            dryRun: true,
+            resourceJsonDataType: "json",
+        });
+        (0, vitest_1.expect)(options.resourceJsonDataType).toBe("json");
+    });
+});
+//# sourceMappingURL=load.test.js.map

package/dist/tests/load.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.test.js","sourceRoot":"","sources":["../../src/tests/load.test.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAEH,mCAA8C;AAC9C,kCAA6C;AAE7C,IAAA,iBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAA,WAAE,EAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,8DAA8D;QAC9D,MAAM,OAAO,GAAG,IAAA,yBAAkB,EAAC,QAAQ,EAAE;YAC3C,MAAM,EAAE,IAAI;YACZ,oBAAoB,EAAE,MAAM;SAC7B,CAAC,CAAC;QACH,IAAA,eAAM,EAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,OAAO,GAAG,IAAA,yBAAkB,EAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,IAAA,eAAM,EAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,aAAa,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,uEAAuE;QACvE,4DAA4D;QAC5D,MAAM,OAAO,GAAG,IAAA,yBAAkB,EAAC,QAAQ,EAAE;YAC3C,MAAM,EAAE,IAAI;YACZ,oBAAoB,EAAE,MAAM;SAC7B,CAAC,CAAC;QACH,IAAA,eAAM,EAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/tests/utils/database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAkC,MAAM,OAAO,CAAC;AA+CvE;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBnD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAWrD;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,GAAG,EAAE,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCnE;AAwFD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAKhD"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/tests/utils/database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAkC,MAAM,OAAO,CAAC;AA4DvE;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBnD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAWrD;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,GAAG,EAAE,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCnE;AAsID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAKhD"}

package/dist/tests/utils/database.js

@@ -15,6 +15,7 @@ exports.cleanupTestData = cleanupTestData;
 exports.getDatabasePool = getDatabasePool;
 const lossless_json_1 = require("lossless-json");
 const mssql_1 = require("mssql");
+const validation_1 = require("../../validation");
 // Global connection pool
 let globalPool = null;
 let isConnected = false;
@@ -44,12 +45,20 @@ const getDatabaseConfig = () => {
 /**
  * Get table configuration from environment variables.
  * Uses a test-specific table name to avoid conflicts with production data.
+ *
+ * The `json` column's storage type is governed by MSSQL_RESOURCE_JSON_DATA_TYPE
+ * (default `NVARCHAR(MAX)`); setting it to `JSON` exercises the native JSON type
+ * and requires a SQL Server 2025 instance. This lets the full conformance suite
+ * run against both column types (FR-011).
  */
 const getTableConfig = () => ({
     tableName: process.env.MSSQL_TEST_TABLE ?? "fhir_resources_test",
     schemaName: process.env.MSSQL_SCHEMA ?? "dbo",
     resourceIdColumn: "id",
     resourceJsonColumn: "json",
+    resourceJsonDataType: process.env.MSSQL_RESOURCE_JSON_DATA_TYPE
+        ? (0, validation_1.normaliseResourceJsonDataType)(process.env.MSSQL_RESOURCE_JSON_DATA_TYPE)
+        : "NVARCHAR(MAX)",
 });
 /**
  * Setup database connection and create the FHIR resources table.
@@ -215,6 +224,34 @@ async function clearTestTable() {
         throw new Error(`Failed to clear test table: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+/**
+ * Determine the existing test table's json column type.
+ *
+ * Maps the INFORMATION_SCHEMA representation to a canonical type: `json` for the
+ * native type, otherwise `NVARCHAR(MAX)` (the test table only ever uses these
+ * two). Used to decide whether the persisted table needs recreating when the
+ * configured type changes.
+ *
+ * @param tableConfig - The resolved test table configuration.
+ * @returns The canonical existing json column type.
+ */
+async function getExistingTestTableJsonType(tableConfig) {
+    if (!globalPool) {
+        throw new Error("Database not connected");
+    }
+    const request = new mssql_1.Request(globalPool);
+    request.input("schemaName", tableConfig.schemaName);
+    request.input("tableName", tableConfig.tableName);
+    request.input("columnName", tableConfig.resourceJsonColumn);
+    const result = await request.query(`
+    SELECT DATA_TYPE
+    FROM INFORMATION_SCHEMA.COLUMNS
+    WHERE TABLE_SCHEMA = @schemaName
+      AND TABLE_NAME = @tableName
+      AND COLUMN_NAME = @columnName
+  `);
+    return result.recordset[0]?.DATA_TYPE === "json" ? "JSON" : "NVARCHAR(MAX)";
+}
 /**
  * Create the FHIR resources table if it doesn't exist.
  */
@@ -236,14 +273,25 @@ async function createTableIfNotExists() {
         const checkResult = await checkRequest.query(checkTableSql);
         const tableExists = checkResult.recordset[0]?.table_count > 0;
         if (tableExists) {
-            return;
+            // The shared test table persists between runs. If its json column type no
+            // longer matches the configured type (e.g. switching
+            // MSSQL_RESOURCE_JSON_DATA_TYPE between NVARCHAR(MAX) and JSON), drop it so
+            // it is recreated with the right type; otherwise leave it as is.
+            const existingType = await getExistingTestTableJsonType(tableConfig);
+            if (existingType === tableConfig.resourceJsonDataType) {
+                return;
+            }
+            await new mssql_1.Request(globalPool).query(`DROP TABLE ${tableName}`);
         }
-        // Create test table with test_id column for concurrent test isolation
+        // Create test table with test_id column for concurrent test isolation. The
+        // json column type is configurable so the same suite can prove conformance
+        // over both NVARCHAR(MAX) and the native JSON type. The type is a canonical,
+        // allowlisted value (see getTableConfig), so it carries no injection risk.
         const createTableSql = `
       CREATE TABLE ${tableName} (
         [${tableConfig.resourceIdColumn}] INT IDENTITY(1,1) NOT NULL PRIMARY KEY,
         [resource_type] NVARCHAR(64) NOT NULL,
-        [${tableConfig.resourceJsonColumn}] NVARCHAR(MAX) NOT NULL,
+        [${tableConfig.resourceJsonColumn}] ${tableConfig.resourceJsonDataType} NOT NULL,
         [test_id] NVARCHAR(255) NOT NULL
       )
     `;