@algocare/react-native-code-push 12.6.3 → 12.6.4

package/.claude/commands/release.md

@@ -0,0 +1,78 @@
+# npm 배포
+
+인자: $ARGUMENTS (patch, minor, major 중 하나. 기본값: patch)
+
+아래 단계를 순서대로 실행하세요. 각 단계 완료 후 다음 단계로 넘어가세요.
+
+## 1단계: 사전 검증
+
+다음을 모두 확인하세요:
+- `git status`: working tree가 clean한지
+- `git branch --show-current`: master 브랜치인지
+- `npm whoami`: npm 로그인 상태인지
+
+로그인이 안 되어 있으면 사용자에게 안내:
+```
+npm 로그인이 필요합니다.
+계정 정보: https://www.notion.so/algocare/npm-1d59954bcc7b8056b6b6c84612592266
+터미널에서 실행: npm login --scope=@algocare
+```
+로그인 완료 후 다시 확인하세요.
+
+검증 실패 시 해당 문제를 안내하고 중단하세요.
+
+## 2단계: 버전 bump + commit + tag
+
+```bash
+npm version $ARGUMENTS --no-git-tag-version
+```
+
+package.json만 변경됩니다. 이후:
+```bash
+git add package.json package-lock.json
+git commit -m "v{새버전}"
+git tag "v{새버전}"
+```
+
+## 3단계: npm publish (사용자 터미널 필요)
+
+npm OTP 브라우저 인증이 필요하므로 Claude Code에서 직접 실행할 수 없습니다.
+
+사용자에게 다음을 안내하세요:
+```
+터미널에서 실행해주세요:
+npm publish --access public --ignore-scripts
+
+브라우저 인증 완료 후 알려주세요.
+```
+
+사용자가 완료했다고 하면 배포 확인:
+```bash
+npm view @algocare/react-native-code-push version
+```
+
+배포된 버전이 새 버전과 일치하면 다음 단계로. 실패 시 복구 안내:
+```
+복구: git tag -d v{새버전} && git reset --soft HEAD~1 && git checkout package.json
+```
+
+## 4단계: git push + GitHub Release
+
+```bash
+git push && git push --tags
+```
+
+이후 GitHub Release 생성:
+```bash
+PREV_TAG=$(git tag --sort=-v:refname | sed -n '2p')
+# PREV_TAG..새태그 사이의 커밋으로 릴리스 노트 생성
+gh release create "v{새버전}" --title "{새버전}" --notes "{릴리스노트}"
+```
+
+## 5단계: 완료 보고
+
+배포 결과를 요약하세요:
+- 패키지: @algocare/react-native-code-push@{새버전}
+- npm: 배포 완료
+- git: push 완료
+- GitHub Release: 생성 완료

package/.claude/skills/npm-release/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: npm-release
+description: Use when user asks to publish, release, or deploy an npm package. Triggers on "배포", "publish", "release", "npm 배포", "버전 올려". Guides step-by-step npm publish workflow with OTP browser auth handoff.
+---
+
+# npm Release
+
+## Overview
+
+npm 패키지 배포를 단계별로 수행한다. OTP 브라우저 인증이 필요한 `npm publish`는 사용자 터미널로 넘기고, 나머지는 자동 처리한다.
+
+## When to Use
+
+- 사용자가 "배포해줘", "publish 해줘", "npm 배포", "버전 올려줘", "release 해줘" 등 요청
+- 프로젝트에 package.json이 있고 npm 배포가 필요한 경우
+
+## When NOT to Use
+
+- CodePush 번들 배포 (code-push CLI 사용)
+- 앱스토어 배포
+
+## Workflow
+
+### 1. 사전 검증
+
+모두 확인:
+- `git status`: clean working tree
+- `git branch --show-current`: 기본 브랜치 (master/main)
+- `npm whoami`: npm 로그인 상태
+
+로그인 안 됨 → 안내:
+```
+npm 로그인이 필요합니다.
+터미널에서 실행: npm login
+```
+
+프로젝트에 release 스크립트나 `/release` 커맨드가 있으면 그것의 로그인 안내를 따른다.
+
+### 2. 버전 bump + commit + tag
+
+```bash
+VERSION_TYPE=patch  # 사용자 지정 시 minor/major
+npm version $VERSION_TYPE --no-git-tag-version
+git add package.json package-lock.json
+git commit -m "v{새버전}"
+git tag "v{새버전}"
+```
+
+### 3. npm publish (사용자 핸드오프)
+
+**Claude Code에서 직접 실행 불가 (OTP 브라우저 인증 필요)**
+
+사용자에게 안내:
+```
+터미널에서 실행해주세요:
+npm publish --access public --ignore-scripts
+
+브라우저 인증 완료 후 알려주세요.
+```
+
+사용자 완료 후 확인:
+```bash
+npm view {패키지명} version
+```
+
+실패 시 복구 안내:
+```
+복구: git tag -d v{새버전} && git reset --soft HEAD~1 && git checkout package.json
+```
+
+### 4. git push + GitHub Release
+
+```bash
+git push && git push --tags
+```
+
+GitHub Release 생성 (이전 태그 이후 커밋 기반 노트).
+
+### 5. 완료 보고
+
+패키지명, 버전, npm/git/GitHub Release 상태 요약.
+
+## Common Mistakes
+
+| 실수 | 해결 |
+|------|------|
+| Claude Code에서 npm publish 직접 실행 | OTP URL이 마스킹됨. 반드시 사용자 터미널로 넘길 것 |
+| package.json에 `"publish"` lifecycle script | `--ignore-scripts`로 재귀 호출 방지 |
+| publish 에러 코드만 보고 실패 판정 | `npm view`로 실제 배포 여부 재확인 |

