@mostajs/orm 1.3.0 → 1.4.0

package/README.md

@@ -490,6 +490,58 @@ DB_SCHEMA_STRATEGY=update  # in .env
 | `DB_CACHE_ENABLED` | `false` | Query result cache |
 | `DB_CACHE_TTL` | `300` | Cache TTL in seconds |
 
+| `MOSTA_BRIDGE_AUTOSTART` | `true` | JDBC bridge auto-start: `true`, `false`, `detect` |
+| `MOSTA_BRIDGE_PORT_BASE` | `8765` | First bridge HTTP port |
+| `MOSTA_BRIDGE_PORT_INCREMENT` | `true` | Auto-increment ports for multiple bridges |
+| `MOSTA_JAR_DIR` | auto-detect | Directory for JDBC JAR files |
+| `MOSTA_BRIDGE_JAVA` | auto-detect | Path to MostaJdbcBridge.java |
+| `MOSTA_BRIDGE_MAX_RETRIES` | `3` | Max bridge start attempts before giving up |
+| `MOSTA_BRIDGE_TIMEOUT` | `15000` | Bridge health check timeout (ms) |
+
+---
+
+## JDBC Bridge & JAR Upload
+
+MostaORM includes a universal JDBC bridge for databases without npm drivers (HyperSQL, Oracle, DB2, SAP HANA, Sybase). The bridge is a Java HTTP server (`MostaJdbcBridge.java`) that translates HTTP requests into JDBC calls.
+
+### JAR Management API
+
+MostaORM exports functions for managing JDBC driver JARs:
+
+```typescript
+import {
+  saveJarFile,      // Save an uploaded JAR to jar_files/
+  deleteJarFile,    // Delete a JAR from jar_files/
+  listJarFiles,     // List all JARs with dialect detection
+  getJdbcDialectStatus,  // Status of each JDBC dialect (JAR present?)
+  detectDialectFromJar,  // Detect dialect from JAR filename
+} from '@mostajs/orm'
+```
+
+### Next.js Route (via @mostajs/setup)
+
+```typescript
+// src/app/api/setup/upload-jar/route.ts
+import { createUploadJarHandlers } from '@mostajs/setup/api/upload-jar'
+
+const { GET, POST, DELETE } = createUploadJarHandlers()
+export { GET, POST, DELETE }
+```
+
+- **GET** — list JARs and JDBC dialect status
+- **POST** — upload a `.jar` file (multipart/form-data, field `jar`)
+- **DELETE** — remove a JAR (`{ "fileName": "hsqldb-2.7.2.jar" }`)
+
+### BridgeManager (multi-bridge)
+
+```typescript
+import { BridgeManager } from '@mostajs/orm'
+
+const manager = BridgeManager.getInstance()
+// Bridges are managed automatically by the dialect's connect()
+// Multiple bridges can run simultaneously on incrementing ports
+```
+
 ---
 
 ## Complete Example — Blog API

package/dist/core/factory.d.ts

@@ -26,7 +26,10 @@ export declare function disconnectDialect(): Promise<void>;
  * Test the connection with a given config without changing the active dialect.
  * Used by the setup wizard to validate before committing.
  */
