sof-mssql 1.0.0

package/dist/loader/tables.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Table management for NDJSON loader.
+ * Creates and manages the single fhir_resources table.
+ *
+ * @author John Grimes
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableExists = tableExists;
+exports.createTable = createTable;
+exports.truncateTable = truncateTable;
+exports.ensureTable = ensureTable;
+const mssql_1 = __importDefault(require("mssql"));
+/**
+ * Check if a table exists in the database.
+ *
+ * @param pool - Database connection pool.
+ * @param schemaName - Schema name.
+ * @param tableName - Name of the table to check.
+ * @returns Promise that resolves to true if the table exists.
+ */
+async function tableExists(pool, schemaName, tableName) {
+    const result = await pool
+        .request()
+        .input("schemaName", mssql_1.default.NVarChar, schemaName)
+        .input("tableName", mssql_1.default.NVarChar, tableName).query(`
+      SELECT COUNT(*) as count
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = @schemaName AND TABLE_NAME = @tableName
+    `);
+    return result.recordset[0].count > 0;
+}
+/**
+ * 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))
+ *
+ * @param pool - Database connection pool.
+ * @param schemaName - Schema name.
+ * @param tableName - Name of the table to create.
+ */
+async function createTable(pool, schemaName, tableName) {
+    // 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
+    )
+  `);
+    // 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])
+  `);
+}
+/**
+ * Truncate a table (remove all rows).
+ *
+ * @param pool - Database connection pool.
+ * @param schemaName - Schema name.
+ * @param tableName - Name of the table to truncate.
+ */
+async function truncateTable(pool, schemaName, tableName) {
+    await pool.request().query(`TRUNCATE TABLE [${schemaName}].[${tableName}]`);
+}
+/**
+ * Ensure the fhir_resources table exists, creating it if necessary.
+ *
+ * @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.
+ */
+async function ensureTable(pool, schemaName, tableName, truncate = false) {
+    const exists = await tableExists(pool, schemaName, tableName);
+    if (exists) {
+        if (truncate) {
+            await truncateTable(pool, schemaName, tableName);
+        }
+    }
+    else {
+        await createTable(pool, schemaName, tableName);
+    }
+}
+//# sourceMappingURL=tables.js.map

package/dist/loader/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/loader/tables.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAYH,kCAeC;AAUD,kCAmBC;AASD,sCAMC;AAUD,kCAeC;AA9FD,kDAAiD;AAEjD;;;;;;;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,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,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"}

