@nsxbet/admin-sdk 0.5.1 → 0.7.0

package/CHECKLIST.md

@@ -12,7 +12,7 @@
 - [ ] `vite.config.ts` — Vite build config
 - [ ] `index.html` — HTML entry point
 - [ ] `src/spa.tsx` — Shell entry (default export)
-- [ ] `src/standalone.tsx` — Dev entry (AdminShell wrapper)
+- [ ] `src/main.tsx` — Dev entry (AdminShell wrapper)
 - [ ] `src/App.tsx` — Main app component (Routes)
 - [ ] `src/index.css` — Styles with Tailwind directives
 - [ ] `tailwind.config.js` — Tailwind config
@@ -20,17 +20,36 @@
 - [ ] `tsconfig.json` — TypeScript config
 - [ ] `tsconfig.node.json` — Node TypeScript config
 - [ ] `src/globals.d.ts` — Global type declarations
+- [ ] `src/i18n/locales/en-US.json` — English (US) translations
+- [ ] `src/i18n/locales/pt-BR.json` — Portuguese (Brazil) translations
+- [ ] `src/i18n/locales/es.json` — Spanish translations
+- [ ] `src/i18n/locales/ro.json` — Romanian translations
+- [ ] `.env.staging` — Gateway environment config (staging mode)
+
+## Environment Configuration
+
+- [ ] `.env.staging` exists with `VITE_ADMIN_GATEWAY_URL` configured
+- [ ] `dev` script uses `--mode staging` to load `.env.staging` by default
+
+Expected `.env.staging`:
+
+```bash
+# Gateway URL for BFF token integration (InMemory auth)
+# Fetches real signed JWTs from the admin gateway instead of mock tokens.
+# Staging: https://admin-bff-stg.nsx.dev | Homol: https://admin-bff-homol.nsx.dev | Local: http://localhost:8080
+VITE_ADMIN_GATEWAY_URL=https://admin-bff-stg.nsx.dev
+```
 
 ## Module Manifest (`admin.module.json`)
 
 - [ ] Has `id` field (format: `@admin/<name>`)
-- [ ] Has `title` field
+- [ ] Has `title` field (localized object with en-US, pt-BR, es, ro)
 - [ ] Has `routeBase` field (starts with `/`)
-- [ ] Has `description` field (recommended)
+- [ ] Has `description` field (required, localized object with all 4 locales)
 - [ ] Has `version` field (recommended)
 - [ ] Has `category` field (recommended)
 - [ ] Has `permissions` object (recommended, values are string arrays)
-- [ ] Has `commands` array (recommended, each with `id`, `title`, `route`)
+- [ ] Has `commands` array (recommended, each with `id`, `title` (localized), `route`)
 - [ ] All command `route` values start with the module's `routeBase`
 
 Expected structure:
@@ -38,12 +57,14 @@ Expected structure:
 ```json
 {
   "id": "@admin/my-module",
-  "title": "My Module",
+  "title": { "en-US": "My Module", "pt-BR": "Meu Módulo", "es": "Mi Módulo", "ro": "Modulul Meu" },
   "routeBase": "/my-module",
-  "description": "My Module admin module",
+  "description": { "en-US": "My Module admin module", "pt-BR": "...", "es": "...", "ro": "..." },
   "version": "1.0.0",
   "category": "Tools",
-  "commands": [{ "id": "home", "title": "Home", "route": "/my-module/home" }],
+  "commands": [
+    { "id": "home", "title": { "en-US": "Home", "pt-BR": "Início", "es": "Inicio", "ro": "Acasă" }, "route": "/my-module/home" }
+  ],
   "permissions": {
     "view": ["admin.my-module.view"],
     "edit": ["admin.my-module.edit"],
@@ -52,6 +73,14 @@ Expected structure:
 }
 ```
 
