@mostajs/dialect-registry 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import type { ConnectionConfig, EntitySchema, IDialect } from '@mostajs/orm';
+/**
+ * Open an isolated dialect — NOT stored as singleton.
+ * Each call returns a new, independent connection to the database.
+ * Schemas are initialized on this instance only, not in the global registry.
+ *
+ * Use this when you need multiple simultaneous database connections
+ * (e.g., multi-project / multi-tenant scenarios, default + meta DB split).
+ *
+ * Example:
+ *   const metaDialect = await openIsolatedDialect({
+ *     dialect: 'postgres',
+ *     uri: 'postgresql://user:pass@localhost:5432/octonet_meta',
+ *   })
+ *   registerNamedConnection('meta', metaDialect)
+ */
+export declare function openIsolatedDialect(config: ConnectionConfig, schemas?: EntitySchema[]): Promise<IDialect>;
+/**
+ * Register a named connection for later retrieval.
+ * @param name    - Unique name (e.g., 'default', 'meta', 'tenant-42')
+ * @param dialect - Connected dialect instance
+ */
+export declare function registerNamedConnection(name: string, dialect: IDialect): void;
+/**
+ * Retrieve a previously registered named connection.
+ * Returns null if not found. Does NOT create a new connection.
+ */
+export declare function getNamedConnection(name: string): IDialect | null;
+/** List all registered connection names. */
+export declare function listNamedConnections(): string[];
+/**
+ * Remove a named connection from the registry.
+ * Does NOT disconnect — call dialect.disconnect() separately if needed.
+ */
+export declare function removeNamedConnection(name: string): void;
+/** Remove all named connections (for testing or shutdown). */
+export declare function clearNamedConnections(): void;
+export type { ConnectionConfig, EntitySchema, IDialect } from '@mostajs/orm';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAc7E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAUD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,CAE7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEhE;AAED,4CAA4C;AAC5C,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAGD,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,87 @@
+// @mostajs/dialect-registry — Multi-dialect connection registry
+//
+// Orchestre N dialects @mostajs/orm en parallèle dans un même process.
+// Concerne complémentaire de @mostajs/orm (qui possède l'ORM lui-même :
+// schemas, queries, dialects par SGBD). Ce module gère la *coordination* :
+//
+//   - openIsolatedDialect(config)        → ouvre une connexion neuve (non-singleton)
+//   - registerNamedConnection(name, d)   → la stocke sous un nom logique
+//   - getNamedConnection(name)           → la retrouve par nom
+//   - listNamedConnections()             → liste tous les noms
+//   - removeNamedConnection(name)        → la sort du registry (sans déconnecter)
+//   - clearNamedConnections()            → reset complet
+//
+// Cas d'usage typiques :
+//   - Octonet : `default` (project DB) + `meta` (RBAC/ApiKey shared avec Octocloud)
+//   - Multi-tenant : 1 dialect par tenant, registry-keyed par tenant-id
+//   - Tests : isolation per-test
+//
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+import { createIsolatedDialect as _ormCreateIsolatedDialect, registerNamedConnection as _ormRegisterNamedConnection, getNamedConnection as _ormGetNamedConnection, listNamedConnections as _ormListNamedConnections, removeNamedConnection as _ormRemoveNamedConnection, clearNamedConnections as _ormClearNamedConnections, } from '@mostajs/orm';
+// ─────────────────────────────────────────────────────────────────────────
+//  openIsolatedDialect — renamed from createIsolatedDialect
+// ─────────────────────────────────────────────────────────────────────────
+//
+// "open" matches the connection lifecycle (cf. JDBC openConnection,
+// Hibernate openSession, POSIX open()) — pendant naturel à `getDialect()`
+// qui partage le singleton. Le verbe `create` insistait sur la fabrication ;
+// `open` insiste sur l'usage.
+//
+// L'implémentation reste dans @mostajs/orm (où vit `loadDialectModule`).
+// Ce ré-export aliase juste le nom dans l'API publique du registry.
+/**
+ * Open an isolated dialect — NOT stored as singleton.
+ * Each call returns a new, independent connection to the database.
+ * Schemas are initialized on this instance only, not in the global registry.
+ *
+ * Use this when you need multiple simultaneous database connections
+ * (e.g., multi-project / multi-tenant scenarios, default + meta DB split).
+ *
+ * Example:
+ *   const metaDialect = await openIsolatedDialect({
+ *     dialect: 'postgres',
+ *     uri: 'postgresql://user:pass@localhost:5432/octonet_meta',
+ *   })
+ *   registerNamedConnection('meta', metaDialect)
+ */
+export async function openIsolatedDialect(config, schemas) {
+    return _ormCreateIsolatedDialect(config, schemas);
+}
+// ─────────────────────────────────────────────────────────────────────────
+//  Named-connection registry — re-exports from @mostajs/orm
+// ─────────────────────────────────────────────────────────────────────────
+//
+// Le store sous-jacent est un Map module-level dans @mostajs/orm. Tant que
+// les deux packages sont chargés via le même process Node.js, ils voient
+// la même instance (Node.js module cache).
+/**
+ * Register a named connection for later retrieval.
+ * @param name    - Unique name (e.g., 'default', 'meta', 'tenant-42')
+ * @param dialect - Connected dialect instance
+ */
+export function registerNamedConnection(name, dialect) {
+    _ormRegisterNamedConnection(name, dialect);
+}
+/**
+ * Retrieve a previously registered named connection.
+ * Returns null if not found. Does NOT create a new connection.
+ */
+export function getNamedConnection(name) {
+    return _ormGetNamedConnection(name);
+}
+/** List all registered connection names. */
+export function listNamedConnections() {
+    return _ormListNamedConnections();
+}
+/**
+ * Remove a named connection from the registry.
+ * Does NOT disconnect — call dialect.disconnect() separately if needed.
+ */
+export function removeNamedConnection(name) {
+    _ormRemoveNamedConnection(name);
+}
+/** Remove all named connections (for testing or shutdown). */
+export function clearNamedConnections() {
+    _ormClearNamedConnections();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,2EAA2E;AAC3E,EAAE;AACF,qFAAqF;AACrF,yEAAyE;AACzE,+DAA+D;AAC/D,+DAA+D;AAC/D,kFAAkF;AAClF,yDAAyD;AACzD,EAAE;AACF,yBAAyB;AACzB,oFAAoF;AACpF,wEAAwE;AACxE,iCAAiC;AACjC,EAAE;AACF,0CAA0C;AAE1C,OAAO,EACL,qBAAqB,IAAI,yBAAyB,EAClD,uBAAuB,IAAI,2BAA2B,EACtD,kBAAkB,IAAI,sBAAsB,EAC5C,oBAAoB,IAAI,wBAAwB,EAChD,qBAAqB,IAAI,yBAAyB,EAClD,qBAAqB,IAAI,yBAAyB,GACnD,MAAM,cAAc,CAAC;AAGtB,4EAA4E;AAC5E,4DAA4D;AAC5D,4EAA4E;AAC5E,EAAE;AACF,oEAAoE;AACpE,0EAA0E;AAC1E,6EAA6E;AAC7E,8BAA8B;AAC9B,EAAE;AACF,yEAAyE;AACzE,oEAAoE;AAEpE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,OAAwB;IAExB,OAAO,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,4EAA4E;AAC5E,4DAA4D;AAC5D,4EAA4E;AAC5E,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,2CAA2C;AAE3C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,OAAiB;IACrE,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,oBAAoB;IAClC,OAAO,wBAAwB,EAAE,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,yBAAyB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB;IACnC,yBAAyB,EAAE,CAAC;AAC9B,CAAC"}

package/llms.txt

@@ -0,0 +1,68 @@
+# @mostajs/dialect-registry — fiche LLM
+> Registre de connexions multi-dialecte — orchestre N dialectes parallèles par process (default, meta, per-tenant…).
+
+- Version: 0.1.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Chemin: mostajs/mosta-dialect-registry · Statut audit: complet (dist/)
+
+## RÔLE
+Concern frère de @mostajs/orm : @mostajs/orm possède les implémentations de dialectes,
+ce module gère leur orchestration. Permet d'ouvrir plusieurs connexions de bases de données
+indépendantes dans le même process et de les retrouver par un nom logique (`default`, `meta`,
+`tenant-42`…). Cas d'usage : multi-tenant, séparation base métier / base meta, multi-projet.
+
+## INSTALLATION
+npm i @mostajs/dialect-registry
+(peerDep : @mostajs/orm >=1.13.0)
+
+## EXPORTS
+- openIsolatedDialect — ouvre une connexion isolée (hors singleton)
+- registerNamedConnection, getNamedConnection, listNamedConnections,
+  removeNamedConnection, clearNamedConnections
+- Types ré-exportés de @mostajs/orm : ConnectionConfig, EntitySchema, IDialect
+
+## API — SIGNATURES
+- openIsolatedDialect(config: ConnectionConfig, schemas?: EntitySchema[]): Promise<IDialect>
+  → chaque appel = connexion neuve et indépendante ; schémas initialisés sur cette
+    instance uniquement, pas dans le registre global de @mostajs/orm.
+- registerNamedConnection(name: string, dialect: IDialect): void
+- getNamedConnection(name: string): IDialect | null  (null si absent, NE crée rien)
+- listNamedConnections(): string[]
+- removeNamedConnection(name: string): void  (ne déconnecte PAS)
+- clearNamedConnections(): void  (vide le registre — tests / shutdown)
+
+## TYPES CLÉS
+- ConnectionConfig, EntitySchema, IDialect : ré-exports directs de @mostajs/orm
+  (voir la fiche llms.txt de @mostajs/orm pour leur forme détaillée).
+
+## PATTERN
+```ts
+import {
+  openIsolatedDialect, registerNamedConnection, getNamedConnection,
+} from '@mostajs/dialect-registry';
+
+const metaDialect = await openIsolatedDialect({
+  dialect: 'postgres',
+  uri: 'postgresql://user:pass@localhost:5432/octonet_meta',
+});
+registerNamedConnection('meta', metaDialect);
+
+// plus loin, ailleurs dans le process :
+const meta = getNamedConnection('meta');  // IDialect | null
+```
+
+## DÉPEND DE
+- @mostajs/orm (peerDep — fournit IDialect, ConnectionConfig, EntitySchema et la connexion réelle)
+
+## PIÈGES
+- `openIsolatedDialect` ne stocke RIEN comme singleton et n'enregistre pas le dialecte sous
+  un nom — il faut appeler `registerNamedConnection` explicitement pour le retrouver ensuite.
+- `getNamedConnection` retourne `null` si le nom est inconnu ; il NE crée pas de connexion.
+- `removeNamedConnection` / `clearNamedConnections` ne ferment PAS la connexion physique —
+  appeler `dialect.disconnect()` séparément pour libérer les ressources.
+- Les schémas passés à `openIsolatedDialect` sont locaux à cette instance ; ils n'apparaissent
+  pas dans `getAllSchemas()` du registre global de @mostajs/orm.
+- API très proche des helpers `createIsolatedDialect` / `*NamedConnection` de @mostajs/orm
+  lui-même — ce module les expose comme concern dédié et stable.
+
+## RÉFÉRENCES
+- (pas de README.md ni CHANGELOG.md présents dans le module au moment de l'audit)

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@mostajs/dialect-registry",
+  "version": "0.1.0",
+  "description": "Multi-dialect connection registry — orchestrate N parallel dialects per process (default, meta, per-tenant…). Sibling concern of @mostajs/orm (which owns the dialect implementations).",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "llms.txt"
+  ],
+  "keywords": [
+    "mostajs",
+    "orm",
+    "dialect",
+    "connection",
+    "registry",
+    "multi-tenant",
+    "named-connection"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@mostajs/orm": ">=1.13.0"
+  },
+  "devDependencies": {
+    "@mostajs/orm": "^1.13.0",
+    "@types/node": "^25.5.2",
+    "typescript": "^5.6.0"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}