package/dist/loader/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Type definitions for the NDJSON loader.
+ *
+ * @author John Grimes
+ */
+/**
+ * Database connection configuration.
+ */
+export interface DatabaseConfig {
+    /** Database server hostname or IP address. */
+    host: string;
+    /** Database server port. */
+    port?: number;
+    /** Database username. */
+    user: string;
+    /** Database password. */
+    password: string;
+    /** Database name. */
+    database: string;
+    /** Whether to trust the server certificate. */
+    trustServerCertificate?: boolean;
+}
+/**
+ * Discovered NDJSON file with metadata.
+ */
+export interface DiscoveredFile {
+    /** Full path to the file. */
+    path: string;
+    /** FHIR resource type extracted from filename. */
+    resourceType: string;
+    /** File size in bytes. */
+    size: number;
+}
+/**
+ * Options for the NDJSON loader.
+ */
+export interface LoaderOptions {
+    /** Directory containing NDJSON files. */
+    directory: string;
+    /** Database connection configuration. */
+    database: DatabaseConfig;
+    /** File naming pattern (default: {ResourceType}.ndjson). */
+    pattern?: string;
+    /** Filter to specific resource type. */
+    resourceType?: string;
+    /** Table name for storing resources (default: fhir_resources). */
+    tableName?: string;
+    /** Schema name (default: dbo). */
+    schemaName?: string;
+    /** Create table if it doesn't exist. */
+    createTable?: boolean;
+    /** Truncate table before loading. */
+    truncate?: boolean;
+    /** Number of rows per batch for bulk insert. */
+    batchSize?: number;
+    /** Number of files to process in parallel. */
+    parallel?: number;
+    /** Continue loading other files if one fails. */
+    continueOnError?: boolean;
+    /** Show what would be loaded without loading. */
+    dryRun?: boolean;
+    /** Enable verbose logging. */
+    verbose?: boolean;
+    /** Minimal output. */
+    quiet?: boolean;
+    /** Show progress bar. */
+    progress?: boolean;
+}
+/**
+ * Progress information for a file being loaded.
+ */
+export interface FileProgress {
+    /** File being processed. */
+    file: DiscoveredFile;
+    /** Number of rows loaded. */
+    rowsLoaded: number;
+    /** Number of rows that failed to load. */
+    rowsFailed: number;
+    /** Whether the file has completed loading. */
+    completed: boolean;
+    /** Error message if the file failed to load. */
+    error?: string;
+}
+/**
+ * Overall progress for the loading operation.
+ */
+export interface LoaderProgress {
+    /** Total number of files to process. */
+    totalFiles: number;
+    /** Number of files completed. */
+    filesCompleted: number;
+    /** Total rows loaded across all files. */
+    totalRowsLoaded: number;
+    /** Total rows failed across all files. */
+    totalRowsFailed: number;
+    /** Progress for each file. */
+    fileProgress: Map<string, FileProgress>;
+}
+/**
+ * Summary of the loading operation.
+ */
+export interface LoaderSummary {
+    /** Number of files successfully loaded. */
+    filesLoaded: number;
+    /** Number of files that failed to load. */
+    filesFailed: number;
+    /** Total rows loaded. */
+    rowsLoaded: number;
+    /** Total rows that failed to load. */
+    rowsFailed: number;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Errors encountered during loading. */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+/**
+ * Result of loading a single file.
+ */
+export interface FileLoadResult {
+    /** File that was loaded. */
+    file: DiscoveredFile;
+    /** Number of rows successfully loaded. */
+    rowsLoaded: number;
+    /** Number of rows that failed to load. */
+    rowsFailed: number;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Error message if the file failed to load. */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/loader/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Type definitions for the NDJSON loader.
+ *
+ * @author John Grimes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/loader/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/loader/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/parser.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Parser for ViewDefinition JSON structures.
+ */
+import { TestSuite, ViewDefinition } from "./types.js";
+export declare class ViewDefinitionParser {
+    /**
+     * Parse a ViewDefinition from JSON.
+     */
+    static parseViewDefinition(json: string | object): ViewDefinition;
+    /**
+     * Parse a test suite from the sql-on-fhir-v2 format.
+     */
+    static parseTestSuite(json: string | object): TestSuite;
+    /**
+     * Validate and narrow a ViewDefinition structure using type predicate.
+     */
+    private static isValidViewDefinition;
+    /**
+     * Validate select element using type predicate.
+     */
+    private static isValidSelect;
+    /**
+     * Validate select element has required structure.
+     */
+    private static validateSelectStructure;
+    /**
+     * Validate forEach and forEachOrNull expressions.
+     */
+    private static validateSelectExpressions;
+    /**
+     * Validate columns in a select element.
+     */
+    private static validateSelectColumns;
+    /**
+     * Validate nested select elements.
+     */
+    private static validateNestedSelects;
+    /**
+     * Validate unionAll branches.
+     */
+    private static validateUnionAll;
+    /**
+     * Validate column using type predicate.
+     */
+    private static isValidColumn;
+    /**
+     * Validate collection property constraints.
+     */
+    private static validateCollectionConstraints;
+    /**
+     * Validate that all branches of a unionAll have the same columns in the same order.
+     */
+    private static validateUnionAllColumns;
+    /**
+     * Extract column definitions from a select element.
+     * Handles direct columns, forEach columns, and nested select columns.
+     */
+    private static extractColumnsFromSelect;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EAIT,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc;IAWjE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUvD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA8BpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAQtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAUxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAWpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAWpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAY/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAyB5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAiC5C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA0CtC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CA+BxC"}

package/dist/parser.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Parser for ViewDefinition JSON structures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewDefinitionParser = void 0;
+class ViewDefinitionParser {
+    /**
+     * Parse a ViewDefinition from JSON.
+     */
+    static parseViewDefinition(json) {
+        const data = typeof json === "string" ? JSON.parse(json) : json;
+        if (this.isValidViewDefinition(data)) {
+            return data;
+        }
+        throw new Error("Invalid ViewDefinition structure.");
+    }
+    /**
+     * Parse a test suite from the sql-on-fhir-v2 format.
+     */
+    static parseTestSuite(json) {
+        const data = typeof json === "string" ? JSON.parse(json) : json;
+        if (!data.title || !data.resources || !data.tests) {
+            throw new Error("Invalid test suite format. Missing required fields.");
+        }
+        return data;
+    }
+    /**
+     * Validate and narrow a ViewDefinition structure using type predicate.
+     */
+    static isValidViewDefinition(data) {
+        if (!data.resource || typeof data.resource !== "string") {
+            throw new Error("ViewDefinition must specify a resource type.");
+        }
+        if (!data.select ||
+            !Array.isArray(data.select) ||
+            data.select.length === 0) {
+            throw new Error("ViewDefinition must have at least one select element.");
+        }
+        // Status is optional for test cases, but recommended for production use
+        // The SQL-on-FHIR spec requires status, but test cases may omit it
+        // Default to 'active' if not specified
+        data.status ??= "active";
+        // Validate select elements
+        for (const select of data.select) {
+            if (!this.isValidSelect(select)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Validate select element using type predicate.
+     */
+    static isValidSelect(select) {
+        this.validateSelectStructure(select);
+        this.validateSelectExpressions(select);
+        return (this.validateSelectColumns(select) &&
+            this.validateNestedSelects(select) &&
+            this.validateUnionAll(select));
+    }
+    /**
+     * Validate select element has required structure.
+     */
+    static validateSelectStructure(select) {
+        if (!select.column && !select.select && !select.unionAll) {
+            throw new Error("Select element must have columns, nested selects, or unionAll.");
+        }
+    }
+    /**
+     * Validate forEach and forEachOrNull expressions.
+     */
+    static validateSelectExpressions(select) {
+        if (select.forEach && typeof select.forEach !== "string") {
+            throw new Error("forEach must be a string FHIRPath expression.");
+        }
+        if (select.forEachOrNull && typeof select.forEachOrNull !== "string") {
+            throw new Error("forEachOrNull must be a string FHIRPath expression.");
+        }
+    }
+    /**
+     * Validate columns in a select element.
+     */
+    static validateSelectColumns(select) {
+        if (select.column) {
+            for (const column of select.column) {
+                if (!this.isValidColumn(column, select)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Validate nested select elements.
+     */
+    static validateNestedSelects(select) {
+        if (select.select) {
+            for (const nestedSelect of select.select) {
+                if (!this.isValidSelect(nestedSelect)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Validate unionAll branches.
+     */
+    static validateUnionAll(select) {
+        if (select.unionAll) {
+            for (const unionSelect of select.unionAll) {
+                if (!this.isValidSelect(unionSelect)) {
+                    return false;
+                }
+            }
+            this.validateUnionAllColumns(select.unionAll);
+        }
+        return true;
+    }
+    /**
+     * Validate column using type predicate.
+     */
+    static isValidColumn(column, selectContext) {
+        if (!column.name || typeof column.name !== "string") {
+            throw new Error("Column must have a valid name.");
+        }
+        if (!column.path || typeof column.path !== "string") {
+            throw new Error("Column must have a valid FHIRPath expression.");
+        }
+        // Validate column name is database-friendly
+        if (!/^[a-zA-Z_]\w*$/.test(column.name)) {
+            throw new Error(`Column name '${column.name}' is not database-friendly. Use alphanumeric and underscores only.`);
+        }
+        // Validate collection constraints
+        this.validateCollectionConstraints(column, selectContext);
+        return true;
+    }
+    /**
+     * Validate collection property constraints.
+     */
+    static validateCollectionConstraints(column, selectContext) {
+        if (column.collection === false) {
+            // At this point, path has been validated to be a string in isValidColumn
+            const path = column.path;
+            // Known array fields in FHIR Patient that could return multiple values
+            const multiValuedPaths = [
+                "name.family",
+                "name.given",
+                "telecom.value",
+                "address.line",
+                "identifier.value",
+                "extension.value",
+            ];
+            // Check if this path could return multiple values without forEach context
+            const isInForEachContext = selectContext && (selectContext.forEach ?? selectContext.forEachOrNull);
+            if (!isInForEachContext &&
+                multiValuedPaths.some((multiPath) => path.includes(multiPath))) {
+                throw new Error(`Path '${path}' can return multiple values. Use collection=true or place within a forEach context.`);
+            }
+        }
+    }
+    /**
+     * Validate that all branches of a unionAll have the same columns in the same order.
+     */
+    static validateUnionAllColumns(unionAllBranches) {
+        if (unionAllBranches.length < 2) {
+            return; // Nothing to validate
+        }
+        // Extract column definitions from each branch
+        const branchColumns = [];
+        for (const branch of unionAllBranches) {
+            const columns = this.extractColumnsFromSelect(branch);
+            branchColumns.push(columns);
+        }
+        // Compare first branch with all other branches
+        const firstBranch = branchColumns[0];
+        for (let i = 1; i < branchColumns.length; i++) {
+            const currentBranch = branchColumns[i];
+            // Check if column count matches
+            if (firstBranch.length !== currentBranch.length) {
+                throw new Error(`unionAll branches must have the same columns. ` +
+                    `Branch 1 has ${firstBranch.length} columns, but branch ${i + 1} has ${currentBranch.length} columns.`);
+            }
+            // Check if column names and order match
+            for (let j = 0; j < firstBranch.length; j++) {
+                if (firstBranch[j].name !== currentBranch[j].name) {
+                    throw new Error(`unionAll branches must have the same columns in the same order. ` +
+                        `Column at position ${j + 1}: branch 1 has "${firstBranch[j].name}", ` +
+                        `but branch ${i + 1} has "${currentBranch[j].name}".`);
+                }
+            }
+        }
+    }
+    /**
+     * Extract column definitions from a select element.
+     * Handles direct columns, forEach columns, and nested select columns.
+     */
+    static extractColumnsFromSelect(select) {
+        const columns = [];
+        // Direct columns
+        if (select.column) {
+            for (const column of select.column) {
+                columns.push({
+                    name: column.name,
+                    type: column.type,
+                });
+            }
+        }
+        // Nested select columns
+        if (select.select) {
+            for (const nestedSelect of select.select) {
+                const nestedColumns = this.extractColumnsFromSelect(nestedSelect);
+                columns.push(...nestedColumns);
+            }
+        }
+        // UnionAll - take columns from first branch (all branches should be validated to match)
+        if (select.unionAll && select.unionAll.length > 0) {
+            const unionColumns = this.extractColumnsFromSelect(select.unionAll[0]);
+            columns.push(...unionColumns);
+        }
+        return columns;
+    }
+}
+exports.ViewDefinitionParser = ViewDefinitionParser;
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/queryGenerator/ColumnExpressionGenerator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Generates SQL expressions for ViewDefinition columns.
+ */
+import { TranspilerContext } from "../fhirpath/transpiler.js";
+import { ViewDefinitionColumn } from "../types.js";
+/**
+ * Handles generation of column expressions with type casting.
+ */
+export declare class ColumnExpressionGenerator {
+    /**
+     * Generate SQL expression for a column.
+     */
+    generateExpression(column: ViewDefinitionColumn, context: TranspilerContext): string;
+    /**
+     * Apply type casting to an expression.
+     */
+    private applyTypeCasting;
+    /**
+     * Generate a CASE expression for boolean conversion.
+     * Handles both simple JSON_VALUE fields and boolean expressions.
+     */
+    private generateBooleanCaseExpression;
+    /**
+     * Generate collection expression that returns an array.
+     */
+    private generateCollectionExpression;
+    /**
+     * Build a JSON path expression for collection=true.
+     */
+    private buildCollectionJsonPath;
+    /**
+     * Check if path is name.family.
+     */
+    private isNameFamilyPath;
+    /**
+     * Check if path is name.given.
+     */
+    private isNameGivenPath;
+    /**
+     * Build collection query for name.family path.
+     */
+    private buildNameFamilyCollectionQuery;
+    /**
+     * Build collection query for name.given path.
+     */
+    private buildNameGivenCollectionQuery;
+    /**
+     * Generate single value expression for collection=false.
+     */
+    private generateSingleValueExpression;
+}
+//# sourceMappingURL=ColumnExpressionGenerator.d.ts.map

package/dist/queryGenerator/ColumnExpressionGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnExpressionGenerator.d.ts","sourceRoot":"","sources":["../../src/queryGenerator/ColumnExpressionGenerator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAc,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,kBAAkB,CAChB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,iBAAiB,GACzB,MAAM;IA0BT;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAkBrC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAWpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAWtC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAYrC;;OAEG;IACH,OAAO,CAAC,6BAA6B;CAMtC"}