dolphin-server-modules 2.11.1 → 2.11.3

package/dist/realtime/camera.js

@@ -0,0 +1,299 @@
+import { EventEmitter } from 'events';
+/**
+ * Detect codec from raw binary frame buffer
+ */
+function detectCodec(buf) {
+    if (buf.length < 4)
+        return 'UNKNOWN';
+    // MJPEG: starts with FF D8 FF
+    if (buf[0] === 0xFF && buf[1] === 0xD8 && buf[2] === 0xFF) {
+        return 'MJPEG';
+    }
+    // H.264 NAL unit: starts with 00 00 00 01 or 00 00 01
+    if (buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x00 && buf[3] === 0x01) {
+        return 'H264';
+    }
+    if (buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x01) {
+        return 'H264';
+    }
+    // H.265 / HEVC: NAL unit type in byte 0 bits [1-6]
+    // HEVC starts with 00 00 00 01 as well but NAL type >= 32
+    if (buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x00 && buf[3] === 0x01) {
+        const nalType = (buf[4] >> 1) & 0x3F;
+        if (nalType >= 32)
+            return 'H265';
+        return 'H264';
+    }
+    // Raw RGB: heuristic — divisible by 3 (RGB triplets) and large enough
+    if (buf.length % 3 === 0 && buf.length > 1000) {
+        return 'RAW_RGB';
+    }
+    // Raw YUV: heuristic — divisible by 2 (YUV 4:2:2)
+    if (buf.length % 2 === 0 && buf.length > 1000) {
+        return 'RAW_YUV';
+    }
+    return 'UNKNOWN';
+}
+/**
+ * Detect if H.264 NAL unit is a keyframe (IDR frame)
+ */
+function isH264KeyFrame(buf) {
+    // Find NAL start code
+    let offset = 0;
+    if (buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x00 && buf[3] === 0x01) {
+        offset = 4;
+    }
+    else if (buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x01) {
+        offset = 3;
+    }
+    if (offset >= buf.length)
+        return false;
+    const nalType = buf[offset] & 0x1F;
+    return nalType === 5; // IDR = keyframe
+}
+/**
+ * Try to extract MJPEG resolution from JFIF/EXIF header
+ */
+function getMjpegResolution(buf) {
+    // Scan for SOF0 (FF C0) or SOF2 (FF C2) markers
+    for (let i = 0; i < Math.min(buf.length - 9, 512); i++) {
+        if (buf[i] === 0xFF && (buf[i + 1] === 0xC0 || buf[i + 1] === 0xC2)) {
+            const height = buf.readUInt16BE(i + 5);
+            const width = buf.readUInt16BE(i + 7);
+            if (width > 0 && height > 0)
+                return { width, height };
+        }
+    }
+    return { width: 0, height: 0 };
+}
+/**
+ * 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 class CameraFrameModule extends EventEmitter {
+    rt;
+    cameras = new Map();
+    frameCounters = new Map();
+    fpsTrackers = new Map();
+    offlineTimers = new Map();
+    OFFLINE_TIMEOUT_MS = 10000; // 10s no frame → offline
+    FPS_WINDOW_MS = 1000;
+    constructor(rt) {
+        super();
+        this.rt = rt;
+    }
+    /**
+     * Register a camera before ingesting frames
+     */
+    registerCamera(opts) {
+        const existing = this.cameras.get(opts.cameraId);
+        if (existing)
+            return; // already registered
+        this.cameras.set(opts.cameraId, {
+            ...opts,
+            codec: opts.codec || 'UNKNOWN',
+            framesReceived: 0,
+            bytesReceived: 0,
+            fps: 0,
+            lastFrameAt: 0,
+            width: opts.expectedWidth || 0,
+            height: opts.expectedHeight || 0,
+            isOnline: false,
+        });
+        this.frameCounters.set(opts.cameraId, 0);
+        this.fpsTrackers.set(opts.cameraId, { count: 0, windowStart: Date.now() });
+        this.emit('camera:registered', { cameraId: opts.cameraId });
+    }
+    /**
+     * Ingest a raw binary frame from a camera.
+     * Auto-detects codec if not registered.
+     * Publishes to RealtimeCore topic: camera/<cameraId>/frame
+     */
+    ingestFrame(cameraId, rawBuffer) {
+        if (!Buffer.isBuffer(rawBuffer) || rawBuffer.length === 0)
+            return null;
+        // Auto-register if not known
+        if (!this.cameras.has(cameraId)) {
+            this.registerCamera({ cameraId });
+        }
+        const cam = this.cameras.get(cameraId);
+        const now = Date.now();
+        // Detect codec from binary signature
+        const codec = cam.codec !== 'UNKNOWN' ? cam.codec : detectCodec(rawBuffer);
+        // Extract resolution
+        let width = cam.width;
+        let height = cam.height;
+        if ((width === 0 || height === 0) && codec === 'MJPEG') {
+            const res = getMjpegResolution(rawBuffer);
+            width = res.width || width;
+            height = res.height || height;
+        }
+        // Detect keyframe
+        let isKeyFrame = false;
+        if (codec === 'MJPEG')
+            isKeyFrame = true; // MJPEG = every frame is a keyframe
+        if (codec === 'H264')
+            isKeyFrame = isH264KeyFrame(rawBuffer);
+        // Increment counters
+        const frameIndex = (this.frameCounters.get(cameraId) || 0) + 1;
+        this.frameCounters.set(cameraId, frameIndex);
+        // Update FPS tracker
+        const tracker = this.fpsTrackers.get(cameraId);
+        tracker.count++;
+        const elapsed = now - tracker.windowStart;
+        if (elapsed >= this.FPS_WINDOW_MS) {
+            cam.fps = Math.round((tracker.count / elapsed) * 1000);
+            tracker.count = 0;
+            tracker.windowStart = now;
+        }
+        // Update stats
+        cam.codec = codec;
+        cam.width = width;
+        cam.height = height;
+        cam.framesReceived = frameIndex;
+        cam.bytesReceived += rawBuffer.length;
+        cam.lastFrameAt = now;
+        cam.isOnline = true;
+        // Build frame object
+        const frame = {
+            cameraId,
+            codec,
+            width,
+            height,
+            timestamp: now,
+            frameIndex,
+            isKeyFrame,
+            data: rawBuffer,
+            sizeBytes: rawBuffer.length,
+        };
+        // Publish to RealtimeCore — high frequency binary push
+        this.rt.pubPush(`camera/${cameraId}/frame`, rawBuffer);
+        // Also publish metadata separately for lightweight subscribers
+        this.rt.publish(`camera/${cameraId}/meta`, {
+            cameraId,
+            codec,
+            width,
+            height,
+            timestamp: now,
+            frameIndex,
+            isKeyFrame,
+            sizeBytes: rawBuffer.length,
+            fps: cam.fps,
+        });
+        // Emit locally
+        this.emit('frame', frame);
+        this.emit(`frame:${cameraId}`, frame);
+        // Reset offline timer
+        this._resetOfflineTimer(cameraId);
+        return frame;
+    }
+    /**
+     * Subscribe to frames from a specific camera
+     */
+    subscribe(cameraId, fn) {
+        this.on(`frame:${cameraId}`, fn);
+    }
+    /**
+     * Subscribe to ALL cameras
+     */
+    subscribeAll(fn) {
+        this.on('frame', fn);
+    }
+    /**
+     * Unsubscribe from a camera
+     */
+    unsubscribe(cameraId, fn) {
+        this.off(`frame:${cameraId}`, fn);
+    }
+    /**
+     * Get live stats for a camera
+     */
+    getStats(cameraId) {
+        const cam = this.cameras.get(cameraId);
+        if (!cam)
+            return undefined;
+        return {
+            cameraId: cam.cameraId,
+            framesReceived: cam.framesReceived,
+            bytesReceived: cam.bytesReceived,
+            fps: cam.fps,
+            lastFrameAt: cam.lastFrameAt,
+            codec: cam.codec,
+            width: cam.width,
+            height: cam.height,
+            isOnline: cam.isOnline,
+        };
+    }
+    /**
+     * Get stats for all cameras
+     */
+    getAllStats() {
+        return Array.from(this.cameras.keys()).map(id => this.getStats(id));
+    }
+    /**
+     * List registered camera IDs
+     */
+    listCameras() {
+        return Array.from(this.cameras.keys());
+    }
+    /**
+     * Mark a camera as offline manually
+     */
+    markOffline(cameraId) {
+        const cam = this.cameras.get(cameraId);
+        if (cam) {
+            cam.isOnline = false;
+            this.emit('camera:offline', { cameraId });
+            this.rt.publish(`camera/${cameraId}/status`, { cameraId, status: 'offline', timestamp: Date.now() });
+        }
+    }
+    /**
+     * Remove a camera from the module
+     */
+    removeCamera(cameraId) {
+        this.cameras.delete(cameraId);
+        this.frameCounters.delete(cameraId);
+        this.fpsTrackers.delete(cameraId);
+        const timer = this.offlineTimers.get(cameraId);
+        if (timer)
+            clearTimeout(timer);
+        this.offlineTimers.delete(cameraId);
+        this.emit('camera:removed', { cameraId });
+    }
+    /**
+     * Destroy the module and clean up
+     */
+    destroy() {
+        for (const timer of this.offlineTimers.values())
+            clearTimeout(timer);
+        this.offlineTimers.clear();
+        this.cameras.clear();
+        this.frameCounters.clear();
+        this.fpsTrackers.clear();
+        this.removeAllListeners();
+    }
+    _resetOfflineTimer(cameraId) {
+        const existing = this.offlineTimers.get(cameraId);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.markOffline(cameraId);
+        }, this.OFFLINE_TIMEOUT_MS);
+        this.offlineTimers.set(cameraId, timer);
+    }
+}
+/**
+ * Factory function
+ */
+export function createCameraModule(rt) {
+    return new CameraFrameModule(rt);
+}
+//# sourceMappingURL=camera.js.map

