dolphin-server-modules 2.10.0 → 2.11.1

package/package.json

@@ -1,144 +1,65 @@
-{
-  "name": "dolphin-server-modules",
-  "version": "2.10.0",
-  "type": "module",
-  "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
-  "description": "Core utility modules for Auth, CRUD, and Controllers",
-  "main": "dist/index.js",
-  "bin": {
-    "dolphin": "dist/bin/cli.js",
-    "dolphin-server": "dist/bin/cli.js"
-  },
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "TUTORIAL_NEPALI.md",
-    "DOLPHIN_MASTER_GUIDE_NEPALI.md",
-    "scripts/client.js",
-    "scripts/dolphin-persist.js"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./auth": {
-      "types": "./dist/auth/auth.d.ts",
-      "default": "./dist/auth/auth.js"
-    },
-    "./auth-controller": {
-      "types": "./dist/authController/authController.d.ts",
-      "default": "./dist/authController/authController.js"
-    },
-    "./controller": {
-      "types": "./dist/controller/controller.d.ts",
-      "default": "./dist/controller/controller.js"
-    },
-    "./crud": {
-      "types": "./dist/curd/crud.d.ts",
-      "default": "./dist/curd/crud.js"
-    },
-    "./curd": {
-      "types": "./dist/curd/crud.d.ts",
-      "default": "./dist/curd/crud.js"
-    },
-    "./middleware/zod": {
-      "types": "./dist/middleware/zod.d.ts",
-      "default": "./dist/middleware/zod.js"
-    },
-    "./adapters/mongoose": {
-      "types": "./dist/adapters/mongoose/index.d.ts",
-      "default": "./dist/adapters/mongoose/index.js"
-    },
-    "./server": {
-      "types": "./dist/server/server.d.ts",
-      "default": "./dist/server/server.js"
-    },
-    "./router": {
-      "types": "./dist/router/router.d.ts",
-      "default": "./dist/router/router.js"
-    },
-    "./realtime": {
-      "types": "./dist/realtime/index.d.ts",
-      "default": "./dist/realtime/index.js"
-    },
-    "./realtime/core": {
-      "types": "./dist/realtime/core.d.ts",
-      "default": "./dist/realtime/core.js"
-    },
-    "./realtime/trie": {
-      "types": "./dist/realtime/trie.d.ts",
-      "default": "./dist/realtime/trie.js"
-    },
-    "./realtime/codec": {
-      "types": "./dist/realtime/codec.d.ts",
-      "default": "./dist/realtime/codec.js"
-    },
-    "./realtime/plugins": {
-      "types": "./dist/realtime/plugins.d.ts",
-      "default": "./dist/realtime/plugins.js"
-    },
-    "./swagger": {
-      "types": "./dist/swagger/swagger.d.ts",
-      "default": "./dist/swagger/swagger.js"
-    },
-    "./djson": {
-      "types": "./dist/djson/djson.d.ts",
-      "default": "./dist/djson/djson.js"
-    },
-    "./signaling": {
-      "types": "./dist/signaling/index.d.ts",
-      "default": "./dist/signaling/index.js"
-    },
-    "./cli": "./dist/bin/cli.js",
-    "./client": "./scripts/client.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/demo-server.js",
-    "dolphin": "node dist/bin/cli.js",
-    "dev": "npm run build && npm run start",
-    "test": "jest",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "dolphin",
-    "server",
-    "auth",
-    "crud",
-    "controller",
-    "realtime",
-    "iot",
-    "2fa",
-    "jwt"
-  ],
-  "author": "Shankar Phuyal",
-  "license": "ISC",
-  "dependencies": {
-    "argon2": "^0.40.1",
-    "ioredis": "^5.10.1",
-    "jsonwebtoken": "^9.0.3",
-    "mongodb-memory-server": "^11.0.1",
-    "ws": "^8.20.0",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.5.12",
-    "@types/jsonwebtoken": "^9.0.10",
-    "@types/node": "^20.11.30",
-    "@types/ws": "^8.18.1",
-    "jest": "^29.7.0",
-    "mongoose": "^9.3.2",
-    "ts-jest": "^29.1.2",
-    "typescript": "^5.4.3"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Phuyalshankar/dolphin-server-modules.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Phuyalshankar/dolphin-server-modules/issues"
-  }
-}
+{
+  "name": "dolphin-server-modules",
+  "version": "2.11.1",
+  "type": "module",
+  "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
+  "description": "Core utility modules for Auth, CRUD, and Controllers",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./server": "./dist/server/server.js",
+    "./router": "./dist/router/router.js",
+    "./adapters/mongoose": "./dist/adapters/mongoose/index.js",
+    "./auth-controller": "./dist/authController/authController.js",
+    "./crud": "./dist/curd/crud.js"
+  },
+  "bin": {
+    "dolphin": "dist/bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "DOLPHIN_MASTER_GUIDE_NEPALI.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "test": "jest"
+  },
+  "keywords": [
+    "dolphin",
+    "framework",
+    "server",
+    "auth",
+    "crud"
+  ],
+  "author": "Phuyal Shankar",
+  "license": "MIT",
+  "dependencies": {
+    "@google/generative-ai": "^0.11.0",
+    "chalk": "^5.3.0",
+    "dotenv": "^16.4.5",
+    "express": "^4.19.2",
+    "mongoose": "^8.3.4",
+    "node-fetch": "^3.3.2",
+    "ora": "^8.0.1",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/ioredis": "^4.28.10",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.12.11",
+    "@types/supertest": "^7.2.0",
+    "@types/ws": "^8.18.1",
+    "ioredis": "^5.10.1",
+    "jest": "^29.7.0",
+    "mongodb-memory-server": "^11.0.1",
+    "supertest": "^7.2.2",
+    "ts-jest": "^29.4.9",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.5"
+  }
+}

