dolphin-server-modules 2.11.0 → 2.11.2

package/dist/dolphin-bench.js

@@ -0,0 +1,63 @@
+import { createDolphinServer } from './server/server';
+import http from 'http';
+const PORT = 3007;
+const CONCURRENCY = 50;
+const DURATION_MS = 5000;
+async function benchmark() {
+    const app = createDolphinServer();
+    app.get('/perf', (ctx) => {
+        ctx.json({ status: 'ok', rps_test: true });
+    });
+    const server = app.listen(PORT, async () => {
+        console.log(`🐬 Dolphin Benchmark Server running on port ${PORT}`);
+        const getMemory = () => {
+            const mem = process.memoryUsage();
+            return {
+                rss: (mem.rss / 1024 / 1024).toFixed(2) + ' MB',
+                heapUsed: (mem.heapUsed / 1024 / 1024).toFixed(2) + ' MB',
+                heapTotal: (mem.heapTotal / 1024 / 1024).toFixed(2) + ' MB'
+            };
+        };
+        const memBefore = getMemory();
+        console.log(`🧠 Memory BEFORE load: RSS: ${memBefore.rss}, Heap: ${memBefore.heapUsed}/${memBefore.heapTotal}`);
+        let successfulRequests = 0;
+        let totalLatency = 0;
+        const startTime = Date.now();
+        const makeRequest = () => {
+            const requestStart = Date.now();
+            return new Promise((resolve) => {
+                if (Date.now() - startTime > DURATION_MS)
+                    return resolve();
+                const req = http.get(`http://localhost:${PORT}/perf`, (res) => {
+                    if (res.statusCode === 200)
+                        successfulRequests++;
+                    totalLatency += Date.now() - requestStart;
+                    res.resume();
+                    res.on('end', () => {
+                        if (Date.now() - startTime < DURATION_MS)
+                            makeRequest().then(resolve);
+                        else
+                            resolve();
+                    });
+                });
+                req.on('error', () => resolve());
+            });
+        };
+        console.log(`🚀 Starting single-process benchmark (Concurrency: ${CONCURRENCY})...`);
+        const promises = Array.from({ length: CONCURRENCY }, () => makeRequest());
+        await Promise.all(promises);
+        const actualDuration = (Date.now() - startTime) / 1000;
+        const rps = (successfulRequests / actualDuration).toFixed(2);
+        const avgLatency = (totalLatency / successfulRequests).toFixed(2);
+        const memAfter = getMemory();
+        console.log('\n📊 DOLPHIN PERFORMANCE RESULTS (Single Process):');
+        console.log(`Requests Per Second: ${rps}`);
+        console.log(`Average Latency: ${avgLatency}ms`);
+        console.log(`Total Successful Requests: ${successfulRequests}`);
+        console.log(`🧠 Memory AFTER load: RSS: ${memAfter.rss}, Heap: ${memAfter.heapUsed}/${memAfter.heapTotal}`);
+        server.close();
+        process.exit(0);
+    });
+}
+benchmark().catch(console.error);
+//# sourceMappingURL=dolphin-bench.js.map

package/dist/dolphin-bench.js.map

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

package/dist/hard-performance-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hard-performance-test.js

