turbine-orm 0.50.0 → 0.51.0

package/dist/cjs/cli/index.js

@@ -4,21 +4,21 @@
  * turbine-orm CLI
  *
  * Commands:
- *   turbine init                  — Initialize a Turbine project
- *   turbine generate | pull       — Introspect database and generate TypeScript types
+ *   turbine init                 , Initialize a Turbine project
+ *   turbine generate | pull      , Introspect database and generate TypeScript types
  *   turbine migrate-from-prisma   - Parse a schema.prisma and emit a Prisma->Turbine name map + report
  *   turbine push                  - Apply schema-builder definitions to database (destructive ops gated)
  *   turbine migrate create <name> - Create a new SQL migration file (--auto | --from-diff | --recipe <name>)
- *   turbine migrate up            — Apply pending migrations
- *   turbine migrate deploy        — Apply pending migrations without prompts
- *   turbine migrate down          — Rollback last migration
- *   turbine migrate status        — Show migration status
- *   turbine seed                  — Run seed file
- *   turbine status                — Show schema summary
+ *   turbine migrate up           , Apply pending migrations
+ *   turbine migrate deploy       , Apply pending migrations without prompts
+ *   turbine migrate down         , Rollback last migration
+ *   turbine migrate status       , Show migration status
+ *   turbine seed                 , Run seed file
+ *   turbine status               , Show schema summary
  *   turbine doctor                - Cost-aware missing-FK-index triage (--fix, --json, --no-concurrently, --unused, --audit)
  *   turbine studio                : Launch local read-only web UI (--demo for a seeded sample DB)
- *   turbine mcp                   — Start read-only MCP server over JSON-RPC stdio
- *   turbine observe               — Launch metrics dashboard (requires TURBINE_OBSERVE_URL)
+ *   turbine mcp                  , Start read-only MCP server over JSON-RPC stdio
+ *   turbine observe              , Launch metrics dashboard (requires TURBINE_OBSERVE_URL)
  *
  * Usage:
  *   DATABASE_URL=postgres://... npx turbine generate
@@ -278,7 +278,7 @@ function parseArgs(argv = process.argv.slice(2)) {
     return result;
 }
 // ---------------------------------------------------------------------------
