@lossless.org/client 0.1.0

package/dist_ts/sqldb/clickhouse/index.js

@@ -0,0 +1,13 @@
+// Core
+export * from './smartclickhouse.classes.smartclickhouse.js';
+export * from './smartclickhouse.classes.clickhousetable.js';
+export * from './smartclickhouse.classes.httpclient.js';
+// Query & Results
+export * from './smartclickhouse.classes.querybuilder.js';
+export * from './smartclickhouse.classes.resultset.js';
+// Time Data Table (backward compat)
+export * from './smartclickhouse.classes.timedatatable.js';
+// Types
+export * from './smartclickhouse.types.js';
+export { MetricWriter } from './classes.metricwriter.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9zcWxkYi9jbGlja2hvdXNlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU87QUFDUCxjQUFjLDhDQUE4QyxDQUFDO0FBQzdELGNBQWMsOENBQThDLENBQUM7QUFDN0QsY0FBYyx5Q0FBeUMsQ0FBQztBQUV4RCxrQkFBa0I7QUFDbEIsY0FBYywyQ0FBMkMsQ0FBQztBQUMxRCxjQUFjLHdDQUF3QyxDQUFDO0FBRXZELG9DQUFvQztBQUNwQyxjQUFjLDRDQUE0QyxDQUFDO0FBRTNELFFBQVE7QUFDUixjQUFjLDRCQUE0QixDQUFDO0FBQzNDLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQyJ9

package/dist_ts/sqldb/clickhouse/smartclickhouse.classes.clickhousetable.d.ts

@@ -0,0 +1,88 @@
+import * as plugins from './smartclickhouse.plugins.js';
+import type { SmartClickHouseDb } from './smartclickhouse.classes.smartclickhouse.js';
+import { ClickhouseQueryBuilder } from './smartclickhouse.classes.querybuilder.js';
+import type { IClickhouseTableOptions, IColumnInfo, IEngineConfig } from './smartclickhouse.types.js';
+import { MetricWriter, type IMetricWriterOptions } from './classes.metricwriter.js';
+import type { IOperationOptions } from '../../core/interfaces.js';
+export declare class ClickhouseTable<T extends Record<string, any>> {
+    static create<T extends Record<string, any>>(db: SmartClickHouseDb, options: IClickhouseTableOptions<T>): Promise<ClickhouseTable<T>>;
+    db: SmartClickHouseDb;
+    options: IClickhouseTableOptions<T> & {
+        database: string;
+        engine: IEngineConfig;
+    };
+    columns: IColumnInfo[];
+    constructor(db: SmartClickHouseDb, options: IClickhouseTableOptions<T>);
+    protected get qualifiedName(): string;
+    private interval;
+    /**
+     * Creates the table if it doesn't exist and refreshes column metadata
+     */
+    setup(): Promise<void>;
+    /**
+     * Refresh column metadata from system.columns
+     */
+    updateColumns(): Promise<IColumnInfo[]>;
+    /**
+     * Auto-schema evolution: detect new columns from data and add them
+     */
+    syncSchema(data: Record<string, any>): Promise<void>;
+    /**
+     * Insert a single row
+     */
+    insert(data: Partial<T>): Promise<void>;
+    /**
+     * Insert multiple rows
+     */
+    insertMany(data: Partial<T>[]): Promise<void>;
+    /**
+     * Insert in batches of configurable size
+     */
+    insertBatch(data: Partial<T>[], options?: {
+        batchSize?: number;
+    }): Promise<void>;
+    /** Await write() for backpressure and close() for the final acknowledged flush. */
+    createInsertStream(options?: IMetricWriterOptions): MetricWriter<Partial<T>>;
+    /**
+     * Returns a fluent query builder for this table
+     */
+    query(): ClickhouseQueryBuilder<T>;
+    /**
+     * Update rows matching a where condition (ClickHouse mutation - use sparingly)
+     */
+    update(set: Partial<T>, whereFn: (q: ClickhouseQueryBuilder<T>) => ClickhouseQueryBuilder<T>): Promise<void>;
+    /**
+     * Delete rows matching a where condition (ClickHouse mutation)
+     */
+    deleteWhere(whereFn: (q: ClickhouseQueryBuilder<T>) => ClickhouseQueryBuilder<T>): Promise<void>;
+    /**
+     * Delete entries older than a given interval on a column
+     */
+    deleteOlderThan(column: keyof T & string, interval: string): Promise<void>;
+    /**
+     * Drop the entire table
+     */
+    drop(): Promise<void>;
+    /**
+     * Wait for all pending mutations on this table to complete
+     */
+    waitForMutations(options?: IOperationOptions): Promise<void>;
+    /**
+     * Get the total row count
+     */
+    getRowCount(): Promise<number>;
+    /**
+     * Optimize table (useful for ReplacingMergeTree deduplication)
+     */
+    optimize(final?: boolean): Promise<void>;
+    /**
+     * Watch for new entries via polling. Returns an RxJS Observable.
+     */
+    watch(_options?: {
+        pollInterval?: number;
+    }): plugins.smartrx.rxjs.Observable<T>;
+    private ensureColumn;
+    private flattenDocument;
+    private prepareDocument;
+    private executeInsert;
+}

package/dist_ts/sqldb/clickhouse/smartclickhouse.classes.clickhousetable.js

