RouteAccess — @gj-kit/expo-workouts

@gj-kit/expo-workouts/core에서 공개하는 type입니다. package version 0.1.1의 release declaration을 그대로 표시합니다.

검증된 import 예제

import { RouteAccess } from '@gj-kit/expo-workouts/core';

시그니처, 매개변수, 반환 타입

/**
 * How far route reads reach right now.
 * - 'all'      — the route permission is held AND the app is in the foreground.
 * - 'own'      — only routes this app wrote read inline.
 * - 'perRoute' — nothing reads inline; each route needs `getRoute(id, { consent: 'prompt' })`.
 *
 * ⚠ On iOS this is always `'all'` and is NOT evidence of anything — read it together with
 *   `read.routes === 'unknown'`.
 * ⚠ On Android `'all'` does NOT guarantee a route read succeeds: Health Connect's first-run
 *   onboarding is an undocumented further precondition. `'all'` + `getRoute` throwing
 *   `consentRequired` is the signature of incomplete onboarding — send the user to `openSettings()`.
 * CLOSED for 1.x.
 */
type RouteAccess = 'all' | 'own' | 'perRoute';

이 선언은 매개변수, optionality, 제네릭, 반환값, 공개 union/type 계약의 정본입니다. 호출 전 필요한 환경·권한·오류 경계는 패키지 Golden path와 이 subpath의 import 조건을 함께 확인하세요.

Release context

• 패키지: @gj-kit/expo-workouts
• 버전: 0.1.1
• 공개 entry: ./core
• 소스: GitHub

구현 주석

How far route reads reach right now.

• ‘all’ — the route permission is held AND the app is in the foreground.
• ‘own’ — only routes this app wrote read inline.
• ‘perRoute’ — nothing reads inline; each route needs getRoute(id, { consent: 'prompt' }).

⚠ On iOS this is always 'all' and is NOT evidence of anything — read it together with read.routes === 'unknown'. ⚠ On Android 'all' does NOT guarantee a route read succeeds: Health Connect’s first-run onboarding is an undocumented further precondition. 'all' + getRoute throwing consentRequired is the signature of incomplete onboarding — send the user to openSettings(). CLOSED for 1.x.