dolphin-server-modules 1.1.0 → 1.2.0

package/DOLPHIN_MASTER_GUIDE_NEPALI.md

@@ -19,6 +19,7 @@
 - [११. स्केलिङ र पर्फर्मेन्स (Scaling & Performance)](#११-स्केलिङ-र-पर्फर्मेन्स-scaling--performance)
 - [१२. टेस्टिङ र डेभप्स (Testing & DevOps)](#१२-टेस्टिङ-र-डेभप्स-testing--devops)
 - [१३. भविष्य र योगदान (Future Roadmap)](#१३-भविष्य-र-योगदान-future-roadmap)
+- [१४. रियलटाइम र IoT मास्टरक्लास (Realtime & IoT Masterclass) [NEW]](#१४-रियलटाइम-र-iot-मास्टरक्लास-realtime--iot-masterclass-new)
 
 ---
 
@@ -282,6 +283,30 @@ app.post('/auth/2fa/setup', auth.middleware(), async (ctx) => {
   const result = await auth.setup2FA(ctx.req.user.id);
   ctx.json(result); // QR Code URL यहाँ आउँछ
 });
+
+### ७.५ कस्टम कन्ट्रोलर (Custom Controllers)
+यदि तपाईँलाई अटोमेटेड CRUD ले पुग्दैन भने, तपाईँ आफ्नै कन्ट्रोलर लेख्न सक्नुहुन्छ। Dolphin मा एउटा राम्रो कन्ट्रोलर यस्तो हुनुपर्छ:
+
+```typescript
+// src/controllers/userController.ts
+export const userController = {
+  getProfile: async (ctx) => {
+    const user = ctx.req.user;
+    if (!user) return ctx.status(401).json({ error: "Unauthorized" });
+    
+    // केही जटिल लजिक यहाँ...
+    ctx.json({ 
+      id: user.id, 
+      email: user.email, 
+      serverTime: new Date() 
+    });
+  }
+};
+```
+यसलाई राउटमा यसरी प्रयोग गर्नुहोस्:
+```typescript
+import { userController } from './controllers/userController';
+app.get('/me', auth.middleware(), userController.getProfile);
 ```
 
 ---
@@ -484,7 +509,8 @@ CMD ["npm", "start"]
 
 Dolphin अझै विकसित हुँदैछ। हाम्रो आगामी योजनाहरू:
 - **Dolphin CLI**: एउटा कमान्डले प्रोजेक्ट सेटअप गर्ने।
-- **WebSocket Support**: रियल-टाइम च्याटको लागि।
+- **Dolphin CLI**: एउटा कमान्डले प्रोजेक्ट सेटअप गर्ने।
+- **Realtime & IoT Integration**: उच्च क्षमताको डाटा इन्जेसनको लागि। [DONE]
 - **Native SQL Adapters**: PostgreSQL र MySQL का लागि विशेष एडाप्टरहरू।
 
 ### योगदान कसरी गर्ने?
@@ -492,6 +518,50 @@ Dolphin अझै विकसित हुँदैछ। हाम्रो
 
 ---
 
+## १४. रियलटाइम र IoT मास्टरक्लास (Realtime & IoT Masterclass) [NEW]
+
+आधुनिक एप्लिकेसनहरूलाई केवल "Request-Response" मात्र पुग्दैन। तिनीहरूलाई "Real-time" डाटा चाहिन्छ। Dolphin को Realtime मोड्युलले यसलाई सम्भव बनाउँछ।
+
+### १४.१ रियलटाइम कोर (Realtime Core) के हो?
+यो एउटा इन्टरनल "Event Bus" हो जसले मेसेजहरूलाई एक ठाउँबाट अर्को ठाउँमा तुरुन्तै पुर्‍याउँछ। यसले MQTT जस्तो "Topic-based" सिस्टम प्रयोग गर्छ।
+
+### १४.२ मुख्य अवधारणाहरू (Key Concepts)
+१. **TopicTrie**: मेसेजहरू कुन टपिकमा जाने भनेर छिटो पत्ता लगाउने इन्जिन।
+२. **Binary Codec**: डाटालाई सानो बनाउन बाइनरी फर्म्याटमा लैजाने सफ्टवेयर।
+३. **Plugins**: विभिन्न प्रोटोकलहरू (HL7, Modbus) सपोर्ट गर्न।
+
+### १४.३ कोड उदाहरण: बेसिक पब-सब (Pub/Sub)
+```typescript
+import { RealtimeCore } from 'dolphin-server-modules/realtime';
+
+const rt = new RealtimeCore({
+  maxMessageSize: 512 * 1024 // ५१२ KB म्याक्स साइज
+});
+
+// १. सब्सक्राइब (Subscribe) गर्ने
+rt.subscribe('sensors/temperature/+', (ctx) => {
+  console.log(`नयाँ डाटा आयो: ${ctx.payload.value}°C`);
+});
+
+// २. पब्लिस (Publish) गर्ने
+rt.publish('sensors/temperature/room1', { value: 22.5 });
+```
+
+### १४.४ वाइल्डकार्डको शक्ति (Power of Wildcards)
+- `sensors/+`: `sensors/temp` र `sensors/hum` दुवै म्याच गर्छ।
+- `sensors/#`: `sensors/a/b/c` जति पनि गहिराइ (depth) सम्म म्याच गर्छ।
+
+### १४.५ रेडिस स्केलिङ (Redis Scaling)
+यदि तपाईँको धेरै वटा सर्भरहरू छन् भने, तिनीहरूलाई रेडिस मार्फत जोड्न सक्नुहुन्छ:
+```typescript
+const rt = new RealtimeCore({
+  redisUrl: 'redis://localhost:6379'
+});
+```
+यसो गर्दा एउटा सर्भरबाट पठाएको मेसेज अर्को सर्भरमा बस्ने युजरले पनि तुरुन्तै पाउँछ।
+
+---
+
 ## निष्कर्ष (Conclusion)
 
 बधाई छ! तपाईँले Dolphin Framework को **Master Guide** को अन्त्य सम्म पढ्नुभयो। अब तपाईँ कुनै पनि जटिल ब्याकइन्ड सिस्टम Dolphin प्रयोग गरेर बनाउन पूर्ण सक्षम हुनुहुन्छ।

package/README.md

@@ -6,6 +6,13 @@
 
 ---
 
+### 📘 Official Master Guide (Nepal)
+Dolphin Framework को विस्तृत र आधिकारिक गाइड अब उपलब्ध छ। यसमा **Auth, CRUD, Models, र Controllers** को १००% ट्युटोरियल समावेश छ।
+
+👉 **[Dolphin Master Guide (PDF)](https://github.com/Phuyalshankar/dolphin-server-modules/blob/main/DOLPHIN_MASTER_GUIDE_NEPALI.pdf)**
+
+---
+
 ## 🚀 Core Philosophy
 - **Zero-Dependency Core**: Built on the native Node.js `http` module. No Express, no Fastify overhead.
 - **Extreme Modularity**: Use only what you need. Auth, CRUD, and Routing are all independent.
@@ -108,13 +115,19 @@ Seamlessly switch between databases with the Adapter pattern.
 ### ✅ 5. Zod-Powered Validation (`/middleware/zod`)
 Validate payloads and params with 100% type inference.
 
+### 🌐 6. Realtime & IoT Core (`/realtime`) [NEW]
+High-performance pub/sub with MQTT-style matching.
+- **TopicTrie**: $O(1)$ pattern matching for `+` and `#`.
+- **Binary Codec**: Ultra-lightweight ingestion for IoT devices.
+- **Redis Scaling**: Seamlessly scale across multiple instances.
+
 ---
 
 ## 🗺️ Roadmap & Future Vision
 1. **`defineModel` Engine**: Define a schema once, auto-generate CRUD, validation, and types.
-2. **Plugin System**: A robust "hook" based system for extending the framework core.
-3. **IoT & WebSocket Support**: Dedicated ingestion layer for high-throughput data.
-4. **CLI Presets**: `npx dolphin init` for instant project scaffolding.
+2. **Plugin System**: A robust "hook" based system for extending the framework core. [DONE]
+3. **CLI Presets**: `npx dolphin init` for instant project scaffolding.
+4. **Adaptive Load Balancing**: Native cluster support for multi-core CPUs.
 
 ---
 

package/TUTORIAL_NEPALI.md

@@ -180,7 +180,27 @@ app.post('/register', validate(registerSchema), (ctx) => {
 
 ---
 
-## ११. अन्तिममा (Conclusion)
+## ११. रियलटाइम र IoT (Realtime & IoT Core) [NEW]
+Dolphin ले अब उच्च क्षमताको रियलटाइम कम्युनिकेसन सपोर्ट गर्छ।
+
+```typescript
+import { RealtimeCore, JSONPlugin } from 'dolphin-server-modules/realtime';
+
+const rt = new RealtimeCore();
+rt.use(JSONPlugin);
+
+// टपिकहरूमा सब्सक्राइब (Subscribe) गर्नुहोस्
+rt.subscribe('sensors/+', (ctx) => {
+  console.log(`टपिक: ${ctx.topic}, डाटा:`, ctx.payload);
+});
+
+// पब्लिस (Publish) गर्नुहोस्
+rt.publish('sensors/temp', { value: 24.5 });
+```
+
+---
+
+## १२. अन्तिममा (Conclusion)
 
 Dolphin Framework निकै छिटो र सजिलो छ। यसले तपाईँको ब्याकइन्ड डेभलपमेन्टको अनुभवलाई नयाँ उचाइमा पुर्‍याउँछ।
 

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export * from './controller/controller';
 export { createCRUD, BaseDocument, QueryFilter, PaginationOptions, DatabaseAdapter as CrudDatabaseAdapter } from './curd/crud';
 export * from './server/server';
 export * from './router/router';
+export * from './realtime/index';

package/dist/index.js

@@ -25,4 +25,6 @@ Object.defineProperty(exports, "createCRUD", { enumerable: true, get: function (
 // Re-export Server & Router
 __exportStar(require("./server/server"), exports);
 __exportStar(require("./router/router"), exports);
+// Re-export Realtime
+__exportStar(require("./realtime/index"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iBAAiB;AACjB,8CAA4B;AAC5B,uBAAuB;AACvB,0DAAwC;AACxC,8DAA8D;AAC9D,oCAMqB;AALnB,kGAAA,UAAU,OAAA;AAMZ,4BAA4B;AAC5B,kDAAgC;AAChC,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iBAAiB;AACjB,8CAA4B;AAC5B,uBAAuB;AACvB,0DAAwC;AACxC,8DAA8D;AAC9D,oCAMqB;AALnB,kGAAA,UAAU,OAAA;AAMZ,4BAA4B;AAC5B,kDAAgC;AAChC,kDAAgC;AAEhC,qBAAqB;AACrB,mDAAiC"}

package/dist/realtime/codec.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Lightweight binary/JSON codec for Dolphin Realtime.
+ * Optimized for small payloads and cross-platform compatibility.
+ */
+export declare function getSize(data: any): number;
+/**
+ * Encode data to Buffer.
+ * Types:
+ * 1: Int32
+ * 2: String
+ * 3: JSON
+ * Default: Buffer as is
+ */
+export declare function encode(data: any): Buffer;
+/**
+ * Decode Buffer to data.
+ */
+export declare function decode(buf: Buffer): any;

package/dist/realtime/codec.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSize = getSize;
+exports.encode = encode;
+exports.decode = decode;
+/**
+ * Lightweight binary/JSON codec for Dolphin Realtime.
+ * Optimized for small payloads and cross-platform compatibility.
+ */
+function getSize(data) {
+    if (Buffer.isBuffer(data))
+        return data.length;
+    if (typeof data === 'string')
+        return Buffer.byteLength(data);
+    return Buffer.byteLength(JSON.stringify(data));
+}
+/**
+ * Encode data to Buffer.
+ * Types:
+ * 1: Int32
+ * 2: String
+ * 3: JSON
+ * Default: Buffer as is
+ */
+function encode(data) {
+    if (Buffer.isBuffer(data))
+        return data;
+    if (typeof data === 'number') {
+        const b = Buffer.allocUnsafe(5);
+        b[0] = 1;
+        b.writeInt32BE(data, 1);
+        return b;
+    }
+    if (typeof data === 'string') {
+        const str = Buffer.from(data);
+        const len = str.length;
+        // Simple header: type(1 byte) + len(2 bytes)
+        const b = Buffer.allocUnsafe(3);
+        b[0] = 2;
+        b.writeUInt16BE(len, 1);
+        return Buffer.concat([b, str]);
+    }
+    const json = Buffer.from(JSON.stringify(data));
+    const b = Buffer.allocUnsafe(1);
+    b[0] = 3;
+    return Buffer.concat([b, json]);
+}
+/**
+ * Decode Buffer to data.
+ */
+function decode(buf) {
+    if (!buf || buf.length === 0)
+        return null;
+    const t = buf[0];
+    if (t === 1)
+        return buf.readInt32BE(1);
+    if (t === 2) {
+        const len = buf.readUInt16BE(1);
+        return buf.slice(3, 3 + len).toString();
+    }
+    if (t === 3)
+        return JSON.parse(buf.slice(1).toString());
+    return buf;
+}
+//# sourceMappingURL=codec.js.map

package/dist/realtime/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../realtime/codec.ts"],"names":[],"mappings":";;AAIA,0BAIC;AAUD,wBAwBC;AAKD,wBAUC;AAzDD;;;GAGG;AACH,SAAgB,OAAO,CAAC,IAAS;IAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,MAAM,CAAC,IAAS;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACT,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QACvB,6CAA6C;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACT,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACT,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,GAAW;IAChC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/realtime/core.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter } from 'events';
+import { RealtimePlugin } from './plugins';
+/**
+ * RealtimeCore - High performance unified pub/sub bus for Dolphin.
+ * Supports:
+ * - Local event emitter (in-process)
+ * - Distributed bus via Redis (optional)
+ * - Retained messages with TTL
+ * - Device/Client tracking
+ * - Plugin-based protocol handling
+ */
+export declare class RealtimeCore extends EventEmitter {
+    private config;
+    private trie;
+    private retained;
+    private devices;
+    private plugins;
+    private pending;
+    private msgId;
+    private redisPub?;
+    private redisSub?;
+    constructor(config?: {
+        maxMessageSize?: number;
+        redisUrl?: string;
+        acl?: {
+            canSubscribe: (deviceId: string, topic: string) => boolean;
+            canPublish: (deviceId: string, topic: string) => boolean;
+        };
+    });
+    /**
+     * Initialize Redis for distributed pub/sub.
+     */
+    private initRedis;
+    /**
+     * Subscribe to a topic pattern.
+     */
+    subscribe(topic: string, fn: (data: any) => void, deviceId?: string): void;
+    /**
+     * Publish a message to a topic.
+     */
+    publish(topic: string, payload: any, opts?: {
+        retain?: boolean;
+        ttl?: number;
+    }, deviceId?: string): void;
+    private publishInternal;
+    /**
+     * Handle raw data from a socket.
+     */
+    handle(raw: Buffer, socket?: any, deviceId?: string): Promise<void>;
+    /**
+     * Register a plugin.
+     */
+    use(plugin: RealtimePlugin): void;
+    /**
+     * Register a device/client.
+     */
+    register(deviceId: string, socket?: any): void;
+    /**
+     * Heartbeat for a device.
+     */
+    touch(deviceId: string): void;
+    private startCleanup;
+}

package/dist/realtime/core.js

@@ -0,0 +1,200 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeCore = void 0;
+const events_1 = require("events");
+const trie_1 = require("./trie");
+const codec_1 = require("./codec");
+/**
+ * RealtimeCore - High performance unified pub/sub bus for Dolphin.
+ * Supports:
+ * - Local event emitter (in-process)
+ * - Distributed bus via Redis (optional)
+ * - Retained messages with TTL
+ * - Device/Client tracking
+ * - Plugin-based protocol handling
+ */
+class RealtimeCore extends events_1.EventEmitter {
+    config;
+    trie = new trie_1.TopicTrie();
+    retained = new Map();
+    devices = new Map();
+    plugins = new Map();
+    pending = new Map();
+    msgId = 0;
+    redisPub;
+    redisSub;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+        if (config.redisUrl) {
+            this.initRedis(config.redisUrl);
+        }
+        this.startCleanup();
+    }
+    /**
+     * Initialize Redis for distributed pub/sub.
+     */
+    async initRedis(url) {
+        try {
+            // @ts-ignore
+            const Redis = (await Promise.resolve().then(() => __importStar(require('ioredis')))).default;
+            this.redisPub = new Redis(url);
+            this.redisSub = new Redis(url);
+            this.redisSub.subscribe('dolphin-rt');
+            this.redisSub.on('message', (_, msg) => {
+                const { topic, payload } = JSON.parse(msg);
+                this.publishInternal(topic, payload, { skipRedis: true });
+            });
+        }
+        catch (err) {
+            console.warn('Redis initialization failed (ioredis not found or connection error):', err);
+        }
+    }
+    /**
+     * Subscribe to a topic pattern.
+     */
+    subscribe(topic, fn, deviceId) {
+        if (deviceId && this.config.acl && !this.config.acl.canSubscribe(deviceId, topic)) {
+            throw new Error('ACL deny');
+        }
+        this.trie.add(topic, fn);
+        // Replay retained messages
+        for (const [t, data] of this.retained.entries()) {
+            // Small hack: if we match the new subscription, replay
+            // We can improve this by matching the pattern against the topic
+            // For now, only exact match for simplicity or improve TopicTrie
+            if (t === topic)
+                fn(data.payload);
+        }
+    }
+    /**
+     * Publish a message to a topic.
+     */
+    publish(topic, payload, opts = {}, deviceId) {
+        if ((0, codec_1.getSize)(payload) > (this.config.maxMessageSize || 256 * 1024)) {
+            throw new Error('Payload too large');
+        }
+        if (deviceId && this.config.acl && !this.config.acl.canPublish(deviceId, topic)) {
+            throw new Error('ACL deny');
+        }
+        this.publishInternal(topic, payload, opts);
+    }
+    publishInternal(topic, payload, opts = {}) {
+        if (opts.retain) {
+            this.retained.set(topic, { payload, ts: Date.now(), ttl: opts.ttl || 0 });
+        }
+        // Match and emit locally
+        this.trie.match(topic, (fn) => fn({ topic, payload }));
+        this.emit('message', { topic, payload });
+        // Publish to Redis if available
+        if (this.redisPub && !opts.skipRedis) {
+            this.redisPub.publish('dolphin-rt', JSON.stringify({ topic, payload }));
+        }
+    }
+    /**
+     * Handle raw data from a socket.
+     */
+    async handle(raw, socket, deviceId) {
+        if (raw.length > (this.config.maxMessageSize || 256 * 1024))
+            return;
+        // Create initial context
+        const ctx = {
+            type: 'raw',
+            raw,
+            socket,
+            deviceId,
+            ts: Date.now(),
+            publish: this.publish.bind(this)
+        };
+        // Plugin matching and decoding
+        for (const p of this.plugins.values()) {
+            if (p.match(ctx)) {
+                if (p.decode)
+                    ctx.payload = p.decode(raw);
+                p.onMessage?.(ctx);
+                // If plugin handled it, we might want to stop or continue.
+                // For now, let's continue to allow multiple plugins or default handling.
+            }
+        }
+        // Default handling for 'pub' style packets if no plugin decoded it or just generic
+        try {
+            const decoded = (0, codec_1.decode)(raw);
+            if (decoded && typeof decoded === 'object' && decoded.type === 'pub') {
+                this.publish(decoded.topic, decoded.payload, {}, deviceId);
+            }
+        }
+        catch {
+            // Ignore decode errors for raw data
+        }
+    }
+    /**
+     * Register a plugin.
+     */
+    use(plugin) {
+        this.plugins.set(plugin.name, plugin);
+    }
+    /**
+     * Register a device/client.
+     */
+    register(deviceId, socket) {
+        this.devices.set(deviceId, { lastSeen: Date.now(), socket });
+    }
+    /**
+     * Heartbeat for a device.
+     */
+    touch(deviceId) {
+        const d = this.devices.get(deviceId);
+        if (d)
+            d.lastSeen = Date.now();
+    }
+    startCleanup() {
+        setInterval(() => {
+            const now = Date.now();
+            // Clean retained messages
+            for (const [k, v] of this.retained) {
+                if (v.ttl && now - v.ts > v.ttl)
+                    this.retained.delete(k);
+            }
+            // Clean inactive devices (1 minute timeout)
+            for (const [id, d] of this.devices) {
+                if (now - d.lastSeen > 60000)
+                    this.devices.delete(id);
+            }
+        }, 5000);
+    }
+}
+exports.RealtimeCore = RealtimeCore;
+//# sourceMappingURL=core.js.map

package/dist/realtime/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../realtime/core.ts"],"names":[],"mappings":"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"}

package/dist/realtime/index.d.ts

@@ -0,0 +1,4 @@
+export * from './core';
+export * from './trie';
+export * from './codec';
+export * from './plugins';

package/dist/realtime/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core"), exports);
+__exportStar(require("./trie"), exports);
+__exportStar(require("./codec"), exports);
+__exportStar(require("./plugins"), exports);
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../realtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B"}

package/dist/realtime/plugins.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Realtime Plugins for Dolphin.
+ * Allows handling custom protocols (e.g. Modbus, HL7) seamlessly.
+ */
+export type RealtimeContext = {
+    id?: number;
+    type: string;
+    topic?: string;
+    payload?: any;
+    raw?: Buffer;
+    socket?: any;
+    deviceId?: string;
+    ts: number;
+    publish: (topic: string, payload: any, opts?: any) => void;
+};
+export type RealtimePlugin = {
+    name: string;
+    match: (ctx: RealtimeContext) => boolean;
+    decode?: (buf: Buffer) => any;
+    encode?: (data: any) => Buffer;
+    onMessage?: (ctx: RealtimeContext) => void;
+};
+/**
+ * Sample HL7 Plugin
+ */
+export declare const HL7Plugin: RealtimePlugin;
+/**
+ * Sample Modbus Plugin
+ */
+export declare const ModbusPlugin: RealtimePlugin;
+/**
+ * Standard JSON Plugin for Web
+ */
+export declare const JSONPlugin: RealtimePlugin;

package/dist/realtime/plugins.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Realtime Plugins for Dolphin.
+ * Allows handling custom protocols (e.g. Modbus, HL7) seamlessly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONPlugin = exports.ModbusPlugin = exports.HL7Plugin = void 0;
+/**
+ * Sample HL7 Plugin
+ */
+exports.HL7Plugin = {
+    name: 'hl7',
+    match: (ctx) => ctx.raw?.includes?.(0x0b) ?? false,
+    decode: (buf) => ({ msg: buf.toString().split('\r') })
+};
+/**
+ * Sample Modbus Plugin
+ */
+exports.ModbusPlugin = {
+    name: 'modbus',
+    match: (ctx) => ctx.raw?.length === 8,
+    decode: (buf) => ({
+        addr: buf[0],
+        func: buf[1],
+        value: buf.readUInt16BE(2)
+    })
+};
+/**
+ * Standard JSON Plugin for Web
+ */
+exports.JSONPlugin = {
+    name: 'json',
+    match: (ctx) => {
+        try {
+            if (ctx.raw) {
+                JSON.parse(ctx.raw.toString());
+                return true;
+            }
+        }
+        catch {
+            return false;
+        }
+        return false;
+    },
+    decode: (buf) => JSON.parse(buf.toString())
+};
+//# sourceMappingURL=plugins.js.map

package/dist/realtime/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../realtime/plugins.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAsBH;;GAEG;AACU,QAAA,SAAS,GAAmB;IACvC,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;CACvD,CAAC;AAEF;;GAEG;AACU,QAAA,YAAY,GAAmB;IAC1C,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;IACrC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACZ,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF;;GAEG;AACU,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;CAC5C,CAAC"}

package/dist/realtime/trie.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TopicTrie for high-performance MQTT-style topic matching.
+ * Supports:
+ * - Simple topics: "sensors/temp"
+ * - Single level wildcard: "sensors/+" (matches "sensors/temp", "sensors/hum")
+ * - Multi level wildcard: "sensors/#" (matches "sensors/temp", "sensors/room1/temp")
+ */
+export declare class TopicTrie {
+    private root;
+    /**
+     * Add a subscriber function to a topic pattern.
+     */
+    add(topic: string, fn: Function): void;
+    /**
+     * Remove a subscriber function from a topic pattern.
+     */
+    remove(topic: string, fn: Function): void;
+    /**
+     * Match a topic and execute callback for each matching subscriber.
+     */
+    match(topic: string, cb: (fn: Function) => void): void;
+}

package/dist/realtime/trie.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicTrie = void 0;
+/**
+ * TopicTrie for high-performance MQTT-style topic matching.
+ * Supports:
+ * - Simple topics: "sensors/temp"
+ * - Single level wildcard: "sensors/+" (matches "sensors/temp", "sensors/hum")
+ * - Multi level wildcard: "sensors/#" (matches "sensors/temp", "sensors/room1/temp")
+ */
+class TopicTrie {
+    root = {};
+    /**
+     * Add a subscriber function to a topic pattern.
+     */
+    add(topic, fn) {
+        const parts = topic.split('/');
+        let node = this.root;
+        for (const p of parts) {
+            if (!node[p])
+                node[p] = {};
+            node = node[p];
+        }
+        if (!node._)
+            node._ = [];
+        node._.push(fn);
+    }
+    /**
+     * Remove a subscriber function from a topic pattern.
+     */
+    remove(topic, fn) {
+        const parts = topic.split('/');
+        let node = this.root;
+        for (const p of parts) {
+            if (!node[p])
+                return;
+            node = node[p];
+        }
+        if (node._) {
+            node._ = node._.filter((f) => f !== fn);
+            if (node._.length === 0)
+                delete node._;
+        }
+    }
+    /**
+     * Match a topic and execute callback for each matching subscriber.
+     */
+    match(topic, cb) {
+        const parts = topic.split('/');
+        const walk = (node, i) => {
+            if (!node)
+                return;
+            // Exact match level
+            if (i === parts.length) {
+                if (node._)
+                    node._.forEach(cb);
+                // Also check if '#' exists at this level (e.g. pattern 'a/#' matches 'a')
+                if (node['#'] && node['#']._)
+                    node['#']._.forEach(cb);
+                return;
+            }
+            // 1. Direct match
+            if (node[parts[i]])
+                walk(node[parts[i]], i + 1);
+            // 2. Single level wildcard '+'
+            if (node['+'])
+                walk(node['+'], i + 1);
+            // 3. Multi level wildcard '#'
+            if (node['#'] && node['#']._)
+                node['#']._.forEach(cb);
+        };
+        walk(this.root, 0);
+    }
+}
+exports.TopicTrie = TopicTrie;
+//# sourceMappingURL=trie.js.map

package/dist/realtime/trie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trie.js","sourceRoot":"","sources":["../../realtime/trie.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAa,SAAS;IACZ,IAAI,GAAQ,EAAE,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,EAAY;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAErB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,CAAC;YAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,EAAY;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAErB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO;YACrB,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAa,EAAE,EAA0B;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,IAAI,GAAG,CAAC,IAAS,EAAE,CAAS,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI;gBAAE,OAAO;YAElB,oBAAoB;YACpB,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC/B,0EAA0E;gBAC1E,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,kBAAkB;YAClB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhD,+BAA+B;YAC/B,IAAI,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAEtC,8BAA8B;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;CACF;AAlED,8BAkEC"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "dolphin-server-modules",
-  "version": "1.1.0",
+  "version": "1.2.0",
+  "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
   "description": "Core utility modules for Auth, CRUD, and Controllers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +21,12 @@
     "./middleware/zod": "./dist/middleware/zod.js",
     "./adapters/mongoose": "./dist/adapters/mongoose/index.js",
     "./server": "./dist/server/server.js",
-    "./router": "./dist/router/router.js"
+    "./router": "./dist/router/router.js",
+    "./realtime": "./dist/realtime/index.js",
+    "./realtime/core": "./dist/realtime/core.js",
+    "./realtime/trie": "./dist/realtime/trie.js",
+    "./realtime/codec": "./dist/realtime/codec.js",
+    "./realtime/plugins": "./dist/realtime/plugins.js"
   },
   "scripts": {
     "build": "tsc",
@@ -32,12 +38,15 @@
     "server",
     "auth",
     "crud",
-    "controller"
+    "controller",
+    "realtime",
+    "iot"
   ],
   "author": "",
   "license": "ISC",
   "dependencies": {
     "argon2": "^0.40.1",
+    "ioredis": "^15.15.5",
     "zod": "^4.3.6"
   },
   "devDependencies": {