flint-orm 0.4.0 → 0.4.2

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 (51) hide show
  1. package/API.md +7 -1
  2. package/README.md +3 -1
  3. package/dist/config.d.ts +30 -0
  4. package/dist/drivers/better-sqlite3.d.ts +38 -0
  5. package/dist/drivers/bun-sqlite.d.ts +38 -0
  6. package/dist/drivers/libsql-web.d.ts +44 -0
  7. package/dist/drivers/libsql.d.ts +40 -0
  8. package/dist/drivers/turso-sync.d.ts +44 -0
  9. package/dist/drivers/turso.d.ts +38 -0
  10. package/dist/entries/better-sqlite3.d.ts +1 -0
  11. package/dist/entries/bun-sqlite.d.ts +1 -0
  12. package/dist/entries/config.d.ts +1 -0
  13. package/dist/entries/expressions.d.ts +5 -0
  14. package/dist/entries/libsql-web.d.ts +2 -0
  15. package/dist/entries/libsql.d.ts +2 -0
  16. package/dist/entries/table.d.ts +4 -0
  17. package/dist/entries/turso-sync.d.ts +2 -0
  18. package/dist/entries/turso.d.ts +1 -0
  19. package/dist/errors.d.ts +13 -0
  20. package/dist/executor.d.ts +16 -0
  21. package/dist/flint.d.ts +120 -0
  22. package/dist/index.d.ts +11 -0
  23. package/dist/migration/diff.d.ts +15 -0
  24. package/dist/migration/generate.d.ts +18 -0
  25. package/dist/migration/index.d.ts +11 -0
  26. package/dist/migration/migrate.d.ts +52 -0
  27. package/dist/migration/migration.d.ts +5 -0
  28. package/dist/migration/operations.d.ts +14 -0
  29. package/dist/migration/serialize.d.ts +3 -0
  30. package/dist/migration/sql.d.ts +2 -0
  31. package/dist/migration/types.d.ts +98 -0
  32. package/dist/query/aggregates.d.ts +47 -0
  33. package/dist/query/builder.d.ts +257 -0
  34. package/dist/query/conditions.d.ts +176 -0
  35. package/dist/schema/columns.d.ts +146 -0
  36. package/dist/schema/table.d.ts +74 -0
  37. package/dist/sqlite/introspect.d.ts +19 -0
  38. package/dist/src/cli.js +13744 -0
  39. package/dist/src/entries/better-sqlite3.js +2050 -0
  40. package/dist/src/entries/bun-sqlite.js +1284 -0
  41. package/dist/src/entries/config.js +55 -0
  42. package/dist/src/entries/expressions.js +1252 -0
  43. package/dist/src/entries/libsql-web.js +6065 -0
  44. package/dist/src/entries/libsql.js +7208 -0
  45. package/dist/src/entries/table.js +403 -0
  46. package/dist/src/entries/turso-sync.js +3504 -0
  47. package/dist/src/entries/turso.js +2379 -0
  48. package/dist/{index.js → src/index.js} +86 -22
  49. package/dist/src/migration/index.js +1066 -0
  50. package/package.json +3 -3
  51. package/src/cli.ts +0 -361
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "flint-orm",
3
- "version": "0.4.0",
3
+ "version": "0.4.2",
4
4
  "bin": {
5
- "flint": "./src/cli.ts"
5
+ "flint": "./dist/src/cli.js"
6
6
  },
7
7
  "files": [
8
8
  "dist",
@@ -59,7 +59,7 @@
59
59
  }
60
60
  },