@@ -0,0 +1,97 @@
+// hard-performance-test.ts - Intensive performance test
+import { createServer } from "http";
+import { cpus } from "os";
+import cluster from "cluster";
+const PORT = 3006;
+const CONCURRENCY = 100; // Increased concurrency
+const DURATION_MS = 10000; // Longer duration
+if (cluster.isMaster) {
+    const numWorkers = cpus().length;
+    console.log(`🍴 Master running, forking ${numWorkers} workers for hard test...`);
+    for (let i = 0; i < numWorkers; i++) {
+        cluster.fork();
+    }
+    let results = [];
+    for (const id in cluster.workers) {
+        cluster.workers[id]?.on("message", (msg) => {
+            if (msg.type === "result") {
+                results.push(msg.data);
+                if (results.length === numWorkers) {
+                    console.log("\n📊 HARD CLUSTER PERFORMANCE RESULTS:");
+                    results.forEach((r) => {
+                        console.log(`Worker ${r.workerId}: ${r.rps} RPS | Avg Latency: ${r.latency}ms | Total: ${r.total}, Success: ${r.success}`);
+                    });
+                    const totalRPS = results.reduce((sum, r) => sum + r.rps, 0);
+                    console.log(`\nTotal RPS across all workers: ${totalRPS.toFixed(2)}`);
+                    process.exit(0);
+                }
+            }
+        });
+    }
+}
+else {
+    // Worker process
+    const app = createServer((req, res) => {
+        if (req.url === "/hard-perf") {
+            // Simulate some processing delay
+            setTimeout(() => {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ status: "ok", time: Date.now() }));
+            }, Math.random() * 10); // Random delay 0-10ms
+        }
+        else {
+            res.writeHead(404);
+            res.end();
+        }
+    });
+    app.listen(PORT, () => {
+        console.log(`Worker ${process.pid} listening on port ${PORT}`);
+        // Benchmark inside worker
+        let totalRequests = 0;
+        let successfulRequests = 0;
+        let totalLatency = 0;
+        const startTime = Date.now();
+        const http = require("http");
+        const makeRequest = () => {
+            const requestStart = Date.now();
+            return new Promise((resolve) => {
+                if (Date.now() - startTime > DURATION_MS)
+                    return resolve();
+                const req = http.get(`http://localhost:${PORT}/hard-perf`, (res) => {
+                    totalRequests++;
+                    if (res.statusCode === 200)
+                        successfulRequests++;
+                    totalLatency += Date.now() - requestStart;
+                    res.resume();
+                    res.on("end", () => {
+                        if (Date.now() - startTime < DURATION_MS)
+                            makeRequest().then(resolve);
+                        else
+                            resolve();
+                    });
+                });
+                req.on("error", () => {
+                    totalRequests++;
+                    resolve();
+                });
+            });
+        };
+        const promises = Array.from({ length: CONCURRENCY }, () => makeRequest());
+        Promise.all(promises).then(() => {
+            const actualDuration = (Date.now() - startTime) / 1000;
+            const rps = (successfulRequests / actualDuration).toFixed(2);
+            const avgLatency = successfulRequests > 0 ? (totalLatency / successfulRequests).toFixed(2) : '0';
+            process.send?.({
+                type: "result",
+                data: {
+                    workerId: process.pid,
+                    total: totalRequests,
+                    success: successfulRequests,
+                    rps: Number(rps),
+                    latency: Number(avgLatency),
+                },
+            });
+        });
+    });
+}
+//# sourceMappingURL=hard-performance-test.js.map

package/dist/hard-performance-test.js.map

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

package/dist/middleware/zod.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/middleware/zod.test.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { validateStructure, validatePagesRequest, validateAppRoute } from './zod';
+describe('Zod Validation Middleware', () => {
+    const userSchema = z.object({
+        name: z.string().min(2),
+        age: z.number().gte(18)
+    });
+    describe('validateStructure', () => {
+        it('validates and returns data if valid', () => {
+            const data = { name: 'Alice', age: 25 };
+            const res = validateStructure(userSchema, data);
+            expect(res).toEqual(data);
+        });
+        it('throws custom error object if invalid', () => {
+            expect(() => validateStructure(userSchema, { name: 'A', age: 10 })).toThrowError();
+            try {
+                validateStructure(userSchema, { name: 'A', age: 10 });
+            }
+            catch (err) {
+                expect(err.status).toBe(400);
+                expect(err.errors.length).toBe(2);
+                expect(err.errors[0].field).toBe('name');
+            }
+        });
+    });
+    describe('validatePagesRequest', () => {
+        it('calls next if valid', () => {
+            const middleware = validatePagesRequest({ body: userSchema });
+            const req = { body: { name: 'Alice', age: 25 } };
+            const res = { status: jest.fn().mockReturnThis(), json: jest.fn() };
+            const next = jest.fn();
+            middleware(req, res, next);
+            expect(next).toHaveBeenCalled();
+            expect(res.status).not.toHaveBeenCalled();
+        });
+        it('returns 400 if invalid', () => {
+            const middleware = validatePagesRequest({ body: userSchema });
+            const req = { body: { name: 'A' } };
+            const res = { status: jest.fn().mockReturnThis(), json: jest.fn() };
+            const next = jest.fn();
+            middleware(req, res, next);
+            expect(next).not.toHaveBeenCalled();
+            expect(res.status).toHaveBeenCalledWith(400);
+            expect(res.json).toHaveBeenCalled();
+        });
+    });
+    describe('validateAppRoute', () => {
+        it('passes validated data to the handler', async () => {
+            const handler = jest.fn().mockReturnValue(new Response('OK'));
+            const wrapped = validateAppRoute(userSchema, handler);
+            const request = new Request('http://localhost', {
+                method: 'POST',
+                body: JSON.stringify({ name: 'Alice', age: 25 })
+            });
+            const response = await wrapped(request);
+            expect(handler).toHaveBeenCalledWith(request, { name: 'Alice', age: 25 });
+        });
+        it('returns a 400 response on validation failure', async () => {
+            const handler = jest.fn();
+            const wrapped = validateAppRoute(userSchema, handler);
+            const request = new Request('http://localhost', {
+                method: 'POST',
+                body: JSON.stringify({ name: 'A', age: 10 })
+            });
+            const response = await wrapped(request);
+            expect(handler).not.toHaveBeenCalled();
+            expect(response.status).toBe(400);
+            const body = await response.json();
+            expect(body.message).toBe('Validation Error');
+            expect(body.errors.length).toBe(2);
+        });
+    });
+});
+//# sourceMappingURL=zod.test.js.map

