@lossless.org/client 0.1.0

package/dist_ts/sqldb/classes.sqlconnection.js

@@ -0,0 +1,376 @@
+import * as plugins from './plugins.mariadb.js';
+import { SqlTable } from './classes.sqltable.js';
+import { SqlPool } from './internal.sqlpool.js';
+import { Operation } from '../core/classes.operation.js';
+import { LosslessClientError, backendError } from '../core/classes.error.js';
+import { quoteIdentifier, resultLimits, valueBytes } from './interfaces.js';
+const validateStatement = (statement) => {
+    if (!statement || typeof statement.sql !== 'string' || !statement.sql.trim()) {
+        throw new LosslessClientError('invalid_argument', 'A SQL statement is required.');
+    }
+    if (statement.values !== undefined && !Array.isArray(statement.values)) {
+        throw new LosslessClientError('invalid_argument', 'SQL values must be an array.');
+    }
+    for (const value of statement.values ?? []) {
+        if (value !== null && !['string', 'number', 'bigint', 'boolean'].includes(typeof value) &&
+            !(value instanceof Date) && !(value instanceof Uint8Array)) {
+            throw new LosslessClientError('invalid_argument', 'SQL parameters must be supported scalar, date or binary values.');
+        }
+        if (value instanceof Date && !Number.isFinite(value.getTime())) {
+            throw new LosslessClientError('invalid_argument', 'Invalid date parameter.');
+        }
+        if (typeof value === 'number' && (!Number.isFinite(value) ||
+            (Number.isInteger(value) && !Number.isSafeInteger(value)))) {
+            throw new LosslessClientError('invalid_argument', 'Use bigint or a decimal string for exact large numbers.');
+        }
+    }
+};
+const boundValues = (statement) => (statement.values ?? []).map(value => value instanceof Date
+    ? value.toISOString().replace('T', ' ').replace('Z', '')
+    : value instanceof Uint8Array ? Buffer.from(value) : value);
+const mutationResult = (result) => ({
+    affectedRows: result.affectedRows,
+    ...(result.insertId === undefined ? {} : { insertId: BigInt(result.insertId) }),
+    completion: 'acknowledged',
+});
+/** One MariaDB-protocol pool. SQLDB uses the same wire adapter with its own capabilities. */
+export class SqlConnection {
+    options;
+    backend;
+    capabilities;
+    pool;
+    closing;
+    connecting;
+    closed = false;
+    acquisitions = new Set();
+    leases = new Set();
+    pendingOperations = new Set();
+    constructor(options) {
+        this.options = options;
+        if (!['sqldb', 'mariadb'].includes(options.backend) || !options.host || !options.database || !options.user) {
+            throw new LosslessClientError('invalid_argument', 'SQL backend, host, user and database are required.');
+        }
+        if (options.backend === 'sqldb' && options.tls) {
+            throw new LosslessClientError('unsupported_capability', 'SQLDB does not yet support TLS.');
+        }
+        this.backend = options.backend;
+        this.capabilities = Object.freeze({ backend: this.backend, transactions: 'available',
+            changeStreams: 'unsupported', objectMetrics: 'unsupported',
+            diskResidentScans: this.backend === 'sqldb' ? 'unsupported' : 'available' });
+    }
+    connect(options = {}) {
+        if (this.closed || this.closing)
+            return Promise.reject(new LosslessClientError('closed', 'SQL connection is closed.'));
+        if (this.connecting)
+            return this.connecting;
+        if (this.pool)
+            return Promise.resolve();
+        const limit = this.options.connectionLimit ?? 10;
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1024) {
+            return Promise.reject(new LosslessClientError('invalid_argument', 'connectionLimit must be between 1 and 1024.'));
+        }
+        this.pool = new SqlPool({
+            host: this.options.host, port: this.options.port ?? 3306, user: this.options.user,
+            password: this.options.password, database: this.options.database,
+            connectTimeout: this.options.timeoutMs ?? 30_000,
+            ssl: this.options.tls, bigIntAsNumber: false, decimalAsNumber: false,
+            dateStrings: true, timezone: this.backend === 'mariadb' ? '+00:00' : undefined,
+            multipleStatements: false,
+        }, limit);
+        this.connecting = (async () => {
+            try {
+                await this.query({ sql: 'SELECT 1 AS ready' }, { ...options, maxRows: 1 });
+            }
+            catch (error) {
+                const pool = this.pool;
+                this.pool = undefined;
+                await pool?.end();
+                throw error;
+            }
+            finally {
+                this.connecting = undefined;
+            }
+        })();
+        return this.connecting;
+    }
+    async ready(options = {}) {
+        try {
+            await this.query({ sql: 'SELECT 1 AS ready' }, { ...options, maxRows: 1 });
+            return { ready: true };
+        }
+        catch (error) {
+            return { ready: false, reason: error instanceof LosslessClientError ? error.code : 'unavailable' };
+        }
+    }
+    table(name) {
+        return new SqlTable(this, name);
+    }
+    acquire(options) {
+        if (!this.pool || this.closed || this.closing) {
+            return Promise.reject(new LosslessClientError(this.closed ? 'closed' : 'not_connected', 'SQL connection is not open.'));
+        }
+        const pool = this.pool;
+        const operation = new Operation(options, this.options.timeoutMs);
+        this.pendingOperations.add(operation);
+        const acquisition = (async () => {
+            let connection;
+            try {
+                operation.check();
+                connection = await pool.getConnection(operation);
+                operation.check();
+                const acquired = connection;
+                const settled = Promise.withResolvers();
+                let disposal;
+                const abort = () => acquired.destroy();
+                const lease = { connection: acquired, operation, done: settled.promise,
+                    close: () => disposal ??= (async () => {
+                        try {
+                            await acquired.release();
+                        }
+                        finally {
+                            operation.signal.removeEventListener('abort', abort);
+                            operation.dispose();
+                            this.pendingOperations.delete(operation);
+                            this.leases.delete(lease);
+                            settled.resolve();
+                        }
+                    })(),
+                };
+                operation.signal.addEventListener('abort', abort, { once: true });
+                this.leases.add(lease);
+                return lease;
+            }
+            catch (error) {
+                connection?.destroy();
+                await connection?.release();
+                operation.dispose();
+                this.pendingOperations.delete(operation);
+                throw operation.signal.aborted ? operation.signal.reason : backendError(error);
+            }
+        })();
+        this.acquisitions.add(acquisition);
+        void acquisition.finally(() => this.acquisitions.delete(acquisition)).catch(() => { });
+        return acquisition;
+    }
+    async execute(statement, options = {}) {
+        validateStatement(statement);
+        const lease = await this.acquire(options);
+        let dispatched = false;
+        try {
+            lease.operation.check();
+            dispatched = true;
+            const result = await lease.connection.execute(statement.sql, boundValues(statement));
+            return mutationResult(result);
+        }
+        catch (error) {
+            if (dispatched && (lease.operation.signal.aborted || !lease.connection.isValid())) {
+                throw new LosslessClientError('ambiguous_write', 'SQL write outcome is unknown after connection loss.', { cause: error });
+            }
+            throw backendError(error);
+        }
+        finally {
+            await lease.close();
+        }
+    }
+    async query(statement, options = {}) {
+        const limits = resultLimits(options);
+        const rows = [];
+        let bytes = 0;
+        for await (const row of this.stream(statement, options)) {
+            bytes += valueBytes(row);
+            if (rows.length >= limits.rows || bytes > limits.bytes) {
+                throw new LosslessClientError('result_limit', 'SQL result exceeded its materialization limit. Use stream().');
+            }
+            rows.push(row);
+        }
+        return rows;
+    }
+    async *stream(statement, options = {}) {
+        validateStatement(statement);
+        const lease = await this.acquire(options);
+        let readable;
+        let completed = false;
+        try {
+            lease.operation.check();
+            readable = lease.connection.queryStream(statement.sql, boundValues(statement));
+            // A paused consumer still owns a socket. Stream close independently returns its lease.
+            readable.on('error', () => { });
+            readable.once('close', () => { void lease.close().catch(() => { }); });
+            for await (const row of readable) {
+                lease.operation.check();
+                yield row;
+            }
+            lease.operation.check();
+            completed = true;
+        }
+        catch (error) {
+            throw lease.operation.signal.aborted ? lease.operation.signal.reason : backendError(error);
+        }
+        finally {
+            if (!completed)
+                lease.connection.destroy();
+            readable?.destroy();
+            await lease.close();
+        }
+    }
+    async insert(table, rows, options = {}) {
+        const tableName = quoteIdentifier(table);
+        const batchSize = options.batchSize ?? 500;
+        const maxBytes = options.maxBatchBytes ?? 4 * 1024 * 1024;
+        if (!Number.isSafeInteger(batchSize) || batchSize < 1 || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+            throw new LosslessClientError('invalid_argument', 'Insert batch limits must be positive integers.');
+        }
+        const operation = new Operation(options, this.options.timeoutMs);
+        if (!this.pool || this.closed || this.closing) {
+            operation.dispose();
+            throw new LosslessClientError(this.closed ? 'closed' : 'not_connected', 'SQL connection is not open.');
+        }
+        this.pendingOperations.add(operation);
+        let columns;
+        let batch = [], bytes = 0, affectedRows = 0;
+        const flush = async () => {
+            if (!batch.length)
+                return;
+            const result = await this.execute({ sql: `INSERT INTO ${tableName} (${columns.map(quoteIdentifier).join(',')}) VALUES ${batch.map(() => '(' + columns.map(() => '?').join(',') + ')').join(',')}`,
+                values: batch.flat() }, { signal: operation.signal, timeoutMs: options.timeoutMs });
+            affectedRows += result.affectedRows;
+            batch = [];
+            bytes = 0;
+        };
+        try {
+            for await (const row of operation.iterate(rows)) {
+                operation.check();
+                columns ??= Object.keys(row);
+                if (!columns.length || Object.keys(row).length !== columns.length || columns.some(key => !Object.hasOwn(row, key))) {
+                    throw new LosslessClientError('invalid_argument', 'Every inserted row must have the same columns.');
+                }
+                const size = valueBytes(row);
+                if (size > maxBytes)
+                    throw new LosslessClientError('invalid_argument', 'Insert row exceeds maxBatchBytes.');
+                if (batch.length && (batch.length >= batchSize || bytes + size > maxBytes))
+                    await flush();
+                batch.push(columns.map(key => row[key]));
+                bytes += size;
+            }
+            await flush();
+            return { affectedRows, completion: 'acknowledged' };
+        }
+        catch (error) {
+            if (affectedRows)
+                throw new LosslessClientError(error instanceof LosslessClientError && error.code === 'ambiguous_write'
+                    ? 'ambiguous_write' : 'partial_write', 'Bulk insert stopped after acknowledged batches.', { cause: error, acknowledgedRows: affectedRows });
+            throw error;
+        }
+        finally {
+            operation.dispose();
+            this.pendingOperations.delete(operation);
+        }
+    }
+    async transaction(callback, options = {}) {
+        const lease = await this.acquire(options);
+        const transaction = new SqlTransaction(lease);
+        let committing = false;
+        try {
+            await lease.connection.beginTransaction();
+            const value = await lease.operation.wait(callback(transaction));
+            await transaction.finish();
+            lease.operation.check();
+            committing = true;
+            await lease.connection.commit();
+            return value;
+        }
+        catch (error) {
+            await transaction.finish().catch(() => { });
+            if (committing && !lease.connection.isValid()) {
+                throw new LosslessClientError('ambiguous_write', 'Transaction commit outcome is unknown.', { cause: error });
+            }
+            if (lease.operation.signal.aborted)
+                throw lease.operation.signal.reason;
+            try {
+                await lease.connection.rollback();
+            }
+            catch (rollbackError) {
+                throw new AggregateError([error, rollbackError], 'Transaction and rollback failed.');
+            }
+            throw error;
+        }
+        finally {
+            await lease.close();
+        }
+    }
+    close() {
+        return this.closing ??= (async () => {
+            this.closed = true;
+            for (const operation of this.pendingOperations)
+                operation.cancel();
+            await Promise.allSettled([...this.acquisitions]);
+            for (const lease of this.leases)
+                lease.operation.cancel();
+            await Promise.all([...this.leases].map(lease => lease.close()));
+            await this.connecting?.catch(() => { });
+            const pool = this.pool;
+            this.pool = undefined;
+            await pool?.end();
+        })();
+    }
+}
+/** Bound to a single transaction callback and physical connection. */
+export class SqlTransaction {
+    lease;
+    active;
+    failure;
+    finished = false;
+    constructor(lease) {
+        this.lease = lease;
+    }
+    run(action) {
+        if (this.finished || this.active)
+            return Promise.reject(new LosslessClientError('invalid_argument', 'Transaction is closed or already has an active operation.'));
+        if (this.failure)
+            return Promise.reject(this.failure);
+        this.lease.operation.check();
+        const result = action().catch(error => { this.failure = error; throw error; });
+        this.active = result;
+        void result.finally(() => { if (this.active === result)
+            this.active = undefined; }).catch(() => { });
+        return result;
+    }
+    execute(statement) {
+        validateStatement(statement);
+        return this.run(async () => mutationResult(await this.lease.connection.execute(statement.sql, boundValues(statement))));
+    }
+    query(statement, options = {}) {
+        validateStatement(statement);
+        const limits = resultLimits(options);
+        return this.run(async () => {
+            const rows = [];
+            let bytes = 0;
+            const source = this.lease.connection.queryStream(statement.sql, boundValues(statement));
+            try {
+                for await (const row of source) {
+                    this.lease.operation.check();
+                    bytes += valueBytes(row);
+                    if (rows.length >= limits.rows || bytes > limits.bytes) {
+                        throw new LosslessClientError('result_limit', 'Transaction result exceeded its materialization limit.');
+                    }
+                    rows.push(row);
+                }
+                return rows;
+            }
+            catch (error) {
+                this.lease.connection.destroy();
+                throw error;
+            }
+            finally {
+                source.destroy();
+            }
+        });
+    }
+    async finish() {
+        this.finished = true;
+        await this.active;
+        if (this.failure)
+            throw this.failure;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zcWxjb25uZWN0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvc3FsZGIvY2xhc3Nlcy5zcWxjb25uZWN0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sc0JBQXNCLENBQUM7QUFDaEQsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ2pELE9BQU8sRUFBRSxPQUFPLEVBQTRCLE1BQU0sdUJBQXVCLENBQUM7QUFDMUUsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ3pELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxZQUFZLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUU3RSxPQUFPLEVBQUUsZUFBZSxFQUFFLFlBQVksRUFBRSxVQUFVLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQVU1RSxNQUFNLGlCQUFpQixHQUFHLENBQUMsU0FBd0IsRUFBUSxFQUFFO0lBQzNELElBQUksQ0FBQyxTQUFTLElBQUksT0FBTyxTQUFTLENBQUMsR0FBRyxLQUFLLFFBQVEsSUFBSSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFFLEVBQUUsQ0FBQztRQUM3RSxNQUFNLElBQUksbUJBQW1CLENBQUMsa0JBQWtCLEVBQUUsOEJBQThCLENBQUMsQ0FBQztJQUNwRixDQUFDO0lBQ0QsSUFBSSxTQUFTLENBQUMsTUFBTSxLQUFLLFNBQVMsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDdkUsTUFBTSxJQUFJLG1CQUFtQixDQUFDLGtCQUFrQixFQUFFLDhCQUE4QixDQUFDLENBQUM7SUFDcEYsQ0FBQztJQUNELEtBQUssTUFBTSxLQUFLLElBQUksU0FBUyxDQUFDLE1BQU0sSUFBSSxFQUFFLEVBQUUsQ0FBQztRQUMzQyxJQUFJLEtBQUssS0FBSyxJQUFJLElBQUksQ0FB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

package/dist_ts/sqldb/classes.sqltable.d.ts

@@ -0,0 +1,29 @@
+import type { SqlConnection } from './classes.sqlconnection.js';
+import type { IInsertOptions, IQueryOptions, ISqlStatement, TSqlValue } from './interfaces.js';
+import type { IOperationOptions } from '../core/interfaces.js';
+export type TSqlSelector<Row> = Partial<{
+    [Key in keyof Row]: TSqlValue;
+}>;
+export interface ISqlSelectOptions<Row> extends IQueryOptions {
+    columns?: (keyof Row & string)[];
+    orderBy?: {
+        column: keyof Row & string;
+        direction?: 'ASC' | 'DESC';
+    }[];
+    limit?: number;
+}
+/** A typed handle to an existing relational table. Schema creation is explicit SQL or a migration. */
+export declare class SqlTable<Row extends {
+    [Key in keyof Row]: TSqlValue;
+}> {
+    private readonly connection;
+    readonly name: string;
+    constructor(connection: SqlConnection, name: string);
+    private where;
+    selectStatement(selector?: TSqlSelector<Row>, options?: ISqlSelectOptions<Row>): ISqlStatement;
+    query(selector?: TSqlSelector<Row>, options?: ISqlSelectOptions<Row>): Promise<Row[]>;
+    stream(selector?: TSqlSelector<Row>, options?: ISqlSelectOptions<Row>): AsyncGenerator<Row>;
+    insert(rows: Iterable<Row> | AsyncIterable<Row>, options?: IInsertOptions): Promise<import("./interfaces.js").ISqlMutationResult>;
+    update(selector: TSqlSelector<Row>, changes: Partial<Row>, options?: IOperationOptions): Promise<import("./interfaces.js").ISqlMutationResult>;
+    delete(selector: TSqlSelector<Row>, options?: IOperationOptions): Promise<import("./interfaces.js").ISqlMutationResult>;
+}

package/dist_ts/sqldb/classes.sqltable.js

@@ -0,0 +1,70 @@
+import { quoteIdentifier } from './interfaces.js';
+import { LosslessClientError } from '../core/classes.error.js';
+/** A typed handle to an existing relational table. Schema creation is explicit SQL or a migration. */
+export class SqlTable {
+    connection;
+    name;
+    constructor(connection, name) {
+        this.connection = connection;
+        this.name = name;
+        quoteIdentifier(name);
+    }
+    where(selector, required = false) {
+        const entries = Object.entries(selector);
+        if (required && !entries.length)
+            throw new LosslessClientError('invalid_argument', 'A nonempty selector is required for table mutations.');
+        const values = [];
+        const sql = entries.map(([key, value]) => {
+            if (value === undefined)
+                throw new LosslessClientError('invalid_argument', 'Undefined selector values are not allowed.');
+            if (value === null)
+                return quoteIdentifier(key) + ' IS NULL';
+            values.push(value);
+            return quoteIdentifier(key) + ' = ?';
+        }).join(' AND ');
+        return { sql: sql ? ' WHERE ' + sql : '', values };
+    }
+    selectStatement(selector = {}, options = {}) {
+        const where = this.where(selector);
+        if (options.columns?.length === 0)
+            throw new LosslessClientError('invalid_argument', 'Select at least one column.');
+        let sql = 'SELECT ' + (options.columns?.map(quoteIdentifier).join(', ') ?? '*') + ' FROM ' + quoteIdentifier(this.name) + where.sql;
+        if (options.orderBy?.length)
+            sql += ' ORDER BY ' + options.orderBy.map(order => {
+                const direction = order.direction ?? 'ASC';
+                if (!['ASC', 'DESC'].includes(direction))
+                    throw new LosslessClientError('invalid_argument', 'Invalid sort direction.');
+                return quoteIdentifier(order.column) + ' ' + direction;
+            }).join(', ');
+        if (options.limit !== undefined) {
+            if (!Number.isSafeInteger(options.limit) || options.limit < 0)
+                throw new LosslessClientError('invalid_argument', 'Limit must be a nonnegative safe integer.');
+            sql += ' LIMIT ' + options.limit;
+        }
+        return { sql, values: where.values };
+    }
+    query(selector = {}, options = {}) {
+        return this.connection.query(this.selectStatement(selector, options), options);
+    }
+    stream(selector = {}, options = {}) {
+        return this.connection.stream(this.selectStatement(selector, options), options);
+    }
+    insert(rows, options = {}) {
+        return this.connection.insert(this.name, rows, options);
+    }
+    update(selector, changes, options = {}) {
+        const where = this.where(selector, true);
+        const entries = Object.entries(changes);
+        if (!entries.length || entries.some(([, value]) => value === undefined)) {
+            throw new LosslessClientError('invalid_argument', 'Supply at least one defined changed value.');
+        }
+        return this.connection.execute({ sql: 'UPDATE ' + quoteIdentifier(this.name) + ' SET ' +
+                entries.map(([key]) => quoteIdentifier(key) + ' = ?').join(', ') + where.sql,
+            values: [...entries.map(([, value]) => value), ...where.values] }, options);
+    }
+    delete(selector, options = {}) {
+        const where = this.where(selector, true);
+        return this.connection.execute({ sql: 'DELETE FROM ' + quoteIdentifier(this.name) + where.sql, values: where.values }, options);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zcWx0YWJsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3NxbGRiL2NsYXNzZXMuc3FsdGFibGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ2xELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBUy9ELHNHQUFzRztBQUN0RyxNQUFNLE9BQU8sUUFBUTtJQUNVO0lBQTJDO0lBQXhFLFlBQTZCLFVBQXlCLEVBQWtCLElBQVk7UUFBdkQsZUFBVSxHQUFWLFVBQVUsQ0FBZTtRQUFrQixTQUFJLEdBQUosSUFBSSxDQUFRO1FBQUksZUFBZSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQUMsQ0FBQztJQUV4RyxLQUFLLENBQUMsUUFBMkIsRUFBRSxRQUFRLEdBQUcsS0FBSztRQUN6RCxNQUFNLE9BQU8sR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQ3pDLElBQUksUUFBUSxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU07WUFBRSxNQUFNLElBQUksbUJBQW1CLENBQUMsa0JBQWtCLEVBQUUsc0RBQXNELENBQUMsQ0FBQztRQUMzSSxNQUFNLE1BQU0sR0FBZ0IsRUFBRSxDQUFDO1FBQy9CLE1BQU0sR0FBRyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEdBQUcsRUFBRSxLQUFLLENBQUMsRUFBRSxFQUFFO1lBQ3ZDLElBQUksS0FBSyxLQUFLLFNBQVM7Z0JBQUUsTUFBTSxJQUFJLG1CQUFtQixDQUFDLGtCQUFrQixFQUFFLDRDQUE0QyxDQUFDLENBQUM7WUFDekgsSUFBSSxLQUFLLEtBQUssSUFBSTtnQkFBRSxPQUFPLGVBQWUsQ0FBQyxHQUFHLENBQUMsR0FBRyxVQUFVLENBQUM7WUFDN0QsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFrQixDQUFDLENBQUM7WUFDaEMsT0FBTyxl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

package/dist_ts/sqldb/clickhouse/classes.metricwriter.d.ts

@@ -0,0 +1,27 @@
+export interface IMetricWriterOptions {
+    batchSize?: number;
+    maxBatchBytes?: number;
+    flushIntervalMs?: number;
+}
+/** Await write() for backpressure. flush()/close() settle only after server acknowledgement. */
+export declare class MetricWriter<Row> {
+    private readonly send;
+    private readonly options;
+    private batch;
+    private bytes;
+    private active?;
+    private failure?;
+    private closed;
+    private closing?;
+    private timer?;
+    private readonly batchSize;
+    private readonly maxBytes;
+    constructor(send: (rows: Row[]) => Promise<void>, options?: IMetricWriterOptions);
+    private check;
+    private perform;
+    private sendBatch;
+    write(row: Row): Promise<void>;
+    private schedule;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist_ts/sqldb/clickhouse/classes.metricwriter.js

@@ -0,0 +1,89 @@
+import { valueBytes } from '../interfaces.js';
+import { LosslessClientError } from '../../core/classes.error.js';
+/** Await write() for backpressure. flush()/close() settle only after server acknowledgement. */
+export class MetricWriter {
+    send;
+    options;
+    batch = [];
+    bytes = 0;
+    active;
+    failure;
+    closed = false;
+    closing;
+    timer;
+    batchSize;
+    maxBytes;
+    constructor(send, options = {}) {
+        this.send = send;
+        this.options = options;
+        this.batchSize = options.batchSize ?? 500;
+        this.maxBytes = options.maxBatchBytes ?? 4 * 1024 * 1024;
+        for (const limit of [this.batchSize, this.maxBytes, options.flushIntervalMs ?? 1000]) {
+            if (!Number.isSafeInteger(limit) || limit < 1)
+                throw new RangeError('Writer limits must be positive integers.');
+        }
+    }
+    check() {
+        if (this.failure)
+            throw this.failure;
+        if (this.closed)
+            throw new LosslessClientError('closed', 'Metric writer is closed.');
+        if (this.active)
+            throw new LosslessClientError('invalid_argument', 'Await the preceding writer operation before writing again.');
+    }
+    perform(action) {
+        const task = action().catch(error => { this.failure = error; throw error; });
+        this.active = task;
+        void task.finally(() => {
+            if (this.active === task)
+                this.active = undefined;
+            this.schedule();
+        }).catch(() => { });
+        return task;
+    }
+    async sendBatch() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        if (!this.batch.length)
+            return;
+        await this.send(this.batch);
+        this.batch = [];
+        this.bytes = 0;
+    }
+    write(row) {
+        this.check();
+        const size = valueBytes(row);
+        if (size > this.maxBytes)
+            throw new LosslessClientError('invalid_argument', 'Metric row exceeds maxBatchBytes.');
+        return this.perform(async () => {
+            if (this.batch.length && this.bytes + size > this.maxBytes)
+                await this.sendBatch();
+            this.batch.push(structuredClone(row));
+            this.bytes += size;
+            if (this.batch.length >= this.batchSize)
+                await this.sendBatch();
+        });
+    }
+    schedule() {
+        if (this.timer || this.closed || this.failure || !this.batch.length)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            if (!this.closed && !this.failure && !this.active)
+                void this.flush().catch(() => { });
+        }, this.options.flushIntervalMs ?? 1000);
+        this.timer.unref();
+    }
+    flush() { this.check(); return this.perform(() => this.sendBatch()); }
+    close() {
+        return this.closing ??= (async () => {
+            this.closed = true;
+            clearTimeout(this.timer);
+            await this.active;
+            if (this.failure)
+                throw this.failure;
+            await this.sendBatch();
+        })();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tZXRyaWN3cml0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9zcWxkYi9jbGlja2hvdXNlL2NsYXNzZXMubWV0cmljd3JpdGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUlsRSxnR0FBZ0c7QUFDaEcsTUFBTSxPQUFPLFlBQVk7SUFXTTtJQUF1RDtJQVY1RSxLQUFLLEdBQVUsRUFBRSxDQUFDO0lBQ2xCLEtBQUssR0FBRyxDQUFDLENBQUM7SUFDVixNQUFNLENBQWlCO0lBQ3ZCLE9BQU8sQ0FBVztJQUNsQixNQUFNLEdBQUcsS0FBSyxDQUFDO0lBQ2YsT0FBTyxDQUFpQjtJQUN4QixLQUFLLENBQWlDO0lBQzdCLFNBQVMsQ0FBUztJQUNsQixRQUFRLENBQVM7SUFFbEMsWUFBNkIsSUFBb0MsRUFBbUIsVUFBZ0MsRUFBRTtRQUF6RixTQUFJLEdBQUosSUFBSSxDQUFnQztRQUFtQixZQUFPLEdBQVAsT0FBTyxDQUEyQjtRQUNwSCxJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sQ0FBQyxTQUFTLElBQUksR0FBRyxDQUFDO1FBQzFDLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLGFBQWEsSUFBSSxDQUFDLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztRQUN6RCxLQUFLLE1BQU0sS0FBSyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxlQUFlLElBQUksSUFBSSxDQUFDLEVBQUUsQ0FBQztZQUNyRixJQUFJLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsSUFBSSxLQUFLLEdBQUcsQ0FBQztnQkFBRSxNQUFNLElBQUksVUFBVSxDQUFDLDBDQUEwQyxDQUFDLENBQUM7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

package/dist_ts/sqldb/clickhouse/index.d.ts

@@ -0,0 +1,9 @@
+export * from './smartclickhouse.classes.smartclickhouse.js';
+export * from './smartclickhouse.classes.clickhousetable.js';
+export * from './smartclickhouse.classes.httpclient.js';
+export * from './smartclickhouse.classes.querybuilder.js';
+export * from './smartclickhouse.classes.resultset.js';
+export * from './smartclickhouse.classes.timedatatable.js';
+export * from './smartclickhouse.types.js';
+export { MetricWriter } from './classes.metricwriter.js';
+export type { IMetricWriterOptions } from './classes.metricwriter.js';