knex 2.4.2 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/CHANGELOG.md +54 -18
  2. package/CONTRIBUTING.md +194 -194
  3. package/LICENSE +22 -22
  4. package/README.md +147 -148
  5. package/UPGRADING.md +233 -233
  6. package/bin/cli.js +473 -473
  7. package/bin/utils/cli-config-utils.js +210 -210
  8. package/bin/utils/constants.js +7 -7
  9. package/bin/utils/migrationsLister.js +37 -37
  10. package/knex.js +23 -23
  11. package/knex.mjs +11 -0
  12. package/lib/builder-interface-augmenter.js +120 -120
  13. package/lib/client.js +495 -475
  14. package/lib/constants.js +61 -61
  15. package/lib/dialects/better-sqlite3/index.js +77 -72
  16. package/lib/dialects/cockroachdb/crdb-columncompiler.js +14 -14
  17. package/lib/dialects/cockroachdb/crdb-querybuilder.js +11 -11
  18. package/lib/dialects/cockroachdb/crdb-querycompiler.js +122 -122
  19. package/lib/dialects/cockroachdb/crdb-tablecompiler.js +37 -37
  20. package/lib/dialects/cockroachdb/crdb-viewcompiler.js +15 -15
  21. package/lib/dialects/cockroachdb/index.js +86 -86
  22. package/lib/dialects/index.js +33 -33
  23. package/lib/dialects/mssql/index.js +500 -495
  24. package/lib/dialects/mssql/mssql-formatter.js +34 -34
  25. package/lib/dialects/mssql/query/mssql-querycompiler.js +601 -600
  26. package/lib/dialects/mssql/schema/mssql-columncompiler.js +185 -185
  27. package/lib/dialects/mssql/schema/mssql-compiler.js +91 -91
  28. package/lib/dialects/mssql/schema/mssql-tablecompiler.js +378 -378
  29. package/lib/dialects/mssql/schema/mssql-viewcompiler.js +55 -55
  30. package/lib/dialects/mssql/transaction.js +176 -176
  31. package/lib/dialects/mysql/index.js +201 -201
  32. package/lib/dialects/mysql/query/mysql-querycompiler.js +274 -274
  33. package/lib/dialects/mysql/schema/mysql-columncompiler.js +193 -193
  34. package/lib/dialects/mysql/schema/mysql-compiler.js +60 -60
  35. package/lib/dialects/mysql/schema/mysql-tablecompiler.js +381 -381
  36. package/lib/dialects/mysql/schema/mysql-viewbuilder.js +21 -21
  37. package/lib/dialects/mysql/schema/mysql-viewcompiler.js +15 -15
  38. package/lib/dialects/mysql/transaction.js +46 -46
  39. package/lib/dialects/mysql2/index.js +53 -33
  40. package/lib/dialects/mysql2/transaction.js +44 -44
  41. package/lib/dialects/oracle/DEAD_CODE.md +5 -5
  42. package/lib/dialects/oracle/index.js +92 -92
  43. package/lib/dialects/oracle/query/oracle-querycompiler.js +343 -342
  44. package/lib/dialects/oracle/schema/internal/incrementUtils.js +20 -20
  45. package/lib/dialects/oracle/schema/internal/trigger.js +135 -135
  46. package/lib/dialects/oracle/schema/oracle-columnbuilder.js +17 -17
  47. package/lib/dialects/oracle/schema/oracle-columncompiler.js +126 -126
  48. package/lib/dialects/oracle/schema/oracle-compiler.js +122 -122
  49. package/lib/dialects/oracle/schema/oracle-tablecompiler.js +190 -190
  50. package/lib/dialects/oracle/utils.js +87 -87
  51. package/lib/dialects/oracledb/index.js +327 -327
  52. package/lib/dialects/oracledb/query/oracledb-querycompiler.js +481 -481
  53. package/lib/dialects/oracledb/schema/oracledb-columncompiler.js +61 -55
  54. package/lib/dialects/oracledb/schema/oracledb-tablecompiler.js +19 -19
  55. package/lib/dialects/oracledb/schema/oracledb-viewbuilder.js +13 -13
  56. package/lib/dialects/oracledb/schema/oracledb-viewcompiler.js +19 -19
  57. package/lib/dialects/oracledb/transaction.js +98 -98
  58. package/lib/dialects/oracledb/utils.js +208 -208
  59. package/lib/dialects/pgnative/index.js +60 -60
  60. package/lib/dialects/postgres/execution/pg-transaction.js +19 -12
  61. package/lib/dialects/postgres/index.js +358 -358
  62. package/lib/dialects/postgres/query/pg-querybuilder.js +43 -38
  63. package/lib/dialects/postgres/query/pg-querycompiler.js +400 -395
  64. package/lib/dialects/postgres/schema/pg-columncompiler.js +156 -156
  65. package/lib/dialects/postgres/schema/pg-compiler.js +138 -138
  66. package/lib/dialects/postgres/schema/pg-tablecompiler.js +304 -299
  67. package/lib/dialects/postgres/schema/pg-viewbuilder.js +21 -21
  68. package/lib/dialects/postgres/schema/pg-viewcompiler.js +35 -35
  69. package/lib/dialects/redshift/index.js +86 -86
  70. package/lib/dialects/redshift/query/redshift-querycompiler.js +163 -163
  71. package/lib/dialects/redshift/schema/redshift-columnbuilder.js +22 -22
  72. package/lib/dialects/redshift/schema/redshift-columncompiler.js +67 -67
  73. package/lib/dialects/redshift/schema/redshift-compiler.js +14 -14
  74. package/lib/dialects/redshift/schema/redshift-tablecompiler.js +122 -122
  75. package/lib/dialects/redshift/schema/redshift-viewcompiler.js +11 -11
  76. package/lib/dialects/redshift/transaction.js +32 -25
  77. package/lib/dialects/sqlite3/execution/sqlite-transaction.js +25 -18
  78. package/lib/dialects/sqlite3/index.js +250 -250
  79. package/lib/dialects/sqlite3/query/sqlite-querybuilder.js +33 -33
  80. package/lib/dialects/sqlite3/query/sqlite-querycompiler.js +334 -334
  81. package/lib/dialects/sqlite3/schema/ddl.js +400 -400
  82. package/lib/dialects/sqlite3/schema/internal/compiler.js +327 -327
  83. package/lib/dialects/sqlite3/schema/internal/parser-combinator.js +161 -161
  84. package/lib/dialects/sqlite3/schema/internal/parser.js +638 -638
  85. package/lib/dialects/sqlite3/schema/internal/sqlite-ddl-operations.js +41 -41
  86. package/lib/dialects/sqlite3/schema/internal/tokenizer.js +38 -38
  87. package/lib/dialects/sqlite3/schema/internal/utils.js +12 -12
  88. package/lib/dialects/sqlite3/schema/sqlite-columncompiler.js +50 -50
  89. package/lib/dialects/sqlite3/schema/sqlite-compiler.js +80 -80
  90. package/lib/dialects/sqlite3/schema/sqlite-tablecompiler.js +347 -347
  91. package/lib/dialects/sqlite3/schema/sqlite-viewcompiler.js +40 -40
  92. package/lib/execution/batch-insert.js +51 -51
  93. package/lib/execution/internal/delay.js +6 -6
  94. package/lib/execution/internal/ensure-connection-callback.js +41 -41
  95. package/lib/execution/internal/query-executioner.js +62 -62
  96. package/lib/execution/runner.js +325 -307
  97. package/lib/execution/transaction.js +409 -401
  98. package/lib/formatter/formatterUtils.js +42 -42
  99. package/lib/formatter/rawFormatter.js +84 -84
  100. package/lib/formatter/wrappingFormatter.js +250 -250
  101. package/lib/formatter.js +25 -25
  102. package/lib/index.js +3 -3
  103. package/lib/knex-builder/FunctionHelper.js +80 -54
  104. package/lib/knex-builder/Knex.js +59 -59
  105. package/lib/knex-builder/internal/config-resolver.js +57 -57
  106. package/lib/knex-builder/internal/parse-connection.js +87 -87
  107. package/lib/knex-builder/make-knex.js +345 -340
  108. package/lib/logger.js +76 -76
  109. package/lib/migrations/common/MigrationsLoader.js +36 -36
  110. package/lib/migrations/migrate/MigrationGenerator.js +84 -84
  111. package/lib/migrations/migrate/Migrator.js +598 -598
  112. package/lib/migrations/migrate/migrate-stub.js +17 -17
  113. package/lib/migrations/migrate/migration-list-resolver.js +33 -33
  114. package/lib/migrations/migrate/migrator-configuration-merger.js +58 -58
  115. package/lib/migrations/migrate/sources/fs-migrations.js +74 -74
  116. package/lib/migrations/migrate/stub/cjs.stub +15 -15
  117. package/lib/migrations/migrate/stub/coffee.stub +13 -13
  118. package/lib/migrations/migrate/stub/eg.stub +14 -14
  119. package/lib/migrations/migrate/stub/js-schema.stub +22 -22
  120. package/lib/migrations/migrate/stub/js.stub +22 -22
  121. package/lib/migrations/migrate/stub/knexfile-coffee.stub +34 -34
  122. package/lib/migrations/migrate/stub/knexfile-eg.stub +43 -43
  123. package/lib/migrations/migrate/stub/knexfile-js.stub +47 -47
  124. package/lib/migrations/migrate/stub/knexfile-ls.stub +35 -35
  125. package/lib/migrations/migrate/stub/knexfile-ts.stub +47 -47
  126. package/lib/migrations/migrate/stub/ls.stub +14 -14
  127. package/lib/migrations/migrate/stub/mjs.stub +23 -23
  128. package/lib/migrations/migrate/stub/ts-schema.stub +21 -21
  129. package/lib/migrations/migrate/stub/ts.stub +21 -21
  130. package/lib/migrations/migrate/table-creator.js +77 -77
  131. package/lib/migrations/migrate/table-resolver.js +27 -27
  132. package/lib/migrations/seed/Seeder.js +137 -137
  133. package/lib/migrations/seed/seed-stub.js +13 -13
  134. package/lib/migrations/seed/seeder-configuration-merger.js +60 -60
  135. package/lib/migrations/seed/sources/fs-seeds.js +65 -65
  136. package/lib/migrations/seed/stub/coffee.stub +9 -9
  137. package/lib/migrations/seed/stub/eg.stub +11 -11
  138. package/lib/migrations/seed/stub/js.stub +13 -13
  139. package/lib/migrations/seed/stub/ls.stub +11 -11
  140. package/lib/migrations/seed/stub/mjs.stub +12 -12
  141. package/lib/migrations/seed/stub/ts.stub +13 -13
  142. package/lib/migrations/util/fs.js +86 -86
  143. package/lib/migrations/util/import-file.js +12 -12
  144. package/lib/migrations/util/is-module-type.js +9 -9
  145. package/lib/migrations/util/template.js +52 -52
  146. package/lib/migrations/util/timestamp.js +14 -14
  147. package/lib/query/analytic.js +52 -52
  148. package/lib/query/constants.js +15 -15
  149. package/lib/query/joinclause.js +270 -270
  150. package/lib/query/method-constants.js +136 -135
  151. package/lib/query/querybuilder.js +1793 -1794
  152. package/lib/query/querycompiler.js +1591 -1580
  153. package/lib/raw.js +139 -139
  154. package/lib/ref.js +39 -39
  155. package/lib/schema/builder.js +115 -115
  156. package/lib/schema/columnbuilder.js +146 -146
  157. package/lib/schema/columncompiler.js +307 -307
  158. package/lib/schema/compiler.js +187 -187
  159. package/lib/schema/internal/helpers.js +55 -55
  160. package/lib/schema/tablebuilder.js +376 -376
  161. package/lib/schema/tablecompiler.js +433 -433
  162. package/lib/schema/viewbuilder.js +92 -92
  163. package/lib/schema/viewcompiler.js +138 -138
  164. package/lib/util/finally-mixin.js +13 -13
  165. package/lib/util/helpers.js +95 -95
  166. package/lib/util/is.js +32 -32
  167. package/lib/util/nanoid.js +40 -40
  168. package/lib/util/noop.js +1 -1
  169. package/lib/util/save-async-stack.js +14 -14
  170. package/lib/util/security.js +26 -0
  171. package/lib/util/string.js +190 -190
  172. package/lib/util/timeout.js +29 -29
  173. package/package.json +12 -10
  174. package/scripts/build.js +125 -125
  175. package/scripts/clean.js +31 -31
  176. package/scripts/docker-compose.yml +152 -152
  177. package/scripts/next-release-howto.md +24 -24
  178. package/scripts/oracledb-install-driver-libs.sh +82 -82
  179. package/scripts/release.sh +34 -34
  180. package/scripts/runkit-example.js +34 -34
  181. package/scripts/stress-test/README.txt +18 -18
  182. package/scripts/stress-test/docker-compose.yml +57 -57
  183. package/scripts/stress-test/knex-stress-test.js +208 -208
  184. package/scripts/stress-test/mysql2-random-hanging-every-now-and-then.js +145 -145
  185. package/scripts/stress-test/mysql2-sudden-exit-without-error.js +100 -100
  186. package/scripts/stress-test/reconnect-test-mysql-based-drivers.js +184 -184
  187. package/scripts/update_gitignore_for_tsc_output.js +90 -90
  188. package/types/index.d.ts +3273 -3233
  189. package/types/result.d.ts +27 -27
  190. package/types/tables.d.ts +4 -4