package/dist/middleware/zod.test.js.map

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

package/dist/performance-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/performance-test.js

@@ -0,0 +1,92 @@
+// performance-cluster.ts
+import { createServer } from "http";
+import { cpus } from "os";
+import cluster from "cluster";
+const PORT = 3005;
+const CONCURRENCY = 50;
+const DURATION_MS = 5000;
+if (cluster.isMaster) {
+    const numWorkers = cpus().length;
+    console.log(`🍴 Master running, forking ${numWorkers} workers...`);
+    for (let i = 0; i < numWorkers; i++) {
+        cluster.fork();
+    }
+    let results = [];
+    for (const id in cluster.workers) {
+        cluster.workers[id]?.on("message", (msg) => {
+            if (msg.type === "result") {
+                results.push(msg.data);
+                if (results.length === numWorkers) {
+                    console.log("\n📊 CLUSTER PERFORMANCE RESULTS:");
+                    results.forEach((r) => {
+                        console.log(`Worker ${r.workerId}: ${r.rps} RPS | Avg Latency: ${r.latency}ms | Total: ${r.total}, Success: ${r.success}`);
+                    });
+                    process.exit(0);
+                }
+            }
+        });
+    }
+}
+else {
+    // Worker process
+    const app = createServer((req, res) => {
+        if (req.url === "/perf") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", time: Date.now() }));
+        }
+        else {
+            res.writeHead(404);
+            res.end();
+        }
+    });
+    app.listen(PORT, () => {
+        console.log(`Worker ${process.pid} listening on port ${PORT}`);
+        // Benchmark inside worker
+        let totalRequests = 0;
+        let successfulRequests = 0;
+        let totalLatency = 0;
+        const startTime = Date.now();
+        const http = require("http");
+        const makeRequest = () => {
+            const requestStart = Date.now();
+            return new Promise((resolve) => {
+                if (Date.now() - startTime > DURATION_MS)
+                    return resolve();
+                const req = http.get(`http://localhost:${PORT}/perf`, (res) => {
+                    totalRequests++;
+                    if (res.statusCode === 200)
+                        successfulRequests++;
+                    totalLatency += Date.now() - requestStart;
+                    res.resume();
+                    res.on("end", () => {
+                        if (Date.now() - startTime < DURATION_MS)
+                            makeRequest().then(resolve);
+                        else
+                            resolve();
+                    });
+                });
+                req.on("error", () => {
+                    totalRequests++;
+                    resolve();
+                });
+            });
+        };
+        const promises = Array.from({ length: CONCURRENCY }, () => makeRequest());
+        Promise.all(promises).then(() => {
+            const actualDuration = (Date.now() - startTime) / 1000;
+            const rps = (successfulRequests / actualDuration).toFixed(2);
+            const avgLatency = (totalLatency / successfulRequests).toFixed(2);
+            process.send?.({
+                type: "result",
+                data: {
+                    workerId: process.pid,
+                    total: totalRequests,
+                    success: successfulRequests,
+                    rps: Number(rps),
+                    latency: Number(avgLatency),
+                },
+            });
+        });
+    });
+}
+//# sourceMappingURL=performance-test.js.map

