@algocare/react-native-code-push 12.5.0 → 12.6.0

package/README.md

@@ -1,13 +1,260 @@
 ## @algocare/react-native-code-push
 
-Fork of `code-push-react-native`
+> `react-native-code-push`의 알고케어 커스텀 포크
+> AppCenter 없이 독립적인 CodePush 배포 시스템
 
 ```bash
 npm install @algocare/react-native-code-push
 ```
 
-You'll have more flexibility and freedom in your deployment strategy.
-You can still use CodePush, but become independent of AppCenter's cloud infrastructure.
+---
+
+## 🚀 빠른 시작 (5분 안에 설정 완료!)
+
+### 1단계: 패키지 설치
+
+```bash
+npm install @algocare/react-native-code-push
+```
+
+### 2단계: 환경변수 설정
+
+#### B2C Home 프로젝트만 (`.env` 파일 사용)
+
+`home-device`, `home-mobile` 프로젝트만 `.env` 파일 생성:
+
+```bash
+# AWS 자격 증명
+AWS_ACCESS_KEY_ID=your_aws_access_key_here
+AWS_SECRET_ACCESS_KEY=your_aws_secret_key_here
+AWS_REGION=ap-northeast-2
+
+# STG/PRD 환경별 설정
+AWS_S3_BUCKET_STG=your-stg-bucket-name
+AWS_S3_BUCKET_PRD=your-prd-bucket-name
+CDN_URL_STG=https://your-stg-cdn-url.com
+CDN_URL_PRD=https://your-prd-cdn-url.com
+```
+
+⚠️ **실제 값은 팀 내부에서 공유받으세요!**
+
+#### B2B + B2C MVP (Infisical 사용)
+
+`user`, `device`, `b2c-device` 프로젝트는 Infisical 사용:
+
+```bash
+# Infisical에서 자동으로 .env 파일 생성
+yarn set:stg  # STG 환경변수 로드
+yarn set:prd  # PRD 환경변수 로드
+```
+
+Infisical에 이미 모든 환경변수가 설정되어 있습니다.
+
+⚠️ **중요**: `.env` 파일을 `.gitignore`에 추가하세요!
+
+```bash
+echo ".env" >> .gitignore
+```
+
+### 3단계: package.json에 스크립트 추가
+
+```json
+{
+  "scripts": {
+    "codepush:release": "sh scripts/codepush.sh release",
+    "codepush:release:prd": "sh scripts/codepush.sh release --env=prd",
+    "codepush:show": "sh scripts/codepush.sh show",
+    "codepush:show:prd": "sh scripts/codepush.sh show --env=prd"
+  }
+}
+```
+
+### 4단계: 배포!
+
+```bash
+# Staging 환경에 배포
+npm run codepush:release
+
+# Production 환경에 배포
+npm run codepush:release:prd
+```
+
+**끝!** 더 이상 추가 설정 파일이 필요 없습니다. 🎉
+
+---
+
+## 📱 지원하는 앱
+
+| 앱 이름 | 설명 | 플랫폼 | 환경 관리 |
+|---------|------|--------|----------|
+| `user` | B2B 모바일 앱 | iOS, Android | Infisical (STG/PRD) |
+| `device` | B2B 디바이스 앱 | Android | Infisical (STG/PRD) |
+| `b2c-device` | B2C MVP 디바이스 앱 | Android | Infisical (STG/PRD) |
+| `home-device` | B2C Home (상용) 디바이스 앱 | Android | .env 파일 (STG/PRD) |
+| `home-mobile` | B2C Home (상용) 모바일 앱 | iOS, Android | .env 파일 (STG/PRD) |
+
+> **모든 앱이 STG/PRD 환경을 구분합니다!**
+> - **B2B + B2C MVP**: Infisical로 환경변수 관리
+> - **B2C Home**: .env 파일로 환경변수 관리
+
+---
+
+## ⚙️ 작동 원리
+
+### 환경 자동 선택
+
+패키지가 자동으로 다음을 수행합니다:
+
+1. `.env` 파일에서 AWS 자격증명 로드
+2. `-i` 플래그로 환경 구분 (stg/prd)
+3. 적절한 S3 버킷과 CDN URL 선택
+4. 번들을 업로드하고 히스토리 관리
+
+### 환경변수 우선순위
+
+```javascript
+// STG 환경
+-i stg → AWS_S3_BUCKET_STG, CDN_URL_STG
+
+// PRD 환경
+-i prd → AWS_S3_BUCKET_PRD, CDN_URL_PRD
+
+// 레거시 호환성 (옵션)
+AWS_S3_BUCKET, CDN_URL // identifier 없이 사용 가능
+```
+
+---
+
+## 🔧 상세 설정
+
+### B2C Home 프로젝트 (`.env` 파일)
+
+**home-device, home-mobile**
+
+`.env` 파일:
+```bash
+AWS_S3_BUCKET_STG=your-stg-bucket-name
+AWS_S3_BUCKET_PRD=your-prd-bucket-name
+CDN_URL_STG=https://your-stg-cdn-url.com
+CDN_URL_PRD=https://your-prd-cdn-url.com
+```
+
+사용:
+```bash
+npm run codepush:release        # STG 배포
+npm run codepush:release:prd    # PRD 배포
+```
+
+### B2B + B2C MVP (Infisical)
+
+**user, device, b2c-device**
+
+```bash
+# package.json 스크립트
+{
+  "scripts": {
+    "set:stg": "infisical export --env=stg > .env",
+    "set:prd": "infisical export --env=prd > .env",
+    "codepush:stg": "yarn set:stg && npx code-push release -i stg",
+    "codepush:prd": "yarn set:prd && npx code-push release -i prd"
+  }
+}
+```
+
+사용:
+```bash
+yarn codepush:stg  # STG 배포
+yarn codepush:prd  # PRD 배포
+```
+
+---
+
+## 📝 예제 Scripts
+
+### 기본 배포 스크립트 (`scripts/codepush.sh`)
+
+```bash
+#!/bin/bash
+
+ENV="stg"
+COMMAND=""
+ADDITIONAL_ARGS="-a home-mobile -i $ENV"
+
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        create|update|show|release) COMMAND="$1";;
+        --env=*) ENV="${1#*=}"
+        ADDITIONAL_ARGS="-a home-mobile -i $ENV"
+        ;;
+        *) ADDITIONAL_ARGS="$ADDITIONAL_ARGS $1";;
+    esac
+    shift
+done
+
+if [ "$COMMAND" = "release" ]; then
+    npx code-push release $ADDITIONAL_ARGS
+else
+    npx code-push $COMMAND-history $ADDITIONAL_ARGS
+fi
+```
+
+---
+
+## 🆚 기존 방식과의 차이
+
+### ❌ 기존 방식 (복잡함)
+
+1. 프로젝트마다 `code-push.config.js` 파일 생성
+2. AWS 키 하드코딩 (보안 위험)
+3. `postinstall` 스크립트로 파일 복사
+4. 환경별로 다른 설정 파일 관리
+
+### ✅ 새로운 방식 (간단함)
+
+1. `.env` 파일 하나만 생성
+2. AWS 키 안전하게 관리
+3. 추가 설정 파일 불필요
+4. 환경변수로 자동 전환
+
+---
+
+## 🔍 트러블슈팅
+
+### CodePush 실행 시 "AWS credentials not found" 에러
+
+**원인**: `.env` 파일이 없거나 환경변수가 설정되지 않음
+
+**해결**:
+```bash
+# .env 파일 확인
+cat .env
+
+# 환경변수 설정 확인
+echo $AWS_ACCESS_KEY_ID
+```
+
+### S3 업로드 실패 (403 Forbidden)
+
+**원인**: AWS 자격증명이 잘못되었거나 권한 부족
+
+**해결**:
+1. `.env` 파일의 AWS 키 확인
+2. IAM 사용자 권한 확인 (S3 PutObject 필요)
+
+### 잘못된 환경에 배포됨
+
+**원인**: `-i` 플래그를 잘못 지정
+
+**해결**:
+```bash
+# STG 배포
+npm run codepush:release        # -i stg (기본값)
+
+# PRD 배포
+npm run codepush:release:prd    # -i prd
+```
+
+---
 
 ### Self-host the update bundle file
 

