feat(mock): env3 런타임 충실화 — 6 env-API sync→Promise + fetchContacts.getPermission 런타임 부재

[DaveDev42]

목적

sdk-example env1(브라우저+mock)↔env3(실기기 토스 WebView) 재측정에서 남은 8건 mismatch를 닫는다. 전부 상류 SDK의 type↔runtime 불일치(선언은 X, 런타임은 Y)이고 mock 품질 결함이 아니다 — devtools #775 원칙("mock은 타입 선언이 아니라 런타임 실측을 재현한다")을 두 방향(동기/비동기 축, 멤버 존재 여부)으로 확장한다.

Closes #795

Before / After

Part A — 6 env-API (src/mock/navigation/index.ts)

getPlatformOS / getOperationalEnvironment / getLocale / getDeviceId / isMinVersionSupported / getSafeAreaInsets

	Before (env1)	After (env1)	env3 실측
반환	동기 값	Promise.resolve(값) (같은 시그니처로 캐스트)	Promise

선언 타입은 전혀 바꾸지 않았다 — __typecheck.ts(3.0-beta)·__typecheck-2x.ts(2.x) 둘 다 그대로 컴파일된다(런타임 Promise는 tsc에 안 보임). getSafeAreaInsets는 기존 #770의 object 캐스트를 Promise.resolve(...)로 한 겹 더 감쌌다.

Part B — fetchContacts.getPermission (src/mock/device/contacts.ts)

	Before (env1)	After (env1)	env3 실측
fetchContacts.getPermission()	resolved PermissionStatus	접근 시 undefined → 호출 시 native TypeError	rejected native TypeError

withPermission()으로 감싸지 않고 _fetchContacts를 상류 타입(typeof _fetchContacts & { getPermission; openPermissionDialog })으로만 캐스트했다. _fetchContacts 내부에서 이미 checkPermission을 호출하므로 메인 동작(권한 거부 시 FetchContactsPermissionError)은 변화 없음.

standalone getPermission({name:'contacts', access:'access'})는 실기기에서 정상 resolve하므로(src/mock/permissions.ts) 이 변경은 fetchContacts에 부착된 메서드에만 적용된다.

Part B 상태 — 부분 확장 명시

• getPermission 부재는 issue의 직접 실측이고 이번 커밋으로 반영했다.
• openPermissionDialog 부재는 측정 근거 없는 합리적 추론이다 — 상류가 fetchContacts에 권한 헬퍼 전체를 붙이지 않는다고 보는 것. 코드 캐스트에서 같은 취급을 했고(둘 다 attached-member 부재), 코드 주석에 이 구분을 명시했다. 호출 시 native TypeError로 떨어짐을 직접 확인했다.
• 다른 withPermission API(clipboard/camera/location)로는 확장하지 않았다 — 그쪽 부착 메서드의 실기기 부재는 관측된 바 없다(failureModes 다이얼 3종 확장 — getIsTossLoginIntegratedService·requestNotificationAgreement·getPermission(이름별) #783 "측정 밖 확장 금지" 원칙).

Part B 전체를 구현했고 deferred 항목 없음.

테스트 갱신

기존 단위 테스트 중 이 6개 API를 동기로 단정하던 것(navigation.test.ts, fidelity-qa.test.ts)과, fetchContacts.getPermission()이 resolved를 반환한다고 단정하던 것(contacts.test.ts)은 실기기 실측에 맞춰 갱신했다 — 그 테스트들이 재현하던 동작이 비충실했다.

검증

pnpm typecheck   # tsc (3.0-beta) + tsc -p tsconfig.2x.json (2.x) + e2e fixture + scripts — 모두 green
pnpm test        # vitest — 111 files, 2498 passed | 1 todo
pnpm lint        # biome — green (touched files clean; pre-existing 32 infos in unrelated e2e fixture HTML)

Playwright e2e는 이 PR의 범위(mock 로직 변경, UI 변경 아님)라 실행하지 않았다.

다운스트림 검증 (별도 라운드)

sdk-example이 이 devtools를 물린 뒤 pnpm diff:captures에서 위 8건 mismatch 소멸 확인은 별도 PR/라운드에서 진행한다(SDK-surface 61→69/70 예상, 잔여 1건은 GPS 하드웨어 transient로 범위 밖).

Changeset

.changeset/env3-runtime-fidelity-795.md — @ait-co/devtools patch.

---

커뮤니티 오픈소스 프로젝트입니다.