@wingscommerce/app-bridge-types

Wings Commerce App Bridge 스크립트의 동반 타입 패키지입니다.

타입이 생성되는 방식

이 패키지에는 타입 소스가 없습니다. 정본은 app-bridge 저장소의 src/types.ts 하나이고, 여기서는 빌드 시 내려받기만 합니다.

1. app-bridge가 CDN에 스크립트와 함께 wingscommerce.d.ts를 배포합니다
2. 빌드 시 scripts/build.mjs가 그 .d.ts를 내려받아 dist/index.d.ts로 씁니다
3. 내려받은 타입이 그대로 npm에 배포됩니다

CDN에 아직 없는 스크립트를 상대로 개발할 때는 APP_BRIDGE_TYPES_SOURCE 환경변수로 소스를 바꿀 수 있습니다 (URL 또는 파일 경로):

# 경로는 workspace 스크립트의 cwd(이 패키지 디렉터리) 기준으로 해석됩니다 —
# 절대 경로를 쓰는 게 가장 안전합니다.
APP_BRIDGE_TYPES_SOURCE=/path/to/app-bridge/dist/wingscommerce.d.ts \
  npm run build -w @wingscommerce/app-bridge-types

npm run check-cdn-updates는 dist/index.d.ts가 CDN과 어긋났는지 검사합니다 — 어긋났다면 다시 빌드해서 새 버전을 배포해야 합니다.