millas 0.2.12-beta → 0.2.12-beta-2

package/src/container/AppInitializer.js

@@ -0,0 +1,215 @@
+'use strict';
+
+const express = require('express');
+const Application = require('./Application');
+const HttpServer = require('./HttpServer');
+
+/**
+ * AppInitialiser
+ *
+ * The internal engine that receives what bootstrap/app.js exports
+ * (a MillasInstance), extracts its config, and wires up everything:
+ *
+ *   - ExpressAdapter
+ *   - Application kernel (DI container, providers, routes, middleware)
+ *   - Admin panel
+ *   - HttpServer (port, signals, startup log, IPC ready signal)
+ *
+ * Developers never see or interact with this class.
+ * It is used exclusively by runner.js (millas serve) and the no-reload path.
+ *
+ * ── Flow ─────────────────────────────────────────────────────────────────────
+ *
+ *   bootstrap/app.js  →  MillasInstance  →  AppInitialiser.boot()
+ *                                              ├─ builds ExpressAdapter
+ *                                              ├─ builds Application
+ *                                              ├─ registers core providers
+ *                                              │    Log → Database → Auth → Admin
+ *                                              │    → Cache → Mail → Queue → Events
+ *                                              ├─ registers app providers
+ *                                              ├─ registers routes
+ *                                              ├─ registers middleware aliases
+ *                                              ├─ boots all providers
+ *                                              ├─ mounts routes
+ *                                              ├─ mounts admin panel
+ *                                              ├─ mounts fallbacks
+ *                                              └─ starts HttpServer
+ */
+class AppInitializer {
+    /**
+     * @param {Object} config — the sealed export of bootstrap/app.js
+     */
+    constructor(config) {
+        this._config = config;
+        this._kernel = null;
+        this._adapter = null;
+    }
+
+    /**
+     * Boot the full application and start the HTTP server.
+     * Returns a Promise that resolves once the server is listening.
+     */
+    async boot() {
+        const cfg = this._config;
+
+        // ── Build the HTTP adapter ───────────────────────────────────────────────
+        const ExpressAdapter = require('../http/adapters/ExpressAdapter');
+        const expressApp = express();
+        this._adapter = new ExpressAdapter(expressApp);
+        this._adapter.applyBodyParsers();
+
+        // Raw adapter middleware (helmet, compression, etc.)
+        for (const mw of (cfg.adapterMiddleware || [])) {
+            this._adapter.applyMiddleware(mw);
+        }
+
+        // ── Build the Application kernel ─────────────────────────────────────────
+        this._kernel = new Application(this._adapter);
+
+        // Bind basePath so all providers can resolve config/model paths
+        // without calling process.cwd() at runtime.
+        const basePath = cfg.basePath || process.cwd();
+        this._kernel._container.instance('basePath', basePath);
+
+        // Core providers (auto-enabled unless disabled in config)
+        const coreProviders = this._buildCoreProviders(cfg);
+        this._kernel.providers([...coreProviders, ...cfg.providers]);
+
+        // Named middleware aliases
+        for (const {alias, handler} of (cfg.middleware || [])) {
+            this._kernel.middleware(alias, handler);
+        }
+
+        // Route definitions
+        if (cfg.routes) {
+            this._kernel.routes(cfg.routes);
+        }
+
+        // ── Boot providers ───────────────────────────────────────────────────────
+        await this._kernel.boot();
+
+        // ── Mount routes ─────────────────────────────────────────────────────────
+        if (!process.env.MILLAS_ROUTE_LIST) {
+            this._kernel.mountRoutes();
+
+            // Admin panel — mounted between routes and fallbacks
+            if (cfg.admin !== null) {
+                try {
+                    const Admin = require('../admin/Admin');
+                    if (cfg.admin && Object.keys(cfg.admin).length) {
+                        Admin.configure(cfg.admin);
+                    }
+                    Admin.mount(expressApp);
+                } catch (err) {
+                    process.stderr.write(`[millas] Admin mount failed: ${err.message}\n`);
+                }
+            }
+
+            this._kernel.mountFallbacks();
+
+            // ── Start the HTTP server ──────────────────────────────────────────────
+            const server = new HttpServer(this._kernel, {
+                onStart: cfg.onStart || undefined,
+                onShutdown: cfg.onShutdown || undefined,
+            });
+
+            await server.start();
+        }
+    }
+
+    // ── Internal ───────────────────────────────────────────────────────────────
+
+    _buildCoreProviders(cfg) {
+        const providers = [];
+        const load = (p) => {
+            try { return require(p); } catch { return null; }
+        };
+
+        // ── 1. Logging ───────────────────────────────────────────────────────
+        if (cfg.logging !== false) {
+            const p = load('../providers/LogServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 2. Database ──────────────────────────────────────────────────────
+        if (cfg.database !== false) {
+            const p = load('../providers/DatabaseServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 3. Auth — always on unless explicitly disabled ───────────────────
+        // Mirrors Django: django.contrib.auth is in INSTALLED_APPS by default.
+        // Provides Auth.login/register, JWT middleware, the User model.
+        // Requires Database to be booted first.
+        if (cfg.auth !== false) {
+            const p = load('../providers/AuthServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 4. Admin — on when .withAdmin() was called ───────────────────────
+        // Mirrors Django: django.contrib.admin is in INSTALLED_APPS by default.
+        // Requires Auth to be booted first (needs the resolved User model).
+        if (cfg.admin !== null && cfg.admin !== undefined) {
+            const p = load('../providers/AdminServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 5. Cache + Storage ───────────────────────────────────────────────
+        if (cfg.cache !== false || cfg.storage !== false) {
+            const p = load('../providers/CacheStorageServiceProvider');
+            if (p) {
+                if (cfg.cache !== false && p.CacheServiceProvider) providers.push(p.CacheServiceProvider);
+                if (cfg.storage !== false && p.StorageServiceProvider) providers.push(p.StorageServiceProvider);
+            }
+        }
+
+        // ── 6. Mail ──────────────────────────────────────────────────────────
+        if (cfg.mail !== false) {
+            const p = load('../providers/MailServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 7. Queue ─────────────────────────────────────────────────────────
+        if (cfg.queue !== false) {
+            const p = load('../providers/QueueServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 8. Events ────────────────────────────────────────────────────────
+        if (cfg.events !== false) {
+            const p = load('../providers/EventServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        // ── 9. i18n — opt-in via config/app.js use_i18n: true ───────────────
+        // Mirrors Django's USE_I18N = True in settings.py.
+        // Booted last so translations are available in all request handlers.
+        if (this._resolveI18nEnabled(cfg)) {
+            const p = load('../i18n/I18nServiceProvider');
+            if (p) providers.push(p);
+        }
+
+        return providers;
+    }
+
+    /**
+     * Resolve whether i18n should be enabled.
+     * Reads use_i18n from config/app.js — the single source of truth.
+     *
+     *   // config/app.js
+     *   module.exports = {
+     *     use_i18n: true,
+     *     locale:   'sw',
+     *     fallback: 'en',
+     *   };
+     */
+    _resolveI18nEnabled(cfg) {
+        try {
+            const basePath  = cfg.basePath || process.cwd();
+            const appConfig = require(basePath + '/config/app');
+            return appConfig.use_i18n === true;
+        } catch { return false; }
+    }
+}
+
+module.exports = AppInitializer;