sof-mssql 2.3.0 → 2.4.0

package/dist/loader/feedback.integration.test.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Integration tests for misconfiguration feedback (US4).
+ *
+ * Covers: invalid values rejected before any connection is opened (FR-003,
+ * runs without a database); an existing-table type mismatch emitting a warning
+ * and leaving the table unaltered (FR-008, runs on any server); and the SQL
+ * Server "unsupported type" error being surfaced rather than swallowed when
+ * JSON is requested on a server that does not support it (FR-009, runs only on
+ * pre-2025 servers).
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("./index");
+const loaderIntegration_1 = require("../tests/utils/loaderIntegration");
+const harness = (0, loaderIntegration_1.createLoaderIntegrationHarness)();
+(0, vitest_1.beforeAll)(() => harness.connect());
+(0, vitest_1.afterAll)(() => harness.cleanup());
+(0, vitest_1.describe)("invalid resourceJsonDataType (US4, no database required)", () => {
+    (0, vitest_1.it)("throws before opening a connection", async () => {
+        // The database host is unroutable. If validation did not run first, the
+        // call would fail with a connection error; instead it must fail with the
+        // validation error, proving no connection was attempted (FR-003).
+        await (0, vitest_1.expect)((0, index_1.loadNdjsonFiles)({
+            directory: "/nonexistent-directory",
+            database: {
+                host: "203.0.113.1",
+                user: "unused",
+                password: "unused",
+                database: "unused",
+            },
+            resourceJsonDataType: "TEXT",
+        })).rejects.toThrow(/Invalid resource JSON data type.*TEXT/s);
+    });
+});
+(0, vitest_1.describe)("existing-table type mismatch (US4)", () => {
+    (0, vitest_1.it)("warns naming both types and does not alter the existing table", async () => {
+        // First load creates the table as the default NVARCHAR(MAX).
+        const tableName = harness.makeTableName();
+        await harness.loadSample(tableName);
+        // Second load requests JSON against the now-existing NVARCHAR(MAX) table.
+        const warnSpy = vitest_1.vi.spyOn(console, "warn").mockImplementation(() => { });
+        let warnings = [];
+        try {
+            await harness.loadSample(tableName, "JSON");
+            warnings = warnSpy.mock.calls.map((call) => call.join(" "));
+        }
+        finally {
+            warnSpy.mockRestore();
+        }
+        // A warning naming both the existing and requested types must be emitted.
+        const mismatchWarning = warnings.find((w) => w.includes("NVARCHAR(MAX)") &&
+            w.includes("JSON") &&
+            w.includes(tableName));
+        (0, vitest_1.expect)(mismatchWarning).toBeDefined();
+        // The table must be left unaltered (still NVARCHAR(MAX)).
+        const columnType = await harness.getJsonColumnType(tableName);
+        (0, vitest_1.expect)(columnType.dataType).toBe("nvarchar");
+        (0, vitest_1.expect)(columnType.maxLength).toBe(-1);
+    });
+});
+(0, vitest_1.describe)("JSON requested on an unsupporting server (US4)", () => {
+    (0, vitest_1.it)("surfaces the SQL Server error rather than swallowing it", async (ctx) => {
+        // Only meaningful on servers without the native JSON type; on SQL Server
+        // 2025+ the request succeeds, so this is skipped there. CI exercises it on
+        // the 2017/2019/2022 matrix dimensions (FR-009).
+        if (harness.isNativeJsonSupported()) {
+            ctx.skip();
+        }
+        const tableName = harness.makeTableName();
+        await (0, vitest_1.expect)(harness.loadSample(tableName, "JSON")).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=feedback.integration.test.js.map

package/dist/loader/feedback.integration.test.js.map

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

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

@@ -1 +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"}
+{"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;AAkOpB;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAqCxB;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"}

package/dist/loader/index.js

@@ -21,6 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadNdjsonFiles = loadNdjsonFiles;
+const validation_js_1 = require("../validation.js");
 const connection_js_1 = require("./connection.js");
 const discovery_js_1 = require("./discovery.js");
 const tables_js_1 = require("./tables.js");
@@ -74,14 +75,20 @@ function chunkFiles(files, chunkSize) {
  * @param options - Loader options.
  * @returns Table schema and name.
  */
-async function prepareTable(pool, options) {
+async function prepareTable(pool, options, jsonType) {
     const schemaName = options.schemaName ?? "dbo";
     const tableName = options.tableName ?? "fhir_resources";
     if (options.createTable !== false) {
         if (options.verbose) {
-            console.log(`Ensuring table [${schemaName}].[${tableName}] exists${options.truncate ? " (will truncate)" : ""}...`);
+            console.log(`Ensuring table [${schemaName}].[${tableName}] exists as [json] ${jsonType}${options.truncate ? " (will truncate)" : ""}...`);
         }
-        await (0, tables_js_1.ensureTable)(pool, schemaName, tableName, options.truncate ?? false);
+        await (0, tables_js_1.ensureTable)(pool, schemaName, tableName, options.truncate ?? false, jsonType);
+    }
+    else {
+        // Table creation is disabled, so the requested type cannot be applied.
+        // Still surface a mismatch against an existing table so misconfiguration
+        // remains visible (FR-008 edge case).
+        await (0, tables_js_1.warnIfJsonTypeMismatch)(pool, schemaName, tableName, jsonType);
     }
     return { schemaName, tableName };
 }
@@ -129,7 +136,7 @@ async function loadFilesInChunks(pool, files, options, schemaName, tableName, pr
  * @param startTime - Start timestamp.
  * @returns Loader summary.
  */
-async function performLoad(pool, files, options, startTime) {
+async function performLoad(pool, files, options, startTime, jsonType) {
     const connected = await (0, connection_js_1.testConnection)(pool);
     if (!connected) {
         throw new Error("Failed to connect to database");
@@ -138,7 +145,7 @@ async function performLoad(pool, files, options, startTime) {
         console.log("Connected successfully\n");
     }
     const progress = (0, progress_js_1.createProgressTracker)(files);
-    const { schemaName, tableName } = await prepareTable(pool, options);
+    const { schemaName, tableName } = await prepareTable(pool, options, jsonType);
     if (!options.quiet) {
         console.log("Loading files...\n");
     }
@@ -160,6 +167,12 @@ async function performLoad(pool, files, options, startTime) {
  */
 async function loadNdjsonFiles(options) {
     const startTime = Date.now();
+    // Resolve and validate the json column storage type before any file
+    // discovery, connection or DDL. An invalid value throws synchronously here,
+    // so misconfiguration is reported before a connection is opened (FR-003).
+    const jsonType = options.resourceJsonDataType === undefined
+        ? "NVARCHAR(MAX)"
+        : (0, validation_js_1.normaliseResourceJsonDataType)(options.resourceJsonDataType);
     const files = discoverAndLogFiles(options);
     if (files.length === 0) {
         return (0, progress_js_1.createSummary)((0, progress_js_1.createProgressTracker)([]), Date.now() - startTime);
@@ -175,7 +188,7 @@ async function loadNdjsonFiles(options) {
     }
     const pool = await (0, connection_js_1.createConnectionPool)(options.database);
     try {
-        return await performLoad(pool, files, options, startTime);
+        return await performLoad(pool, files, options, startTime, jsonType);
     }
     finally {
         await (0, connection_js_1.closeConnectionPool)(pool);

package/dist/loader/index.js.map

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

package/dist/loader/jsonColumn.integration.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Database-backed integration tests for the configurable `json` column type.
+ *
+ * Exercises the loader end to end against a real SQL Server: the default
+ * `NVARCHAR(MAX)` column (US1, every supported version) and the native `JSON`
+ * column (US1/US2, SQL Server 2025+ only). The native-JSON cases skip
+ * automatically on servers that do not support the type, so the same file is
+ * safe to run across the whole CI matrix.
+ *
+ * @author John Grimes
+ */
+export {};
+//# sourceMappingURL=jsonColumn.integration.test.d.ts.map

package/dist/loader/jsonColumn.integration.test.d.ts.map

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

package/dist/loader/jsonColumn.integration.test.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Database-backed integration tests for the configurable `json` column type.
+ *
+ * Exercises the loader end to end against a real SQL Server: the default
+ * `NVARCHAR(MAX)` column (US1, every supported version) and the native `JSON`
+ * column (US1/US2, SQL Server 2025+ only). The native-JSON cases skip
+ * automatically on servers that do not support the type, so the same file is
+ * safe to run across the whole CI matrix.
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const loaderIntegration_1 = require("../tests/utils/loaderIntegration");
+const harness = (0, loaderIntegration_1.createLoaderIntegrationHarness)();
+(0, vitest_1.beforeAll)(() => harness.connect());
+(0, vitest_1.afterAll)(() => harness.cleanup());
+(0, vitest_1.describe)("loadNdjsonFiles json column type (US1)", () => {
+    (0, vitest_1.it)("creates an NVARCHAR(MAX) column and loads every row when the type is omitted", async () => {
+        // The default path must be unchanged from earlier releases (SC-001).
+        const tableName = harness.makeTableName();
+        const rowsLoaded = await harness.loadSample(tableName);
+        (0, vitest_1.expect)(rowsLoaded).toBe(loaderIntegration_1.SAMPLE_PATIENTS.length);
+        const columnType = await harness.getJsonColumnType(tableName);
+        (0, vitest_1.expect)(columnType.dataType).toBe("nvarchar");
+        (0, vitest_1.expect)(columnType.maxLength).toBe(-1);
+        (0, vitest_1.expect)(await harness.getRowCount(tableName)).toBe(loaderIntegration_1.SAMPLE_PATIENTS.length);
+    });
+    (0, vitest_1.it)("creates a native JSON column and loads every row when JSON is requested", async (ctx) => {
+        if (!harness.isNativeJsonSupported()) {
+            ctx.skip();
+        }
+        const tableName = harness.makeTableName();
+        const rowsLoaded = await harness.loadSample(tableName, "JSON");
+        (0, vitest_1.expect)(rowsLoaded).toBe(loaderIntegration_1.SAMPLE_PATIENTS.length);
+        const columnType = await harness.getJsonColumnType(tableName);
+        (0, vitest_1.expect)(columnType.dataType).toBe("json");
+        (0, vitest_1.expect)(await harness.getRowCount(tableName)).toBe(loaderIntegration_1.SAMPLE_PATIENTS.length);
+    });
+    (0, vitest_1.it)("accepts a lower-case json value and still creates the native type", async (ctx) => {
+        if (!harness.isNativeJsonSupported()) {
+            ctx.skip();
+        }
+        const tableName = harness.makeTableName();
+        await harness.loadSample(tableName, "json");
+        const columnType = await harness.getJsonColumnType(tableName);
+        (0, vitest_1.expect)(columnType.dataType).toBe("json");
+    });
+});
+(0, vitest_1.describe)("loadNdjsonFiles json column type (US2 - programmatic, no CLI)", () => {
+    // loadSample calls loadNdjsonFiles with LoaderOptions directly, demonstrating
+    // that the capability is fully available through the programmatic API with no
+    // CLI or commander layer involved.
+    (0, vitest_1.it)("honours LoaderOptions.resourceJsonDataType = JSON via the programmatic API", async (ctx) => {
+        if (!harness.isNativeJsonSupported()) {
+            ctx.skip();
+        }
+        const tableName = harness.makeTableName();
+        const rowsLoaded = await harness.loadSample(tableName, "JSON");
+        (0, vitest_1.expect)(rowsLoaded).toBe(loaderIntegration_1.SAMPLE_PATIENTS.length);
+        const columnType = await harness.getJsonColumnType(tableName);
+        (0, vitest_1.expect)(columnType.dataType).toBe("json");
+    });
+    (0, vitest_1.it)("defaults to NVARCHAR(MAX) programmatically when the option is omitted", async () => {
+        const tableName = harness.makeTableName();
+        const rowsLoaded = await harness.loadSample(tableName);
+        (0, vitest_1.expect)(rowsLoaded).toBe(loaderIntegration_1.SAMPLE_PATIENTS.length);
+        const columnType = await harness.getJsonColumnType(tableName);
+        (0, vitest_1.expect)(columnType.dataType).toBe("nvarchar");
+        (0, vitest_1.expect)(columnType.maxLength).toBe(-1);
+    });
+});
+(0, vitest_1.describe)("loadNdjsonFiles existing json column safeguard (FR-008)", () => {
+    (0, vitest_1.it)("fails fast when an existing json column cannot hold a FHIR resource", async () => {
+        // A pre-existing table whose json column is a bounded VARCHAR cannot hold a
+        // serialised FHIR resource. The loader must reject it before writing any
+        // rows, rather than coercing it to NVARCHAR(MAX) and corrupting data.
+        const tableName = harness.makeTableName();
+        await harness.createTableWithJsonColumnType(tableName, "VARCHAR(100)");
+        await (0, vitest_1.expect)(harness.loadSample(tableName)).rejects.toThrow(/VARCHAR\(100\)/);
+        // No rows must have been written into the unsafe column.
+        (0, vitest_1.expect)(await harness.getRowCount(tableName)).toBe(0);
+    });
+});
+//# sourceMappingURL=jsonColumn.integration.test.js.map

package/dist/loader/jsonColumn.integration.test.js.map

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

package/dist/loader/tables.d.ts

@@ -5,6 +5,63 @@
  * @author John Grimes
  */
 import { type ConnectionPool } from "mssql";
+import { type ResourceJsonDataType } from "../validation.js";
+/**
+ * The DDL statements needed to create the resources table and its index.
+ */
+export interface CreateTableStatements {
+    /** The `CREATE TABLE` statement. */
+    createTable: string;
+    /** The `CREATE INDEX` statement for the `resource_type` column. */
+    createIndex: string;
+}
+/**
+ * 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.
+ */
+export declare function buildCreateTableStatements(schemaName: string, tableName: string, jsonType: ResourceJsonDataType): CreateTableStatements;
+/**
+ * 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.
+ */
+export declare function resolveColumnJsonDataType(dataType: string, characterMaximumLength: number | null): ResourceJsonDataType;
+/**
+ * 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.
+ */
+export declare function buildJsonTypeMismatchWarning(schemaName: string, tableName: string, existingType: ResourceJsonDataType, requestedType: ResourceJsonDataType): string | null;
 /**
  * Check if a table exists in the database.
  *
@@ -14,15 +71,46 @@ import { type ConnectionPool } from "mssql";
  * @returns Promise that resolves to true if the table exists.
  */
 export declare function tableExists(pool: ConnectionPool, schemaName: string, tableName: string): Promise<boolean>;
+/**
+ * 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}).
+ */
+export declare function getExistingJsonColumnType(pool: ConnectionPool, schemaName: string, tableName: string): Promise<ResourceJsonDataType | null>;
+/**
+ * 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}).
+ */
+export declare function warnIfJsonTypeMismatch(pool: ConnectionPool, schemaName: string, tableName: string, requestedType: ResourceJsonDataType): Promise<void>;
 /**
  * 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)`).
  */
-export declare function createTable(pool: ConnectionPool, schemaName: string, tableName: string): Promise<void>;
+export declare function createTable(pool: ConnectionPool, schemaName: string, tableName: string, jsonType?: ResourceJsonDataType): Promise<void>;
 /**
  * Truncate a table (remove all rows).
  *
@@ -34,10 +122,15 @@ export declare function truncateTable(pool: ConnectionPool, schemaName: string,
 /**
  * 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)`).
  */
-export declare function ensureTable(pool: ConnectionPool, schemaName: string, tableName: string, truncate?: boolean): Promise<void>;
+export declare function ensureTable(pool: ConnectionPool, schemaName: string, tableName: string, truncate?: boolean, jsonType?: ResourceJsonDataType): Promise<void>;
 //# sourceMappingURL=tables.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/loader/tables.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAY,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAGjD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/loader/tables.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAY,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,GAC7B,qBAAqB,CAiBvB;AA0BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAAG,IAAI,GACpC,oBAAoB,CAgBtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,oBAAoB,EAClC,aAAa,EAAE,oBAAoB,GAClC,MAAM,GAAG,IAAI,CASf;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAiBtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,oBAAoB,GAClC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,oBAAsC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,OAAe,EACzB,QAAQ,GAAE,oBAAsC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAaf"}