fix(docs): restore GitHub Pages deployment for v6.0.0

[Palbahngmiyine]

Summary

v6.0.0 릴리즈 이후 GitHub Pages API Reference 문서 배포가 중단된 이슈를 두 개의 독립 원인으로 나눠 수정한다.

1. pnpm run docs (typedoc)가 tsconfig의 include: ["src/**/*", "test/**/*"] 기준으로 전체 TS 컴파일을 수행하다 4개 타입 에러로 실패 — CI가 Biome/Vitest/tsup(esbuild 계열)만 돌려 타입 검증 공백이 있었음
2. release-please가 기본 GITHUB_TOKEN으로 생성한 GitHub Release의 release: [published] 이벤트는 GitHub Actions 정책상 다음 워크플로를 트리거하지 않음 — v6.0.0 릴리즈 이후 build-docs.yaml이 자동 실행되지 않은 근본 원인

Changes

타입 에러 수정 (Phase A)

• src/lib/schemaUtils.ts:48 — Effect.void(Effect<void, never>) → Effect.succeed<Date | undefined>(undefined)
• test/lib/bms-test-utils.ts:8 — BmsChatBubbleType를 정식 re-export 위치(@/models/base/kakao/bms)에서 import
• test/models/base/kakao/bms/bmsConstraints.test.ts:29-44 — it.each 튜플의 미사용 3번째 원소(true) 제거로 콜백 시그니처와 일치화
• test/models/requests/messages/sendMessage.test.ts:600 — Schema.encodeSync 결과의 scheduledDate가 string | Date이므로 new Date(...) 정규화 후 .getTime() 호출

회귀 방지 게이트 (Phase B)

• package.json에 "typecheck": "tsc --noEmit" 스크립트 신설
• .github/workflows/ci.yml의 lint 잡에 Typecheck step 추가

릴리즈 → 문서 빌드 체인 복구 (Phase C)

• .github/workflows/release.yml에 trigger-docs 잡 추가
  • needs: [release-please, publish]
  • gating: release_created == 'true' + publish.result == 'success' + github.ref_name == 'master'
  • permissions: actions: write (최소 권한)
  • gh workflow run build-docs.yaml --repo "$REPO" --ref "$TAG" — workflow_dispatch는 GITHUB_TOKEN으로도 기동 가능하므로 명시적 디스패치 경로로 정책 제약 우회

build-docs.yaml의 기존 release: [published] 트리거와 workflow_dispatch는 그대로 유지해 수동 재빌드 경로 및 향후 PAT 전환 여지를 보존.

Test plan

로컬 검증 (모두 green):

• pnpm typecheck — 0 errors
• pnpm test:ci — 374/374 passed
• pnpm run docs — exit 0, docs/index.html 생성 (warning only)
• pnpm build — lint + tsup 성공
• YAML 파싱 유효성 확인

CI/CD 검증 (이 PR 자체):

• CI의 신설 Typecheck step 통과
• CI의 test-matrix(Node 18/20/22) + build 통과
• GitHub Actions Security 통과

배포 후 검증 (머지 이후 수동):

1. 본 PR이 master에 머지된 뒤:

   gh workflow run build-docs.yaml --repo solapi/solapi-nodejs --ref solapi-v6.0.0

   → v6.0.0 태그 커밋 기준으로 문서 빌드, GitHub Pages에 즉시 반영
2. 차후 정식 릴리즈에서 Release 워크플로의 trigger-docs 잡이 build-docs를 자동 디스패치하는지 확인

Related PRs (merged into fork master)

• fix(build): resolve typedoc type errors and add tsc gate Palbahngmiyine/solapi-nodejs#17 — Phase A + B
• ci(release): trigger docs build after stable publish Palbahngmiyine/solapi-nodejs#18 — Phase C

🤖 Generated with Claude Code

[gemini-code-assist]

Code Review

This pull request introduces several improvements and fixes across the codebase. Key changes include the addition of a typecheck script to package.json, a type-safety update in safeDateTransfer to return an explicit undefined effect, and refactoring of imports and test data in the BMS test utilities. Additionally, a date comparison in the message sending tests was corrected by explicitly constructing a Date object. I have no feedback to provide.