@mostajs/octoswitcher 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Minimal dialect interface — same contract as IDialect in @mostajs/orm.
+ * Both ORM dialects and NET proxies implement this.
+ */
+export interface IDataDialect {
+    readonly dialectType: string;
+    find<T = Record<string, unknown>>(schema: any, filter: any, options?: any): Promise<T[]>;
+    findOne<T = Record<string, unknown>>(schema: any, filter: any, options?: any): Promise<T | null>;
+    findById<T = Record<string, unknown>>(schema: any, id: string, options?: any): Promise<T | null>;
+    create<T = Record<string, unknown>>(schema: any, data: Record<string, unknown>): Promise<T>;
+    update<T = Record<string, unknown>>(schema: any, id: string, data: Record<string, unknown>): Promise<T | null>;
+    updateMany(schema: any, filter: any, data: Record<string, unknown>): Promise<number>;
+    delete(schema: any, id: string): Promise<boolean>;
+    deleteMany(schema: any, filter: any): Promise<number>;
+    count(schema: any, filter: any): Promise<number>;
+    distinct(schema: any, field: string, filter: any): Promise<unknown[]>;
+    aggregate<T = Record<string, unknown>>(schema: any, stages: any[]): Promise<T[]>;
+    findWithRelations<T = Record<string, unknown>>(schema: any, filter: any, relations: string[], options?: any): Promise<T[]>;
+    findByIdWithRelations<T = Record<string, unknown>>(schema: any, id: string, relations: string[], options?: any): Promise<T | null>;
+    upsert<T = Record<string, unknown>>(schema: any, filter: any, data: Record<string, unknown>): Promise<T>;
+    increment(schema: any, id: string, field: string, amount: number): Promise<Record<string, unknown>>;
+    addToSet(schema: any, id: string, field: string, value: unknown): Promise<Record<string, unknown> | null>;
+    pull(schema: any, id: string, field: string, value: unknown): Promise<Record<string, unknown> | null>;
+    search<T = Record<string, unknown>>(schema: any, query: string, fields: string[], options?: any): Promise<T[]>;
+}
+export type DataMode = 'orm' | 'net';
+/**
+ * Detect data mode from environment.
+ * MOSTA_DATA=net → remote transport (REST, GraphQL, gRPC, WS, MCP, etc.)
+ * MOSTA_DATA=orm (or unset) → direct database access via ORM dialect
+ */
+export declare function getDataMode(): DataMode;
+export declare function isNetMode(): boolean;
+export declare function isOrmMode(): boolean;
+/**
+ * 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.
+ * All @mostajs modules (auth, rbac, audit, settings) call this function.
+ */
+export declare function getDialect(): Promise<IDataDialect>;
+/**
+ * Inject an external dialect (for testing or custom implementations).
+ * After this call, getDialect() returns the injected dialect.
+ */
+export declare function setDialect(dialect: IDataDialect): void;
+/**
+ * Reset the singleton (for testing).
+ */
+export declare function resetDialect(): void;

package/dist/index.js

@@ -0,0 +1,89 @@
+// OctoSwitcher — Data access switcher for @mostajs ecosystem
+// Switches between ORM (direct DB) and NET (remote transport) based on MOSTA_DATA env var
+// All modules import getDialect() from here — never from @mostajs/orm or @mostajs/net directly
+// Author: Dr Hamid MADANI drmdh@msn.com
+/**
+ * Detect data mode from environment.
+ * MOSTA_DATA=net → remote transport (REST, GraphQL, gRPC, WS, MCP, etc.)
+ * MOSTA_DATA=orm (or unset) → direct database access via ORM dialect
+ */
+export function getDataMode() {
+    return process.env.MOSTA_DATA === 'net' ? 'net' : 'orm';
+}
+export function isNetMode() {
+    return getDataMode() === 'net';
+}
+export function isOrmMode() {
+    return getDataMode() === 'orm';
+}
+// ============================================================
+// Singleton dialect
+// ============================================================
+let _dialect = null;
+/**
+ * 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.
+ * All @mostajs modules (auth, rbac, audit, settings) call this function.
+ */
+export async function getDialect() {
+    if (_dialect)
+        return _dialect;
+    if (isNetMode()) {
+        _dialect = await initNetDialect();
+    }
+    else {
+        _dialect = await initOrmDialect();
+    }
+    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;
+}
+/**
+ * Reset the singleton (for testing).
+ */
+export function resetDialect() {
+    _dialect = null;
+}
+// ============================================================
+// ORM mode — direct database access
+// ============================================================
+async function initOrmDialect() {
+    try {
+        const orm = await import(/* webpackIgnore: true */ '@mostajs/orm');
+        return await orm.getDialect();
+    }
+    catch (err) {
+        throw new Error(`[OctoSwitcher] ORM mode requires @mostajs/orm. Install it: npm install @mostajs/orm\n` +
+            `Original error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// ============================================================
+// NET mode — remote transport via @mostajs/net client
+// ============================================================
+async function initNetDialect() {
+    const url = process.env.MOSTA_NET_URL;
+    if (!url) {
+        throw new Error('[OctoSwitcher] NET mode requires MOSTA_NET_URL env var.\n' +
+            'Example: MOSTA_NET_URL=https://mcp.amia.fr/astro_08/');
+    }
+    try {
+        const net = await import(/* webpackIgnore: true */ '@mostajs/net/client');
+        const apiKey = process.env.MOSTA_NET_API_KEY;
+        const client = new net.NetClient({ url, apiKey });
+        const proxy = net.createNetDialectProxy(client);
+        return proxy;
+    }
+    catch (err) {
+        throw new Error(`[OctoSwitcher] NET mode requires @mostajs/net. Install it: npm install @mostajs/net\n` +
+            `Original error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@mostajs/octoswitcher",
+  "version": "1.0.0",
+  "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",
+  "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"
+  ],
+  "keywords": [
+    "mostajs",
+    "orm",
+    "net",
+    "switcher",
+    "dialect",
+    "transport",
+    "rest",
+    "graphql",
+    "grpc",
+    "websocket",
+    "mcp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/apolocine/octoswitcher"
+  },
+  "homepage": "https://mostajs.dev",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@mostajs/net": ">=2.0.0",
+    "@mostajs/orm": ">=1.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@mostajs/orm": {
+      "optional": true
+    },
+    "@mostajs/net": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mostajs/net": "^2.0.73",
+    "@mostajs/orm": "^1.8.0",
+    "@types/node": "^25.5.2",
+    "typescript": "^5.6.0"
+  }
+}