@nmvuong92/fluxe 0.9.2 → 0.9.3

package/README.md

@@ -8,7 +8,7 @@ Khung fullstack tối giản — **một runtime TypeScript** (chạy trên `nod
 trên triết lý **RCA — Resolved Cell Architecture**: *logic chỉ phụ thuộc HỢP ĐỒNG; mọi quyết định
 vận hành (render, backend data) là **kết quả được GIẢI** bởi engine, không viết tay.*
 
-> Đổi backend data `memory ↔ sqlite ↔ postgres` chỉ một dòng trong `app/backend.ts`, đổi render
+> Đổi backend data `memory ↔ sqlite ↔ postgres` chỉ một dòng trong `app/backend/data.ts`, đổi render
 > `static ↔ island` qua profile — **cell & frontend không đổi một dòng**.
 
 ## Cài & dùng (npm)
@@ -25,7 +25,7 @@ import { rpc } from "@nmvuong92/fluxe/client";
 
 | Import | Nội dung |
 |--------|----------|
-| `@nmvuong92/fluxe` | engine: defineCell, makeServer, resolver, auth, validate, seo, broker, ratelimit, codegen… (KHÔNG có driver data — backend là của bạn ở `app/backend.ts`) |
+| `@nmvuong92/fluxe` | engine: defineCell, makeServer, resolver, auth, validate, seo, broker, ratelimit, codegen… (KHÔNG có driver data — backend là của bạn ở `app/backend/data.ts`) |
 | `@nmvuong92/fluxe/react` | useQuery, useMutation, Link, Nav, ThemeToggle, useTheme, DebugBar |
 | `@nmvuong92/fluxe/client` | rpc, RpcError, mutate, revalidate, subscribe |
 | `@nmvuong92/fluxe/jobs` | queue/dead-letter (cần `--experimental-sqlite`) |
@@ -47,8 +47,9 @@ npm run test:all           # typecheck + 144 unit + integration (selftest2) —
 app/        ← DEV sở hữu (sửa thoải mái) — Contract Plane
   cells/        trang/feature (route + loader + view + action/head/layout/guard)
   layouts/      layout dùng chung (nested)
-  server.ts     server entry — Express/Hono/Nest mount fluxe (mặc định Express)
-  backend.ts    TẦNG DATA của bạn: interface domain + chọn driver (memory/sqlite/postgres)
+  backend/      BACKEND của bạn (Express/Hono/Nest + fluxe)
+    server.ts     entry: mount fluxe (catch-all) + route riêng của bạn
+    data.ts       TẦNG DATA: interface domain + chọn driver (memory/sqlite/postgres); export backend
   profiles.ts   profile resolve render mode (static/island) per môi trường
   contract.ts   schema → codegen types TS
   env.ts        env có kiểu, validate fail-fast lúc boot
@@ -60,7 +61,7 @@ src/        ← ENGINE (không đụng) — Resolution Plane
   server_factory.ts   runtime ráp cell + giải manifest
 ```
 
-**Quy tắc:** backend là **tầng data của bạn** ở `app/backend.ts` (interface domain + chọn driver),
+**Quy tắc:** backend là **tầng data của bạn** ở `app/backend/data.ts` (interface domain + chọn driver),
 inject qua `makeServer(…, { backend })`. Engine không bao giờ import ngược vào `app/`.
 
 ## Tính năng (tất cả TDD + chạy thật)
@@ -69,7 +70,7 @@ inject qua `makeServer(…, { backend })`. Engine không bao giờ import ngư
 - **Render** — static (0 JS) · island hydrate · SPA nav (Inertia) · static-prerender · API mode `?json=1`
 - **Routing** — động `[param]` → `ctx.input` · **nested layouts** · SEO (head/canonical/OG/JSON-LD per cell, `/sitemap.xml`, `/robots.txt`)
 - **Bảo mật (đầy đủ)** — input validation (Zod) · auth password **scrypt** · **RBAC** · **CSRF** double-submit · **rate-limit** token-bucket · error handling không-leak + structured
-- **Data** — backend **user-owned** ở `app/backend.ts` (bạn tự định nghĩa interface + implement bằng `node:sqlite`/`pg`/ORM trực tiếp), inject qua `makeServer(…, { backend })` · engine 0 driver · **codegen contract** 1 schema → types TS
+- **Data** — backend **user-owned** ở `app/backend/data.ts` (bạn tự định nghĩa interface + implement bằng `node:sqlite`/`pg`/ORM trực tiếp), inject qua `makeServer(…, { backend })` · engine 0 driver · **codegen contract** 1 schema → types TS
 - **Mutations DX** — `RpcError` có cấu trúc · `mutate()` optimistic + rollback · lỗi validation field-level
 - **Realtime (Trục 4g)** — **SSE channel** + pub/sub broker · live-update on action · **presence** (multi-tab)
 - **Async** — **job queue bền** (SQLite, retry → dead-letter)
@@ -79,7 +80,7 @@ inject qua `makeServer(…, { backend })`. Engine không bao giờ import ngư
 
 ## Backend data (user-owned, TS in-process)
 
-Backend là **tầng data của bạn** — định nghĩa interface domain ở `app/backend.ts` + chọn driver
+Backend là **tầng data của bạn** — định nghĩa interface domain ở `app/backend/data.ts` + chọn driver
 **TS in-process** dưới đây, inject qua `makeServer(…, { backend })`. Cell chỉ thấy interface:
 
 | Driver | Bạn tự implement bằng |
@@ -89,7 +90,7 @@ Backend là **tầng data của bạn** — định nghĩa interface domain ở
 | `postgres` | `npm i pg`, dùng `Pool`/`Client` trực tiếp (`DATABASE_URL`) |
 
 ```ts
-// app/backend.ts — engine không biết gì
+// app/backend/data.ts — engine không biết gì
 import { DatabaseSync } from "node:sqlite";
 
 export interface Todo { id: string; title: string; done: boolean }

package/lib/core/cli.js

@@ -47,7 +47,7 @@ export const COMMANDS = {
     },
     dev: {
         desc: "Sync + resolve + build client + chạy server",
-        shell: (a) => `${SYNC} && tsx scripts/resolve.ts ${p(a)} && ${ESBUILD} && tsx app/server.ts`,
+        shell: (a) => `${SYNC} && tsx scripts/resolve.ts ${p(a)} && ${ESBUILD} && tsx app/backend/server.ts`,
     },
     test: {
         desc: "Sync + typecheck + unit + integration",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nmvuong92/fluxe",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "fluxe — khung fullstack tối giản, một runtime TS (RCA: Resolved Cell Architecture).",
   "license": "Apache-2.0",
   "author": "nmvuong92",
@@ -56,7 +56,7 @@
     "typecheck": "tsc --noEmit",
     "sync": "tsx scripts/sync.ts",
     "build:client": "npm run sync && esbuild src/client.tsx --bundle --format=esm --outfile=dist/client.js --jsx=automatic --loader:.tsx=tsx",
-    "dev": "npm run build:client && tsx app/server.ts",
+    "dev": "npm run build:client && tsx app/backend/server.ts",
     "dev:node": "npm run build:client && tsx src/server.tsx",
     "test": "tsx src/selftest2.ts",
     "test:unit": "node --experimental-sqlite --import tsx --test '{src,app}/**/*.test.ts'",