-export declare function testConnection(config: ConnectionConfig): Promise<boolean>;
+export declare function testConnection(config: ConnectionConfig): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
 /**
  * Simplified high-level API: connect to a database and optionally register schemas.
  * Returns the connected dialect instance.

package/dist/core/factory.js

@@ -117,10 +117,11 @@ export async function testConnection(config) {
         await dialect.connect(config);
         const ok = await dialect.testConnection();
         await dialect.disconnect();
-        return ok;
+        return { ok };
     }
-    catch {
-        return false;
+    catch (e) {
+        const error = e instanceof Error ? e.message : String(e);
+        return { ok: false, error };
     }
 }
 /**

package/docs/plan-session-factory-multi-bridge.md

@@ -1231,3 +1231,118 @@ mosta-orm/
   - process.on('exit/SIGINT/SIGTERM') → stopAll()
   - Détection port occupé avec incrémentation automatique
 
+
+  Architecture JAR Upload                                                    
+                                                                             
+  Navigateur (ReconfigPanel)                                                 
+      │  upload .jar via <input type="file">                                 
+      ▼                                                                      
+  POST /api/setup/upload-jar    (SecuAccessPro route)
+      │  createUploadJarHandlers()
+      ▼
+  @mostajs/setup/api/upload-jar.route.ts    (route factory)
+      │  import('@mostajs/orm')
+      ▼
+  @mostajs/orm/bridge/jar-upload.ts    (logique metier)
+      │  saveJarFile() / deleteJarFile() / listJarFiles()
+      ▼
+  jar_files/hsqldb-2.7.2.jar    (fichier sauvegardé)
+
+  Fichiers créés/modifiés
+
+  ┌───────────┬───────────────────────────────────┬─────────────────────┐
+  │  Package  │              Fichier              │       Action        │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-orm │ src/bridge/jar-upload.ts          │ Logique upload/dele │
+  │           │                                   │ te/list/detect      │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-orm │ src/bridge/BridgeManager.ts       │ Multi-bridge        │
+  │           │                                   │ singleton           │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-orm │ src/index.ts                      │ Exports ajoutés     │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-orm │ README.md                         │ Section JDBC Bridge │
+  │           │                                   │  + JAR Upload       │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-set │ api/upload-jar.route.ts           │ Route factory       │
+  │ up        │                                   │ GET/POST/DELETE     │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-set │                                   │ 13 dialects +       │
+  │ up        │ components/ReconfigPanel.tsx      │ premium badge +     │
+  │           │                                   │ section upload JAR  │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ mosta-set │ README.md                         │ Route upload-jar    │
+  │ up        │                                   │ documentée          │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ SecuAcces │ src/app/api/setup/upload-jar/rout │ Route Next.js       │
+  │ sPro      │ e.ts                              │                     │
+  ├───────────┼───────────────────────────────────┼─────────────────────┤
+  │ SecuAcces │ src/app/dashboard/settings/reconf │ Ajout jarEndpoint   │
+  │ sPro      │ ig/page.tsx                       │                     │
+  └───────────┴───────────────────────────────────┴─────────────────────┘
+
+  Versions publiées
+
+  - @mostajs/orm@1.3.1 — avec BridgeManager, jar-upload,
+  jar_files/hsqldb-2.7.2.jar
+  - @mostajs/setup@1.3.1 — avec ReconfigPanel (13 dialects, premium, upload
+  JAR)
+
+
+                                                                             
+  Page setup alignée avec ReconfigPanel                                      
+                                                                             
+  ┌───────────────┬──────────────────────┬──────────────────────────────┐    
+  │ Modification  │    ReconfigPanel     │          Setup page          │
+  ├───────────────┼──────────────────────┼──────────────────────────────┤    
+  │ 13 dialects   │ Oui (corrigé avant)  │ Oui (déjà present)           │
+  ├───────────────┼──────────────────────┼──────────────────────────────┤    
+  │ Premium grisé │ Oui (opacity: 0.45,  │ Oui (opacity-40 grayscale,   │    
+  │               │ badge "Premium")     │ badge "Premium")             │    
+  ├───────────────┼──────────────────────┼──────────────────────────────┤
+  │ Upload JAR    │ Oui (section         │ Oui (composant               │
+  │               │ complète avec table) │ JarUploadSection inline)     │
+  ├───────────────┼──────────────────────┼──────────────────────────────┤
+  │ JDBC          │ Oui (JDBC_DIALECTS)  │ Oui (JDBC_DIALECTS)          │
+  │ indicator     │                      │                              │
+  ├───────────────┼──────────────────────┼──────────────────────────────┤
+  │ Driver hint   │                      │ Corrigé: "Uploader           │
+  │ hsqldb        │ N/A                  │ hsqldb*.jar" au lieu de "npm │
+  │               │                      │  install hsqldb"             │
+  └───────────────┴──────────────────────┴──────────────────────────────┘
+
+  Les deux pages (setup initial + reconfiguration) sont maintenant alignées
+  avec les mêmes fonctionnalités : 13 dialects, premium grisé, upload JAR
+  pour les dialects JDBC.
+
+✻ Worked for 1m 40s
+
+❯ publie sur npm et install                                                  
+                            
+● Read 2 files (ctrl+o to expand)                                            
+                                                             
+● Les modifications de la page setup sont dans SecuAccessPro (pas dans les   
+  packages npm). Mais mosta-setup n'a pas changé depuis la dernière          
+  publication. Seul mosta-orm n'a pas changé non plus. Pas besoin de         
+  republier — les versions 1.3.1 sont déjà installées et à jour.             
+                                                                             
+  Vérifions que tout est bien installé.                                      
+                                     
+● Bash(npm ls @mostajs/orm @mostajs/setup 2>&1 | head -10)                   
+  ⎿  secuaccesspro@1.0.0 /home/hmd/dev/MostaGare-Install/SecuAccessPro       
+     ├─┬ @mostajs/audit@1.0.3                                                
+     │ └── @mostajs/orm@1.3.1 deduped                                        
+     … +7 lines (ctrl+o to expand)                                           
+                                                                             
+● @mostajs/orm@1.3.1 et @mostajs/setup@1.3.1 sont déjà installés et à jour.
+  Les packages n'ont pas changé — seule la page src/app/setup/page.tsx de    
+  SecuAccessPro a été modifiée (premium + JAR upload), et c'est un fichier   
+  local, pas un package npm.                                                 
+                                                                             
+  Rien à publier ni à installer — tout est déjà en place.
+                                                                             
+❯ la page setup devrait se trouvé dans mosta-setup                           
+                                                                             
+● Compris — la page setup doit être un composant dans mosta-setup, comme     
+  ReconfigPanel. Voyons d'abord la page complète.
+                                                        

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/orm",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Hibernate-inspired multi-dialect ORM for Node.js/TypeScript — One API, 13 databases, zero lock-in",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "MIT",