+## i18n
+
+- [ ] All 4 locale files exist: `src/i18n/locales/en-US.json`, `pt-BR.json`, `es.json`, `ro.json`
+- [ ] Manifest `title` and `description` are localized objects (not plain strings)
+- [ ] Each command `title` is a localized object
+- [ ] No manual i18n registration in `main.tsx` or `spa.tsx` (Vite plugin auto-injects)
+- [ ] No `import "./i18n"` in `App.tsx`
+
 ## Dependencies (`package.json`)
 
 - [ ] `"type": "module"` is set
@@ -162,7 +191,7 @@ import { App } from "./App";
 export default App;
 ```
 
-### `src/standalone.tsx`
+### `src/main.tsx`
 
 - [ ] Uses `AdminShell` from `@nsxbet/admin-sdk`
 - [ ] Imports manifest and passes to `modules` prop
@@ -220,13 +249,25 @@ If your module was scaffolded by Lovable, the following differences apply:
 - [ ] `vite.config.ts` uses `adminModule()` spread into the existing plugins array (option B above), NOT `defineModuleConfig`
 - [ ] React plugin is `@vitejs/plugin-react-swc` (Lovable default) — this is supported
 - [ ] `index.html` entry point references `/src/main.tsx` (Lovable default) — this serves as the standalone dev entry
-- [ ] `src/main.tsx` wraps your App with `AdminShell` (same role as `src/standalone.tsx` in non-Lovable modules)
+- [ ] `src/main.tsx` wraps your App with `AdminShell` (same role as `src/main.tsx` in non-Lovable modules)
 - [ ] `src/spa.tsx` still required — `export default App` for shell mode
 - [ ] `admin.module.json` still required at project root
 - [ ] `module.manifest.json` is auto-generated at build time by `adminModule()` — do NOT manually copy `admin.module.json` to `dist/`
 - [ ] Lovable's existing `server`, `resolve.alias`, and plugin settings are preserved — `adminModule()` only affects `vite build`
 - [ ] Build script can be `"vite build"` (Lovable default) or `"tsc && vite build"` — both work
 
+### Environment Configuration (automatic)
+
+`adminModule()` automatically injects `VITE_ADMIN_GATEWAY_URL` with the staging gateway URL (`https://admin-bff-stg.nsx.dev`). No `.env.staging` file or `--mode staging` script is needed for Lovable projects.
+
+- [ ] Do NOT create `.env.staging` — the Vite plugin handles it
+- [ ] Do NOT add `--mode staging` to the dev script
+
+To override the gateway URL, either:
+- Set `VITE_ADMIN_GATEWAY_URL` in a `.env` or `.env.local` file
+- Pass `gatewayUrl` option: `...adminModule({ gatewayUrl: "http://localhost:8080" })`
+- Disable injection: `...adminModule({ gatewayUrl: null })`
+
 Expected `vite.config.ts` for Lovable:
 
 ```typescript
@@ -294,8 +335,9 @@ ReactDOM.createRoot(document.getElementById("root")!).render(
 
 - [ ] No `@supabase/supabase-js` or `supabase` imports in `src/**`
 - [ ] No `firebase` imports in `src/**`
-- [ ] No `BrowserRouter` or `MemoryRouter` in `src/**` (except `standalone.tsx`)
+- [ ] No `BrowserRouter` or `MemoryRouter` in `src/**` (except `main.tsx`)
 - [ ] No `useNavigate` imported from `@nsxbet/admin-sdk` (use `react-router-dom`)
 - [ ] No `@supabase/supabase-js` or `firebase` in `package.json` dependencies
 - [ ] No raw `fetch()` or `window.fetch()` calls — use `useFetch()` from the SDK
+- [ ] No direct date formatting (`toLocaleDateString`, `toLocaleTimeString`, `Intl.DateTimeFormat`, dayjs/moment `.format()`, date-fns `format`) — use `<Timestamp />` or `useTimestamp()` from the SDK
 - [ ] Do NOT scaffold shadcn/ui components locally — use `@nsxbet/admin-ui` which ships them pre-configured