61
61
  "scripts": {
62
- "build": "bun build ./src/index.ts ./src/entries/bun-sqlite.ts ./src/entries/better-sqlite3.ts ./src/entries/libsql.ts ./src/entries/libsql-web.ts ./src/entries/turso-sync.ts ./src/entries/turso.ts ./src/entries/table.ts ./src/entries/expressions.ts ./src/entries/config.ts ./src/migration/index.ts --outdir ./dist --target bun && tsc --project tsconfig.build.json",
62
+ "build": "bun build ./src/index.ts ./src/entries/bun-sqlite.ts ./src/entries/better-sqlite3.ts ./src/entries/libsql.ts ./src/entries/libsql-web.ts ./src/entries/turso-sync.ts ./src/entries/turso.ts ./src/entries/table.ts ./src/entries/expressions.ts ./src/entries/config.ts ./src/migration/index.ts ./src/cli.ts --outdir ./dist --target bun && tsc --project tsconfig.build.json",
63
63
  "typecheck": "tsc --noEmit",
64
64
  "lint": "oxlint --fix",
65
65
  "format": "oxfmt --write",
package/src/cli.ts DELETED
@@ -1,361 +0,0 @@
1
- #!/usr/bin/env bun
2
- // ---------------------------------------------------------------------------
3
- // flint CLI — migration generation for flint-orm
4
- // ---------------------------------------------------------------------------
5
-
6
- import { parseArgs, styleText } from 'node:util';
7
- import { statSync, readdirSync, existsSync, readFileSync } from 'node:fs';
8
- import { join, resolve, isAbsolute } from 'node:path';
9
- import { pathToFileURL } from 'node:url';
10
- import type { AnyTable, TableDef } from './schema/table.js';
11
- import type { SchemaState } from './migration/types.js';
12
- import { outro, log, cancel, isCancel, select, pc, note } from './cli/ui.js';
13
- import { CancellationError } from './migration/diff.js';
14
- import type { RenamePrompt } from './migration/diff.js';
15
- import type { Executor } from './executor.js';
16
-
17
- // ---------------------------------------------------------------------------
18
- // Config loading
19
- // ---------------------------------------------------------------------------
20
-
21
- interface FlintConfig {
22
- /** Which SQLite driver to use. */
23
- driver: string;
24
- /** Database connection details. */
25
- database: { url: string; authToken?: string };
26
- /** Path to schema file or directory. */
27
- schema: string;
28
- /** Path to migrations directory (default: ./flint). */
29
- migrations?: string;
30
- }
31
-
32
- async function loadConfig(): Promise<FlintConfig> {
33
- const configPath = resolve(process.cwd(), 'flint.config.ts');
34
- const configUrl = pathToFileURL(configPath).href;
35
- const mod = await import(configUrl);
36
- return mod.default as FlintConfig;
37
- }
38
-
39
- // ---------------------------------------------------------------------------
40
- // Schema discovery — import table() exports from schema path
41
- // ---------------------------------------------------------------------------
42
-
43
- function isTableDef(value: unknown): boolean {
44
- return (
45
- value !== null &&
46
- typeof value === 'object' &&
47
- '_' in value &&
48
- typeof (value as Record<string, unknown>)._ === 'object' &&
49
- typeof ((value as Record<string, Record<string, unknown>>)._ as Record<string, unknown>).name === 'string'
50
- );
51
- }
52
-
53
- async function discoverTables(schemaPath: string): Promise<unknown[]> {
54
- const abs = isAbsolute(schemaPath) ? schemaPath : resolve(process.cwd(), schemaPath);
55
- const stat = statSync(abs);
56
-
57
- if (stat.isFile()) {
58
- return importTableFile(abs);
59
- }
60
-
61
- if (stat.isDirectory()) {
62
- return importTableFolder(abs);
63
- }
64
-
65
- throw new Error(`Schema path does not exist: ${abs}`);
66
- }
67
-
68
- async function importTableFile(filePath: string): Promise<unknown[]> {
69
- const url = pathToFileURL(filePath).href;
70
- const mod = await import(url);
71
- const tables: unknown[] = [];
72
-
73
- for (const exportValue of Object.values(mod)) {
74
- if (isTableDef(exportValue)) {
75
- tables.push(exportValue);
76
- }
77
- }
78
-
79
- return tables;
80
- }
81
-
82
- async function importTableFolder(folderPath: string): Promise<unknown[]> {
83
- const entries = readdirSync(folderPath).filter((e) => e.endsWith('.ts'));
84
- const tables: unknown[] = [];
85
-
86
- for (const entry of entries) {
87
- const filePath = join(folderPath, entry);
88
- const discovered = await importTableFile(filePath);
89
- tables.push(...discovered);
90
- }
91
-
92
- return tables;
93
- }
94
-
95
- // ---------------------------------------------------------------------------
96
- // Commands
97
- // ---------------------------------------------------------------------------
98
-
99
- async function cmdGenerate(args: ReturnType<typeof parseArgs>['values'], config: FlintConfig): Promise<void> {
100
- const name = typeof args.name === 'string' ? args.name : undefined;
101
- const preview = args.preview === true;
102
- const promptRename: RenamePrompt = (message, options) => select({ message: pc.bold(message), options }) as Promise<string | symbol>;
103
-
104
- log.info(`Discovering schema from: ${config.schema}`);
105
- const tables = await discoverTables(config.schema);
106
-
107
- if (tables.length === 0) {
108
- cancel('No table() definitions found in schema path.');
109
- process.exit(1);
110
- }
111
-
112
- log.info(`Found ${tables.length} table(s): ${tables.map((t) => (t as Record<string, Record<string, unknown>>)._?.name ?? 'unknown').join(', ')}`);
113
-
114
- if (preview) {
115
- // Dynamic import of migration functions
116
- const { serializeSchema } = await import('./migration/serialize.js');
117
- const { diffSchemas, emptyState, resolveRenames } = await import('./migration/diff.js');
118
- const { generateSQL } = await import('./migration/sql.js');
119
-
120
- // Find latest state
121
- const migrationsDir = resolve(process.cwd(), config.migrations ?? './flint');
122
- let previousState: SchemaState | null = null;
123
- if (existsSync(migrationsDir)) {
124
- const folders = readdirSync(migrationsDir)
125
- .filter((e) => /^\d{10}_/.test(e))
126
- .sort()
127
- .reverse();
128
- for (const folder of folders) {
129
- const statePath = join(migrationsDir, folder, 'state.json');
130
- if (existsSync(statePath)) {
131
- previousState = JSON.parse(readFileSync(statePath, 'utf-8'));
132
- break;
133
- }
134
- }
135
- }
136
- if (!previousState) previousState = emptyState();
137
-
138
- const currentState = serializeSchema(tables as AnyTable[]);
139
- const rawOps = diffSchemas(previousState, currentState);
140
-
141
- if (rawOps.length === 0) {
142
- outro('Schema is already up to date.');
143
- return;
144
- }
145
-
146
- // Resolve renames interactively
147
- const operations = await resolveRenames(rawOps, { interactive: true, prompt: promptRename });
148
-
149
- const sql = generateSQL(operations);
150
- log.info(`Operations: ${operations.length}`);
151
- note(sql, 'SQL', { format: (text) => styleText('dim', text) });
152
- log.info('(dry run, no files written)');
153
- return;
154
- }
155
-
156
- // Dynamic import of the generate function
157
- const { generate } = await import('./migration/generate.js');
158
-
159
- try {
160
- const migrationsDir = resolve(process.cwd(), config.migrations ?? './flint');
161
- const result = await generate(tables as TableDef<any>[], migrationsDir, {
162
- name,
163
- interactive: true,
164
- prompt: promptRename,
165
- });
166
- log.info(`Operations: ${result.operations.length}`);
167
- note(result.sql, 'SQL', { format: (text) => styleText('dim', text) });
168
- log.success(`Migration generated: ${migrationsDir}/${result.folderName}`);
169
- } catch (err: unknown) {
170
- if (err instanceof Error && err.message.includes('No changes detected')) {
171
- outro('Schema is already up to date.');
172
- } else {
173
- throw err;
174
- }
175
- }
176
- }
177
-
178
- async function cmdMigrate(args: ReturnType<typeof parseArgs>['values'], config: FlintConfig): Promise<void> {
179
- const { migrate, getMigrationStatus } = await import('./migration/migrate.js');
180
-
181
- const migrationsDir = resolve(process.cwd(), config.migrations ?? './flint');
182
- const dryRun = args['dry-run'] === true;
183
- const statusOnly = args.status === true;
184
-
185
- // Dynamically create executor based on configured driver
186
- const isLocalDriver = config.driver === 'bun-sqlite' || config.driver === 'better-sqlite3';
187
- const dbUrl = isLocalDriver ? resolve(process.cwd(), config.database.url) : config.database.url;
188
-
189
- let executor: Executor;
190
-
191
- switch (config.driver) {
192
- case 'bun-sqlite': {
193
- const { BunSqliteExecutor } = await import('./drivers/bun-sqlite');
194
- const { Database } = await import('bun:sqlite');
195
- executor = new BunSqliteExecutor(new Database(dbUrl));
196
- break;
197
- }
198
- case 'better-sqlite3': {
199
- const { BetterSqlite3Executor } = await import('./drivers/better-sqlite3');
200
- const Database = (await import('better-sqlite3')).default;
201
- executor = new BetterSqlite3Executor(new Database(dbUrl));
202
- break;
203
- }
204
- case 'libsql': {
205
- const { LibsqlExecutor } = await import('./drivers/libsql');
206
- const { createClient: createLibsqlClient } = await import('@libsql/client');
207
- executor = new LibsqlExecutor(createLibsqlClient({ url: dbUrl, authToken: config.database.authToken }));
208
- break;
209
- }
210
- case 'libsql-web': {
211
- const { LibsqlWebExecutor } = await import('./drivers/libsql-web');
212
- const { createClient: createLibsqlWebClient } = await import('@libsql/client/web');
213
- executor = new LibsqlWebExecutor(createLibsqlWebClient({ url: dbUrl, authToken: config.database.authToken }));
214
- break;
215
- }
216
- case 'turso-sync': {
217
- const { TursoSyncExecutor } = await import('./drivers/turso-sync');
218
- const { connect } = await import('@tursodatabase/sync');
219
- const db = await connect({ path: dbUrl, authToken: config.database.authToken });
220
- executor = new TursoSyncExecutor(db);
221
- break;
222
- }
223
- case 'turso': {
224
- const { TursoExecutor } = await import('./drivers/turso');
225
- const { connect } = await import('@tursodatabase/database');
226
- const db = await connect(dbUrl);
227
- executor = new TursoExecutor(db);
228
- break;
229
- }
230
- default:
231
- cancel(`Unsupported driver: ${config.driver}`);
232
- process.exit(1);
233
- }
234
-
235
- try {
236
- if (statusOnly) {
237
- const status = await getMigrationStatus(executor, migrationsDir);
238
-
239
- if (status.applied.length === 0 && status.pending.length === 0) {
240
- outro('No migrations found.');
241
- return;
242
- }
243
-
244
- if (status.applied.length > 0) {
245
- log.info('Applied migrations:');
246
- for (const m of status.applied) {
247
- log.success(`${m.name} (${m.folderName})`);
248
- }
249
- }
250
-
251
- if (status.pending.length > 0) {
252
- log.warn('Pending migrations:');
253
- for (const m of status.pending) {
254
- log.message(` ○ ${m.name} (${m.folderName})`);
255
- }
256
- }
257
-
258
- log.info(`${status.applied.length} applied, ${status.pending.length} pending`);
259
- return;
260
- }
261
-
262
- const result = await migrate(executor, {
263
- migrationsDir,
264
- dryRun,
265
- });
266
-
267
- if (result.applied.length === 0) {
268
- outro('No pending migrations — database is up to date.');
269
- } else {
270
- log.info(`${dryRun ? 'Would apply' : 'Applied'} ${result.applied.length} migration(s):`);
271
- for (const appliedName of result.applied) {
272
- log.success(appliedName);
273
- }
274
- }
275
-
276
- if (result.skipped.length > 0 && !dryRun) {
277
- log.info(`Skipped ${result.skipped.length} already applied migration(s)`);
278
- }
279
- } finally {
280
- executor.close();
281
- }
282
- }
283
-
284
- // ---------------------------------------------------------------------------
285
- // Help
286
- // ---------------------------------------------------------------------------
287
-
288
- function printHelp(): void {
289
- log.message(`
290
- Usage:
291
- flint <command> [options]
292
-
293
- Commands:
294
- generate Generate a new migration from schema changes
295
- migrate Apply pending migrations to the database
296
-
297
- Options for generate:
298
- --name <name> Migration name (optional)
299
- --preview Show what would be generated without writing files
300
-
301
- Options for migrate:
302
- --status Show applied and pending migrations
303
- --dry-run Show what would be applied without executing
304
- --name <name> Apply only the named migration
305
-
306
- Examples:
307
- flint generate --name init_schema
308
- flint generate --preview
309
- flint migrate
310
- flint migrate --status
311
- flint migrate --dry-run
312
- `);
313
- }
314
-
315
- // ---------------------------------------------------------------------------
316
- // Main
317
- // ---------------------------------------------------------------------------
318
-
319
- async function main(): Promise<void> {
320
- const { values, positionals } = parseArgs({
321
- args: process.argv.slice(2),
322
- options: {
323
- name: { type: 'string', short: 'n' },
324
- preview: { type: 'boolean', short: 'p' },
325
- help: { type: 'boolean', short: 'h' },
326
- status: { type: 'boolean', short: 's' },
327
- 'dry-run': { type: 'boolean', short: 'd' },
328
- },
329
- allowPositionals: true,
330
- });
331
-
332
- if (values.help || positionals.length === 0) {
333
- printHelp();
334
- process.exit(0);
335
- }
336
-
337
- const command = positionals[0];
338
- const config = await loadConfig();
339
-
340
- switch (command) {
341
- case 'generate':
342
- await cmdGenerate(values, config);
343
- break;
344
- case 'migrate':
345
- await cmdMigrate(values, config);
346
- break;
347
- default:
348
- cancel(`Unknown command: ${command}`);
349
- printHelp();
350
- process.exit(1);
351
- }
352
- }
353
-
354
- main().catch((err) => {
355
- if (isCancel(err) || err instanceof CancellationError) {
356
- cancel('Operation cancelled.');
357
- } else {
358
- cancel(err.message ?? 'An error occurred');
359
- }
360
- process.exit(1);
361
- });