leoric 2.6.0 → 2.6.3

package/History.md

@@ -0,0 +1,760 @@
+2.6.3 / 2022-08-04
+==================
+
+## What's Changed
+* fix: aggregator not parse null result by @killagu in https://github.com/cyjake/leoric/pull/322
+* test: switch the auth protocol of test mysql database  by @cyjake in https://github.com/cyjake/leoric/pull/323
+* feat: add leoric_bone meta data to Bone by @JimmyDaddy in https://github.com/cyjake/leoric/pull/324
+* docs: fix declarations of findOne(primaryKey) & findOne({ $or }) by @cyjake in https://github.com/cyjake/leoric/pull/325
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.6.2...v2.6.3
+
+2.6.2 / 2022-07-12
+==================
+
+## What's Changed
+* fix: format select with out * if use aggreator by @killagu in https://github.com/cyjake/leoric/pull/320
+* fix: fix transaction typing by @killagu in https://github.com/cyjake/leoric/pull/321
+
+## New Contributors
+* @killagu made their first contribution in https://github.com/cyjake/leoric/pull/320
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.6.1...v2.6.2
+
+2.6.1 / 2022-06-24
+==================
+
+## What's Changed
+* build: switch to latest postgres by @cyjake in https://github.com/cyjake/leoric/pull/316
+* fix: fix [bug] init models with bone class should work #317 by @JimmyDaddy in https://github.com/cyjake/leoric/pull/318
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.6.0...v2.6.1
+
+2.6.0 / 2022-06-02
+==================
+
+## What's Changed
+* feat: support export sql query template in logger by @JimmyDaddy in https://github.com/cyjake/leoric/pull/314
+* fix: fix uncast date string without milliseconds error by jsCore in Android/iOS by @JimmyDaddy in https://github.com/cyjake/leoric/pull/315
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.5.0...v2.6.0
+
+2.5.0 / 2022-05-13
+==================
+
+## What's Changed
+* feat: support disconnect and fix timestamps init by @JimmyDaddy in https://github.com/cyjake/leoric/pull/313
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.4.1...v2.5.0
+
+2.4.1 / 2022-04-27
+==================
+
+## What's Changed
+* fix: realm.Bone.DataTypes should be invokable, Invokable.TYPE.toSqlString() get wrong default length(1), DataType definitions by @JimmyDaddy in https://github.com/cyjake/leoric/pull/307
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.4.0...v2.4.1
+
+2.4.0 / 2022-04-24
+==================
+
+## What's Changed
+* feat: support custom driver by @JimmyDaddy in https://github.com/cyjake/leoric/pull/304
+* chore: update build status badge by @snapre in https://github.com/cyjake/leoric/pull/305
+* feat: export more ts type definitions and  use deep-equal module by @JimmyDaddy in https://github.com/cyjake/leoric/pull/306
+
+## New Contributors
+* @snapre made their first contribution in https://github.com/cyjake/leoric/pull/305
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.3.2...v2.4.0
+
+2.3.2 / 2022-04-15
+==================
+
+## What's Changed
+* fix: order by raw with mix-type array in sequelize mode by @JimmyDaddy in https://github.com/cyjake/leoric/pull/298
+* docs: monthly updates and example about egg-orm usage with TypeScript by @cyjake in https://github.com/cyjake/leoric/pull/299
+* docs: monthly updates in en & docmentation about typescript support by @cyjake in https://github.com/cyjake/leoric/pull/300
+* fix: raw query should format replacements with extra blank by @JimmyDaddy in https://github.com/cyjake/leoric/pull/301
+* docs: elaborate on querying by @cyjake in https://github.com/cyjake/leoric/pull/302
+* feat: transaction should return result by @JimmyDaddy in https://github.com/cyjake/leoric/pull/303
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.3.1...v2.3.2
+
+2.3.1 / 2022-03-22
+==================
+
+## What's Changed
+* fix: mysql2 Invalid Date compatible by @JimmyDaddy in https://github.com/cyjake/leoric/pull/291
+* fix: order by raw in sequelize mode by @JimmyDaddy in https://github.com/cyjake/leoric/pull/292
+* fix: bulk update query conditions duplicated in sequelize mode by @JimmyDaddy in https://github.com/cyjake/leoric/pull/293
+* fix: bulk destroy query conditions duplicated in sequelize mode by @JimmyDaddy in https://github.com/cyjake/leoric/pull/295
+* fix: drop column if not defined in attributes when alter table by @cyjake in https://github.com/cyjake/leoric/pull/296
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.3.0...v2.3.1
+
+2.3.0 / 2022-03-10
+==================
+
+## What's Changed
+* feat: model declaration with decorators by @cyjake in https://github.com/cyjake/leoric/pull/287
+* feat: add VIRTUAL data type by @JimmyDaddy in https://github.com/cyjake/leoric/pull/289
+* fix: create instance dirty check rule fix by @JimmyDaddy in https://github.com/cyjake/leoric/pull/290
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.2.3...v2.3.0
+2.2.3 / 2022-03-01
+==================
+
+## What's Changed
+* fix: normalize attribute defaultValue by @cyjake in https://github.com/cyjake/leoric/pull/285
+* fix: instance beforeUpdate hooks should not modify any Raw if there are no Raw assignment in them by @JimmyDaddy in https://github.com/cyjake/leoric/pull/283
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.2.2...v2.2.3
+
+2.2.2 / 2022-02-28
+==================
+
+## What's Changed
+* fix: tddl gives misleading information_schema.columns.table_name by @cyjake in https://github.com/cyjake/leoric/pull/284
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.2.1...v2.2.2
+
+2.2.1 / 2022-02-24
+==================
+
+## What's Changed
+* fix: realm.DataTypes should be invokable by @cyjake in https://github.com/cyjake/leoric/pull/282
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.2.0...v2.2.1
+
+2.2.0 / 2022-02-24
+==================
+
+## What's Changed
+* fix: add missing `password` field for `ConnectOptions` by @luckydrq in https://github.com/cyjake/leoric/pull/280
+* feat: integer types (mostly mysql specific) by @cyjake in https://github.com/cyjake/leoric/pull/281
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.1.1...v2.2.0
+
+2.1.1 / 2022-02-23
+==================
+
+## What's Changed
+* fix: fix #274 update with fields option by @JimmyDaddy in https://github.com/cyjake/leoric/pull/275
+* fix:  upsert should set createdAt  by default while createdAt  not set  by @JimmyDaddy in https://github.com/cyjake/leoric/pull/277
+* fix: previousChanges should check instance is new record or not while specific attributes' values were undefined by @JimmyDaddy in https://github.com/cyjake/leoric/pull/276
+* docs: add types for realm by @luckydrq in https://github.com/cyjake/leoric/pull/278
+
+## New Contributors
+* @luckydrq made their first contribution in https://github.com/cyjake/leoric/pull/278
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.1.0...v2.1.1
+
+2.1.0 / 2022-02-17
+==================
+
+## What's Changed
+* feat: fix #270 sequelize mode bulkBuild by @JimmyDaddy in https://github.com/cyjake/leoric/pull/273
+* fix:  mysql delete/remove/destroy with limit and orders by @JimmyDaddy in https://github.com/cyjake/leoric/pull/272
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.0.4...v2.1.0
+
+2.0.4 / 2022-02-16
+==================
+
+## What's Changed
+* fix: fix unit test  error by @LB4027221 in https://github.com/cyjake/leoric/pull/269
+* fix: attribute.defaultValue should be set when init attributes by @cyjake in https://github.com/cyjake/leoric/pull/271
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.0.3...v2.0.4
+
+2.0.3 / 2022-02-11
+==================
+
+## What's Changed
+* fix: default updatedAt to new date if model has no createdAt by @LB4027221 in https://github.com/cyjake/leoric/pull/268
+
+## New Contributors
+* @LB4027221 made their first contribution in https://github.com/cyjake/leoric/pull/268
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.0.2...v2.0.3
+
+2.0.2 / 2022-02-10
+==================
+
+## What's Changed
+* fix: order by alias should not throw by @cyjake in https://github.com/cyjake/leoric/pull/255
+* fix: fix #257 DataType.uncast should skip Raw type at type checking by @JimmyDaddy in https://github.com/cyjake/leoric/pull/258
+* docs: async function in transaction by @cyjake in https://github.com/cyjake/leoric/pull/259
+* fix: fixed #256 static create instance should check all default attri… by @JimmyDaddy in https://github.com/cyjake/leoric/pull/262
+* fix: fix #260 UPDATE with LIMIT and ORDER should be formatted(mysql only) by @JimmyDaddy in https://github.com/cyjake/leoric/pull/261
+* refactor: keep the UPDATE ... ORDER BY ... LIMIT to mysql driver by @cyjake in https://github.com/cyjake/leoric/pull/264
+* fix: fix #263 upsert attributes should use defaultValue while there i… by @JimmyDaddy in https://github.com/cyjake/leoric/pull/265
+* fix: fix restore Error `Undefined attribute "deletedAt"` by @JimmyDaddy in https://github.com/cyjake/leoric/pull/267
+* fix: type checking adaption by @JimmyDaddy in https://github.com/cyjake/leoric/pull/266
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v2.0.1...v2.0.2
+
+2.0.1 / 2022-01-05
+==================
+
+## What's Changed
+* fix: format numeric result by @JimmyDaddy in https://github.com/cyjake/leoric/pull/253
+* fix: should still return number if value is '0.000' by @cyjake in https://github.com/cyjake/leoric/pull/254
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.15.1...v2.0.1
+
+2.0.0 / 2021-12-28
+==================
+
+## What's Changed
+* breaking: model.sync add force/alter option by @SmartOrange in https://github.com/cyjake/leoric/pull/224
+* breaking: logQueryError(err, sql, duration, options) by @cyjake in https://github.com/cyjake/leoric/pull/237
+* test: add utf8mb4 test cases by @fengmk2 in https://github.com/cyjake/leoric/pull/239
+* Merge 1.x changes by @cyjake in https://github.com/cyjake/leoric/pull/249
+
+## New Contributors
+* @SmartOrange made their first contribution in https://github.com/cyjake/leoric/pull/222
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.15.1...v2.0.0
+
+1.15.1 / 2021-12-28
+===================
+
+## What's Changed
+* fix: fix #242 date string format by @JimmyDaddy in https://github.com/cyjake/leoric/pull/243
+* fix: update with empty conditions by @JimmyDaddy in https://github.com/cyjake/leoric/pull/241
+* fix: silent option's priority should be lower than valueSet by @JimmyDaddy in https://github.com/cyjake/leoric/pull/244
+* fix: information_schema.columns.datetime_precision by @cyjake in https://github.com/cyjake/leoric/pull/246
+* fix: should not hoist subquery if query is ordered by external columns by @cyjake in https://github.com/cyjake/leoric/pull/247
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.15.0...v1.15.1
+
+1.15.0 / 2021-11-22
+===================
+
+## What's Changed
+* feat: make duration in precise milliseconds by @fengmk2 in https://github.com/cyjake/leoric/pull/236
+* fix: spell.increment() & spell.decrement() @cyjake https://github.com/cyjake/leoric/pull/234
+* fix: bulkCreate should adapte empty data @JimmyDaddy  https://github.com/cyjake/leoric/pull/232
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.14.4...v1.14.5
+
+1.14.4 / 2021-11-15
+===================
+
+## What's Changed
+
+* test: PostgreSQL v14 test case compatibility by @cyjake https://github.com/cyjake/leoric/pull/230
+* fix: turn off subquery optimization if query criteria contains other column by @cyjake https://github.com/cyjake/leoric/pull/229
+* fix: bone.changed() return `false | string[]` type by @fengmk2 https://github.com/cyjake/leoric/pull/231
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.14.3...v1.14.4
+
+1.14.3 / 2021-11-12
+===================
+
+## What's Changed
+* fix: logger.logQuery should be guarded in case of error by @SmartOrange in https://github.com/cyjake/leoric/pull/222
+* fix: findOne without result should return null by @JimmyDaddy in https://github.com/cyjake/leoric/pull/225
+* fix: Literal should support bigint type by @fengmk2 in https://github.com/cyjake/leoric/pull/226
+* fix: select((name: string) => boolean) by @cyjake in https://github.com/cyjake/leoric/pull/227
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.14.2...v1.14.3
+
+1.14.2 / 2021-11-01
+===================
+
+## What's Changed
+* fix: accept timestamps in snake case by @cyjake in https://github.com/cyjake/leoric/pull/221
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.14.1...v1.14.2
+
+1.14.1 / 2021-11-01
+===================
+
+## What's Changed
+* docs: export { Collection } by @cyjake in https://github.com/cyjake/leoric/pull/220
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.14.0...v1.14.1
+
+1.14.0 / 2021-11-01
+===================
+
+Two options regarding `Model.init()` were added in this release:
+
+```js
+class User extends Bone {}
+User.init({ name: STRING }, {
+  timestamps: true,  // which is the default
+  paranoid: true,    // which default to `false`
+});
+assert.deepEqual(Object.keys(User.attributes), [
+  'id',
+  'name',
+  'createdAt',
+  'updatedAt',
+  'deletedAt',
+]);
+```
+
+## What's Changed
+* docs: update 'primayKey' typos by @freshgum-bubbles in https://github.com/cyjake/leoric/pull/211
+* docs: DataTypes definitions in d.ts by @cyjake in https://github.com/cyjake/leoric/pull/210
+* fix: fix#209 sequelize mode should update all changed fields in instance update method by @JimmyDaddy in https://github.com/cyjake/leoric/pull/212
+* fix: fix #213 findAndCountAll should ignore attributes by @JimmyDaddy in https://github.com/cyjake/leoric/pull/214
+* fix: opts.connectTimeout by @cyjake in https://github.com/cyjake/leoric/pull/216
+* fix: reload instance with sharding key should not throw by @cyjake in https://github.com/cyjake/leoric/pull/217
+* feat: timestamps should be defined by default by @cyjake in https://github.com/cyjake/leoric/pull/218
+* fix: instance.reload() should not rely on `static findOne()` by @cyjake in https://github.com/cyjake/leoric/pull/219
+
+## New Contributors
+* @freshgum-bubbles made their first contribution in https://github.com/cyjake/leoric/pull/211
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.13.5...v1.14.0
+
+1.13.5 / 2021-10-26
+===================
+
+## What's Changed
+* docs: enhance aggregation query types & fix raw query result type by @cyjake in https://github.com/cyjake/leoric/pull/208
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.13.4...v1.13.5
+
+1.13.4 / 2021-10-25
+===================
+
+## What's Changed
+* docs: spell & model methods should be generic  by @cyjake in https://github.com/cyjake/leoric/pull/206
+* docs: enhance query options, instance type, and toJSON() result type by @cyjake in https://github.com/cyjake/leoric/pull/207
+
+This version brings correct (and hopefully better) typescript definitions, with the dts checked continuously at test/types tests. With this version, users that have model types correctly pinned at Bone will get code completion including class fields. Such as:
+
+![image](https://user-images.githubusercontent.com/252317/138683240-98ee9e79-4b3e-449c-bc95-a449d457d64f.png)
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.13.3...v1.13.4
+
+1.13.3 / 2021-10-21
+===================
+
+## What's Changed
+* refactor: persist edge cases of type casting in integration tests by @cyjake in https://github.com/cyjake/leoric/pull/202
+* docs: renaming attributes by @cyjake in https://github.com/cyjake/leoric/pull/203
+* fix: JSON.uncast(string) should not serialize twice by @cyjake in https://github.com/cyjake/leoric/pull/205
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.13.2...v1.13.3
+
+1.13.2 / 2021-10-18
+===================
+
+## What's Changed
+* fix: attribute.uncast([]) and realm.connect with synchronized models by @cyjake in https://github.com/cyjake/leoric/pull/201
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.13.1...v1.13.2
+
+1.13.1 / 2021-10-18
+===================
+
+## What's Changed
+* fix: skip connecting if models are synchronized already by @cyjake in https://github.com/cyjake/leoric/pull/200
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.13.0...v1.13.1
+
+1.13.0 / 2021-10-18
+===================
+
+## What's Changed
+* docs: monthly updates of 2021.09; support dark mode by @cyjake in https://github.com/cyjake/leoric/pull/196
+* feat: coerce literal values into accurate attribute type by @cyjake in https://github.com/cyjake/leoric/pull/197
+* fix: dispatched result should be in attribute names by @cyjake in https://github.com/cyjake/leoric/pull/198
+
+
+**Full Changelog**: https://github.com/cyjake/leoric/compare/v1.12.0...v1.13.0
+
+1.12.0 / 2021-10-12
+===================
+
+  * feat: support custom fields query and sequelize mode export rawAttributes (#192)
+  * refactor: collection format query result (#194)
+  * refactor: object condition parsing and expression formatting (#191)
+
+1.11.1 / 2021-09-28
+===================
+
+This version fixes lots of issues regarding logical operator in object conditions.
+
+  * fix: logical operator with multiple conditions such as (#190)
+  * fix: sequelize mode support HAVING, and select fields raw sql support (#187)
+  * fix: support len validator (#188)
+  * fix: normalize logical operator conditions before formatting with spellbook (#186)
+
+1.11.0 / 2021-09-24
+===================
+
+  * feat: support BINARY(length), VARBINARY(length), and BLOB (#169)
+  * fix: logic operate should adapt one argument (#183)
+  * fix: Bone.load() should be idempotent, make sure associations is intact (#184)
+  * fix: selected instance isNewRecord is false (#182)
+  * fix: set options.busyTimeout to mitigate SQLITE_BUSY (#176)
+  * fix: turn on long stack trace of sqlite driver (#175)
+  * docs: how to contribute (#180)
+
+1.10.0 / 2021-09-14
+===================
+
+  * feat: SQLite driver should emit "connection" event when new connection is created (#168)
+  * fix: bulkCreate(...records) should recognize custom setters (#168)
+  * fix: attribute.equals() check should ignore defaultValue (#172)
+
+1.9.0 / 2021-09-04
+==================
+
+> should've been a major release but since existing users have all migrated to the new api...
+
+  * breaking: drop the deprecated `Model.describe()` (#167)
+
+1.8.0 / 2021-08-30
+==================
+
+  * feat: silent option fix #164 (#165)
+  * feat: binary type (#166)
+
+1.7.1 / 2021-08-17
+==================
+
+  * revert: drop Driver#recycleConnections due to poor interoperability (#162)
+  * fix: validator call array arguments (#160)
+
+1.7.0 / 2021-08-17
+=================
+
+  * feat: close connections that exceeds opts.idleTimeout (#159)
+  * feat: `opts.connectionLimit` support for SQLite (#159)
+  * feat: raw query relpacements, closes #149 (#155)
+  * fix: upsert created_at default (#154)
+  * test: validator unit test (#157)
+  * test: setup_hooks unit test (#158)
+
+1.6.7 / 2021-08-05
+==================
+
+  * fix: prevent from calling Date.prototype.toJSON (#153)
+
+1.6.6 / 2021-07-22
+==================
+
+  * fix: subclassing data type in dialects (#145)
+  * fix: where('width / height >= 16 / 9') (#144)
+  * docs: logging and sequelzie adapter (zh) (#142)
+  * test: include test/unit/utils (#143)
+  * test: more tests cases about sequelize adapter (#141)
+
+1.6.5 / 2021-07-16
+==================
+
+  * fix: define assign Bone.models #140
+
+1.6.4 / 2021-07-16
+==================
+
+  * refactor: connect({ Bone }) still necessary (#139)
+  * fix: formatting select join with subqueries should not tamper the subquery itself (#138)
+  * fix: describe table with more compatible syntax (#137)
+
+1.6.3 / 2021-07-14
+==================
+
+  * fix: transaction option passing in sequelize adapter (#136)
+  * fix: this.Model and proper Model.describe() (#135)
+
+1.6.2 / 2021-07-09
+==================
+
+  * fix: convert datetime in seconds/milliseconds back to Date (#134)
+  * fix: renamed attribute should remain enumerable (#133)
+
+1.6.1 / 2021-07-07
+==================
+
+  * fix: collection convert should handle tddl results as well (#132)
+
+1.6.0 / 2021-07-06
+==================
+
+  * feat: support class static attributes and hooks (#131)
+  * fix: names defined in Bone.attributes should always be enumerable (#128)
+  * chore: add quality badge to readme (#129)
+
+1.5.2 / 2021-07-02
+==================
+
+  * fix: leave the getter properties defined in class syntax as is (#127)
+
+1.5.1 / 2021-06-30
+==================
+
+  * fix: export Logger and Spell to let users intercept lower level api calls (#126)
+
+1.5.0 / 2021-06-30
+==================
+
+  * feat: provide Bone.pool to be backward compatible with v0.x (#124)
+  * feat: complete bone/spine.restore and Bone API type definitions (#125)
+  * feat: support more data types (mediumtext, mediumint, char, date...) (#123)
+
+1.4.1 / 2021-06-25
+==================
+
+  * refactor: simplify legacy timestamps support (#120)
+  * refactor: do not subclass Bone unless asked specifically (#120)
+
+1.4.0 / 2021-06-24
+==================
+
+  * feat: `realm.raw('SELECT ...')` and `Model.raw('SELECT ...')` (#94)
+  * feat: support multiple order rules in one single string or one-dimensional array (#92)
+  * feat: `Model.truncate()` now uses TRUNCATE if possible
+  * feat: `Model.find().optimizerHints('SET_VAR(foreign_key_checks=OFF)')`
+  * fix: Bone.bulkCreate() should not throw when called with non attribute (#117)
+  * fix: batch upsert (#108)
+  * fix: make sure connection is passed around in all queries carried out within transaction (#105)
+  * fix: update, sequelize mode get API, destroy compitable (#104)
+  * fix: `setDataValue` in sequelize adapter should not check prop name strictly
+  * refactor: spell_insert (#118)
+  * docs: about egg-orm & migrations (#119)
+  * docs: revise instructions for installing Jekyll (#111)
+  * docs: migrations, validations, hooks, and sequelize adapter (#103)
+  * docs: contributing guides
+
+1.3.0 / 2021-03-01
+==================
+
+  * feat: hook support
+  * feat: dirty check (`changes()` & `previousChanges()`)
+  * feat: compatible with mysql longtext conversion
+  * feat: NOT condition
+
+1.2.0 / 2020-12-10
+==================
+
+  * feat: `Realm.prototype.transaction()` with async function support
+  * feat: `Realm.prototype.query()` for raw queries
+  * feat: `logger.logQuery(sql, duration, { Model, command })`
+  * feat: `logger.logQueryError(sql, err, duration, { Model, command })`
+
+1.1.0 / 2020-11-23
+==================
+
+  * feat: JSON and JSONB data types
+  * feat: support `stringifyObjects` option for mysql client
+  * feat: aggregate functions for sequelize adapter
+  * feat: `Spell.prototype.nodeify()`
+
+1.0.3 / 2020-03-16
+==================
+
+  * fix: replace `deep-equal` (which is bloated) with `util.isDeepStrictEqual`
+
+1.0.2 / 2020-03-04
+==================
+
+  * fix: driver.alterTable() with multiple columns to add in SQLite
+
+1.0.1 / 2020-02-25
+==================
+
+  * fix: bulkCreate in sequelize shim
+
+1.0.0 / 2020-02-24
+==================
+
+First major release. Let's get serious with semver.
+
+  * feat: logger.logQuery(sql, duration) & logger.logQueryError(sql, err)
+
+0.5.3 / 2020-02-22
+==================
+
+  * fix: `connect({ sequelize, dialect, client })` to allow mandatory sqlite client
+  * fix: prevent queries being performed unless model is correctly connected
+
+0.5.2 / 2020-02-21
+==================
+
+  * fix: drop the default and unused `require('sqlite3')`
+
+0.5.1 / 2020-02-21
+==================
+
+  * fix: `connect({ client: '@journeyapps/sqlcipher' })`
+
+0.5.0 / 2020-02-19
+==================
+
+  * feat: `Bone.sync()` to synchronize model with database
+  * feat: `Bone.createMigrationFile()` to create migration file
+  * feat: `Bone.migrate()` to run migrations
+  * feat: `Bone.bulkCreate()` to bulk insert records
+  * feat: `require('leoric')` now exports `Realm` to connect with multiple databases
+  * feat: `realm.define()` to define models in an old fashioned way
+  * feat: `realm.connect()` to connect with database
+  * feat: SQLite support without hacking node-sqlite3
+  * feat: `Bone.DataTypes` for type references
+  * feat: `Bone.init()` to initialize models
+  * feat: an adaptor to use Leoric in (partially) Sequelize complaint API
+  * refactor: a complete re-write of JOIN queries
+  * refactor: added `Bone.driver` to better encapsulate and planish database nuances
+
+0.4.5 / 2019-12-14
+==================
+
+  * fix: prevent primary key from being overridden with incorrect `LAST_INSERT_ID()`
+
+0.4.4 / 2019-07-15
+==================
+
+  * fix: append default scope when declaring relations, fixes #10
+
+0.4.3 / 2019-05-09
+==================
+
+  * fix: prevent Bone.dispatch from creating duplicated records of main table
+
+0.4.2 / 2019-04-26
+==================
+
+  * feat: `Spell#orWhere()` and `Spell#orHaving()`
+  * feat: arithmetic operators
+  * feat: unary operators such as unary minus `-` and bit invertion `~`
+  * fix: unset attribute should be overwritable
+  * fix: `attributeChanged()` should be false if attribute is unset and not overwritten
+  * fix: subclass with incomplete getter/setter should be complemented
+  * fix: sharding key validation on `Bone.update()` and `Bone.save()`
+  * fix: sharding key should be along with primary key on `bone.remove()`
+  * fix: `Bone.cast()` should leave `null` as is
+  * fix: `INSERT ... UPDATE` with `id = LAST_INSERT_ID(id)` in MySQL
+  * fix: `Model.find({ name: { $op1, $op2 } })` object conditions with multiple operators
+  * fix: prefixing result set with qualifiers if query contains join relations and is not dispatchable
+  * fix: `Spell#$get(index)` with LIMIT
+  * doc: `Model.transaction()`
+  * doc: definition types with `index.d.ts`
+
+0.4.1 / 2019-03-21
+==================
+
+  * feat: premature sharding key validation
+  * fix: output complete SQL instead of parameterized query with values.
+  * fix: both `connect({ model })` and `connect({ models })` are allowed.
+  * doc: no more `.findOrCreate()`, just `.upsert()`
+  * doc: table of contents with kramdown's `{:toc}`
+  * chore: droped experimental sqlite3 support
+
+0.4.0 / 2018-11-05
+==================
+
+  * feat: PostgreSQL support
+  * feat: Transaction support
+  * upgrade: (forked) SQLite client updated to SQLite 3.24
+
+
+0.3.0 / 2018-10-31
+==================
+
+ * feat: SQLite support with a [forked sqlite3](https://github.com/cyjake/node-sqlite3)
+ * feat: mysql2 support (which is trivial since both mysql and mysql2 share the same API)
+ * refactor: Spell now formats SQL with the literals separated, which gets escaped by the corresponding client itself later on.
+
+0.2.0 / 2018-01-03
+==================
+
+ * breaking: renaming
+
+0.1.8 / 2017-12-31
+==================
+
+ * fix: implement `query.batch()` as async iterator
+ * fix: `NOT (expr)`
+ * fix: `IFNULL(foo, default)`
+ * fix: support `.select(name[])`, `.select(name => {})`, and `.select("...name")`
+ * doc: `Model => className` in association options
+ * doc: use [jsdoc](http://usejsdoc.org) to generate docs/api
+ * doc: `.include()`
+
+0.1.7 / 2017-12-22
+==================
+
+ * refactor: `{ type: 'op', name: 'as' }` renamed to `{ type: 'alias' }`
+ * feat: `{ type: 'mod' }` for modifier, currently only `DISTINCT` is recognized
+ * feat: unary operators like `!` and `NOT`
+ * feat: `IS` and `IS NOT`
+ * fix: logic operator precendences
+ * fix: polymorphic hasMany({ through }) relations
+ * fix: dispatching multiple results with joins correctly
+
+0.1.6 / 2017-12-21
+==================
+
+ * feat: proper `.first`, `.last`, `.all`, and `.get(index)`
+ * fix: accept `Date`, `boolean`, and `Set` values
+ * fix: `Model.unscoped`
+ * fix: `Model.remove({}, true)` should be unscoped
+
+0.1.5 / 2017-12-20
+==================
+
+ * refactor: encapsulate column names. Keep them from the users even if the query results can not be dispatched.
+ * fix: complicated groups with joins should discard the use of subquery.
+ * fix: camelCase should replace globally
+ * fix: avoid missing attribtue exception when toJSON/toObject
+
+0.1.4 / 2017-12-18
+==================
+
+ * fix: should format condition arrays by hand instead of hand it over to formatExpr
+ * fix: whereConditions of subquery should retain the order of the whereConditions in major query
+ * fix: calculated columns should be kept in the final columns when sorting out the attributes
+ * fix: doesn't depend on co anymore
+
+0.1.3 / 2017-12-17
+==================
+
+ * fix: `select distict foo from table`;
+ * fix: `where (a = 1 or a = 2) and b = 3`;
+ * doc: a syntax table to provide a better glance over the querying ability.
+
+0.1.2 / 2017-12-14
+==================
+
+ * fix: copy left table's orders into subquery to make order/limit work when combined.
+ * fix: errors should be thrown when accessing attributes that weren't selected at the first place.
+
+0.1.1 / 2017-12-13
+==================
+
+ * refactor: automatic versioning on spells. When client calls query methods with chaining, new versions of spell gets duplicated. Makes reuse of spells possible.
+ * doc: english verion is almost complete <http://cyj.me/leoric>.
+
+0.1.0 / 2017-12-09
+==================
+
+ * Initial version, covers basic usage such as model authoring, database connection, query interface, and association.

package/index.js

@@ -14,6 +14,7 @@ const Realm = require('./src/realm');
 const Decorators = require('./src/decorators');
 const Raw = require('./src/raw');
 const { MysqlDriver, PostgresDriver, SqliteDriver, AbstractDriver } = require('./src/drivers');
+const { isBone } = require('./src/utils');
 
 /**
  * @typedef {Object} RawSql
@@ -64,6 +65,7 @@ Object.assign(Realm, {
   SqliteDriver,
   AbstractDriver,
   Raw,
+  isBone,
 });
 
 module.exports = Realm;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leoric",
-  "version": "2.6.0",
+  "version": "2.6.3",
   "description": "JavaScript Object-relational mapping alchemy",
   "main": "index.js",
   "types": "types/index.d.ts",

package/src/bone.js

@@ -21,6 +21,7 @@ const {
   LEGACY_TIMESTAMP_COLUMN_MAP,
   ASSOCIATE_METADATA_MAP,
   TIMESTAMP_ATTRIBUTE_NAMES,
+  IS_LEORIC_BONE,
 } = require('./constants');
 
 const columnAttributesKey = Symbol('leoric#columns');
@@ -1715,4 +1716,6 @@ for (const getter of Spell_getters) {
   });
 }
 
+Reflect.defineMetadata(IS_LEORIC_BONE, true, Bone);
+
 module.exports = Bone;

package/src/collection.js

@@ -1,8 +1,5 @@
 'use strict';
 
-const { AGGREGATOR_MAP } = require('./constants');
-
-const AGGREGATORS = Object.values(AGGREGATOR_MAP);
 /**
  * An extended Array to represent collections of models.
  */
@@ -92,11 +89,6 @@ function dispatch(spell, rows, fields) {
       const row = rows[0];
       const record = row && (row[''] || row[table]);
       const result = record && record[value];
-      // see https://www.w3schools.com/mysql/mysql_ref_functions.asp
-      if (AGGREGATORS.includes(args[0].name)) {
-        const num = Number(result);
-        return isNaN(num) ? result : num;
-      }
       return result;
     }
   }

package/src/constants.js

@@ -8,6 +8,8 @@ const AGGREGATOR_MAP = {
   sum: 'sum'
 };
 
+const AGGREGATORS = Object.values(AGGREGATOR_MAP);
+
 const LEGACY_TIMESTAMP_MAP = {
   gmtCreate: 'createdAt',
   gmtModified: 'updatedAt',
@@ -20,7 +22,7 @@ const LEGACY_TIMESTAMP_COLUMN_MAP = {
   deleted_at: 'gmt_deleted',
 };
 
-const TIMESTAMP_ATTRIBUTE_NAMES = [ 
+const TIMESTAMP_ATTRIBUTE_NAMES = [
   'createdAt', 'updatedAt', 'deletedAt',
   'gmtCreate', 'gmtModified', 'gmtDeleted',
   'created_at', 'updated_at', 'deleted_at',
@@ -34,11 +36,15 @@ const ASSOCIATE_METADATA_MAP = {
   belongsTo: Symbol('belongsTo'),
 };
 
+const IS_LEORIC_BONE = Symbol('leoric#bone');
+
 module.exports = {
   AGGREGATOR_MAP,
   LEGACY_TIMESTAMP_MAP,
   TIMESTAMP_NAMES,
   LEGACY_TIMESTAMP_COLUMN_MAP,
   ASSOCIATE_METADATA_MAP,
-  TIMESTAMP_ATTRIBUTE_NAMES
+  TIMESTAMP_ATTRIBUTE_NAMES,
+  AGGREGATORS,
+  IS_LEORIC_BONE,
 };

package/src/data_types.js

@@ -358,7 +358,8 @@ class DATE extends DataType {
     // @deprecated
     // vaguely standard date formats such as 2021-10-15 15:50:02,548
     if (typeof value === 'string' && rDateFormat.test(value)) {
-      // 2021-10-15 15:50:02,548 => 2021-10-15T15:50:02,548,  2021-10-15 15:50:02 => 2021-10-15T15:50:02.000
+      // 2021-10-15 15:50:02,548 => 2021-10-15T15:50:02,548,
+      // 2021-10-15 15:50:02 => 2021-10-15T15:50:02.000
       value = new Date(`${value.replace(' ', 'T').replace(',', '.')}`);
     }
 

package/src/drivers/abstract/spellbook.js

@@ -3,7 +3,7 @@
 const SqlString = require('sqlstring');
 
 const { copyExpr, findExpr, walkExpr } = require('../../expr');
-const { formatExpr, formatConditions, collectLiteral } = require('../../expr_formatter');
+const { formatExpr, formatConditions, collectLiteral, isAggregatorExpr } = require('../../expr_formatter');
 const Raw = require('../../raw');
 
 /**
@@ -91,10 +91,12 @@ function formatSelectExpr(spell, values) {
   const baseName = Model.tableAlias;
   const selects = new Set();
   const map = {};
+  let isAggregate = false;
 
   for (const token of columns) {
     collectLiteral(spell, token, values);
     const selectExpr = formatExpr(spell, token);
+    isAggregate = isAggregate || isAggregatorExpr(spell, token);
     const qualifier = token.qualifiers ? token.qualifiers[0] : '';
     const list = map[qualifier] || (map[qualifier] = []);
     list.push(selectExpr);
@@ -104,7 +106,7 @@ function formatSelectExpr(spell, values) {
     const list = map[qualifier];
     if (list) {
       for (const selectExpr of list) selects.add(selectExpr);
-    } else if (groups.length === 0 && Model.driver.type !== 'sqlite') {
+    } else if (groups.length === 0 && Model.driver.type !== 'sqlite' && !isAggregate) {
       selects.add(`${escapeId(qualifier)}.*`);
     }
   }
@@ -163,7 +165,7 @@ class SpellBook {
     const { escapeId } = Model.driver;
     let columns = [];
     let updateOnDuplicateColumns = [];
-  
+
     let values = [];
     let placeholders = [];
     if (Array.isArray(sets)) {
@@ -181,14 +183,14 @@ class SpellBook {
           columnAttributes.push(Model.columnAttributes[name]);
         }
       }
-  
+
       for (const entry of columnAttributes) {
         columns.push(entry.columnName);
-        if (updateOnDuplicate && createdAt && entry.name === createdAt 
+        if (updateOnDuplicate && createdAt && entry.name === createdAt
           && !(Array.isArray(updateOnDuplicate) && updateOnDuplicate.includes(createdAt))) continue;
         updateOnDuplicateColumns.push(entry.columnName);
       }
-  
+
       for (const entry of sets) {
         if (shardingKey && entry[shardingKey] == null) {
           throw new Error(`Sharding key ${Model.table}.${shardingKey} cannot be NULL.`);
@@ -199,7 +201,7 @@ class SpellBook {
         }
         placeholders.push(`(${new Array(columnAttributes.length).fill('?').join(',')})`);
       }
-  
+
     } else {
       if (shardingKey && sets[shardingKey] == null) {
         throw new Error(`Sharding key ${Model.table}.${shardingKey} cannot be NULL.`);
@@ -216,10 +218,10 @@ class SpellBook {
         updateOnDuplicateColumns.push(Model.unalias(name));
       }
     }
-  
-  
+
+
     const chunks = ['INSERT'];
-  
+
     // see https://dev.mysql.com/doc/refman/8.0/en/optimizer-hints.html
     const hintStr = this.formatOptimizerHints(spell);
     if (hintStr) {

package/src/drivers/mysql/index.js

@@ -50,6 +50,7 @@ class MysqlDriver extends AbstractDriver {
     const {
       host, port, user, password,
       connectTimeout, connectionLimit, charset, stringifyObjects = true,
+      decimalNumbers = true,
     } = opts;
 
     if (client !== 'mysql' && client !== 'mysql2') {
@@ -66,6 +67,7 @@ class MysqlDriver extends AbstractDriver {
       database,
       charset,
       stringifyObjects,
+      decimalNumbers,
     });
   }
 

package/src/drivers/postgres/index.js

@@ -5,7 +5,7 @@ const { performance } = require('perf_hooks');
 const AbstractDriver = require('../abstract');
 const Attribute = require('./attribute');
 const DataTypes = require('./data_types');
-const { 
+const {
   escape, escapeId, formatAddColumn,
   formatAlterColumns, formatDropColumn,
   cast, nest, parameterize,
@@ -36,6 +36,9 @@ class PostgresDriver extends AbstractDriver {
 
   createPool(opts) {
     const { host, port, user, password, database } = opts;
+    // dynamic require pg type parse
+    // if not use pg, pg-types may not exits
+    require('./type_parser');
     return new (require('pg')).Pool({ host, port, user, password, database });
   }
 

package/src/drivers/postgres/type_parser.js

@@ -0,0 +1,7 @@
+'use strict';
+
+const pgTypes = require('pg-types');
+
+pgTypes.setTypeParser(1700, 'text', function (val) {
+    return Number(val);
+});

package/src/expr_formatter.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const { precedes, walkExpr } = require('./expr');
+const { AGGREGATORS } = require('./constants');
 
 /**
  * Find model by qualifiers.
@@ -65,6 +66,31 @@ function formatLiteral(spell, ast) {
   return '?';
 }
 
+/**
+ * Format the abstract syntax tree of an expression into escaped string.
+ * @param {Spell}  spell
+ * @param {Object} ast
+ */
+function isAggregatorExpr(spell, ast) {
+  const { type, name, args } = ast;
+  switch (type) {
+    case 'literal':
+    case 'subquery':
+    case 'wildcard':
+    case 'mod':
+    case 'id':
+    case 'raw':
+    case 'op':
+      return false;
+    case 'alias':
+      return isAggregatorExpr(spell, args[0]);
+    case 'func':
+      return AGGREGATORS.includes(name);
+    default:
+      throw new Error(`Unexpected type ${type}`);
+  }
+}
+
 /**
  * Format the abstract syntax tree of an expression into escaped string.
  * @param {Spell}  spell
@@ -216,4 +242,4 @@ function coerceLiteral(spell, ast) {
   }
 }
 
-module.exports = { formatExpr, formatConditions, collectLiteral };
+module.exports = { formatExpr, formatConditions, collectLiteral, isAggregatorExpr };

package/src/realm.js

@@ -6,6 +6,7 @@ const path = require('path');
 const Bone = require('./bone');
 const { findDriver, AbstractDriver } = require('./drivers');
 const { camelCase } = require('./utils/string');
+const { isBone } = require('./utils');
 const sequelize = require('./adapters/sequelize');
 const Raw = require('./raw');
 const { LEGACY_TIMESTAMP_MAP } = require('./constants');
@@ -33,7 +34,7 @@ async function findModels(dir) {
     const extname = path.extname(entry.name);
     if (entry.isFile() && ['.js', '.mjs'].includes(extname)) {
       const model = require(path.join(dir, entry.name));
-      if (model.prototype instanceof Bone) models.push(model);
+      if (isBone(model)) models.push(model);
     }
   }
 
@@ -75,6 +76,10 @@ async function loadModels(Spine, models, opts) {
   const schemaInfo = await Spine.driver.querySchemaInfo(database, tables);
 
   for (const model of models) {
+    // assign driver if model's driver not exist
+    if (!model.driver) model.driver = Spine.driver;
+    // assign options if model's options not exist
+    if (!model.options) model.options = Spine.options;
     const columns = schemaInfo[model.physicTable] || schemaInfo[model.table];
     if (!model.attributes) initAttributes(model, columns);
     model.load(columns);

package/src/spell.js

@@ -15,8 +15,8 @@ const { AGGREGATOR_MAP } = require('./constants');
 
 /**
  * check condition to avoid use virtual fields as where condtions
- * @param {Bone} Model 
- * @param {Array<Object>} conds 
+ * @param {Bone} Model
+ * @param {Array<Object>} conds
  */
 function checkCond(Model, conds) {
   if (Array.isArray(conds)) {

package/src/utils/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const { performance } = require('perf_hooks');
+const { IS_LEORIC_BONE } = require('../constants');
 
 function isPlainObject(value) {
   return Object.prototype.toString.call(value) === '[object Object]';
@@ -43,10 +44,17 @@ const logger = {};
   };
 });
 
+function isBone(bone) {
+  if (!bone || (typeof bone !== 'object' && typeof bone !== 'function')) return false;
+  const metaValue = Reflect.getMetadata(IS_LEORIC_BONE, bone);
+  return metaValue === true;
+}
+
 module.exports = {
   isPlainObject,
   compose,
   getPropertyNames,
   calculateDuration,
   logger,
+  isBone,
 };

package/types/index.d.ts

@@ -160,6 +160,8 @@ type OperatorCondition = {
 
 type WhereConditions<T extends typeof Bone> = {
   [Property in keyof Extract<InstanceType<T>, Literal>]?: Literal | Literal[] | OperatorCondition;
+} | {
+  [key in '$and' | '$or']?: WhereConditions<T>[];
 }
 
 type Values<T extends typeof Bone> = {
@@ -205,6 +207,11 @@ interface QueryOptions {
   hooks?: boolean;
   paranoid?: boolean;
   silent?: boolean;
+  connection?: Connection;
+}
+
+interface TransactionOptions {
+  connection: Connection;
 }
 
 interface QueryResult {
@@ -214,7 +221,7 @@ interface QueryResult {
   fields?: Array<{ table: string, name: string }>,
 }
 
-interface Connection {
+export interface Connection {
   /**
    * MySQL
    */
@@ -322,10 +329,10 @@ declare class AbstractDriver {
    * @param callback
    */
   disconnect(callback?: Function): Promise<boolean | void>;
-  
+
   /**
    * query with spell
-   * @param spell 
+   * @param spell
    */
   cast(spell: Spell<typeof Bone, ResultSet | number | null>): Promise<QueryResult>;
 
@@ -424,7 +431,7 @@ declare class AbstractDriver {
    * remove index in table
    * @param table string
    * @param attributes attributes name
-   * @param opts 
+   * @param opts
    */
   removeIndex(table: string, attributes: string[], opts?: { unique?: boolean, type?: string }): Promise<void>;
 
@@ -574,6 +581,7 @@ export class Bone {
    */
   static find<T extends typeof Bone>(this: T, whereConditions: WhereConditions<T>): Spell<T, Collection<InstanceType<T>>>;
   static find<T extends typeof Bone>(this: T, whereConditions: string, ...values: Literal[]): Spell<T, Collection<InstanceType<T>>>;
+  static find<T extends typeof Bone>(this: T, primaryKey: number | number[]): Spell<T, Collection<InstanceType<T>>>;
   static find<T extends typeof Bone>(this: T, ): Spell<T, Collection<InstanceType<T>>>;
 
   /**
@@ -596,6 +604,7 @@ export class Bone {
    */
   static findOne<T extends typeof Bone>(this: T, whereConditions: WhereConditions<T>): Spell<T, InstanceType<T> | null>;
   static findOne<T extends typeof Bone>(this: T, whereConditions: string, ...values: Literal[]): Spell<T, InstanceType<T> | null>;
+  static findOne<T extends typeof Bone>(this: T, primaryKey: number | number[]): Spell<T, InstanceType<T> | null>;
   static findOne<T extends typeof Bone>(this: T, ): Spell<T, InstanceType<T> | null>;
 
   /**
@@ -695,7 +704,7 @@ export class Bone {
    * });
    */
   static transaction(callback: GeneratorFunction): Promise<RawQueryResult>;
-  static transaction(callback: (connection: Connection) => Promise<RawQueryResult>): Promise<RawQueryResult>;
+  static transaction(callback: (connection: TransactionOptions) => Promise<RawQueryResult | void>): Promise<RawQueryResult>;
 
   /**
    * DROP the table