@mostajs/orm-cli 0.3.2 → 0.4.0

package/bin/install-bridge.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+// install-bridge.mjs — one-shot codemod : scan a Prisma project, find every
+// file that instantiates PrismaClient, and rewrite it to use
+// createPrismaLikeDb() from @mostajs/orm-bridge.
+//
+// Author: Dr Hamid MADANI drmdh@msn.com
+// License: AGPL-3.0-or-later
+//
+// Usage (invoked by bin/mostajs.sh  as `mostajs install-bridge`) :
+//
+//   node install-bridge.mjs              # dry-run (default, safe)
+//   node install-bridge.mjs --apply      # actually write files
+//   node install-bridge.mjs --file X     # restrict to a single file
+//   node install-bridge.mjs --project P  # root to scan (default: cwd)
+//   node install-bridge.mjs --restore    # restore from .prisma.bak backups
+//
+// The rewriter is deliberately conservative :
+//   - It only touches files that CREATE a PrismaClient (`new PrismaClient(...)`).
+//   - It preserves the original export name (`prisma`, `db`, `client`, `default`)
+//     so none of the 10 to 10000 call-sites elsewhere in the codebase need to change.
+//   - Original file is saved as <path>.prisma.bak (never overwritten).
+//   - Re-runs are idempotent : if the file already uses createPrismaLikeDb,
+//     the codemod skips it.
+
+import { readFileSync, writeFileSync, readdirSync, statSync, existsSync, renameSync, copyFileSync } from 'node:fs';
+import { join, resolve, relative, extname } from 'node:path';
+
+// ---------- CLI ----------
+const argv = process.argv.slice(2);
+const flag = (name) => argv.includes(`--${name}`);
+const val  = (name) => { const i = argv.indexOf(`--${name}`); return i >= 0 ? argv[i + 1] : null; };
+
+const APPLY    = flag('apply');
+const RESTORE  = flag('restore');
+const ONE_FILE = val('file');
+const ROOT     = resolve(val('project') ?? process.cwd());
+const QUIET    = flag('quiet');
+
+const log = (...a) => { if (!QUIET) console.log(...a); };
+const c   = { cyan: s => `\x1b[36m${s}\x1b[0m`, yellow: s => `\x1b[33m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`, red: s => `\x1b[31m${s}\x1b[0m`, bold: s => `\x1b[1m${s}\x1b[0m`, dim: s => `\x1b[2m${s}\x1b[0m` };
+
+// ---------- Walk ----------
+const SKIP_DIRS = new Set(['node_modules', '.next', '.svelte-kit', 'dist', 'build', '.turbo', '.vercel', '.cache', 'coverage', '.git', '.vscode', '.idea']);
+const EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.js', '.jsx', '.mjs']);
+
+function* walk(dir) {
+  let entries;
+  try { entries = readdirSync(dir); } catch { return; }
+  for (const name of entries) {
+    if (SKIP_DIRS.has(name)) continue;
+    const p = join(dir, name);
+    let st;
+    try { st = statSync(p); } catch { continue; }
+    if (st.isDirectory()) yield* walk(p);
+    else if (EXTENSIONS.has(extname(name))) yield p;
+  }
+}
+
+// ---------- Detection ----------
+// Patterns we consider "PrismaClient instantiation sites"
+const RX_IMPORT = /import\s*(?:\{[^}]*PrismaClient[^}]*\}|[^;]*?)\s*from\s*['"]@prisma\/client['"]/;
+const RX_NEW    = /new\s+PrismaClient\s*\(/;
+const RX_ALREADY = /@mostajs\/orm-bridge\/prisma-client/;
+
+// Detect the export shape to preserve the name the codebase depends on.
+//   export const db = new PrismaClient(...)       → named, "db"
+//   export const prisma = new PrismaClient(...)   → named, "prisma"
+//   export default new PrismaClient(...)          → default
+//   const prisma = ...; export { prisma }         → named, "prisma"
+function detectExportShape(source) {
+  // Singleton pattern commonly used in Next.js :
+  //   const g = globalThis as ... { prisma: ... }
+  //   export const db = g.prisma ?? new PrismaClient()
+  const mNamed = source.match(/export\s+const\s+(\w+)\s*=\s*(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mNamed) return { kind: 'const', name: mNamed[1] };
+
+  const mLet = source.match(/export\s+let\s+(\w+)\s*=\s*(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mLet) return { kind: 'let', name: mLet[1] };
+
+  const mDefault = source.match(/export\s+default\s+(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mDefault) return { kind: 'default', name: null };
+
+  // Bare global : const prisma = new PrismaClient(); followed somewhere by `export { prisma }` or not
+  const mBare = source.match(/(?:^|\n)\s*(?:const|let)\s+(\w+)\s*=\s*(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mBare) {
+    const name = mBare[1];
+    if (new RegExp(`export\\s*\\{[^}]*\\b${name}\\b[^}]*\\}`).test(source)) {
+      return { kind: 'export-block', name };
+    }
+    return { kind: 'const', name };  // assume user wants to export it ; safer default
+  }
+
+  return null;
+}
+
+// ---------- Rewrite ----------
+function buildReplacement(shape) {
+  const header = `// Auto-generated by \`mostajs install-bridge\` on ${new Date().toISOString()}\n// Original file backed up as <this-file>.prisma.bak\n// Every db/prisma/client call is now routed to @mostajs/orm (13 dialects).\nimport 'server-only'\nimport { createPrismaLikeDb } from '@mostajs/orm-bridge/prisma-client'\n`;
+  if (shape.kind === 'default') {
+    return `${header}\nexport default createPrismaLikeDb()\n`;
+  }
+  const kw = shape.kind === 'let' ? 'let' : 'const';
+  if (shape.kind === 'export-block') {
+    return `${header}\n${kw} ${shape.name} = createPrismaLikeDb()\nexport { ${shape.name} }\n`;
+  }
+  return `${header}\nexport ${kw} ${shape.name} = createPrismaLikeDb()\n`;
+}
+
+// ---------- Restore ----------
+function restoreBackups() {
+  const restored = [];
+  for (const p of walk(ROOT)) {
+    if (!p.endsWith('.prisma.bak')) continue;
+    const original = p.slice(0, -'.prisma.bak'.length);
+    if (APPLY) {
+      renameSync(p, original);
+      log(`  ${c.green('✓')} restored ${c.dim(relative(ROOT, original))}`);
+    } else {
+      log(`  ${c.yellow('•')} would restore ${c.dim(relative(ROOT, original))}`);
+    }
+    restored.push(original);
+  }
+  return restored;
+}
+
+// ---------- Main ----------
+if (RESTORE) {
+  log(c.bold('▶ Restoring .prisma.bak files' + (APPLY ? '' : c.yellow(' (dry-run, use --apply)'))));
+  const r = restoreBackups();
+  log(`\n${r.length} file(s) ${APPLY ? 'restored' : 'would be restored'}`);
+  process.exit(0);
+}
+
+log(c.bold(`▶ mostajs install-bridge — scanning ${c.cyan(ROOT)}`));
+log('');
+
+const candidates = [];
+const iter = ONE_FILE ? [resolve(ROOT, ONE_FILE)] : walk(ROOT);
+for (const p of iter) {
+  let src;
+  try { src = readFileSync(p, 'utf8'); } catch { continue; }
+  if (!RX_IMPORT.test(src) && !RX_NEW.test(src)) continue;
+  if (RX_ALREADY.test(src)) {
+    log(`  ${c.dim('— skip (already bridged) ' + relative(ROOT, p))}`);
+    continue;
+  }
+  if (!RX_NEW.test(src)) continue;  // imports only = not an instantiation site
+  const shape = detectExportShape(src);
+  if (!shape) {
+    log(`  ${c.yellow('?')} ${relative(ROOT, p)} — PrismaClient detected but export shape unknown, skipping`);
+    continue;
+  }
+  candidates.push({ path: p, rel: relative(ROOT, p), shape, src });
+}
+
+if (candidates.length === 0) {
+  log(c.yellow('  No instantiation sites found.'));
+  log('');
+  log(`  Did you remove \`new PrismaClient()\` already ? The bridge may already be in place.`);
+  log(`  Re-scan with: ${c.cyan('mostajs install-bridge --restore --apply')} to undo a prior run.`);
+  process.exit(0);
+}
+
+log(c.bold(`Found ${candidates.length} PrismaClient instantiation site(s):`));
+for (const ca of candidates) {
+  log(`  ${c.green('→')} ${ca.rel}  ${c.dim(`(${ca.shape.kind}${ca.shape.name ? ' ' + ca.shape.name : ''})`)}`);
+}
+log('');
+
+if (!APPLY) {
+  log(c.yellow('Dry-run — no files written. Re-run with --apply to execute.'));
+  log('');
+  log(c.bold('Preview of rewrite for the first file :'));
+  log(c.dim('─────────────────────────────────────────'));
+  log(buildReplacement(candidates[0].shape));
+  log(c.dim('─────────────────────────────────────────'));
+  process.exit(0);
+}
+
+// ---------- Apply ----------
+log(c.bold('Applying rewrites :'));
+for (const ca of candidates) {
+  const bak = ca.path + '.prisma.bak';
+  if (!existsSync(bak)) copyFileSync(ca.path, bak);
+  writeFileSync(ca.path, buildReplacement(ca.shape));
+  log(`  ${c.green('✓')} rewrote ${ca.rel}  ${c.dim(`(backup: ${relative(ROOT, bak)})`)}`);
+}
+
+log('');
+log(c.bold(c.green(`✓ Bridge installed in ${candidates.length} file(s).`)));
+log('');
+log('Next steps :');
+log(`  1. ${c.cyan('npm i @mostajs/orm @mostajs/orm-bridge server-only --legacy-peer-deps')}`);
+log(`  2. ${c.cyan('npx @mostajs/orm-cli')}  →  menu 1 (Convert Prisma → entities.json)  →  menu 3 (init DDL)`);
+log(`  3. Set ${c.cyan('DB_DIALECT')} + ${c.cyan('SGBD_URI')} in .env (or: menu 2 → i to import)`);
+log(`  4. ${c.cyan('npm run dev')}  and test.`);
+log('');
+log(`To undo : ${c.cyan('mostajs install-bridge --restore --apply')}`);

package/bin/mostajs.sh

@@ -438,6 +438,8 @@ menu_main() {
   echo -e "  ${CYAN}8${RESET}) Health checks"
   echo -e "  ${CYAN}9${RESET}) Generate boilerplate (src/db.ts with bridge)"
   echo -e "  ${CYAN}s${RESET}) ${BOLD}Seeding${RESET} (upload / validate / apply seed data)"
+  echo -e "  ${GREEN}b${RESET}) ${BOLD}Bootstrap${RESET} — one-shot migration of a Prisma project"
+  echo -e "  ${GREEN}i${RESET}) ${BOLD}Install bridge${RESET} — codemod PrismaClient → bridge (dry-run / apply / restore)"
   echo -e "  ${CYAN}0${RESET}) About / Help"
   echo
   echo -e "  ${RED}q${RESET}) Quit"
@@ -455,12 +457,63 @@ menu_main() {
     8) action_healthcheck ;;
     9) action_generate_boilerplate ;;
     s|S) menu_seeding ;;
+    b|B) menu_bootstrap ;;
+    i|I) menu_install_bridge ;;
     0) action_about ;;
     q|Q) exit 0 ;;
     *) warn "Unknown choice"; pause ;;
   esac
 }
 
