dolphin-server-modules 1.1.1 → 1.3.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)
 
 ---
 
@@ -508,7 +509,8 @@ CMD ["npm", "start"]
 
 Dolphin अझै विकसित हुँदैछ। हाम्रो आगामी योजनाहरू:
 - **Dolphin CLI**: एउटा कमान्डले प्रोजेक्ट सेटअप गर्ने।
-- **WebSocket Support**: रियल-टाइम च्याटको लागि।
+- **Dolphin CLI**: एउटा कमान्डले प्रोजेक्ट सेटअप गर्ने।
+- **Realtime & IoT Integration**: उच्च क्षमताको डाटा इन्जेसनको लागि। [DONE]
 - **Native SQL Adapters**: PostgreSQL र MySQL का लागि विशेष एडाप्टरहरू।
 
 ### योगदान कसरी गर्ने?
@@ -516,6 +518,77 @@ 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'
+});
+```
+यसो गर्दा एउटा सर्भरबाट पठाएको मेसेज अर्को सर्भरमा बस्ने युजरले पनि तुरुन्तै पाउँछ।
+
+---
+
+## १५. इन्डिपेन्डेन्ट राउटिङ मास्टरक्लास (Independent Routing) [NEW]
+
+तपाईँको प्रोजेक्ट ठूलो हुँदै जाँदा एउटै फाइलमा सबै राउट्हरू राख्नु झन्झटिलो हुन्छ। त्यसैले Dolphin ले एक्सप्रेस जस्तै `Router` सपोर्ट गर्छ।
+
+### १५.१ किन प्रयोग गर्ने?
+- **Modular Code**: राउट्हरूलाई काम अनुसार (जस्तै: Users, Products, Auth) अलग फाइलमा राख्न।
+- **Prefixing**: एउटा पूरा राउट सेटलाई एउटा 'Prefix' (जस्तै: `/api/v1`) भित्र राख्न।
+- **Clean index.ts**: मुख्य फाइललाई सफा र छोटो राख्न।
+
+### १५.२ कोड उदाहरण
+```typescript
+// userRouters.ts
+import { createDolphinRouter } from 'dolphin-server-modules/router';
+export const userRouter = createDolphinRouter();
+
+userRouter.get('/profile', (ctx) => ctx.json({ name: "Ram" }));
+
+// main.ts
+import { createDolphinServer } from 'dolphin-server-modules/server';
+import { userRouter } from './userRouters';
+
+const app = createDolphinServer();
+app.use('/users', userRouter); // अब यो /users/profile मा चल्छ
+```
+
+---
+
 ## निष्कर्ष (Conclusion)
 
 बधाई छ! तपाईँले Dolphin Framework को **Master Guide** को अन्त्य सम्म पढ्नुभयो। अब तपाईँ कुनै पनि जटिल ब्याकइन्ड सिस्टम Dolphin प्रयोग गरेर बनाउन पूर्ण सक्षम हुनुहुन्छ।

package/README.md

@@ -115,12 +115,21 @@ 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`)
+High-performance pub/sub with MQTT-style matching.
+
+### 🛣️ 7. Independent Routing (`/router`) [NEW]
+Express-style standalone routers for clean organization.
+- `app.use('/prefix', subRouter)`: Mount sub-modules with ease.
+- **Nested Routing**: Unlimited nesting with prefix inheritance.
+- **Unified Matcher**: Optimized matching for both static and dynamic routes.
+
 ---
 
 ## 🗺️ 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.
+2. **Plugin System**: A robust "hook" based system. [DONE]
+3. **Independent Routing**: Standalone sub-routers for large apps. [DONE]
 4. **CLI Presets**: `npx dolphin init` for instant project scaffolding.
 
 ---

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/dist/router/router.d.ts

@@ -1,13 +1,26 @@
-type Handler = (ctx: any) => Promise<void> | void;
+export type Handler = (ctx: any) => Promise<void> | void;
+export interface Route {
+    method: string;
+    path: string;
+    handler: Handler;
+    regex: RegExp;
+    keys: string[];
+}
 export declare function createDolphinRouter(): {
     get: (path: string, handler: Handler) => void;
     post: (path: string, handler: Handler) => void;
     put: (path: string, handler: Handler) => void;
     delete: (path: string, handler: Handler) => void;
     patch: (path: string, handler: Handler) => void;
+    all: (path: string, handler: Handler) => void;
+    /**
+     * Mount a sub-router or middleware.
+     * app.use('/auth', authRouter)
+     */
+    use: (prefix: string, subRouter: any) => void;
+    _routes: Route[];
     match(method: string, url: string): {
         handler: Handler;
         params: Record<string, string>;
     } | null;
 };
-export {};

package/dist/router/router.js

