@crowsgear/escl-protocol-scanner 1.1.1 → 1.2.1

package/scripts/check-python-deps.js

@@ -1,206 +1,269 @@
-#!/usr/bin/env node
-
-/**
- * Python 의존성 확인 및 설치 스크립트
- * - 시스템에 Python 3 설치 여부 확인
- * - 필요한 패키지(zeroconf, pillow) 설치 여부 확인
- * - 대화형 설치 프롬프트
- *
- * 사용자는 PYTHON_PATH 환경변수로 어느 Python을 사용할지 결정
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execSync, spawnSync } = require('child_process');
-const readline = require('readline');
-
-const REQUIRED_PACKAGES = ['zeroconf', 'pillow'];
-const PACKAGE_JSON_PATH = path.join(__dirname, '..', 'package.json');
-const PROJECT_ROOT = path.dirname(path.dirname(PACKAGE_JSON_PATH));
-
-/**
- * 플랫폼별 바이너리 존재 여부 확인
- */
-function checkBinaryExists() {
-  const platform = process.platform; // 'win32', 'darwin', 'linux'
-  const binDir = path.join(__dirname, '..', 'bin', platform);
-  const binaryName = platform === 'win32' ? 'escl-scanner.exe' : 'escl-scanner';
-  const binaryPath = path.join(binDir, binaryName);
-
-  return fs.existsSync(binaryPath);
-}
-
-// 색상 코드
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-};
-
-const log = {
-  info: (msg) => console.log(`${colors.blue}ℹ️  ${msg}${colors.reset}`),
-  success: (msg) => console.log(`${colors.green}✅ ${msg}${colors.reset}`),
-  warn: (msg) => console.log(`${colors.yellow}⚠️  ${msg}${colors.reset}`),
-  error: (msg) => console.log(`${colors.red}❌ ${msg}${colors.reset}`),
-  header: (msg) => console.log(`\n${colors.bright}${colors.cyan}${msg}${colors.reset}\n`),
-};
-
-/**
- * 시스템 Python 경로 찾기
- */
-function findPythonPath() {
-  // PYTHON_PATH 환경변수가 설정되어 있으면 사용
-  if (process.env.PYTHON_PATH) {
-    log.success(`PYTHON_PATH 환경변수 사용: ${process.env.PYTHON_PATH}`);
-    return process.env.PYTHON_PATH;
-  }
-
-  // 아니면 시스템 python3 사용
-  try {
-    const pythonPath = execSync('which python3', { encoding: 'utf-8' }).trim();
-    log.info(`시스템 Python 사용: ${pythonPath}`);
-    return pythonPath;
-  } catch (error) {
-    log.error('python3를 찾을 수 없습니다. Python 3을 설치하세요.');
-    process.exit(1);
-  }
-}
-
-/**
- * 패키지 설치 여부 확인
- */
-function checkPackageInstalled(pythonPath, packageName) {
-  try {
-    execSync(`${pythonPath} -c "import ${packageName}"`, {
-      stdio: 'pipe',
-      encoding: 'utf-8',
-    });
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * 설치된 패키지 확인
- */
-function checkInstalledPackages(pythonPath) {
-  const missing = [];
-
-  for (const pkg of REQUIRED_PACKAGES) {
-    const installed = checkPackageInstalled(pythonPath, pkg);
-
-    if (installed) {
-      log.success(`${pkg} 설치됨`);
-    } else {
-      log.warn(`${pkg} 미설치`);
-      missing.push(pkg);
-    }
-  }
-
-  return missing;
-}
-
-/**
- * 사용자 입력 프롬프트
- */
-function prompt(question) {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-    });
-
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.toLowerCase());
-    });
-  });
-}
-
-/**
- * 패키지 설치
- */
-async function installPackages(pythonPath, packages) {
-  log.header(`Python 패키지 설치`);
-
-  const installCmd = `${pythonPath} -m pip install ${packages.join(' ')}`;
-
-  console.log(`설치 명령어: ${colors.cyan}${installCmd}${colors.reset}\n`);
-
-  const answer = await prompt(
-    `${colors.bright}패키지를 설치하시겠습니까? (y/n): ${colors.reset}`
-  );
-
-  if (answer === 'y' || answer === 'yes') {
-    try {
-      log.info('설치 중...');
-      execSync(installCmd, { stdio: 'inherit' });
-      log.success('패키지 설치 완료');
-      return true;
-    } catch (error) {
-      log.error(`설치 실패: ${error.message}`);
-      return false;
-    }
-  } else {
-    log.warn('사용자가 설치를 거부했습니다.');
-    log.info(`수동 설치 명령어: ${colors.cyan}${installCmd}${colors.reset}`);
-    return false;
-  }
-}
-
-/**
- * 메인 함수
- */
-async function main() {
-  log.header('eSCL Protocol Scanner - Python 의존성 확인');
-
-  // 바이너리 존재 여부 확인 - 있으면 Python 체크 스킵
-  if (checkBinaryExists()) {
-    log.success('Pre-built 바이너리가 존재합니다. Python 의존성 체크를 건너뜁니다.');
-    console.log();
-    process.exit(0);
-  }
-
-  log.info('Pre-built 바이너리가 없습니다. Python 의존성을 확인합니다...');
-
-  // Python 경로 결정
-  const pythonPath = findPythonPath();
-
-  // 패키지 확인
-  log.header('필수 패키지 확인');
-  const missing = checkInstalledPackages(pythonPath);
-
-  if (missing.length === 0) {
-    log.success('모든 필수 패키지가 설치되어 있습니다.');
-    console.log();
-    process.exit(0);
-  }
-
-  // 설치 필요
-  log.header('필수 패키지 설치 필요');
-  log.warn(`다음 패키지가 필요합니다: ${missing.join(', ')}`);
-
-  const installed = await installPackages(pythonPath, missing);
-
-  if (!installed) {
-    log.error('필수 패키지 없이는 eSCL 스캐너를 사용할 수 없습니다.');
-    console.log(
-      `\n${colors.bright}수동 설치 방법:${colors.reset}`
-    );
-
-    console.log(`${colors.cyan}${pythonPath} -m pip install ${missing.join(' ')}${colors.reset}`);
-    console.log();
-    process.exit(1);
-  }
-}
-
-// 실행
-main().catch((error) => {
-  log.error(`예기치 않은 오류: ${error.message}`);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * Python 의존성 확인 및 설치 스크립트
+ * - 시스템에 Python 3 설치 여부 확인
+ * - 필요한 패키지(zeroconf, pillow) 설치 여부 확인
+ * - 대화형 설치 프롬프트
+ *
+ * 사용자는 PYTHON_PATH 환경변수로 어느 Python을 사용할지 결정
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { execSync, spawnSync } = require("child_process");
+const readline = require("readline");
+
+const REQUIRED_PACKAGES = ["zeroconf", "pillow"];
+const PACKAGE_JSON_PATH = path.join(__dirname, "..", "package.json");
+const PROJECT_ROOT = path.dirname(path.dirname(PACKAGE_JSON_PATH));
+
+/**
+ * 플랫폼별 바이너리 존재 여부 확인
+ */
+function checkBinaryExists() {
+    const platform = process.platform; // 'win32', 'darwin', 'linux'
+    const binDir = path.join(__dirname, "..", "bin", platform);
+    const binaryName = platform === "win32" ? "escl-scanner.exe" : "escl-scanner";
+    const binaryPath = path.join(binDir, binaryName);
+
+    return fs.existsSync(binaryPath);
+}
+
+// 색상 코드
+const colors = {
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    cyan: "\x1b[36m",
+};
+
+const log = {
+    info: (msg) => console.log(`${colors.blue}ℹ️  ${msg}${colors.reset}`),
+    success: (msg) => console.log(`${colors.green}✅ ${msg}${colors.reset}`),
+    warn: (msg) => console.log(`${colors.yellow}⚠️  ${msg}${colors.reset}`),
+    error: (msg) => console.log(`${colors.red}❌ ${msg}${colors.reset}`),
+    header: (msg) => console.log(`\n${colors.bright}${colors.cyan}${msg}${colors.reset}\n`),
+};
+
+/**
+ * 시스템 Python 경로 찾기
+ */
+function findPythonPath() {
+    // PYTHON_PATH 환경변수가 설정되어 있으면 사용
+    if (process.env.PYTHON_PATH) {
+        log.success(`PYTHON_PATH 환경변수 사용: ${process.env.PYTHON_PATH}`);
+        return process.env.PYTHON_PATH;
+    }
+
+    const isWindows = process.platform === "win32";
+    const whichCmd = isWindows ? "where" : "which";
+    // 윈도우에서는 python3이 없을 수 있으므로 python도 시도
+    const candidates = isWindows ? ["python3", "python"] : ["python3"];
+
+    for (const candidate of candidates) {
+        try {
+            const result = execSync(`${whichCmd} ${candidate}`, {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+            // where 명령어는 여러 줄을 반환할 수 있으므로 첫 번째 경로 사용
+            const pythonPath = result.split(/\r?\n/)[0].trim();
+
+            // python인 경우 Python 3인지 확인
+            if (candidate === "python") {
+                try {
+                    const version = execSync(`${pythonPath} --version`, {
+                        encoding: "utf-8",
+                        stdio: ["pipe", "pipe", "pipe"],
+                    }).trim();
+                    if (!version.startsWith("Python 3")) {
+                        continue;
+                    }
+                } catch {
+                    continue;
+                }
+            }
+
+            log.info(`시스템 Python 사용: ${pythonPath}`);
+            return pythonPath;
+        } catch {
+            // 이 candidate를 찾지 못함, 다음 시도
+        }
+    }
+
+    log.error("Python 3을 찾을 수 없습니다. Python 3을 설치하세요.");
+    process.exit(1);
+}
+
+/**
+ * 패키지 설치 여부 확인
+ */
+function checkPackageInstalled(pythonPath, packageName) {
+    try {
+        execSync(`${pythonPath} -c "import ${packageName}"`, {
+            stdio: "pipe",
+            encoding: "utf-8",
+        });
+        return true;
+    } catch (error) {
+        return false;
+    }
+}
+
+/**
+ * 설치된 패키지 확인
+ */
+function checkInstalledPackages(pythonPath) {
+    const missing = [];
+
+    for (const pkg of REQUIRED_PACKAGES) {
+        const installed = checkPackageInstalled(pythonPath, pkg);
+
+        if (installed) {
+            log.success(`${pkg} 설치됨`);
+        } else {
+            log.warn(`${pkg} 미설치`);
+            missing.push(pkg);
+        }
+    }
+
+    return missing;
+}
+
+/**
+ * 사용자 입력 프롬프트
+ */
+function prompt(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase());
+        });
+    });
+}
+
+/**
+ * 가상환경 사용 안내 출력
+ */
+function showVenvGuide(packages) {
+    log.header("가상환경 사용 안내");
+    log.info("애플리케이션에서 pythonPath 옵션으로 가상환경 경로를 직접 전달합니다.(패키지 직접 설치)");
+
+    const isWindows = process.platform === "win32";
+    const venvPython = isWindows ? ".venv\\Scripts\\python.exe" : ".venv/bin/python3";
+    const activateCmd = isWindows ? ".venv\\Scripts\\activate" : "source .venv/bin/activate";
+
+    console.log(`\n${colors.bright}가상환경 설정 방법:${colors.reset}`);
+    console.log(`  1. 가상환경 생성:  ${colors.cyan}python -m venv .venv${colors.reset}`);
+    console.log(`  2. 가상환경 활성화: ${colors.cyan}${activateCmd}${colors.reset}`);
+    console.log(`  3. 패키지 설치:    ${colors.cyan}pip install ${packages.join(" ")}${colors.reset}`);
+
+    console.log(`\n${colors.bright}애플리케이션에서 사용:${colors.reset}`);
+    console.log(`  ${colors.cyan}const app = new Application({ pythonPath: '${venvPython}' });${colors.reset}`);
+    console.log();
+}
+
+/**
+ * 패키지 설치 방법 선택
+ */
+async function handleMissingPackages(pythonPath, packages) {
+    log.header("설치 방법 선택");
+
+    console.log(`  ${colors.bright}1)${colors.reset} 시스템 Python에 직접 설치 (pip install)`);
+    console.log(`  ${colors.bright}2)${colors.reset} 가상환경 사용 (애플리케이션 내 가상환경 경로 직접 전달)`);
+    console.log(`  ${colors.bright}3)${colors.reset} 건너뛰기`);
+    console.log();
+
+    const answer = await prompt(`${colors.bright}선택하세요 (1/2/3): ${colors.reset}`);
+
+    switch (answer) {
+        case "1": {
+            const installCmd = `${pythonPath} -m pip install ${packages.join(" ")}`;
+            console.log(`\n설치 명령어: ${colors.cyan}${installCmd}${colors.reset}\n`);
+            const confirm = await prompt(`${colors.bright}설치를 진행하시겠습니까? (y/n): ${colors.reset}`);
+            if (confirm === "y" || confirm === "yes") {
+                try {
+                    log.info("설치 중...");
+                    execSync(installCmd, { stdio: "inherit" });
+                    log.success("패키지 설치 완료");
+                    return true;
+                } catch (error) {
+                    log.error(`설치 실패: ${error.message}`);
+                    return false;
+                }
+            }
+            log.warn("사용자가 설치를 취소했습니다.");
+            return false;
+        }
+        case "2": {
+            showVenvGuide(packages);
+            log.success("가상환경 모드를 선택했습니다. 위 안내에 따라 설정하세요.");
+            return true;
+        }
+        default: {
+            log.warn("설치를 건너뛰었습니다.");
+            log.info(
+                `수동 설치 명령어: ${colors.cyan}${pythonPath} -m pip install ${packages.join(" ")}${colors.reset}`,
+            );
+            return false;
+        }
+    }
+}
+
+/**
+ * 메인 함수
+ */
+async function main() {
+    log.header("eSCL Protocol Scanner - Python 의존성 확인");
+
+    // 바이너리 존재 여부 확인 - 있으면 Python 체크 스킵
+    if (checkBinaryExists()) {
+        log.success("Pre-built 바이너리가 존재합니다. Python 의존성 체크를 건너뜁니다.");
+        console.log();
+        process.exit(0);
+    }
+
+    log.info("Pre-built 바이너리가 없습니다. Python 의존성을 확인합니다...");
+
+    // Python 경로 결정
+    const pythonPath = findPythonPath();
+
+    // 패키지 확인
+    log.header("필수 패키지 확인");
+    const missing = checkInstalledPackages(pythonPath);
+
+    if (missing.length === 0) {
+        log.success("모든 필수 패키지가 설치되어 있습니다.");
+        console.log();
+        process.exit(0);
+    }
+
+    // 설치 필요
+    log.warn(`다음 패키지가 필요합니다: ${missing.join(", ")}`);
+
+    const resolved = await handleMissingPackages(pythonPath, missing);
+
+    if (!resolved) {
+        log.error("필수 패키지 없이는 eSCL 스캐너를 사용할 수 없습니다.");
+        console.log(`\n${colors.bright}수동 설치 방법:${colors.reset}`);
+
+        console.log(`${colors.cyan}${pythonPath} -m pip install ${missing.join(" ")}${colors.reset}`);
+        console.log();
+        process.exit(1);
+    }
+}
+
+// 실행
+main().catch((error) => {
+    log.error(`예기치 않은 오류: ${error.message}`);
+    process.exit(1);
+});

