feat: cache runtime camera stream URL in FiveMClient

Add cameraStreamUrl property to FiveMClient that is populated from
the printer-reported CameraStreamUrl field in machine-info responses,
enabling OEM camera auto-detection without manual configuration.

- Add FiveMClient.cameraStreamUrl property (cleared on dispose)
- Populate from info.CameraStreamUrl in updateMachineInfo()
- Add test coverage in FiveMClient.test.ts and MachineInfo.test.ts
- Bump version to 1.2.0

Author: GhostTypes

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-03-08
+
+### Added
+
+- `FiveMClient.cameraStreamUrl` — caches the OEM camera stream URL reported by the printer in machine-info responses, cleared on dispose
+
+### Changed
+
+- `FiveMClient.updateMachineInfo()` now populates `cameraStreamUrl` from `info.CameraStreamUrl`
+
 ## [1.1.0] - 2026-03-08
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghosttypes/ff-api",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "FlashForge 3D Printer API for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

src/FiveMClient.test.ts

@@ -4,6 +4,7 @@
 
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { FiveMClient } from './FiveMClient';
+import type { FFMachineInfo } from './models/ff-models';
 
 const { flashForgeClientConstructor, axiosCreate } = vi.hoisted(() => ({
   flashForgeClientConstructor: vi.fn(),
@@ -51,4 +52,23 @@ describe('FiveMClient', () => {
     expect(client.getEndpoint('/detail')).toBe('http://192.168.1.10:19098/detail');
     expect(flashForgeClientConstructor).toHaveBeenCalledWith('192.168.1.10', { port: 19099 });
   });
+
+  it('caches the runtime OEM camera stream URL from machine info', () => {
+    const client = new FiveMClient('192.168.1.10', 'SN-1', 'CHK-1');
+    const machineInfo = {
+      Name: 'FlashForge 5M',
+      IsPro: false,
+      IsAD5X: false,
+      FirmwareVersion: '3.2.7',
+      CameraStreamUrl: 'http://192.168.1.10:8080/?action=stream',
+      MacAddress: 'AA:BB:CC:DD:EE:FF',
+      FlashCloudRegisterCode: '',
+      PolarCloudRegisterCode: '',
+      FormattedTotalRunTime: '0h:0m',
+      CumulativeFilament: 0,
+    } as FFMachineInfo;
+
+    expect(client.cacheDetails(machineInfo)).toBe(true);
+    expect(client.cameraStreamUrl).toBe('http://192.168.1.10:8080/?action=stream');
+  });
 });

src/FiveMClient.ts

@@ -59,6 +59,7 @@ export class FiveMClient {
   public isAD5X: boolean = false;
   public firmwareVersion: string = '';
   public firmVer: string = '';
+  public cameraStreamUrl: string = '';
 
   public ipAddress: string;
   public macAddress: string = '';
@@ -161,6 +162,7 @@ export class FiveMClient {
    * Disposes of the FiveMClient instance, stopping keep-alive messages and cleaning up resources.
    */
   public async dispose(): Promise<void> {
+    this.cameraStreamUrl = '';
     await this.tcpClient.dispose();
   }
 
@@ -178,6 +180,7 @@ export class FiveMClient {
     this.isAD5X = info.IsAD5X; // Cache the AD5X status
     this.firmwareVersion = info.FirmwareVersion || '';
     this.firmVer = info.FirmwareVersion ? info.FirmwareVersion.split('-')[0] : '';
+    this.cameraStreamUrl = info.CameraStreamUrl || '';
     this.macAddress = info.MacAddress || '';
     this.flashCloudCode = info.FlashCloudRegisterCode || '';
     this.polarCloudCode = info.PolarCloudRegisterCode || '';

src/models/MachineInfo.test.ts

@@ -127,6 +127,7 @@ describe('MachineInfo', () => {
       expect(result.IsAD5X).toBe(true);
       expect(result.IsPro).toBe(false); // As per our logic Name=AD5X implies IsPro=false
       expect(result.FirmwareVersion).toBe('1.1.3-1.0.8');
+      expect(result.CameraStreamUrl).toBe('');
 
       expect(result.HasMatlStation).toBe(true);
       expect(result.CoolingFanLeftSpeed).toBe(0);
@@ -185,6 +186,7 @@ describe('MachineInfo', () => {
       expect(result.IsAD5X).toBe(false);
       expect(result.IsPro).toBe(false); // "FlashForge 5M" does not contain "Pro"
       expect(result.FirmwareVersion).toBe('1.0.0');
+      expect(result.CameraStreamUrl).toBe('');
 
       expect(result.HasMatlStation).toBeUndefined();
       expect(result.MatlStationInfo).toBeUndefined();
@@ -230,10 +232,23 @@ describe('MachineInfo', () => {
       expect(result.IsAD5X).toBe(false);
       expect(result.IsPro).toBe(false);
       expect(result.FirmwareVersion).toBe(''); // Defaults to empty string
+      expect(result.CameraStreamUrl).toBe('');
       expect(result.CoolingFanSpeed).toBe(0); // Defaults to 0
       expect(result.PrintBed.current).toBe(0);
       expect(result.Extruder.set).toBe(0);
       expect(result.MachineState).toBe(MachineState.Unknown); // status is empty
     });
+
+    it('preserves a populated camera stream URL from detail data', () => {
+      const result = machineInfoConverter.fromDetail({
+        ...GENERIC_PRINTER_DETAIL_JSON,
+        cameraStreamUrl: 'http://192.168.1.100:8080/?action=stream',
+      });
+
+      expect(result).not.toBeNull();
+      if (!result) return;
+
+      expect(result.CameraStreamUrl).toBe('http://192.168.1.100:8080/?action=stream');
+    });
   });
 });