langaro-api 1.0.1 → 1.0.3

package/bin/langaro-api.js

@@ -21,6 +21,10 @@ if (command === 'init') {
   // Project scaffolding
   const runInit = require('../lib/cli/init');
   runInit();
+} else if (command === 'migrate') {
+  // Migrate existing project to use langaro-api loaders
+  const runMigrate = require('../lib/cli/migrate');
+  runMigrate();
 } else if (command === 'new') {
   // Interactive resource generator
   const runNew = require('../lib/cli/new');

package/lib/cli/init.js

@@ -1,7 +1,8 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
-const { execSync } = require('child_process');
+
+const OWN_VERSION = require('../../package.json').version;
 
 function ask(rl, question, defaultVal) {
   const suffix = defaultVal ? ` (${defaultVal})` : '';
@@ -75,7 +76,7 @@ function packageJson(name) {
       'knex-extended-crud': '^2.0.31',
       'knex-paginate': '3.2.0',
       'knex-schema-inspector': '^3.0.0',
-      'langaro-api': '^2.0.0',
+      'langaro-api': `^${OWN_VERSION}`,
       lodash: '^4.17.21',
       morgan: '^1.10.0',
       multer: '^1.4.5-lts.1',

package/lib/cli/migrate.js

@@ -0,0 +1,99 @@
+const fs = require('fs');
+const path = require('path');
+
+const INDEX_REPLACEMENTS = {
+  'src/database/models/index.js': `const { loadModels } = require('langaro-api');
+
+module.exports = (knexInstance) => loadModels(knexInstance, __dirname);
+`,
+  'src/database/services/index.js': `const { loadServices } = require('langaro-api');
+
+module.exports = (models, io) => loadServices(models, io, __dirname);
+`,
+  'src/controllers/index.js': `const { loadControllers } = require('langaro-api');
+
+module.exports = (services, Queue, io) => loadControllers(services, Queue, io, __dirname);
+`,
+  'src/routes/index.js': `const { attachRouters } = require('langaro-api');
+
+exports.attachRouters = (express, controllers, services) => {
+  attachRouters(express, controllers, services, __dirname);
+};
+`,
+  'src/jobs/index.js': `const { loadJobs } = require('langaro-api');
+
+module.exports = (services) => loadJobs(services, __dirname);
+`,
+  'src/tasks/index.js': `const { loadTasks } = require('langaro-api');
+
+module.exports = (services, Queue) => loadTasks(services, Queue, __dirname);
+`,
+};
+
+function run() {
+  const root = process.cwd();
+  let replaced = 0;
+  let skipped = 0;
+  let missing = 0;
+
+  console.log('\n\x1b[36mlangaro-api migrate\x1b[0m — Replace index files with langaro-api loaders\n');
+
+  Object.entries(INDEX_REPLACEMENTS).forEach(([relPath, newContent]) => {
+    const fullPath = path.resolve(root, relPath);
+
+    if (!fs.existsSync(fullPath)) {
+      console.log(`  \x1b[33mmissing\x1b[0m  ${relPath} (file not found, skipping)`);
+      missing++;
+      return;
+    }
+
+    const current = fs.readFileSync(fullPath, 'utf8');
+
+    // Already migrated — check if it already uses langaro-api
+    if (current.includes("require('langaro-api')")) {
+      console.log(`  \x1b[90mskip\x1b[0m     ${relPath} (already using langaro-api)`);
+      skipped++;
+      return;
+    }
+
+    // Back up the original
+    const backupPath = `${fullPath}.bak`;
+    fs.writeFileSync(backupPath, current);
+
+    // Replace with the loader version
+    fs.writeFileSync(fullPath, newContent);
+    console.log(`  \x1b[32mreplaced\x1b[0m ${relPath} (backup at ${path.basename(backupPath)})`);
+    replaced++;
+  });
+
+  console.log(`\n  Replaced: ${replaced}, Skipped: ${skipped}, Missing: ${missing}\n`);
+
+  if (replaced > 0) {
+    console.log('\x1b[36mManual step required — update src/config/app.js:\x1b[0m\n');
+    console.log('  Replace these lines:');
+    console.log("    \x1b[31m- const { attachRouters } = require('@/routes');\x1b[0m");
+    console.log("    \x1b[31m- const models = await require('@/database/models')(this.knex);\x1b[0m");
+    console.log("    \x1b[31m- const services = this.services || require('@/database/services')(models.models, io);\x1b[0m");
+    console.log("    \x1b[31m- const controllers = require('@/controllers')(services, Queue, io);\x1b[0m");
+    console.log("    \x1b[31m- require('@/tasks')(services, Queue);\x1b[0m");
+    console.log('');
+    console.log('  With:');
+    console.log("    \x1b[32m+ const { loadModels, loadServices, loadControllers, attachRouters, loadTasks } = require('langaro-api');\x1b[0m");
+    console.log('    \x1b[32m+ const { models } = await loadModels(this.knex);\x1b[0m');
+    console.log('    \x1b[32m+ const services = this.services || loadServices(models, io);\x1b[0m');
+    console.log('    \x1b[32m+ const controllers = loadControllers(services, Queue, io);\x1b[0m');
+    console.log('    \x1b[32m+ loadTasks(services, Queue);\x1b[0m');
+    console.log('');
+    console.log('  And in queues.js replace:');
+    console.log("    \x1b[31m- const jobs = require('@/jobs/index')(services);\x1b[0m");
+    console.log('  With:');
+    console.log("    \x1b[32m+ const { loadJobs } = require('langaro-api');\x1b[0m");
+    console.log('    \x1b[32m+ const jobs = loadJobs(services);\x1b[0m');
+    console.log('');
+    console.log('  Then run \x1b[36mnpx langaro-api\x1b[0m to regenerate types.\n');
+  }
+
+  process.exit(0);
+}
+
+module.exports = run;

package/lib/cli/new.js

@@ -244,7 +244,10 @@ async function run(config = {}) {
   }
 
   if (created.length > 0) {
-    console.log(`\n\x1b[32mDone!\x1b[0m Created ${created.length} file(s). Run \x1b[36mlangaro-api\x1b[0m to regenerate types.\n`);
+    // Auto-regenerate types so the new resource gets IntelliSense immediately
+    const { generateTypes } = require('../index');
+    generateTypes(cfg);
+    console.log(`\n\x1b[32mDone!\x1b[0m Created ${created.length} file(s). Types regenerated.\n`);
   } else {
     console.log('\nNo files created (all already exist).\n');
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langaro-api",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Auto-generate TypeScript types, JSDoc annotations, and boilerplate loaders for knex-extended-crud projects",
   "main": "lib/index.js",
   "bin": {