package/CLAUDE.md

@@ -0,0 +1,83 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+Microsoft react-native-code-push의 알고케어 포크. AWS S3/CDN 기반 자체 CodePush 배포 시스템으로, 네이티브 모듈(iOS/Android)이 런타임에 JS 번들 업데이트를 확인·다운로드·설치하고, CLI가 번들 생성·업로드·히스토리 관리를 담당한다.
+
+## Commands
+
+```bash
+# 테스트
+npm run jest                    # versioning 단위 테스트 (Jest)
+npm test                        # 전체 테스트 (빌드 → 셋업 → 실행)
+npm run test:ios                # iOS 통합 테스트
+npm run test:android            # Android 통합 테스트
+
+# 린트
+npm run eslint                  # ESLint (eslint.config.mjs, 플랫 설정)
+npm run tslint                  # TSLint (test/ 디렉토리)
+
+# 빌드
+npm run build:tests             # tsc로 테스트 빌드
+
+# npm 배포 — `/release` 커맨드 또는 "배포해줘"로 실행
+# 상세 워크플로우: .claude/commands/release.md 참조
+npm run release              # patch (기본)
+npm run release -- minor     # minor
+npm run release -- major     # major
+```
+
+## Architecture
+
+### JS ↔ Native 브릿지
+
+```
+CodePush.js (진입점, sync/checkForUpdate/HOC)
+  └─ package-mixins.js (remote.download, local.install)
+       └─ NativeCodePush (RCT_EXPORT_METHOD)
+            ├─ iOS: CodePush.m → CodePushPackage.m → CodePushDownloadHandler.m
+            └─ Android: CodePushNativeModule.java → CodePushUpdateManager.java
+```
+
+- `CodePush.js`: `sync()`, `checkForUpdate()`, SyncStatus/InstallMode 상수, React HOC (`codePush()`)
+- `package-mixins.js`: 네이티브 이벤트(`CodePushDownloadProgress`, `CodePushDownloadComplete`) 구독하여 다운로드 진행률 전달
+- 네이티브 모듈은 `RCT_EXPORT_METHOD`로 JS에 노출, `NativeEventEmitter`로 이벤트 전달
+
+### 업데이트 흐름
+
+1. `checkForUpdate()` → `releaseHistoryFetcher`로 릴리스 히스토리 JSON 조회
+2. `versioning/` 모듈이 버전 비교·필수 업데이트·롤백 판단 (`SemverVersioning` 기본)
+3. `remotePackage.download()` → 네이티브 다운로드 → unzip → `LocalPackage` 반환
+4. `localPackage.install(installMode)` → InstallMode에 따라 즉시/다음 재시작 시 적용
+
+### CLI (`cli/index.js`, `code-push` 명령)
+
+주요 명령: `bundle`, `release`, `create-history`, `update-history`, `show-history`, `get-package-hash`
+
+`code-push.config.ts`에서 앱별(user, device, b2c-device, home-device, home-mobile) S3 경로·CDN URL·환경(STG/PRD) 설정.
+
+### 앱별 설정
+
+| 앱 | 타입 | 플랫폼 | 환경변수 |
+|---|---|---|---|
+| user | B2B | iOS/Android | Infisical |
+| device | B2B | Android | Infisical |
+| b2c-device | B2C MVP | Android | Infisical |
+| home-device | B2C Home | Android | .env |
+| home-mobile | B2C Home | iOS/Android | .env |
+
+### Versioning (`versioning/`)
+
+- `BaseVersioning.js` - 릴리스 히스토리 정렬/필터/롤백 로직 (추상)
+- `SemverVersioning.js` - Semver 기반 (기본값)
+- `IncrementalVersioning.js` - 증분 버전 관리
+
+## Key Conventions
+
+- 패키지: `@algocare/react-native-code-push` (npm scoped, public)
+- iOS 네이티브: Objective-C, `NSURLSession` 기반 다운로드, `SSZipArchive`로 unzip
+- Android 네이티브: Java, `com.microsoft.codepush.react` 패키지
+- TypeScript 타입: `typings/react-native-code-push.d.ts`
+- CocoaPods: `CodePush.podspec`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algocare/react-native-code-push",
-  "version": "12.6.3",
+  "version": "12.6.4",
   "description": "React Native plugin for the CodePush service",
   "main": "CodePush.js",
   "typings": "typings/react-native-code-push.d.ts",