package/code-push.config.js

@@ -10,16 +10,52 @@ const fs = require('fs')
 const axios = require('axios')
 require('dotenv').config()
 
+// CLI 인자에서 identifier 추출 (패키지 버그 workaround)
+function getIdentifierFromArgs() {
+  const args = process.argv
+  const identifierIndex = args.findIndex(arg => arg === '-i' || arg === '--identifier')
+  if (identifierIndex !== -1 && args[identifierIndex + 1]) {
+    return args[identifierIndex + 1]
+  }
+  // --identifier=prd 형태 처리
+  const identifierArg = args.find(arg => arg.startsWith('--identifier='))
+  if (identifierArg) {
+    return identifierArg.split('=')[1]
+  }
+  return 'stg' // 기본값
+}
+
 const s3Client = new S3Client({
-  region: process.env.AWS_REGION,
+  region: process.env.AWS_REGION || 'ap-northeast-2',
   credentials: {
     accessKeyId: process.env.AWS_ACCESS_KEY_ID,
     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
   },
 })
 
-const BUCKET_NAME = process.env.AWS_S3_BUCKET || 'codepush-bucket'
-const CDN_URL = process.env.CDN_URL || `https://${BUCKET_NAME}.s3.amazonaws.com`
+function getBucketName(identifier) {
+  // Legacy support: AWS_S3_BUCKET (단일 버킷)
+  if (process.env.AWS_S3_BUCKET) {
+    return process.env.AWS_S3_BUCKET
+  }
+
+  const actualIdentifier = identifier || getIdentifierFromArgs()
+  return actualIdentifier === 'prd'
+    ? process.env.AWS_S3_BUCKET_PRD || 'a-algocare-c-prd'
+    : process.env.AWS_S3_BUCKET_STG || 'a-algocare-b-stg'
+}
+
+function getCDNUrl(identifier) {
+  // Legacy support: CDN_URL (단일 CDN)
+  if (process.env.CDN_URL) {
+    return process.env.CDN_URL
+  }
+
+  const actualIdentifier = identifier || getIdentifierFromArgs()
+  return actualIdentifier === 'prd'
+    ? process.env.CDN_URL_PRD || 'https://contents.algocare.link'
+    : process.env.CDN_URL_STG || 'https://contents-stg.algocare.link'
+}
 
 function historyJsonFileRemotePath(app, platform, binaryVersion) {
   return `histories/${app}/${platform}/${binaryVersion}.json`
@@ -30,10 +66,19 @@ function bundleFileRemotePath(app, platform, fileName) {
 }
 
 const Config = {
-  bundleUploader: async (source, app, platform) => {
+  bundleUploader: async (source, app, platform, identifier) => {
+    const actualIdentifier = identifier || getIdentifierFromArgs()
     const fileName = source.split('/').pop()
     const fileContent = fs.readFileSync(source)
     const remotePath = bundleFileRemotePath(app, platform, fileName)
+    const BUCKET_NAME = getBucketName(actualIdentifier)
+    const CDN_URL = getCDNUrl(actualIdentifier)
+
+    console.log(`🔧 S3 업로드 설정:`)
+    console.log(`   - Identifier: ${actualIdentifier}`)
+    console.log(`   - Bucket: ${BUCKET_NAME}`)
+    console.log(`   - Region: ${process.env.AWS_REGION || 'ap-northeast-2'}`)
+    console.log(`   - Remote Path: ${remotePath}`)
 
     try {
       await s3Client.send(
@@ -55,7 +100,9 @@ const Config = {
       throw error
     }
   },
-  getReleaseHistory: async (app, targetBinaryVersion, platform) => {
+  getReleaseHistory: async (app, targetBinaryVersion, platform, identifier) => {
+    const actualIdentifier = identifier || getIdentifierFromArgs()
+    const CDN_URL = getCDNUrl(actualIdentifier)
     const remoteJsonPath = historyJsonFileRemotePath(
       app,
       platform,
@@ -69,8 +116,12 @@ const Config = {
     jsonFilePath,
     releaseInfo,
     app,
-    platform
+    platform,
+    identifier
   ) => {
+    const actualIdentifier = identifier || getIdentifierFromArgs()
+    const BUCKET_NAME = getBucketName(actualIdentifier)
+    const CDN_URL = getCDNUrl(actualIdentifier)
     const fileContent = fs.readFileSync(jsonFilePath, 'utf8')
     const remoteJsonPath = historyJsonFileRemotePath(
       app,
@@ -98,7 +149,9 @@ const Config = {
       throw error
     }
   },
-  getBinaryVersionList: async (app, platform) => {
+  getBinaryVersionList: async (app, platform, identifier) => {
+    const actualIdentifier = identifier || getIdentifierFromArgs()
+    const CDN_URL = getCDNUrl(actualIdentifier)
     const remoteJsonPath = `histories/${app}/${platform}/list.json`
     let currentList = {}
     try {
@@ -113,7 +166,10 @@ const Config = {
     }
     return currentList
   },
-  setBinaryVersionList: async (targetVersion, jsonFilePath, app, platform) => {
+  setBinaryVersionList: async (targetVersion, jsonFilePath, app, platform, identifier) => {
+    const actualIdentifier = identifier || getIdentifierFromArgs()
+    const BUCKET_NAME = getBucketName(actualIdentifier)
+    const CDN_URL = getCDNUrl(actualIdentifier)
     const remoteJsonPath = `histories/${app}/${platform}/list.json`
 
     const currentList = JSON.parse(fs.readFileSync(jsonFilePath, 'utf8'))
@@ -146,7 +202,10 @@ const Config = {
       throw error
     }
   },
-  removeReleaseHistory: async (app, targetBinaryVersion, platform) => {
+  removeReleaseHistory: async (app, targetBinaryVersion, platform, identifier) => {
+    const actualIdentifier = identifier || getIdentifierFromArgs()
+    const BUCKET_NAME = getBucketName(actualIdentifier)
+    const CDN_URL = getCDNUrl(actualIdentifier)
     const remoteJsonPath = historyJsonFileRemotePath(
       app,
       platform,

package/code-push.config.ts

@@ -7,27 +7,55 @@ import {
 } from '@algocare/react-native-code-push'
 import * as fs from 'fs'
 import axios from 'axios'
-import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3'
+import { S3Client, PutObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3'
+import * as dotenv from 'dotenv'
+dotenv.config()
+
+// CLI 인자에서 identifier 추출 (패키지 버그 workaround)
+function getIdentifierFromArgs(): 'stg' | 'prd' {
+  const args = process.argv
+  const identifierIndex = args.findIndex(arg => arg === '-i' || arg === '--identifier')
+  if (identifierIndex !== -1 && args[identifierIndex + 1]) {
+    return args[identifierIndex + 1] as 'stg' | 'prd'
+  }
+  // --identifier=prd 형태 처리
+  const identifierArg = args.find(arg => arg.startsWith('--identifier='))
+  if (identifierArg) {
+    return identifierArg.split('=')[1] as 'stg' | 'prd'
+  }
+  return 'stg' // 기본값
+}
 
 const s3Client = new S3Client({
-  region: process.env.AWS_REGION,
+  region: process.env.AWS_REGION || 'ap-northeast-2',
   credentials: {
     accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
   },
 })
 
-function getBucketName(identifier: 'stg' | 'prd') {
-  return identifier === 'prd'
-    ? process.env.AWS_S3_BUCKET_PRD || 'codepush-bucket'
-    : process.env.AWS_S3_BUCKET_STG || 'codepush-bucket'
+function getBucketName(identifier?: 'stg' | 'prd') {
+  // Legacy support: AWS_S3_BUCKET (단일 버킷)
+  if (process.env.AWS_S3_BUCKET) {
+    return process.env.AWS_S3_BUCKET
+  }
+
+  const actualIdentifier = identifier || getIdentifierFromArgs()
+  return actualIdentifier === 'prd'
+    ? process.env.AWS_S3_BUCKET_PRD || 'a-algocare-c-prd'
+    : process.env.AWS_S3_BUCKET_STG || 'a-algocare-b-stg'
 }
 
-function getCDNUrl(identifier: 'stg' | 'prd') {
-  const BUCKET_NAME = getBucketName(identifier)
-  return identifier === 'prd'
-    ? process.env.CDN_URL_PRD || `https://${BUCKET_NAME}.s3.amazonaws.com`
-    : process.env.CDN_URL_STG || `https://${BUCKET_NAME}.s3.amazonaws.com`
+function getCDNUrl(identifier?: 'stg' | 'prd') {
+  // Legacy support: CDN_URL (단일 CDN)
+  if (process.env.CDN_URL) {
+    return process.env.CDN_URL
+  }
+
+  const actualIdentifier = identifier || getIdentifierFromArgs()
+  return actualIdentifier === 'prd'
+    ? process.env.CDN_URL_PRD || 'https://contents.algocare.link'
+    : process.env.CDN_URL_STG || 'https://contents-stg.algocare.link'
 }
 
 function historyJsonFileRemotePath(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algocare/react-native-code-push",
-  "version": "12.5.0",
+  "version": "12.6.0",
   "description": "React Native plugin for the CodePush service",
   "main": "CodePush.js",
   "typings": "typings/react-native-code-push.d.ts",