@mostajs/octoswitcher 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,101 @@
+# @mostajs/octoswitcher
+
+> Data access switcher — ORM direct or NET transport, one interface, zero config in modules.
+
+## Principe
+
+```
+MOSTA_DATA=orm → @mostajs/orm → SQL direct (SQLite, PostgreSQL, Oracle, MSSQL, etc.)
+MOSTA_DATA=net → @mostajs/net → Transport distant (REST, GraphQL, gRPC, WS, MCP)
+```
+
+Les modules @mostajs (auth, rbac, audit, settings, ticketing, secu) appellent `getDialect()` depuis octoswitcher — ils ne savent pas si les données viennent d'une base locale ou d'un serveur distant.
+
+## Installation
+
+```bash
+npm install @mostajs/octoswitcher
+```
+
+## Usage dans un module
+
+```typescript
+import { getDialect } from '@mostajs/octoswitcher'
+import { UserRepository } from './repositories/user.repository.js'
+
+const dialect = await getDialect()
+const repo = new UserRepository(dialect)
+const users = await repo.findAll()
+```
+
+## Configuration (dans l'app, pas dans le module)
+
+### Mode ORM (accès direct base de données)
+
+```env
+MOSTA_DATA=orm
+DB_DIALECT=sqlite
+SGBD_URI=./data/app.db
+```
+
+### Mode NET (accès distant via transport)
+
+```env
+MOSTA_DATA=net
+MOSTA_NET_URL=https://mcp.amia.fr/astro_08/
+MOSTA_NET_TRANSPORT=rest
+```
+
+## API
+
+### `getDialect(): Promise<IDataDialect>`
+Retourne le dialect singleton — ORM ou NET selon `MOSTA_DATA`.
+
+### `getDataMode(): DataMode`
+Retourne `'orm'` ou `'net'`.
+
+### `isNetMode(): boolean`
+Raccourci pour `getDataMode() === 'net'`.
+
+### `isOrmMode(): boolean`
+Raccourci pour `getDataMode() === 'orm'`.
+
+### `setDialect(dialect): void`
+Injecte un dialect externe (pour les tests).
+
+### `resetDialect(): void`
+Réinitialise le singleton (pour les tests).
+
+## Architecture
+
+```
+App (.env.local)
+ ├── MOSTA_DATA=net + MOSTA_NET_URL=...
+ │
+ ├── @mostajs/auth     → @mostajs/rbac → octoswitcher → getDialect()
+ ├── @mostajs/rbac     → octoswitcher → getDialect()
+ ├── @mostajs/audit    → octoswitcher → getDialect()
+ ├── @mostajs/settings → octoswitcher → getDialect()
+ ├── @mostajs/ticketing → octoswitcher → getDialect()
+ └── @mostajs/secu     → octoswitcher → getDialect()
+                              │
+                    ┌─────────┴─────────┐
+                    │                   │
+              MOSTA_DATA=orm      MOSTA_DATA=net
+              @mostajs/orm        @mostajs/net
+              SQL direct          REST/GraphQL/gRPC
+```
+
+## Modules migrés
+
+| Module | Avant | Après |
+|--------|-------|-------|
+| rbac | 212 lignes (data-mode.ts + NET factories) | 106 lignes |
+| audit | 130 lignes (data-mode.ts + NET factories) | 41 lignes |
+| settings | 119 lignes (data-mode.ts + NET factories) | 41 lignes |
+| ticketing | hardcodé ORM | 1 import changé |
+| secu | hardcodé ORM | 1 import changé |
+
+## Licence
+
+AGPL-3.0-or-later — Dr Hamid MADANI <drmdh@msn.com>

package/dist/index.d.ts

@@ -38,7 +38,7 @@ export declare function isOrmMode(): boolean;
  * - MOSTA_DATA=orm (default): loads @mostajs/orm, connects via DB_DIALECT + SGBD_URI
  * - MOSTA_DATA=net: loads @mostajs/net/client, creates NetDialectProxy via MOSTA_NET_URL + MOSTA_NET_TRANSPORT
  *
- * Singleton — first call initializes, subsequent calls return cached instance.
+ * Global singleton — survives module re-imports and Next.js bundler splitting.
  * All @mostajs modules (auth, rbac, audit, settings) call this function.
  */
 export declare function getDialect(): Promise<IDataDialect>;
@@ -48,6 +48,6 @@ export declare function getDialect(): Promise<IDataDialect>;
  */
 export declare function setDialect(dialect: IDataDialect): void;
 /**
- * Reset the singleton (for testing).
+ * Reset the singleton (for testing or after disconnectDialect).
  */
 export declare function resetDialect(): void;

package/dist/index.js

@@ -19,39 +19,50 @@ export function isOrmMode() {
 // ============================================================
 // Singleton dialect
 // ============================================================
-let _dialect = null;
+// Global singleton — survives module re-imports and bundler splitting
+// Uses globalThis to ensure a single dialect instance across the entire process
+const GLOBAL_KEY = '__mostajs_octoswitcher_dialect__';
+function getGlobalDialect() {
+    return globalThis[GLOBAL_KEY] ?? null;
+}
+function setGlobalDialect(dialect) {
+    globalThis[GLOBAL_KEY] = dialect;
+}
 /**
  * Get the data dialect — ORM or NET, determined by MOSTA_DATA env var.
  *
  * - MOSTA_DATA=orm (default): loads @mostajs/orm, connects via DB_DIALECT + SGBD_URI
  * - MOSTA_DATA=net: loads @mostajs/net/client, creates NetDialectProxy via MOSTA_NET_URL + MOSTA_NET_TRANSPORT
  *
- * Singleton — first call initializes, subsequent calls return cached instance.
+ * Global singleton — survives module re-imports and Next.js bundler splitting.
  * All @mostajs modules (auth, rbac, audit, settings) call this function.
  */
 export async function getDialect() {
-    if (_dialect)
-        return _dialect;
+    const cached = getGlobalDialect();
+    if (cached)
+        return cached;
+    let dialect;
     if (isNetMode()) {
-        _dialect = await initNetDialect();
+        dialect = await initNetDialect();
     }
     else {
-        _dialect = await initOrmDialect();
+        dialect = await initOrmDialect();
     }
-    return _dialect;
+    setGlobalDialect(dialect);
+    return dialect;
 }
 /**
  * Inject an external dialect (for testing or custom implementations).
  * After this call, getDialect() returns the injected dialect.
  */
 export function setDialect(dialect) {
-    _dialect = dialect;
+    setGlobalDialect(dialect);
 }
 /**
- * Reset the singleton (for testing).
+ * Reset the singleton (for testing or after disconnectDialect).
  */
 export function resetDialect() {
-    _dialect = null;
+    setGlobalDialect(null);
 }
 // ============================================================
 // ORM mode — direct database access

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/octoswitcher",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Data access switcher — ORM direct or NET transport, one interface, zero config in modules",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",