package/scripts/benchmark.js

@@ -0,0 +1,12 @@
+const { createDolphinServer } = require('../dist/server/server');
+
+const app = createDolphinServer();
+
+app.get('/health', (ctx) => {
+  ctx.json({ status: 'ok' });
+});
+
+const PORT = 5008;
+app.listen(PORT, () => {
+  console.log(`Benchmark server running on port ${PORT}`);
+});

package/scripts/benchmark.ts

@@ -0,0 +1,12 @@
+import { createDolphinServer } from '../src/server/server';
+
+const app = createDolphinServer();
+
+app.get('/health', (ctx: any) => {
+  ctx.json({ status: 'ok' });
+});
+
+const PORT = 5002;
+app.listen(PORT, () => {
+  console.log(`Benchmark server running on port ${PORT}`);
+});

package/scripts/list-models.js

@@ -0,0 +1,34 @@
+/**
+ * 🔍 Dolphin AI Diagnostic Tool
+ * यो स्क्रिप्टले तपाइँको API Key ले कुन-कुन मोडेलहरू एक्सेस गर्न सक्छ भनेर देखाउँछ।
+ */
+
+const https = require('https');
+
+const API_KEY = process.env.GEMINI_API_KEY || "AIzaSyA3EFr62PEEXaIRpVfW_Qd2tYMu0jftj7Y";
+const VERSION = "v1beta"; // सूची हेर्न प्राय: v1beta उत्तम हुन्छ
+
+console.log(`📡 Fetching available models for your API Key...`);
+
+const options = {
+    hostname: 'generativelanguage.googleapis.com',
+    path: `/${VERSION}/models?key=${API_KEY}`,
+    method: 'GET'
+};
+
+const req = https.request(options, (res) => {
+    let body = '';
+    res.on('data', (d) => body += d);
+    res.on('end', () => {
+        const json = JSON.parse(body);
+        if (json.models) {
+            console.log('✅ Available Models:');
+            json.models.forEach(m => console.log(` - ${m.name.replace('models/', '')} (${m.supportedGenerationMethods.join(', ')})`));
+        } else {
+            console.error('❌ Error fetching models:', json);
+        }
+    });
+});
+
+req.on('error', (e) => console.error('❌ Network Error:', e));
+req.end();

package/scripts/run-real-ai-test.js

