knex 0.21.20 → 0.21.21

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 (141) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/CONTRIBUTING.md +184 -184
  3. package/LICENSE +22 -22
  4. package/README.md +95 -95
  5. package/bin/cli.js +414 -414
  6. package/bin/utils/cli-config-utils.js +151 -151
  7. package/bin/utils/constants.js +7 -7
  8. package/bin/utils/migrationsLister.js +37 -37
  9. package/knex.js +8 -8
  10. package/lib/client.js +413 -413
  11. package/lib/config-resolver.js +61 -61
  12. package/lib/constants.js +44 -44
  13. package/lib/dialects/mssql/index.js +390 -390
  14. package/lib/dialects/mssql/query/compiler.js +444 -444
  15. package/lib/dialects/mssql/schema/columncompiler.js +103 -103
  16. package/lib/dialects/mssql/schema/compiler.js +59 -59
  17. package/lib/dialects/mssql/schema/tablecompiler.js +245 -245
  18. package/lib/dialects/mssql/transaction.js +97 -97
  19. package/lib/dialects/mysql/index.js +191 -191
  20. package/lib/dialects/mysql/query/compiler.js +142 -142
  21. package/lib/dialects/mysql/schema/columncompiler.js +171 -171
  22. package/lib/dialects/mysql/schema/compiler.js +60 -60
  23. package/lib/dialects/mysql/schema/tablecompiler.js +262 -262
  24. package/lib/dialects/mysql/transaction.js +48 -48
  25. package/lib/dialects/mysql2/index.js +35 -35
  26. package/lib/dialects/mysql2/transaction.js +46 -46
  27. package/lib/dialects/oracle/DEAD_CODE.md +5 -5
  28. package/lib/dialects/oracle/formatter.js +20 -20
  29. package/lib/dialects/oracle/index.js +79 -79
  30. package/lib/dialects/oracle/query/compiler.js +327 -327
  31. package/lib/dialects/oracle/schema/columnbuilder.js +18 -18
  32. package/lib/dialects/oracle/schema/columncompiler.js +139 -139
  33. package/lib/dialects/oracle/schema/compiler.js +81 -81
  34. package/lib/dialects/oracle/schema/tablecompiler.js +165 -165
  35. package/lib/dialects/oracle/schema/trigger.js +126 -126
  36. package/lib/dialects/oracle/utils.js +86 -86
  37. package/lib/dialects/oracledb/index.js +489 -489
  38. package/lib/dialects/oracledb/query/compiler.js +363 -363
  39. package/lib/dialects/oracledb/schema/columncompiler.js +35 -35
  40. package/lib/dialects/oracledb/transaction.js +76 -76
  41. package/lib/dialects/oracledb/utils.js +14 -14
  42. package/lib/dialects/postgres/index.js +319 -319
  43. package/lib/dialects/postgres/query/compiler.js +206 -206
  44. package/lib/dialects/postgres/schema/columncompiler.js +125 -125
  45. package/lib/dialects/postgres/schema/compiler.js +109 -109
  46. package/lib/dialects/postgres/schema/tablecompiler.js +183 -183
  47. package/lib/dialects/redshift/index.js +73 -73
  48. package/lib/dialects/redshift/query/compiler.js +119 -119
  49. package/lib/dialects/redshift/schema/columnbuilder.js +20 -20
  50. package/lib/dialects/redshift/schema/columncompiler.js +60 -60
  51. package/lib/dialects/redshift/schema/compiler.js +14 -14
  52. package/lib/dialects/redshift/schema/tablecompiler.js +123 -123
  53. package/lib/dialects/redshift/transaction.js +18 -18
  54. package/lib/dialects/sqlite3/formatter.js +21 -21
  55. package/lib/dialects/sqlite3/index.js +169 -169
  56. package/lib/dialects/sqlite3/query/compiler.js +222 -222
  57. package/lib/dialects/sqlite3/schema/columncompiler.js +27 -27
  58. package/lib/dialects/sqlite3/schema/compiler.js +49 -49
  59. package/lib/dialects/sqlite3/schema/ddl.js +525 -525
  60. package/lib/dialects/sqlite3/schema/tablecompiler.js +238 -238
  61. package/lib/formatter.js +295 -295
  62. package/lib/functionhelper.js +14 -14
  63. package/lib/helpers.js +92 -92
  64. package/lib/index.js +3 -3
  65. package/lib/interface.js +115 -115
  66. package/lib/knex.js +42 -42
  67. package/lib/logger.js +76 -76
  68. package/lib/migrate/MigrationGenerator.js +82 -82
  69. package/lib/migrate/Migrator.js +611 -611
  70. package/lib/migrate/configuration-merger.js +60 -60
  71. package/lib/migrate/migrate-stub.js +17 -17
  72. package/lib/migrate/migration-list-resolver.js +36 -36
  73. package/lib/migrate/sources/fs-migrations.js +99 -99
  74. package/lib/migrate/stub/cjs.stub +15 -15
  75. package/lib/migrate/stub/coffee.stub +13 -13
  76. package/lib/migrate/stub/eg.stub +14 -14
  77. package/lib/migrate/stub/js.stub +15 -15
  78. package/lib/migrate/stub/knexfile-coffee.stub +34 -34
  79. package/lib/migrate/stub/knexfile-eg.stub +43 -43
  80. package/lib/migrate/stub/knexfile-js.stub +44 -44
  81. package/lib/migrate/stub/knexfile-ls.stub +35 -35
  82. package/lib/migrate/stub/knexfile-ts.stub +44 -44
  83. package/lib/migrate/stub/ls.stub +14 -14
  84. package/lib/migrate/stub/ts.stub +21 -21
  85. package/lib/migrate/table-creator.js +67 -67
  86. package/lib/migrate/table-resolver.js +27 -27
  87. package/lib/query/builder.js +1372 -1372
  88. package/lib/query/compiler.js +889 -889
  89. package/lib/query/constants.js +13 -13
  90. package/lib/query/joinclause.js +263 -263
  91. package/lib/query/methods.js +92 -92
  92. package/lib/query/string.js +190 -190
  93. package/lib/raw.js +188 -188
  94. package/lib/ref.js +39 -39
  95. package/lib/runner.js +285 -285
  96. package/lib/schema/builder.js +82 -82
  97. package/lib/schema/columnbuilder.js +117 -117
  98. package/lib/schema/columncompiler.js +177 -177
  99. package/lib/schema/compiler.js +101 -101
  100. package/lib/schema/helpers.js +51 -51
  101. package/lib/schema/tablebuilder.js +288 -288
  102. package/lib/schema/tablecompiler.js +296 -296
  103. package/lib/seed/Seeder.js +203 -203
  104. package/lib/seed/seed-stub.js +13 -13
  105. package/lib/seed/stub/coffee.stub +9 -9
  106. package/lib/seed/stub/eg.stub +11 -11
  107. package/lib/seed/stub/js.stub +13 -13
  108. package/lib/seed/stub/ls.stub +11 -11
  109. package/lib/seed/stub/ts.stub +13 -13
  110. package/lib/transaction.js +363 -363
  111. package/lib/util/batchInsert.js +59 -59
  112. package/lib/util/delay.js +6 -6
  113. package/lib/util/fake-client.js +9 -9
  114. package/lib/util/finally-mixin.js +13 -13
  115. package/lib/util/fs.js +76 -76
  116. package/lib/util/import-file.js +13 -13
  117. package/lib/util/is-module-type.js +14 -14
  118. package/lib/util/is.js +32 -32
  119. package/lib/util/make-knex.js +338 -338
  120. package/lib/util/nanoid.js +29 -29
  121. package/lib/util/noop.js +1 -1
  122. package/lib/util/parse-connection.js +66 -66
  123. package/lib/util/save-async-stack.js +14 -14
  124. package/lib/util/template.js +52 -52
  125. package/lib/util/timeout.js +29 -29
  126. package/lib/util/timestamp.js +16 -16
  127. package/package.json +1 -1
  128. package/scripts/build.js +125 -125
  129. package/scripts/docker-compose.yml +111 -111
  130. package/scripts/next-release-howto.md +24 -24
  131. package/scripts/release.sh +34 -34
  132. package/scripts/runkit-example.js +34 -34
  133. package/scripts/stress-test/README.txt +18 -18
  134. package/scripts/stress-test/docker-compose.yml +47 -47
  135. package/scripts/stress-test/knex-stress-test.js +196 -196
  136. package/scripts/stress-test/mysql2-random-hanging-every-now-and-then.js +145 -145
  137. package/scripts/stress-test/mysql2-sudden-exit-without-error.js +100 -100
  138. package/scripts/stress-test/reconnect-test-mysql-based-drivers.js +184 -184
  139. package/types/index.d.ts +2249 -2249
  140. package/types/result.d.ts +27 -27
  141. package/types/tables.d.ts +4 -4
