millas 0.1.0

package/src/scaffold/maker.js

@@ -0,0 +1,272 @@
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function resolveAppPath(...segments) {
+  return path.resolve(process.cwd(), ...segments);
+}
+
+function timestamp() {
+  return new Date().toISOString().replace(/[-T:.Z]/g, '').slice(0, 14);
+}
+
+function pascalCase(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+async function write(filePath, content) {
+  await fs.ensureDir(path.dirname(filePath));
+  if (await fs.pathExists(filePath)) {
+    throw new Error(`File already exists: ${filePath}`);
+  }
+  await fs.writeFile(filePath, content, 'utf8');
+  return filePath;
+}
+
+// ─── Generators ───────────────────────────────────────────────────────────────
+
+async function makeController(name, options = {}) {
+  const className = pascalCase(name.endsWith('Controller') ? name : `${name}Controller`);
+  const filePath = resolveAppPath('app/controllers', `${className}.js`);
+
+  const resource = options.resource;
+
+  const content = resource
+    ? `'use strict';
+
+const { Controller } = require('millas/src');
+
+/**
+ * ${className}
+ *
+ * Resource controller — handles CRUD operations.
+ */
+class ${className} extends Controller {
+  /** GET /${name.toLowerCase()}s */
+  async index(req, res) {
+    return this.ok(res, { data: [] });
+  }
+
+  /** GET /${name.toLowerCase()}s/:id */
+  async show(req, res) {
+    const id = this.param(req, 'id');
+    return this.ok(res, { data: { id } });
+  }
+
+  /** POST /${name.toLowerCase()}s */
+  async store(req, res) {
+    const data = await this.validate(req, {
+      // 'name': 'required|string|max:255',
+    });
+    return this.created(res, { data });
+  }
+
+  /** PUT /${name.toLowerCase()}s/:id */
+  async update(req, res) {
+    const id   = this.param(req, 'id');
+    const data = this.except(req, ['id']);
+    return this.ok(res, { data: { id, ...data } });
+  }
+
+  /** DELETE /${name.toLowerCase()}s/:id */
+  async destroy(req, res) {
+    return this.noContent(res);
+  }
+}
+
+module.exports = ${className};
+`
+    : `'use strict';
+
+const { Controller } = require('millas/src');
+
+/**
+ * ${className}
+ */
+class ${className} extends Controller {
+  async index(req, res) {
+    return this.ok(res, { message: 'Hello from ${className}' });
+  }
+}
+
+module.exports = ${className};
+`;
+
+  return write(filePath, content);
+}
+
+async function makeModel(name, options = {}) {
+  const className = pascalCase(name);
+  const tableName = name.toLowerCase() + 's';
+  const filePath = resolveAppPath('app/models', `${className}.js`);
+
+  const content = `'use strict';
+
+const { Model, fields } = require('millas/src');
+
+/**
+ * ${className} Model
+ *
+ * Represents the "${tableName}" table.
+ * Run: millas makemigrations  — to generate the migration.
+ * Run: millas migrate         — to apply it.
+ */
+class ${className} extends Model {
+  static table = '${tableName}';
+
+  static fields = {
+    id:         fields.id(),
+    created_at: fields.timestamp(),
+    updated_at: fields.timestamp(),
+  };
+}
+
+module.exports = ${className};
+`;
+
+  const result = await write(filePath, content);
+
+  if (options.migration) {
+    await makeMigration(`create_${tableName}_table`);
+  }
+
+  return result;
+}
+
+async function makeMiddleware(name) {
+  const className = pascalCase(name.endsWith('Middleware') ? name : `${name}Middleware`);
+  const filePath = resolveAppPath('app/middleware', `${className}.js`);
+
+  const content = `'use strict';
+
+const { Middleware } = require('millas/src');
+
+/**
+ * ${className}
+ *
+ * Usage:
+ *   1. Register in bootstrap/app.js:
+ *        middlewareRegistry.register('${name.toLowerCase()}', ${className});
+ *
+ *   2. Apply to routes:
+ *        Route.middleware(['${name.toLowerCase()}']).group(() => { ... });
+ */
+class ${className} extends Middleware {
+  /**
+   * Handle the incoming request.
+   * Call next() to continue, or return a response to halt the chain.
+   */
+  async handle(req, res, next) {
+    // Your middleware logic here
+
+    next();
+  }
+}
+
+module.exports = ${className};
+`;
+
+  return write(filePath, content);
+}
+
+async function makeService(name) {
+  const className = pascalCase(name.endsWith('Service') ? name : `${name}Service`);
+  const filePath = resolveAppPath('app/services', `${className}.js`);
+
+  const content = `'use strict';
+
+/**
+ * ${className}
+ *
+ * Business logic service.
+ * Register in AppServiceProvider:
+ *   container.bind('${className}', ${className});
+ */
+class ${className} {
+  constructor() {
+    // Inject dependencies here (Phase 4)
+  }
+}
+
+module.exports = ${className};
+`;
+
+  return write(filePath, content);
+}
+
+async function makeJob(name) {
+  const className = pascalCase(name.endsWith('Job') ? name : `${name}Job`);
+  const filePath = resolveAppPath('app/jobs', `${className}.js`);
+
+  const content = `'use strict';
+
+/**
+ * ${className}
+ *
+ * Background job — dispatched via:
+ *   dispatch(new ${className}(payload))
+ *
+ * Phase 9: Queue system will process this job.
+ */
+class ${className} {
+  constructor(payload = {}) {
+    this.payload = payload;
+  }
+
+  /**
+   * Execute the job.
+   */
+  async handle() {
+    // Your job logic here
+    console.log('${className} running with:', this.payload);
+  }
+}
+
+module.exports = ${className};
+`;
+
+  return write(filePath, content);
+}
+
+async function makeMigration(name) {
+  const fileName = `${timestamp()}_${name}.js`;
+  const filePath = resolveAppPath('database/migrations', fileName);
+
+  const content = `'use strict';
+
+/**
+ * Migration: ${name}
+ */
+module.exports = {
+  async up(db) {
+    // Write your migration here
+    // Example:
+    // await db.schema.createTable('users', (table) => {
+    //   table.id();
+    //   table.string('name');
+    //   table.string('email').unique();
+    //   table.timestamps();
+    // });
+  },
+
+  async down(db) {
+    // Rollback logic here
+    // await db.schema.dropTableIfExists('users');
+  },
+};
+`;
+
+  return write(filePath, content);
+}
+
+module.exports = {
+  makeController,
+  makeModel,
+  makeMiddleware,
+  makeService,
+  makeJob,
+  makeMigration,
+};

package/src/scaffold/templates.js

@@ -0,0 +1,350 @@
+'use strict';
+
+function getProjectFiles(projectName) {
+  return {
+
+    // ─── package.json ─────────────────────────────────────────────
+    'package.json': JSON.stringify({
+      name: projectName,
+      version: '1.0.0',
+      description: `A Millas application`,
+      main: 'bootstrap/app.js',
+      scripts: {
+        start: 'node bootstrap/app.js',
+        dev: 'millas serve',
+      },
+      dependencies: {
+        express: '^4.18.2',
+        dotenv: '^16.0.3',
+      },
+    }, null, 2),
+
+    // ─── .env ─────────────────────────────────────────────────────
+    '.env': `APP_NAME=${projectName}
+APP_ENV=development
+APP_PORT=3000
+APP_KEY=
+
+DB_CONNECTION=sqlite
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=database/database.sqlite
+DB_USERNAME=root
+DB_PASSWORD=
+
+MAIL_DRIVER=smtp
+MAIL_HOST=smtp.mailtrap.io
+MAIL_PORT=2525
+MAIL_USERNAME=
+MAIL_PASSWORD=
+
+QUEUE_DRIVER=sync
+
+CACHE_DRIVER=memory
+`,
+
+    // ─── .env.example ─────────────────────────────────────────────
+    '.env.example': `APP_NAME=${projectName}
+APP_ENV=development
+APP_PORT=3000
+APP_KEY=
+
+DB_CONNECTION=sqlite
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=database/database.sqlite
+DB_USERNAME=root
+DB_PASSWORD=
+`,
+
+    // ─── .gitignore ───────────────────────────────────────────────
+    '.gitignore': `node_modules/
+.env
+storage/logs/*.log
+storage/uploads/*
+!storage/uploads/.gitkeep
+database/database.sqlite
+`,
+
+    // ─── millas.config.js ─────────────────────────────────────────
+    'millas.config.js': `'use strict';
+
+module.exports = {
+  /*
+  |--------------------------------------------------------------------------
+  | Millas Framework Configuration
+  |--------------------------------------------------------------------------
+  */
+  providers: [
+    './providers/AppServiceProvider',
+  ],
+};
+`,
+
+    // ─── bootstrap/app.js ─────────────────────────────────────────
+    'bootstrap/app.js': `'use strict';
+
+require('dotenv').config();
+
+const express              = require('express');
+const { Application }      = require('millas/src');
+const AppServiceProvider   = require('../providers/AppServiceProvider');
+
+const expressApp = express();
+expressApp.use(express.json());
+expressApp.use(express.urlencoded({ extended: true }));
+
+// ── Build the Millas application kernel ─────────────────────────
+const app = new Application(expressApp);
+
+// ── Register service providers ──────────────────────────────────
+app.providers([
+  AppServiceProvider,
+  // Add more providers here as you build your app
+]);
+
+// ── Define routes ────────────────────────────────────────────────
+app.routes(Route => {
+  require('../routes/web')(Route);
+  require('../routes/api')(Route);
+});
+
+// ── Boot + mount + listen ────────────────────────────────────────
+(async () => {
+  await app.boot();
+
+  if (!process.env.MILLAS_ROUTE_LIST) {
+    app.mount();
+    app.listen();
+  }
+})();
+
+module.exports = { app, expressApp };
+`,
+
+    // ─── routes/web.js ────────────────────────────────────────────
+    'routes/web.js': `'use strict';
+
+/**
+ * Web Routes
+ *
+ * Define your web-facing routes here using the Millas Route API.
+ *
+ *   Route.get('/path', ControllerClass, 'method')
+ *   Route.get('/path', (req, res) => res.json({ ... }))   // closure
+ *   Route.resource('/posts', PostController)               // full CRUD
+ *   Route.group({ prefix: '/admin', middleware: ['auth'] }, () => { ... })
+ */
+module.exports = function (Route) {
+  Route.get('/', (req, res) => {
+    res.json({
+      framework: 'Millas',
+      version:   '0.1.0',
+      message:   'Welcome to your Millas application!',
+      docs:      'https://millas.dev/docs',
+    });
+  });
+};
+`,
+
+    // ─── routes/api.js ────────────────────────────────────────────
+    'routes/api.js': `'use strict';
+
+/**
+ * API Routes
+ *
+ * All routes here are prefixed with /api.
+ * Add Route.middleware(['auth']) to protect routes.
+ */
+module.exports = function (Route) {
+  Route.prefix('/api').group(() => {
+
+    Route.get('/health', (req, res) => {
+      res.json({ status: 'ok', timestamp: new Date().toISOString() });
+    });
+
+  });
+};
+`,
+
+    // ─── config/app.js ────────────────────────────────────────────
+    'config/app.js': `'use strict';
+
+module.exports = {
+  name: process.env.APP_NAME || 'Millas',
+  env: process.env.APP_ENV || 'development',
+  port: parseInt(process.env.APP_PORT, 10) || 3000,
+  key: process.env.APP_KEY || '',
+  debug: process.env.APP_ENV !== 'production',
+  timezone: 'UTC',
+  locale: 'en',
+};
+`,
+
+    // ─── config/database.js ───────────────────────────────────────
+    'config/database.js': `'use strict';
+
+module.exports = {
+  default: process.env.DB_CONNECTION || 'sqlite',
+
+  connections: {
+    sqlite: {
+      driver: 'sqlite',
+      database: process.env.DB_DATABASE || 'database/database.sqlite',
+    },
+    mysql: {
+      driver: 'mysql',
+      host: process.env.DB_HOST || '127.0.0.1',
+      port: parseInt(process.env.DB_PORT, 10) || 3306,
+      database: process.env.DB_DATABASE || 'millas',
+      username: process.env.DB_USERNAME || 'root',
+      password: process.env.DB_PASSWORD || '',
+    },
+    postgres: {
+      driver: 'postgres',
+      host: process.env.DB_HOST || '127.0.0.1',
+      port: parseInt(process.env.DB_PORT, 10) || 5432,
+      database: process.env.DB_DATABASE || 'millas',
+      username: process.env.DB_USERNAME || 'postgres',
+      password: process.env.DB_PASSWORD || '',
+    },
+  },
+};
+`,
+
+    // ─── config/auth.js ───────────────────────────────────────────
+    'config/auth.js': `'use strict';
+
+module.exports = {
+  default: 'jwt',
+
+  guards: {
+    jwt: {
+      driver: 'jwt',
+      secret: process.env.APP_KEY || 'change-me',
+      expiresIn: '7d',
+    },
+    session: {
+      driver: 'session',
+    },
+  },
+
+  providers: {
+    users: {
+      model: 'User',
+    },
+  },
+
+  passwordReset: {
+    expiresIn: '1h',
+  },
+};
+`,
+
+    // ─── config/mail.js ───────────────────────────────────────────
+    'config/mail.js': `'use strict';
+
+module.exports = {
+  default: process.env.MAIL_DRIVER || 'smtp',
+
+  drivers: {
+    smtp: {
+      host: process.env.MAIL_HOST || 'smtp.mailtrap.io',
+      port: parseInt(process.env.MAIL_PORT, 10) || 2525,
+      username: process.env.MAIL_USERNAME || '',
+      password: process.env.MAIL_PASSWORD || '',
+      encryption: 'tls',
+    },
+  },
+
+  from: {
+    address: process.env.MAIL_FROM_ADDRESS || 'hello@millas.dev',
+    name: process.env.MAIL_FROM_NAME || 'Millas',
+  },
+};
+`,
+
+    // ─── providers/AppServiceProvider.js ──────────────────────────
+    'providers/AppServiceProvider.js': `'use strict';
+
+const { ServiceProvider } = require('millas/src');
+
+/**
+ * AppServiceProvider
+ *
+ * Register and bootstrap your application's services here.
+ *
+ * register()  — bind things into the container
+ * boot()      — called after all providers have registered;
+ *               safe to resolve other bindings here
+ */
+class AppServiceProvider extends ServiceProvider {
+  register(container) {
+    // container.bind('UserService', UserService);
+    // container.singleton('Mailer', MailService);
+    // container.instance('Config', require('../config/app'));
+  }
+
+  async boot(container, app) {
+    // const logger = container.make('Logger');
+    // logger.info('App booted');
+  }
+}
+
+module.exports = AppServiceProvider;
+`,
+
+    // ─── app/controllers/.gitkeep ────────────────────────────────
+    'app/controllers/.gitkeep': '',
+    'app/models/.gitkeep': '',
+    'app/services/.gitkeep': '',
+    'app/middleware/.gitkeep': '',
+    'app/jobs/.gitkeep': '',
+
+    // ─── README.md ────────────────────────────────────────────────
+    'README.md': `# ${projectName}
+
+A [Millas](https://millas.dev) application.
+
+## Getting Started
+
+\`\`\`bash
+# Start the development server
+millas serve
+
+# Generate a controller
+millas make:controller UserController
+
+# Generate a model
+millas make:model User
+
+# Run migrations
+millas migrate
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+app/
+  controllers/    # HTTP controllers
+  models/         # ORM models
+  services/       # Business logic
+  middleware/     # HTTP middleware
+  jobs/           # Background jobs
+bootstrap/
+  app.js          # Application entry point
+config/           # Configuration files
+database/
+  migrations/     # Database migrations
+  seeders/        # Database seeders
+routes/
+  web.js          # Web routes
+  api.js          # API routes
+storage/          # Logs, uploads
+providers/        # Service providers
+\`\`\`
+`,
+  };
+}
+
+module.exports = { getProjectFiles };