@argos-js/data 0.0.0-stage → 0.1.1

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 (131) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +799 -2
  3. package/dist/connection/index.d.ts +2 -0
  4. package/dist/connection/index.d.ts.map +1 -0
  5. package/dist/connection/index.js +18 -0
  6. package/dist/connection/index.js.map +1 -0
  7. package/dist/connection/manager.d.ts +93 -0
  8. package/dist/connection/manager.d.ts.map +1 -0
  9. package/dist/connection/manager.js +194 -0
  10. package/dist/connection/manager.js.map +1 -0
  11. package/dist/database.d.ts +29 -0
  12. package/dist/database.d.ts.map +1 -0
  13. package/dist/database.js +276 -0
  14. package/dist/database.js.map +1 -0
  15. package/dist/drivers/base-driver.d.ts +18 -0
  16. package/dist/drivers/base-driver.d.ts.map +1 -0
  17. package/dist/drivers/base-driver.js +211 -0
  18. package/dist/drivers/base-driver.js.map +1 -0
  19. package/dist/drivers/index.d.ts +11 -0
  20. package/dist/drivers/index.d.ts.map +1 -0
  21. package/dist/drivers/index.js +55 -0
  22. package/dist/drivers/index.js.map +1 -0
  23. package/dist/drivers/mavedb-edge.d.ts +8 -0
  24. package/dist/drivers/mavedb-edge.d.ts.map +1 -0
  25. package/dist/drivers/mavedb-edge.js +18 -0
  26. package/dist/drivers/mavedb-edge.js.map +1 -0
  27. package/dist/drivers/mongodb.d.ts +8 -0
  28. package/dist/drivers/mongodb.d.ts.map +1 -0
  29. package/dist/drivers/mongodb.js +18 -0
  30. package/dist/drivers/mongodb.js.map +1 -0
  31. package/dist/drivers/mssql.d.ts +8 -0
  32. package/dist/drivers/mssql.d.ts.map +1 -0
  33. package/dist/drivers/mssql.js +18 -0
  34. package/dist/drivers/mssql.js.map +1 -0
  35. package/dist/drivers/mysql.d.ts +8 -0
  36. package/dist/drivers/mysql.d.ts.map +1 -0
  37. package/dist/drivers/mysql.js +18 -0
  38. package/dist/drivers/mysql.js.map +1 -0
  39. package/dist/drivers/postgres.d.ts +8 -0
  40. package/dist/drivers/postgres.d.ts.map +1 -0
  41. package/dist/drivers/postgres.js +18 -0
  42. package/dist/drivers/postgres.js.map +1 -0
  43. package/dist/drivers/redis.d.ts +9 -0
  44. package/dist/drivers/redis.d.ts.map +1 -0
  45. package/dist/drivers/redis.js +50 -0
  46. package/dist/drivers/redis.js.map +1 -0
  47. package/dist/drivers/sqlite.d.ts +8 -0
  48. package/dist/drivers/sqlite.d.ts.map +1 -0
  49. package/dist/drivers/sqlite.js +18 -0
  50. package/dist/drivers/sqlite.js.map +1 -0
  51. package/dist/index.d.ts +14 -0
  52. package/dist/index.d.ts.map +1 -0
  53. package/dist/index.js +49 -0
  54. package/dist/index.js.map +1 -0
  55. package/dist/migrations/index.d.ts +7 -0
  56. package/dist/migrations/index.d.ts.map +1 -0
  57. package/dist/migrations/index.js +23 -0
  58. package/dist/migrations/index.js.map +1 -0
  59. package/dist/migrations/migrator.d.ts +79 -0
  60. package/dist/migrations/migrator.d.ts.map +1 -0
  61. package/dist/migrations/migrator.js +274 -0
  62. package/dist/migrations/migrator.js.map +1 -0
  63. package/dist/migrations/schema-builder.d.ts +318 -0
  64. package/dist/migrations/schema-builder.d.ts.map +1 -0
  65. package/dist/migrations/schema-builder.js +957 -0
  66. package/dist/migrations/schema-builder.js.map +1 -0
  67. package/dist/migrations/types.d.ts +58 -0
  68. package/dist/migrations/types.d.ts.map +1 -0
  69. package/dist/migrations/types.js +3 -0
  70. package/dist/migrations/types.js.map +1 -0
  71. package/dist/model.d.ts +107 -0
  72. package/dist/model.d.ts.map +1 -0
  73. package/dist/model.js +333 -0
  74. package/dist/model.js.map +1 -0
  75. package/dist/plugin.d.ts +38 -0
  76. package/dist/plugin.d.ts.map +1 -0
  77. package/dist/plugin.js +83 -0
  78. package/dist/plugin.js.map +1 -0
  79. package/dist/query-builder.d.ts +58 -0
  80. package/dist/query-builder.d.ts.map +1 -0
  81. package/dist/query-builder.js +534 -0
  82. package/dist/query-builder.js.map +1 -0
  83. package/dist/schema-adapter.d.ts +34 -0
  84. package/dist/schema-adapter.d.ts.map +1 -0
  85. package/dist/schema-adapter.js +511 -0
  86. package/dist/schema-adapter.js.map +1 -0
  87. package/dist/schema.d.ts +104 -0
  88. package/dist/schema.d.ts.map +1 -0
  89. package/dist/schema.js +190 -0
  90. package/dist/schema.js.map +1 -0
  91. package/dist/seeds/index.d.ts +3 -0
  92. package/dist/seeds/index.d.ts.map +1 -0
  93. package/dist/seeds/index.js +19 -0
  94. package/dist/seeds/index.js.map +1 -0
  95. package/dist/seeds/seeder.d.ts +27 -0
  96. package/dist/seeds/seeder.d.ts.map +1 -0
  97. package/dist/seeds/seeder.js +138 -0
  98. package/dist/seeds/seeder.js.map +1 -0
  99. package/dist/seeds/types.d.ts +60 -0
  100. package/dist/seeds/types.d.ts.map +1 -0
  101. package/dist/seeds/types.js +3 -0
  102. package/dist/seeds/types.js.map +1 -0
  103. package/dist/sync/dump.d.ts +80 -0
  104. package/dist/sync/dump.d.ts.map +1 -0
  105. package/dist/sync/dump.js +655 -0
  106. package/dist/sync/dump.js.map +1 -0
  107. package/dist/sync/index.d.ts +5 -0
  108. package/dist/sync/index.d.ts.map +1 -0
  109. package/dist/sync/index.js +21 -0
  110. package/dist/sync/index.js.map +1 -0
  111. package/dist/sync/introspector.d.ts +49 -0
  112. package/dist/sync/introspector.d.ts.map +1 -0
  113. package/dist/sync/introspector.js +750 -0
  114. package/dist/sync/introspector.js.map +1 -0
  115. package/dist/sync/synchronizer.d.ts +50 -0
  116. package/dist/sync/synchronizer.d.ts.map +1 -0
  117. package/dist/sync/synchronizer.js +506 -0
  118. package/dist/sync/synchronizer.js.map +1 -0
  119. package/dist/sync/types.d.ts +83 -0
  120. package/dist/sync/types.d.ts.map +1 -0
  121. package/dist/sync/types.js +3 -0
  122. package/dist/sync/types.js.map +1 -0
  123. package/dist/tenant/sequence.d.ts +36 -0
  124. package/dist/tenant/sequence.d.ts.map +1 -0
  125. package/dist/tenant/sequence.js +130 -0
  126. package/dist/tenant/sequence.js.map +1 -0
  127. package/dist/types.d.ts +81 -0
  128. package/dist/types.d.ts.map +1 -0
  129. package/dist/types.js +3 -0
  130. package/dist/types.js.map +1 -0
  131. 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