@mostajs/setup 2.1.3 → 2.1.5

package/README.md

@@ -1123,6 +1123,59 @@ Puis recompilez : `cd packages/mosta-setup && npx tsc`
 | [@mostajs/settings](https://www.npmjs.com/package/@mostajs/settings) | oui | non | Parametres cle-valeur |
 | [@mostajs/face](https://www.npmjs.com/package/@mostajs/face) | **non** | **oui** | Reconnaissance faciale (independant) |
 
+## Catch-all Route Factory (createSetupRoutes)
+
+Replace 6+ individual route files with a single `[...slug]` handler :
+
+```typescript
+// src/app/api/setup/[...slug]/route.ts — 7 lines replaces 6 files
+import { createSetupRoutes } from '@mostajs/setup'
+import { appNeedsSetup, getSetupConfig } from '@/lib/setup-config'
+
+export const { GET, POST, DELETE, PATCH } = createSetupRoutes({
+  needsSetup: appNeedsSetup,
+  getSetupConfig,
+})
+```
+
+Handles all 11 setup endpoints : status, test-db, create-db, preflight, detect-modules, install-modules, setup-json, upload-jar, wire-module, reconfig, install.
+
+## createAdmin (auto-generated)
+
+`loadSetupJson()` automatically generates a `createAdmin` callback that :
+1. Gets the `user` repo via `repoFactory`
+2. Gets the `role` repo to resolve the `admin` role
+3. Creates the admin user with bcrypt-hashed password and admin role
+
+No need to define `createAdmin` manually — it comes from `loadSetupJson()`.
+
+## lookupFields (cross-entity references in seeds)
+
+Resolve a field value from another collection before inserting seed data :
+
+```json
+{
+  "key": "demoClients",
+  "collection": "client",
+  "lookupFields": {
+    "createdBy": { "collection": "user", "match": "status", "value": "active" }
+  },
+  "data": [
+    { "firstName": "Samir", "lastName": "Boudjema", "phone": "0550100001" }
+  ]
+}
+```
+
+`lookupFields.createdBy` : find the first `user` where `status = "active"`, inject its `id` as `createdBy` in every data item.
+
+Useful for seeds that reference entities created by earlier seeds (RBAC roles, admin user, etc.).
+
+## Dynamic Seeds in SetupWizard
+
+The wizard automatically loads available seeds from the `/api/setup/setup-json` endpoint and displays them as checkboxes. Seeds with `"default": true` in setup.json are pre-checked.
+
+No need to hardcode seed checkboxes — add a seed to `setup.json` and it appears in the wizard automatically.
+
 ## License
 
-MIT — (c) 2025 Dr Hamid MADANI <drmdh@msn.com>
+MIT — (c) 2025-2026 Dr Hamid MADANI <drmdh@msn.com>

package/dist/lib/load-setup-json.d.ts

@@ -35,6 +35,11 @@ export interface SetupJsonSeed {
     hashField?: string;
     roleField?: string;
     defaults?: Record<string, unknown>;
+    lookupFields?: Record<string, {
+        collection: string;
+        match: string;
+        value: string;
+    }>;
     data: Record<string, unknown>[];
 }
 export interface SetupJson {

package/dist/lib/load-setup-json.js

@@ -134,8 +134,18 @@ function buildSeedDefinition(seedDef, repoFactory) {
         run: async () => {
             const getRepo = repoFactory ?? defaultRepoFactory;
             const repo = await getRepo(seedDef.collection);
+            // Resolve lookupFields once (e.g. createdBy → user where email = admin@test.dz → userId)
+            const resolved = {};
+            if (seedDef.lookupFields) {
+                for (const [field, lookup] of Object.entries(seedDef.lookupFields)) {
+                    const lookupRepo = await getRepo(lookup.collection);
+                    const found = await lookupRepo.findOne({ [lookup.match]: lookup.value });
+                    if (found)
+                        resolved[field] = found.id;
+                }
+            }
             for (const rawItem of seedDef.data) {
-                const item = { ...(seedDef.defaults ?? {}), ...rawItem };
+                const item = { ...(seedDef.defaults ?? {}), ...resolved, ...rawItem };
                 // Hash field if configured (e.g. password)
                 if (seedDef.hashField && item[seedDef.hashField]) {
                     const bcryptModule = await import('bcryptjs');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/setup",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "Reusable setup wizard module — multi-dialect DB configuration, .env.local writer, seed runner",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "MIT",