@mostajs/orm 1.2.0 → 1.3.1

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/bridge/jar-upload.d.ts

@@ -0,0 +1,47 @@
+import { type JdbcDriverInfo } from './jdbc-registry.js';
+import type { DialectType } from '../core/types.js';
+export interface JarUploadResult {
+    ok: boolean;
+    fileName?: string;
+    dialect?: string;
+    jarDir?: string;
+    replaced?: string;
+    error?: string;
+}
+/**
+ * Detect which dialect a JAR file belongs to based on its filename.
+ */
+export declare function detectDialectFromJar(fileName: string): {
+    dialect: DialectType;
+    info: JdbcDriverInfo;
+} | null;
+/**
+ * List all JAR files currently in the jar_files directory.
+ */
+export declare function listJarFiles(): {
+    fileName: string;
+    dialect: string | null;
+    label: string | null;
+}[];
+/**
+ * Save an uploaded JAR file to the jar_files directory.
+ * If a JAR for the same dialect already exists, it is replaced.
+ *
+ * @param fileName - Original filename (e.g. "hsqldb-2.7.2.jar")
+ * @param data - File content as Buffer or Uint8Array
+ */
+export declare function saveJarFile(fileName: string, data: Buffer | Uint8Array): JarUploadResult;
+/**
+ * Delete a JAR file from the jar_files directory.
+ */
+export declare function deleteJarFile(fileName: string): JarUploadResult;
+/**
+ * Get the list of JDBC-eligible dialects with their JAR status.
+ */
+export declare function getJdbcDialectStatus(): {
+    dialect: DialectType;
+    label: string;
+    jarPrefix: string;
+    hasJar: boolean;
+    jarFile: string | null;
+}[];

package/dist/bridge/jar-upload.js