@@ -1,48 +1,48 @@
1
- const Transaction = require('../../transaction');
2
- const Debug = require('debug');
3
-
4
- const debug = Debug('knex:tx');
5
-
6
- class Transaction_MySQL extends Transaction {}
7
-
8
- Object.assign(Transaction_MySQL.prototype, {
9
- query(conn, sql, status, value) {
10
- const t = this;
11
- const q = this.trxClient
12
- .query(conn, sql)
13
- .catch((err) => {
14
- if (err.errno === 1305) {
15
- this.trxClient.logger.warn(
16
- 'Transaction was implicitly committed, do not mix transactions and ' +
17
- 'DDL with MySQL (#805)'
18
- );
19
- return;
20
- }
21
-
22
- status = 2;
23
- value = err;
24
- t._completed = true;
25
- debug('%s error running transaction query', t.txid);
26
- })
27
- .then(function (res) {
28
- if (status === 1) t._resolver(value);
29
- if (status === 2) {
30
- if (value === undefined) {
31
- if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
32
- t._resolver();
33
- return;
34
- }
35
- value = new Error(`Transaction rejected with non-error: ${value}`);
36
- }
37
- t._rejecter(value);
38
- }
39
- return res;
40
- });
41
- if (status === 1 || status === 2) {
42
- t._completed = true;
43
- }
44
- return q;
45
- },
46
- });
47
-
48
- module.exports = Transaction_MySQL;
1
+ const Transaction = require('../../transaction');
2
+ const Debug = require('debug');
3
+
4
+ const debug = Debug('knex:tx');
5
+
6
+ class Transaction_MySQL extends Transaction {}
7
+
8
+ Object.assign(Transaction_MySQL.prototype, {
9
+ query(conn, sql, status, value) {
10
+ const t = this;
11
+ const q = this.trxClient
12
+ .query(conn, sql)
13
+ .catch((err) => {
14
+ if (err.errno === 1305) {
15
+ this.trxClient.logger.warn(
16
+ 'Transaction was implicitly committed, do not mix transactions and ' +
17
+ 'DDL with MySQL (#805)'
18
+ );
19
+ return;
20
+ }
21
+
22
+ status = 2;
23
+ value = err;
24
+ t._completed = true;
25
+ debug('%s error running transaction query', t.txid);
26
+ })
27
+ .then(function (res) {
28
+ if (status === 1) t._resolver(value);
29
+ if (status === 2) {
30
+ if (value === undefined) {
31
+ if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
32
+ t._resolver();
33
+ return;
34
+ }
35
+ value = new Error(`Transaction rejected with non-error: ${value}`);
36
+ }
37
+ t._rejecter(value);
38
+ }
39
+ return res;
40
+ });
41
+ if (status === 1 || status === 2) {
42
+ t._completed = true;
43
+ }
44
+ return q;
45
+ },
46
+ });
47
+
48
+ module.exports = Transaction_MySQL;
@@ -1,35 +1,35 @@
1
- // MySQL2 Client
2
- // -------
3
- const { inherits } = require('util');
4
- const Client_MySQL = require('../mysql');
5
- const Transaction = require('./transaction');
6
-
7
- // Always initialize with the "QueryBuilder" and "QueryCompiler"
8
- // objects, which extend the base 'lib/query/builder' and
9
- // 'lib/query/compiler', respectively.
10
- function Client_MySQL2(config) {
11
- Client_MySQL.call(this, config);
12
- }
13
- inherits(Client_MySQL2, Client_MySQL);
14
-
15
- Object.assign(Client_MySQL2.prototype, {
16
- // The "dialect", for reference elsewhere.
17
- driverName: 'mysql2',
18
-
19
- transaction() {
20
- return new Transaction(this, ...arguments);
21
- },
22
-
23
- _driver() {
24
- return require('mysql2');
25
- },
26
-
27
- validateConnection(connection) {
28
- if (connection._fatalError) {
29
- return false;
30
- }
31
- return true;
32
- },
33
- });
34
-
35
- module.exports = Client_MySQL2;
1
+ // MySQL2 Client
2
+ // -------
3
+ const { inherits } = require('util');
4
+ const Client_MySQL = require('../mysql');
5
+ const Transaction = require('./transaction');
6
+
7
+ // Always initialize with the "QueryBuilder" and "QueryCompiler"
8
+ // objects, which extend the base 'lib/query/builder' and
9
+ // 'lib/query/compiler', respectively.
10
+ function Client_MySQL2(config) {
11
+ Client_MySQL.call(this, config);
12
+ }
13
+ inherits(Client_MySQL2, Client_MySQL);
14
+
15
+ Object.assign(Client_MySQL2.prototype, {
16
+ // The "dialect", for reference elsewhere.
17
+ driverName: 'mysql2',
18
+
19
+ transaction() {
20
+ return new Transaction(this, ...arguments);
21
+ },
22
+
23
+ _driver() {
24
+ return require('mysql2');
25
+ },
26
+
27
+ validateConnection(connection) {
28
+ if (connection._fatalError) {
29
+ return false;
30
+ }
31
+ return true;
32
+ },
33
+ });
34
+
35
+ module.exports = Client_MySQL2;
@@ -1,46 +1,46 @@
1
- const Transaction = require('../../transaction');
2
- const debug = require('debug')('knex:tx');
3
-
4
- class Transaction_MySQL2 extends Transaction {}
5
-
6
- Object.assign(Transaction_MySQL2.prototype, {
7
- query(conn, sql, status, value) {
8
- const t = this;
9
- const q = this.trxClient
10
- .query(conn, sql)
11
- .catch((err) => {
12
- if (err.code === 'ER_SP_DOES_NOT_EXIST') {
13
- this.trxClient.logger.warn(
14
- 'Transaction was implicitly committed, do not mix transactions and ' +
15
- 'DDL with MySQL (#805)'
16
- );
17
- return;
18
- }
19
-
20
- status = 2;
21
- value = err;
22
- t._completed = true;
23
- debug('%s error running transaction query', t.txid);
24
- })
25
- .then(function (res) {
26
- if (status === 1) t._resolver(value);
27
- if (status === 2) {
28
- if (value === undefined) {
29
- if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
30
- t._resolver();
31
- return;
32
- }
33
- value = new Error(`Transaction rejected with non-error: ${value}`);
34
- }
35
- t._rejecter(value);
36
- return res;
37
- }
38
- });
39
- if (status === 1 || status === 2) {
40
- t._completed = true;
41
- }
42
- return q;
43
- },
44
- });
45
-
46
- module.exports = Transaction_MySQL2;
1
+ const Transaction = require('../../transaction');
2
+ const debug = require('debug')('knex:tx');
3
+
4
+ class Transaction_MySQL2 extends Transaction {}
5
+
6
+ Object.assign(Transaction_MySQL2.prototype, {
7
+ query(conn, sql, status, value) {
8
+ const t = this;
9
+ const q = this.trxClient
10
+ .query(conn, sql)
11
+ .catch((err) => {
12
+ if (err.code === 'ER_SP_DOES_NOT_EXIST') {
13
+ this.trxClient.logger.warn(
14
+ 'Transaction was implicitly committed, do not mix transactions and ' +
15
+ 'DDL with MySQL (#805)'
16
+ );
17
+ return;
18
+ }
19
+
20
+ status = 2;
21
+ value = err;
22
+ t._completed = true;
23
+ debug('%s error running transaction query', t.txid);
24
+ })
25
+ .then(function (res) {
26
+ if (status === 1) t._resolver(value);
27
+ if (status === 2) {
28
+ if (value === undefined) {
29
+ if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
30
+ t._resolver();
31
+ return;
32
+ }
33
+ value = new Error(`Transaction rejected with non-error: ${value}`);
34
+ }
35
+ t._rejecter(value);
36
+ return res;
37
+ }
38
+ });
39
+ if (status === 1 || status === 2) {
40
+ t._completed = true;
41
+ }
42
+ return q;
43
+ },
44
+ });
45
+
46
+ module.exports = Transaction_MySQL2;
@@ -1,5 +1,5 @@
1
- # Warning: Dead Code #
2
-
3
- The `oracle` dialect is mostly dead code at this point. However, a handful of its methods are still referenced by the `oracledb` dialect. So, we are in the process of migrating those methods over to the `oracledb` dialect where they belong. Once that task is completed, we will officially remove the `oracle` dialect.
4
-
5
- In short: do not use the `oracle` dialect. Use the `oracledb` dialect instead.
1
+ # Warning: Dead Code #
2
+
3
+ The `oracle` dialect is mostly dead code at this point. However, a handful of its methods are still referenced by the `oracledb` dialect. So, we are in the process of migrating those methods over to the `oracledb` dialect where they belong. Once that task is completed, we will officially remove the `oracle` dialect.
4
+
5
+ In short: do not use the `oracle` dialect. Use the `oracledb` dialect instead.
@@ -1,20 +1,20 @@
1
- const Formatter = require('../../formatter');
2
- const { ReturningHelper } = require('./utils');
3
-
4
- class Oracle_Formatter extends Formatter {
5
- alias(first, second) {
6
- return first + ' ' + second;
7
- }
8
-
9
- parameter(value, notSetValue) {
10
- // Returning helper uses always ROWID as string
11
- if (value instanceof ReturningHelper && this.client.driver) {
12
- value = new this.client.driver.OutParam(this.client.driver.OCCISTRING);
13
- } else if (typeof value === 'boolean') {
14
- value = value ? 1 : 0;
15
- }
16
- return super.parameter(value, notSetValue);
17
- }
18
- }
19
-
20
- module.exports = Oracle_Formatter;
1
+ const Formatter = require('../../formatter');
2
+ const { ReturningHelper } = require('./utils');
3
+
4
+ class Oracle_Formatter extends Formatter {
5
+ alias(first, second) {
6
+ return first + ' ' + second;
7
+ }
8
+
9
+ parameter(value, notSetValue) {
10
+ // Returning helper uses always ROWID as string
11
+ if (value instanceof ReturningHelper && this.client.driver) {
12
+ value = new this.client.driver.OutParam(this.client.driver.OCCISTRING);
13
+ } else if (typeof value === 'boolean') {
14
+ value = value ? 1 : 0;
15
+ }
16
+ return super.parameter(value, notSetValue);
17
+ }
18
+ }
19
+
20
+ module.exports = Oracle_Formatter;
@@ -1,79 +1,79 @@
1
- // Oracle Client
2
- // -------
3
- const { inherits } = require('util');
4
- const Client = require('../../client');
5
-
6
- const SchemaCompiler = require('./schema/compiler');
7
- const ColumnBuilder = require('./schema/columnbuilder');
8
- const ColumnCompiler = require('./schema/columncompiler');
9
- const TableCompiler = require('./schema/tablecompiler');
10
- const { isConnectionError } = require('./utils');
11
-
12
- // Always initialize with the "QueryBuilder" and "QueryCompiler"
13
- // objects, which extend the base 'lib/query/builder' and
14
- // 'lib/query/compiler', respectively.
15
- function Client_Oracle(config) {
16
- Client.call(this, config);
17
- }
18
-
19
- inherits(Client_Oracle, Client);
20
-
21
- Object.assign(Client_Oracle.prototype, {
22
- dialect: 'oracle',
23
-
24
- driverName: 'oracle',
25
-
26
- schemaCompiler() {
27
- return new SchemaCompiler(this, ...arguments);
28
- },
29
-
30
- columnBuilder() {
31
- return new ColumnBuilder(this, ...arguments);
32
- },
33
-
34
- columnCompiler() {
35
- return new ColumnCompiler(this, ...arguments);
36
- },
37
-
38
- tableCompiler() {
39
- return new TableCompiler(this, ...arguments);
40
- },
41
-
42
- // Return the database for the Oracle client.
43
- database() {
44
- return this.connectionSettings.database;
45
- },
46
-
47
- // Position the bindings for the query.
48
- positionBindings(sql) {
49
- let questionCount = 0;
50
- return sql.replace(/\?/g, function () {
51
- questionCount += 1;
52
- return `:${questionCount}`;
53
- });
54
- },
55
-
56
- _stream(connection, obj, stream, options) {
57
- return new Promise(function (resolver, rejecter) {
58
- stream.on('error', (err) => {
59
- if (isConnectionError(err)) {
60
- connection.__knex__disposed = err;
61
- }
62
- rejecter(err);
63
- });
64
- stream.on('end', resolver);
65
- const queryStream = connection.queryStream(
66
- obj.sql,
67
- obj.bindings,
68
- options
69
- );
70
- queryStream.pipe(stream);
71
- queryStream.on('error', function (error) {
72
- rejecter(error);
73
- stream.emit('error', error);
74
- });
75
- });
76
- },
77
- });
78
-
79
- module.exports = Client_Oracle;
1
+ // Oracle Client
2
+ // -------
3
+ const { inherits } = require('util');
4
+ const Client = require('../../client');
5
+
6
+ const SchemaCompiler = require('./schema/compiler');
7
+ const ColumnBuilder = require('./schema/columnbuilder');
8
+ const ColumnCompiler = require('./schema/columncompiler');
9
+ const TableCompiler = require('./schema/tablecompiler');
10
+ const { isConnectionError } = require('./utils');
11
+
12
+ // Always initialize with the "QueryBuilder" and "QueryCompiler"
13
+ // objects, which extend the base 'lib/query/builder' and
14
+ // 'lib/query/compiler', respectively.
15
+ function Client_Oracle(config) {
16
+ Client.call(this, config);
17
+ }
18
+
19
+ inherits(Client_Oracle, Client);
20
+
21
+ Object.assign(Client_Oracle.prototype, {
22
+ dialect: 'oracle',
23
+
24
+ driverName: 'oracle',
25
+
26
+ schemaCompiler() {
27
+ return new SchemaCompiler(this, ...arguments);
28
+ },
29
+
30
+ columnBuilder() {
31
+ return new ColumnBuilder(this, ...arguments);
32
+ },
33
+
34
+ columnCompiler() {
35
+ return new ColumnCompiler(this, ...arguments);
36
+ },
37
+
38
+ tableCompiler() {
39
+ return new TableCompiler(this, ...arguments);
40
+ },
41
+
42
+ // Return the database for the Oracle client.
43
+ database() {
44
+ return this.connectionSettings.database;
45
+ },
46
+
47
+ // Position the bindings for the query.
48
+ positionBindings(sql) {
49
+ let questionCount = 0;
50
+ return sql.replace(/\?/g, function () {
51
+ questionCount += 1;
52
+ return `:${questionCount}`;
53
+ });
54
+ },
55
+
56
+ _stream(connection, obj, stream, options) {
57
+ return new Promise(function (resolver, rejecter) {
58
+ stream.on('error', (err) => {
59
+ if (isConnectionError(err)) {
60
+ connection.__knex__disposed = err;
61
+ }
62
+ rejecter(err);
63
+ });
64
+ stream.on('end', resolver);
65
+ const queryStream = connection.queryStream(
66
+ obj.sql,
67
+ obj.bindings,
68
+ options
69
+ );
70
+ queryStream.pipe(stream);
71
+ queryStream.on('error', function (error) {
72
+ rejecter(error);
73
+ stream.emit('error', error);
74
+ });
75
+ });
76
+ },
77
+ });
78
+
79
+ module.exports = Client_Oracle;