설치

npm에서 설치

npm install dbx-py

yarn 사용

yarn add dbx-py

pnpm 사용

pnpm add dbx-py

요구사항

• Node.js: 16 이상
• 플랫폼: Windows x64 (현재 테스트 완료)
  • Linux x64: 계획됨
  • macOS (Intel/Apple Silicon): 계획됨

설치 확인

const { Database } = require('dbx-py');

const db = Database.openInMemory();
console.log('DBX Native loaded successfully!');
db.close();

TypeScript 설정

npm install --save-dev @types/node

tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "esModuleInterop": true,
    "strict": true
  }
}

문제 해결

모듈을 찾을 수 없음

원인: 네이티브 바인딩 로드 실패

해결:

# node_modules 재설치
rm -rf node_modules package-lock.json
npm install

Windows에서 빌드 도구 오류

원인: Visual C++ Build Tools 누락

해결:

1. Build Tools for Visual Studio 다운로드
2. “Desktop development with C++” 워크로드 선택
3. 설치 후 재부팅

Node.js 버전 확인

node --version  # v16.0.0 이상 필요