package/dist/performance-test.js.map

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

package/dist/real-test-mongoose.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/real-test-mongoose.js

@@ -0,0 +1,104 @@
+import mongoose from 'mongoose';
+import { MongoMemoryServer } from 'mongodb-memory-server';
+import { createDolphinServer } from './server/server';
+import { createMongooseAdapter } from './adapters/mongoose';
+import { createCrudController } from './curd/crud';
+// Define a sample schema
+const ProductSchema = new mongoose.Schema({
+    name: String,
+    price: Number,
+    category: String,
+    createdAt: String,
+    updatedAt: String,
+});
+const Product = mongoose.model('Product', ProductSchema);
+const UserSchema = new mongoose.Schema({
+    email: String
+});
+const User = mongoose.model('User', UserSchema);
+const RefreshTokenSchema = new mongoose.Schema({
+    token: String
+});
+const RefreshToken = mongoose.model('RefreshToken', RefreshTokenSchema);
+async function runTest() {
+    console.log('🌱 Starting MongoDB Memory Server...');
+    const mongod = await MongoMemoryServer.create();
+    const uri = mongod.getUri();
+    await mongoose.connect(uri);
+    console.log('✅ Connected to MongoDB Memory Server');
+    // Create Mongoose adapter for Dolphin CRUD
+    const db = createMongooseAdapter({
+        User,
+        RefreshToken,
+        models: { Product },
+        leanByDefault: true,
+        softDelete: false
+    });
+    const app = createDolphinServer();
+    // Create CRUD Controller, disable enforceOwnership so it works publicly
+    const crud = createCrudController(db, "Product", { enforceOwnership: false });
+    // Map Routes
+    app.get('/products', crud.getAll);
+    app.get('/products/:id', crud.getOne);
+    app.post('/products', crud.create);
+    app.put('/products/:id', crud.update);
+    app.delete('/products/:id', crud.delete);
+    const server = app.listen(3002, async () => {
+        console.log('🚀 Server running on port 3002\n');
+        console.log('--- RUNNING TESTS ---\n');
+        try {
+            // 1. Create a Product
+            console.log('➡️ POST /products');
+            let res = await fetch('http://localhost:3002/products', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ name: 'Real Mongoose iPhone', price: 999, category: 'Electronics' })
+            });
+            const createdItem = await res.json();
+            console.log('✅ Created:', createdItem, '\n');
+            // 2. Read All Products
+            const itemId = createdItem.id || createdItem._id;
+            console.log('➡️ GET /products');
+            res = await fetch('http://localhost:3002/products');
+            const allItems = await res.json();
+            console.log('✅ All Products:', allItems, '\n');
+            // 3. Read Single Product by ID
+            console.log(`➡️ GET /products/${itemId}`);
+            res = await fetch(`http://localhost:3002/products/${itemId}`);
+            let singleItem = await res.json();
+            console.log('✅ Single Product:', singleItem, '\n');
+            // 4. Update Product
+            console.log(`➡️ PUT /products/${itemId}`);
+            res = await fetch(`http://localhost:3002/products/${itemId}`, {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ price: 899 })
+            });
+            const updatedItem = await res.json();
+            console.log('✅ Updated Product:', updatedItem, '\n');
+            // 5. Delete Product
+            console.log(`➡️ DELETE /products/${createdItem.id}`);
+            res = await fetch(`http://localhost:3002/products/${createdItem.id}`, { method: 'DELETE' });
+            const deleteResult = await res.json();
+            console.log('✅ Delete Result:', deleteResult, '\n');
+            // 6. Ensure empty list now
+            console.log('➡️ GET /products (After Delete)');
+            res = await fetch('http://localhost:3002/products');
+            const finalItems = await res.json();
+            console.log('✅ All Products:', finalItems, '\n');
+            console.log('🎉 REAL MONGODB CRUD CONTROLLER TESTS PASSED!');
+        }
+        catch (err) {
+            console.error('❌ Test failed:', err);
+        }
+        finally {
+            // Cleanup
+            server.close();
+            await mongoose.disconnect();
+            await mongod.stop();
+            process.exit(0);
+        }
+    });
+}
+runTest().catch(console.error);
+//# sourceMappingURL=real-test-mongoose.js.map