@@ -4,9 +4,10 @@ exports.createDolphinRouter = createDolphinRouter;
 function createDolphinRouter() {
     const routes = [];
     const addRoute = (method, path, handler) => {
-        // Convert /users/:id to regex
+        // Normalize path to remove trailing slashes unless it's just /
+        const normalizedPath = path === '/' ? '/' : path.replace(/\/$/, '');
         const keys = [];
-        const pattern = path
+        const pattern = normalizedPath
             .replace(/:([^\/]+)/g, (_, key) => {
             keys.push(key);
             return '([^\\/]+)';
@@ -14,18 +15,39 @@ function createDolphinRouter() {
             .replace(/\//g, '\\/');
         routes.push({
             method: method.toUpperCase(),
-            path,
+            path: normalizedPath,
             handler,
             regex: new RegExp(`^${pattern}$`),
             keys
         });
     };
-    return {
+    const router = {
         get: (path, handler) => addRoute('GET', path, handler),
         post: (path, handler) => addRoute('POST', path, handler),
         put: (path, handler) => addRoute('PUT', path, handler),
         delete: (path, handler) => addRoute('DELETE', path, handler),
         patch: (path, handler) => addRoute('PATCH', path, handler),
+        all: (path, handler) => addRoute('ALL', path, handler),
+        /**
+         * Mount a sub-router or middleware.
+         * app.use('/auth', authRouter)
+         */
+        use: (prefix, subRouter) => {
+            if (typeof prefix !== 'string') {
+                // Fallback for global middleware handling if needed
+                return;
+            }
+            const normalizedPrefix = prefix === '/' ? '' : prefix.replace(/\/$/, '');
+            // If subRouter is another Dolphin router, merge its routes
+            if (subRouter && typeof subRouter.match === 'function' && subRouter._routes) {
+                for (const sr of subRouter._routes) {
+                    const fullPath = normalizedPrefix + (sr.path === '/' ? '' : sr.path);
+                    addRoute(sr.method, fullPath || '/', sr.handler);
+                }
+            }
+        },
+        // Internal getter for route merging
+        _routes: routes,
         match(method, url) {
             const path = url.split('?')[0];
             const m = method.toUpperCase();
@@ -44,5 +66,6 @@ function createDolphinRouter() {
             return null;
         }
     };
+    return router;
 }
 //# sourceMappingURL=router.js.map

package/dist/router/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../router/router.ts"],"names":[],"mappings":";;AAUA,kDAgDC;AAhDD,SAAgB,mBAAmB;IACjC,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,OAAgB,EAAE,EAAE;QAClE,8BAA8B;QAC9B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI;aACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,OAAO,WAAW,CAAC;QACrB,CAAC,CAAC;aACD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAEzB,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5B,IAAI;YACJ,OAAO;YACP,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC;YACjC,IAAI;SACL,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;QACvE,IAAI,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;QACzE,GAAG,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;QACvE,MAAM,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;QAC7E,KAAK,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;QAE3E,KAAK,CAAC,MAAc,EAAE,GAAW;YAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;oBAAE,SAAS;gBAE3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,MAAM,GAA2B,EAAE,CAAC;oBAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;wBAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7B,CAAC,CAAC,CAAC;oBACH,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC5C,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../router/router.ts"],"names":[],"mappings":"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"}

package/dist/server/server.d.ts

@@ -3,16 +3,18 @@ export declare function createDolphinServer(options?: {
     port?: number;
     host?: string;
 }): {
-    use: (mw: any) => number;
+    use: (prefixOrMw: string | any, mw?: any) => void;
     listen: (port?: number, callback?: () => void) => void;
     close: () => http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
-    get: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
-    post: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
-    put: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
-    delete: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
-    patch: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
+    get: (path: string, handler: import("../router/router").Handler) => void;
+    post: (path: string, handler: import("../router/router").Handler) => void;
+    put: (path: string, handler: import("../router/router").Handler) => void;
+    delete: (path: string, handler: import("../router/router").Handler) => void;
+    patch: (path: string, handler: import("../router/router").Handler) => void;
+    all: (path: string, handler: import("../router/router").Handler) => void;
+    _routes: import("../router/router").Route[];
     match(method: string, url: string): {
-        handler: (ctx: any) => Promise<void> | void;
+        handler: import("../router/router").Handler;
         params: Record<string, string>;
     } | null;
 };

package/dist/server/server.js

@@ -77,7 +77,14 @@ function createDolphinServer(options = {}) {
     });
     return {
         ...router, // Mixin router methods (get, post, etc.)
-        use: (mw) => middlewares.push(mw),
+        use: (prefixOrMw, mw) => {
+            if (typeof prefixOrMw === 'string' && mw && typeof mw.match === 'function') {
+                router.use(prefixOrMw, mw);
+            }
+            else {
+                middlewares.push(prefixOrMw);
+            }
+        },
         listen: (port = options.port || 3000, callback) => {
             server.listen(port, options.host || '0.0.0.0', callback);
         },

package/dist/server/server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dolphin-server-modules",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
   "description": "Core utility modules for Auth, CRUD, and Controllers",
   "main": "dist/index.js",
@@ -21,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",
@@ -33,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": {