@@ -0,0 +1,79 @@
+/**
+ * 🚀 Dolphin Real AI Integration Test
+ * यो स्क्रिप्टले तपाइँको वास्तविक API Key प्रयोग गरेर 
+ * Google Gemini बाट कोड मगाउँछ र 'ai-demo-result.js' मा लेख्छ।
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const API_KEY = process.env.GEMINI_API_KEY || "AIzaSyA3EFr62PEEXaIRpVfW_Qd2tYMu0jftj7Y";
+const MODELS = ["gemini-flash-latest", "gemini-2.0-flash", "gemini-2.5-flash", "gemini-pro-latest"];
+const VERSIONS = ["v1", "v1beta"];
+
+const payload = JSON.stringify({
+    contents: [{ parts: [{ text: `Create a professional Dolphin Server app.
+    Context: Simple health check and system info.
+    Requirements:
+    1. Use ESM 'import' from 'dolphin-server-modules/server'.
+    2. Use 'createDolphinServer'.
+    3. Routes: GET '/health' (uptime) and GET '/info' (framework name).
+    4. Use unified context '(ctx) => ({ ... })'.
+    5. Include app.listen(3000).
+    Return ONLY the pure JavaScript code, no markdown, no explanations.` 
+    }] }]
+});
+
+const tryAI = (mIndex, vIndex) => {
+    if (mIndex >= MODELS.length) {
+        console.error('❌ All models failed. Ensure your API Key from https://aistudio.google.com/ is correct and has access to these models.');
+        return;
+    }
+
+    if (vIndex >= VERSIONS.length) {
+        return tryAI(mIndex + 1, 0);
+    }
+
+    const MODEL = MODELS[mIndex];
+    const VERSION = VERSIONS[vIndex];
+    console.log(`📡 Sending request to Gemini (${MODEL} via ${VERSION})...`);
+
+    const options = {
+        hostname: 'generativelanguage.googleapis.com',
+        path: `/${VERSION}/models/${MODEL}:generateContent?key=${API_KEY}`,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' }
+    };
+
+    const req = https.request(options, (res) => {
+        let body = '';
+        res.on('data', (d) => body += d);
+        res.on('end', () => {
+            try {
+                const json = JSON.parse(body);
+                if (json.error) {
+                    console.warn(`⚠️ ${MODEL} (${VERSION}) failed: ${json.error.status}`);
+                    return tryAI(mIndex, vIndex + 1);
+                }
+                const rawCode = json.candidates?.[0]?.content?.parts?.[0]?.text || '';
+                if (rawCode) {
+                    const codeMatch = rawCode.match(/(import|const|let|var|app|function)[\s\S]*/);
+                    const code = (codeMatch ? codeMatch[0] : rawCode).replace(/```javascript|```js|```/g, '').trim();
+                    fs.writeFileSync(path.join(process.cwd(), 'ai-demo-result.js'), code);
+                    console.log(`✅ Success! Code generated using ${MODEL} (${VERSION})`);
+                } else {
+                    tryAI(mIndex, vIndex + 1);
+                }
+            } catch (e) {
+                tryAI(mIndex, vIndex + 1);
+            }
+        });
+    });
+
+    req.on('error', (e) => tryAI(mIndex, vIndex + 1));
+    req.write(payload);
+    req.end();
+};
+
+tryAI(0, 0);

package/scripts/test-ai-logic.js

@@ -0,0 +1,44 @@
+/**
+ * 🤖 Dolphin AI Logic Test
+ * यो स्क्रिप्टले AI बाट आएको कच्चा (raw) रेस्पोन्सलाई 
+ * हाम्रो CLI ले कसरी सफा कोडमा बदल्छ भनेर जाँच्छ।
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Mock AI Response with Markdown backticks
+const mockAiResponse = "```javascript\nconst { createDolphinServer } = require('dolphin-server-modules/server');\nconst app = createDolphinServer();\napp.get('/', (ctx) => ({ message: 'AI Works!' }));\napp.listen(3000);\n```";
+
+function simulateParsing(rawText) {
+    // CLI.ts मा भएको रिप्लेस लजिक
+    return rawText.replace(/```javascript|```/g, '').trim();
+}
+
+function runTest() {
+    console.log('🧪 Running AI Logic Test...');
+
+    const cleanedCode = simulateParsing(mockAiResponse);
+
+    console.log('\n--- Cleaned Code Output ---');
+    console.log(cleanedCode);
+    console.log('---------------------------\n');
+
+    if (cleanedCode.includes('```') || cleanedCode.includes('javascript')) {
+        console.error('❌ FAIL: Markdown backticks are still present!');
+        process.exit(1);
+    }
+
+    if (!cleanedCode.includes('createDolphinServer')) {
+        console.error('❌ FAIL: Core code logic missing!');
+        process.exit(1);
+    }
+
+    console.log('✅ PASS: AI Response parsing logic is correct.');
+    
+    // Test file creation
+    fs.writeFileSync(path.join(process.cwd(), 'ai-test-output.js'), cleanedCode);
+    console.log('✅ PASS: Simulated file written to ai-test-output.js');
+}
+
+runTest();

package/scripts/test-client.js