package/lib/query/method-constants.js CHANGED
@@ -1,135 +1,136 @@
1
- // All properties we can use to start a query chain
2
- // from the `knex` object, e.g. `knex.select('*').from(...`
3
- module.exports = [
4
- 'with',
5
- 'withRecursive',
6
- 'withMaterialized',
7
- 'withNotMaterialized',
8
- 'select',
9
- 'as',
10
- 'columns',
11
- 'column',
12
- 'from',
13
- 'fromJS',
14
- 'fromRaw',
15
- 'into',
16
- 'withSchema',
17
- 'table',
18
- 'distinct',
19
- 'join',
20
- 'joinRaw',
21
- 'innerJoin',
22
- 'leftJoin',
23
- 'leftOuterJoin',
24
- 'rightJoin',
25
- 'rightOuterJoin',
26
- 'outerJoin',
27
- 'fullOuterJoin',
28
- 'crossJoin',
29
- 'where',
30
- 'andWhere',
31
- 'orWhere',
32
- 'whereNot',
33
- 'orWhereNot',
34
- 'whereLike',
35
- 'andWhereLike',
36
- 'orWhereLike',
37
- 'whereILike',
38
- 'andWhereILike',
39
- 'orWhereILike',
40
- 'whereRaw',
41
- 'whereWrapped',
42
- 'havingWrapped',
43
- 'orWhereRaw',
44
- 'whereExists',
45
- 'orWhereExists',
46
- 'whereNotExists',
47
- 'orWhereNotExists',
48
- 'whereIn',
49
- 'orWhereIn',
50
- 'whereNotIn',
51
- 'orWhereNotIn',
52
- 'whereNull',
53
- 'orWhereNull',
54
- 'whereNotNull',
55
- 'orWhereNotNull',
56
- 'whereBetween',
57
- 'whereNotBetween',
58
- 'andWhereBetween',
59
- 'andWhereNotBetween',
60
- 'orWhereBetween',
61
- 'orWhereNotBetween',
62
- 'groupBy',
63
- 'groupByRaw',
64
- 'orderBy',
65
- 'orderByRaw',
66
- 'union',
67
- 'unionAll',
68
- 'intersect',
69
- 'having',
70
- 'havingRaw',
71
- 'orHaving',
72
- 'orHavingRaw',
73
- 'offset',
74
- 'limit',
75
- 'count',
76
- 'countDistinct',
77
- 'min',
78
- 'max',
79
- 'sum',
80
- 'sumDistinct',
81
- 'avg',
82
- 'avgDistinct',
83
- 'increment',
84
- 'decrement',
85
- 'first',
86
- 'debug',
87
- 'pluck',
88
- 'clearSelect',
89
- 'clearWhere',
90
- 'clearGroup',
91
- 'clearOrder',
92
- 'clearHaving',
93
- 'insert',
94
- 'update',
95
- 'returning',
96
- 'del',
97
- 'delete',
98
- 'truncate',
99
- 'transacting',
100
- 'connection',
101
-
102
- // JSON methods
103
-
104
- // Json manipulation functions
105
- 'jsonExtract',
106
- 'jsonSet',
107
- 'jsonInsert',
108
- 'jsonRemove',
109
-
110
- // Wheres Json
111
- 'whereJsonObject',
112
- 'orWhereJsonObject',
113
- 'andWhereJsonObject',
114
- 'whereNotJsonObject',
115
- 'orWhereNotJsonObject',
116
- 'andWhereNotJsonObject',
117
-
118
- 'whereJsonPath',
119
- 'orWhereJsonPath',
120
- 'andWhereJsonPath',
121
-
122
- 'whereJsonSupersetOf',
123
- 'orWhereJsonSupersetOf',
124
- 'andWhereJsonSupersetOf',
125
- 'whereJsonNotSupersetOf',
126
- 'orWhereJsonNotSupersetOf',
127
- 'andWhereJsonNotSupersetOf',
128
-
129
- 'whereJsonSubsetOf',
130
- 'orWhereJsonSubsetOf',
131
- 'andWhereJsonSubsetOf',
132
- 'whereJsonNotSubsetOf',
133
- 'orWhereJsonNotSubsetOf',
134
- 'andWhereJsonNotSubsetOf',
135
- ];
1
+ // All properties we can use to start a query chain
2
+ // from the `knex` object, e.g. `knex.select('*').from(...`
3
+ module.exports = [
4
+ 'with',
5
+ 'withRecursive',
6
+ 'withMaterialized',
7
+ 'withNotMaterialized',
8
+ 'select',
9
+ 'as',
10
+ 'columns',
11
+ 'column',
12
+ 'from',
13
+ 'fromJS',
14
+ 'fromRaw',
15
+ 'into',
16
+ 'withSchema',
17
+ 'table',
18
+ 'distinct',
19
+ 'join',
20
+ 'joinRaw',
21
+ 'innerJoin',
22
+ 'leftJoin',
23
+ 'leftOuterJoin',
24
+ 'rightJoin',
25
+ 'rightOuterJoin',
26
+ 'outerJoin',
27
+ 'fullOuterJoin',
28
+ 'crossJoin',
29
+ 'where',
30
+ 'andWhere',
31
+ 'orWhere',
32
+ 'whereNot',
33
+ 'orWhereNot',
34
+ 'whereLike',
35
+ 'andWhereLike',
36
+ 'orWhereLike',
37
+ 'whereILike',
38
+ 'andWhereILike',
39
+ 'orWhereILike',
40
+ 'whereRaw',
41
+ 'whereWrapped',
42
+ 'havingWrapped',
43
+ 'orWhereRaw',
44
+ 'whereExists',
45
+ 'orWhereExists',
46
+ 'whereNotExists',
47
+ 'orWhereNotExists',
48
+ 'whereIn',
49
+ 'orWhereIn',
50
+ 'whereNotIn',
51
+ 'orWhereNotIn',
52
+ 'whereNull',
53
+ 'orWhereNull',
54
+ 'whereNotNull',
55
+ 'orWhereNotNull',
56
+ 'whereBetween',
57
+ 'whereNotBetween',
58
+ 'andWhereBetween',
59
+ 'andWhereNotBetween',
60
+ 'orWhereBetween',
61
+ 'orWhereNotBetween',
62
+ 'groupBy',
63
+ 'groupByRaw',
64
+ 'orderBy',
65
+ 'orderByRaw',
66
+ 'union',
67
+ 'unionAll',
68
+ 'intersect',
69
+ 'except',
70
+ 'having',
71
+ 'havingRaw',
72
+ 'orHaving',
73
+ 'orHavingRaw',
74
+ 'offset',
75
+ 'limit',
76
+ 'count',
77
+ 'countDistinct',
78
+ 'min',
79
+ 'max',
80
+ 'sum',
81
+ 'sumDistinct',
82
+ 'avg',
83
+ 'avgDistinct',
84
+ 'increment',
85
+ 'decrement',
86
+ 'first',
87
+ 'debug',
88
+ 'pluck',
89
+ 'clearSelect',
90
+ 'clearWhere',
91
+ 'clearGroup',
92
+ 'clearOrder',
93
+ 'clearHaving',
94
+ 'insert',
95
+ 'update',
96
+ 'returning',
97
+ 'del',
98
+ 'delete',
99
+ 'truncate',
100
+ 'transacting',
101
+ 'connection',
102
+
103
+ // JSON methods
104
+
105
+ // Json manipulation functions
106
+ 'jsonExtract',
107
+ 'jsonSet',
108
+ 'jsonInsert',
109
+ 'jsonRemove',
110
+
111
+ // Wheres Json
112
+ 'whereJsonObject',
113
+ 'orWhereJsonObject',
114
+ 'andWhereJsonObject',
115
+ 'whereNotJsonObject',
116
+ 'orWhereNotJsonObject',
117
+ 'andWhereNotJsonObject',
118
+
119
+ 'whereJsonPath',
120
+ 'orWhereJsonPath',
121
+ 'andWhereJsonPath',
122
+
123
+ 'whereJsonSupersetOf',
124
+ 'orWhereJsonSupersetOf',
125
+ 'andWhereJsonSupersetOf',
126
+ 'whereJsonNotSupersetOf',
127
+ 'orWhereJsonNotSupersetOf',
128
+ 'andWhereJsonNotSupersetOf',
129
+
130
+ 'whereJsonSubsetOf',
131
+ 'orWhereJsonSubsetOf',
132
+ 'andWhereJsonSubsetOf',
133
+ 'whereJsonNotSubsetOf',
134
+ 'orWhereJsonNotSubsetOf',
135
+ 'andWhereJsonNotSubsetOf',
136
+ ];