@@ -32,7 +32,7 @@
     "test:debugger:android": "mocha --recursive --inspect-brk=0.0.0.0 bin/test --android",
     "test:debugger:ios": "mocha --recursive --inspect-brk=0.0.0.0 bin/test --ios",
     "tslint": "tslint -c tslint.json test/**/*.ts",
-    "publish": "npm publish --access=public",
+    "release": "bash scripts/release.sh",
     "eslint": "eslint --quiet .",
     "jest": "jest versioning/*"
   },

package/scripts/release.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+set -euo pipefail
+
+# npm 배포 + GitHub Release 자동화
+# 사용법: npm run release [-- patch|minor|major]
+
+VERSION_TYPE="${1:-patch}"
+VALID_TYPES=("patch" "minor" "major")
+
+if [[ ! " ${VALID_TYPES[*]} " =~ " ${VERSION_TYPE} " ]]; then
+  echo "Error: Invalid version type '${VERSION_TYPE}'. Use: patch, minor, major"
+  exit 1
+fi
+
+PACKAGE_NAME=$(node -p "require('./package.json').name")
+
+# 1. npm 로그인 확인
+if ! npm whoami &>/dev/null; then
+  echo "npm 로그인이 필요합니다."
+  echo "계정 정보: https://www.notion.so/algocare/npm-1d59954bcc7b8056b6b6c84612592266"
+  npm login --scope=@algocare
+fi
+
+# 2. clean working tree 확인
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Error: Working tree is not clean. Commit or stash changes first."
+  exit 1
+fi
+
+# 3. master 브랜치 확인
+CURRENT_BRANCH=$(git branch --show-current)
+if [[ "${CURRENT_BRANCH}" != "master" ]]; then
+  echo "Error: Must be on master branch. Current: ${CURRENT_BRANCH}"
+  exit 1
+fi
+
+# 4. 버전 bump
+NEW_VERSION=$(npm version "${VERSION_TYPE}" --no-git-tag-version)
+echo "Bumped to ${NEW_VERSION}"
+
+# 5. commit + tag
+git add package.json
+git commit -m "${NEW_VERSION}"
+git tag "${NEW_VERSION}"
+
+# 6. npm publish (OTP/브라우저 인증 시 에러 코드 반환 후 백그라운드에서 성공할 수 있음)
+echo "Publishing to npm..."
+if ! npm publish --access public --ignore-scripts; then
+  echo "npm publish가 에러를 반환했습니다. 실제 배포 여부 확인 중..."
+  sleep 3
+  PUBLISHED=$(npm view "${PACKAGE_NAME}@${NEW_VERSION}" version 2>/dev/null || true)
+  if [[ "${PUBLISHED}" == "${NEW_VERSION#v}" ]]; then
+    echo "확인 완료: ${NEW_VERSION} 이미 배포되어 있습니다. 계속 진행합니다."
+  else
+    echo "Error: npm publish 실패. 수동으로 확인해주세요."
+    echo "복구: git tag -d ${NEW_VERSION} && git reset --soft HEAD~1"
+    exit 1
+  fi
+fi
+
+# 7. git push
+if ! git push || ! git push --tags; then
+  echo "Error: git push 실패. npm에는 이미 배포됨."
+  echo "수동으로 push해주세요: git push && git push --tags"
+  exit 1
+fi
+
+# 8. GitHub Release (최근 태그 이후 커밋 기반 노트 생성)
+PREV_TAG=$(git tag --sort=-v:refname | sed -n '2p')
+RELEASE_NOTES=""
+
+if [[ -n "${PREV_TAG}" ]]; then
+  RELEASE_NOTES=$(git log "${PREV_TAG}..${NEW_VERSION}" --merges --pretty=format:"- %s" 2>/dev/null || true)
+fi
+
+if [[ -z "${RELEASE_NOTES}" ]]; then
+  RELEASE_NOTES=$(git log "${PREV_TAG:-HEAD~5}..${NEW_VERSION}" --no-merges --pretty=format:"- %s" 2>/dev/null | head -20)
+fi
+
+if ! gh release create "${NEW_VERSION}" --title "${NEW_VERSION#v}" --notes "${RELEASE_NOTES}"; then
+  echo "Warning: GitHub Release 생성 실패. 수동으로 생성해주세요:"
+  echo "  gh release create ${NEW_VERSION} --title \"${NEW_VERSION#v}\""
+fi
+
+echo ""
+echo "Done! ${NEW_VERSION} published and released."