-// TypeScript loader — user-facing error helper
+// TypeScript loader, user-facing error helper
 // ---------------------------------------------------------------------------
 /**
  * Print a friendly error explaining how to install tsx, then exit.
@@ -294,7 +294,7 @@ function failMissingTsLoader(filePath, reason) {
     }
     else if (reason === 'failed') {
         // tsx IS installed but registering its loader threw. Report the real
-        // cause — telling the user to install tsx here would be a misdiagnosis.
+        // cause, telling the user to install tsx here would be a misdiagnosis.
         console.log(`  ${(0, ui_js_1.dim)('tsx is installed, but registering its TypeScript loader failed:')}`);
         (0, ui_js_1.newline)();
         console.log(`    ${(0, loader_js_1.getTsLoaderError)() ?? '(unknown error)'}`);
@@ -808,6 +808,7 @@ async function runInitGenerate(config, url) {
             schema: config.schema,
             include: config.include.length ? config.include : undefined,
             exclude: config.exclude.length ? config.exclude : undefined,
+            relationNames: config.relationNames,
         });
         spinner.succeed(`Found ${(0, ui_js_1.bold)(String(Object.keys(schema.tables).length))} tables`);
         const genSpinner = new ui_js_1.Spinner('Generating TypeScript client').start();
@@ -1115,7 +1116,7 @@ async function cmdGenerate(args, config) {
     const url = requireUrl(config);
     const startTime = performance.now();
     // Guard: `schema` is the Postgres NAMESPACE to introspect (default `public`),
-    // NOT the path to your schema-builder file — that goes in `schemaFile`. If the
+    // NOT the path to your schema-builder file, that goes in `schemaFile`. If the
     // configured `schema` looks like a file path, introspection would silently
     // match zero tables and emit an empty client. Fail loudly instead.
     if (!args.allowEmpty && (0, config_js_1.looksLikeSchemaFilePath)(config.schema)) {
@@ -1125,7 +1126,7 @@ async function cmdGenerate(args, config) {
         console.log(`  ${(0, ui_js_1.dim)('The path to your defineSchema() file belongs in')} ${(0, ui_js_1.cyan)('schemaFile')}${(0, ui_js_1.dim)('.')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.dim)('Fix your')} ${(0, ui_js_1.cyan)('turbine.config.ts')}${(0, ui_js_1.dim)(':')}`);
-        console.log(`    ${(0, ui_js_1.green)('schema:')} ${(0, ui_js_1.cyan)("'public'")}${(0, ui_js_1.dim)(",       // or omit — introspects the 'public' schema")}`);
+        console.log(`    ${(0, ui_js_1.green)('schema:')} ${(0, ui_js_1.cyan)("'public'")}${(0, ui_js_1.dim)(",       // or omit, introspects the 'public' schema")}`);
         console.log(`    ${(0, ui_js_1.green)('schemaFile:')} ${(0, ui_js_1.cyan)(`'${config.schema}'`)}${(0, ui_js_1.dim)(', // your defineSchema() file (used by `turbine push`)')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.dim)('Re-run with')} ${(0, ui_js_1.cyan)('--allow-empty')} ${(0, ui_js_1.dim)('to introspect this literal schema name anyway.')}`);
@@ -1144,6 +1145,7 @@ async function cmdGenerate(args, config) {
         schema: config.schema,
         include: config.include.length ? config.include : undefined,
         exclude: config.exclude.length ? config.exclude : undefined,
+        relationNames: config.relationNames,
         includeViews: args.includeViews,
         legacyToManyUniques: config.legacyToManyUniques,
         onDefaultTableExclusion: (tables) => skippedInternalTables.push(...tables),
@@ -1163,13 +1165,13 @@ async function cmdGenerate(args, config) {
     // instead of silently emitting an empty typed client.
     if (tableNames.length === 0 && !args.allowEmpty) {
         (0, ui_js_1.newline)();
-        (0, ui_js_1.error)(`Introspection matched 0 tables in schema ${(0, ui_js_1.cyan)(config.schema)} — refusing to generate an empty client.`);
+        (0, ui_js_1.error)(`Introspection matched 0 tables in schema ${(0, ui_js_1.cyan)(config.schema)}, refusing to generate an empty client.`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.dim)('Common causes:')}`);
         console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('schema')} ${(0, ui_js_1.dim)('points at the wrong Postgres namespace')} ${(0, ui_js_1.dim)('(it is the schema NAME, default')} ${(0, ui_js_1.cyan)('public')}${(0, ui_js_1.dim)(').')}`);
         console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.dim)('You meant to set')} ${(0, ui_js_1.cyan)('schemaFile')} ${(0, ui_js_1.dim)('(your defineSchema() file), not')} ${(0, ui_js_1.cyan)('schema')}${(0, ui_js_1.dim)('.')}`);
         console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('include')}/${(0, ui_js_1.cyan)('exclude')} ${(0, ui_js_1.dim)('filtered out every table.')}`);
-        console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.dim)('The database has no tables yet — run')} ${(0, ui_js_1.cyan)('turbine push')} ${(0, ui_js_1.dim)('or a migration first.')}`);
+        console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.dim)('The database has no tables yet, run')} ${(0, ui_js_1.cyan)('turbine push')} ${(0, ui_js_1.dim)('or a migration first.')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.dim)('If an empty client is genuinely what you want, re-run with')} ${(0, ui_js_1.cyan)('--allow-empty')}${(0, ui_js_1.dim)('.')}`);
         (0, ui_js_1.newline)();
@@ -1296,6 +1298,7 @@ async function cmdMigrateFromPrisma(args, config) {
             includeViews: true,
             // Inherit the shared bookkeeping-table exclusions (Turbine + Prisma).
             exclude: [...new Set([...config.exclude, ...prisma_resolve_js_1.DEFAULT_EXCLUDED_TABLES])],
+            relationNames: config.relationNames,
         });
         spinner.succeed(`Introspected ${(0, ui_js_1.bold)(String(Object.keys(schemaMeta.tables).length))} tables`);
     }
@@ -1431,7 +1434,7 @@ async function cmdPush(args, config) {
         (0, ui_js_1.newline)();
     }
     if (args.dryRun) {
-        (0, ui_js_1.info)('Dry run — no changes applied.');
+        (0, ui_js_1.info)('Dry run, no changes applied.');
         (0, ui_js_1.newline)();
         return;
     }
@@ -1480,7 +1483,7 @@ async function cmdMigrate(args, config) {
     const sub = args.subcommand;
     if (!sub || sub === 'help') {
         (0, ui_js_1.banner)();
-        console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} ${(0, ui_js_1.dim)('— SQL-first migration system')}`);
+        console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} ${(0, ui_js_1.dim)(', SQL-first migration system')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.bold)('Commands:')}`);
         console.log(`    ${(0, ui_js_1.cyan)('create <name>')}             Create a new migration file`);
@@ -1759,16 +1762,16 @@ async function cmdMigrateUp(args, config) {
         (0, ui_js_1.newline)();
         return;
     }
-    // Big, loud warning when bypassing drift detection — this is a deliberately
+    // Big, loud warning when bypassing drift detection, this is a deliberately
     // dangerous operation and the user should see it on every invocation.
     if (args.allowDrift) {
-        (0, ui_js_1.warn)('--allow-drift is set — checksum validation is DISABLED for this run.');
+        (0, ui_js_1.warn)('--allow-drift is set, checksum validation is DISABLED for this run.');
         console.log(`  ${(0, ui_js_1.dim)('Applied migrations may have been modified or deleted on disk.')}`);
         console.log(`  ${(0, ui_js_1.dim)('Proceed only if you are intentionally rewriting migration history.')}`);
         (0, ui_js_1.newline)();
     }
     if (args.allowDestructive) {
-        (0, ui_js_1.warn)('--allow-destructive is set — data-destroying statements in migrations WILL run.');
+        (0, ui_js_1.warn)('--allow-destructive is set, data-destroying statements in migrations WILL run.');
         (0, ui_js_1.newline)();
     }
     const spinner = new ui_js_1.Spinner('Applying migrations').start();
@@ -1797,7 +1800,7 @@ async function cmdMigrateUp(args, config) {
             throw err;
         spinner.stop();
         if (!(await confirmDestructive(err.message))) {
-            (0, ui_js_1.error)('Aborted — no migrations were applied and no data was touched.');
+            (0, ui_js_1.error)('Aborted, no migrations were applied and no data was touched.');
             (0, ui_js_1.newline)();
             process.exit(1);
         }
@@ -1945,7 +1948,7 @@ function isDestructiveRefusal(err) {
  *   1. show the full itemized report (statement kinds + targets),
  *   2. require typing the literal phrase `destroy my data`,
  *   3. require a final explicit `yes`.
- * Non-interactive shells (CI, pipes) can never pass this — they must use the
+ * Non-interactive shells (CI, pipes) can never pass this, they must use the
  * explicit `--allow-destructive` flag instead. Anything but exact answers aborts.
  */
 async function confirmDestructive(report) {
@@ -1967,7 +1970,7 @@ async function confirmDestructive(report) {
         const phrase = await rl.question(`  Type ${(0, ui_js_1.bold)('destroy my data')} to continue, anything else to abort: `);
         if (phrase.trim() !== 'destroy my data')
             return false;
-        const finalAnswer = await rl.question(`  Final confirmation — apply the destructive statements above? Type ${(0, ui_js_1.bold)('yes')}: `);
+        const finalAnswer = await rl.question(`  Final confirmation, apply the destructive statements above? Type ${(0, ui_js_1.bold)('yes')}: `);
         return finalAnswer.trim() === 'yes';
     }
     finally {
@@ -1993,7 +1996,7 @@ async function cmdMigrateDown(args, config) {
             throw err;
         spinner.stop();
         if (!(await confirmDestructive(err.message))) {
-            (0, ui_js_1.error)('Aborted — nothing was rolled back and no data was touched.');
+            (0, ui_js_1.error)('Aborted, nothing was rolled back and no data was touched.');
             (0, ui_js_1.newline)();
             process.exit(1);
         }
@@ -2083,7 +2086,7 @@ async function cmdMigrateStatus(_args, config) {
                     .toISOString()
                     .replace('T', ' ')
                     .replace(/\.\d+Z$/, ' UTC'))
-                : (0, ui_js_1.dim)('—'),
+                : (0, ui_js_1.dim)('-'),
         ];
     });
     console.log((0, ui_js_1.table)(headers, rows));