+# ------------------------------------------------------------
+# Interactive wrapper for `install-bridge` codemod
+# ------------------------------------------------------------
+menu_install_bridge() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Install bridge — PrismaClient codemod${RESET}"
+  echo
+  echo "  ${CYAN}1${RESET}) Dry-run : list files that would be rewritten (default)"
+  echo "  ${CYAN}2${RESET}) Apply   : rewrite PrismaClient sites to createPrismaLikeDb()"
+  echo "  ${CYAN}3${RESET}) Restore : revert .prisma.bak files (dry-run)"
+  echo "  ${CYAN}4${RESET}) Restore : revert .prisma.bak files (apply)"
+  echo "  ${RED}0${RESET}) Back"
+  echo
+  local cli_dir
+  cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+  local choice; choice=$(ask "Choice" "1")
+  case "$choice" in
+    1) node "$cli_dir/bin/install-bridge.mjs" ;;
+    2) node "$cli_dir/bin/install-bridge.mjs" --apply ;;
+    3) node "$cli_dir/bin/install-bridge.mjs" --restore ;;
+    4) node "$cli_dir/bin/install-bridge.mjs" --restore --apply ;;
+    0) return ;;
+    *) warn "Unknown" ;;
+  esac
+  pause
+}
+
+# ------------------------------------------------------------
+# Interactive wrapper for `bootstrap` — one-shot full migration
+# ------------------------------------------------------------
+menu_bootstrap() {
+  header
+  echo -e "${BOLD}${GREEN}▶ Bootstrap — full Prisma → @mostajs/orm migration${RESET}"
+  echo
+  echo "This will, in ${BOLD}this project${RESET} :"
+  echo "  1. Rewrite every ${CYAN}new PrismaClient()${RESET} site to use ${CYAN}createPrismaLikeDb()${RESET}"
+  echo "     (originals backed up as ${DIM}*.prisma.bak${RESET})"
+  echo "  2. Install ${CYAN}@mostajs/orm${RESET} + ${CYAN}@mostajs/orm-bridge${RESET} + ${CYAN}server-only${RESET}"
+  echo "  3. Convert ${CYAN}prisma/schema.prisma${RESET} → ${DIM}.mostajs/generated/entities.json${RESET}"
+  echo "  4. Write ${DIM}.mostajs/config.env${RESET} (default : sqlite ./data.sqlite) and init DDL"
+  echo
+  warn "Existing code changes will be backed up but NOT committed — review the diff before pushing."
+  echo
+  local go; go=$(ask "Proceed? (y/N)" "N")
+  [[ "$go" =~ ^[yY]$ ]] || { info "Cancelled"; return; }
+  run_subcommand bootstrap
+  pause
+}
+
 # ============================================================
 # ACTION 1 : CONVERT
 # ============================================================
