@samlab-corp/sfm-node 0.1.0

package/dist/commands/firmware.js

@@ -0,0 +1,152 @@
+/**
+ * Firmware upgrade commands
+ */
+import fs from "node:fs";
+import { SFM_CMD } from "../constants";
+import { calcChecksum16 } from "../core/packet";
+const FW_HANDSHAKE = {
+    PING: 0x31,
+    UPGRADE_CONFIRM: 0x75,
+};
+const FIRMWARE_MAGIC = 0x1f2f3f4f;
+const FIRMWARE_CHUNK_SIZE = 0x1000;
+const HANDSHAKE_TIMEOUT_MS = 5000;
+const DOWNLOAD_TIMEOUT_MS = 1000;
+const COMPLETION_TIMEOUT_MS = 12000;
+const HANDSHAKE_RETRY_DELAY_MS = 10;
+export class FirmwareCommands {
+    constructor(client) {
+        this.client = client;
+        this.data = null;
+    }
+    /** @internal Set DataCommands reference (avoid circular dependency) */
+    _setDataCommands(data) {
+        this.data = data;
+    }
+    /**
+     * Load firmware file and build packet
+     */
+    loadFirmware(filePath) {
+        const data = fs.readFileSync(filePath);
+        const totalLen = data.length + 6;
+        const packet = Buffer.alloc(totalLen);
+        packet.writeUInt32LE(totalLen, 0);
+        data.copy(packet, 4);
+        const checksum = calcChecksum16(data);
+        packet.writeUInt16LE(checksum, 4 + data.length);
+        return { data, packet, totalLen, checksum };
+    }
+    /**
+     * Firmware upgrade (serial direct handshake)
+     */
+    async upgrade(filePath, { onProgress, onStatus } = {}) {
+        if (!filePath) {
+            throw new Error("filePath is required");
+        }
+        const progress = onProgress || (() => { });
+        const status = onStatus || (() => { });
+        const fw = this.loadFirmware(filePath);
+        status(`Firmware loaded: ${filePath} (${fw.data.length} bytes)`);
+        status("=== Firmware upgrade started ===");
+        status("Handshake started...");
+        const handshakeOk = await this._handshake(this.client.serial, status);
+        if (!handshakeOk) {
+            throw new Error("Handshake failed: no device response");
+        }
+        status("Sending upgrade confirm...");
+        await this.client.serial.write(Buffer.from([FW_HANDSHAKE.UPGRADE_CONFIRM]));
+        status('Waiting for "download" response...');
+        try {
+            await this.client.serial.readUntil("download", DOWNLOAD_TIMEOUT_MS);
+        }
+        catch {
+            throw new Error('No "download" response from device');
+        }
+        await this.client.serial.write(Buffer.alloc(0));
+        status(`Firmware transfer started: ${fw.totalLen} bytes`);
+        let sent = 0;
+        while (sent < fw.totalLen) {
+            const chunkSize = Math.min(FIRMWARE_CHUNK_SIZE, fw.totalLen - sent);
+            const chunk = fw.packet.subarray(sent, sent + chunkSize);
+            await this.client.serial.write(chunk);
+            sent += chunkSize;
+            const percent = Math.floor((sent * 100) / fw.totalLen);
+            progress(percent, sent, fw.totalLen);
+            status(`Written ${sent}/${fw.totalLen} bytes (${percent}%)`);
+        }
+        status('Waiting for "Started" response...');
+        try {
+            await this.client.serial.readUntil("Started", COMPLETION_TIMEOUT_MS);
+            status("Firmware apply started!");
+        }
+        catch {
+            status('Warning: "Started" response timeout (device may be rebooting)');
+        }
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        status("=== Firmware upgrade complete ===");
+    }
+    /**
+     * Protocol-level firmware upgrade (SFM packet protocol)
+     */
+    async upgradeViaProtocol(filePath, chunkSize = 0x4000, { onProgress, onStatus } = {}) {
+        if (!filePath) {
+            throw new Error("filePath is required");
+        }
+        if (!this.data) {
+            throw new Error("DataCommands not initialized");
+        }
+        const progress = onProgress || (() => { });
+        const status = onStatus || (() => { });
+        const data = fs.readFileSync(filePath);
+        status(`Firmware loaded: ${filePath} (${data.length} bytes)`);
+        if (data.length >= 4) {
+            const magic = data.readUInt32LE(0);
+            if (magic !== FIRMWARE_MAGIC) {
+                status(`Warning: firmware magic mismatch (got=0x${magic.toString(16)}, expected=0x${FIRMWARE_MAGIC.toString(16)})`);
+            }
+        }
+        status("Checking system status...");
+        const statusResponse = await this.client.sendCommand(SFM_CMD.SS, 0, 0, 0);
+        if (!statusResponse.valid) {
+            throw new Error(`Status check failed: ${statusResponse.error}`);
+        }
+        status("System status OK");
+        status("Saving database...");
+        const saveResponse = await this.client.sendCommand(SFM_CMD.SDB, 0, 0, 0);
+        if (!saveResponse.valid) {
+            throw new Error(`Database save failed before firmware upgrade: ${saveResponse.error || "unknown error"}`);
+        }
+        status(`Firmware data transfer started: ${data.length} bytes`);
+        await this.data.send(SFM_CMD.SDB, data, chunkSize, {
+            onProgress: (idx, total) => {
+                const percent = Math.floor(((idx + 1) * 100) / total);
+                progress(percent, idx + 1, total);
+                status(`Transfer ${idx + 1}/${total} (${percent}%)`);
+            },
+        });
+        status("Module reset...");
+        await this.client.sendCommand(SFM_CMD.RS, 0, 0, 0);
+        status("Waiting for firmware apply...");
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        status("=== Protocol-level firmware upgrade complete ===");
+    }
+    async _handshake(serial, status) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < HANDSHAKE_TIMEOUT_MS) {
+            await serial.write(Buffer.from([FW_HANDSHAKE.PING]));
+            try {
+                const response = await serial.readByte(100);
+                if (response === FW_HANDSHAKE.PING) {
+                    status("Handshake success!");
+                    return true;
+                }
+            }
+            catch {
+                // timeout, retry
+            }
+            await new Promise((resolve) => setTimeout(resolve, HANDSHAKE_RETRY_DELAY_MS));
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=firmware.js.map

package/dist/commands/firmware.js.map

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

package/dist/commands/freescan.d.ts

@@ -0,0 +1,68 @@
+/**
+ * FreeScan commands - automatic fingerprint recognition mode
+ *
+ * In FreeScan mode, the device automatically scans fingerprints
+ * and sends IS(0x11) response packets.
+ */
+import type { SfmClient } from "../core";
+import type { SystemCommands } from "./system";
+export interface FreeScanResult {
+    success: boolean;
+    userId?: number;
+    flag?: number;
+}
+export type FreeScanCallback = (result: FreeScanResult) => void;
+export type FreeScanDataHandler = (data: Buffer) => void;
+export type FreeScanErrorHandler = (error?: Error) => void;
+export declare class FreeScanCommands {
+    private client;
+    private system;
+    private running;
+    private dataHandler;
+    private errorHandler;
+    private buffer;
+    private callback;
+    private logFn;
+    private externalDataHandler;
+    private externalErrorHandler;
+    constructor(client: SfmClient);
+    /** @internal Set SystemCommands reference */
+    _setSystemCommands(system: SystemCommands): void;
+    get isRunning(): boolean;
+    /** Register an external data handler (can be swapped at any time) */
+    onDataHandler(handler: FreeScanDataHandler): void;
+    /** Remove the external data handler */
+    offDataHandler(): void;
+    /** Register an external error handler (can be swapped at any time) */
+    onErrorHandler(handler: FreeScanErrorHandler): void;
+    /** Remove the external error handler */
+    offErrorHandler(): void;
+    /** Clean up internal state (remove listeners, reset flags) */
+    private cleanup;
+    /**
+     * Check if device FreeScan parameter (0x84) is active
+     */
+    isDeviceFreeScanActive(): Promise<boolean>;
+    /**
+     * Start FreeScan
+     * @param onResult identification result callback
+     * @param onLog log callback (optional)
+     */
+    start(onResult: FreeScanCallback, onLog?: (msg: string) => void): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Stop FreeScan
+     */
+    stop(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Serial data event handler
+     * Parses 13-byte packets and processes IS(0x11) responses
+     */
+    private handleData;
+}
+//# sourceMappingURL=freescan.d.ts.map

package/dist/commands/freescan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freescan.d.ts","sourceRoot":"","sources":["../../src/commands/freescan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;AAE3D,qBAAa,gBAAgB;IAWf,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,oBAAoB,CAAqC;gBAE7C,MAAM,EAAE,SAAS;IAErC,6CAA6C;IAC7C,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIhD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qEAAqE;IACrE,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIjD,uCAAuC;IACvC,cAAc,IAAI,IAAI;IAItB,sEAAsE;IACtE,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAInD,wCAAwC;IACxC,eAAe,IAAI,IAAI;IAIvB,8DAA8D;IAC9D,OAAO,CAAC,OAAO;IAsBf;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC;IAOhD;;;;OAIG;IACG,KAAK,CACT,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA2DjD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB5D;;;OAGG;IACH,OAAO,CAAC,UAAU;CAiDnB"}

package/dist/commands/freescan.js

@@ -0,0 +1,202 @@
+/**
+ * FreeScan commands - automatic fingerprint recognition mode
+ *
+ * In FreeScan mode, the device automatically scans fingerprints
+ * and sends IS(0x11) response packets.
+ */
+import { SFM_ERROR, SFM_CMD, SFM_PARAM, START_CODE, PACKET_SIZE } from "../constants";
+import { parseNormalPacket } from "../core";
+export class FreeScanCommands {
+    constructor(client) {
+        this.client = client;
+        this.system = null;
+        this.running = false;
+        this.dataHandler = null;
+        this.errorHandler = null;
+        this.buffer = Buffer.alloc(0);
+        this.callback = null;
+        this.logFn = null;
+        this.externalDataHandler = null;
+        this.externalErrorHandler = null;
+    }
+    /** @internal Set SystemCommands reference */
+    _setSystemCommands(system) {
+        this.system = system;
+    }
+    get isRunning() {
+        return this.running;
+    }
+    /** Register an external data handler (can be swapped at any time) */
+    onDataHandler(handler) {
+        this.externalDataHandler = handler;
+    }
+    /** Remove the external data handler */
+    offDataHandler() {
+        this.externalDataHandler = null;
+    }
+    /** Register an external error handler (can be swapped at any time) */
+    onErrorHandler(handler) {
+        this.externalErrorHandler = handler;
+    }
+    /** Remove the external error handler */
+    offErrorHandler() {
+        this.externalErrorHandler = null;
+    }
+    /** Clean up internal state (remove listeners, reset flags) */
+    cleanup() {
+        try {
+            if (this.client.serial?.port) {
+                if (this.dataHandler) {
+                    this.client.serial.port.removeListener("data", this.dataHandler);
+                }
+                if (this.errorHandler) {
+                    this.client.serial.port.removeListener("error", this.errorHandler);
+                    this.client.serial.port.removeListener("close", this.errorHandler);
+                }
+            }
+        }
+        catch {
+            // Port may already be destroyed; ignore listener removal errors
+        }
+        this.dataHandler = null;
+        this.errorHandler = null;
+        this.running = false;
+        this.buffer = Buffer.alloc(0);
+        this.callback = null;
+        this.logFn = null;
+    }
+    /**
+     * Check if device FreeScan parameter (0x84) is active
+     */
+    async isDeviceFreeScanActive() {
+        if (!this.system)
+            throw new Error("SystemCommands not initialized");
+        const result = await this.system.getParam("FREE_SCAN");
+        const FREE_SCAN_ON = SFM_PARAM.FREE_SCAN.options.find((o) => o.alias === "ON").value;
+        return result.value === FREE_SCAN_ON;
+    }
+    /**
+     * Start FreeScan
+     * @param onResult identification result callback
+     * @param onLog log callback (optional)
+     */
+    async start(onResult, onLog) {
+        if (!this.system)
+            throw new Error("SystemCommands not initialized");
+        // If running flag is true but device is OFF (stale state) -> cleanup
+        if (this.running) {
+            const deviceActive = await this.isDeviceFreeScanActive();
+            if (!deviceActive) {
+                onLog?.("[FreeScan] Stale state detected — cleaning up and restarting");
+                this.cleanup();
+            }
+            else {
+                return { success: false, message: "Already running" };
+            }
+        }
+        const log = (msg) => {
+            onLog?.(msg);
+        };
+        this.logFn = log;
+        this.callback = onResult;
+        log("[FreeScan] Enabling Auto Response...");
+        const arResult = await this.system.setParam("AUTO_RESPONSE", "HOST");
+        if (!arResult.success) {
+            log(`[FreeScan] Auto Response setup failed: ${JSON.stringify(arResult)}`);
+            return { success: false, message: "Auto Response setup failed" };
+        }
+        log("[FreeScan] Enabling FreeScan...");
+        const fsResult = await this.system.setParam("FREE_SCAN", "ON");
+        if (!fsResult.success) {
+            log(`[FreeScan] Enable failed: ${JSON.stringify(fsResult)}`);
+            return { success: false, message: "FreeScan setup failed" };
+        }
+        if (!this.client.serial?.port) {
+            return { success: false, message: "Serial port not connected" };
+        }
+        this.running = true;
+        this.buffer = Buffer.alloc(0);
+        // Serial port event listening
+        this.dataHandler = (data) => {
+            this.externalDataHandler?.(data);
+            this.handleData(data);
+        };
+        this.errorHandler = (err) => {
+            this.logFn?.("[FreeScan] Port error/close detected — auto cleanup");
+            this.externalErrorHandler?.(err);
+            this.cleanup();
+        };
+        this.client.serial.port.on("data", this.dataHandler);
+        this.client.serial.port.on("error", this.errorHandler);
+        this.client.serial.port.on("close", this.errorHandler);
+        log("[FreeScan] FreeScan ON — serial data event listening started");
+        return { success: true, message: "FreeScan enabled" };
+    }
+    /**
+     * Stop FreeScan
+     */
+    async stop() {
+        if (!this.system)
+            throw new Error("SystemCommands not initialized");
+        const log = this.logFn || (() => { });
+        log("[FreeScan] Disabling FreeScan...");
+        await this.system.setParam("FREE_SCAN", "OFF");
+        log("[FreeScan] Disabling Auto Response...");
+        await this.system.setParam("AUTO_RESPONSE", "OFF");
+        this.cleanup();
+        log("[FreeScan] FreeScan OFF");
+        return { success: true, message: "FreeScan disabled" };
+    }
+    /**
+     * Serial data event handler
+     * Parses 13-byte packets and processes IS(0x11) responses
+     */
+    handleData(data) {
+        try {
+            const hex = Buffer.from(data).toString("hex").match(/../g)?.join(" ") || "";
+            this.logFn?.(`[FreeScan RX] +${data.length}B | ${hex}`);
+            this.buffer = Buffer.concat([this.buffer, data]);
+            while (this.buffer.length >= PACKET_SIZE.NORMAL) {
+                const startIdx = this.buffer.indexOf(START_CODE.NORMAL);
+                if (startIdx === -1) {
+                    this.buffer = Buffer.alloc(0);
+                    break;
+                }
+                if (startIdx > 0) {
+                    this.buffer = this.buffer.subarray(startIdx);
+                }
+                if (this.buffer.length < PACKET_SIZE.NORMAL)
+                    break;
+                const packet = this.buffer.subarray(0, PACKET_SIZE.NORMAL);
+                this.buffer = this.buffer.subarray(PACKET_SIZE.NORMAL);
+                const parsed = parseNormalPacket(packet);
+                if (!parsed.valid)
+                    continue;
+                // IS response handling
+                if (parsed.command === SFM_CMD.IS) {
+                    const flag = parsed.flag;
+                    const userId = parsed.param;
+                    if (flag === SFM_ERROR.SUCCESS) {
+                        this.logFn?.(`[FreeScan] Identified! UserID: ${userId}`);
+                        this.callback?.({ success: true, userId });
+                    }
+                    else if (flag === SFM_ERROR.NOT_FOUND) {
+                        this.logFn?.("[FreeScan] Unregistered fingerprint");
+                        this.callback?.({ success: false, flag });
+                    }
+                    else if (flag === SFM_ERROR.SCAN_SUCCESS) {
+                        this.logFn?.("[FreeScan] Fingerprint scanned, matching...");
+                    }
+                    else {
+                        this.logFn?.(`[FreeScan] Unknown response: flag=0x${flag?.toString(16) ?? "??"}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            this.logFn?.(`[FreeScan] Data processing error: ${err.message}`);
+            this.externalErrorHandler?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+}
+//# sourceMappingURL=freescan.js.map

package/dist/commands/freescan.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * SfmCommands - Unified command class (composition)
+ *
+ * Usage:
+ *   const finger = new SfmCommands({ baudRate: 115200 });
+ *   await finger.connect('/dev/ttyUSB0');
+ *
+ *   await finger.fingerprint.enroll(userId);
+ *   await finger.fingerprint.verify(userId);
+ *   await finger.fingerprint.identify();
+ *
+ *   await finger.system.getParam(0x01);
+ *   await finger.system.reset();
+ *   await finger.system.selfTest();
+ *
+ *   await finger.data.send(cmd, buf);
+ *   await finger.data.recv(cmd, size);
+ *
+ *   await finger.firmware.upgrade(filePath);
+ *
+ *   await finger.disconnect();
+ */
+import type { SfmClientOptions, SerialPortInfo } from "../core";
+import type { EncryptionMode } from "../constants";
+import { FingerprintCommands } from "./fingerprint";
+import { SystemCommands } from "./system";
+import { DataCommands } from "./data";
+import { FirmwareCommands } from "./firmware";
+import { FreeScanCommands } from "./freescan";
+export declare class SfmCommands {
+    private readonly client;
+    readonly fingerprint: FingerprintCommands;
+    readonly system: SystemCommands;
+    readonly data: DataCommands;
+    readonly firmware: FirmwareCommands;
+    readonly freeScan: FreeScanCommands;
+    constructor(options?: SfmClientOptions);
+    /**
+     * Create instance and connect to device
+     */
+    static create(options: SfmClientOptions & {
+        portPath: string;
+    }): Promise<SfmCommands>;
+    /**
+     * List available serial ports
+     */
+    static listPorts(): Promise<SerialPortInfo[]>;
+    /**
+     * Connect to device
+     */
+    connect(portPath?: string): Promise<void>;
+    /**
+     * Disconnect from device
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Switch secure mode
+     */
+    setSecureMode(enabled: boolean, options?: {
+        key?: Buffer | string;
+        iv?: Buffer | string;
+        secureCode?: Buffer | string;
+        mode?: EncryptionMode;
+    }): void;
+    /**
+     * Switch network protocol mode (RS422/485)
+     */
+    setNetworkMode(enabled: boolean, terminalId?: number): void;
+    /** Set disconnect callback */
+    setOnDisconnect(callback: ((error?: Error) => void) | null): void;
+    /** Set auto-reconnect options */
+    setAutoReconnect(options: import("../core/serial").AutoReconnectOptions | null): void;
+    /** Set auto-reconnect callbacks only */
+    setAutoReconnectCallbacks(callbacks: import("../core/serial").AutoReconnectCallbacks): void;
+    /** Whether reconnection is in progress */
+    get isReconnecting(): boolean;
+}
+export { FingerprintCommands } from "./fingerprint";
+export { SystemCommands } from "./system";
+export { DataCommands, calcEvenOddChecksum } from "./data";
+export { FirmwareCommands } from "./firmware";
+export { FreeScanCommands } from "./freescan";
+export type { EnrollResult, VerifyResult, IdentifyResult, CommandResult, ListUserIdsResult, CaptureImageResult, } from "./fingerprint";
+export type { SystemStatusResult, ParamResult, SelfTestResult } from "./system";
+export type { MultiPacketOptions } from "./data";
+export type { FirmwareOptions } from "./firmware";
+export type { FreeScanResult, FreeScanCallback } from "./freescan";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

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

package/dist/commands/index.js

@@ -0,0 +1,104 @@
+/**
+ * SfmCommands - Unified command class (composition)
+ *
+ * Usage:
+ *   const finger = new SfmCommands({ baudRate: 115200 });
+ *   await finger.connect('/dev/ttyUSB0');
+ *
+ *   await finger.fingerprint.enroll(userId);
+ *   await finger.fingerprint.verify(userId);
+ *   await finger.fingerprint.identify();
+ *
+ *   await finger.system.getParam(0x01);
+ *   await finger.system.reset();
+ *   await finger.system.selfTest();
+ *
+ *   await finger.data.send(cmd, buf);
+ *   await finger.data.recv(cmd, size);
+ *
+ *   await finger.firmware.upgrade(filePath);
+ *
+ *   await finger.disconnect();
+ */
+import { SfmClient, SfmSerial } from "../core";
+import { FingerprintCommands } from "./fingerprint";
+import { SystemCommands } from "./system";
+import { DataCommands } from "./data";
+import { FirmwareCommands } from "./firmware";
+import { FreeScanCommands } from "./freescan";
+export class SfmCommands {
+    constructor(options = {}) {
+        this.client = new SfmClient(options);
+        this.fingerprint = new FingerprintCommands(this.client);
+        this.system = new SystemCommands(this.client);
+        this.data = new DataCommands(this.client);
+        this.firmware = new FirmwareCommands(this.client);
+        this.freeScan = new FreeScanCommands(this.client);
+        // Set cross-references between sub-classes
+        this.system._setDataCommands(this.data);
+        this.firmware._setDataCommands(this.data);
+        this.fingerprint._setSystemCommands(this.system);
+        this.freeScan._setSystemCommands(this.system);
+    }
+    /**
+     * Create instance and connect to device
+     */
+    static async create(options) {
+        const instance = new SfmCommands(options);
+        await instance.connect();
+        return instance;
+    }
+    /**
+     * List available serial ports
+     */
+    static async listPorts() {
+        return SfmSerial.listPorts();
+    }
+    /**
+     * Connect to device
+     */
+    async connect(portPath) {
+        await this.client.connect(portPath);
+    }
+    /**
+     * Disconnect from device
+     */
+    async disconnect() {
+        await this.client.disconnect();
+    }
+    /**
+     * Switch secure mode
+     */
+    setSecureMode(enabled, options = {}) {
+        this.client.setSecureMode(enabled, options);
+    }
+    /**
+     * Switch network protocol mode (RS422/485)
+     */
+    setNetworkMode(enabled, terminalId) {
+        this.client.setNetworkMode(enabled, terminalId);
+    }
+    /** Set disconnect callback */
+    setOnDisconnect(callback) {
+        this.client.setOnDisconnect(callback);
+    }
+    /** Set auto-reconnect options */
+    setAutoReconnect(options) {
+        this.client.setAutoReconnect(options);
+    }
+    /** Set auto-reconnect callbacks only */
+    setAutoReconnectCallbacks(callbacks) {
+        this.client.setAutoReconnectCallbacks(callbacks);
+    }
+    /** Whether reconnection is in progress */
+    get isReconnecting() {
+        return this.client.isReconnecting;
+    }
+}
+// Sub-class re-exports
+export { FingerprintCommands } from "./fingerprint";
+export { SystemCommands } from "./system";
+export { DataCommands, calcEvenOddChecksum } from "./data";
+export { FirmwareCommands } from "./firmware";
+export { FreeScanCommands } from "./freescan";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

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