@@ -2113,7 +2116,7 @@ async function runSeedPlan(plan, config) {
     try {
         if (plan.kind === 'tsx') {
             if (!(0, loader_js_1.canResolveTsx)()) {
-                throw new Error('TypeScript seed files require tsx — install tsx or use seed.js/seed.sql.');
+                throw new Error('TypeScript seed files require tsx, install tsx or use seed.js/seed.sql.');
             }
             // The seed runs in a child process, so we cannot observe its callback
             // directly. Hand it a sentinel path: `defineSeed`'s runner writes the file
@@ -2214,6 +2217,7 @@ async function cmdStatus(_args, config) {
         schema: config.schema,
         include: config.include.length ? config.include : undefined,
         exclude: config.exclude.length ? config.exclude : undefined,
+        relationNames: config.relationNames,
     });
     const tableNames = Object.keys(schema.tables);
     spinner.succeed(`Found ${(0, ui_js_1.bold)(String(tableNames.length))} tables`);
@@ -2677,7 +2681,7 @@ function isLoopbackHost(host) {
     return h === '127.0.0.1' || h === 'localhost' || h === '::1' || h === '[::1]';
 }
 // ---------------------------------------------------------------------------
-// Command: studio — local read-only web UI
+// Command: studio, local read-only web UI
 // ---------------------------------------------------------------------------
 async function cmdStudio(args, config) {
     (0, ui_js_1.banner)();
@@ -2693,7 +2697,7 @@ async function cmdStudio(args, config) {
         process.exit(1);
     }
     // Non-loopback binds require an explicit --allow-remote opt-in. Studio has
-    // only a random session token — exposing it on a LAN interface is foot-gun
+    // only a random session token, exposing it on a LAN interface is foot-gun
     // territory, so we refuse rather than warn-and-proceed.
     if (!isLoopbackHost(host)) {
         if (!args.allowRemote) {
@@ -2704,7 +2708,7 @@ async function cmdStudio(args, config) {
             (0, ui_js_1.newline)();
             process.exit(1);
         }
-        console.log((0, ui_js_1.warn)(`Studio is binding to ${(0, ui_js_1.yellow)(host)} — this is NOT loopback. ` +
+        console.log((0, ui_js_1.warn)(`Studio is binding to ${(0, ui_js_1.yellow)(host)}, this is NOT loopback. ` +
             `Anyone on your network who can reach this port + guess the session token can read your database.`));
     }
     const spinner = new ui_js_1.Spinner(demo ? 'Seeding demo dataset' : 'Introspecting database').start();
@@ -2804,7 +2808,7 @@ async function cmdStudio(args, config) {
     });
 }
 // ---------------------------------------------------------------------------
-// Command: mcp — read-only JSON-RPC stdio server
+// Command: mcp, read-only JSON-RPC stdio server
 // ---------------------------------------------------------------------------
 async function cmdMcp(_args, config) {
     const url = requireUrl(config);
@@ -2849,7 +2853,7 @@ async function cmdObserve(args) {
             (0, ui_js_1.newline)();
             process.exit(1);
         }
-        console.log((0, ui_js_1.warn)(`Observe is binding to ${(0, ui_js_1.yellow)(host)} — this is NOT loopback. ` +
+        console.log((0, ui_js_1.warn)(`Observe is binding to ${(0, ui_js_1.yellow)(host)}, this is NOT loopback. ` +
             `Anyone on your network who can reach this port + guess the session token can read your metrics.`));
     }
     const spinner = new ui_js_1.Spinner('Connecting to metrics database').start();
@@ -2864,7 +2868,7 @@ async function cmdObserve(args) {
     }
     (0, ui_js_1.newline)();
     console.log((0, ui_js_1.box)([
-        `${(0, ui_js_1.bold)('Turbine Observe')}  ${(0, ui_js_1.dim)('— query metrics dashboard')}`,
+        `${(0, ui_js_1.bold)('Turbine Observe')}  ${(0, ui_js_1.dim)(', query metrics dashboard')}`,
         '',
         `  ${(0, ui_js_1.cyan)('URL:')}  ${(0, ui_js_1.bold)(handle.url)}`,
         '',
@@ -2911,7 +2915,7 @@ function showSubcommandHelp(command) {
 }
 function showInitHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine init')} — Initialize a Turbine project`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine init')}, Initialize a Turbine project`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine init ${(0, ui_js_1.dim)('[options]')}`);
@@ -2936,16 +2940,16 @@ function showInitHelp() {
 }
 function showGenerateHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine generate')} — Introspect database and generate TypeScript types`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine generate')}, Introspect database and generate TypeScript types`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine generate ${(0, ui_js_1.dim)('[options]')}`);
     (0, ui_js_1.newline)();
     console.log(`  Connects to your database, reads the schema, and generates:`);
-    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('types.ts')}    — Entity interfaces, Create/Update input types`);
-    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('metadata.ts')} — Runtime schema metadata`);
-    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('index.ts')}    — Configured client with typed table accessors`);
-    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('zod.ts')}      — Zod schemas ${(0, ui_js_1.dim)('(with --zod)')}`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('types.ts')}   , Entity interfaces, Create/Update input types`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('metadata.ts')}, Runtime schema metadata`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('index.ts')}   , Configured client with typed table accessors`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('zod.ts')}     , Zod schemas ${(0, ui_js_1.dim)('(with --zod)')}`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}       Postgres connection string`);
@@ -2993,7 +2997,7 @@ function showMigrateFromPrismaHelp() {
 }
 function showPushHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine push')} — Apply schema-builder definitions to database`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine push')}, Apply schema-builder definitions to database`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine push ${(0, ui_js_1.dim)('[options]')}`);