@@ -0,0 +1,139 @@
+// JAR Upload Handler — receives a JAR file and saves it to jar_files/
+// Used by mosta-setup ReconfigPanel for JDBC dialect configuration
+// Author: Dr Hamid MADANI drmdh@msn.com
+import { existsSync, mkdirSync, writeFileSync, readdirSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { JDBC_REGISTRY } from './jdbc-registry.js';
+// Resolve jar_files directory
+const __filename_resolved = typeof __filename !== 'undefined'
+    ? __filename
+    : fileURLToPath(import.meta.url);
+const __dirname_resolved = dirname(__filename_resolved);
+function getJarDir() {
+    if (process.env.MOSTA_JAR_DIR)
+        return process.env.MOSTA_JAR_DIR;
+    const candidates = [
+        join(process.cwd(), 'jar_files'),
+        join(__dirname_resolved, '..', '..', 'jar_files'),
+        join(__dirname_resolved, '..', '..', '..', 'jar_files'),
+    ];
+    for (const dir of candidates) {
+        if (existsSync(dir))
+            return dir;
+    }
+    return candidates[0]; // Default: cwd/jar_files
+}
+/**
+ * Detect which dialect a JAR file belongs to based on its filename.
+ */
+export function detectDialectFromJar(fileName) {
+    const lowerName = fileName.toLowerCase();
+    for (const [dialect, info] of Object.entries(JDBC_REGISTRY)) {
+        if (info && lowerName.startsWith(info.jarPrefix)) {
+            return { dialect: dialect, info };
+        }
+    }
+    return null;
+}
+/**
+ * List all JAR files currently in the jar_files directory.
+ */
+export function listJarFiles() {
+    const dir = getJarDir();
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter(f => f.endsWith('.jar'))
+        .map(fileName => {
+        const detected = detectDialectFromJar(fileName);
+        return {
+            fileName,
+            dialect: detected?.dialect ?? null,
+            label: detected?.info.label ?? null,
+        };
+    });
+}
+/**
+ * Save an uploaded JAR file to the jar_files directory.
+ * If a JAR for the same dialect already exists, it is replaced.
+ *
+ * @param fileName - Original filename (e.g. "hsqldb-2.7.2.jar")
+ * @param data - File content as Buffer or Uint8Array
+ */
+export function saveJarFile(fileName, data) {
+    // Validate filename
+    if (!fileName.endsWith('.jar')) {
+        return { ok: false, error: 'Le fichier doit etre un .jar' };
+    }
+    // Sanitize filename
+    const safeName = fileName.replace(/[^a-zA-Z0-9._-]/g, '');
+    if (!safeName || safeName.length < 5) {
+        return { ok: false, error: 'Nom de fichier invalide' };
+    }
+    // Detect dialect
+    const detected = detectDialectFromJar(safeName);
+    // Ensure jar_files directory exists
+    const dir = getJarDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Remove existing JAR for the same dialect (if any)
+    let replaced;
+    if (detected) {
+        try {
+            const existing = readdirSync(dir)
+                .filter(f => f.startsWith(detected.info.jarPrefix) && f.endsWith('.jar'));
+            for (const old of existing) {
+                if (old !== safeName) {
+                    unlinkSync(join(dir, old));
+                    replaced = old;
+                }
+            }
+        }
+        catch {
+            // Non-critical
+        }
+    }
+    // Write file
+    writeFileSync(join(dir, safeName), data);
+    return {
+        ok: true,
+        fileName: safeName,
+        dialect: detected?.dialect ?? undefined,
+        jarDir: dir,
+        replaced,
+    };
+}
+/**
+ * Delete a JAR file from the jar_files directory.
+ */
+export function deleteJarFile(fileName) {
+    const safeName = fileName.replace(/[^a-zA-Z0-9._-]/g, '');
+    const dir = getJarDir();
+    const filePath = join(dir, safeName);
+    if (!existsSync(filePath)) {
+        return { ok: false, error: `Fichier ${safeName} introuvable` };
+    }
+    unlinkSync(filePath);
+    return { ok: true, fileName: safeName };
+}
+/**
+ * Get the list of JDBC-eligible dialects with their JAR status.
+ */
+export function getJdbcDialectStatus() {
+    const dir = getJarDir();
+    const files = existsSync(dir) ? readdirSync(dir).filter(f => f.endsWith('.jar')) : [];
+    return Object.entries(JDBC_REGISTRY).map(([dialect, info]) => {
+        if (!info)
+            return null;
+        const match = files.find(f => f.startsWith(info.jarPrefix));
+        return {
+            dialect: dialect,
+            label: info.label,
+            jarPrefix: info.jarPrefix,
+            hasJar: !!match,
+            jarFile: match ?? null,
+        };
+    }).filter(Boolean);
+}

package/dist/index.d.ts

@@ -8,7 +8,9 @@ export { normalizeDoc, normalizeDocs } from './core/normalizer.js';
 export { JdbcNormalizer, parseUri } from './bridge/JdbcNormalizer.js';
 export { JDBC_REGISTRY, hasJdbcDriver, getJdbcDriverInfo } from './bridge/jdbc-registry.js';
 export { BridgeManager } from './bridge/BridgeManager.js';
+export { saveJarFile, deleteJarFile, listJarFiles, detectDialectFromJar, getJdbcDialectStatus, } from './bridge/jar-upload.js';
 export type { BridgeInstance } from './bridge/BridgeManager.js';
+export type { JarUploadResult } from './bridge/jar-upload.js';
 export type { JdbcDriverInfo } from './bridge/jdbc-registry.js';
 export type { JdbcBridgeConfig } from './bridge/JdbcNormalizer.js';
 export { MostaORMError, EntityNotFoundError, ConnectionError, ValidationError, DialectNotFoundError, } from './core/errors.js';

package/dist/index.js

@@ -26,6 +26,7 @@ export { normalizeDoc, normalizeDocs } from './core/normalizer.js';
 export { JdbcNormalizer, parseUri } from './bridge/JdbcNormalizer.js';
 export { JDBC_REGISTRY, hasJdbcDriver, getJdbcDriverInfo } from './bridge/jdbc-registry.js';
 export { BridgeManager } from './bridge/BridgeManager.js';
+export { saveJarFile, deleteJarFile, listJarFiles, detectDialectFromJar, getJdbcDialectStatus, } from './bridge/jar-upload.js';
 // ============================================================
 // Errors
 // ============================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/orm",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "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",