@naturalcycles/mysql-lib 3.8.1 → 3.10.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { getDBAdapter } from './dbAdapter';
 import { MysqlDB, MysqlDBCfg, MysqlDBOptions, MysqlDBSaveOptions } from './mysql.db';
+import { MySQLKeyValueDB } from './mysqlKeyValueDB';
 import { jsonSchemaToMySQLDDL } from './schema/mysql.schema.util';
 export type { MysqlDBCfg, MysqlDBOptions, MysqlDBSaveOptions };
-export { MysqlDB, jsonSchemaToMySQLDDL, getDBAdapter };
+export { MysqlDB, MySQLKeyValueDB, jsonSchemaToMySQLDDL, getDBAdapter };

package/dist/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDBAdapter = exports.jsonSchemaToMySQLDDL = exports.MysqlDB = void 0;
+exports.getDBAdapter = exports.jsonSchemaToMySQLDDL = exports.MySQLKeyValueDB = exports.MysqlDB = void 0;
 const dbAdapter_1 = require("./dbAdapter");
 Object.defineProperty(exports, "getDBAdapter", { enumerable: true, get: function () { return dbAdapter_1.getDBAdapter; } });
 const mysql_db_1 = require("./mysql.db");
 Object.defineProperty(exports, "MysqlDB", { enumerable: true, get: function () { return mysql_db_1.MysqlDB; } });
+const mysqlKeyValueDB_1 = require("./mysqlKeyValueDB");
+Object.defineProperty(exports, "MySQLKeyValueDB", { enumerable: true, get: function () { return mysqlKeyValueDB_1.MySQLKeyValueDB; } });
 const mysql_schema_util_1 = require("./schema/mysql.schema.util");
 Object.defineProperty(exports, "jsonSchemaToMySQLDDL", { enumerable: true, get: function () { return mysql_schema_util_1.jsonSchemaToMySQLDDL; } });

package/dist/mysql.db.d.ts

@@ -1,8 +1,7 @@
-import { AnyObjectWithId } from '@naturalcycles/db-lib/src/db.model';
-import { BaseCommonDB, CommonDB, CommonDBCreateOptions, CommonDBOptions, CommonDBSaveOptions, DBQuery, ObjectWithId, RunQueryResult } from '@naturalcycles/db-lib';
-import { JsonSchemaObject, JsonSchemaRootObject } from '@naturalcycles/js-lib';
+import { BaseCommonDB, CommonDB, CommonDBCreateOptions, CommonDBOptions, CommonDBSaveOptions, DBQuery, RunQueryResult } from '@naturalcycles/db-lib';
+import { AnyObjectWithId, CommonLogger, JsonSchemaObject, JsonSchemaRootObject, ObjectWithId } from '@naturalcycles/js-lib';
 import { ReadableTyped } from '@naturalcycles/nodejs-lib';