@@ -2316,6 +2369,14 @@ EOF
 
 run_subcommand() {
   case "$1" in
+    diagnose|diag|d)
+      # mostajs diagnose [email] [password]
+      # Walks through: config vs project datasource mismatch, DB connection,
+      # user lookup, isActive check, bcrypt verification.
+      local email="${2:-}"
+      local password="${3:-}"
+      action_diagnose_login "$email" "$password"
+      ;;
     hash|h)
       # mostajs hash <plaintext> [cost]
       local pw="${2:-}"
@@ -2387,6 +2448,71 @@ run_subcommand() {
     health|h)
       action_healthcheck
       ;;
+    install-bridge|ib)
+      # mostajs install-bridge [--apply] [--file X] [--project P] [--restore]
+      # Codemod : scans the project for `new PrismaClient(...)` sites and rewrites
+      # them in place to use createPrismaLikeDb() from @mostajs/orm-bridge.
+      # Dry-run by default ; pass --apply to write the changes.
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      shift
+      node "$cli_dir/bin/install-bridge.mjs" "$@"
+      ;;
+    bootstrap|b)
+      # mostajs bootstrap : the full zero-touch migration for a Prisma project.
+      #   1. Run the codemod on the whole tree  (install-bridge --apply)
+      #   2. npm install @mostajs/orm @mostajs/orm-bridge server-only
+      #   3. Convert prisma/schema.prisma → entities.json
+      #   4. Write .mostajs/config.env + init SQLite DDL
+      #   5. Tell the user what remains (.env, seeds, run dev).
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      detect_project
+      [[ ${#DETECTED_TYPES[@]} -eq 0 ]] && { err "No schema found. Bootstrap needs a prisma/schema.prisma (or OpenAPI/JSONSchema)."; exit 1; }
+
+      echo -e "\n\e[1m▶ Step 1/4 : rewrite PrismaClient sites\e[0m"
+      node "$cli_dir/bin/install-bridge.mjs" --apply || { err "Codemod failed"; exit 1; }
+
+      echo -e "\n\e[1m▶ Step 2/4 : install runtime deps\e[0m"
+      ( cd "$PROJECT_ROOT" && $PKG_MANAGER install @mostajs/orm @mostajs/orm-bridge server-only --legacy-peer-deps 2>&1 | tail -3 )
+
+      echo -e "\n\e[1m▶ Step 3/4 : convert schema + init DDL\e[0m"
+      local type="${DETECTED_TYPES[0]}" input
+      case "$type" in
+        prisma)     input="$PRISMA_SCHEMA" ;;
+        openapi)    input="$OPENAPI_FILE" ;;
+        jsonschema) input="${JSON_SCHEMAS[0]}" ;;
+      esac
+      run_adapter_convert "$type" "$input" "$GENERATED_DIR/entities.ts"
+
+      mkdir -p "$CONFIG_DIR"
+      if [[ ! -f "$CONFIG_DIR/config.env" ]]; then
+        cat > "$CONFIG_DIR/config.env" <<CFG
+DB_DIALECT=sqlite
+SGBD_URI=./data.sqlite
+DB_SCHEMA_STRATEGY=update
+CFG
+        ok "  wrote $CONFIG_DIR/config.env (defaults: sqlite ./data.sqlite)"
+      fi
+      action_init_dialects || warn "DDL init returned non-zero — inspect and retry with menu 3"
+
+      echo -e "\n\e[1m▶ Step 4/4 : done\e[0m"
+      cat <<DONE
+
+  ✓ Bridge installed in-place.  Original files backed up as *.prisma.bak
+  ✓ Schema converted :   $GENERATED_DIR/entities.json
+  ✓ SQLite DDL applied : $PROJECT_ROOT/data.sqlite
+
+  Next :
+    - Add seeds to $CONFIG_DIR/seeds/*.json   (one file per entity)
+    - $CLI_NAME             # menu S → h (hash) → 4 (apply)
+    - npm run dev
+
+  To undo the codemod :
+    $CLI_NAME install-bridge --restore --apply
+
+DONE
+      ;;
     version|-v|--version)
       echo "$CLI_NAME $VERSION"
       ;;
@@ -2394,14 +2520,21 @@ run_subcommand() {
       cat <<EOF
 Usage :
   $CLI_NAME                         Interactive menu
+  $CLI_NAME bootstrap               One-shot migration : codemod + deps + convert + DDL
+  $CLI_NAME install-bridge          Codemod only (dry-run ; add --apply to write)
+  $CLI_NAME install-bridge --apply  Rewrite PrismaClient sites to use @mostajs/orm-bridge
+  $CLI_NAME install-bridge --restore --apply     Undo a prior install-bridge
   $CLI_NAME convert                 Run conversion (auto-detect schema type)
   $CLI_NAME detect                  Print detected schemas
   $CLI_NAME health                  Run health checks
   $CLI_NAME hash <password> [cost]  Hash a password with bcrypt (cost default 10)
   $CLI_NAME verify <password> <hash> Check if a plain password matches a bcrypt hash
+  $CLI_NAME diagnose [email] [pw]   Walk through login diagnostics
   $CLI_NAME version                 Print version
 
 Examples:
+  $CLI_NAME bootstrap               → zero-touch migrate a Prisma project to @mostajs/orm
+  $CLI_NAME install-bridge          → preview rewrites without touching files
   $CLI_NAME hash 'Admin@123456'     → \$2b\$10\$N9qo8uLOickgx2ZMRZoMyeIjZA...
   $CLI_NAME verify 'Admin@123456' '\$2b\$10\$N9qo...'
 EOF

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mostajs/orm-cli",
-  "version": "0.3.2",
-  "description": "Universal CLI to integrate @mostajs/orm into any project — auto-detects Prisma, OpenAPI, JSON Schema. Interactive menu + subcommands. 13 databases.",
+  "version": "0.4.0",
+  "description": "Universal CLI to integrate @mostajs/orm into any project — one-shot `mostajs bootstrap` migrates a Prisma project (codemod + deps + schema convert + DDL) to 13 databases with zero code change.",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",
   "type": "module",