@nmvuong92/fluxe 0.4.0 → 0.5.0

package/lib/core/container.d.ts

@@ -0,0 +1,9 @@
+export type Factory<T> = (c: Container) => T;
+export interface Container {
+    register<T>(token: string, factory: Factory<T>): Container;
+    override<T>(token: string, factory: Factory<T>): Container;
+    has(token: string): boolean;
+    get<T>(token: string): T;
+    resolved(): string[];
+}
+export declare function createContainer(): Container;

package/lib/core/container.js

@@ -0,0 +1,46 @@
+// Copyright (c) 2026 nmvuong92
+// SPDX-License-Identifier: Apache-2.0
+/* Resolved Container — DI lười (lazy singleton). Register factory = O(1), KHÔNG instantiate;
+ * get() tạo lần đầu rồi memoize. Factory tự c.get(dep) → DI + thứ tự init tự nhiên (DFS) +
+ * phát hiện vòng (cycle). resolved() liệt kê token đã tạo → "chỉ module dùng mới bootstrap".
+ * DSA: Map provider + Map instance (O(1)); Set "đang giải" (cycle, O(depth)). */
+export function createContainer() {
+    const providers = new Map();
+    const instances = new Map();
+    const resolving = new Set(); // DFS đang giải → bắt cycle
+    const c = {
+        register(token, factory) {
+            if (providers.has(token))
+                throw new Error(`Container: token '${token}' đã đăng ký (dùng override để ghi đè)`);
+            providers.set(token, factory);
+            return c;
+        },
+        override(token, factory) {
+            providers.set(token, factory);
+            instances.delete(token); // buộc tạo lại lần get sau
+            return c;
+        },
+        has: (token) => providers.has(token),
+        get(token) {
+            if (instances.has(token))
+                return instances.get(token); // memoized singleton
+            const f = providers.get(token);
+            if (!f)
+                throw new Error(`Container: chưa đăng ký token '${token}'`);
+            if (resolving.has(token)) {
+                throw new Error(`Container: phụ thuộc vòng (cycle) tại '${token}' — chuỗi: ${[...resolving, token].join(" → ")}`);
+            }
+            resolving.add(token);
+            try {
+                const inst = f(c); // factory có thể c.get(dep) → DI lười, thứ tự tự nhiên
+                instances.set(token, inst);
+                return inst;
+            }
+            finally {
+                resolving.delete(token);
+            }
+        },
+        resolved: () => [...instances.keys()],
+    };
+    return c;
+}

package/lib/index.d.ts

@@ -6,6 +6,7 @@ export * from "./core/wiring.ts";
 export * from "./core/auth.ts";
 export * from "./core/env.ts";
 export * from "./core/config.ts";
+export * from "./core/container.ts";
 export * from "./core/i18n.ts";
 export * from "./core/seo.ts";
 export * from "./core/broker.ts";

package/lib/index.js

@@ -10,6 +10,7 @@ export * from "./core/wiring.js"; // backendFromManifest, backendsFromManifest
 export * from "./core/auth.js"; // session HMAC, scrypt password, CSRF, RBAC
 export * from "./core/env.js"; // loadEnv
 export * from "./core/config.js"; // FluxeConfig, loadConfig (default ← ENV FLUXE_* ← override)
+export * from "./core/container.js"; // createContainer — Resolved Container (DI lười, chỉ-used-bootstrap)
 export * from "./core/i18n.js"; // createI18n, resolveLocale, translate, makeT, t(key, vars)
 export * from "./core/seo.js"; // renderHead, renderSitemap, renderRobots, HeadMeta
 export * from "./core/broker.js"; // pub/sub

package/lib/server_factory.js

@@ -14,6 +14,7 @@ import { FluxeError, toErrorPayload, renderErrorPage } from "./core/errors.js";
 import { signSession, verifySession, parseCookie, hasRole, hashPassword, verifyPassword, newCsrfToken } from "./core/auth.js";
 import { validateInput } from "./core/validate.js";
 import { createBroker } from "./core/broker.js";