@@ -3010,7 +3014,7 @@ function showPushHelp() {
 }
 function showMigrateHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} — SQL migration management`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine migrate')}, SQL migration management`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine migrate ${(0, ui_js_1.cyan)('<subcommand>')} ${(0, ui_js_1.dim)('[options]')}`);
@@ -3029,7 +3033,7 @@ function showMigrateHelp() {
     console.log(`    ${(0, ui_js_1.cyan)('--recipe')} ${(0, ui_js_1.dim)('<name>')}   Scaffold a sanctioned migration pattern ${(0, ui_js_1.dim)('(create only, e.g. backfill)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--step, -n')} ${(0, ui_js_1.dim)('<N>')}    Number of migrations to apply/rollback`);
     console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}         Show SQL without executing`);
-    console.log(`    ${(0, ui_js_1.cyan)('--allow-drift')}     Bypass checksum validation ${(0, ui_js_1.dim)('(migrate up only — advanced)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--allow-drift')}     Bypass checksum validation ${(0, ui_js_1.dim)('(migrate up only, advanced)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--allow-destructive')} Run data-destroying migration statements without the interactive confirm`);
     console.log(`    ${(0, ui_js_1.cyan)('--verbose, -v')}     Show detailed output`);
     (0, ui_js_1.newline)();