@@ -0,0 +1,304 @@
+import * as plugins from './smartclickhouse.plugins.js';
+import { ClickhouseQueryBuilder } from './smartclickhouse.classes.querybuilder.js';
+import { detectClickhouseType } from './smartclickhouse.types.js';
+import { quoteClickHouseIdentifier as quoteIdentifier } from '../interfaces.js';
+import { MetricWriter } from './classes.metricwriter.js';
+import { Operation } from '../../core/classes.operation.js';
+import { LosslessClientError } from '../../core/classes.error.js';
+export class ClickhouseTable {
+    // ---- STATIC FACTORY ----
+    static async create(db, options) {
+        const table = new ClickhouseTable(db, options);
+        await table.setup();
+        return table;
+    }
+    // ---- INSTANCE ----
+    db;
+    options;
+    columns = [];
+    constructor(db, options) {
+        this.db = db;
+        this.options = {
+            autoSchemaEvolution: true,
+            ...options,
+            database: options.database || db.options.database,
+            engine: options.engine || { engine: 'MergeTree' },
+        };
+    }
+    get qualifiedName() {
+        return quoteIdentifier(this.options.database) + '.' + quoteIdentifier(this.options.tableName);
+    }
+    interval(value) {
+        if (!/^[1-9][0-9]* (SECOND|MINUTE|HOUR|DAY|WEEK|MONTH|QUARTER|YEAR)$/i.test(value)) {
+            throw new RangeError('An interval must be a positive integer and a supported unit.');
+        }
+        return value;
+    }
+    // ---- SCHEMA MANAGEMENT ----
+    /**
+     * Creates the table if it doesn't exist and refreshes column metadata
+     */
+    async setup() {
+        const { database, tableName, engine, orderBy, partitionBy, primaryKey, ttl, retainDataForDays, columns } = this.options;
+        // Build column definitions
+        let columnDefs;
+        if (columns && columns.length > 0) {
+            columnDefs = columns.map((col) => {
+                let def = `${quoteIdentifier(col.name)} ${col.type}`;
+                if (col.defaultExpression)
+                    def += ` DEFAULT ${col.defaultExpression}`;
+                if (col.codec)
+                    def += ` CODEC(${col.codec})`;
+                return def;
+            }).join(',\n          ');
+        }
+        else {
+            // Default minimal schema — downstream code can add columns via auto-schema evolution
+            columnDefs = `timestamp DateTime64(3, 'Europe/Berlin'),\n          message String`;
+        }
+        // Build engine clause
+        if (!['MergeTree', 'ReplacingMergeTree', 'SummingMergeTree', 'AggregatingMergeTree',
+            'CollapsingMergeTree', 'VersionedCollapsingMergeTree'].includes(engine.engine)) {
+            throw new RangeError('Unsupported table engine.');
+        }
+        let engineClause = engine.engine;
+        if (engine.engine === 'ReplacingMergeTree' && engine.versionColumn) {
+            engineClause = `ReplacingMergeTree(${quoteIdentifier(engine.versionColumn)})`;
+        }
+        else if (engine.engine === 'CollapsingMergeTree' && engine.signColumn) {
+            engineClause = `CollapsingMergeTree(${quoteIdentifier(engine.signColumn)})`;
+        }
+        else if (engine.engine === 'VersionedCollapsingMergeTree' && engine.signColumn && engine.versionColumn) {
+            engineClause = `VersionedCollapsingMergeTree(${quoteIdentifier(engine.signColumn)}, ${quoteIdentifier(engine.versionColumn)})`;
+        }
+        else {
+            engineClause = `${engine.engine}()`;
+        }
+        // Build ORDER BY
+        const orderByStr = Array.isArray(orderBy) ? orderBy.map(quoteIdentifier).join(', ') : quoteIdentifier(orderBy);
+        let createSQL = `
+      CREATE TABLE IF NOT EXISTS ${this.qualifiedName} (
+          ${columnDefs}
+      ) ENGINE = ${engineClause}`;
+        if (partitionBy) {
+            createSQL += `\n      PARTITION BY ${partitionBy}`;
+        }
+        createSQL += `\n      ORDER BY (${orderByStr})`;
+        if (primaryKey) {
+            const primaryKeyStr = Array.isArray(primaryKey) ? primaryKey.map(quoteIdentifier).join(', ') : quoteIdentifier(primaryKey);
+            createSQL += `\n      PRIMARY KEY (${primaryKeyStr})`;
+        }
+        await this.db.clickhouseHttpClient.queryPromise(createSQL);
+        // Apply TTL if configured
+        if (ttl) {
+            await this.db.clickhouseHttpClient.queryPromise(`
+        ALTER TABLE ${this.qualifiedName}
+        MODIFY TTL toDateTime(${quoteIdentifier(String(ttl.column))}) + INTERVAL ${this.interval(ttl.interval)}
+      `);
+        }
+        else if (retainDataForDays && retainDataForDays > 0) {
+            // Legacy shorthand
+            await this.db.clickhouseHttpClient.queryPromise(`
+        ALTER TABLE ${this.qualifiedName}
+        MODIFY TTL toDateTime(timestamp) + INTERVAL ${this.interval(retainDataForDays + ' DAY')}
+      `);
+        }
+        await this.updateColumns();
+    }
+    /**
+     * Refresh column metadata from system.columns
+     */
+    async updateColumns() {
+        this.columns = await this.db.clickhouseHttpClient.queryPromise(`
+      SELECT * FROM system.columns
+      WHERE database = {database:String}
+      AND table = {table:String}
+    `, { database: this.options.database, table: this.options.tableName });
+        return this.columns;
+    }
+    /**
+     * Auto-schema evolution: detect new columns from data and add them
+     */
+    async syncSchema(data) {
+        const flatData = plugins.smartobject.toFlatObject(data);
+        for (const key of Object.keys(flatData)) {
+            if (key === 'timestamp')
+                continue;
+            const value = flatData[key];
+            const clickhouseType = detectClickhouseType(value);
+            if (!clickhouseType)
+                continue;
+            await this.ensureColumn(key, clickhouseType);
+        }
+    }
+    // ---- INSERT ----
+    /**
+     * Insert a single row
+     */
+    async insert(data) {
+        const storageDoc = await this.prepareDocument(data);
+        await this.executeInsert([storageDoc]);
+    }
+    /**
+     * Insert multiple rows
+     */
+    async insertMany(data) {
+        if (data.length === 0)
+            return;
+        // Schema sync across all documents
+        if (this.options.autoSchemaEvolution) {
+            const allKeys = new Set();
+            const sampleValues = {};
+            for (const doc of data) {
+                const flat = plugins.smartobject.toFlatObject(doc);
+                for (const [key, value] of Object.entries(flat)) {
+                    if (!allKeys.has(key)) {
+                        allKeys.add(key);
+                        sampleValues[key] = value;
+                    }
+                }
+            }
+            await this.syncSchema(sampleValues);
+        }
+        const storageDocs = data.map((doc) => this.flattenDocument(doc));
+        await this.executeInsert(storageDocs);
+    }
+    /**
+     * Insert in batches of configurable size
+     */
+    async insertBatch(data, options) {
+        const size = options?.batchSize ?? 500;
+        if (!Number.isSafeInteger(size) || size < 1)
+            throw new RangeError('batchSize must be positive.');
+        for (let offset = 0; offset < data.length; offset += size) {
+            await this.insertMany(data.slice(offset, offset + size));
+        }
+    }
+    /** Await write() for backpressure and close() for the final acknowledged flush. */
+    createInsertStream(options = {}) {
+        return this.db.ownWriter(new MetricWriter(rows => this.insertMany(rows), options));
+    }
+    // ---- QUERY ----
+    /**
+     * Returns a fluent query builder for this table
+     */
+    query() {
+        return new ClickhouseQueryBuilder(this.options.tableName, this.options.database, this.db.clickhouseHttpClient);
+    }
+    // ---- UPDATE ----
+    /**
+     * Update rows matching a where condition (ClickHouse mutation - use sparingly)
+     */
+    async update(set, whereFn) {
+        const qb = whereFn(new ClickhouseQueryBuilder(this.options.tableName, this.options.database, this.db.clickhouseHttpClient));
+        const whereClause = qb.buildWhereClause();
+        if (!whereClause) {
+            throw new Error('UPDATE requires a WHERE clause. Use a where condition to target specific rows.');
+        }
+        const setClauses = Object.entries(set)
+            .map(([key, value]) => `${quoteIdentifier(key)} = ${qb.bind(value)}`)
+            .join(', ');
+        await this.db.clickhouseHttpClient.mutatePromise(`ALTER TABLE ${this.qualifiedName} UPDATE ${setClauses} WHERE ${whereClause}`, qb.parameters);
+        await this.waitForMutations();
+    }
+    // ---- DELETE ----
+    /**
+     * Delete rows matching a where condition (ClickHouse mutation)
+     */
+    async deleteWhere(whereFn) {
+        const qb = whereFn(new ClickhouseQueryBuilder(this.options.tableName, this.options.database, this.db.clickhouseHttpClient));
+        const whereClause = qb.buildWhereClause();
+        if (!whereClause) {
+            throw new Error('DELETE requires a WHERE clause.');
+        }
+        await this.db.clickhouseHttpClient.mutatePromise(`ALTER TABLE ${this.qualifiedName} DELETE WHERE ${whereClause}`, qb.parameters);
+        await this.waitForMutations();
+    }
+    /**
+     * Delete entries older than a given interval on a column
+     */
+    async deleteOlderThan(column, interval) {
+        await this.db.clickhouseHttpClient.mutatePromise(`ALTER TABLE ${this.qualifiedName} DELETE WHERE ${quoteIdentifier(String(column))} < now() - INTERVAL ${this.interval(interval)}`);
+        await this.waitForMutations();
+    }
+    /**
+     * Drop the entire table
+     */
+    async drop() {
+        await this.db.clickhouseHttpClient.queryPromise(`DROP TABLE IF EXISTS ${this.qualifiedName}`);
+        this.columns = [];
+    }
+    // ---- UTILITIES ----
+    /**
+     * Wait for all pending mutations on this table to complete
+     */
+    async waitForMutations(options = {}) {
+        const operation = new Operation(options, this.db.options.timeoutMs);
+        try {
+            while (true) {
+                operation.check();
+                const rows = await this.db.clickhouseHttpClient.queryPromise('SELECT count() AS cnt FROM system.mutations WHERE is_done = 0 AND database = {database:String} AND table = {table:String}', { database: this.options.database, table: this.options.tableName }, { signal: operation.signal });
+                if (BigInt(rows[0]?.cnt ?? 0) === 0n)
+                    return;
+                await plugins.smartdelay.delayFor(100);
+            }
+        }
+        finally {
+            operation.dispose();
+        }
+    }
+    /**
+     * Get the total row count
+     */
+    async getRowCount() {
+        const result = await this.db.clickhouseHttpClient.queryPromise(`
+      SELECT count() AS cnt FROM ${this.qualifiedName} FORMAT JSONEachRow
+    `);
+        const count = Number(result[0]?.cnt ?? 0);
+        if (!Number.isSafeInteger(count))
+            throw new RangeError('Count exceeds a safe JavaScript integer.');
+        return count;
+    }
+    /**
+     * Optimize table (useful for ReplacingMergeTree deduplication)
+     */
+    async optimize(final = false) {
+        const finalClause = final ? ' FINAL' : '';
+        await this.db.clickhouseHttpClient.queryPromise(`OPTIMIZE TABLE ${this.qualifiedName}${finalClause}`);
+    }
+    // ---- OBSERVATION ----
+    /**
+     * Watch for new entries via polling. Returns an RxJS Observable.
+     */
+    watch(_options) {
+        return new plugins.smartrx.rxjs.Observable(observer => observer.error(new LosslessClientError('unsupported_capability', 'Timestamp polling cannot guarantee delivery of equal-timestamp or late rows. Use an explicit stable ingestion cursor before enabling a watch.')));
+    }
+    // ---- PRIVATE HELPERS ----
+    async ensureColumn(name, type) {
+        if (this.columns.some(column => column.name === name))
+            return;
+        await this.db.clickhouseHttpClient.queryPromise(`ALTER TABLE ${this.qualifiedName} ADD COLUMN IF NOT EXISTS ${quoteIdentifier(name)} ${type}`);
+        await this.updateColumns();
+    }
+    flattenDocument(data) {
+        const flat = plugins.smartobject.toFlatObject(data);
+        const storageDoc = {};
+        for (const [key, value] of Object.entries(flat)) {
+            const type = detectClickhouseType(value);
+            if (type || key === 'timestamp') {
+                storageDoc[key] = value;
+            }
+        }
+        return storageDoc;
+    }
+    async prepareDocument(data) {
+        if (this.options.autoSchemaEvolution) {
+            await this.syncSchema(data);
+        }
+        return this.flattenDocument(data);
+    }
+    async executeInsert(docs) {
+        await this.db.clickhouseHttpClient.insertPromise(this.options.database, this.options.tableName, docs);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRjbGlja2hvdXNlLmNsYXNzZXMuY2xpY2tob3VzZXRhYmxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvc3FsZGIvY2xpY2tob3VzZS9zbWFydGNsaWNraG91c2UuY2xhc3Nlcy5jbGlja2hvdXNldGFibGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSw4QkFBOEIsQ0FBQztBQUV4RCxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSwyQ0FBMkMsQ0FBQztBQU9uRixPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUNsRSxPQUFPLEVBQUUseUJBQXlCLElBQUksZUFBZSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDaEYsT0FBTyxFQUFFLFlBQVksRUFBNkIsTUFBTSwyQkFBMkIsQ0FBQztBQUNwRixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDNUQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFHbEUsTUFBTSxPQUFPLGVBQWU7SUFDMUIsMkJBQTJCO0lBRXBCLE1BQU0sQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUN4QixFQUFxQixFQUNyQixPQUFtQztRQUVuQyxNQUFNLEtBQUssR0FBRyxJQUFJLGVBQWUsQ0FBSSxFQUFFLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDbEQsTUFBTSxLQUFLLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDcEIsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDO0lBRUQscUJBQXFCO0lBRWQsRUFBRSxDQUFvQjtJQUN0QixPQUFPLENBQTJFO0lBQ2xGLE9BQU8sR0FBa0IsRUFBRSxDQUFDO0lBR25DLFlBQVksRUFBcUIsRUFBRSxPQUFtQztRQUNwRSxJQUFJLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQztRQUNiLElBQUksQ0FBQyxPQUFPLEdBQUc7WUFDYixtQkFBbUIsRUFBRSxJQUFJO1lBQ3pCLEdBQUcsT0FBTztZQUNWLFFBQVEsRUFBRSxPQUFPLENBQUMsUUFBUSxJQUFJLEVBQUUsQ0FBQyxPQUFPLENBQUMsUUFBUTtZQUNqRCxNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU0sSUFBSSxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUU7U0FDbEQsQ0FBQztJQUNKLENBQUM7SUFFRCxJQUFjLGFBQWE7UUFDekIsT0FBTyxlQUFlLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsR0FBRyxHQUFHLEdBQUcsZUFBZSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDaEcsQ0FBQztJQUVPLFFBQVEsQ0FBQyxLQUFhO1FBQzVCLElBQUksQ0FBQyxpRUFBaUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUNuRixNQUFNLElBQUksVUFBVSxDQUFDLDhEQUE4RCxDQUFDLENBQUM7UUFDdkYsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVELDhCQUE4QjtJQUU5Qjs7T0FFRztJQUNJLEtBQUssQ0FBQyxLQUFLO1FBQ2hCLE1BQU0sRUFBRSxRQUFRLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsV0FBVyxFQUFFLFVBQVUsRUFBRSxHQUFHLEVBQUUsaUJBQWlCLEVBQUUsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQztRQUV4SCwyQkFBMkI7UUFDM0IsSUFBSSxVQUFrQixDQUFDO1FBQ3ZCLElBQUksT0FBTyxJQUFJLE9BQU8sQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDbEMsVUFBVSxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLEVBQUUsRUFBRTtnQkFDL0IsSUFBSSxHQUFHLEdBQUcsR0FBRyxlQUFlLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLEdBQUcsQ0FBQyxJQUFJLEVBQUUsQ0FBQztnQkFDckQsSUFBSSxHQUFHLENBQUMsaUJBQWlCO29CQUFFLEdBQUcsSUFBSSxZQUFZLEdBQUcsQ0FBQyxpQkFBaUIsRUFBRSxDQUFDO2dCQUN0RSxJQUFJLEdBQUcsQ0FBQyxLQUFLO29CQUFFLEdBQUcsSUFBSSxVQUFVLEdBQUcsQ0FBQyxLQUFLLEdBQUcsQ0FBQztnQkFDN0MsT0FBTyxHQUFHLENBQUM7WUFDYixDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLENBQUM7UUFDM0IsQ0FBQzthQUFNLENBQUM7WUFDTixxRkFBcUY7WUFDckYsVUFBVSxHQUFHLHFFQUFxRSxDQUFDO1FBQ3JGLENBQUM7UUFFRCxzQkFBc0I7UUFDdEIsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLG9CQUFvQixFQUFFLGtCQUFrQixFQUFFLHNCQUFzQjtZQUNqRixxQkFBcUIsRUFBRSw4QkFBOEIsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztZQUNqRixNQUFNLElBQUksVUFBVSxDQUFDLDJCQUEyQixDQUFDLENBQUM7UUFDcEQsQ0FBQztRQUNELElBQUksWUFBWSxHQUFXLE1BQU0sQ0FBQyxNQUFNLENBQUM7UUFDekMsSUFBSSxNQUFNLENBQUMsTUFBTSxLQUFLLG9CQUFvQixJQUFJLE1BQU0sQ0FBQyxhQUFhLEVBQUUsQ0FBQztZQUNuRSxZQUFZLEdBQUcsc0JBQXNCLGVBQWUsQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQztRQUNoRixDQUFDO2FBQU0sSUFBSSxNQUFNLENBQUMsTUFBTSxLQUFLLHFCQUFxQixJQUFJLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUN4RSxZQUFZLEdBQUcsdUJBQXVCLGVBQWUsQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQztRQUM5RSxDQUFDO2FBQU0sSUFBSSxNQUFNLENBQUMsTUFBTSxLQUFLLDhCQUE4QixJQUFJLE1BQU0sQ0FBQyxVQUFVLElBQUksTUFBTSxDQUFDLGFBQWEsRUFBRSxDQUFDO1lBQ3pHLFlBQVksR0FBRyxnQ0FBZ0MsZUFBZSxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsS0FBSyxlQUFlLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxHQUFHLENBQUM7UUFDakksQ0FBQzthQUFNLENBQUM7WUFDTixZQUFZLEdBQUcsR0FBRyxNQUFNLENBQUMsTUFBTSxJQUFJLENBQUM7UUFDdEMsQ0FBQztRQUVELGlCQUFpQjtRQUNqQixNQUFNLFVBQVUsR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGVBQWUsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsZUFBZSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBRS9HLElBQUksU0FBUyxHQUFHO21DQUNlLElBQUksQ0FBQyxhQUFhO1lBQ3pDLFVBQVU7bUJBQ0gsWUFBWSxFQUFFLENBQUM7UUFFOUIsSUFBSSxXQUFXLEVBQUUsQ0FBQztZQUNoQixTQUFTLElBQUksd0JBQXdCLFdBQVcsRUFBRSxDQUFDO1FBQ3JELENBQUM7UUFFRCxTQUFTLElBQUkscUJBQXFCLFVBQVUsR0FBRyxDQUFDO1FBRWhELElBQUksVUFBVSxFQUFFLENBQUM7WUFDZixNQUFNLGFBQWEsR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLGVBQWUsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsZUFBZSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1lBQzNILFNBQVMsSUFBSSx3QkFBd0IsYUFBYSxHQUFHLENBQUM7UUFDeEQsQ0FBQztRQUVELE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FBQyxZQUFZLENBQUMsU0FBUyxDQUFDLENBQUM7UUFFM0QsMEJBQTBCO1FBQzFCLElBQUksR0FBRyxFQUFFLENBQUM7WUFDUixNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsWUFBWSxDQUFDO3NCQUNoQyxJQUFJLENBQUMsYUFBYTtnQ0FDUixlQUFlLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQyxnQkFBZ0IsSUFBSSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDO09BQ3ZHLENBQUMsQ0FBQztRQUNMLENBQUM7YUFBTSxJQUFJLGlCQUFpQixJQUFJLGlCQUFpQixHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ3RELG1CQUFtQjtZQUNuQixNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsWUFBWSxDQUFDO3NCQUNoQyxJQUFJLENBQUMsYUFBYTtzREFDYyxJQUFJLENBQUMsUUFBUSxDQUFDLGlCQUFpQixHQUFHLE1BQU0sQ0FBQztPQUN4RixDQUFDLENBQUM7UUFDTCxDQUFDO1FBRUQsTUFBTSxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7SUFDN0IsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLGFBQWE7UUFDeEIsSUFBSSxDQUFDLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsWUFBWSxDQUFDOzs7O0tBSTlELEVBQUUsRUFBRSxRQUFRLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsS0FBSyxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUMsQ0FBQztRQUN2RSxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUM7SUFDdEIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUF5QjtRQUMvQyxNQUFNLFFBQVEsR0FBRyxPQUFPLENBQUMsV0FBVyxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN4RCxLQUFLLE1BQU0sR0FBRyxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQztZQUN4QyxJQUFJLEdBQUcsS0FBSyxXQUFXO2dCQUFFLFNBQVM7WUFDbEMsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQzVCLE1BQU0sY0FBYyxHQUFHLG9CQUFvQixDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQ25ELElBQUksQ0FBQyxjQUFjO2dCQUFFLFNBQVM7WUFDOUIsTUFBTSxJQUFJLENBQUMsWUFBWSxDQUFDLEdBQUcsRUFBRSxjQUFjLENBQUMsQ0FBQztRQUMvQyxDQUFDO0lBQ0gsQ0FBQztJQUVELG1CQUFtQjtJQUVuQjs7T0FFRztJQUNJLEtBQUssQ0FBQyxNQUFNLENBQUMsSUFBZ0I7UUFFbEMsTUFBTSxVQUFVLEdBQUcsTUFBTSxJQUFJLENBQUMsZUFBZSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3BELE1BQU0sSUFBSSxDQUFDLGFBQWEsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUM7SUFDekMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUFrQjtRQUN4QyxJQUFJLElBQUksQ0FBQyxNQUFNLEtBQUssQ0FBQztZQUFFLE9BQU87UUFFOUIsbUNBQW1DO1FBQ25DLElBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1lBQ3JDLE1BQU0sT0FBTyxHQUFHLElBQUksR0FBRyxFQUFVLENBQUM7WUFDbEMsTUFBTSxZQUFZLEdBQXdCLEVBQUUsQ0FBQztZQUM3QyxLQUFLLE1BQU0sR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO2dCQUN2QixNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsV0FBVyxDQUFDLFlBQVksQ0FBQyxHQUFHLENBQUMsQ0FBQztnQkFDbkQsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztvQkFDaEQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQzt3QkFDdEIsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQzt3QkFDakIsWUFBWSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQztvQkFDNUIsQ0FBQztnQkFDSCxDQUFDO1lBQ0gsQ0FBQztZQUNELE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxZQUFZLENBQUMsQ0FBQztRQUN0QyxDQUFDO1FBRUQsTUFBTSxXQUFXLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO1FBQ2pFLE1BQU0sSUFBSSxDQUFDLGFBQWEsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUN4QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsV0FBVyxDQUFDLElBQWtCLEVBQUUsT0FBZ0M7UUFDM0UsTUFBTSxJQUFJLEdBQUcsT0FBTyxFQUFFLFNBQVMsSUFBSSxHQUFHLENBQUM7UUFDdkMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsSUFBSSxDQUFDLElBQUksSUFBSSxHQUFHLENBQUM7WUFBRSxNQUFNLElBQUksVUFBVSxDQUFDLDZCQUE2QixDQUFDLENBQUM7UUFDakcsS0FBSyxJQUFJLE1BQU0sR0FBRyxDQUFDLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FBQyxNQUFNLEVBQUUsTUFBTSxJQUFJLElBQUksRUFBRSxDQUFDO1lBQzFELE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQztRQUMzRCxDQUFDO0lBQ0gsQ0FBQztJQUVELG1GQUFtRjtJQUM1RSxrQkFBa0IsQ0FBQyxVQUFnQyxFQUFFO1FBQzFELE9BQU8sSUFBSSxDQUFDLEVBQUUsQ0FBQyxTQUFTLENBQUMsSUFBSSxZQUFZLENBQWEsSUFBSSxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDakcsQ0FBQztJQUVELGtCQUFrQjtJQUVsQjs7T0FFRztJQUNJLEtBQUs7UUFDVixPQUFPLElBQUksc0JBQXNCLENBQy9CLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUN0QixJQUFJLENBQUMsT0FBTyxDQUFDLFFBQVEsRUFDckIsSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FDN0IsQ0FBQztJQUNKLENBQUM7SUFFRCxtQkFBbUI7SUFFbkI7O09BRUc7SUFDSSxLQUFLLENBQUMsTUFBTSxDQUNqQixHQUFlLEVBQ2YsT0FBb0U7UUFFcEUsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLElBQUksc0JBQXNCLENBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FBQyxDQUFDLENBQUM7UUFDL0gsTUFBTSxXQUFXLEdBQUcsRUFBRSxDQUFDLGdCQUFnQixFQUFFLENBQUM7UUFDMUMsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO1lBQ2pCLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0ZBQWdGLENBQUMsQ0FBQztRQUNwRyxDQUFDO1FBRUQsTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUM7YUFDbkMsR0FBRyxDQUFDLENBQUMsQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLEVBQUUsRUFBRSxDQUFDLEdBQUcsZUFBZSxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQzthQUNwRSxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFZCxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsYUFBYSxDQUM5QyxlQUFlLElBQUksQ0FBQyxhQUFhLFdBQVcsVUFBVSxVQUFVLFdBQVcsRUFBRSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQzdGLENBQUM7UUFDRixNQUFNLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO0lBQ2hDLENBQUM7SUFFRCxtQkFBbUI7SUFFbkI7O09BRUc7SUFDSSxLQUFLLENBQUMsV0FBVyxDQUN0QixPQUFvRTtRQUVwRSxNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsSUFBSSxzQkFBc0IsQ0FBSSxJQUFJLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsRUFBRSxDQUFDLG9CQUFvQixDQUFDLENBQUMsQ0FBQztRQUMvSCxNQUFNLFdBQVcsR0FBRyxFQUFFLENBQUMsZ0JBQWdCLEVBQUUsQ0FBQztRQUMxQyxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7WUFDakIsTUFBTSxJQUFJLEtBQUssQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFDO1FBQ3JELENBQUM7UUFFRCxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsYUFBYSxDQUM5QyxlQUFlLElBQUksQ0FBQyxhQUFhLGlCQUFpQixXQUFXLEVBQUUsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUMvRSxDQUFDO1FBQ0YsTUFBTSxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsQ0FBQztJQUNoQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsZUFBZSxDQUFDLE1BQXdCLEVBQUUsUUFBZ0I7UUFDckUsTUFBTSxJQUFJLENBQUMsRUFBRSxDQUFDLG9CQUFvQixDQUFDLGFBQWEsQ0FDOUMsZUFBZSxJQUFJLENBQUMsYUFBYSxpQkFBaUIsZUFBZSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyx1QkFBdUIsSUFBSSxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUNsSSxDQUFDO1FBQ0YsTUFBTSxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsQ0FBQztJQUNoQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsSUFBSTtRQUNmLE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FBQyxZQUFZLENBQzdDLHdCQUF3QixJQUFJLENBQUMsYUFBYSxFQUFFLENBQzdDLENBQUM7UUFDRixJQUFJLENBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQztJQUNwQixDQUFDO0lBRUQsc0JBQXNCO0lBRXRCOztPQUVHO0lBQ0ksS0FBSyxDQUFDLGdCQUFnQixDQUFDLFVBQTZCLEVBQUU7UUFDM0QsTUFBTSxTQUFTLEdBQUcsSUFBSSxTQUFTLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxFQUFFLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ3BFLElBQUksQ0FBQztZQUNILE9BQU8sSUFBSSxFQUFFLENBQUM7Z0JBQ1osU0FBUyxDQUFDLEtBQUssRUFBRSxDQUFDO2dCQUNsQixNQUFNLElBQUksR0FBRyxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsWUFBWSxDQUMxRCwySEFBMkgsRUFDM0gsRUFBRSxRQUFRLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsS0FBSyxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsU0FBUyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUM7Z0JBQ3BHLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDLEtBQUssRUFBRTtvQkFBRSxPQUFPO2dCQUM3QyxNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ3pDLENBQUM7UUFDSCxDQUFDO2dCQUFTLENBQUM7WUFBQyxTQUFTLENBQUMsT0FBTyxFQUFFLENBQUM7UUFBQyxDQUFDO0lBQ3BDLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxXQUFXO1FBQ3RCLE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FBQyxZQUFZLENBQUM7bUNBQ2hDLElBQUksQ0FBQyxhQUFhO0tBQ2hELENBQUMsQ0FBQztRQUNILE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQztZQUFFLE1BQU0sSUFBSSxVQUFVLENBQUMsMENBQTBDLENBQUMsQ0FBQztRQUNuRyxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxRQUFRLENBQUMsUUFBaUIsS0FBSztRQUMxQyxNQUFNLFdBQVcsR0FBRyxLQUFLLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQzFDLE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FBQyxZQUFZLENBQzdDLGtCQUFrQixJQUFJLENBQUMsYUFBYSxHQUFHLFdBQVcsRUFBRSxDQUNyRCxDQUFDO0lBQ0osQ0FBQztJQUVELHdCQUF3QjtJQUV4Qjs7T0FFRztJQUNJLEtBQUssQ0FBQyxRQUFvQztRQUMvQyxPQUFPLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFJLFFBQVEsQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FDdEUsSUFBSSxtQkFBbUIsQ0FBQyx3QkFBd0IsRUFDOUMsK0lBQStJLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDekosQ0FBQztJQUVELDRCQUE0QjtJQUNwQixLQUFLLENBQUMsWUFBWSxDQUFDLElBQVksRUFBRSxJQUEyQjtRQUNsRSxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUMsTUFBTSxDQUFDLElBQUksS0FBSyxJQUFJLENBQUM7WUFBRSxPQUFPO1FBQzlELE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxvQkFBb0IsQ0FBQyxZQUFZLENBQzdDLGVBQWUsSUFBSSxDQUFDLGFBQWEsNkJBQTZCLGVBQWUsQ0FBQyxJQUFJLENBQUMsSUFBSSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQ2pHLE1BQU0sSUFBSSxDQUFDLGFBQWEsRUFBRSxDQUFDO0lBQzdCLENBQUM7SUFFTyxlQUFlLENBQUMsSUFBZ0I7UUFDdEMsTUFBTSxJQUFJLEdBQUcsT0FBTyxDQUFDLFdBQVcsQ0FBQyxZQUFZLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDcEQsTUFBTSxVQUFVLEdBQXdCLEVBQUUsQ0FBQztRQUMzQyxLQUFLLE1BQU0sQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQ2hELE1BQU0sSUFBSSxHQUFHLG9CQUFvQixDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQ3pDLElBQUksSUFBSSxJQUFJLEdBQUcsS0FBSyxXQUFXLEVBQUUsQ0FBQztnQkFDaEMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQztZQUMxQixDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sVUFBVSxDQUFDO0lBQ3BCLENBQUM7SUFFTyxLQUFLLENBQUMsZUFBZSxDQUFDLElBQWdCO1FBQzVDLElBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1lBQ3JDLE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxJQUEyQixDQUFDLENBQUM7UUFDckQsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLGVBQWUsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNwQyxDQUFDO0lBRU8sS0FBSyxDQUFDLGFBQWEsQ0FBQyxJQUEyQjtRQUNyRCxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsYUFBYSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ3hHLENBQUM7Q0FDRiJ9

package/dist_ts/sqldb/clickhouse/smartclickhouse.classes.httpclient.d.ts

@@ -0,0 +1,28 @@
+import { ClickHouseConnection } from '../classes.clickhouseconnection.js';
+import type { IOperationOptions } from '../../core/interfaces.js';
+import type { IQueryOptions } from '../interfaces.js';
+export interface IClickhouseHttpClientOptions {
+    username?: string;
+    password?: string;
+    url: string;
+    timeoutMs?: number;
+}
+/** Migrated public transport API, using the official streaming ClickHouse connector. */
+export declare class ClickhouseHttpClient {
+    options: IClickhouseHttpClientOptions;
+    readonly connection: ClickHouseConnection;
+    private readonly ownsConnection;
+    constructor(options: IClickhouseHttpClientOptions, connection?: ClickHouseConnection);
+    static createAndStart(options: IClickhouseHttpClientOptions): Promise<ClickhouseHttpClient>;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    ping(options?: IOperationOptions): Promise<boolean>;
+    queryPromise(query: string, values?: Record<string, unknown>, options?: IQueryOptions): Promise<any[]>;
+    queryTyped<T>(query: string, values?: Record<string, unknown>, options?: IQueryOptions): Promise<T[]>;
+    insertPromise(database: string, table: string, documents: Record<string, unknown>[]): Promise<{
+        queryId: string;
+        completion: "acknowledged";
+    }>;
+    insertBatch(database: string, table: string, documents: Record<string, unknown>[], batchSize?: number): Promise<void>;
+    mutatePromise(query: string, values?: Record<string, unknown>, options?: IOperationOptions): Promise<void>;
+}

package/dist_ts/sqldb/clickhouse/smartclickhouse.classes.httpclient.js

@@ -0,0 +1,46 @@
+import { ClickHouseConnection } from '../classes.clickhouseconnection.js';
+/** Migrated public transport API, using the official streaming ClickHouse connector. */
+export class ClickhouseHttpClient {
+    options;
+    connection;
+    ownsConnection;
+    constructor(options, connection) {
+        this.options = options;
+        this.ownsConnection = !connection;
+        this.connection = connection ?? new ClickHouseConnection({ ...options, backend: 'clickhouse', database: 'default' });
+    }
+    static async createAndStart(options) {
+        const instance = new ClickhouseHttpClient(options);
+        await instance.start();
+        return instance;
+    }
+    async start() { await this.connection.connect(); }
+    async close() { if (this.ownsConnection)
+        await this.connection.close(); }
+    async ping(options = {}) { return (await this.connection.ready(options)).ready; }
+    async queryPromise(query, values, options = {}) {
+        const sql = query.trim().replace(/\s+FORMAT\s+JSONEachRow\s*;?$/i, '');
+        if (/^(SELECT|WITH|SHOW|DESCRIBE|DESC|EXISTS|EXPLAIN)\b/i.test(sql)) {
+            return this.connection.query({ sql, values }, options);
+        }
+        await this.connection.execute({ sql, values }, options);
+        return [];
+    }
+    async queryTyped(query, values, options = {}) {
+        return this.queryPromise(query, values, options);
+    }
+    async insertPromise(database, table, documents) {
+        return this.connection.insertQualified(database, table, documents);
+    }
+    async insertBatch(database, table, documents, batchSize = 10_000) {
+        if (!Number.isSafeInteger(batchSize) || batchSize < 1)
+            throw new RangeError('batchSize must be positive.');
+        for (let i = 0; i < documents.length; i += batchSize) {
+            await this.insertPromise(database, table, documents.slice(i, i + batchSize));
+        }
+    }
+    async mutatePromise(query, values, options = {}) {
+        await this.connection.execute({ sql: query, values }, options);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRjbGlja2hvdXNlLmNsYXNzZXMuaHR0cGNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL3NxbGRiL2NsaWNraG91c2Uvc21hcnRjbGlja2hvdXNlLmNsYXNzZXMuaHR0cGNsaWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQVcxRSx3RkFBd0Y7QUFDeEYsTUFBTSxPQUFPLG9CQUFvQjtJQUdaO0lBRkgsVUFBVSxDQUF1QjtJQUNoQyxjQUFjLENBQVU7SUFDekMsWUFBbUIsT0FBcUMsRUFBRSxVQUFpQztRQUF4RSxZQUFPLEdBQVAsT0FBTyxDQUE4QjtRQUN0RCxJQUFJLENBQUMsY0FBYyxHQUFHLENBQUMsVUFBVSxDQUFDO1FBQ2xDLElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxJQUFJLElBQUksb0JBQW9CLENBQUMsRUFBRSxHQUFHLE9BQU8sRUFBRSxPQUFPLEVBQUUsWUFBWSxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDO0lBQ3ZILENBQUM7SUFDTSxNQUFNLENBQUMsS0FBSyxDQUFDLGNBQWMsQ0FBQyxPQUFxQztRQUN0RSxNQUFNLFFBQVEsR0FBRyxJQUFJLG9CQUFvQixDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ25ELE1BQU0sUUFBUSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3ZCLE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7SUFDTSxLQUFLLENBQUMsS0FBSyxLQUFvQixNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ2pFLEtBQUssQ0FBQyxLQUFLLEtBQW9CLElBQUksSUFBSSxDQUFDLGNBQWM7UUFBRSxNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ3hGLEtBQUssQ0FBQyxJQUFJLENBQUMsVUFBNkIsRUFBRSxJQUFzQixPQUFPLENBQUMsTUFBTSxJQUFJLENBQUMsVUFBVSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUM7SUFFdEgsS0FBSyxDQUFDLFlBQVksQ0FBQyxLQUFhLEVBQUUsTUFBZ0MsRUFBRSxVQUF5QixFQUFFO1FBQ3BHLE1BQU0sR0FBRyxHQUFHLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxPQUFPLENBQUMsZ0NBQWdDLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDdkUsSUFBSSxxREFBcUQsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUNwRSxPQUFPLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxDQUFDLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3pELENBQUM7UUFDRCxNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3hELE9BQU8sRUFBRSxDQUFDO0lBQ1osQ0FBQztJQUNNLEtBQUssQ0FBQyxVQUFVLENBQUksS0FBYSxFQUFFLE1BQWdDLEVBQUUsVUFBeUIsRUFBRTtRQUNyRyxPQUFPLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxPQUFPLENBQWlCLENBQUM7SUFDbkUsQ0FBQztJQUNNLEtBQUssQ0FBQyxhQUFhLENBQUMsUUFBZ0IsRUFBRSxLQUFhLEVBQUUsU0FBb0M7UUFDOUYsT0FBTyxJQUFJLENBQUMsVUFBVSxDQUFDLGVBQWUsQ0FBQyxRQUFRLEVBQUUsS0FBSyxFQUFFLFNBQVMsQ0FBQyxDQUFDO0lBQ3JFLENBQUM7SUFDTSxLQUFLLENBQUMsV0FBVyxDQUFDLFFBQWdCLEVBQUUsS0FBYSxFQUFFLFNBQW9DLEVBQUUsU0FBUyxHQUFHLE1BQU07UUFDaEgsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsU0FBUyxDQUFDLElBQUksU0FBUyxHQUFHLENBQUM7WUFBRSxNQUFNLElBQUksVUFBVSxDQUFDLDZCQUE2QixDQUFDLENBQUM7UUFDM0csS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLFNBQVMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxJQUFJLFNBQVMsRUFBRSxDQUFDO1lBQ3JELE1BQU0sSUFBSSxDQUFDLGFBQWEsQ0FBQyxRQUFRLEVBQUUsS0FBSyxFQUFFLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsR0FBRyxTQUFTLENBQUMsQ0FBQyxDQUFDO1FBQy9FLENBQUM7SUFDSCxDQUFDO0lBQ00sS0FBSyxDQUFDLGFBQWEsQ0FBQyxLQUFhLEVBQUUsTUFBZ0MsRUFBRSxVQUE2QixFQUFFO1FBQ3pHLE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxPQUFPLENBQUMsRUFBRSxHQUFHLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ2pFLENBQUM7Q0FDRiJ9

package/dist_ts/sqldb/clickhouse/smartclickhouse.classes.querybuilder.d.ts

@@ -0,0 +1,43 @@
+import type { ClickhouseHttpClient } from './smartclickhouse.classes.httpclient.js';
+import { ClickhouseResultSet } from './smartclickhouse.classes.resultset.js';
+import type { TComparisonOperator } from './smartclickhouse.types.js';
+import type { IClickHouseStatement, IQueryOptions } from '../interfaces.js';
+/** Identifier methods quote names. Methods ending in Raw and having() accept trusted SQL expressions. */
+export declare class ClickhouseQueryBuilder<T extends Record<string, any>> {
+    private tableName;
+    private database;
+    private httpClient;
+    private selectColumns;
+    private whereClauses;
+    private orderByClauses;
+    private groupByClauses;
+    private havingClauses;
+    private limitValue;
+    private offsetValue;
+    private readonly values;
+    constructor(tableName: string, database: string, httpClient: ClickhouseHttpClient);
+    select<K extends keyof T & string>(...columns: K[]): this;
+    selectRaw(...expressions: string[]): this;
+    where<K extends keyof T & string>(column: K, operator: TComparisonOperator, value: unknown): this;
+    and<K extends keyof T & string>(column: K, operator: TComparisonOperator, value: unknown): this;
+    or<K extends keyof T & string>(column: K, operator: TComparisonOperator, value: unknown): this;
+    whereRaw(expression: string): this;
+    orderBy(column: (keyof T & string) | string, direction?: 'ASC' | 'DESC'): this;
+    groupBy<K extends keyof T & string>(...columns: K[]): this;
+    having(expression: string): this;
+    limit(count: number): this;
+    offset(count: number): this;
+    private validateCount;
+    execute(options?: IQueryOptions): Promise<ClickhouseResultSet<T>>;
+    first(): Promise<T | null>;
+    count(): Promise<number>;
+    toArray(options?: IQueryOptions): Promise<T[]>;
+    /** SQL contains typed placeholders. Pass parameters alongside it, or use toStatement(). */
+    toSQL(): string;
+    get parameters(): Record<string, unknown>;
+    toStatement(): IClickHouseStatement;
+    buildWhereClause(): string;
+    /** Bind a scalar for table mutations as well as predicates. */
+    bind(value: unknown): string;
+    private buildCondition;
+}