package/dist/realtime/camera.js.map

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

package/dist/realtime/camera.test.d.ts

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

package/dist/realtime/camera.test.js

@@ -0,0 +1,345 @@
+/// <reference types="jest" />
+import { RealtimeCore } from './core';
+import { createCameraModule } from './camera';
+// ============================================
+// Helper: MJPEG frame बनाउने (FF D8 FF signature)
+// ============================================
+function makeMjpegFrame(width = 640, height = 480) {
+    // Minimal MJPEG: SOI + SOF0 marker with resolution
+    const buf = Buffer.alloc(64, 0x00);
+    // SOI marker
+    buf[0] = 0xFF;
+    buf[1] = 0xD8;
+    // APP0 marker
+    buf[2] = 0xFF;
+    buf[3] = 0xE0;
+    // SOF0 marker at offset 20
+    buf[20] = 0xFF;
+    buf[21] = 0xC0;
+    buf[22] = 0x00;
+    buf[23] = 0x11; // length
+    buf[24] = 0x08; // precision
+    buf.writeUInt16BE(height, 25);
+    buf.writeUInt16BE(width, 27);
+    return buf;
+}
+// ============================================
+// Helper: H.264 IDR keyframe बनाउने
+// ============================================
+function makeH264KeyFrame() {
+    const buf = Buffer.alloc(16, 0x00);
+    // NAL start code
+    buf[0] = 0x00;
+    buf[1] = 0x00;
+    buf[2] = 0x00;
+    buf[3] = 0x01;
+    // NAL type = 5 (IDR = keyframe)
+    buf[4] = 0x65;
+    return buf;
+}
+// ============================================
+// Helper: H.264 P-frame (non-keyframe) बनाउने
+// ============================================
+function makeH264PFrame() {
+    const buf = Buffer.alloc(16, 0x00);
+    buf[0] = 0x00;
+    buf[1] = 0x00;
+    buf[2] = 0x00;
+    buf[3] = 0x01;
+    // NAL type = 1 (non-IDR = P-frame)
+    buf[4] = 0x41;
+    return buf;
+}
+// ============================================
+// Helper: Unknown/raw frame
+// ============================================
+function makeRawFrame(size = 2048) {
+    return Buffer.alloc(size, 0xAB);
+}
+describe('CameraFrameModule', () => {
+    let rt;
+    let cam;
+    let instances = [];
+    beforeEach(() => {
+        rt = new RealtimeCore({ debug: false, maxBufferPerTopic: 200 });
+        cam = createCameraModule(rt);
+        instances.push(rt);
+    });
+    afterEach(async () => {
+        cam.destroy();
+        for (const instance of instances) {
+            await instance.destroy();
+        }
+        instances = [];
+    });
+    // ============================================
+    // Camera Registration Tests
+    // ============================================
+    describe('Camera Registration', () => {
+        it('should register a camera', () => {
+            cam.registerCamera({ cameraId: 'cam1', codec: 'MJPEG' });
+            expect(cam.listCameras()).toContain('cam1');
+        });
+        it('should auto-register camera on first frame', () => {
+            const frame = makeMjpegFrame();
+            cam.ingestFrame('cam-auto', frame);
+            expect(cam.listCameras()).toContain('cam-auto');
+        });
+        it('should not duplicate register same camera', () => {
+            cam.registerCamera({ cameraId: 'cam1' });
+            cam.registerCamera({ cameraId: 'cam1' });
+            expect(cam.listCameras().filter(id => id === 'cam1').length).toBe(1);
+        });
+        it('should remove a camera', () => {
+            cam.registerCamera({ cameraId: 'cam1' });
+            cam.removeCamera('cam1');
+            expect(cam.listCameras()).not.toContain('cam1');
+        });
+    });
+    // ============================================
+    // Codec Detection Tests
+    // ============================================
+    describe('Codec Detection', () => {
+        it('should detect MJPEG codec from FF D8 FF signature', () => {
+            const frame = makeMjpegFrame();
+            const result = cam.ingestFrame('cam-mjpeg', frame);
+            expect(result).not.toBeNull();
+            expect(result?.codec).toBe('MJPEG');
+        });
+        it('should detect H.264 codec from NAL start code 00 00 00 01', () => {
+            const frame = makeH264KeyFrame();
+            const result = cam.ingestFrame('cam-h264', frame);
+            expect(result?.codec).toBe('H264');
+        });
+        it('should detect H.264 P-frame', () => {
+            const frame = makeH264PFrame();
+            const result = cam.ingestFrame('cam-h264-p', frame);
+            expect(result?.codec).toBe('H264');
+        });
+        it('should return UNKNOWN for unrecognized binary', () => {
+            const buf = Buffer.from([0x01, 0x02, 0x03, 0x04, 0x05]);
+            const result = cam.ingestFrame('cam-unknown', buf);
+            expect(result?.codec).toBe('UNKNOWN');
+        });
+    });
+    // ============================================
+    // Keyframe Detection Tests
+    // ============================================
+    describe('Keyframe Detection', () => {
+        it('should mark MJPEG as keyframe (every frame)', () => {
+            const frame = makeMjpegFrame();
+            const result = cam.ingestFrame('cam1', frame);
+            expect(result?.isKeyFrame).toBe(true);
+        });
+        it('should mark H.264 IDR (NAL type 5) as keyframe', () => {
+            const frame = makeH264KeyFrame();
+            const result = cam.ingestFrame('cam1', frame);
+            expect(result?.isKeyFrame).toBe(true);
+        });
+        it('should mark H.264 P-frame (NAL type 1) as non-keyframe', () => {
+            const frame = makeH264PFrame();
+            const result = cam.ingestFrame('cam1', frame);
+            expect(result?.isKeyFrame).toBe(false);
+        });
+    });
+    // ============================================
+    // Resolution Detection Tests
+    // ============================================
+    describe('Resolution Detection', () => {
+        it('should extract resolution from MJPEG SOF0 header', () => {
+            const frame = makeMjpegFrame(1280, 720);
+            const result = cam.ingestFrame('cam-res', frame);
+            expect(result?.width).toBe(1280);
+            expect(result?.height).toBe(720);
+        });
+        it('should use expectedWidth/Height if provided', () => {
+            cam.registerCamera({ cameraId: 'cam-preset', expectedWidth: 1920, expectedHeight: 1080 });
+            const frame = makeRawFrame();
+            const result = cam.ingestFrame('cam-preset', frame);
+            expect(result?.width).toBe(1920);
+            expect(result?.height).toBe(1080);
+        });
+    });
+    // ============================================
+    // Frame Ingestion Tests
+    // ============================================
+    describe('Frame Ingestion', () => {
+        it('should return null for empty buffer', () => {
+            const result = cam.ingestFrame('cam1', Buffer.alloc(0));
+            expect(result).toBeNull();
+        });
+        it('should return null for non-buffer input', () => {
+            const result = cam.ingestFrame('cam1', null);
+            expect(result).toBeNull();
+        });
+        it('should increment frame index on each ingest', () => {
+            const frame = makeMjpegFrame();
+            const r1 = cam.ingestFrame('cam1', frame);
+            const r2 = cam.ingestFrame('cam1', frame);
+            const r3 = cam.ingestFrame('cam1', frame);
+            expect(r1?.frameIndex).toBe(1);
+            expect(r2?.frameIndex).toBe(2);
+            expect(r3?.frameIndex).toBe(3);
+        });
+        it('should include correct timestamp', () => {
+            const before = Date.now();
+            const result = cam.ingestFrame('cam1', makeMjpegFrame());
+            const after = Date.now();
+            expect(result?.timestamp).toBeGreaterThanOrEqual(before);
+            expect(result?.timestamp).toBeLessThanOrEqual(after);
+        });
+        it('should include correct sizeBytes', () => {
+            const frame = makeMjpegFrame();
+            const result = cam.ingestFrame('cam1', frame);
+            expect(result?.sizeBytes).toBe(frame.length);
+        });
+    });
+    // ============================================
+    // Subscription Tests
+    // ============================================
+    describe('Subscriptions', () => {
+        it('should receive frame via subscribe()', (done) => {
+            cam.subscribe('cam1', (frame) => {
+                expect(frame.cameraId).toBe('cam1');
+                expect(frame.codec).toBe('MJPEG');
+                done();
+            });
+            cam.ingestFrame('cam1', makeMjpegFrame());
+        });
+        it('should receive ALL camera frames via subscribeAll()', (done) => {
+            const received = [];
+            cam.subscribeAll((frame) => {
+                received.push(frame.cameraId);
+                if (received.length === 2) {
+                    expect(received).toContain('cam1');
+                    expect(received).toContain('cam2');
+                    done();
+                }
+            });
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam2', makeH264KeyFrame());
+        });
+        it('should unsubscribe correctly', () => {
+            const fn = jest.fn();
+            cam.subscribe('cam1', fn);
+            cam.unsubscribe('cam1', fn);
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            expect(fn).not.toHaveBeenCalled();
+        });
+        it('should publish frame to RealtimeCore topic camera/<id>/frame', () => {
+            const rtFn = jest.fn();
+            rt.subscribe('camera/cam1/frame', rtFn);
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            expect(rtFn).toHaveBeenCalledTimes(1);
+        });
+        it('should publish metadata to camera/<id>/meta topic', (done) => {
+            rt.subscribe('camera/cam1/meta', (meta) => {
+                expect(meta.cameraId).toBe('cam1');
+                expect(meta.codec).toBe('MJPEG');
+                expect(meta.frameIndex).toBe(1);
+                expect(meta).toHaveProperty('fps');
+                done();
+            });
+            cam.ingestFrame('cam1', makeMjpegFrame());
+        });
+        it('should support wildcard subscription for all cameras via RealtimeCore', () => {
+            const fn = jest.fn();
+            rt.subscribe('camera/+/meta', fn);
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam2', makeH264KeyFrame());
+            expect(fn).toHaveBeenCalledTimes(2);
+        });
+    });
+    // ============================================
+    // Stats Tests
+    // ============================================
+    describe('Camera Stats', () => {
+        it('should track framesReceived count', () => {
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            const stats = cam.getStats('cam1');
+            expect(stats?.framesReceived).toBe(3);
+        });
+        it('should track bytesReceived', () => {
+            const frame = makeMjpegFrame();
+            cam.ingestFrame('cam1', frame);
+            cam.ingestFrame('cam1', frame);
+            const stats = cam.getStats('cam1');
+            expect(stats?.bytesReceived).toBe(frame.length * 2);
+        });
+        it('should mark camera as online after frame', () => {
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            expect(cam.getStats('cam1')?.isOnline).toBe(true);
+        });
+        it('should return undefined stats for unknown camera', () => {
+            expect(cam.getStats('non-existent')).toBeUndefined();
+        });
+        it('should return all cameras stats', () => {
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam2', makeH264KeyFrame());
+            const allStats = cam.getAllStats();
+            expect(allStats.length).toBe(2);
+            expect(allStats.map(s => s.cameraId)).toContain('cam1');
+            expect(allStats.map(s => s.cameraId)).toContain('cam2');
+        });
+    });
+    // ============================================
+    // Offline Detection Tests
+    // ============================================
+    describe('Offline Detection', () => {
+        it('should emit camera:offline when markOffline() called', (done) => {
+            cam.registerCamera({ cameraId: 'cam1' });
+            cam.on('camera:offline', ({ cameraId }) => {
+                expect(cameraId).toBe('cam1');
+                done();
+            });
+            cam.markOffline('cam1');
+        });
+        it('should set isOnline=false after markOffline()', () => {
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.markOffline('cam1');
+            expect(cam.getStats('cam1')?.isOnline).toBe(false);
+        });
+    });
+    // ============================================
+    // Multi-Camera Tests
+    // ============================================
+    describe('Multi-Camera Handling', () => {
+        it('should handle 10 cameras simultaneously', () => {
+            const results = [];
+            for (let i = 1; i <= 10; i++) {
+                const frame = i % 2 === 0 ? makeMjpegFrame() : makeH264KeyFrame();
+                results.push(cam.ingestFrame(`cam${i}`, frame));
+            }
+            expect(cam.listCameras().length).toBe(10);
+            expect(results.every(r => r !== null)).toBe(true);
+        });
+        it('should keep frame counters independent per camera', () => {
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.ingestFrame('cam2', makeH264KeyFrame());
+            expect(cam.getStats('cam1')?.framesReceived).toBe(2);
+            expect(cam.getStats('cam2')?.framesReceived).toBe(1);
+        });
+        it('should emit camera:registered event', (done) => {
+            cam.on('camera:registered', ({ cameraId }) => {
+                expect(cameraId).toBe('cam-new');
+                done();
+            });
+            cam.registerCamera({ cameraId: 'cam-new' });
+        });
+    });
+    // ============================================
+    // Destroy / Cleanup Tests
+    // ============================================
+    describe('Cleanup', () => {
+        it('should clear all state on destroy()', () => {
+            cam.registerCamera({ cameraId: 'cam1' });
+            cam.ingestFrame('cam1', makeMjpegFrame());
+            cam.destroy();
+            expect(cam.listCameras().length).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=camera.test.js.map