open-index/open-npm huggingface dataset:
npm package: @sgrsoft/vpe-core-sdk
Description: VPE Player를 초기화하고 설정을 검증하는 Core SDK입니다. Access Key 검증, 서버 옵션 동기화, MA 리포트 동기화, 다국어 메시지, 옵션 정규화를 제공합니다.
Latest version: 0.20.5

# VPE Core SDK

VPE Player를 초기화하고 설정을 검증하는 Core SDK입니다. Access Key 검증, 서버 옵션 동기화, MA 리포트 동기화, 다국어 메시지, 옵션 정규화를 제공합니다.

## 주요 기능
- Access Key 및 App ID 기반 라이선스/설정 확인
- 플랫폼/스테이지별 서버 설정 로딩 (`pub|gov`, `prod|beta`)
- 플레이어 옵션 병합 및 검증
- 무료 요금제 강제 옵션 템플릿 적용
- MA(통계/리포트) 동기화 및 전송
- i18n 문자열 조회 (`$t`)
- HLS 마스터 플레이리스트 파싱

## 설치
```bash
pnpm install
```

## 기본 사용법
```ts
import VpeCore from '@sgrsoft/vpe-core-sdk';

const vpe = new VpeCore({
	accessKey: 'YOUR_ACCESS_KEY',
	appId: location.origin,
	platform: 'pub',
	stage: 'prod',
	isDev: false,
});

const result = await vpe.initialize();
if (result.error) {
	console.error(result.error);
	return;
}

const options = vpe.getValidatedOptions({
	autostart: false,
});
console.log(options);
```

## API 요약
### VpeCore 생성자
- `accessKey`: 인증 키
- `appId`: 앱/도메인 식별자
- `platform`: `pub` 또는 `gov`
- `stage`: `prod` 또는 `beta`
- `isDev`: 개발 모드일 때 `true`
- `language`: i18n 언어 코드

### 주요 메서드
- `initialize()`: 서버 설정과 MA 초기화 수행
- `isInitialized()`: 서버 설정 로딩 여부
- `isPaidTier()`: 요금제 유료 여부
- `getValidatedOptions(options)`: 서버 옵션과 로컬 옵션 병합
- `$t(key)`: i18n 문자열 조회
- `getErrorState()`: 마지막 에러 상태 반환
- `hlsPaser(url)`: HLS 마스터 플레이리스트 파싱

## 예제
- `example/` 디렉터리의 최소 연동 샘플로 동작 확인
- 실행: `pnpm dev`

## 빌드
```bash
pnpm build
pnpm build:types
```

## 배포 산출물
`dist/`에 다음 파일만 배포 대상으로 유지합니다.
- `vpe-core-sdk.es.js`
- `vpe-core-sdk.cjs.js`
- `main.d.ts`