package/dist/client.d.ts

@@ -1,78 +0,0 @@
-/**
- * eSCL Protocol Client for Node.js
- * HTTP client for communicating with eSCL/AirPrint network scanners
- */
-import { ESCLScanner, ESCLCapabilities } from './types';
-/**
- * eSCL HTTP Client
- * Handles all HTTP communication with eSCL-compatible network scanners
- */
-export declare class ESCLClient {
-    private timeout;
-    constructor(timeout?: number);
-    /**
-     * Get scanner capabilities
-     * @param scanner Target scanner
-     * @param debug Enable debug logging (default: false)
-     * @returns Scanner capabilities
-     */
-    getCapabilities(scanner: ESCLScanner, debug?: boolean): Promise<ESCLCapabilities | null>;
-    /**
-     * Start scan job
-     * @param scanner Target scanner
-     * @param dpi Resolution in DPI
-     * @param colorMode Color mode (BlackAndWhite1, Grayscale8, RGB24)
-     * @param source Scan source (Platen, Feeder)
-     * @param documentFormat Document format MIME type
-     * @param width Scan width in mm (optional)
-     * @param height Scan height in mm (optional)
-     * @returns Scan job UUID
-     */
-    createScanJob(scanner: ESCLScanner, dpi: number, colorMode: string, source: string, documentFormat: string, width?: number, height?: number): Promise<string | null>;
-    /**
-     * Poll scan job status
-     * @param scanner Target scanner
-     * @param jobId Scan job ID
-     * @returns Job status and image URLs if complete
-     */
-    getScanJobStatus(scanner: ESCLScanner, jobId: string): Promise<{
-        status: 'Processing' | 'Completed' | 'Aborted' | 'Unknown';
-        images: string[];
-    }>;
-    /**
-     * Download scanned image
-     * @param scanner Target scanner
-     * @param imageUrl Relative image URL
-     * @returns PNG image data as Buffer
-     */
-    downloadImage(scanner: ESCLScanner, imageUrl: string): Promise<Buffer | null>;
-    /**
-     * Build eSCL scan settings XML
-     * @param dpi Resolution in DPI
-     * @param colorMode Color mode
-     * @param source Scan source
-     * @param documentFormat Document format MIME type
-     * @param width Scan width in mm (optional)
-     * @param height Scan height in mm (optional)
-     */
-    private buildScanSettings;
-    /**
-     * Parse scanner capabilities from XML response
-     * @param xml XML response from scanner
-     * @param debug Enable debug logging (default: false)
-     */
-    private parseCapabilities;
-    /**
-     * HTTP GET request
-     */
-    private httpGet;
-    /**
-     * HTTP GET request (binary)
-     */
-    private httpGetBinary;
-    /**
-     * HTTP POST request
-     */
-    private httpPost;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAgB,MAAM,SAAS,CAAC;AAEtE;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,CAAC,EAAE,MAAM;IAM5B;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAarG;;;;;;;;;;OAUG;IACG,aAAa,CACjB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsCzB;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACnE,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;QAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAyBF;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUnF;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAkHzB;;OAEG;IACH,OAAO,CAAC,OAAO;IAyBf;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAmCjB"}