-import { Connection, Pool, PoolConfig, PoolConnection, QueryOptions } from 'mysql';
+import { Connection, Pool, PoolConfig, PoolConnection, QueryOptions, TypeCast } from 'mysql';
 export interface MysqlDBOptions extends CommonDBOptions {
 }
 export interface MysqlDBSaveOptions<ROW extends ObjectWithId = AnyObjectWithId> extends CommonDBSaveOptions<ROW> {
@@ -19,10 +18,17 @@ export interface MysqlDBCfg extends PoolConfig {
      * If true - will emit logs of connection events.
      */
     debugConnections?: boolean;
+    /**
+     * Default to `console`
+     */
+    logger?: CommonLogger;
 }
+export declare const typeCast: TypeCast;
 export declare class MysqlDB extends BaseCommonDB implements CommonDB {
     constructor(cfg?: MysqlDBCfg);
-    cfg: MysqlDBCfg;
+    cfg: MysqlDBCfg & {
+        logger: CommonLogger;
+    };
     ping(): Promise<void>;
     pool(): Pool;
     close(): Promise<void>;

package/dist/mysql.db.js

@@ -1,17 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MysqlDB = void 0;
+exports.MysqlDB = exports.typeCast = void 0;
 const tslib_1 = require("tslib");
 const stream_1 = require("stream");
 const util_1 = require("util");
 const db_lib_1 = require("@naturalcycles/db-lib");
 const js_lib_1 = require("@naturalcycles/js-lib");
-const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
 const colors_1 = require("@naturalcycles/nodejs-lib/dist/colors");
 const mysql = require("mysql");
 const query_util_1 = require("./query.util");
 const mysql_schema_util_1 = require("./schema/mysql.schema.util");
-const log = (0, nodejs_lib_1.Debug)('nc:mysql-lib');
 const BOOLEAN_TYPES = new Set(['TINY', 'TINYINT', 'INT']);
 const BOOLEAN_BIT_TYPES = new Set(['BIT']);
 const typeCast = (field, next) => {
@@ -33,17 +31,19 @@ const typeCast = (field, next) => {
     }
     return next();
 };
+exports.typeCast = typeCast;
 class MysqlDB extends db_lib_1.BaseCommonDB {
     constructor(cfg = {}) {
         super();
         this.cfg = {
-            typeCast,
+            typeCast: exports.typeCast,
             // charset: 'utf8mb4', // for emoji support
             // host: 'localhost',
             // user: MYSQL_USER,
             // password: MYSQL_PW,
             // database: MYSQL_DB,
             ...cfg,
+            logger: (0, js_lib_1.commonLoggerPrefix)(cfg.logger || console, '[mysql]'),
         };
     }
     async ping() {
@@ -52,31 +52,32 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
     }
     pool() {
         const pool = mysql.createPool(this.cfg);
-        const { host, database } = this.cfg;
-        log(`connected to ${(0, colors_1.white)(host + '/' + database)}`);
+        const { host, database, logger } = this.cfg;
+        logger.log(`connected to ${(0, colors_1.white)(host + '/' + database)}`);
         if (this.cfg.debugConnections) {
             pool.on('acquire', con => {
-                log(`acquire(${con.threadId})`);
+                logger.log(`acquire(${con.threadId})`);
             });
             pool.on('connection', con => {
-                log(`connection(${con.threadId})`);
+                logger.log(`connection(${con.threadId})`);
             });
             pool.on('enqueue', () => {
-                log(`enqueue`);
+                logger.log(`enqueue`);
             });
             pool.on('release', con => {
-                log(`release(${con.threadId})`);
+                logger.log(`release(${con.threadId})`);
             });
         }
         pool.on('error', err => {
-            log.error(`error`, err);
+            logger.error(err);
         });
         return pool;
     }
     async close() {
         const pool = this.pool();
         // eslint-disable-next-line @typescript-eslint/await-thenable
-        await (0, util_1.promisify)(pool.end.bind(pool));
+        await (0, util_1.promisify)(pool.end.bind(pool))();
+        this.cfg.logger.log('closed');
     }
     /**
      * Be careful to always call `con.release()` when you get connection with this method.
@@ -94,14 +95,14 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
         await (0, util_1.promisify)(con.connect.bind(con))();
         const { threadId } = con;
         if (this.cfg.debugConnections) {
-            log(`createSingleConnection(${threadId})`);
-            con.on('connect', () => log(`createSingleConnection(${threadId}).connect`));
-            con.on('drain', () => log(`createSingleConnection(${threadId}).drain`));
-            con.on('enqueue', () => log(`createSingleConnection(${threadId}).enqueue`));
-            con.on('end', () => log(`createSingleConnection(${threadId}).end`));
+            this.cfg.logger.log(`createSingleConnection(${threadId})`);
+            con.on('connect', () => this.cfg.logger.log(`createSingleConnection(${threadId}).connect`));
+            con.on('drain', () => this.cfg.logger.log(`createSingleConnection(${threadId}).drain`));
+            con.on('enqueue', () => this.cfg.logger.log(`createSingleConnection(${threadId}).enqueue`));
+            con.on('end', () => this.cfg.logger.log(`createSingleConnection(${threadId}).end`));
         }
         con.on('error', err => {
-            log.error(`createSingleConnection(${threadId}).error`, err);
+            this.cfg.logger.error(`createSingleConnection(${threadId}).error`, err);
         });
         return con;
     }
@@ -116,14 +117,20 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
     // QUERY
     async runQuery(q, _opt = {}) {
         const sql = (0, query_util_1.dbQueryToSQLSelect)(q);
-        const rows = await this.runSQL({ sql });
+        const rows = (await this.runSQL({ sql })).map(row => (0, js_lib_1._mapKeys)((0, js_lib_1._filterUndefinedValues)(row, true), k => (0, mysql_schema_util_1.mapNameFromMySQL)(k)));
+        // edge case where 0 fields are selected
+        if (q._selectedFieldNames?.length === 0) {
+            return {
+                rows: rows.map(_ => ({})),
+            };
+        }
         return {
-            rows: rows.map(r => (0, js_lib_1._mapKeys)((0, js_lib_1._filterNullishValues)(r, true), k => (0, mysql_schema_util_1.mapNameFromMySQL)(k))),
+            rows,
         };
     }
     async runSQL(q) {
         if (this.cfg.logSQL)
-            log(q.sql, q.values);
+            this.cfg.logger.log(...[q.sql, q.values].filter(Boolean));
         return await new Promise((resolve, reject) => {
             this.pool().query(q, (err, res) => {
                 if (err)
@@ -139,7 +146,7 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
     streamQuery(q, _opt = {}) {
         const sql = (0, query_util_1.dbQueryToSQLSelect)(q);
         if (this.cfg.logSQL)
-            log(`stream: ${sql}`);
+            this.cfg.logger.log(`stream: ${sql}`);
         // return this.streamSQL(sql, opt)
         return this.pool()
             .query(sql)
@@ -147,7 +154,7 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
             .pipe(new stream_1.Transform({
             objectMode: true,
             transform(row, _encoding, cb) {
-                cb(null, (0, js_lib_1._filterNullishValues)(row, true));
+                cb(null, (0, js_lib_1._filterUndefinedValues)(row, true));
             },
         }));
     }
@@ -156,11 +163,11 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
         if (!_rows.length)
             return;
         // Stringify object values
-        const rows = _rows.map(row => (0, js_lib_1._mapValues)(row, v => {
+        const rows = _rows.map(row => (0, js_lib_1._mapValues)(row, (_k, v) => {
             return v && typeof v === 'object' && !Buffer.isBuffer(v) ? JSON.stringify(v) : v;
         }));
         // inserts are split into multiple sentenses to respect the max_packet_size (1Mb usually)
-        const sqls = (0, query_util_1.insertSQL)(table, rows);
+        const sqls = (0, query_util_1.insertSQL)(table, rows, 'REPLACE', this.cfg.logger);
         for await (const sql of sqls) {
             await this.runSQL({ sql });
         }
@@ -205,7 +212,7 @@ class MysqlDB extends db_lib_1.BaseCommonDB {
         const stats = await this.runSQL({
             sql: `describe ${mysql.escapeId(table)}`,
         });
-        return (0, mysql_schema_util_1.mysqlTableStatsToJsonSchemaField)(table, stats);
+        return (0, mysql_schema_util_1.mysqlTableStatsToJsonSchemaField)(table, stats, this.cfg.logger);
     }
 }
 (0, tslib_1.__decorate)([

package/dist/mysqlKeyValueDB.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="node" />
+import { CommonDBCreateOptions, CommonKeyValueDB, KeyValueDBTuple } from '@naturalcycles/db-lib';
+import { ReadableTyped } from '@naturalcycles/nodejs-lib';
+import { MysqlDB, MysqlDBCfg } from './mysql.db';
+export declare class MySQLKeyValueDB implements CommonKeyValueDB {
+    constructor(cfg?: MysqlDBCfg);
+    cfg: MysqlDBCfg;
+    db: MysqlDB;
+    ping(): Promise<void>;
+    close(): Promise<void>;
+    createTable(table: string, opt?: CommonDBCreateOptions): Promise<void>;
+    getByIds(table: string, ids: string[]): Promise<KeyValueDBTuple[]>;
+    /**
+     * Use with caution!
+     */
+    dropTable(table: string): Promise<void>;
+    deleteByIds(table: string, ids: string[]): Promise<void>;
+    saveBatch(table: string, entries: KeyValueDBTuple[]): Promise<void>;
+    streamIds(table: string, limit?: number): ReadableTyped<string>;
+    streamValues(table: string, limit?: number): ReadableTyped<Buffer>;
+    streamEntries(table: string, limit?: number): ReadableTyped<KeyValueDBTuple>;
+    beginTransaction(): Promise<void>;
+    endTransaction(): Promise<void>;
+    count(table: string): Promise<number>;
+}

package/dist/mysqlKeyValueDB.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MySQLKeyValueDB = void 0;
+const stream_1 = require("stream");
+const js_lib_1 = require("@naturalcycles/js-lib");
+const mysql_db_1 = require("./mysql.db");
+class MySQLKeyValueDB {
+    constructor(cfg = {}) {
+        this.cfg = {
+            typeCast: mysql_db_1.typeCast,
+            ...cfg,
+        };
+        this.db = new mysql_db_1.MysqlDB(this.cfg);
+    }
+    async ping() {
+        await this.db.ping();
+    }
+    async close() {
+        await this.db.close();
+    }
+    async createTable(table, opt = {}) {
+        if (opt.dropIfExists)
+            await this.dropTable(table);
+        // On blob sizes: https://tableplus.com/blog/2019/10/tinyblob-blob-mediumblob-longblob.html
+        // LONGBLOB supports up to 4gb
+        // MEDIUMBLOB up to 16Mb
+        const sql = `create table ${table} (id VARCHAR(64) PRIMARY KEY, v LONGBLOB NOT NULL)`;
+        this.db.cfg.logger.log(sql);
+        await this.db.runSQL({ sql });
+    }
+    async getByIds(table, ids) {
+        if (!ids.length)
+            return [];
+        const sql = `SELECT id,v FROM ${table} where id in (${ids.map(id => `"${id}"`).join(',')})`;
+        const rows = await this.db.runSQL({ sql });
+        return rows.map(({ id, v }) => [id, v]);
+    }
+    /**
+     * Use with caution!
+     */
+    async dropTable(table) {
+        await this.db.runSQL({ sql: `DROP TABLE IF EXISTS ${table}` });
+    }
+    async deleteByIds(table, ids) {
+        const sql = `DELETE FROM ${table} WHERE id in (${ids.map(id => `"${id}"`).join(',')})`;
+        if (this.cfg.logSQL)
+            this.db.cfg.logger.log(sql);
+        await this.db.runSQL({ sql });
+    }
+    async saveBatch(table, entries) {
+        const statements = entries.map(([id, buf]) => {
+            return {
+                sql: `INSERT INTO ${table} (id, v) VALUES (?, ?)`,
+                values: [id, buf],
+            };
+        });
+        await (0, js_lib_1.pMap)(statements, async (statement) => {
+            if (this.cfg.debug)
+                this.db.cfg.logger.log(statement.sql);
+            await this.db.runSQL(statement);
+        });
+    }
+    streamIds(table, limit) {
+        let sql = `SELECT id FROM ${table}`;
+        if (limit)
+            sql += ` LIMIT ${limit}`;
+        if (this.cfg.logSQL)
+            this.db.cfg.logger.log(`stream: ${sql}`);
+        return this.db
+            .pool()
+            .query(sql)
+            .stream()
+            .pipe(new stream_1.Transform({
+            objectMode: true,
+            transform(row, _, cb) {
+                cb(null, row.id);
+            },
+        }));
+    }
+    streamValues(table, limit) {
+        let sql = `SELECT v FROM ${table}`;
+        if (limit)
+            sql += ` LIMIT ${limit}`;
+        if (this.cfg.logSQL)
+            this.db.cfg.logger.log(`stream: ${sql}`);
+        return this.db
+            .pool()
+            .query(sql)
+            .stream()
+            .pipe(new stream_1.Transform({
+            objectMode: true,
+            transform(row, _, cb) {
+                cb(null, row.v);
+            },
+        }));
+    }
+    streamEntries(table, limit) {
+        let sql = `SELECT id,v FROM ${table}`;
+        if (limit)
+            sql += ` LIMIT ${limit}`;
+        if (this.cfg.logSQL)
+            this.db.cfg.logger.log(`stream: ${sql}`);
+        return this.db
+            .pool()
+            .query(sql)
+            .stream()
+            .pipe(new stream_1.Transform({
+            objectMode: true,
+            transform(row, _, cb) {
+                cb(null, [row.id, row.v]);
+            },
+        }));
+    }
+    async beginTransaction() {
+        await this.db.runSQL({ sql: `BEGIN TRANSACTION` });
+    }
+    async endTransaction() {
+        await this.db.runSQL({ sql: `END TRANSACTION` });
+    }
+    async count(table) {
+        const sql = `SELECT count(*) as cnt FROM ${table}`;
+        if (this.cfg.logSQL)
+            this.db.cfg.logger.log(sql);
+        const rows = await this.db.runSQL({ sql });
+        return rows[0].cnt;
+    }
+}
+exports.MySQLKeyValueDB = MySQLKeyValueDB;

package/dist/query.util.d.ts

@@ -1,11 +1,12 @@
 import { DBQuery } from '@naturalcycles/db-lib';
+import { CommonLogger } from '@naturalcycles/js-lib';
 import { QueryOptions } from 'mysql';
 export declare function dbQueryToSQLSelect(q: DBQuery<any>): string;
 export declare function dbQueryToSQLDelete(q: DBQuery<any>): string;
 /**
  * Returns array of sql statements to respect the max sql size.
  */
-export declare function insertSQL(table: string, records: Record<any, any>[], verb?: 'INSERT' | 'REPLACE'): string[];
+export declare function insertSQL(table: string, rows: Record<any, any>[], verb?: 'INSERT' | 'REPLACE', logger?: CommonLogger): string[];
 export declare function insertSQLSingle(table: string, record: Record<any, any>): string;
 export declare function insertSQLSetSingle(table: string, record: Record<any, any>): QueryOptions;
 export declare function dbQueryToSQLUpdate(q: DBQuery<any>, record: Record<any, any>): string;

package/dist/query.util.js

@@ -30,12 +30,12 @@ exports.dbQueryToSQLDelete = dbQueryToSQLDelete;
 /**
  * Returns array of sql statements to respect the max sql size.
  */
-function insertSQL(table, records, verb = 'INSERT') {
+function insertSQL(table, rows, verb = 'INSERT', logger = console) {
     // INSERT INTO table_name (column1, column2, column3, ...)
     // VALUES (value1, value2, value3, ...);
     // eslint-disable-next-line unicorn/no-array-reduce
-    const fieldSet = records.reduce((set, rec) => {
-        Object.keys(rec).forEach(field => set.add(field));
+    const fieldSet = rows.reduce((set, row) => {
+        Object.keys(row).forEach(field => set.add(field));
         return set;
     }, new Set());
     const fields = [...fieldSet];
@@ -46,7 +46,7 @@ function insertSQL(table, records, verb = 'INSERT') {
         `(` + [...fields].map(f => mysql.escapeId((0, mysql_schema_util_1.mapNameToMySQL)(f))).join(',') + `)`,
         `VALUES\n`,
     ].join(' ');
-    const valueRows = records.map(rec => {
+    const valueRows = rows.map(rec => {
         return `(` + fields.map(k => mysql.escape(rec[k])).join(',') + `)`;
     });
     const full = start + valueRows.join(',\n');
@@ -71,7 +71,7 @@ function insertSQL(table, records, verb = 'INSERT') {
     if (sql) {
         sqls.push(sql); // last one
     }
-    console.log(`${(0, colors_1.white)(table)} large sql query (${(0, colors_1.yellow)((0, js_lib_1._hb)(full.length))}) was split into ${(0, colors_1.yellow)(sqls.length)} chunks`);
+    logger.log(`${(0, colors_1.white)(table)} large sql query (${(0, colors_1.yellow)((0, js_lib_1._hb)(full.length))}) was split into ${(0, colors_1.yellow)(sqls.length)} chunks`);
     return sqls;
     // todo: handle "upsert" later
 }

package/dist/schema/mysql.schema.util.d.ts

@@ -1,4 +1,4 @@
-import { JsonSchemaObject, JsonSchemaRootObject } from '@naturalcycles/js-lib';
+import { CommonLogger, JsonSchemaObject, JsonSchemaRootObject } from '@naturalcycles/js-lib';
 export interface MySQLTableStats {
     Field: string;
     Type: string;
@@ -14,7 +14,7 @@ export interface MySQLSchemaOptions {
  * It currently skips nullability and declares everything as "DEFAULT NULL".
  */
 export declare function jsonSchemaToMySQLDDL(table: string, schema: JsonSchemaObject<any>, opt?: MySQLSchemaOptions): string;
-export declare function mysqlTableStatsToJsonSchemaField<T = any>(table: string, stats: MySQLTableStats[]): JsonSchemaRootObject<T>;
+export declare function mysqlTableStatsToJsonSchemaField<T = any>(table: string, stats: MySQLTableStats[], logger: CommonLogger): JsonSchemaRootObject<T>;
 /**
  * Because MySQL doesn't support `.` in field names and escapes them as tableName + fieldName.
  *

package/dist/schema/mysql.schema.util.js

@@ -56,7 +56,7 @@ function jsonSchemaToMySQLDDL(table, schema, opt = {}) {
     return lines.join('\n');
 }
 exports.jsonSchemaToMySQLDDL = jsonSchemaToMySQLDDL;
-function mysqlTableStatsToJsonSchemaField(table, stats) {
+function mysqlTableStatsToJsonSchemaField(table, stats, logger) {
     const s = {
         $id: `${table}.schema.json`,
         type: 'object',
@@ -80,14 +80,14 @@ function mysqlTableStatsToJsonSchemaField(table, stats) {
         else if (t.startsWith('tinyint') || t.includes('(1)')) {
             s.properties[name] = { type: 'boolean' };
         }
-        else if (t.startsWith('int(')) {
+        else if (t === 'int' || t.startsWith('int(')) {
             s.properties[name] = { type: 'integer' };
         }
         else if (t.startsWith('float')) {
             s.properties[name] = { type: 'number' };
         }
         else {
-            console.log(s);
+            logger.log(s);
             throw new Error(`Unknown mysql field type ${name} ${stat.Type}`);
         }
     });

package/package.json

@@ -3,9 +3,6 @@
   "scripts": {
     "prepare": "husky install"
   },
-  "peerDependencies": {
-    "@naturalcycles/db-lib": ">=7.0.0"
-  },
   "dependencies": {
     "@naturalcycles/db-lib": "^8.16.2",
     "@naturalcycles/js-lib": "^14.47.0",
@@ -15,7 +12,7 @@
   },
   "devDependencies": {
     "@naturalcycles/dev-lib": "^12.7.5",
-    "@types/node": "^16.10.2",
+    "@types/node": "^17.0.5",
     "dotenv": "^10.0.0",
     "jest": "^27.2.4"
   },
@@ -39,7 +36,7 @@
   "engines": {
     "node": ">=14.15.0"
   },
-  "version": "3.8.1",
+  "version": "3.10.0",
   "description": "MySQL client implementing CommonDB interface",
   "keywords": [
     "mysql",

package/readme.md

@@ -3,12 +3,33 @@
 > MySQL client implementing CommonDB interface
 
 [![npm](https://img.shields.io/npm/v/@naturalcycles/mysql-lib/latest.svg)](https://www.npmjs.com/package/@naturalcycles/mysql-lib)
-[![](https://circleci.com/gh/NaturalCycles/mysql-lib.svg?style=shield&circle-token=123)](https://circleci.com/gh/NaturalCycles/mysql-lib)
 [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
 
-# Packaging
+# Quick start
 
-- `engines.node >= 10.13`: Latest Node.js LTS
-- `main: dist/index.js`: commonjs, es2018
-- `types: dist/index.d.ts`: typescript types
-- `/src` folder with source `*.ts` files included
+todo
+
+# Develop
+
+Install MySQL server+client on Mac:
+
+```shell
+
+brew install mysql
+
+# start
+
+mysql.server start
+
+# secure
+
+mysql_secure_installation
+
+# connect
+
+mysql -uroot
+
+# Default options are read from the following files in the given order:
+# /etc/my.cnf /etc/mysql/my.cnf /opt/homebrew/etc/my.cnf ~/.my.cnf
+
+```

package/src/index.ts

@@ -1,7 +1,8 @@
 import { getDBAdapter } from './dbAdapter'
 import { MysqlDB, MysqlDBCfg, MysqlDBOptions, MysqlDBSaveOptions } from './mysql.db'
+import { MySQLKeyValueDB } from './mysqlKeyValueDB'
 import { jsonSchemaToMySQLDDL } from './schema/mysql.schema.util'
 
 export type { MysqlDBCfg, MysqlDBOptions, MysqlDBSaveOptions }
 
-export { MysqlDB, jsonSchemaToMySQLDDL, getDBAdapter }
+export { MysqlDB, MySQLKeyValueDB, jsonSchemaToMySQLDDL, getDBAdapter }

package/src/mysql.db.ts

@@ -1,6 +1,5 @@
 import { Transform } from 'stream'
 import { promisify } from 'util'
-import { AnyObjectWithId } from '@naturalcycles/db-lib/src/db.model'
 import {
   BaseCommonDB,
   CommonDB,
@@ -8,18 +7,21 @@ import {
   CommonDBOptions,
   CommonDBSaveOptions,
   DBQuery,
-  ObjectWithId,
   RunQueryResult,
 } from '@naturalcycles/db-lib'
 import {
-  _filterNullishValues,
+  _filterUndefinedValues,
   _mapKeys,
   _mapValues,
   _Memo,
+  AnyObjectWithId,
+  CommonLogger,
+  commonLoggerPrefix,
   JsonSchemaObject,
   JsonSchemaRootObject,
+  ObjectWithId,
 } from '@naturalcycles/js-lib'
-import { Debug, ReadableTyped } from '@naturalcycles/nodejs-lib'
+import { ReadableTyped } from '@naturalcycles/nodejs-lib'
 import { white } from '@naturalcycles/nodejs-lib/dist/colors'
 import { Connection, Pool, PoolConfig, PoolConnection, QueryOptions, TypeCast } from 'mysql'
 import * as mysql from 'mysql'
@@ -48,14 +50,17 @@ export interface MysqlDBCfg extends PoolConfig {
    * If true - will emit logs of connection events.
    */
   debugConnections?: boolean
-}
 
-const log = Debug('nc:mysql-lib')
+  /**
+   * Default to `console`
+   */
+  logger?: CommonLogger
+}
 
 const BOOLEAN_TYPES = new Set(['TINY', 'TINYINT', 'INT'])
 const BOOLEAN_BIT_TYPES = new Set(['BIT'])
 
-const typeCast: TypeCast = (field, next) => {
+export const typeCast: TypeCast = (field, next) => {
   // cast to boolean
   if (field.length === 1) {
     if (BOOLEAN_BIT_TYPES.has(field.type)) {
@@ -86,10 +91,11 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
       // password: MYSQL_PW,
       // database: MYSQL_DB,
       ...cfg,
+      logger: commonLoggerPrefix(cfg.logger || console, '[mysql]'),
     }
   }
 
-  cfg!: MysqlDBCfg
+  cfg: MysqlDBCfg & { logger: CommonLogger }
 
   override async ping(): Promise<void> {
     const con = await this.getConnection()
@@ -99,29 +105,29 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
   @_Memo()
   pool(): Pool {
     const pool = mysql.createPool(this.cfg)
-    const { host, database } = this.cfg
-    log(`connected to ${white(host + '/' + database)}`)
+    const { host, database, logger } = this.cfg
+    logger.log(`connected to ${white(host + '/' + database)}`)
 
     if (this.cfg.debugConnections) {
       pool.on('acquire', con => {
-        log(`acquire(${con.threadId})`)
+        logger.log(`acquire(${con.threadId})`)
       })
 
       pool.on('connection', con => {
-        log(`connection(${con.threadId})`)
+        logger.log(`connection(${con.threadId})`)
       })
 
       pool.on('enqueue', () => {
-        log(`enqueue`)
+        logger.log(`enqueue`)
       })
 
       pool.on('release', con => {
-        log(`release(${con.threadId})`)
+        logger.log(`release(${con.threadId})`)
       })
     }
 
     pool.on('error', err => {
-      log.error(`error`, err)
+      logger.error(err)
     })
 
     return pool
@@ -130,7 +136,8 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
   async close(): Promise<void> {
     const pool = this.pool()
     // eslint-disable-next-line @typescript-eslint/await-thenable
-    await promisify(pool.end.bind(pool))
+    await promisify(pool.end.bind(pool))()
+    this.cfg.logger.log('closed')
   }
 
   /**
@@ -151,16 +158,16 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
     const { threadId } = con
 
     if (this.cfg.debugConnections) {
-      log(`createSingleConnection(${threadId})`)
+      this.cfg.logger.log(`createSingleConnection(${threadId})`)
 
-      con.on('connect', () => log(`createSingleConnection(${threadId}).connect`))
-      con.on('drain', () => log(`createSingleConnection(${threadId}).drain`))
-      con.on('enqueue', () => log(`createSingleConnection(${threadId}).enqueue`))
-      con.on('end', () => log(`createSingleConnection(${threadId}).end`))
+      con.on('connect', () => this.cfg.logger.log(`createSingleConnection(${threadId}).connect`))
+      con.on('drain', () => this.cfg.logger.log(`createSingleConnection(${threadId}).drain`))
+      con.on('enqueue', () => this.cfg.logger.log(`createSingleConnection(${threadId}).enqueue`))
+      con.on('end', () => this.cfg.logger.log(`createSingleConnection(${threadId}).end`))
     }
 
     con.on('error', err => {
-      log.error(`createSingleConnection(${threadId}).error`, err)
+      this.cfg.logger.error(`createSingleConnection(${threadId}).error`, err)
     })
 
     return con
@@ -184,14 +191,24 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
     _opt: MysqlDBOptions = {},
   ): Promise<RunQueryResult<OUT>> {
     const sql = dbQueryToSQLSelect(q)
-    const rows = await this.runSQL<ROW[]>({ sql })
+    const rows = (await this.runSQL<ROW[]>({ sql })).map(
+      row => _mapKeys(_filterUndefinedValues(row, true), k => mapNameFromMySQL(k)) as any,
+    )
+
+    // edge case where 0 fields are selected
+    if (q._selectedFieldNames?.length === 0) {
+      return {
+        rows: rows.map(_ => ({} as any)),
+      }
+    }
+
     return {
-      rows: rows.map(r => _mapKeys(_filterNullishValues(r, true), k => mapNameFromMySQL(k)) as any),
+      rows,
     }
   }
 
   async runSQL<RESULT>(q: QueryOptions): Promise<RESULT> {
-    if (this.cfg.logSQL) log(q.sql, q.values)
+    if (this.cfg.logSQL) this.cfg.logger.log(...[q.sql, q.values].filter(Boolean))
 
     return await new Promise<RESULT>((resolve, reject) => {
       this.pool().query(q, (err, res) => {
@@ -215,7 +232,7 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
   ): ReadableTyped<OUT> {
     const sql = dbQueryToSQLSelect(q)
 
-    if (this.cfg.logSQL) log(`stream: ${sql}`)
+    if (this.cfg.logSQL) this.cfg.logger.log(`stream: ${sql}`)
 
     // return this.streamSQL(sql, opt)
     return this.pool()
@@ -225,7 +242,7 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
         new Transform({
           objectMode: true,
           transform(row, _encoding, cb) {
-            cb(null, _filterNullishValues(row, true))
+            cb(null, _filterUndefinedValues(row, true))
           },
         }),
       )
@@ -241,13 +258,13 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
 
     // Stringify object values
     const rows = _rows.map(row =>
-      _mapValues(row, v => {
+      _mapValues(row, (_k, v) => {
         return v && typeof v === 'object' && !Buffer.isBuffer(v) ? JSON.stringify(v) : v
       }),
     )
 
     // inserts are split into multiple sentenses to respect the max_packet_size (1Mb usually)
-    const sqls = insertSQL(table, rows)
+    const sqls = insertSQL(table, rows, 'REPLACE', this.cfg.logger)
 
     for await (const sql of sqls) {
       await this.runSQL({ sql })
@@ -308,6 +325,6 @@ export class MysqlDB extends BaseCommonDB implements CommonDB {
       sql: `describe ${mysql.escapeId(table)}`,
     })
 
-    return mysqlTableStatsToJsonSchemaField<ROW>(table, stats)
+    return mysqlTableStatsToJsonSchemaField<ROW>(table, stats, this.cfg.logger)
   }
 }

package/src/mysqlKeyValueDB.ts

@@ -0,0 +1,155 @@
+import { Transform } from 'stream'
+import { CommonDBCreateOptions, CommonKeyValueDB, KeyValueDBTuple } from '@naturalcycles/db-lib'
+import { pMap } from '@naturalcycles/js-lib'
+import { ReadableTyped } from '@naturalcycles/nodejs-lib'
+import { QueryOptions } from 'mysql'
+import { MysqlDB, MysqlDBCfg, typeCast } from './mysql.db'
+
+interface KeyValueObject {
+  id: string
+  v: Buffer
+}
+
+export class MySQLKeyValueDB implements CommonKeyValueDB {
+  constructor(cfg: MysqlDBCfg = {}) {
+    this.cfg = {
+      typeCast,
+      ...cfg,
+    }
+
+    this.db = new MysqlDB(this.cfg)
+  }
+
+  cfg: MysqlDBCfg
+
+  db: MysqlDB
+
+  async ping(): Promise<void> {
+    await this.db.ping()
+  }
+
+  async close(): Promise<void> {
+    await this.db.close()
+  }
+
+  async createTable(table: string, opt: CommonDBCreateOptions = {}): Promise<void> {
+    if (opt.dropIfExists) await this.dropTable(table)
+
+    // On blob sizes: https://tableplus.com/blog/2019/10/tinyblob-blob-mediumblob-longblob.html
+    // LONGBLOB supports up to 4gb
+    // MEDIUMBLOB up to 16Mb
+    const sql = `create table ${table} (id VARCHAR(64) PRIMARY KEY, v LONGBLOB NOT NULL)`
+    this.db.cfg.logger.log(sql)
+    await this.db.runSQL({ sql })
+  }
+
+  async getByIds(table: string, ids: string[]): Promise<KeyValueDBTuple[]> {
+    if (!ids.length) return []
+
+    const sql = `SELECT id,v FROM ${table} where id in (${ids.map(id => `"${id}"`).join(',')})`
+
+    const rows = await this.db.runSQL<KeyValueObject[]>({ sql })
+
+    return rows.map(({ id, v }) => [id, v])
+  }
+
+  /**
+   * Use with caution!
+   */
+  async dropTable(table: string): Promise<void> {
+    await this.db.runSQL({ sql: `DROP TABLE IF EXISTS ${table}` })
+  }
+
+  async deleteByIds(table: string, ids: string[]): Promise<void> {
+    const sql = `DELETE FROM ${table} WHERE id in (${ids.map(id => `"${id}"`).join(',')})`
+    if (this.cfg.logSQL) this.db.cfg.logger.log(sql)
+    await this.db.runSQL({ sql })
+  }
+
+  async saveBatch(table: string, entries: KeyValueDBTuple[]): Promise<void> {
+    const statements: QueryOptions[] = entries.map(([id, buf]) => {
+      return {
+        sql: `INSERT INTO ${table} (id, v) VALUES (?, ?)`,
+        values: [id, buf],
+      }
+    })
+
+    await pMap(statements, async statement => {
+      if (this.cfg.debug) this.db.cfg.logger.log(statement.sql)
+      await this.db.runSQL(statement)
+    })
+  }
+
+  streamIds(table: string, limit?: number): ReadableTyped<string> {
+    let sql = `SELECT id FROM ${table}`
+    if (limit) sql += ` LIMIT ${limit}`
+    if (this.cfg.logSQL) this.db.cfg.logger.log(`stream: ${sql}`)
+
+    return this.db
+      .pool()
+      .query(sql)
+      .stream()
+      .pipe(
+        new Transform({
+          objectMode: true,
+          transform(row, _, cb) {
+            cb(null, row.id)
+          },
+        }),
+      )
+  }
+
+  streamValues(table: string, limit?: number): ReadableTyped<Buffer> {
+    let sql = `SELECT v FROM ${table}`
+    if (limit) sql += ` LIMIT ${limit}`
+    if (this.cfg.logSQL) this.db.cfg.logger.log(`stream: ${sql}`)
+
+    return this.db
+      .pool()
+      .query(sql)
+      .stream()
+      .pipe(
+        new Transform({
+          objectMode: true,
+          transform(row, _, cb) {
+            cb(null, row.v)
+          },
+        }),
+      )
+  }
+
+  streamEntries(table: string, limit?: number): ReadableTyped<KeyValueDBTuple> {
+    let sql = `SELECT id,v FROM ${table}`
+    if (limit) sql += ` LIMIT ${limit}`
+    if (this.cfg.logSQL) this.db.cfg.logger.log(`stream: ${sql}`)
+
+    return this.db
+      .pool()
+      .query(sql)
+      .stream()
+      .pipe(
+        new Transform({
+          objectMode: true,
+          transform(row, _, cb) {
+            cb(null, [row.id, row.v])
+          },
+        }),
+      )
+  }
+
+  async beginTransaction(): Promise<void> {
+    await this.db.runSQL({ sql: `BEGIN TRANSACTION` })
+  }
+
+  async endTransaction(): Promise<void> {
+    await this.db.runSQL({ sql: `END TRANSACTION` })
+  }
+
+  async count(table: string): Promise<number> {
+    const sql = `SELECT count(*) as cnt FROM ${table}`
+    if (this.cfg.logSQL) this.db.cfg.logger.log(sql)
+
+    const rows = await this.db.runSQL<{ cnt: number }[]>({ sql })
+    return rows[0]!.cnt
+  }
+}

package/src/query.util.ts

@@ -1,6 +1,6 @@
 import { DBQuery } from '@naturalcycles/db-lib'
 import { DBQueryFilterOperator } from '@naturalcycles/db-lib/src/query/dbQuery'
-import { _hb } from '@naturalcycles/js-lib'
+import { _hb, CommonLogger } from '@naturalcycles/js-lib'
 import { white, yellow } from '@naturalcycles/nodejs-lib/dist/colors'
 import { QueryOptions } from 'mysql'
 import * as mysql from 'mysql'
@@ -41,15 +41,16 @@ export function dbQueryToSQLDelete(q: DBQuery<any>): string {
  */
 export function insertSQL(
   table: string,
-  records: Record<any, any>[],
+  rows: Record<any, any>[],
   verb: 'INSERT' | 'REPLACE' = 'INSERT',
+  logger: CommonLogger = console,
 ): string[] {
   // INSERT INTO table_name (column1, column2, column3, ...)
   // VALUES (value1, value2, value3, ...);
 
   // eslint-disable-next-line unicorn/no-array-reduce
-  const fieldSet = records.reduce((set: Set<string>, rec) => {
-    Object.keys(rec).forEach(field => set.add(field))
+  const fieldSet = rows.reduce((set: Set<string>, row) => {
+    Object.keys(row).forEach(field => set.add(field))
     return set
   }, new Set<string>())
   const fields = [...fieldSet]
@@ -62,7 +63,7 @@ export function insertSQL(
     `VALUES\n`,
   ].join(' ')
 
-  const valueRows = records.map(rec => {
+  const valueRows = rows.map(rec => {
     return `(` + fields.map(k => mysql.escape(rec[k])).join(',') + `)`
   })
 
@@ -90,7 +91,7 @@ export function insertSQL(
     sqls.push(sql) // last one
   }
 
-  console.log(
+  logger.log(
     `${white(table)} large sql query (${yellow(_hb(full.length))}) was split into ${yellow(
       sqls.length,
     )} chunks`,

package/src/schema/mysql.schema.util.ts

@@ -1,4 +1,5 @@
 import {
+  CommonLogger,
   JsonSchemaBoolean,
   JsonSchemaNumber,
   JsonSchemaObject,
@@ -81,6 +82,7 @@ export function jsonSchemaToMySQLDDL(
 export function mysqlTableStatsToJsonSchemaField<T = any>(
   table: string,
   stats: MySQLTableStats[],
+  logger: CommonLogger,
 ): JsonSchemaRootObject<T> {
   const s: JsonSchemaRootObject<T> = {
     $id: `${table}.schema.json`,
@@ -104,12 +106,12 @@ export function mysqlTableStatsToJsonSchemaField<T = any>(
       s.properties[name] = { instanceof: 'Buffer' }
     } else if (t.startsWith('tinyint') || t.includes('(1)')) {
       s.properties[name] = { type: 'boolean' } as JsonSchemaBoolean
-    } else if (t.startsWith('int(')) {
+    } else if (t === 'int' || t.startsWith('int(')) {
       s.properties[name] = { type: 'integer' } as JsonSchemaNumber
     } else if (t.startsWith('float')) {
       s.properties[name] = { type: 'number' } as JsonSchemaNumber
     } else {
-      console.log(s)
+      logger.log(s)
       throw new Error(`Unknown mysql field type ${name} ${stat.Type}`)
     }
   })

package/CHANGELOG.md

@@ -1,205 +0,0 @@
-## [3.8.1](https://github.com/NaturalCycles/mysql-lib/compare/v3.8.0...v3.8.1) (2021-10-17)
-
-
-### Bug Fixes
-
-* adapt to latest db-lib ([9a368ef](https://github.com/NaturalCycles/mysql-lib/commit/9a368ef4b9d964c09520660319059e9cb67bcf76))
-
-# [3.8.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.7.1...v3.8.0) (2021-10-04)
-
-
-### Features
-
-* modernize ([6e8f0a2](https://github.com/NaturalCycles/mysql-lib/commit/6e8f0a254a67902cbc185f034f58cd4f6885449d))
-
-## [3.7.1](https://github.com/NaturalCycles/mysql-lib/compare/v3.7.0...v3.7.1) (2020-06-03)
-
-
-### Bug Fixes
-
-* modernize ([517f695](https://github.com/NaturalCycles/mysql-lib/commit/517f6952feb15059730f4f7443a295bf596053fc))
-
-# [3.7.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.6.0...v3.7.0) (2020-04-08)
-
-
-### Features
-
-* modernize ([e0e2890](https://github.com/NaturalCycles/mysql-lib/commit/e0e2890cb31e88fcbdae63c417d6cc5c6a52d4e8))
-
-# [3.6.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.5.2...v3.6.0) (2020-03-01)
-
-
-### Features
-
-* deps ([008aa10](https://github.com/NaturalCycles/mysql-lib/commit/008aa10d059734d76c2354553a8dc35c8117b3b2))
-
-## [3.5.2](https://github.com/NaturalCycles/mysql-lib/compare/v3.5.1...v3.5.2) (2019-11-20)
-
-
-### Bug Fixes
-
-* BIT typecast to boolean correctly ([0bc815e](https://github.com/NaturalCycles/mysql-lib/commit/0bc815e025a33ab9fae5405c8b97dd53aae392ca))
-
-## [3.5.1](https://github.com/NaturalCycles/mysql-lib/compare/v3.5.0...v3.5.1) (2019-11-20)
-
-
-### Bug Fixes
-
-* correctly type-cast booleans with value=NULL ([e208b4c](https://github.com/NaturalCycles/mysql-lib/commit/e208b4ca16f700b6ed7bf95c872f68f934894992))
-
-# [3.5.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.4.0...v3.5.0) (2019-11-09)
-
-
-### Features
-
-* implement getDBAdapter. Allow empty (default) configuration ([bcf12dc](https://github.com/NaturalCycles/mysql-lib/commit/bcf12dc9360f525749f9bb10965046b4c56d849a))
-
-# [3.4.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.3.1...v3.4.0) (2019-11-09)
-
-
-### Features
-
-* auto JSON.stringify objects (and arrays) ([0d9aaed](https://github.com/NaturalCycles/mysql-lib/commit/0d9aaedf8f2920a51dacf13b6723eb98c61b34c3))
-
-## [3.3.1](https://github.com/NaturalCycles/mysql-lib/compare/v3.3.0...v3.3.1) (2019-11-09)
-
-
-### Bug Fixes
-
-* use LONGBLOB for binary columns ([ae4facc](https://github.com/NaturalCycles/mysql-lib/commit/ae4facc76bc03b8aafa5141199a98bef530f6913))
-
-# [3.3.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.2.1...v3.3.0) (2019-11-09)
-
-
-### Features
-
-* mapNameToMySQL ([c4bf40c](https://github.com/NaturalCycles/mysql-lib/commit/c4bf40cd6aefaf78219a2588ec803cf74004bc07))
-
-## [3.2.1](https://github.com/NaturalCycles/mysql-lib/compare/v3.2.0...v3.2.1) (2019-11-09)
-
-
-### Bug Fixes
-
-* createTable() ([7983085](https://github.com/NaturalCycles/mysql-lib/commit/7983085017562a4e4a8f7dd38eb41ae6b9fc30ed))
-
-# [3.2.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.1.0...v3.2.0) (2019-11-09)
-
-
-### Bug Fixes
-
-* emoji support ([1262fc4](https://github.com/NaturalCycles/mysql-lib/commit/1262fc4d9ad39c818833b5cfc31b3a65979cdea0))
-
-
-### Features
-
-* auto split long sql queries ([c7c780f](https://github.com/NaturalCycles/mysql-lib/commit/c7c780f295d7ded9f418509f3160a512ec54c7e7))
-
-# [3.1.0](https://github.com/NaturalCycles/mysql-lib/compare/v3.0.0...v3.1.0) (2019-11-08)
-
-
-### Features
-
-* commonSchemaToMySQLDDL ([09168c5](https://github.com/NaturalCycles/mysql-lib/commit/09168c563cbb629ca47121a1aac6a125dd23c144))
-* implement getTables(), getTableSchema() ([20a7746](https://github.com/NaturalCycles/mysql-lib/commit/20a7746c8c4c88dfca8365d1e8d2decce3f47efa))
-
-# [3.0.0](https://github.com/NaturalCycles/mysql-lib/compare/v2.0.2...v3.0.0) (2019-11-02)
-
-
-### Features
-
-* adapt to db-lib@3 ([7d13f54](https://github.com/NaturalCycles/mysql-lib/commit/7d13f540c92dd59b014d1a502c1bff937fad567f))
-
-
-### BREAKING CHANGES
-
-* ^^^
-
-## [2.0.2](https://github.com/NaturalCycles/mysql-lib/compare/v2.0.1...v2.0.2) (2019-10-20)
-
-
-### Bug Fixes
-
-* adopt to db-lib ([6da7d78](https://github.com/NaturalCycles/mysql-lib/commit/6da7d78))
-
-## [2.0.1](https://github.com/NaturalCycles/mysql-lib/compare/v2.0.0...v2.0.1) (2019-10-19)
-
-
-### Bug Fixes
-
-* use Readable ([a0d09c1](https://github.com/NaturalCycles/mysql-lib/commit/a0d09c1))
-
-# [2.0.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.7.1...v2.0.0) (2019-10-18)
-
-
-### Features
-
-* implement CommonDB 2.0 ([9de0e9f](https://github.com/NaturalCycles/mysql-lib/commit/9de0e9f))
-
-
-### BREAKING CHANGES
-
-* ^^^
-
-## [1.7.1](https://github.com/NaturalCycles/mysql-lib/compare/v1.7.0...v1.7.1) (2019-10-18)
-
-
-### Bug Fixes
-
-* pin @types/hapi__joi ([3e3cf5a](https://github.com/NaturalCycles/mysql-lib/commit/3e3cf5a))
-
-# [1.7.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.6.0...v1.7.0) (2019-09-30)
-
-
-### Features
-
-* tiny change to use pool.query inst of getConnection() ([6ffe1b4](https://github.com/NaturalCycles/mysql-lib/commit/6ffe1b4))
-
-# [1.6.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.5.0...v1.6.0) (2019-09-30)
-
-
-### Features
-
-* offset ([78710a1](https://github.com/NaturalCycles/mysql-lib/commit/78710a1))
-
-# [1.5.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.4.0...v1.5.0) (2019-09-30)
-
-
-### Features
-
-* testing simpler streamSQL impl ([0887aa3](https://github.com/NaturalCycles/mysql-lib/commit/0887aa3))
-
-# [1.4.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.3.0...v1.4.0) (2019-09-30)
-
-
-### Features
-
-* stream to use it's own separate connection ([43615f3](https://github.com/NaturalCycles/mysql-lib/commit/43615f3))
-
-# [1.3.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.2.0...v1.3.0) (2019-09-30)
-
-
-### Features
-
-* cfg.debugConnections ([70218ba](https://github.com/NaturalCycles/mysql-lib/commit/70218ba))
-
-# [1.2.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.1.0...v1.2.0) (2019-09-28)
-
-
-### Features
-
-* add BIT cast to boolean ([899cce4](https://github.com/NaturalCycles/mysql-lib/commit/899cce4))
-
-# [1.1.0](https://github.com/NaturalCycles/mysql-lib/compare/v1.0.0...v1.1.0) (2019-09-21)
-
-
-### Features
-
-* modernize, implement saveBatch ([5595b6a](https://github.com/NaturalCycles/mysql-lib/commit/5595b6a))
-
-# 1.0.0 (2019-06-03)
-
-
-### Features
-
-* first version ([02620fb](https://github.com/NaturalCycles/mysql-lib/commit/02620fb))
-* init project by create-module ([eee50b7](https://github.com/NaturalCycles/mysql-lib/commit/eee50b7))