@@ -0,0 +1,105 @@
+/**
+ * Dolphin Client Logic Test
+ * This script verifies the core logic of client.js without needing a real server.
+ */
+
+const { DolphinClient } = require('./client');
+
+// --- Mocks ---
+global.fetch = async (url, options) => {
+    console.log(`[Mock Fetch] ${options.method || 'GET'} ${url}`);
+    return {
+        ok: true,
+        headers: new Map([['content-type', 'application/json']]),
+        json: async () => ({ success: true, message: 'Mock response', data: { url, method: options.method } })
+    };
+};
+
+class MockWebSocket {
+    constructor(url) {
+        console.log(`[Mock WS] Connecting to ${url}`);
+        this.readyState = 1; // OPEN
+        setTimeout(() => this.onopen && this.onopen(), 10);
+    }
+    send(data) { console.log(`[Mock WS] Sending: ${data}`); }
+    close() { console.log(`[Mock WS] Closing`); }
+}
+global.WebSocket = MockWebSocket;
+
+// Storage Mock
+global.localStorage = {
+    getItem: () => null,
+    setItem: () => {},
+    removeItem: () => {}
+};
+
+async function runTests() {
+    console.log('--- Starting DolphinClient Tests ---');
+
+    // 1. Constructor & Protocol Test
+    console.log('\n[Test 1] Protocol Detection');
+    const c1 = new DolphinClient('https://api.example.com');
+    if (c1.httpUrl !== 'https://api.example.com') throw new Error(`Https protocol failed: ${c1.httpUrl}`);
+    
+    const c2 = new DolphinClient('localhost:3000');
+    // Default should be http if not specified and not in browser
+    if (!c2.httpUrl.startsWith('http://')) throw new Error(`Default protocol failed: ${c2.httpUrl}`);
+    console.log('✅ Protocol detection passed');
+
+    // 2. API Proxy & Method Test
+    console.log('\n[Test 2] API Handler (Proxy & Methods)');
+    const dolphin = new DolphinClient('localhost:3000');
+    
+    // Test direct get
+    await dolphin.api.get('/products');
+    
+    // Test proxy path
+    // Under the hood, this calls this._createProxy(['users']).get()
+    await dolphin.api.users.get();
+    
+    // Test post with body
+    await dolphin.api.post('/auth/login', { email: 'test@test.com' });
+    
+    console.log('✅ API Proxy passed');
+
+    // 4. Clashing Property Test
+    console.log('\n[Test 4] Clashing Property Names (Function built-ins)');
+    try {
+        const callProp = dolphin.api.call;
+        const callType = typeof callProp;
+        console.log(`- Type of dolphin.api.call: ${callType}`);
+        
+        // Since our proxy target is a function, typeof will be 'function'.
+        // To verify it's OUR proxy and not the built-in call, check for our methods.
+        const isOurProxy = typeof callProp.post === 'function';
+        console.log(`- Has .post() method: ${isOurProxy}`);
+        
+        if (!isOurProxy) {
+            throw new Error(`Clashing property 'call' was not shadowed by our proxy.`);
+        }
+        console.log('✅ Clashing properties shadowed successfully');
+    } catch (e) {
+        console.log(`❌ Clashing property failed: ${e.message}`);
+        throw e;
+    }
+
+    // 3. Subscription & Memory Cleanup Test
+    console.log('\n[Test 3] Subscriptions & Event Cleanup');
+    let callCount = 0;
+    const cb = () => callCount++;
+    
+    dolphin.subscribe('test', cb);
+    if (!dolphin.handlers.has('test')) throw new Error('Subscribe failed');
+    
+    dolphin.unsubscribe('test', cb);
+    if (dolphin.handlers.has('test')) throw new Error('Unsubscribe failed');
+    
+    console.log('✅ Event management passed');
+
+    console.log('\n--- All Logic Tests Passed! 🐬 ---');
+}
+
+runTests().catch(err => {
+    console.error('❌ Test Failed:', err);
+    process.exit(1);
+});

package/scripts/test-dolphin.js

@@ -0,0 +1,36 @@
+const { createDolphinServer } = require('../dist/server/server');
+const http = require('node:http');
+
+const app = createDolphinServer();
+
+// Mock Express Middleware
+app.use((req, res, next) => {
+  req.isExpress = true;
+  next();
+});
+
+app.get('/test', (ctx) => {
+  ctx.json({ 
+    success: true, 
+    isExpress: ctx.req.isExpress 
+  });
+});
+
+const PORT = 5005;
+app.listen(PORT, () => {
+  console.log(`Test server running on port ${PORT}`);
+  
+  // Make a request immediately
+  http.get(`http://127.0.0.1:${PORT}/test`, (res) => {
+    let data = '';
+    res.on('data', chunk => data += chunk);
+    res.on('end', () => {
+      console.log('STATUS:', res.statusCode);
+      console.log('BODY:', data);
+      process.exit(0);
+    });
+  }).on('error', (err) => {
+    console.error('Request Error:', err.message);
+    process.exit(1);
+  });
+});