@mostajs/setup 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dr Hamid MADANI <drmdh@msn.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+# @mostajs/setup
+
+> Reusable setup wizard module — multi-dialect DB configuration, .env.local writer, seed runner.
+
+[![npm version](https://img.shields.io/npm/v/@mostajs/setup.svg)](https://www.npmjs.com/package/@mostajs/setup)
+[![license](https://img.shields.io/npm/l/@mostajs/setup.svg)](LICENSE)
+
+Part of the [@mosta suite](https://mostajs.dev).
+
+---
+
+## Installation
+
+```bash
+npm install @mostajs/setup @mostajs/orm
+```
+
+## Quick Start
+
+### 1. Create setup config
+
+```typescript
+import type { MostaSetupConfig } from '@mostajs/setup'
+
+export const setupConfig: MostaSetupConfig = {
+  appName: 'MyApp',
+  defaultPort: 3000,
+  seedRBAC: async () => { /* seed roles & permissions */ },
+  createAdmin: async ({ email, hashedPassword, firstName, lastName }) => { /* create admin user */ },
+}
+```
+
+### 2. API routes
+
+```typescript
+// app/api/setup/status/route.ts
+import { createStatusHandler, needsSetup } from '@mostajs/setup'
+export const { GET } = createStatusHandler(() => needsSetup(countUsers))
+
+// app/api/setup/test-db/route.ts
+import { createTestDbHandler } from '@mostajs/setup'
+export const { POST } = createTestDbHandler(() => needsSetup(countUsers))
+
+// app/api/setup/install/route.ts
+import { createInstallHandler } from '@mostajs/setup'
+export const { POST } = createInstallHandler(() => needsSetup(countUsers), setupConfig)
+```
+
+## Features
+
+- **13 database dialects** — all dialects supported by @mostajs/orm
+- **Connection testing** — test DB connection before saving
+- **URI composition** — auto-build connection URI from form fields
+- **.env.local writer** — persist DB config to disk
+- **Seed runner** — RBAC + admin user creation
+- **Dialect metadata** — names, icons, default ports, categories
+
+## API Reference
+
+| Export | Description |
+|--------|-------------|
+| `needsSetup(countFn)` | Check if app needs initial setup |
+| `runInstall(config)` | Full installation flow |
+| `testDbConnection(config)` | Test DB connection |
+| `composeDbUri(config)` | Build connection URI |
+| `writeEnvLocal(vars)` | Write/update .env.local |
+| `DIALECT_INFO` / `ALL_DIALECTS` | Dialect metadata |
+| `createStatusHandler()` | GET /setup/status factory |
+| `createTestDbHandler()` | POST /setup/test-db factory |
+| `createInstallHandler()` | POST /setup/install factory |
+
+## Related Packages
+
+- [@mostajs/orm](https://www.npmjs.com/package/@mostajs/orm) — Multi-dialect ORM (required)
+- [@mostajs/auth](https://www.npmjs.com/package/@mostajs/auth) — Authentication (for RBAC seeding)
+
+## License
+
+MIT — © 2025 Dr Hamid MADANI <drmdh@msn.com>

package/dist/api/install.route.d.ts

@@ -0,0 +1,17 @@
+import { NextResponse } from 'next/server';
+import type { MostaSetupConfig } from '../types';
+type NeedsSetupFn = () => Promise<boolean>;
+/**
+ * Creates a POST handler for running the installation.
+ */
+export declare function createInstallHandler(needsSetup: NeedsSetupFn, setupConfig: MostaSetupConfig): {
+    POST: (req: Request) => Promise<NextResponse<{
+        error: string;
+    }> | NextResponse<{
+        ok: boolean;
+        error?: string;
+        needsRestart: boolean;
+        seeded?: string[];
+    }>>;
+};
+export {};

package/dist/api/install.route.js

@@ -0,0 +1,23 @@
+"use strict";
+// @mosta/setup — API Route template for install
+// Author: Dr Hamid MADANI drmdh@msn.com
+//
+// Copy to: src/app/api/setup/install/route.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInstallHandler = createInstallHandler;
+const server_1 = require("next/server");
+const setup_1 = require("../lib/setup");
+/**
+ * Creates a POST handler for running the installation.
+ */
+function createInstallHandler(needsSetup, setupConfig) {
+    async function POST(req) {
+        if (!(await needsSetup())) {
+            return server_1.NextResponse.json({ error: 'Already installed' }, { status: 400 });
+        }
+        const body = await req.json();
+        const result = await (0, setup_1.runInstall)(body, setupConfig);
+        return server_1.NextResponse.json(result);
+    }
+    return { POST };
+}

package/dist/api/status.route.d.ts

@@ -0,0 +1,11 @@
+import { NextResponse } from 'next/server';
+type NeedsSetupFn = () => Promise<boolean>;
+/**
+ * Creates a GET handler for checking setup status.
+ */
+export declare function createStatusHandler(needsSetup: NeedsSetupFn): {
+    GET: () => Promise<NextResponse<{
+        needsSetup: boolean;
+    }>>;
+};
+export {};

package/dist/api/status.route.js

@@ -0,0 +1,18 @@
+"use strict";
+// @mosta/setup — API Route template for status check
+// Author: Dr Hamid MADANI drmdh@msn.com
+//
+// Copy to: src/app/api/setup/status/route.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatusHandler = createStatusHandler;
+const server_1 = require("next/server");
+/**
+ * Creates a GET handler for checking setup status.
+ */
+function createStatusHandler(needsSetup) {
+    async function GET() {
+        const needed = await needsSetup();
+        return server_1.NextResponse.json({ needsSetup: needed });
+    }
+    return { GET };
+}

package/dist/api/test-db.route.d.ts

@@ -0,0 +1,14 @@
+import { NextResponse } from 'next/server';
+type NeedsSetupFn = () => Promise<boolean>;
+/**
+ * Creates a POST handler for testing DB connections.
+ */
+export declare function createTestDbHandler(needsSetup: NeedsSetupFn): {
+    POST: (req: Request) => Promise<NextResponse<{
+        error: string;
+    }> | NextResponse<{
+        ok: boolean;
+        error?: string;
+    }>>;
+};
+export {};

package/dist/api/test-db.route.js

@@ -0,0 +1,34 @@
+"use strict";
+// @mosta/setup — API Route template for test-db
+// Author: Dr Hamid MADANI drmdh@msn.com
+//
+// Copy to: src/app/api/setup/test-db/route.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestDbHandler = createTestDbHandler;
+const server_1 = require("next/server");
+const db_test_1 = require("../lib/db-test");
+/**
+ * Creates a POST handler for testing DB connections.
+ */
+function createTestDbHandler(needsSetup) {
+    async function POST(req) {
+        if (!(await needsSetup())) {
+            return server_1.NextResponse.json({ error: 'Already installed' }, { status: 400 });
+        }
+        const body = await req.json();
+        const { dialect, host, port, name, user, password } = body;
+        if (!dialect || !name) {
+            return server_1.NextResponse.json({ error: 'Missing required fields' }, { status: 400 });
+        }
+        const result = await (0, db_test_1.testDbConnection)({
+            dialect: dialect,
+            host: host || 'localhost',
+            port: port || 27017,
+            name,
+            user: user || '',
+            password: password || '',
+        });
+        return server_1.NextResponse.json(result);
+    }
+    return { POST };
+}

package/dist/data/dialects.d.ts

@@ -0,0 +1,3 @@
+import type { DialectType, DialectInfo } from '../types';
+export declare const DIALECT_INFO: Record<DialectType, DialectInfo>;
+export declare const ALL_DIALECTS: DialectType[];

package/dist/data/dialects.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_DIALECTS = exports.DIALECT_INFO = void 0;
+exports.DIALECT_INFO = {
+    mongodb: {
+        name: 'MongoDB',
+        icon: '🍃',
+        defaultPort: 27017,
+        defaultUser: '',
+        defaultHost: 'localhost',
+        driverHint: null,
+        requiresAuth: false,
+        category: 'document',
+    },
+    sqlite: {
+        name: 'SQLite',
+        icon: '📄',
+        defaultPort: 0,
+        defaultUser: '',
+        defaultHost: '',
+        driverHint: null,
+        requiresAuth: false,
+        category: 'file',
+    },
+    postgres: {
+        name: 'PostgreSQL',
+        icon: '🐘',
+        defaultPort: 5432,
+        defaultUser: 'postgres',
+        defaultHost: 'localhost',
+        driverHint: 'npm install pg',
+        requiresAuth: true,
+        category: 'sql',
+    },
+    mysql: {
+        name: 'MySQL',
+        icon: '🐬',
+        defaultPort: 3306,
+        defaultUser: 'root',
+        defaultHost: 'localhost',
+        driverHint: 'npm install mysql2',
+        requiresAuth: true,
+        category: 'sql',
+    },
+    mariadb: {
+        name: 'MariaDB',
+        icon: '🦭',
+        defaultPort: 3306,
+        defaultUser: 'root',
+        defaultHost: 'localhost',
+        driverHint: 'npm install mariadb',
+        requiresAuth: true,
+        category: 'sql',
+    },
+    oracle: {
+        name: 'Oracle',
+        icon: '🔴',
+        defaultPort: 1521,
+        defaultUser: 'system',
+        defaultHost: 'localhost',
+        driverHint: 'npm install oracledb',
+        requiresAuth: true,
+        category: 'enterprise',
+    },
+    mssql: {
+        name: 'Microsoft SQL Server',
+        icon: '🟦',
+        defaultPort: 1433,
+        defaultUser: 'sa',
+        defaultHost: 'localhost',
+        driverHint: 'npm install tedious',
+        requiresAuth: true,
+        category: 'enterprise',
+    },
+    cockroachdb: {
+        name: 'CockroachDB',
+        icon: '🪳',
+        defaultPort: 26257,
+        defaultUser: 'root',
+        defaultHost: 'localhost',
+        driverHint: 'npm install pg',
+        requiresAuth: true,
+        category: 'distributed',
+    },
+    db2: {
+        name: 'IBM DB2',
+        icon: '🏢',
+        defaultPort: 50000,
+        defaultUser: 'db2inst1',
+        defaultHost: 'localhost',
+        driverHint: 'npm install ibm_db',
+        requiresAuth: true,
+        category: 'enterprise',
+    },
+    hana: {
+        name: 'SAP HANA',
+        icon: '💎',
+        defaultPort: 39013,
+        defaultUser: 'SYSTEM',
+        defaultHost: 'localhost',
+        driverHint: 'npm install @sap/hana-client',
+        requiresAuth: true,
+        category: 'enterprise',
+    },
+    hsqldb: {
+        name: 'HyperSQL',
+        icon: '⚡',
+        defaultPort: 9001,
+        defaultUser: 'SA',
+        defaultHost: 'localhost',
+        driverHint: null,
+        requiresAuth: false,
+        category: 'legacy',
+    },
+    spanner: {
+        name: 'Google Cloud Spanner',
+        icon: '☁️',
+        defaultPort: 0,
+        defaultUser: '',
+        defaultHost: '',
+        driverHint: 'npm install @google-cloud/spanner',
+        requiresAuth: false,
+        category: 'distributed',
+    },
+    sybase: {
+        name: 'Sybase ASE',
+        icon: '🔷',
+        defaultPort: 5000,
+        defaultUser: 'sa',
+        defaultHost: 'localhost',
+        driverHint: 'npm install sybase',
+        requiresAuth: true,
+        category: 'legacy',
+    },
+};
+exports.ALL_DIALECTS = Object.keys(exports.DIALECT_INFO);

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { needsSetup, runInstall } from './lib/setup';
+export { testDbConnection } from './lib/db-test';
+export { composeDbUri } from './lib/compose-uri';
+export { writeEnvLocal } from './lib/env-writer';
+export { DIALECT_INFO, ALL_DIALECTS } from './data/dialects';
+export { createTestDbHandler } from './api/test-db.route';
+export { createInstallHandler } from './api/install.route';
+export { createStatusHandler } from './api/status.route';
+export type { DialectType, DialectInfo, DbConfig, InstallConfig, SeedOptions, SeedDefinition, MostaSetupConfig, } from './types';

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+// @mosta/setup — Barrel exports
+// Author: Dr Hamid MADANI drmdh@msn.com
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatusHandler = exports.createInstallHandler = exports.createTestDbHandler = exports.ALL_DIALECTS = exports.DIALECT_INFO = exports.writeEnvLocal = exports.composeDbUri = exports.testDbConnection = exports.runInstall = exports.needsSetup = void 0;
+// Core
+var setup_1 = require("./lib/setup");
+Object.defineProperty(exports, "needsSetup", { enumerable: true, get: function () { return setup_1.needsSetup; } });
+Object.defineProperty(exports, "runInstall", { enumerable: true, get: function () { return setup_1.runInstall; } });
+var db_test_1 = require("./lib/db-test");
+Object.defineProperty(exports, "testDbConnection", { enumerable: true, get: function () { return db_test_1.testDbConnection; } });
+var compose_uri_1 = require("./lib/compose-uri");
+Object.defineProperty(exports, "composeDbUri", { enumerable: true, get: function () { return compose_uri_1.composeDbUri; } });
+var env_writer_1 = require("./lib/env-writer");
+Object.defineProperty(exports, "writeEnvLocal", { enumerable: true, get: function () { return env_writer_1.writeEnvLocal; } });
+// Data
+var dialects_1 = require("./data/dialects");
+Object.defineProperty(exports, "DIALECT_INFO", { enumerable: true, get: function () { return dialects_1.DIALECT_INFO; } });
+Object.defineProperty(exports, "ALL_DIALECTS", { enumerable: true, get: function () { return dialects_1.ALL_DIALECTS; } });
+// API route factories
+var test_db_route_1 = require("./api/test-db.route");
+Object.defineProperty(exports, "createTestDbHandler", { enumerable: true, get: function () { return test_db_route_1.createTestDbHandler; } });
+var install_route_1 = require("./api/install.route");
+Object.defineProperty(exports, "createInstallHandler", { enumerable: true, get: function () { return install_route_1.createInstallHandler; } });
+var status_route_1 = require("./api/status.route");
+Object.defineProperty(exports, "createStatusHandler", { enumerable: true, get: function () { return status_route_1.createStatusHandler; } });

package/dist/lib/compose-uri.d.ts

@@ -0,0 +1,5 @@
+import type { DialectType, DbConfig } from '../types';
+/**
+ * Compose a database connection URI from individual fields.
+ */
+export declare function composeDbUri(dialect: DialectType, config: DbConfig): string;

package/dist/lib/compose-uri.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeDbUri = composeDbUri;
+/**
+ * Compose a database connection URI from individual fields.
+ */
+function composeDbUri(dialect, config) {
+    const { host, port, name, user, password } = config;
+    const eu = encodeURIComponent(user);
+    const ep = encodeURIComponent(password);
+    switch (dialect) {
+        case 'mongodb':
+            if (user && password)
+                return `mongodb://${eu}:${ep}@${host}:${port}/${name}`;
+            return `mongodb://${host}:${port}/${name}`;
+        case 'sqlite':
+            return `./data/${name}.db`;
+        case 'postgres':
+        case 'cockroachdb':
+            return `postgresql://${eu}:${ep}@${host}:${port}/${name}`;
+        case 'mysql':
+            return `mysql://${eu}:${ep}@${host}:${port}/${name}`;
+        case 'mariadb':
+            return `mariadb://${eu}:${ep}@${host}:${port}/${name}`;
+        case 'oracle':
+            return `oracle://${eu}:${ep}@${host}:${port}/${name}`;
+        case 'mssql':
+            return `mssql://${eu}:${ep}@${host}:${port}/${name}`;
+        case 'db2':
+            return `db2://${eu}:${ep}@${host}:${port}/${name}`;
+        case 'hana':
+            return `hana://${eu}:${ep}@${host}:${port}`;
+        case 'hsqldb':
+            return `hsqldb:hsql://${host}:${port}/${name}`;
+        case 'spanner':
+            return `spanner://projects/${name}`;
+        case 'sybase':
+            return `sybase://${eu}:${ep}@${host}:${port}/${name}`;
+        default:
+            return `mongodb://${host}:${port}/${name}`;
+    }
+}

package/dist/lib/db-test.d.ts

@@ -0,0 +1,10 @@
+import type { DialectType, DbConfig } from '../types';
+/**
+ * Test a database connection without affecting the global dialect singleton.
+ */
+export declare function testDbConnection(params: {
+    dialect: DialectType;
+} & DbConfig): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/dist/lib/db-test.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testDbConnection = testDbConnection;
+const compose_uri_1 = require("./compose-uri");
+/**
+ * Test a database connection without affecting the global dialect singleton.
+ */
+async function testDbConnection(params) {
+    const { dialect, ...dbConfig } = params;
+    try {
+        switch (dialect) {
+            case 'mongodb': {
+                const uri = (0, compose_uri_1.composeDbUri)('mongodb', dbConfig);
+                const mongoose = await Promise.resolve().then(() => __importStar(require('mongoose')));
+                const conn = mongoose.default.createConnection(uri, {
+                    serverSelectionTimeoutMS: 5000,
+                    connectTimeoutMS: 5000,
+                });
+                try {
+                    await conn.asPromise();
+                    return { ok: conn.readyState === 1 };
+                }
+                finally {
+                    await conn.close().catch(() => { });
+                }
+            }
+            case 'sqlite':
+                return { ok: true };
+            default: {
+                const uri = (0, compose_uri_1.composeDbUri)(dialect, dbConfig);
+                const { testConnection } = await Promise.resolve().then(() => __importStar(require('@mostajs/orm')));
+                const ok = await testConnection({ dialect, uri, schemaStrategy: 'none' });
+                return { ok };
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Connexion echouee';
+        return { ok: false, error: message };
+    }
+}

package/dist/lib/env-writer.d.ts

@@ -0,0 +1,14 @@
+import type { DialectType } from '../types';
+export interface EnvWriterOptions {
+    dialect: DialectType;
+    uri: string;
+    /** Extra variables to write (e.g. STRIPE_KEY, SMTP_HOST) */
+    extraVars?: Record<string, string>;
+    /** Default app port (default: 3000) */
+    port?: number;
+}
+/**
+ * Write or update .env.local with DB_DIALECT + SGBD_URI.
+ * Preserves commented lines. Returns true if dialect changed (needs restart).
+ */
+export declare function writeEnvLocal(options: EnvWriterOptions): Promise<boolean>;

package/dist/lib/env-writer.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeEnvLocal = writeEnvLocal;
+// @mosta/setup — Write/update .env.local
+// Author: Dr Hamid MADANI drmdh@msn.com
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Write or update .env.local with DB_DIALECT + SGBD_URI.
+ * Preserves commented lines. Returns true if dialect changed (needs restart).
+ */
+async function writeEnvLocal(options) {
+    const { dialect, uri, extraVars, port = 3000 } = options;
+    const envPath = path_1.default.resolve(process.cwd(), '.env.local');
+    let content = '';
+    let previousDialect = null;
+    try {
+        content = fs_1.default.readFileSync(envPath, 'utf-8');
+        const match = content.match(/^DB_DIALECT=(.+)$/m);
+        if (match)
+            previousDialect = match[1].trim();
+    }
+    catch {
+        // .env.local doesn't exist yet
+    }
+    const schemaValue = dialect !== 'mongodb' ? 'update' : undefined;
+    if (content) {
+        // Replace only active (uncommented) lines
+        content = upsertEnvLine(content, 'DB_DIALECT', dialect);
+        content = upsertEnvLine(content, 'SGBD_URI', uri);
+        if (schemaValue) {
+            content = upsertEnvLine(content, 'DB_SCHEMA_STRATEGY', schemaValue);
+        }
+        else if (/^DB_SCHEMA_STRATEGY=/m.test(content)) {
+            content = content.replace(/^DB_SCHEMA_STRATEGY=.*$/m, '#DB_SCHEMA_STRATEGY=update');
+        }
+        // Write extra vars
+        if (extraVars) {
+            for (const [key, val] of Object.entries(extraVars)) {
+                content = upsertEnvLine(content, key, val);
+            }
+        }
+    }
+    else {
+        // Fresh .env.local
+        const { randomBytes } = await Promise.resolve().then(() => __importStar(require('crypto')));
+        const secret = randomBytes(32).toString('base64');
+        const lines = [
+            `DB_DIALECT=${dialect}`,
+            `SGBD_URI=${uri}`,
+            ...(schemaValue ? [`DB_SCHEMA_STRATEGY=${schemaValue}`] : []),
+            '',
+            '# NextAuth Configuration',
+            `NEXTAUTH_URL=http://localhost:${port}`,
+            `NEXTAUTH_SECRET=${secret}`,
+            `AUTH_SECRET=${secret}`,
+            `NEXT_PUBLIC_APP_URL=http://localhost:${port}`,
+            '',
+            '# Environment',
+            'NODE_ENV=development',
+            `PORT=${port}`,
+            '',
+            ...(extraVars
+                ? ['# App Configuration', ...Object.entries(extraVars).map(([k, v]) => `${k}=${v}`), '']
+                : []),
+        ];
+        content = lines.join('\n') + '\n';
+    }
+    fs_1.default.writeFileSync(envPath, content, 'utf-8');
+    return previousDialect !== null && previousDialect !== dialect;
+}
+function upsertEnvLine(content, key, value) {
+    const regex = new RegExp(`^${key}=.*$`, 'm');
+    if (regex.test(content)) {
+        return content.replace(regex, `${key}=${value}`);
+    }
+    return content.trimEnd() + `\n${key}=${value}\n`;
+}

package/dist/lib/setup.d.ts

@@ -0,0 +1,22 @@
+import type { InstallConfig, MostaSetupConfig } from '../types';
+/**
+ * Check if the app needs initial setup (0 users in DB).
+ * Provide a countUsers function from your app.
+ */
+export declare function needsSetup(countUsers: () => Promise<number>): Promise<boolean>;
+/**
+ * Run the complete installation flow.
+ *
+ * 1. Compose URI and write .env.local
+ * 2. Set process.env in-memory
+ * 3. Disconnect existing dialect singleton
+ * 4. Seed RBAC (via config.seedRBAC callback)
+ * 5. Create first admin user
+ * 6. Run optional seeds
+ */
+export declare function runInstall(installConfig: InstallConfig, setupConfig: MostaSetupConfig): Promise<{
+    ok: boolean;
+    error?: string;
+    needsRestart: boolean;
+    seeded?: string[];
+}>;

package/dist/lib/setup.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsSetup = needsSetup;
+exports.runInstall = runInstall;
+// @mosta/setup — Core setup logic
+// Author: Dr Hamid MADANI drmdh@msn.com
+const compose_uri_1 = require("./compose-uri");
+const env_writer_1 = require("./env-writer");
+/**
+ * Check if the app needs initial setup (0 users in DB).
+ * Provide a countUsers function from your app.
+ */
+async function needsSetup(countUsers) {
+    try {
+        const count = await countUsers();
+        return count === 0;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Run the complete installation flow.
+ *
+ * 1. Compose URI and write .env.local
+ * 2. Set process.env in-memory
+ * 3. Disconnect existing dialect singleton
+ * 4. Seed RBAC (via config.seedRBAC callback)
+ * 5. Create first admin user
+ * 6. Run optional seeds
+ */
+async function runInstall(installConfig, setupConfig) {
+    try {
+        // 1. Compose URI and write .env.local
+        const uri = (0, compose_uri_1.composeDbUri)(installConfig.dialect, installConfig.db);
+        const needsRestart = await (0, env_writer_1.writeEnvLocal)({
+            dialect: installConfig.dialect,
+            uri,
+            extraVars: setupConfig.extraEnvVars,
+            port: setupConfig.defaultPort,
+        });
+        // 2. Set process.env in-memory
+        process.env.DB_DIALECT = installConfig.dialect;
+        process.env.SGBD_URI = uri;
+        if (installConfig.dialect !== 'mongodb') {
+            process.env.DB_SCHEMA_STRATEGY = 'update';
+        }
+        // 3. Disconnect existing dialect singleton
+        const { disconnectDialect } = await Promise.resolve().then(() => __importStar(require('@mostajs/orm')));
+        await disconnectDialect();
+        // 4. Seed RBAC
+        const seeded = [];
+        if (setupConfig.seedRBAC) {
+            await setupConfig.seedRBAC();
+            seeded.push('categories', 'permissions', 'roles');
+        }
+        // 5. Create admin user
+        if (setupConfig.createAdmin) {
+            const bcrypt = await Promise.resolve().then(() => __importStar(require('bcryptjs')));
+            const hashedPassword = await bcrypt.hash(installConfig.admin.password, 12);
+            await setupConfig.createAdmin({
+                email: installConfig.admin.email,
+                hashedPassword,
+                firstName: installConfig.admin.firstName,
+                lastName: installConfig.admin.lastName,
+            });
+            seeded.push('admin');
+        }
+        // 6. Optional seeds
+        if (setupConfig.optionalSeeds && installConfig.seed) {
+            for (const seedDef of setupConfig.optionalSeeds) {
+                if (installConfig.seed[seedDef.key]) {
+                    await seedDef.run({});
+                    seeded.push(seedDef.key);
+                }
+            }
+        }
+        return { ok: true, needsRestart, seeded };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Erreur installation';
+        return { ok: false, error: message, needsRestart: false };
+    }
+}

package/dist/types/index.d.ts

@@ -0,0 +1,61 @@
+export type DialectType = 'mongodb' | 'sqlite' | 'postgres' | 'mysql' | 'mariadb' | 'oracle' | 'mssql' | 'cockroachdb' | 'db2' | 'hana' | 'hsqldb' | 'spanner' | 'sybase';
+export interface DialectInfo {
+    name: string;
+    icon: string;
+    defaultPort: number;
+    defaultUser: string;
+    defaultHost: string;
+    driverHint: string | null;
+    requiresAuth: boolean;
+    category: 'document' | 'file' | 'sql' | 'enterprise' | 'distributed' | 'legacy';
+}
+export interface DbConfig {
+    host: string;
+    port: number;
+    name: string;
+    user: string;
+    password: string;
+}
+export interface InstallConfig {
+    dialect: DialectType;
+    db: DbConfig;
+    admin: {
+        email: string;
+        password: string;
+        firstName: string;
+        lastName: string;
+    };
+    seed?: SeedOptions;
+}
+export interface SeedOptions {
+    [key: string]: boolean;
+}
+export interface SeedDefinition {
+    key: string;
+    label: string;
+    description: string;
+    icon?: string;
+    default?: boolean;
+    run: (repos: any) => Promise<void>;
+}
+export interface MostaSetupConfig {
+    /** Application name (shown in wizard) */
+    appName: string;
+    /** Default port (default: 3000) */
+    defaultPort?: number;
+    /** Enabled dialects (default: all 13) */
+    enabledDialects?: DialectType[];
+    /** Callback to seed RBAC (permissions, roles, categories) */
+    seedRBAC?: () => Promise<void>;
+    /** Create first admin user — called with hashed password */
+    createAdmin?: (admin: {
+        email: string;
+        hashedPassword: string;
+        firstName: string;
+        lastName: string;
+    }) => Promise<void>;
+    /** Optional seeds shown in the wizard */
+    optionalSeeds?: SeedDefinition[];
+    /** Extra env vars to write to .env.local */
+    extraEnvVars?: Record<string, string>;
+}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// @mosta/setup — Types
+// Author: Dr Hamid MADANI drmdh@msn.com
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@mostajs/setup",
+  "version": "1.0.0",
+  "description": "Reusable setup wizard module — multi-dialect DB configuration, .env.local writer, seed runner",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "setup",
+    "wizard",
+    "installer",
+    "database",
+    "multi-dialect",
+    "nextjs",
+    "mosta"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/apolocine/mosta-setup"
+  },
+  "homepage": "https://mostajs.dev/packages/setup",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@mostajs/orm": "^1.0.0",
+    "bcryptjs": "^2.4.3"
+  },
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "mongoose": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/bcryptjs": "^2.4.0",
+    "@types/node": "^25.3.3",
+    "@types/react": "^19.0.0",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "typescript": "^5.6.0"
+  }
+}