@samlab-corp/sfm-node 0.1.0

package/dist/commands/data.js

@@ -0,0 +1,176 @@
+/**
+ * Multi-packet data transfer/receive commands
+ */
+import { SFM_ERROR, ENCRYPTION_MODE } from "../constants";
+/**
+ * Even/Odd byte checksum calculation
+ */
+export function calcEvenOddChecksum(data) {
+    let evenSum = 0;
+    let oddSum = 0;
+    let remainder = 0;
+    const pairCount = data.length >= 2 ? ((data.length - 2) >>> 1) + 1 : 0;
+    const pairBytes = pairCount * 2;
+    for (let i = 0; i < pairBytes; i += 2) {
+        evenSum += data[i];
+        oddSum += data[i + 1];
+    }
+    if (pairBytes < data.length) {
+        remainder = data[pairBytes];
+    }
+    return (evenSum + oddSum + remainder) | 0;
+}
+export class DataCommands {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Multi-packet data send
+     */
+    async send(command, data, chunkSize = 0x4000, options = {}) {
+        const result = await this._sendMultiPacket(command, data, chunkSize, options);
+        if (result.error) {
+            throw new Error(result.error);
+        }
+    }
+    /**
+     * Multi-packet data receive
+     */
+    async recv(command, totalSize, options = {}) {
+        const result = await this._recvMultiPacket(command, totalSize, options);
+        if (result.error) {
+            throw new Error(result.error);
+        }
+        return result.data ?? Buffer.alloc(0);
+    }
+    async _sendMultiPacket(command, data, chunkSize = 0x4000, options = {}) {
+        if (!data || data.length === 0) {
+            return { error: null };
+        }
+        const dataSize = data.length;
+        if (chunkSize > dataSize) {
+            chunkSize = dataSize;
+        }
+        let sendData = data;
+        if (this.client.secureMode && this.client.crypto) {
+            if (this.client.crypto.mode === ENCRYPTION_MODE.AES256_CBC) {
+                this.client.crypto.resetIV();
+            }
+            sendData = this.client.crypto.encryptRaw(data);
+        }
+        const totalSize = sendData.length;
+        const totalPackets = Math.ceil(totalSize / chunkSize);
+        for (let packetIndex = 0; packetIndex < totalPackets; packetIndex++) {
+            const offset = packetIndex * chunkSize;
+            const remaining = totalSize - offset;
+            const currentChunkSize = Math.min(chunkSize, remaining);
+            const param = (packetIndex << 16) | totalPackets;
+            const cmdResponse = await this.client.sendCommand(command, param, currentChunkSize, 0);
+            if (!cmdResponse.valid) {
+                return {
+                    error: `Command send failed (packet ${packetIndex}): ${cmdResponse.error}`,
+                };
+            }
+            const chunk = sendData.subarray(offset, offset + currentChunkSize);
+            const writeResult = await this._writeWithTimeout(this.client.serial, chunk);
+            if (writeResult < 0) {
+                return { error: `Data write failed (packet ${packetIndex})` };
+            }
+            if (writeResult < currentChunkSize) {
+                return {
+                    error: `Incomplete data write (packet ${packetIndex}): ${writeResult}/${currentChunkSize}`,
+                };
+            }
+            const checksumBuf = Buffer.alloc(4);
+            checksumBuf.writeUInt32LE(calcEvenOddChecksum(chunk) >>> 0, 0);
+            await this._writeWithTimeout(this.client.serial, checksumBuf);
+            const ackResponse = await this.client.receiveResponse();
+            if (!ackResponse.valid) {
+                return {
+                    error: `Response receive failed (packet ${packetIndex}): ${ackResponse.error}`,
+                };
+            }
+            if (ackResponse.flag !== SFM_ERROR.SUCCESS) {
+                return {
+                    error: `Transfer failed (packet ${packetIndex}): flag=0x${ackResponse.flag?.toString(16) ?? "??"}`,
+                };
+            }
+            options.onProgress?.(packetIndex, totalPackets);
+        }
+        return { error: null };
+    }
+    async _recvMultiPacket(command, totalDataSize, options = {}) {
+        if (totalDataSize === 0) {
+            return { data: Buffer.alloc(0), error: null };
+        }
+        const resultBuf = Buffer.alloc(totalDataSize);
+        let receivedTotal = 0;
+        while (receivedTotal < totalDataSize) {
+            const cmdResponse = await this.client.receiveResponse();
+            if (!cmdResponse.valid) {
+                return {
+                    data: null,
+                    error: `Command receive failed: ${cmdResponse.error}`,
+                };
+            }
+            const chunkSize = cmdResponse.size ?? 0;
+            const packetInfo = cmdResponse.param ?? 0;
+            const packetIndex = packetInfo >> 16;
+            const totalPackets = packetInfo & 0xffff;
+            const readTimeout = this.client._getReadTimeout(chunkSize + 4);
+            const chunkData = await this._readWithTimeout(this.client.serial, chunkSize + 4, readTimeout);
+            if (!chunkData || chunkData.length < chunkSize + 4) {
+                await this._sendResponseFlag(command, SFM_ERROR.SCAN_FAIL);
+                return {
+                    data: null,
+                    error: `Incomplete data receive (packet ${packetIndex})`,
+                };
+            }
+            const dataChunk = chunkData.subarray(0, chunkSize);
+            const receivedChecksum = chunkData.readUInt32LE(chunkSize);
+            const calculatedChecksum = calcEvenOddChecksum(dataChunk);
+            if (calculatedChecksum !== receivedChecksum) {
+                await this._sendResponseFlag(command, SFM_ERROR.SCAN_FAIL);
+                return {
+                    data: null,
+                    error: `Checksum mismatch (packet ${packetIndex})`,
+                };
+            }
+            dataChunk.copy(resultBuf, receivedTotal, 0, chunkSize);
+            receivedTotal += chunkSize;
+            await this._sendResponseFlag(command, SFM_ERROR.SUCCESS);
+            options.onProgress?.(packetIndex, totalPackets);
+            if (packetIndex + 1 >= totalPackets)
+                break;
+        }
+        if (this.client.secureMode && this.client.crypto) {
+            if (this.client.crypto.mode === ENCRYPTION_MODE.AES256_CBC) {
+                this.client.crypto.resetIV();
+            }
+            const decrypted = this.client.crypto.decryptRaw(resultBuf, totalDataSize);
+            return { data: decrypted, error: null };
+        }
+        return { data: resultBuf, error: null };
+    }
+    async _sendResponseFlag(command, flag) {
+        await this.client.sendCommand(command, 0, 0, flag);
+    }
+    async _writeWithTimeout(serial, data) {
+        try {
+            await serial.write(data);
+            return data.length;
+        }
+        catch {
+            return -1;
+        }
+    }
+    async _readWithTimeout(serial, length, timeoutMs = 5000) {
+        try {
+            return await serial.read(length, timeoutMs);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=data.js.map

package/dist/commands/data.js.map

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

package/dist/commands/fingerprint.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Fingerprint enroll/verify/identify/capture commands
+ */
+import { SFM_FLAG } from "../constants";
+import type { SfmClient } from "../core";
+import type { SystemCommands, CommandResult } from "./system";
+interface LogOptions {
+    onLog?: (msg: string) => void;
+}
+export interface EnrollResult {
+    success: boolean;
+    step: number;
+    userId?: number;
+    error?: string;
+}
+export interface VerifyResult {
+    success: boolean;
+    userId?: number;
+    error: string | null;
+}
+export interface IdentifyResult {
+    success: boolean;
+    userId: number;
+    error: string | null;
+}
+export type { CommandResult } from "./system";
+export interface ListUserIdsResult {
+    success: boolean;
+    userIds: number[];
+    count: number;
+    error: string | null;
+}
+export interface CaptureImageResult {
+    success: boolean;
+    imageData: Buffer | null;
+    width: number;
+    height: number;
+    error: string | null;
+}
+export declare class FingerprintCommands {
+    private client;
+    private system;
+    constructor(client: SfmClient);
+    /** @internal Set SystemCommands reference */
+    _setSystemCommands(system: SystemCommands): void;
+    /**
+     * Enroll scan 1 - send ES command + read 0x62 (scan success) + 0x61 (template 1 saved)
+     */
+    enrollScan1(userId: number, flag?: 0, { onLog }?: LogOptions): Promise<EnrollResult>;
+    /**
+     * Enroll scan 2 - read 0x62 (scan success) + 0x61 (template 2 saved)
+     */
+    enrollScan2({ onLog }?: LogOptions): Promise<EnrollResult>;
+    /**
+     * Enroll (automatically adapts to current ENROLL_MODE setting)
+     *
+     * - SCAN1 (0x30): 1 scan only
+     * - SCAN2_MERGE (0x31) / SCAN2_DUAL (0x41): scan 1 + scan 2
+     */
+    enroll(userId: number, flag?: 0, { onLog }?: LogOptions): Promise<EnrollResult>;
+    /**
+     * 1:1 검증 (VS: 0x08)
+     */
+    verify(userId: number, { onLog }?: LogOptions): Promise<VerifyResult>;
+    /**
+     * 1:N 식별 (IS: 0x11)
+     */
+    identify({ onLog }?: LogOptions): Promise<IdentifyResult>;
+    /**
+     * Delete specific template (DT: 0x16)
+     */
+    deleteTemplate(userId: number): Promise<CommandResult>;
+    /**
+     * Delete all templates (DA: 0x17)
+     */
+    deleteAllTemplates(): Promise<CommandResult>;
+    /**
+     * List enrolled user IDs (LT: 0x18)
+     */
+    listUserIds({ onLog }?: LogOptions): Promise<ListUserIdsResult>;
+    /**
+     * Read template from device (RTX: 0x89, ping-pong protocol)
+     *
+     * RTX response Size field: (templateCount << 16) | templateSize
+     *   e.g. 131456 = 0x00020180 → count=2, size=384
+     *
+     * Flow: send RTX → read 384B data → send ACK (RTX) → read 384B data → ...
+     * Device flag: 0x74 (CONTINUE) = more chunks, 0x61 (SUCCESS) = last chunk.
+     */
+    readTemplate(userId: number, { onLog }?: LogOptions): Promise<{
+        success: boolean;
+        templateData: Buffer | null;
+        error: string | null;
+    }>;
+    /**
+     * Write template to device (ET: 0x07 — Simple Template Enrollment)
+     *
+     * Kiosk 호환 프로토콜 (rs232/fingerPrinter.js enrollByTemplate):
+     * 1. [Command Packet 13B] + [Template Data] + [END 0x0A] 를 한 번에 전송
+     * 2. 디바이스로부터 2개 응답 수신 (스캔 처리 + 최종 결과)
+     *
+     * Size field = templateData.length (원본 크기 그대로)
+     * 384B 단위 chunk를 각각 별도의 ET 호출로 전송
+     */
+    writeTemplate(userId: number, templateData: Buffer, flag?: (typeof SFM_FLAG)[keyof typeof SFM_FLAG], { onLog }?: LogOptions): Promise<{
+        success: boolean;
+        userId?: number;
+        error: string | null;
+    }>;
+    /**
+     * Write template to device (ETX: 0x87 — Extended Template Enrollment)
+     *
+     * Extended Data Transfer Protocol (Appendix B):
+     * Supports multi-chunk: 768B → 2 chunks of 384B sent in one ETX session.
+     *
+     * 1. sendCommand(ETX, userId, sizeField, flag) → SUCCESS(0x61)
+     *    sizeField: (templateCount << 24) | (enrollCount << 16) | chunkSize
+     * 2. For each chunk:
+     *    Data Packet Header(13B) + Data Body(384B) + Data Checksum(4B)
+     *    → DATA_OK(0x83) 응답 수신
+     */
+    writeTemplateMulti(userId: number, templateData: Buffer, flag?: (typeof SFM_FLAG)[keyof typeof SFM_FLAG], { onLog }?: LogOptions): Promise<{
+        success: boolean;
+        userId?: number;
+        error: string | null;
+    }>;
+    /**
+     * Capture fingerprint image (SI: 0x15)
+     */
+    captureImage({ onLog }?: LogOptions): Promise<CaptureImageResult>;
+}
+//# sourceMappingURL=fingerprint.d.ts.map

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

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