package/dist/real-test-mongoose.js.map

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

package/dist/realtime/camera.d.ts

@@ -0,0 +1,119 @@
+import { EventEmitter } from 'events';
+import { RealtimeCore } from './core';
+/**
+ * Supported camera frame codec types
+ */
+export type CameraCodec = 'MJPEG' | 'H264' | 'H265' | 'RAW_RGB' | 'RAW_YUV' | 'UNKNOWN';
+/**
+ * Parsed camera frame metadata
+ */
+export interface CameraFrame {
+    cameraId: string;
+    codec: CameraCodec;
+    width: number;
+    height: number;
+    timestamp: number;
+    frameIndex: number;
+    isKeyFrame: boolean;
+    data: Buffer;
+    sizeBytes: number;
+}
+/**
+ * Camera registration options
+ */
+export interface CameraOptions {
+    cameraId: string;
+    codec?: CameraCodec;
+    expectedWidth?: number;
+    expectedHeight?: number;
+    maxFps?: number;
+    recordingEnabled?: boolean;
+}
+/**
+ * Camera stats per camera
+ */
+interface CameraStats {
+    cameraId: string;
+    framesReceived: number;
+    bytesReceived: number;
+    fps: number;
+    lastFrameAt: number;
+    codec: CameraCodec;
+    width: number;
+    height: number;
+    isOnline: boolean;
+}
+/**
+ * CameraFrameModule — Direct binary camera frame handler for RealtimeCore
+ *
+ * Handles raw binary frames from IP cameras without needing FFmpeg.
+ * Supports MJPEG, H.264, H.265, RAW_RGB, RAW_YUV formats.
+ *
+ * Usage:
+ *   const cam = new CameraFrameModule(rt);
+ *   cam.registerCamera({ cameraId: 'cam1', codec: 'MJPEG' });
+ *   cam.ingestFrame('cam1', frameBuffer);
+ *   cam.subscribe('cam1', (frame) => { ... });
+ */
+export declare class CameraFrameModule extends EventEmitter {
+    private rt;
+    private cameras;
+    private frameCounters;
+    private fpsTrackers;
+    private offlineTimers;
+    private readonly OFFLINE_TIMEOUT_MS;
+    private readonly FPS_WINDOW_MS;
+    constructor(rt: RealtimeCore);
+    /**
+     * Register a camera before ingesting frames
+     */
+    registerCamera(opts: CameraOptions): void;
+    /**
+     * Ingest a raw binary frame from a camera.
+     * Auto-detects codec if not registered.
+     * Publishes to RealtimeCore topic: camera/<cameraId>/frame
+     */
+    ingestFrame(cameraId: string, rawBuffer: Buffer): CameraFrame | null;
+    /**
+     * Subscribe to frames from a specific camera
+     */
+    subscribe(cameraId: string, fn: (frame: CameraFrame) => void): void;
+    /**
+     * Subscribe to ALL cameras
+     */
+    subscribeAll(fn: (frame: CameraFrame) => void): void;
+    /**
+     * Unsubscribe from a camera
+     */
+    unsubscribe(cameraId: string, fn: (frame: CameraFrame) => void): void;
+    /**
+     * Get live stats for a camera
+     */
+    getStats(cameraId: string): CameraStats | undefined;
+    /**
+     * Get stats for all cameras
+     */
+    getAllStats(): CameraStats[];
+    /**
+     * List registered camera IDs
+     */
+    listCameras(): string[];
+    /**
+     * Mark a camera as offline manually
+     */
+    markOffline(cameraId: string): void;
+    /**
+     * Remove a camera from the module
+     */
+    removeCamera(cameraId: string): void;
+    /**
+     * Destroy the module and clean up
+     */
+    destroy(): void;
+    private _resetOfflineTimer;
+}
+/**
+ * Factory function
+ */
+export declare function createCameraModule(rt: RealtimeCore): CameraFrameModule;
+export {};