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,151 +1,151 @@
1
- const { DEFAULT_EXT, DEFAULT_TABLE_NAME } = require('./constants');
2
- const { resolveClientNameWithAliases } = require('../../lib/helpers');
3
- const fs = require('fs');
4
- const path = require('path');
5
- const tildify = require('tildify');
6
- const color = require('colorette');
7
- const argv = require('getopts')(process.argv.slice(2));
8
-
9
- function mkConfigObj(opts) {
10
- if (!opts.client) {
11
- throw new Error(
12
- `No configuration file found and no commandline connection parameters passed`
13
- );
14
- }
15
-
16
- const envName = opts.env || process.env.NODE_ENV || 'development';
17
- const resolvedClientName = resolveClientNameWithAliases(opts.client);
18
- const useNullAsDefault = resolvedClientName === 'sqlite3';
19
- return {
20
- ext: DEFAULT_EXT,
21
- [envName]: {
22
- useNullAsDefault,
23
- client: opts.client,
24
- connection: opts.connection,
25
- migrations: {
26
- directory: opts.migrationsDirectory,
27
- tableName: opts.migrationsTableName || DEFAULT_TABLE_NAME,
28
- },
29
- },
30
- };
31
- }
32
-
33
- function resolveEnvironmentConfig(opts, allConfigs, configFilePath) {
34
- const environment = opts.env || process.env.NODE_ENV || 'development';
35
- const result = allConfigs[environment] || allConfigs;
36
-
37
- if (allConfigs[environment]) {
38
- console.log('Using environment:', color.magenta(environment));
39
- }
40
-
41
- if (!result) {
42
- console.log(color.red('Warning: unable to read knexfile config'));
43
- process.exit(1);
44
- }
45
-
46
- if (argv.debug !== undefined) {
47
- result.debug = argv.debug;
48
- }
49
-
50
- // It is safe to assume that unless explicitly specified, we would want
51
- // migrations, seeds etc. to be generated with same extension
52
- if (configFilePath) {
53
- result.ext = result.ext || path.extname(configFilePath).replace('.', '');
54
- }
55
-
56
- return result;
57
- }
58
-
59
- function exit(text) {
60
- if (text instanceof Error) {
61
- console.error(
62
- color.red(`${text.detail ? `${text.detail}\n` : ''}${text.stack}`)
63
- );
64
- } else {
65
- console.error(color.red(text));
66
- }
67
- process.exit(1);
68
- }
69
-
70
- function success(text) {
71
- console.log(text);
72
- process.exit(0);
73
- }
74
-
75
- function checkLocalModule(env) {
76
- if (!env.modulePath) {
77
- console.log(
78
- color.red('No local knex install found in:'),
79
- color.magenta(tildify(env.cwd))
80
- );
81
- exit('Try running: npm install knex');
82
- }
83
- }
84
-
85
- function getMigrationExtension(env, opts) {
86
- const config = resolveEnvironmentConfig(
87
- opts,
88
- env.configuration,
89
- env.configPath
90
- );
91
-
92
- let ext = DEFAULT_EXT;
93
- if (argv.x) {
94
- ext = argv.x;
95
- } else if (config.migrations && config.migrations.extension) {
96
- ext = config.migrations.extension;
97
- } else if (config.ext) {
98
- ext = config.ext;
99
- }
100
- return ext.toLowerCase();
101
- }
102
-
103
- function getSeedExtension(env, opts) {
104
- const config = resolveEnvironmentConfig(
105
- opts,
106
- env.configuration,
107
- env.configPath
108
- );
109
-
110
- let ext = DEFAULT_EXT;
111
- if (argv.x) {
112
- ext = argv.x;
113
- } else if (config.seeds && config.seeds.extension) {
114
- ext = config.seeds.extension;
115
- } else if (config.ext) {
116
- ext = config.ext;
117
- }
118
- return ext.toLowerCase();
119
- }
120
-
121
- function getStubPath(configKey, env, opts) {
122
- const config = resolveEnvironmentConfig(opts, env.configuration);
123
- const stubDirectory = config[configKey] && config[configKey].directory;
124
-
125
- const { stub } = argv;
126
- if (!stub) {
127
- return null;
128
- } else if (stub.includes('/')) {
129
- // relative path to stub
130
- return stub;
131
- }
132
-
133
- // using stub <name> must have config[configKey].directory defined
134
- if (!stubDirectory) {
135
- console.log(color.red('Failed to load stub'), color.magenta(stub));
136
- exit(`config.${configKey}.directory in knexfile must be defined`);
137
- }
138
-
139
- return path.join(stubDirectory, stub);
140
- }
141
-
142
- module.exports = {
143
- mkConfigObj,
144
- resolveEnvironmentConfig,
145
- exit,
146
- success,
147
- checkLocalModule,
148
- getSeedExtension,
149
- getMigrationExtension,
150
- getStubPath,
151
- };
1
+ const { DEFAULT_EXT, DEFAULT_TABLE_NAME } = require('./constants');
2
+ const { resolveClientNameWithAliases } = require('../../lib/helpers');
3
+ const fs = require('fs');
4
+ const path = require('path');
5
+ const tildify = require('tildify');
6
+ const color = require('colorette');
7
+ const argv = require('getopts')(process.argv.slice(2));
8
+
9
+ function mkConfigObj(opts) {
10
+ if (!opts.client) {
11
+ throw new Error(
12
+ `No configuration file found and no commandline connection parameters passed`
13
+ );
14
+ }
15
+
16
+ const envName = opts.env || process.env.NODE_ENV || 'development';
17
+ const resolvedClientName = resolveClientNameWithAliases(opts.client);
18
+ const useNullAsDefault = resolvedClientName === 'sqlite3';
19
+ return {
20
+ ext: DEFAULT_EXT,
21
+ [envName]: {
22
+ useNullAsDefault,
23
+ client: opts.client,
24
+ connection: opts.connection,
25
+ migrations: {
26
+ directory: opts.migrationsDirectory,
27
+ tableName: opts.migrationsTableName || DEFAULT_TABLE_NAME,
28
+ },
29
+ },
30
+ };
31
+ }
32
+
33
+ function resolveEnvironmentConfig(opts, allConfigs, configFilePath) {
34
+ const environment = opts.env || process.env.NODE_ENV || 'development';
35
+ const result = allConfigs[environment] || allConfigs;
36
+
37
+ if (allConfigs[environment]) {
38
+ console.log('Using environment:', color.magenta(environment));
39
+ }
40
+
41
+ if (!result) {
42
+ console.log(color.red('Warning: unable to read knexfile config'));
43
+ process.exit(1);
44
+ }
45
+
46
+ if (argv.debug !== undefined) {
47
+ result.debug = argv.debug;
48
+ }
49
+
50
+ // It is safe to assume that unless explicitly specified, we would want
51
+ // migrations, seeds etc. to be generated with same extension
52
+ if (configFilePath) {
53
+ result.ext = result.ext || path.extname(configFilePath).replace('.', '');
54
+ }
55
+
56
+ return result;
57
+ }
58
+
59
+ function exit(text) {
60
+ if (text instanceof Error) {
61
+ console.error(
62
+ color.red(`${text.detail ? `${text.detail}\n` : ''}${text.stack}`)
63
+ );
64
+ } else {
65
+ console.error(color.red(text));
66
+ }
67
+ process.exit(1);
68
+ }
69
+
70
+ function success(text) {
71
+ console.log(text);
72
+ process.exit(0);
73
+ }
74
+
75
+ function checkLocalModule(env) {
76
+ if (!env.modulePath) {
77
+ console.log(
78
+ color.red('No local knex install found in:'),
79
+ color.magenta(tildify(env.cwd))
80
+ );
81
+ exit('Try running: npm install knex');
82
+ }
83
+ }
84
+
85
+ function getMigrationExtension(env, opts) {
86
+ const config = resolveEnvironmentConfig(
87
+ opts,
88
+ env.configuration,
89
+ env.configPath
90
+ );
91
+
92
+ let ext = DEFAULT_EXT;
93
+ if (argv.x) {
94
+ ext = argv.x;
95
+ } else if (config.migrations && config.migrations.extension) {
96
+ ext = config.migrations.extension;
97
+ } else if (config.ext) {
98
+ ext = config.ext;
99
+ }
100
+ return ext.toLowerCase();
101
+ }
102
+
103
+ function getSeedExtension(env, opts) {
104
+ const config = resolveEnvironmentConfig(
105
+ opts,
106
+ env.configuration,
107
+ env.configPath
108
+ );
109
+
110
+ let ext = DEFAULT_EXT;
111
+ if (argv.x) {
112
+ ext = argv.x;
113
+ } else if (config.seeds && config.seeds.extension) {
114
+ ext = config.seeds.extension;
115
+ } else if (config.ext) {
116
+ ext = config.ext;
117
+ }
118
+ return ext.toLowerCase();
119
+ }
120
+
121
+ function getStubPath(configKey, env, opts) {
122
+ const config = resolveEnvironmentConfig(opts, env.configuration);
123
+ const stubDirectory = config[configKey] && config[configKey].directory;
124
+
125
+ const { stub } = argv;
126
+ if (!stub) {
127
+ return null;
128
+ } else if (stub.includes('/')) {
129
+ // relative path to stub
130
+ return stub;
131
+ }
132
+
133
+ // using stub <name> must have config[configKey].directory defined
134
+ if (!stubDirectory) {
135
+ console.log(color.red('Failed to load stub'), color.magenta(stub));
136
+ exit(`config.${configKey}.directory in knexfile must be defined`);
137
+ }
138
+
139
+ return path.join(stubDirectory, stub);
140
+ }
141
+
142
+ module.exports = {
143
+ mkConfigObj,
144
+ resolveEnvironmentConfig,
145
+ exit,
146
+ success,
147
+ checkLocalModule,
148
+ getSeedExtension,
149
+ getMigrationExtension,
150
+ getStubPath,
151
+ };
@@ -1,7 +1,7 @@
1
- const DEFAULT_EXT = 'js';
2
- const DEFAULT_TABLE_NAME = 'knex_migrations';
3
-
4
- module.exports = {
5
- DEFAULT_EXT,
6
- DEFAULT_TABLE_NAME,
7
- };
1
+ const DEFAULT_EXT = 'js';
2
+ const DEFAULT_TABLE_NAME = 'knex_migrations';
3
+
4
+ module.exports = {
5
+ DEFAULT_EXT,
6
+ DEFAULT_TABLE_NAME,
7
+ };
@@ -1,37 +1,37 @@
1
- const color = require('colorette');
2
-
3
- const { success } = require('./cli-config-utils');
4
-
5
- function listMigrations(completed, newMigrations) {
6
- let message = '';
7
-
8
- if (completed.length === 0) {
9
- message += color.red('No Completed Migration files Found. \n');
10
- } else {
11
- message = color.green(
12
- `Found ${completed.length} Completed Migration file/files.\n`
13
- );
14
-
15
- for (let i = 0; i < completed.length; i++) {
16
- const file = completed[i];
17
- message += color.cyan(`${file} \n`);
18
- }
19
- }
20
-
21
- if (newMigrations.length === 0) {
22
- message += color.red('No Pending Migration files Found.\n');
23
- } else {
24
- message += color.green(
25
- `Found ${newMigrations.length} Pending Migration file/files.\n`
26
- );
27
-
28
- for (let i = 0; i < newMigrations.length; i++) {
29
- const file = newMigrations[i];
30
- message += color.cyan(`${file.file} \n`);
31
- }
32
- }
33
-
34
- success(message);
35
- }
36
-
37
- module.exports = { listMigrations };
1
+ const color = require('colorette');
2
+
3
+ const { success } = require('./cli-config-utils');
4
+
5
+ function listMigrations(completed, newMigrations) {
6
+ let message = '';
7
+
8
+ if (completed.length === 0) {
9
+ message += color.red('No Completed Migration files Found. \n');
10
+ } else {
11
+ message = color.green(
12
+ `Found ${completed.length} Completed Migration file/files.\n`
13
+ );
14
+
15
+ for (let i = 0; i < completed.length; i++) {
16
+ const file = completed[i];
17
+ message += color.cyan(`${file} \n`);
18
+ }
19
+ }
20
+
21
+ if (newMigrations.length === 0) {
22
+ message += color.red('No Pending Migration files Found.\n');
23
+ } else {
24
+ message += color.green(
25
+ `Found ${newMigrations.length} Pending Migration file/files.\n`
26
+ );
27
+
28
+ for (let i = 0; i < newMigrations.length; i++) {
29
+ const file = newMigrations[i];
30
+ message += color.cyan(`${file.file} \n`);
31
+ }
32
+ }
33
+
34
+ success(message);
35
+ }
36
+
37
+ module.exports = { listMigrations };
package/knex.js CHANGED
@@ -1,8 +1,8 @@
1
- // Knex.js
2
- // --------------
3
- // (c) 2013-present Tim Griesser
4
- // Knex may be freely distributed under the MIT license.
5
- // For details and documentation:
6
- // http://knexjs.org
7
-
8
- module.exports = require('./lib/index');
1
+ // Knex.js
2
+ // --------------
3
+ // (c) 2013-present Tim Griesser
4
+ // Knex may be freely distributed under the MIT license.
5
+ // For details and documentation:
6
+ // http://knexjs.org
7
+
8
+ module.exports = require('./lib/index');