@argos-js/data 0.0.0-stage → 0.1.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.
- package/LICENSE +21 -0
- package/README.md +799 -2
- package/dist/connection/index.d.ts +2 -0
- package/dist/connection/index.d.ts.map +1 -0
- package/dist/connection/index.js +18 -0
- package/dist/connection/index.js.map +1 -0
- package/dist/connection/manager.d.ts +93 -0
- package/dist/connection/manager.d.ts.map +1 -0
- package/dist/connection/manager.js +194 -0
- package/dist/connection/manager.js.map +1 -0
- package/dist/database.d.ts +29 -0
- package/dist/database.d.ts.map +1 -0
- package/dist/database.js +276 -0
- package/dist/database.js.map +1 -0
- package/dist/drivers/base-driver.d.ts +18 -0
- package/dist/drivers/base-driver.d.ts.map +1 -0
- package/dist/drivers/base-driver.js +211 -0
- package/dist/drivers/base-driver.js.map +1 -0
- package/dist/drivers/index.d.ts +11 -0
- package/dist/drivers/index.d.ts.map +1 -0
- package/dist/drivers/index.js +55 -0
- package/dist/drivers/index.js.map +1 -0
- package/dist/drivers/mavedb-edge.d.ts +8 -0
- package/dist/drivers/mavedb-edge.d.ts.map +1 -0
- package/dist/drivers/mavedb-edge.js +18 -0
- package/dist/drivers/mavedb-edge.js.map +1 -0
- package/dist/drivers/mongodb.d.ts +8 -0
- package/dist/drivers/mongodb.d.ts.map +1 -0
- package/dist/drivers/mongodb.js +18 -0
- package/dist/drivers/mongodb.js.map +1 -0
- package/dist/drivers/mssql.d.ts +8 -0
- package/dist/drivers/mssql.d.ts.map +1 -0
- package/dist/drivers/mssql.js +18 -0
- package/dist/drivers/mssql.js.map +1 -0
- package/dist/drivers/mysql.d.ts +8 -0
- package/dist/drivers/mysql.d.ts.map +1 -0
- package/dist/drivers/mysql.js +18 -0
- package/dist/drivers/mysql.js.map +1 -0
- package/dist/drivers/postgres.d.ts +8 -0
- package/dist/drivers/postgres.d.ts.map +1 -0
- package/dist/drivers/postgres.js +18 -0
- package/dist/drivers/postgres.js.map +1 -0
- package/dist/drivers/redis.d.ts +9 -0
- package/dist/drivers/redis.d.ts.map +1 -0
- package/dist/drivers/redis.js +50 -0
- package/dist/drivers/redis.js.map +1 -0
- package/dist/drivers/sqlite.d.ts +8 -0
- package/dist/drivers/sqlite.d.ts.map +1 -0
- package/dist/drivers/sqlite.js +18 -0
- package/dist/drivers/sqlite.js.map +1 -0
- package/dist/index.d.ts +14 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +49 -0
- package/dist/index.js.map +1 -0
- package/dist/migrations/index.d.ts +7 -0
- package/dist/migrations/index.d.ts.map +1 -0
- package/dist/migrations/index.js +23 -0
- package/dist/migrations/index.js.map +1 -0
- package/dist/migrations/migrator.d.ts +79 -0
- package/dist/migrations/migrator.d.ts.map +1 -0
- package/dist/migrations/migrator.js +274 -0
- package/dist/migrations/migrator.js.map +1 -0
- package/dist/migrations/schema-builder.d.ts +318 -0
- package/dist/migrations/schema-builder.d.ts.map +1 -0
- package/dist/migrations/schema-builder.js +957 -0
- package/dist/migrations/schema-builder.js.map +1 -0
- package/dist/migrations/types.d.ts +58 -0
- package/dist/migrations/types.d.ts.map +1 -0
- package/dist/migrations/types.js +3 -0
- package/dist/migrations/types.js.map +1 -0
- package/dist/model.d.ts +107 -0
- package/dist/model.d.ts.map +1 -0
- package/dist/model.js +333 -0
- package/dist/model.js.map +1 -0
- package/dist/plugin.d.ts +38 -0
- package/dist/plugin.d.ts.map +1 -0
- package/dist/plugin.js +83 -0
- package/dist/plugin.js.map +1 -0
- package/dist/query-builder.d.ts +58 -0
- package/dist/query-builder.d.ts.map +1 -0
- package/dist/query-builder.js +534 -0
- package/dist/query-builder.js.map +1 -0
- package/dist/schema-adapter.d.ts +34 -0
- package/dist/schema-adapter.d.ts.map +1 -0
- package/dist/schema-adapter.js +511 -0
- package/dist/schema-adapter.js.map +1 -0
- package/dist/schema.d.ts +104 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +190 -0
- package/dist/schema.js.map +1 -0
- package/dist/seeds/index.d.ts +3 -0
- package/dist/seeds/index.d.ts.map +1 -0
- package/dist/seeds/index.js +19 -0
- package/dist/seeds/index.js.map +1 -0
- package/dist/seeds/seeder.d.ts +27 -0
- package/dist/seeds/seeder.d.ts.map +1 -0
- package/dist/seeds/seeder.js +138 -0
- package/dist/seeds/seeder.js.map +1 -0
- package/dist/seeds/types.d.ts +60 -0
- package/dist/seeds/types.d.ts.map +1 -0
- package/dist/seeds/types.js +3 -0
- package/dist/seeds/types.js.map +1 -0
- package/dist/sync/dump.d.ts +80 -0
- package/dist/sync/dump.d.ts.map +1 -0
- package/dist/sync/dump.js +655 -0
- package/dist/sync/dump.js.map +1 -0
- package/dist/sync/index.d.ts +5 -0
- package/dist/sync/index.d.ts.map +1 -0
- package/dist/sync/index.js +21 -0
- package/dist/sync/index.js.map +1 -0
- package/dist/sync/introspector.d.ts +49 -0
- package/dist/sync/introspector.d.ts.map +1 -0
- package/dist/sync/introspector.js +750 -0
- package/dist/sync/introspector.js.map +1 -0
- package/dist/sync/synchronizer.d.ts +50 -0
- package/dist/sync/synchronizer.d.ts.map +1 -0
- package/dist/sync/synchronizer.js +506 -0
- package/dist/sync/synchronizer.js.map +1 -0
- package/dist/sync/types.d.ts +83 -0
- package/dist/sync/types.d.ts.map +1 -0
- package/dist/sync/types.js +3 -0
- package/dist/sync/types.js.map +1 -0
- package/dist/tenant/sequence.d.ts +36 -0
- package/dist/tenant/sequence.d.ts.map +1 -0
- package/dist/tenant/sequence.js +130 -0
- package/dist/tenant/sequence.js.map +1 -0
- package/dist/types.d.ts +81 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/package.json +38 -3
|
@@ -0,0 +1,957 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.SchemaBuilder = exports.TableBlueprint = exports.ColumnBlueprint = void 0;
|
|
4
|
+
const schema_adapter_1 = require("../schema-adapter");
|
|
5
|
+
/**
|
|
6
|
+
* Fluent column blueprint for database migrations.
|
|
7
|
+
*/
|
|
8
|
+
class ColumnBlueprint {
|
|
9
|
+
name;
|
|
10
|
+
type;
|
|
11
|
+
length;
|
|
12
|
+
precision;
|
|
13
|
+
scale;
|
|
14
|
+
dimensions;
|
|
15
|
+
enumValues;
|
|
16
|
+
isNullable = true;
|
|
17
|
+
isPrimaryKey = false;
|
|
18
|
+
isAutoIncrement = false;
|
|
19
|
+
isUnique = false;
|
|
20
|
+
defaultValue;
|
|
21
|
+
hasDefault = false;
|
|
22
|
+
hasIndex = false;
|
|
23
|
+
indexName;
|
|
24
|
+
indexUsing;
|
|
25
|
+
isGenerated = false;
|
|
26
|
+
generatedExpression;
|
|
27
|
+
generatedMode = 'stored';
|
|
28
|
+
sequenceOptions;
|
|
29
|
+
constructor(name, type) {
|
|
30
|
+
this.name = name;
|
|
31
|
+
this.type = type;
|
|
32
|
+
}
|
|
33
|
+
notNull() {
|
|
34
|
+
this.isNullable = false;
|
|
35
|
+
return this;
|
|
36
|
+
}
|
|
37
|
+
nullable() {
|
|
38
|
+
this.isNullable = true;
|
|
39
|
+
return this;
|
|
40
|
+
}
|
|
41
|
+
unique() {
|
|
42
|
+
this.isUnique = true;
|
|
43
|
+
return this;
|
|
44
|
+
}
|
|
45
|
+
default(value) {
|
|
46
|
+
this.hasDefault = true;
|
|
47
|
+
this.defaultValue = value;
|
|
48
|
+
return this;
|
|
49
|
+
}
|
|
50
|
+
index(optionsOrName) {
|
|
51
|
+
this.hasIndex = true;
|
|
52
|
+
if (typeof optionsOrName === 'string') {
|
|
53
|
+
this.indexName = optionsOrName;
|
|
54
|
+
}
|
|
55
|
+
else if (typeof optionsOrName === 'object' && optionsOrName !== null) {
|
|
56
|
+
if (optionsOrName.name)
|
|
57
|
+
this.indexName = optionsOrName.name;
|
|
58
|
+
if (optionsOrName.using)
|
|
59
|
+
this.indexUsing = optionsOrName.using;
|
|
60
|
+
}
|
|
61
|
+
return this;
|
|
62
|
+
}
|
|
63
|
+
primaryKey() {
|
|
64
|
+
this.isPrimaryKey = true;
|
|
65
|
+
this.isNullable = false;
|
|
66
|
+
return this;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Defines a generated (computed) column.
|
|
70
|
+
* e.g. .as('price * quantity', { mode: 'stored' })
|
|
71
|
+
*/
|
|
72
|
+
as(expression, options) {
|
|
73
|
+
this.isGenerated = true;
|
|
74
|
+
this.generatedExpression = expression;
|
|
75
|
+
this.generatedMode = options?.mode || 'stored';
|
|
76
|
+
return this;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
exports.ColumnBlueprint = ColumnBlueprint;
|
|
80
|
+
/**
|
|
81
|
+
* Fluent table blueprint for defining schema migrations across dialects.
|
|
82
|
+
*/
|
|
83
|
+
class TableBlueprint {
|
|
84
|
+
tableName;
|
|
85
|
+
columns = [];
|
|
86
|
+
droppedColumns = [];
|
|
87
|
+
customIndices = [];
|
|
88
|
+
compositePrimaryKeys = [];
|
|
89
|
+
isAlter = false;
|
|
90
|
+
constructor(tableName, isAlter = false) {
|
|
91
|
+
this.tableName = tableName;
|
|
92
|
+
this.isAlter = isAlter;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Primary key auto-increment identifier:
|
|
96
|
+
* - SQLite: INTEGER PRIMARY KEY AUTOINCREMENT
|
|
97
|
+
* - Postgres: BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY
|
|
98
|
+
* - MySQL: BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY
|
|
99
|
+
*/
|
|
100
|
+
id(name = 'id') {
|
|
101
|
+
const col = new ColumnBlueprint(name, 'id');
|
|
102
|
+
col.primaryKey();
|
|
103
|
+
col.isAutoIncrement = true;
|
|
104
|
+
this.columns.push(col);
|
|
105
|
+
return col;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* UUID type:
|
|
109
|
+
* - SQLite: TEXT
|
|
110
|
+
* - Postgres: UUID
|
|
111
|
+
* - MySQL: VARCHAR(36)
|
|
112
|
+
*/
|
|
113
|
+
uuid(name) {
|
|
114
|
+
const col = new ColumnBlueprint(name, 'uuid');
|
|
115
|
+
this.columns.push(col);
|
|
116
|
+
return col;
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* UUIDv7 column type:
|
|
120
|
+
* - SQLite: TEXT
|
|
121
|
+
* - Postgres: UUID
|
|
122
|
+
* - MySQL: VARCHAR(36)
|
|
123
|
+
*/
|
|
124
|
+
uuidV7(name) {
|
|
125
|
+
const col = new ColumnBlueprint(name, 'uuidv7');
|
|
126
|
+
this.columns.push(col);
|
|
127
|
+
return col;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* String column (VARCHAR).
|
|
131
|
+
*/
|
|
132
|
+
string(name, length = 255) {
|
|
133
|
+
const col = new ColumnBlueprint(name, 'string');
|
|
134
|
+
col.length = length;
|
|
135
|
+
this.columns.push(col);
|
|
136
|
+
return col;
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* Text column (TEXT).
|
|
140
|
+
*/
|
|
141
|
+
text(name) {
|
|
142
|
+
const col = new ColumnBlueprint(name, 'text');
|
|
143
|
+
this.columns.push(col);
|
|
144
|
+
return col;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Integer column:
|
|
148
|
+
* - SQLite: INTEGER
|
|
149
|
+
* - Postgres: INTEGER
|
|
150
|
+
* - MySQL: INT
|
|
151
|
+
*/
|
|
152
|
+
integer(name) {
|
|
153
|
+
const col = new ColumnBlueprint(name, 'integer');
|
|
154
|
+
this.columns.push(col);
|
|
155
|
+
return col;
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Decimal/numeric column with precision and scale.
|
|
159
|
+
*/
|
|
160
|
+
decimal(name, precision = 10, scale = 2) {
|
|
161
|
+
const col = new ColumnBlueprint(name, 'decimal');
|
|
162
|
+
col.precision = precision;
|
|
163
|
+
col.scale = scale;
|
|
164
|
+
this.columns.push(col);
|
|
165
|
+
return col;
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Boolean column:
|
|
169
|
+
* - SQLite: BOOLEAN
|
|
170
|
+
* - Postgres: BOOLEAN
|
|
171
|
+
* - MySQL: BOOLEAN
|
|
172
|
+
*/
|
|
173
|
+
boolean(name) {
|
|
174
|
+
const col = new ColumnBlueprint(name, 'boolean');
|
|
175
|
+
this.columns.push(col);
|
|
176
|
+
return col;
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* Timestamp column:
|
|
180
|
+
* - SQLite: TIMESTAMP
|
|
181
|
+
* - Postgres: TIMESTAMPTZ
|
|
182
|
+
* - MySQL: TIMESTAMP
|
|
183
|
+
*/
|
|
184
|
+
timestamp(name) {
|
|
185
|
+
const col = new ColumnBlueprint(name, 'timestamp');
|
|
186
|
+
this.columns.push(col);
|
|
187
|
+
return col;
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* DateTime column:
|
|
191
|
+
* - SQLite: DATETIME
|
|
192
|
+
* - Postgres: TIMESTAMP
|
|
193
|
+
* - MySQL: DATETIME
|
|
194
|
+
*/
|
|
195
|
+
dateTime(name) {
|
|
196
|
+
const col = new ColumnBlueprint(name, 'datetime');
|
|
197
|
+
this.columns.push(col);
|
|
198
|
+
return col;
|
|
199
|
+
}
|
|
200
|
+
datetime(name) {
|
|
201
|
+
return this.dateTime(name);
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
* JSON column:
|
|
205
|
+
* - SQLite: TEXT
|
|
206
|
+
* - Postgres: JSONB
|
|
207
|
+
* - MySQL: JSON
|
|
208
|
+
*/
|
|
209
|
+
json(name) {
|
|
210
|
+
const col = new ColumnBlueprint(name, 'json');
|
|
211
|
+
this.columns.push(col);
|
|
212
|
+
return col;
|
|
213
|
+
}
|
|
214
|
+
/**
|
|
215
|
+
* JSONB column:
|
|
216
|
+
* - Postgres: JSONB
|
|
217
|
+
* - MySQL/MariaDB: JSON
|
|
218
|
+
* - SQLite: TEXT
|
|
219
|
+
* - MSSQL: NVARCHAR(MAX)
|
|
220
|
+
* - Oracle: CLOB
|
|
221
|
+
*/
|
|
222
|
+
jsonb(name) {
|
|
223
|
+
const col = new ColumnBlueprint(name, 'jsonb');
|
|
224
|
+
this.columns.push(col);
|
|
225
|
+
return col;
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* Vector embedding column:
|
|
229
|
+
* - Postgres: vector({dimensions}) (pgvector)
|
|
230
|
+
* - Demais dialetos: BLOB / VARBINARY(MAX) com fallback
|
|
231
|
+
*/
|
|
232
|
+
vector(name, dimensions = 1536) {
|
|
233
|
+
const col = new ColumnBlueprint(name, 'vector');
|
|
234
|
+
col.dimensions = dimensions;
|
|
235
|
+
this.columns.push(col);
|
|
236
|
+
return col;
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* Network IP address column:
|
|
240
|
+
* - Postgres: INET
|
|
241
|
+
* - Demais dialetos: VARCHAR(45) / NVARCHAR(45) / VARCHAR2(45)
|
|
242
|
+
*/
|
|
243
|
+
inet(name) {
|
|
244
|
+
const col = new ColumnBlueprint(name, 'inet');
|
|
245
|
+
this.columns.push(col);
|
|
246
|
+
return col;
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* MAC address column:
|
|
250
|
+
* - Postgres: MACADDR
|
|
251
|
+
* - Demais dialetos: VARCHAR(17) / NVARCHAR(17) / VARCHAR2(17)
|
|
252
|
+
*/
|
|
253
|
+
macAddress(name) {
|
|
254
|
+
const col = new ColumnBlueprint(name, 'macaddr');
|
|
255
|
+
this.columns.push(col);
|
|
256
|
+
return col;
|
|
257
|
+
}
|
|
258
|
+
macaddr(name) {
|
|
259
|
+
return this.macAddress(name);
|
|
260
|
+
}
|
|
261
|
+
/**
|
|
262
|
+
* Enum column:
|
|
263
|
+
* - MySQL/MariaDB: native ENUM('val1', 'val2')
|
|
264
|
+
* - Postgres/SQLite/MSSQL/Oracle: CHECK constraint
|
|
265
|
+
*/
|
|
266
|
+
enum(name, values) {
|
|
267
|
+
const col = new ColumnBlueprint(name, 'enum');
|
|
268
|
+
col.enumValues = values;
|
|
269
|
+
this.columns.push(col);
|
|
270
|
+
return col;
|
|
271
|
+
}
|
|
272
|
+
/**
|
|
273
|
+
* Fixed precision money/monetary column.
|
|
274
|
+
*/
|
|
275
|
+
money(name, precision = 19, scale = 4) {
|
|
276
|
+
const col = new ColumnBlueprint(name, 'money');
|
|
277
|
+
col.precision = precision;
|
|
278
|
+
col.scale = scale;
|
|
279
|
+
this.columns.push(col);
|
|
280
|
+
return col;
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* Pure date column (DATE).
|
|
284
|
+
*/
|
|
285
|
+
date(name) {
|
|
286
|
+
const col = new ColumnBlueprint(name, 'date');
|
|
287
|
+
this.columns.push(col);
|
|
288
|
+
return col;
|
|
289
|
+
}
|
|
290
|
+
/**
|
|
291
|
+
* Pure time column (TIME).
|
|
292
|
+
*/
|
|
293
|
+
time(name) {
|
|
294
|
+
const col = new ColumnBlueprint(name, 'time');
|
|
295
|
+
this.columns.push(col);
|
|
296
|
+
return col;
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* BigInt column:
|
|
300
|
+
* - SQLite: INTEGER
|
|
301
|
+
* - Postgres: BIGINT
|
|
302
|
+
* - MySQL: BIGINT
|
|
303
|
+
*/
|
|
304
|
+
bigint(name) {
|
|
305
|
+
const col = new ColumnBlueprint(name, 'bigint');
|
|
306
|
+
this.columns.push(col);
|
|
307
|
+
return col;
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* Float / Double column:
|
|
311
|
+
* - SQLite: REAL
|
|
312
|
+
* - Postgres: REAL / DOUBLE PRECISION
|
|
313
|
+
* - MySQL: FLOAT / DOUBLE
|
|
314
|
+
*/
|
|
315
|
+
float(name) {
|
|
316
|
+
const col = new ColumnBlueprint(name, 'float');
|
|
317
|
+
this.columns.push(col);
|
|
318
|
+
return col;
|
|
319
|
+
}
|
|
320
|
+
/**
|
|
321
|
+
* Binary / Blob column:
|
|
322
|
+
* - SQLite: BLOB
|
|
323
|
+
* - Postgres: BYTEA
|
|
324
|
+
* - MySQL: BLOB
|
|
325
|
+
*/
|
|
326
|
+
binary(name) {
|
|
327
|
+
const col = new ColumnBlueprint(name, 'binary');
|
|
328
|
+
this.columns.push(col);
|
|
329
|
+
return col;
|
|
330
|
+
}
|
|
331
|
+
/**
|
|
332
|
+
* Sequence column (automated atomic counter/friendly identifier).
|
|
333
|
+
* - Scoped by tenant if options.by is provided, or global.
|
|
334
|
+
* - Integer if prefix is not set, or VARCHAR(64) if prefix is set.
|
|
335
|
+
* - Automatically creates an index.
|
|
336
|
+
*/
|
|
337
|
+
sequence(name, options) {
|
|
338
|
+
const colType = options?.prefix ? 'string' : 'integer';
|
|
339
|
+
const col = new ColumnBlueprint(name, colType);
|
|
340
|
+
col.sequenceOptions = options;
|
|
341
|
+
col.notNull();
|
|
342
|
+
if (options?.prefix) {
|
|
343
|
+
col.length = 64;
|
|
344
|
+
}
|
|
345
|
+
this.columns.push(col);
|
|
346
|
+
if (options?.by) {
|
|
347
|
+
this.index([options.by, name]);
|
|
348
|
+
}
|
|
349
|
+
else {
|
|
350
|
+
col.index();
|
|
351
|
+
}
|
|
352
|
+
return col;
|
|
353
|
+
}
|
|
354
|
+
/**
|
|
355
|
+
* Soft delete column (deleted_at) with automatic index:
|
|
356
|
+
* - SQLite: TIMESTAMP NULL
|
|
357
|
+
* - Postgres: TIMESTAMPTZ NULL
|
|
358
|
+
* - MySQL / MariaDB: TIMESTAMP NULL DEFAULT NULL
|
|
359
|
+
* - MSSQL: DATETIME2(6) NULL
|
|
360
|
+
* - Oracle: TIMESTAMP WITH TIME ZONE NULL
|
|
361
|
+
*/
|
|
362
|
+
softDeletes(columnName = 'deleted_at') {
|
|
363
|
+
const col = new ColumnBlueprint(columnName, 'soft_delete');
|
|
364
|
+
col.nullable();
|
|
365
|
+
col.index(`idx_${this.tableName}_${columnName}`);
|
|
366
|
+
this.columns.push(col);
|
|
367
|
+
return col;
|
|
368
|
+
}
|
|
369
|
+
/**
|
|
370
|
+
* Timestamps (created_at, updated_at) per dialect:
|
|
371
|
+
* - SQLite: created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
372
|
+
* - Postgres: created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP
|
|
373
|
+
* - MySQL: created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
|
374
|
+
*
|
|
375
|
+
* When options.softDeletes is true, also generates deleted_at with index.
|
|
376
|
+
*/
|
|
377
|
+
timestamps(options) {
|
|
378
|
+
const createdAt = new ColumnBlueprint('created_at', 'timestamp_created');
|
|
379
|
+
createdAt.notNull();
|
|
380
|
+
const updatedAt = new ColumnBlueprint('updated_at', 'timestamp_updated');
|
|
381
|
+
updatedAt.notNull();
|
|
382
|
+
this.columns.push(createdAt, updatedAt);
|
|
383
|
+
let deletedAt;
|
|
384
|
+
if (options?.softDeletes) {
|
|
385
|
+
deletedAt = this.softDeletes('deleted_at');
|
|
386
|
+
}
|
|
387
|
+
return { createdAt, updatedAt, ...(deletedAt ? { deletedAt } : {}) };
|
|
388
|
+
}
|
|
389
|
+
/**
|
|
390
|
+
* Multi-column or single-column index with optional USING method.
|
|
391
|
+
*/
|
|
392
|
+
index(columns, optionsOrName) {
|
|
393
|
+
const cols = Array.isArray(columns) ? columns : [columns];
|
|
394
|
+
let idxName;
|
|
395
|
+
let using;
|
|
396
|
+
let unique = false;
|
|
397
|
+
if (typeof optionsOrName === 'string') {
|
|
398
|
+
idxName = optionsOrName;
|
|
399
|
+
}
|
|
400
|
+
else if (typeof optionsOrName === 'object' && optionsOrName !== null) {
|
|
401
|
+
idxName = optionsOrName.name;
|
|
402
|
+
using = optionsOrName.using;
|
|
403
|
+
unique = Boolean(optionsOrName.unique);
|
|
404
|
+
}
|
|
405
|
+
this.customIndices.push({
|
|
406
|
+
name: idxName,
|
|
407
|
+
columns: cols,
|
|
408
|
+
unique,
|
|
409
|
+
using,
|
|
410
|
+
kind: 'standard',
|
|
411
|
+
});
|
|
412
|
+
return this;
|
|
413
|
+
}
|
|
414
|
+
/**
|
|
415
|
+
* Vector index (HNSW / IVFFLAT) for semantic similarity searches.
|
|
416
|
+
* Compiles to USING {method} ({column} vector_{metric}_ops) in PostgreSQL (pgvector).
|
|
417
|
+
*/
|
|
418
|
+
vectorIndex(column, options = {}) {
|
|
419
|
+
this.customIndices.push({
|
|
420
|
+
name: options.name,
|
|
421
|
+
columns: [column],
|
|
422
|
+
kind: 'vectorIndex',
|
|
423
|
+
metric: options.metric || 'cosine',
|
|
424
|
+
method: options.method || 'hnsw',
|
|
425
|
+
});
|
|
426
|
+
return this;
|
|
427
|
+
}
|
|
428
|
+
/**
|
|
429
|
+
* Full-text search index across one or more columns.
|
|
430
|
+
* Compiles to FULLTEXT in MySQL/MariaDB, and GIN (to_tsvector) in PostgreSQL.
|
|
431
|
+
*/
|
|
432
|
+
fullText(columns, options = {}) {
|
|
433
|
+
const cols = Array.isArray(columns) ? columns : [columns];
|
|
434
|
+
this.customIndices.push({
|
|
435
|
+
name: options.name,
|
|
436
|
+
columns: cols,
|
|
437
|
+
kind: 'fullText',
|
|
438
|
+
});
|
|
439
|
+
return this;
|
|
440
|
+
}
|
|
441
|
+
/**
|
|
442
|
+
* Multi-column or single-column unique index constraint.
|
|
443
|
+
*/
|
|
444
|
+
unique(columns, indexName) {
|
|
445
|
+
const cols = Array.isArray(columns) ? columns : [columns];
|
|
446
|
+
this.customIndices.push({ name: indexName, columns: cols, unique: true, kind: 'standard' });
|
|
447
|
+
return this;
|
|
448
|
+
}
|
|
449
|
+
/**
|
|
450
|
+
* Drop column (used in alterTable).
|
|
451
|
+
*/
|
|
452
|
+
dropColumn(name) {
|
|
453
|
+
this.droppedColumns.push(name);
|
|
454
|
+
return this;
|
|
455
|
+
}
|
|
456
|
+
/**
|
|
457
|
+
* Defines composite primary key at table level.
|
|
458
|
+
*/
|
|
459
|
+
primaryKey(...columns) {
|
|
460
|
+
this.compositePrimaryKeys = columns.flat();
|
|
461
|
+
return this;
|
|
462
|
+
}
|
|
463
|
+
/**
|
|
464
|
+
* Formats a column definition according to the target SQL dialect.
|
|
465
|
+
*/
|
|
466
|
+
formatColumn(col, dialect) {
|
|
467
|
+
if (col.type === 'id') {
|
|
468
|
+
if (dialect === 'postgres') {
|
|
469
|
+
return `${col.name} BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY`;
|
|
470
|
+
}
|
|
471
|
+
if (dialect === 'mysql' || dialect === 'mariadb') {
|
|
472
|
+
return `${col.name} BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY`;
|
|
473
|
+
}
|
|
474
|
+
if (dialect === 'mssql') {
|
|
475
|
+
return `${col.name} BIGINT IDENTITY(1,1) PRIMARY KEY`;
|
|
476
|
+
}
|
|
477
|
+
if (dialect === 'oracle') {
|
|
478
|
+
return `${col.name} NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY`;
|
|
479
|
+
}
|
|
480
|
+
return `${col.name} INTEGER PRIMARY KEY AUTOINCREMENT`;
|
|
481
|
+
}
|
|
482
|
+
if (col.type === 'timestamp_created') {
|
|
483
|
+
if (dialect === 'postgres') {
|
|
484
|
+
return `${col.name} TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP NOT NULL`;
|
|
485
|
+
}
|
|
486
|
+
if (dialect === 'mssql') {
|
|
487
|
+
return `${col.name} DATETIME2(6) DEFAULT SYSUTCDATETIME() NOT NULL`;
|
|
488
|
+
}
|
|
489
|
+
if (dialect === 'oracle') {
|
|
490
|
+
return `${col.name} TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP NOT NULL`;
|
|
491
|
+
}
|
|
492
|
+
return `${col.name} TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL`;
|
|
493
|
+
}
|
|
494
|
+
if (col.type === 'timestamp_updated') {
|
|
495
|
+
if (dialect === 'postgres') {
|
|
496
|
+
return `${col.name} TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP NOT NULL`;
|
|
497
|
+
}
|
|
498
|
+
if (dialect === 'mysql' || dialect === 'mariadb') {
|
|
499
|
+
return `${col.name} TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP NOT NULL`;
|
|
500
|
+
}
|
|
501
|
+
if (dialect === 'mssql') {
|
|
502
|
+
return `${col.name} DATETIME2(6) DEFAULT SYSUTCDATETIME() NOT NULL`;
|
|
503
|
+
}
|
|
504
|
+
if (dialect === 'oracle') {
|
|
505
|
+
return `${col.name} TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP NOT NULL`;
|
|
506
|
+
}
|
|
507
|
+
return `${col.name} TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL`;
|
|
508
|
+
}
|
|
509
|
+
if (col.type === 'soft_delete') {
|
|
510
|
+
if (dialect === 'postgres') {
|
|
511
|
+
return `${col.name} TIMESTAMPTZ NULL`;
|
|
512
|
+
}
|
|
513
|
+
if (dialect === 'mysql' || dialect === 'mariadb') {
|
|
514
|
+
return `${col.name} TIMESTAMP NULL DEFAULT NULL`;
|
|
515
|
+
}
|
|
516
|
+
if (dialect === 'mssql') {
|
|
517
|
+
return `${col.name} DATETIME2(6) NULL`;
|
|
518
|
+
}
|
|
519
|
+
if (dialect === 'oracle') {
|
|
520
|
+
return `${col.name} TIMESTAMP WITH TIME ZONE NULL`;
|
|
521
|
+
}
|
|
522
|
+
return `${col.name} TIMESTAMP NULL`;
|
|
523
|
+
}
|
|
524
|
+
let typeStr = 'TEXT';
|
|
525
|
+
switch (col.type) {
|
|
526
|
+
case 'uuid':
|
|
527
|
+
case 'uuidv7':
|
|
528
|
+
if (dialect === 'postgres')
|
|
529
|
+
typeStr = 'UUID';
|
|
530
|
+
else if (dialect === 'mysql' || dialect === 'mariadb')
|
|
531
|
+
typeStr = 'VARCHAR(36)';
|
|
532
|
+
else if (dialect === 'mssql')
|
|
533
|
+
typeStr = 'NVARCHAR(36)';
|
|
534
|
+
else if (dialect === 'oracle')
|
|
535
|
+
typeStr = 'VARCHAR2(36)';
|
|
536
|
+
else
|
|
537
|
+
typeStr = 'TEXT';
|
|
538
|
+
break;
|
|
539
|
+
case 'string':
|
|
540
|
+
if (dialect === 'mssql')
|
|
541
|
+
typeStr = `NVARCHAR(${col.length || 255})`;
|
|
542
|
+
else if (dialect === 'oracle')
|
|
543
|
+
typeStr = `VARCHAR2(${col.length || 255})`;
|
|
544
|
+
else
|
|
545
|
+
typeStr = `VARCHAR(${col.length || 255})`;
|
|
546
|
+
break;
|
|
547
|
+
case 'text':
|
|
548
|
+
if (dialect === 'mssql')
|
|
549
|
+
typeStr = 'NVARCHAR(MAX)';
|
|
550
|
+
else if (dialect === 'oracle')
|
|
551
|
+
typeStr = 'CLOB';
|
|
552
|
+
else
|
|
553
|
+
typeStr = 'TEXT';
|
|
554
|
+
break;
|
|
555
|
+
case 'integer':
|
|
556
|
+
if (dialect === 'mysql' || dialect === 'mariadb' || dialect === 'mssql')
|
|
557
|
+
typeStr = 'INT';
|
|
558
|
+
else if (dialect === 'oracle')
|
|
559
|
+
typeStr = 'NUMBER(10)';
|
|
560
|
+
else
|
|
561
|
+
typeStr = 'INTEGER';
|
|
562
|
+
break;
|
|
563
|
+
case 'decimal':
|
|
564
|
+
if (dialect === 'oracle')
|
|
565
|
+
typeStr = `NUMBER(${col.precision ?? 10}, ${col.scale ?? 2})`;
|
|
566
|
+
else
|
|
567
|
+
typeStr = `DECIMAL(${col.precision ?? 10}, ${col.scale ?? 2})`;
|
|
568
|
+
break;
|
|
569
|
+
case 'money':
|
|
570
|
+
if (dialect === 'oracle')
|
|
571
|
+
typeStr = `NUMBER(${col.precision ?? 19}, ${col.scale ?? 4})`;
|
|
572
|
+
else
|
|
573
|
+
typeStr = `DECIMAL(${col.precision ?? 19}, ${col.scale ?? 4})`;
|
|
574
|
+
break;
|
|
575
|
+
case 'boolean':
|
|
576
|
+
if (dialect === 'mssql')
|
|
577
|
+
typeStr = 'BIT';
|
|
578
|
+
else if (dialect === 'oracle')
|
|
579
|
+
typeStr = 'NUMBER(1)';
|
|
580
|
+
else
|
|
581
|
+
typeStr = 'BOOLEAN';
|
|
582
|
+
break;
|
|
583
|
+
case 'timestamp':
|
|
584
|
+
if (dialect === 'postgres')
|
|
585
|
+
typeStr = 'TIMESTAMPTZ';
|
|
586
|
+
else if (dialect === 'mssql')
|
|
587
|
+
typeStr = 'DATETIME2(6)';
|
|
588
|
+
else if (dialect === 'oracle')
|
|
589
|
+
typeStr = 'TIMESTAMP WITH TIME ZONE';
|
|
590
|
+
else
|
|
591
|
+
typeStr = 'TIMESTAMP';
|
|
592
|
+
break;
|
|
593
|
+
case 'datetime':
|
|
594
|
+
if (dialect === 'postgres')
|
|
595
|
+
typeStr = 'TIMESTAMP';
|
|
596
|
+
else if (dialect === 'mssql')
|
|
597
|
+
typeStr = 'DATETIME2(6)';
|
|
598
|
+
else if (dialect === 'oracle')
|
|
599
|
+
typeStr = 'TIMESTAMP';
|
|
600
|
+
else
|
|
601
|
+
typeStr = 'DATETIME';
|
|
602
|
+
break;
|
|
603
|
+
case 'date':
|
|
604
|
+
typeStr = 'DATE';
|
|
605
|
+
break;
|
|
606
|
+
case 'time':
|
|
607
|
+
if (dialect === 'oracle')
|
|
608
|
+
typeStr = 'VARCHAR2(8)';
|
|
609
|
+
else
|
|
610
|
+
typeStr = 'TIME';
|
|
611
|
+
break;
|
|
612
|
+
case 'json':
|
|
613
|
+
if (dialect === 'postgres')
|
|
614
|
+
typeStr = 'JSONB';
|
|
615
|
+
else if (dialect === 'mysql' || dialect === 'mariadb')
|
|
616
|
+
typeStr = 'JSON';
|
|
617
|
+
else if (dialect === 'mssql')
|
|
618
|
+
typeStr = 'NVARCHAR(MAX)';
|
|
619
|
+
else if (dialect === 'oracle')
|
|
620
|
+
typeStr = 'CLOB';
|
|
621
|
+
else
|
|
622
|
+
typeStr = 'TEXT';
|
|
623
|
+
break;
|
|
624
|
+
case 'jsonb':
|
|
625
|
+
if (dialect === 'postgres')
|
|
626
|
+
typeStr = 'JSONB';
|
|
627
|
+
else if (dialect === 'mysql' || dialect === 'mariadb')
|
|
628
|
+
typeStr = 'JSON';
|
|
629
|
+
else if (dialect === 'mssql')
|
|
630
|
+
typeStr = 'NVARCHAR(MAX)';
|
|
631
|
+
else if (dialect === 'oracle')
|
|
632
|
+
typeStr = 'CLOB';
|
|
633
|
+
else
|
|
634
|
+
typeStr = 'TEXT';
|
|
635
|
+
break;
|
|
636
|
+
case 'vector':
|
|
637
|
+
if (dialect === 'postgres')
|
|
638
|
+
typeStr = `vector(${col.dimensions || 1536})`;
|
|
639
|
+
else if (dialect === 'mssql')
|
|
640
|
+
typeStr = 'VARBINARY(MAX)';
|
|
641
|
+
else
|
|
642
|
+
typeStr = 'BLOB';
|
|
643
|
+
break;
|
|
644
|
+
case 'inet':
|
|
645
|
+
if (dialect === 'postgres')
|
|
646
|
+
typeStr = 'INET';
|
|
647
|
+
else if (dialect === 'mssql')
|
|
648
|
+
typeStr = 'NVARCHAR(45)';
|
|
649
|
+
else if (dialect === 'oracle')
|
|
650
|
+
typeStr = 'VARCHAR2(45)';
|
|
651
|
+
else
|
|
652
|
+
typeStr = 'VARCHAR(45)';
|
|
653
|
+
break;
|
|
654
|
+
case 'macaddr':
|
|
655
|
+
if (dialect === 'postgres')
|
|
656
|
+
typeStr = 'MACADDR';
|
|
657
|
+
else if (dialect === 'mssql')
|
|
658
|
+
typeStr = 'NVARCHAR(17)';
|
|
659
|
+
else if (dialect === 'oracle')
|
|
660
|
+
typeStr = 'VARCHAR2(17)';
|
|
661
|
+
else
|
|
662
|
+
typeStr = 'VARCHAR(17)';
|
|
663
|
+
break;
|
|
664
|
+
case 'enum':
|
|
665
|
+
const enumVals = (col.enumValues && col.enumValues.length > 0 ? col.enumValues : ['default'])
|
|
666
|
+
.map((v) => `'${v.replace(/'/g, "''")}'`)
|
|
667
|
+
.join(', ');
|
|
668
|
+
if (dialect === 'mysql' || dialect === 'mariadb') {
|
|
669
|
+
typeStr = `ENUM(${enumVals})`;
|
|
670
|
+
}
|
|
671
|
+
else if (dialect === 'postgres') {
|
|
672
|
+
typeStr = `VARCHAR(255) CHECK (${col.name} IN (${enumVals}))`;
|
|
673
|
+
}
|
|
674
|
+
else if (dialect === 'mssql') {
|
|
675
|
+
typeStr = `NVARCHAR(255) CHECK (${col.name} IN (${enumVals}))`;
|
|
676
|
+
}
|
|
677
|
+
else if (dialect === 'oracle') {
|
|
678
|
+
typeStr = `VARCHAR2(255) CHECK (${col.name} IN (${enumVals}))`;
|
|
679
|
+
}
|
|
680
|
+
else {
|
|
681
|
+
typeStr = `TEXT CHECK (${col.name} IN (${enumVals}))`;
|
|
682
|
+
}
|
|
683
|
+
break;
|
|
684
|
+
case 'bigint':
|
|
685
|
+
if (dialect === 'sqlite')
|
|
686
|
+
typeStr = 'INTEGER';
|
|
687
|
+
else if (dialect === 'oracle')
|
|
688
|
+
typeStr = 'NUMBER(19)';
|
|
689
|
+
else
|
|
690
|
+
typeStr = 'BIGINT';
|
|
691
|
+
break;
|
|
692
|
+
case 'float':
|
|
693
|
+
if (dialect === 'postgres')
|
|
694
|
+
typeStr = 'REAL';
|
|
695
|
+
else if (dialect === 'mysql' || dialect === 'mariadb' || dialect === 'mssql' || dialect === 'oracle')
|
|
696
|
+
typeStr = 'FLOAT';
|
|
697
|
+
else
|
|
698
|
+
typeStr = 'REAL';
|
|
699
|
+
break;
|
|
700
|
+
case 'binary':
|
|
701
|
+
if (dialect === 'postgres')
|
|
702
|
+
typeStr = 'BYTEA';
|
|
703
|
+
else if (dialect === 'mssql')
|
|
704
|
+
typeStr = 'VARBINARY(MAX)';
|
|
705
|
+
else if (dialect === 'oracle')
|
|
706
|
+
typeStr = 'BLOB';
|
|
707
|
+
else
|
|
708
|
+
typeStr = 'BLOB';
|
|
709
|
+
break;
|
|
710
|
+
}
|
|
711
|
+
// Generated columns (computed columns)
|
|
712
|
+
if (col.isGenerated && col.generatedExpression) {
|
|
713
|
+
if (dialect === 'mssql') {
|
|
714
|
+
const persisted = col.generatedMode === 'stored' ? ' PERSISTED' : '';
|
|
715
|
+
const notNull = !col.isNullable ? ' NOT NULL' : '';
|
|
716
|
+
return `${col.name} AS (${col.generatedExpression})${persisted}${notNull}`;
|
|
717
|
+
}
|
|
718
|
+
if (dialect === 'postgres') {
|
|
719
|
+
const notNull = !col.isNullable ? ' NOT NULL' : '';
|
|
720
|
+
return `${col.name} ${typeStr} GENERATED ALWAYS AS (${col.generatedExpression}) STORED${notNull}`;
|
|
721
|
+
}
|
|
722
|
+
if (dialect === 'sqlite') {
|
|
723
|
+
const mode = col.generatedMode.toUpperCase();
|
|
724
|
+
const notNull = !col.isNullable ? ' NOT NULL' : '';
|
|
725
|
+
return `${col.name} ${typeStr} GENERATED ALWAYS AS (${col.generatedExpression}) ${mode}${notNull}`;
|
|
726
|
+
}
|
|
727
|
+
if (dialect === 'mysql' || dialect === 'mariadb') {
|
|
728
|
+
const mode = col.generatedMode.toUpperCase();
|
|
729
|
+
const notNull = !col.isNullable ? ' NOT NULL' : '';
|
|
730
|
+
return `${col.name} ${typeStr} GENERATED ALWAYS AS (${col.generatedExpression}) ${mode}${notNull}`;
|
|
731
|
+
}
|
|
732
|
+
if (dialect === 'oracle') {
|
|
733
|
+
const notNull = !col.isNullable ? ' NOT NULL' : '';
|
|
734
|
+
return `${col.name} ${typeStr} GENERATED ALWAYS AS (${col.generatedExpression})${notNull}`;
|
|
735
|
+
}
|
|
736
|
+
}
|
|
737
|
+
const parts = [col.name, typeStr];
|
|
738
|
+
const hasCompositePk = this.compositePrimaryKeys.length > 1 ||
|
|
739
|
+
this.columns.filter((c) => c.isPrimaryKey).length > 1;
|
|
740
|
+
if (col.isPrimaryKey && !hasCompositePk) {
|
|
741
|
+
parts.push('PRIMARY KEY');
|
|
742
|
+
}
|
|
743
|
+
if (!col.isNullable) {
|
|
744
|
+
parts.push('NOT NULL');
|
|
745
|
+
}
|
|
746
|
+
if (col.isUnique) {
|
|
747
|
+
parts.push('UNIQUE');
|
|
748
|
+
}
|
|
749
|
+
if (col.type === 'boolean' && dialect === 'oracle') {
|
|
750
|
+
parts.push(`CHECK (${col.name} IN (0, 1))`);
|
|
751
|
+
}
|
|
752
|
+
if (col.hasDefault) {
|
|
753
|
+
if (col.defaultValue === null) {
|
|
754
|
+
parts.push('DEFAULT NULL');
|
|
755
|
+
}
|
|
756
|
+
else if (typeof col.defaultValue === 'boolean') {
|
|
757
|
+
if (dialect === 'sqlite' || dialect === 'mssql' || dialect === 'oracle') {
|
|
758
|
+
parts.push(`DEFAULT ${col.defaultValue ? 1 : 0}`);
|
|
759
|
+
}
|
|
760
|
+
else {
|
|
761
|
+
parts.push(`DEFAULT ${col.defaultValue ? 'TRUE' : 'FALSE'}`);
|
|
762
|
+
}
|
|
763
|
+
}
|
|
764
|
+
else if (typeof col.defaultValue === 'number') {
|
|
765
|
+
parts.push(`DEFAULT ${col.defaultValue}`);
|
|
766
|
+
}
|
|
767
|
+
else if (typeof col.defaultValue === 'string') {
|
|
768
|
+
if (col.defaultValue.toUpperCase() === 'CURRENT_TIMESTAMP') {
|
|
769
|
+
if (dialect === 'mssql') {
|
|
770
|
+
parts.push('DEFAULT SYSUTCDATETIME()');
|
|
771
|
+
}
|
|
772
|
+
else {
|
|
773
|
+
parts.push('DEFAULT CURRENT_TIMESTAMP');
|
|
774
|
+
}
|
|
775
|
+
}
|
|
776
|
+
else if (dialect === 'oracle' && col.defaultValue === '') {
|
|
777
|
+
parts.push('DEFAULT NULL');
|
|
778
|
+
}
|
|
779
|
+
else {
|
|
780
|
+
parts.push(`DEFAULT '${col.defaultValue.replace(/'/g, "''")}'`);
|
|
781
|
+
}
|
|
782
|
+
}
|
|
783
|
+
else {
|
|
784
|
+
parts.push(`DEFAULT '${String(col.defaultValue)}'`);
|
|
785
|
+
}
|
|
786
|
+
}
|
|
787
|
+
return parts.join(' ');
|
|
788
|
+
}
|
|
789
|
+
/**
|
|
790
|
+
* Compiles the CREATE TABLE or ALTER TABLE statement(s).
|
|
791
|
+
*/
|
|
792
|
+
toTableSql(dialect = 'sqlite') {
|
|
793
|
+
if (this.isAlter) {
|
|
794
|
+
const parts = [];
|
|
795
|
+
for (const col of this.columns) {
|
|
796
|
+
const colDef = this.formatColumn(col, dialect);
|
|
797
|
+
parts.push(`ALTER TABLE ${this.tableName} ADD COLUMN ${colDef};`);
|
|
798
|
+
}
|
|
799
|
+
for (const dropped of this.droppedColumns) {
|
|
800
|
+
parts.push(`ALTER TABLE ${this.tableName} DROP COLUMN ${dropped};`);
|
|
801
|
+
}
|
|
802
|
+
return parts.join('\n');
|
|
803
|
+
}
|
|
804
|
+
const pkCols = this.columns.filter((c) => c.isPrimaryKey).map((c) => c.name);
|
|
805
|
+
const compositePks = this.compositePrimaryKeys.length > 1
|
|
806
|
+
? this.compositePrimaryKeys
|
|
807
|
+
: pkCols.length > 1
|
|
808
|
+
? pkCols
|
|
809
|
+
: [];
|
|
810
|
+
const columnDefs = this.columns.map((c) => ` ${this.formatColumn(c, dialect)}`);
|
|
811
|
+
if (compositePks.length > 1) {
|
|
812
|
+
columnDefs.push(` PRIMARY KEY (${compositePks.join(', ')})`);
|
|
813
|
+
}
|
|
814
|
+
return `CREATE TABLE IF NOT EXISTS ${this.tableName} (\n${columnDefs.join(',\n')}\n);`;
|
|
815
|
+
}
|
|
816
|
+
/**
|
|
817
|
+
* Compiles all DDL statements including CREATE TABLE and indexes.
|
|
818
|
+
*/
|
|
819
|
+
toSql(dialect = 'sqlite') {
|
|
820
|
+
const statements = [];
|
|
821
|
+
if (this.isAlter) {
|
|
822
|
+
for (const col of this.columns) {
|
|
823
|
+
const colDef = this.formatColumn(col, dialect);
|
|
824
|
+
statements.push(`ALTER TABLE ${this.tableName} ADD COLUMN ${colDef};`);
|
|
825
|
+
}
|
|
826
|
+
for (const dropped of this.droppedColumns) {
|
|
827
|
+
statements.push(`ALTER TABLE ${this.tableName} DROP COLUMN ${dropped};`);
|
|
828
|
+
}
|
|
829
|
+
}
|
|
830
|
+
else {
|
|
831
|
+
statements.push(this.toTableSql(dialect));
|
|
832
|
+
}
|
|
833
|
+
// Column-level indexes
|
|
834
|
+
for (const col of this.columns) {
|
|
835
|
+
if (col.hasIndex) {
|
|
836
|
+
const idxName = col.indexName || `idx_${this.tableName}_${col.name}`;
|
|
837
|
+
if (col.indexUsing && dialect === 'postgres') {
|
|
838
|
+
statements.push(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} USING ${col.indexUsing.toUpperCase()} (${col.name});`);
|
|
839
|
+
}
|
|
840
|
+
else if (dialect === 'mysql' || dialect === 'mssql' || dialect === 'oracle') {
|
|
841
|
+
statements.push(`CREATE INDEX ${idxName} ON ${this.tableName} (${col.name});`);
|
|
842
|
+
}
|
|
843
|
+
else {
|
|
844
|
+
statements.push(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} (${col.name});`);
|
|
845
|
+
}
|
|
846
|
+
}
|
|
847
|
+
}
|
|
848
|
+
// Custom table indexes
|
|
849
|
+
for (const idx of this.customIndices) {
|
|
850
|
+
if (idx.kind === 'vectorIndex') {
|
|
851
|
+
const col = idx.columns[0];
|
|
852
|
+
const method = idx.method || 'hnsw';
|
|
853
|
+
const idxName = idx.name || `idx_${this.tableName}_${col}_${method}`;
|
|
854
|
+
if (dialect === 'postgres') {
|
|
855
|
+
const metric = idx.metric || 'cosine';
|
|
856
|
+
const opclass = metric === 'l2' ? 'vector_l2_ops' : metric === 'inner_product' ? 'vector_ip_ops' : 'vector_cosine_ops';
|
|
857
|
+
statements.push(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} USING ${method} (${col} ${opclass});`);
|
|
858
|
+
}
|
|
859
|
+
else if (dialect === 'mysql' || dialect === 'mssql' || dialect === 'oracle') {
|
|
860
|
+
statements.push(`CREATE INDEX ${idxName} ON ${this.tableName} (${col});`);
|
|
861
|
+
}
|
|
862
|
+
else {
|
|
863
|
+
statements.push(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} (${col});`);
|
|
864
|
+
}
|
|
865
|
+
}
|
|
866
|
+
else if (idx.kind === 'fullText') {
|
|
867
|
+
const idxName = idx.name || `idx_${this.tableName}_${idx.columns.join('_')}_ft`;
|
|
868
|
+
if (dialect === 'mysql' || dialect === 'mariadb') {
|
|
869
|
+
statements.push(`CREATE FULLTEXT INDEX ${idxName} ON ${this.tableName} (${idx.columns.join(', ')});`);
|
|
870
|
+
}
|
|
871
|
+
else if (dialect === 'postgres') {
|
|
872
|
+
const tsvectorExpr = `to_tsvector('simple', ${idx.columns.map((c) => `coalesce("${c}", '')`).join(" || ' ' || ")})`;
|
|
873
|
+
statements.push(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} USING GIN (${tsvectorExpr});`);
|
|
874
|
+
}
|
|
875
|
+
else if (dialect === 'mssql' || dialect === 'oracle') {
|
|
876
|
+
statements.push(`CREATE INDEX ${idxName} ON ${this.tableName} (${idx.columns.join(', ')});`);
|
|
877
|
+
}
|
|
878
|
+
else {
|
|
879
|
+
statements.push(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} (${idx.columns.join(', ')});`);
|
|
880
|
+
}
|
|
881
|
+
}
|
|
882
|
+
else {
|
|
883
|
+
const colList = idx.columns.join(', ');
|
|
884
|
+
const safeCols = idx.columns.join('_');
|
|
885
|
+
const idxName = idx.name || `idx_${this.tableName}_${safeCols}`;
|
|
886
|
+
const uniqueKeyword = idx.unique ? 'UNIQUE ' : '';
|
|
887
|
+
if (idx.using && dialect === 'postgres') {
|
|
888
|
+
statements.push(`CREATE ${uniqueKeyword}INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} USING ${idx.using.toUpperCase()} (${colList});`);
|
|
889
|
+
}
|
|
890
|
+
else if (dialect === 'mysql' || dialect === 'mssql' || dialect === 'oracle') {
|
|
891
|
+
statements.push(`CREATE ${uniqueKeyword}INDEX ${idxName} ON ${this.tableName} (${colList});`);
|
|
892
|
+
}
|
|
893
|
+
else {
|
|
894
|
+
statements.push(`CREATE ${uniqueKeyword}INDEX IF NOT EXISTS ${idxName} ON ${this.tableName} (${colList});`);
|
|
895
|
+
}
|
|
896
|
+
}
|
|
897
|
+
}
|
|
898
|
+
return statements;
|
|
899
|
+
}
|
|
900
|
+
/**
|
|
901
|
+
* Returns all statements joined into a single string for display or debugging.
|
|
902
|
+
*/
|
|
903
|
+
toSqlString(dialect = 'sqlite') {
|
|
904
|
+
return this.toSql(dialect).join('\n');
|
|
905
|
+
}
|
|
906
|
+
}
|
|
907
|
+
exports.TableBlueprint = TableBlueprint;
|
|
908
|
+
/**
|
|
909
|
+
* Agnostic Schema Builder for creating, altering, and dropping tables across SQL engines.
|
|
910
|
+
*/
|
|
911
|
+
class SchemaBuilder {
|
|
912
|
+
db;
|
|
913
|
+
dialect;
|
|
914
|
+
constructor(db) {
|
|
915
|
+
this.db = db;
|
|
916
|
+
this.dialect = (0, schema_adapter_1.normalizeDialect)(db.driverName);
|
|
917
|
+
}
|
|
918
|
+
/**
|
|
919
|
+
* Enables a database extension (e.g. pgvector, uuid-ossp).
|
|
920
|
+
* Executes `CREATE EXTENSION IF NOT EXISTS {name}` on PostgreSQL; no-op on others.
|
|
921
|
+
*/
|
|
922
|
+
async enableExtension(name) {
|
|
923
|
+
if (this.dialect === 'postgres') {
|
|
924
|
+
await this.db.execute(`CREATE EXTENSION IF NOT EXISTS "${name}";`);
|
|
925
|
+
}
|
|
926
|
+
}
|
|
927
|
+
/**
|
|
928
|
+
* Creates a new table using the fluent TableBlueprint.
|
|
929
|
+
*/
|
|
930
|
+
async createTable(tableName, callback) {
|
|
931
|
+
const table = new TableBlueprint(tableName, false);
|
|
932
|
+
callback(table);
|
|
933
|
+
const statements = table.toSql(this.dialect);
|
|
934
|
+
for (const sql of statements) {
|
|
935
|
+
await this.db.execute(sql);
|
|
936
|
+
}
|
|
937
|
+
}
|
|
938
|
+
/**
|
|
939
|
+
* Drops a table if it exists.
|
|
940
|
+
*/
|
|
941
|
+
async dropTableIfExists(tableName) {
|
|
942
|
+
await this.db.execute(`DROP TABLE IF EXISTS ${tableName};`);
|
|
943
|
+
}
|
|
944
|
+
/**
|
|
945
|
+
* Alters an existing table using the fluent TableBlueprint.
|
|
946
|
+
*/
|
|
947
|
+
async alterTable(tableName, callback) {
|
|
948
|
+
const table = new TableBlueprint(tableName, true);
|
|
949
|
+
callback(table);
|
|
950
|
+
const statements = table.toSql(this.dialect);
|
|
951
|
+
for (const sql of statements) {
|
|
952
|
+
await this.db.execute(sql);
|
|
953
|
+
}
|
|
954
|
+
}
|
|
955
|
+
}
|
|
956
|
+
exports.SchemaBuilder = SchemaBuilder;
|
|
957
|
+
//# sourceMappingURL=schema-builder.js.map
|