@cleverbrush/orm-cli 4.3.2 → 4.4.0

package/README.md

@@ -8,6 +8,7 @@ cb-orm migrate generate [name]   # diff DB → schema, emit TS migration file (n
 cb-orm migrate run               # apply pending migrations
 cb-orm migrate rollback          # roll back last batch
 cb-orm migrate status            # list applied/pending migrations
+cb-orm validate                  # check entity schemas against the live DB (read-only)
 cb-orm db push                   # sync schema in-place (dev only)
 ```
 
@@ -57,6 +58,7 @@ export default defineConfig({
     "db:run":      "cb-orm migrate run",
     "db:rollback": "cb-orm migrate rollback",
     "db:status":   "cb-orm migrate status",
+    "db:validate": "cb-orm validate",
     "db:push":     "cb-orm db push"
   }
 }
@@ -122,6 +124,19 @@ npx cb-orm migrate status
 #   ○ 20260423120000_add_role_column.ts
 ```
 
+### `validate`
+
+Checks every configured entity against the live database without applying
+changes, writing migration files, or updating snapshots. It exits with status
+`1` when a table is missing or a schema diff is detected.
+
+```sh
+npx cb-orm validate
+# Schema is in sync (4 table(s) checked).
+```
+
+Use this in CI before deploys when you want to fail fast on schema drift.
+
 ### `db push`
 
 Applies all schema changes directly to the database **without** writing a
@@ -160,6 +175,7 @@ The CLI delegates all schema intelligence to `@cleverbrush/knex-schema`:
 | Diff schema vs DB | `diffSchema(schema, dbState)` |
 | Generate ALTER TABLE source | `generateMigration(diff, tableName)` |
 | Apply diff without file | `applyDiff(knex, diff, tableName)` |
+| Validate without changes | `validateEntitiesAgainstDatabase(knex, entities)` |
 | Polymorphic variant tables | `getPolymorphicVariantSchemas(schema)` |
 
 `tsx` is used to load `db.config.ts` at runtime by registering the

package/dist/bin.js

@@ -3,5 +3,5 @@
 // src/bin.ts
 import { register } from "tsx/esm/api";
 register();
-var { run } = await import("./cli-Q4EBNEOJ.js");
+var { run } = await import("./cli-AOZENPBD.js");
 await run(process.argv.slice(2));

package/dist/{cli-Q4EBNEOJ.js → cli-AOZENPBD.js}

@@ -66,11 +66,16 @@ async function run(argv) {
     console.log(_pkg.version ?? "unknown");
     return;
   }
-  const flags = parseFlags(rest);
+  const flagArgs = sub?.startsWith("--") ? [sub, ...rest] : rest;
+  const flags = parseFlags(flagArgs);
   const configPath = flags["--config"];
   let loadedConfig;
   try {
-    if (cmd === "migrate") {
+    if (cmd === "validate") {
+      loadedConfig = await loadConfig(configPath);
+      const { validate } = await import("./validate-KJTRW3BY.js");
+      await validate(loadedConfig);
+    } else if (cmd === "migrate") {
       switch (sub) {
         case "generate": {
           let name = "migration";
@@ -180,6 +185,7 @@ COMMANDS
   migrate run               Apply pending migrations  (knex.migrate.latest)
   migrate rollback          Roll back last batch      (knex.migrate.rollback)
   migrate status            List applied and pending migrations
+  validate                  Check entity schemas against the live DB (read-only)
   db push                   Sync schema to DB in-place (dev only \u2014 no migration file)
 
 OPTIONS

package/dist/commands/validate.d.ts

@@ -0,0 +1,7 @@
+import type { OrmCliConfig } from '../types.js';
+/**
+ * Validate every configured entity against the live database.
+ *
+ * Exits with status 1 when a table is missing or schema drift is detected.
+ */
+export declare function validate(config: OrmCliConfig): Promise<void>;

package/dist/validate-KJTRW3BY.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+// src/commands/validate.ts
+import { validateEntitiesAgainstDatabase } from "@cleverbrush/knex-schema";
+async function validate(config) {
+  const result = await validateEntitiesAgainstDatabase(
+    config.knex,
+    Object.values(config.entities)
+  );
+  if (result.valid) {
+    console.log(
+      `Schema is in sync (${result.checkedTables.length} table(s) checked).`
+    );
+    return;
+  }
+  console.error("Schema drift detected:");
+  for (const issue of result.issues) {
+    if (issue.type === "missing-table") {
+      console.error(`  - Missing table: ${issue.tableName}`);
+    } else {
+      console.error(
+        `  - Drift in ${issue.tableName}: ${summarizeDiff(issue.diff)}`
+      );
+    }
+  }
+  process.exit(1);
+}
+function summarizeDiff(diff) {
+  const parts = [
+    formatCount(diff.addColumns.length, "column to add", "columns to add"),
+    formatCount(
+      diff.dropColumns.length,
+      "column to drop",
+      "columns to drop"
+    ),
+    formatCount(
+      diff.alterColumns.length,
+      "column to alter",
+      "columns to alter"
+    ),
+    formatCount(diff.addIndexes.length, "index to add", "indexes to add"),
+    formatCount(
+      diff.dropIndexes.length,
+      "index to drop",
+      "indexes to drop"
+    ),
+    formatCount(
+      diff.addForeignKeys.length,
+      "foreign key to add",
+      "foreign keys to add"
+    ),
+    formatCount(
+      diff.dropForeignKeys.length,
+      "foreign key to drop",
+      "foreign keys to drop"
+    )
+  ].filter((part) => part !== null);
+  return parts.length > 0 ? parts.join(", ") : "unknown drift";
+}
+function formatCount(count, singular, plural) {
+  if (count === 0) return null;
+  return `${count} ${count === 1 ? singular : plural}`;
+}
+export {
+  validate
+};

package/package.json

@@ -48,5 +48,5 @@
     },
     "type": "module",
     "types": "./dist/index.d.ts",
-    "version": "4.3.2"
+    "version": "4.4.0"
 }