@@ -3046,7 +3050,7 @@ function showMigrateHelp() {
 }
 function showSeedHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine seed')} — Run seed file`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine seed')}, Run seed file`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine seed ${(0, ui_js_1.dim)('[options]')}`);
@@ -3062,7 +3066,7 @@ function showSeedHelp() {
 }
 function showStatusHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine status')} — Show database schema summary`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine status')}, Show database schema summary`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine status ${(0, ui_js_1.dim)('[options]')}`);
@@ -3077,7 +3081,7 @@ function showStatusHelp() {
 }
 function showMcpHelp() {
     (0, ui_js_1.banner)();
-    console.log(`  ${(0, ui_js_1.bold)('turbine mcp')} — Start read-only MCP server over stdio`);
+    console.log(`  ${(0, ui_js_1.bold)('turbine mcp')}, Start read-only MCP server over stdio`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine mcp ${(0, ui_js_1.dim)('[options]')}`);

package/dist/cjs/cli/loader.d.ts

@@ -1,5 +1,5 @@
 /**
- * turbine-orm CLI — TypeScript loader registration
+ * turbine-orm CLI, TypeScript loader registration
  *
  * The CLI loads user-supplied config and schema files via dynamic `import()`.
  * Plain Node has no built-in `.ts` loader, so importing `turbine.config.ts`
@@ -12,16 +12,16 @@
  *   2. Prefer tsx's supported programmatic API, `tsx/esm/api`'s `register()`.
  *      Calling Node's `module.register('tsx/esm', ...)` directly throws
  *      "tsx must be loaded with --import instead of --loader" on every Node
- *      version that has `module.register()` (>= 20.6) — tsx's hook file
+ *      version that has `module.register()` (>= 20.6), tsx's hook file
  *      guards against being loaded that way. The `tsx/esm/api` entry point
  *      is the documented path and works everywhere `module.register()` does.
  *   3. Fall back to `module.register('tsx/esm', ...)` only for very old tsx
  *      versions (< 4.0) that predate `tsx/esm/api`.
  *   4. If tsx isn't installed, or registration genuinely fails, surface an
- *      actionable error — including the REAL underlying error message, never
+ *      actionable error, including the REAL underlying error message, never
  *      a misdiagnosed "tsx is not installed".
  *
- * `tsx` is intentionally NOT a runtime dependency — many projects already
+ * `tsx` is intentionally NOT a runtime dependency, many projects already
  * have it, and adding a heavy dev tool to a 1-dependency ORM would be silly.
  */
 /**
@@ -45,7 +45,7 @@ export type TsLoaderStatus = 'registered' | 'already' | 'unsupported' | 'missing
 export declare function getTsLoaderError(): string | null;
 /**
  * Register the tsx ESM loader so subsequent dynamic imports of `.ts` files
- * work. Safe to call multiple times — internal flag prevents double registration.
+ * work. Safe to call multiple times, internal flag prevents double registration.
  *
  * Returns:
  *   - 'registered'  loader was successfully registered this call
@@ -53,9 +53,9 @@ export declare function getTsLoaderError(): string | null;
  *   - 'unsupported' Node lacks `module.register()` (Node < 20.6) and tsx has
  *                   no programmatic API to fall back to
  *   - 'missing'     `tsx` is not installed in the user's project
- *   - 'failed'      tsx IS installed but registration threw — see
+ *   - 'failed'      tsx IS installed but registration threw, see
  *                   {@link getTsLoaderError} for the underlying message
  */
 export declare function registerTsLoader(): Promise<TsLoaderStatus>;
-/** Reset the loader state — used by unit tests only. */
+/** Reset the loader state, used by unit tests only. */
 export declare function _resetTsLoaderStateForTests(): void;

package/dist/cjs/cli/loader.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * turbine-orm CLI — TypeScript loader registration
+ * turbine-orm CLI, TypeScript loader registration
  *
  * The CLI loads user-supplied config and schema files via dynamic `import()`.
  * Plain Node has no built-in `.ts` loader, so importing `turbine.config.ts`
@@ -13,16 +13,16 @@
  *   2. Prefer tsx's supported programmatic API, `tsx/esm/api`'s `register()`.
  *      Calling Node's `module.register('tsx/esm', ...)` directly throws
  *      "tsx must be loaded with --import instead of --loader" on every Node
- *      version that has `module.register()` (>= 20.6) — tsx's hook file
+ *      version that has `module.register()` (>= 20.6), tsx's hook file
  *      guards against being loaded that way. The `tsx/esm/api` entry point
  *      is the documented path and works everywhere `module.register()` does.
  *   3. Fall back to `module.register('tsx/esm', ...)` only for very old tsx
  *      versions (< 4.0) that predate `tsx/esm/api`.
  *   4. If tsx isn't installed, or registration genuinely fails, surface an
- *      actionable error — including the REAL underlying error message, never
+ *      actionable error, including the REAL underlying error message, never
  *      a misdiagnosed "tsx is not installed".
  *
- * `tsx` is intentionally NOT a runtime dependency — many projects already
+ * `tsx` is intentionally NOT a runtime dependency, many projects already
  * have it, and adding a heavy dev tool to a 1-dependency ORM would be silly.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -109,7 +109,7 @@ function getTsLoaderError() {
 }
 /**
  * Register the tsx ESM loader so subsequent dynamic imports of `.ts` files
- * work. Safe to call multiple times — internal flag prevents double registration.
+ * work. Safe to call multiple times, internal flag prevents double registration.
  *
  * Returns:
  *   - 'registered'  loader was successfully registered this call
@@ -117,7 +117,7 @@ function getTsLoaderError() {
  *   - 'unsupported' Node lacks `module.register()` (Node < 20.6) and tsx has
  *                   no programmatic API to fall back to
  *   - 'missing'     `tsx` is not installed in the user's project
- *   - 'failed'      tsx IS installed but registration threw — see
+ *   - 'failed'      tsx IS installed but registration threw, see
  *                   {@link getTsLoaderError} for the underlying message
  */
 async function registerTsLoader() {
@@ -150,14 +150,14 @@ async function registerTsLoader() {
             return 'failed';
         }
     }
-    // tsx/esm/api not resolvable — is tsx installed at all?
+    // tsx/esm/api not resolvable, is tsx installed at all?
     if (!canResolveTsx()) {
         tsLoaderState = 'missing';
         return 'missing';
     }
     // Legacy fallback for tsx < 4.0 (no tsx/esm/api): Node's module.register.
     // On tsx >= 4.19 this path throws ("tsx must be loaded with --import
-    // instead of --loader") — but those versions all ship tsx/esm/api, so we
+    // instead of --loader"), but those versions all ship tsx/esm/api, so we
     // only land here for genuinely old installs.
     try {
         const mod = await Promise.resolve().then(() => __importStar(require('node:module')));
@@ -177,7 +177,7 @@ async function registerTsLoader() {
         return 'failed';
     }
 }
-/** Reset the loader state — used by unit tests only. */
+/** Reset the loader state, used by unit tests only. */
 function _resetTsLoaderStateForTests() {
     tsLoaderState = null;
     tsLoaderError = null;

package/dist/cjs/cli/mcp.js

@@ -80,7 +80,7 @@ const TOOLS = [
     },
     {
         name: 'explain_query',
-        description: 'Run EXPLAIN (FORMAT JSON) for a schema-validated findMany query. Pass table + optional where/orderBy/limit/select — free-form SQL is rejected.',
+        description: 'Run EXPLAIN (FORMAT JSON) for a schema-validated findMany query. Pass table + optional where/orderBy/limit/select, free-form SQL is rejected.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -330,7 +330,7 @@ async function doctorReport(ctx) {
     });
 }
 /**
- * EXPLAIN a schema-validated findMany query. Free-form SQL is never accepted —
+ * EXPLAIN a schema-validated findMany query. Free-form SQL is never accepted -
  * table/field identifiers are checked against introspected metadata and the
  * SELECT is compiled by QueryInterface (same stance as Studio `/api/builder`).
  */
@@ -372,7 +372,7 @@ async function explainQuery(ctx, args) {
 }
 /**
  * Extract the allowed findMany subset for explain_query (no `with` / raw SQL).
- * Returns a plain object cast at the buildFindMany call site — same pattern as Studio.
+ * Returns a plain object cast at the buildFindMany call site, same pattern as Studio.
  */
 function parseExplainFindManyArgs(args) {
     const findManyArgs = {};
@@ -650,7 +650,7 @@ function buildRelations(tableNames, columnsByTable, pkByTable, rows, enums = {})
     for (const [tbl, cols] of columnsByTable) {
         columnFieldsByTable.set(tbl, new Set(cols.map((c) => c.field)));
         // Enum-typed columns also report tsType 'unknown', but the generated type
-        // layer gives them a concrete union — only json/jsonb qualify as shadows.
+        // layer gives them a concrete union, only json/jsonb qualify as shadows.
         unknownTypedFieldsByTable.set(tbl, new Set(cols.filter((c) => (0, introspect_js_1.isUnknownTsType)(c.tsType) && !Object.hasOwn(enums, c.pgType)).map((c) => c.field)));
     }
     const relations = (0, introspect_js_1.buildRelationsFromForeignKeys)(foreignKeys, columnFieldsByTable, undefined, unknownTypedFieldsByTable);

package/dist/cjs/cli/migrate.d.ts

@@ -1,5 +1,5 @@
 /**
- * turbine-orm CLI — Migration system
+ * turbine-orm CLI, Migration system
  *
  * SQL-first migrations with UP/DOWN sections, tracked in _turbine_migrations.
  * Migration files are timestamp-prefixed .sql files.
@@ -22,7 +22,7 @@ export interface MigrationFile {
     path: string;
     /** Extracted name portion (e.g. "20260325120000_create_users") */
     name: string;
-    /** Timestamp prefix (e.g. "20260325120000") — YYYYMMDDHHMMSS */
+    /** Timestamp prefix (e.g. "20260325120000"), YYYYMMDDHHMMSS */
     timestamp: string;
 }
 export interface AppliedMigration {
@@ -95,7 +95,7 @@ export declare function sanitizeName(name: string): string;
  */
 export declare function formatTimestamp(date: Date): string;
 /**
- * Get pending migration files — those not yet applied.
+ * Get pending migration files, those not yet applied.
  * Returns files sorted by timestamp (ascending).
  */
 export declare function getPendingMigrations(migrationsDir: string, applied: string[]): MigrationFile[];
@@ -227,7 +227,7 @@ export declare function createMigration(migrationsDir: string, name: string, aut
 /**
  * Derive a Postgres advisory lock ID (positive int4) from the database name.
  *
- * Uses FNV-1a 32-bit hash — a well-known, stable, non-cryptographic hash with
+ * Uses FNV-1a 32-bit hash, a well-known, stable, non-cryptographic hash with
  * excellent distribution over short strings (database names are typically <64
  * chars). Chosen over alternatives because it's:
  *   - deterministic (same input → same output, across processes/machines)
@@ -297,7 +297,7 @@ export declare function inspectMigrationDeploy(connectionString: string, migrati
  * Features:
  * - Idempotent: running twice is safe (already-applied migrations are skipped)
  * - Advisory lock: prevents concurrent migration runs
- * - Checksum validation: detects modified migration files (BLOCKING — use
+ * - Checksum validation: detects modified migration files (BLOCKING, use
  *   `allowDrift: true` to bypass when intentionally rewriting history)
  * - Each migration runs in its own transaction
  *

package/dist/cjs/cli/migrate.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * turbine-orm CLI — Migration system
+ * turbine-orm CLI, Migration system
  *
  * SQL-first migrations with UP/DOWN sections, tracked in _turbine_migrations.
  * Migration files are timestamp-prefixed .sql files.
@@ -138,7 +138,7 @@ function formatTimestamp(date) {
     ].join('');
 }
 /**
- * Get pending migration files — those not yet applied.
+ * Get pending migration files, those not yet applied.
  * Returns files sorted by timestamp (ascending).
  */
 function getPendingMigrations(migrationsDir, applied) {
@@ -642,7 +642,7 @@ ${autoContent.down}
 /**
  * Derive a Postgres advisory lock ID (positive int4) from the database name.
  *
- * Uses FNV-1a 32-bit hash — a well-known, stable, non-cryptographic hash with
+ * Uses FNV-1a 32-bit hash, a well-known, stable, non-cryptographic hash with
  * excellent distribution over short strings (database names are typically <64
  * chars). Chosen over alternatives because it's:
  *   - deterministic (same input → same output, across processes/machines)
@@ -759,7 +759,7 @@ function formatChecksumMismatchError(mismatches) {
     const modified = mismatches.filter((m) => m.type === 'modified');
     const missing = mismatches.filter((m) => m.type === 'missing');
     const lines = [
-        '[turbine] Migration drift detected — refusing to apply pending migrations.',
+        '[turbine] Migration drift detected, refusing to apply pending migrations.',
         '',
         'Applied migrations should be immutable. The following files no longer match their applied state:',
         '',
@@ -781,7 +781,7 @@ function formatChecksumMismatchError(mismatches) {
     if (missing.length > 0) {
         lines.push('     (deleted files cannot be rolled back: restore the file, then run `migrate down` if needed), OR');
     }
-    lines.push('  3. Pass `--allow-drift` to bypass this check (advanced — make sure you know what you are doing).');
+    lines.push('  3. Pass `--allow-drift` to bypass this check (advanced, make sure you know what you are doing).');
     return lines.join('\n');
 }
 /**
@@ -850,7 +850,7 @@ async function inspectMigrationDeploy(connectionString, migrationsDir) {
  * Features:
  * - Idempotent: running twice is safe (already-applied migrations are skipped)
  * - Advisory lock: prevents concurrent migration runs
- * - Checksum validation: detects modified migration files (BLOCKING — use
+ * - Checksum validation: detects modified migration files (BLOCKING, use
  *   `allowDrift: true` to bypass when intentionally rewriting history)
  * - Each migration runs in its own transaction
  *
@@ -874,7 +874,7 @@ async function migrateUp(connectionString, migrationsDir, options) {
         const adapter = options?.adapter;
         const gotLock = await acquireLock(client, lockId, adapter);
         if (!gotLock) {
-            throw new errors_js_1.MigrationError('[turbine] Could not acquire migration lock — another migration is already running');
+            throw new errors_js_1.MigrationError('[turbine] Could not acquire migration lock, another migration is already running');
         }
         try {
             await ensureTrackingTable(client, dialect);
@@ -911,7 +911,7 @@ async function migrateUp(connectionString, migrationsDir, options) {
             // Data-loss gate: refuse to run pending migrations containing destructive
             // statements unless the caller has EXPLICITLY opted in. The CLI layers an
             // interactive typed confirmation on top of this; programmatic callers must
-            // pass `allowDestructive: true`. Safe-by-default is the whole point — a
+            // pass `allowDestructive: true`. Safe-by-default is the whole point, a
             // DROP TABLE should never run just because a file exists.
             if (!options?.allowDestructive && destructive.length > 0) {
                 const lines = ['[turbine] Refusing to apply migrations containing DESTRUCTIVE statements:', ''];
@@ -1025,7 +1025,7 @@ async function migrateDown(connectionString, migrationsDir, options) {
         const adapter = options?.adapter;
         const gotLock = await acquireLock(client, lockId, adapter);
         if (!gotLock) {
-            throw new errors_js_1.MigrationError('[turbine] Could not acquire migration lock — another migration is already running');
+            throw new errors_js_1.MigrationError('[turbine] Could not acquire migration lock, another migration is already running');
         }
         try {
             await ensureTrackingTable(client, dialect);
@@ -1035,9 +1035,9 @@ async function migrateDown(connectionString, migrationsDir, options) {
             }
             const allFiles = listMigrationFiles(migrationsDir);
             const fileMap = new Map(allFiles.map((f) => [f.name, f]));
-            // Reverse order — rollback most recent first
+            // Reverse order, rollback most recent first
             const toRollback = applied.reverse().slice(0, options?.step ?? 1);
-            // Same data-loss gate as migrateUp — DOWN sections routinely contain
+            // Same data-loss gate as migrateUp, DOWN sections routinely contain
             // DROP TABLE (the legitimate reverse of a CREATE), which still destroys
             // every row written since the migration ran. Explicit opt-in required.
             if (!options?.allowDestructive) {