+import { createContainer } from "./core/container.js";
 import { createRateLimiter } from "./core/ratelimit.js";
 import { createRecorder } from "./core/observe.js";
 import { createPresence } from "./core/presence.js";
@@ -116,10 +117,13 @@ export function makeServer(manifest, cells, layouts = {}, opts = {}) {
     // Backend GIẢI per-cell từ manifest (Resolution Plane) — cell/frontend giữ nguyên.
     const backends = backendsFromManifest(manifest);
     const backendFor = (id) => backends.byCell.get(id) ?? backends.default;
-    const broker = createBroker(); // realtime pub/sub (Trục 4g, bản 1-node)
+    // Resolved Container: service realtime đăng ký LƯỜI — chỉ tạo khi thật sự dùng (SSE/action).
+    // App không realtime → broker/presence KHÔNG bao giờ bootstrap. resolved() ở /_fluxe/stats.
+    const container = createContainer();
+    container.register("broker", () => createBroker());
+    container.register("presence", () => createPresence());
     const actionLimit = createRateLimiter(config.rateLimit); // per-IP cho action (FLUXE_RATELIMIT_*)
-    const recorder = createRecorder(); // request log (observability)
-    const presence = createPresence(); // ai đang online per topic (Trục 4g)
+    const recorder = createRecorder(); // request log — chạy mỗi request → eager (luôn dùng)
     const renderCache = createRenderCache({ maxKeys: config.renderCache.maxKeys }); // FLUXE_RENDERCACHE_MAX_KEYS
     let clientJs; // ý A: đọc dist/client.js 1 lần (zero-copy: tái dùng buffer)
     return http.createServer(async (req, res) => {
@@ -160,7 +164,7 @@ export function makeServer(manifest, cells, layouts = {}, opts = {}) {
                 const m = process.memoryUsage();
                 const c = process.cpuUsage();
                 res.writeHead(200, { "content-type": "application/json" });
-                return res.end(JSON.stringify({ rss: m.rss, heapUsed: m.heapUsed, cpuUser: c.user, cpuSystem: c.system, uptimeMs: Math.round(process.uptime() * 1000) }));
+                return res.end(JSON.stringify({ rss: m.rss, heapUsed: m.heapUsed, cpuUser: c.user, cpuSystem: c.system, uptimeMs: Math.round(process.uptime() * 1000), bootstrapped: container.resolved() }));
             }
             if (url.pathname === "/_fluxe/requests") {
                 // Observability: log request gần đây (timing/status). Prod: gate sau auth.
@@ -246,6 +250,9 @@ export function makeServer(manifest, cells, layouts = {}, opts = {}) {
                 const id = url.searchParams.get("id");
                 res.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", connection: "keep-alive" });
                 res.write(`event: ready\ndata: {"topic":"${topic}"}\n\n`);
+                // Lần đầu có client SSE → broker + presence mới bootstrap (lazy qua container).
+                const broker = container.get("broker");
+                const presence = container.get("presence");
                 const offBroker = broker.subscribe(topic, (data) => res.write(`data: ${JSON.stringify(data)}\n\n`));
                 let offPresence = () => { };
                 if (id) {
@@ -301,7 +308,7 @@ export function makeServer(manifest, cells, layouts = {}, opts = {}) {
                 if (schema)
                     input = validateInput(schema, input); // sai → FluxeError 400 (caught)
                 const out = await fn({ input, backend, session });
-                broker.publish(cellId, { action: name, out }); // realtime: báo client khác
+                container.get("broker").publish(cellId, { action: name, out }); // realtime: báo client khác (broker lazy)
                 res.writeHead(200, { "content-type": "application/json", "x-fluxe-resolution": resolution, "x-fluxe-server-ms": String(Date.now() - t0) });
                 return res.end(JSON.stringify(out));
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nmvuong92/fluxe",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "fluxe — khung fullstack tối giản polyglot (RCA: Resolved Cell Architecture).",
   "license": "Apache-2.0",
   "author": "nmvuong92",