@algocare/react-native-code-push 12.6.2 → 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/CodePush.js

@@ -586,6 +586,9 @@ async function syncInternal(
                 }
               }
               break
+            case CodePush.SyncStatus.PREPARING_UPDATE:
+              log('Download complete. Preparing update (unzip/file-copy).')
+              break
             case CodePush.SyncStatus.UNKNOWN_ERROR:
               log('An unknown error occurred.')
               break
@@ -608,7 +611,11 @@ async function syncInternal(
     const doDownloadAndInstall = async () => {
       syncStatusChangeCallback(CodePush.SyncStatus.DOWNLOADING_PACKAGE)
       const localPackage = await remotePackage.download(
-        downloadProgressCallback
+        downloadProgressCallback,
+        () => {
+          // HTTP download complete, post-processing (unzip/file-copy) starts
+          syncStatusChangeCallback(CodePush.SyncStatus.PREPARING_UPDATE)
+        }
       )
 
       // Determine the correct install mode based on whether the update is mandatory or not.
@@ -924,6 +931,7 @@ if (NativeCodePush) {
       AWAITING_USER_ACTION: 6,
       DOWNLOADING_PACKAGE: 7,
       INSTALLING_UPDATE: 8,
+      PREPARING_UPDATE: 9, // HTTP download complete, post-processing (unzip/file-copy) in progress
     },
     CheckFrequency: {
       ON_APP_START: 0,

package/ios/CodePush/CodePush.h

@@ -108,9 +108,9 @@
 
 @end
 
-@interface CodePushDownloadHandler : NSObject <NSURLConnectionDelegate>
+@interface CodePushDownloadHandler : NSObject <NSURLSessionDownloadDelegate>
 
-@property (strong) NSOutputStream *outputFileStream;
+@property (strong) NSString *downloadFilePath;
 @property long long expectedContentLength;
 @property long long receivedContentLength;
 @property dispatch_queue_t operationQueue;
@@ -144,7 +144,9 @@ failCallback:(void (^)(NSError *err))failCallback;
          operationQueue:(dispatch_queue_t)operationQueue
        progressCallback:(void (^)(long long, long long))progressCallback
            doneCallback:(void (^)())doneCallback
-           failCallback:(void (^)(NSError *err))failCallback;
+           failCallback:(void (^)(NSError *err))failCallback
+installProgressCallback:(void (^)(NSString *, NSNumber *, NSNumber *))installProgressCallback
+downloadCompleteCallback:(void (^)())downloadCompleteCallback;
 
 + (NSDictionary *)getCurrentPackage:(NSError **)error;
 + (NSDictionary *)getPreviousPackage:(NSError **)error;

package/ios/CodePush/CodePush.m

@@ -43,6 +43,8 @@ RCT_EXPORT_MODULE()
 
 // These constants represent emitted events
 static NSString *const DownloadProgressEvent = @"CodePushDownloadProgress";
+static NSString *const DownloadCompleteEvent = @"CodePushDownloadComplete";
+static NSString *const InstallProgressEvent = @"CodePushInstallProgress";
 
 // These constants represent valid deployment statuses
 static NSString *const DeploymentFailed = @"DeploymentFailed";
@@ -640,7 +642,7 @@ static NSString *const LatestRollbackCountKey = @"count";
 }
 
 - (NSArray<NSString *> *)supportedEvents {
-    return @[DownloadProgressEvent];
+    return @[DownloadProgressEvent, DownloadCompleteEvent, InstallProgressEvent];
 }
 
 // Determine how long the app was in the background
@@ -726,6 +728,17 @@ RCT_EXPORT_METHOD(downloadUpdate:(NSDictionary*)updatePackage
 
     NSString * publicKey = [[CodePushConfig current] publicKey];
 
+    // Install progress callback for reporting unzip/file-copy progress to JS
+    void (^installProgressCallback)(NSString *, NSNumber *, NSNumber *) =
+        ^(NSString *phase, NSNumber *current, NSNumber *total) {
+            dispatch_async(dispatch_get_main_queue(), ^{
+                [self sendEventWithName:InstallProgressEvent
+                                   body:@{@"phase": phase,
+                                          @"current": current,
+                                          @"total": total}];
+            });
+        };
+
     [CodePushPackage
         downloadPackage:mutableUpdatePackage
         expectedBundleFileName:[bundleResourceName stringByAppendingPathExtension:bundleResourceExtension]
@@ -746,7 +759,7 @@ RCT_EXPORT_METHOD(downloadUpdate:(NSDictionary*)updatePackage
                 [self dispatchDownloadProgressEvent];
             }
         }
-        // The download completed
+        // The download and post-processing completed
         doneCallback:^{
             NSError *err;
             NSDictionary *newPackage = [CodePushPackage getPackage:mutableUpdatePackage[PackageHashKey] error:&err];
@@ -766,6 +779,14 @@ RCT_EXPORT_METHOD(downloadUpdate:(NSDictionary*)updatePackage
             _didUpdateProgress = NO;
             self.paused = YES;
             reject([NSString stringWithFormat: @"%lu", (long)err.code], err.localizedDescription, err);
+        }
+        // Install progress (unzip/file-copy) callback
+        installProgressCallback:installProgressCallback
+        // Notify JS that HTTP download is complete and post-processing begins
+        downloadCompleteCallback:^{
+            dispatch_async(dispatch_get_main_queue(), ^{
+                [self sendEventWithName:DownloadCompleteEvent body:@{}];
+            });
         }];
 }
 

package/ios/CodePush/CodePushDownloadHandler.m

@@ -1,8 +1,10 @@
 #import "CodePush.h"
 
+static const NSTimeInterval kDownloadTimeoutInterval = 60.0;
+
 @implementation CodePushDownloadHandler {
-    // Header chars used to determine if the file is a zip.
-    char _header[4];
+    NSURLSession *_session;
+    BOOL _completed; // 콜백 중복 호출 방지 플래그
 }
 
 - (id)init:(NSString *)downloadFilePath
@@ -10,121 +12,141 @@ operationQueue:(dispatch_queue_t)operationQueue
 progressCallback:(void (^)(long long, long long))progressCallback
 doneCallback:(void (^)(BOOL))doneCallback
 failCallback:(void (^)(NSError *err))failCallback {
-    self.outputFileStream = [NSOutputStream outputStreamToFileAtPath:downloadFilePath
-                                                              append:NO];
-    self.receivedContentLength = 0;
-    self.operationQueue = operationQueue;
-    self.progressCallback = progressCallback;
-    self.doneCallback = doneCallback;
-    self.failCallback = failCallback;
+    self = [super init];
+    if (self) {
+        self.downloadFilePath = downloadFilePath;
+        self.receivedContentLength = 0;
+        self.expectedContentLength = 0;
+        self.operationQueue = operationQueue;
+        self.progressCallback = progressCallback;
+        self.doneCallback = doneCallback;
+        self.failCallback = failCallback;
+        _completed = NO;
+    }
     return self;
 }
 
 - (void)download:(NSString *)url {
     self.downloadUrl = url;
+    NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
+    config.timeoutIntervalForRequest = kDownloadTimeoutInterval;
+
+    NSOperationQueue *delegateQueue = [NSOperationQueue new];
+    delegateQueue.underlyingQueue = self.operationQueue;
+
+    _session = [NSURLSession sessionWithConfiguration:config
+                                             delegate:self
+                                        delegateQueue:delegateQueue];
+
     NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:url]
                                              cachePolicy:NSURLRequestUseProtocolCachePolicy
-                                         timeoutInterval:60.0];
-    NSURLConnection *connection = [[NSURLConnection alloc] initWithRequest:request
-                                                                  delegate:self
-                                                          startImmediately:NO];
-    if ([NSOperationQueue instancesRespondToSelector:@selector(setUnderlyingQueue:)]) {
-        NSOperationQueue *delegateQueue = [NSOperationQueue new];
-        delegateQueue.underlyingQueue = self.operationQueue;
-        [connection setDelegateQueue:delegateQueue];
-    } else {
-        [connection scheduleInRunLoop:[NSRunLoop mainRunLoop]
-                              forMode:NSDefaultRunLoopMode];
-    }
+                                         timeoutInterval:kDownloadTimeoutInterval];
+    NSURLSessionDownloadTask *task = [_session downloadTaskWithRequest:request];
+    [task resume];
+}
 
-    [connection start];
+- (void)invokeFailCallback:(NSError *)error {
+    if (_completed) return;
+    _completed = YES;
+    if (self.failCallback) {
+        self.failCallback(error);
+    }
 }
 
-#pragma mark NSURLConnection Delegate Methods
+- (void)invokeDoneCallback:(BOOL)isZip {
+    if (_completed) return;
+    _completed = YES;
+    if (self.doneCallback) {
+        self.doneCallback(isZip);
+    }
+}
 
-- (NSCachedURLResponse *)connection:(NSURLConnection *)connection
-                  willCacheResponse:(NSCachedURLResponse*)cachedResponse {
-    // Return nil to indicate not necessary to store a cached response for this connection
-    return nil;
+#pragma mark - NSURLSessionDownloadDelegate
+
+- (void)URLSession:(NSURLSession *)session
+      downloadTask:(NSURLSessionDownloadTask *)downloadTask
+      didWriteData:(int64_t)bytesWritten
+ totalBytesWritten:(int64_t)totalBytesWritten
+totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite {
+    self.expectedContentLength = totalBytesExpectedToWrite;
+    self.receivedContentLength = totalBytesWritten;
+    if (self.progressCallback) {
+        self.progressCallback(self.expectedContentLength, self.receivedContentLength);
+    }
 }
 
-- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {
-    if ([response isKindOfClass:[NSHTTPURLResponse class]]) {
-        NSInteger statusCode = [(NSHTTPURLResponse *)response statusCode];
+- (void)URLSession:(NSURLSession *)session
+      downloadTask:(NSURLSessionDownloadTask *)downloadTask
+didFinishDownloadingToURL:(NSURL *)location {
+    // Check HTTP status code
+    if ([downloadTask.response isKindOfClass:[NSHTTPURLResponse class]]) {
+        NSInteger statusCode = ((NSHTTPURLResponse *)downloadTask.response).statusCode;
         if (statusCode >= 400) {
-            [self.outputFileStream close];
-            [connection cancel];
-            NSError *err = [CodePushErrorUtils errorWithMessage:[NSString stringWithFormat: @"Received %ld response from %@", (long)statusCode, self.downloadUrl]];
-            self.failCallback(err);
+            NSError *err = [CodePushErrorUtils errorWithMessage:
+                            [NSString stringWithFormat:@"Received %ld response from %@",
+                             (long)statusCode, self.downloadUrl]];
+            [self invokeFailCallback:err];
             return;
         }
     }
-    
-    self.expectedContentLength = response.expectedContentLength;
-    [self.outputFileStream open];
-}
 
-- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {
-    if (self.receivedContentLength < 4) {
-        for (int i = 0; i < [data length]; i++) {
-            int headerOffset = (int)self.receivedContentLength + i;
-            if (headerOffset >= 4) {
-                break;
-            }
+    // Move downloaded file from temporary location to our target path
+    NSFileManager *fileManager = [NSFileManager defaultManager];
+    NSError *moveError = nil;
 
-            const char *bytes = [data bytes];
-            _header[headerOffset] = bytes[i];
-        }
+    // Remove existing file if present
+    if ([fileManager fileExistsAtPath:self.downloadFilePath]) {
+        [fileManager removeItemAtPath:self.downloadFilePath error:nil];
     }
 
-    self.receivedContentLength = self.receivedContentLength + [data length];
-
-    NSInteger bytesLeft = [data length];
+    [fileManager moveItemAtURL:location
+                         toURL:[NSURL fileURLWithPath:self.downloadFilePath]
+                         error:&moveError];
 
-    do {
-        NSInteger bytesWritten = [self.outputFileStream write:[data bytes]
-                                                     maxLength:bytesLeft];
-        if (bytesWritten == -1) {
-            break;
-        }
-
-        bytesLeft -= bytesWritten;
-    } while (bytesLeft > 0);
+    if (moveError) {
+        [self invokeFailCallback:moveError];
+        return;
+    }
 
-    self.progressCallback(self.expectedContentLength, self.receivedContentLength);
+    if (self.receivedContentLength < 1) {
+        NSError *err = [CodePushErrorUtils errorWithMessage:
+                        [NSString stringWithFormat:@"Received empty response from %@",
+                         self.downloadUrl]];
+        [self invokeFailCallback:err];
+        return;
+    }
 
-    // bytesLeft should not be negative.
-    assert(bytesLeft >= 0);
+    // Determine if the downloaded file is a ZIP by reading its header
+    BOOL isZip = NO;
+    NSFileHandle *fileHandle = [NSFileHandle fileHandleForReadingAtPath:self.downloadFilePath];
+    if (fileHandle) {
+        NSData *headerData = [fileHandle readDataOfLength:4];
+        [fileHandle closeFile];
+        if (headerData.length >= 4) {
+            const char *bytes = [headerData bytes];
+            isZip = bytes[0] == 'P' && bytes[1] == 'K' && bytes[2] == 3 && bytes[3] == 4;
+        }
+    }
 
-    if (bytesLeft) {
-        [self.outputFileStream close];
-        [connection cancel];
-        self.failCallback([self.outputFileStream streamError]);
+    // Send final 100% progress callback
+    // Use receivedContentLength for both args to guarantee expected == received at completion
+    if (self.progressCallback) {
+        self.progressCallback(self.receivedContentLength, self.receivedContentLength);
     }
-}
 
-- (void)connection:(NSURLConnection*)connection didFailWithError:(NSError*)error
-{
-    [self.outputFileStream close];
-    self.failCallback(error);
+    [self invokeDoneCallback:isZip];
 }
 
-- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
-    [self.outputFileStream close];
-    if (self.receivedContentLength < 1) {
-        NSError *err = [CodePushErrorUtils errorWithMessage:[NSString stringWithFormat:@"Received empty response from %@", self.downloadUrl]];
-        self.failCallback(err);
-        return;
-    }
-    
-    // expectedContentLength might be -1 when NSURLConnection don't know the length(e.g. response encode with gzip)
-    if (self.expectedContentLength > 0) {
-        // We should have received all of the bytes if this is called.
-        assert(self.receivedContentLength == self.expectedContentLength);
-    }
+#pragma mark - NSURLSessionTaskDelegate
 
-    BOOL isZip = _header[0] == 'P' && _header[1] == 'K' && _header[2] == 3 && _header[3] == 4;
-    self.doneCallback(isZip);
+- (void)URLSession:(NSURLSession *)session
+              task:(NSURLSessionTask *)task
+didCompleteWithError:(NSError *)error {
+    if (error) {
+        [self invokeFailCallback:error];
+    }
+    [session finishTasksAndInvalidate];
+    _session = nil; // Break retain cycle (NSURLSession strong-references its delegate)
 }
 
 @end

package/ios/CodePush/CodePushPackage.m

@@ -50,6 +50,8 @@ static NSString *const UnzippedFolderName = @"unzipped";
        progressCallback:(void (^)(long long, long long))progressCallback
            doneCallback:(void (^)())doneCallback
            failCallback:(void (^)(NSError *err))failCallback
+installProgressCallback:(void (^)(NSString *, NSNumber *, NSNumber *))installProgressCallback
+downloadCompleteCallback:(void (^)())downloadCompleteCallback
 {
     NSString *newUpdateHash = updatePackage[@"packageHash"];
     NSString *newUpdateFolderPath = [self getPackageFolderPath:newUpdateHash];
@@ -85,6 +87,11 @@ static NSString *const UnzippedFolderName = @"unzipped";
                                                 operationQueue:operationQueue
                                                 progressCallback:progressCallback
                                                 doneCallback:^(BOOL isZip) {
+                                                    // HTTP 다운로드 완료 → 후처리(unzip/파일복사) 시작 전 알림
+                                                    if (downloadCompleteCallback) {
+                                                        downloadCompleteCallback();
+                                                    }
+
                                                     NSError *error = nil;
                                                     NSString * unzippedFolderPath = [CodePushPackage getUnzippedFolderPath];
                                                     NSMutableDictionary * mutableUpdatePackage = [updatePackage mutableCopy];
@@ -101,8 +108,21 @@ static NSString *const UnzippedFolderName = @"unzipped";
                                                         }
                                                         
                                                         NSError *nonFailingError = nil;
-                                                        [SSZipArchive unzipFileAtPath:downloadFilePath
-                                                                        toDestination:unzippedFolderPath];
+                                                        BOOL unzipSuccess = [SSZipArchive unzipFileAtPath:downloadFilePath
+                                                                        toDestination:unzippedFolderPath
+                                                                            overwrite:YES
+                                                                             password:nil
+                                                                      progressHandler:^(NSString *entry, unz_file_info zipInfo, long entryNumber, long total) {
+                                                                          if (installProgressCallback && total > 0) {
+                                                                              installProgressCallback(@"EXTRACTING", @(entryNumber), @(total));
+                                                                          }
+                                                                      }
+                                                                    completionHandler:nil];
+                                                        if (!unzipSuccess) {
+                                                            error = [CodePushErrorUtils errorWithMessage:@"Failed to unzip the downloaded update."];
+                                                            failCallback(error);
+                                                            return;
+                                                        }
                                                         [[NSFileManager defaultManager] removeItemAtPath:downloadFilePath
                                                                                                    error:&nonFailingError];
                                                         if (nonFailingError) {

package/package-mixins.js

@@ -7,19 +7,31 @@ import log from "./logging";
 module.exports = (NativeCodePush) => {
   const remote = () => {
     return {
-      async download(downloadProgressCallback) {
+      async download(downloadProgressCallback, downloadCompleteCallback) {
         if (!this.downloadUrl) {
           throw new Error("Cannot download an update without a download url");
         }
 
         let downloadProgressSubscription;
-        if (downloadProgressCallback) {
+        let downloadCompleteSubscription;
+        if (downloadProgressCallback || downloadCompleteCallback) {
           const codePushEventEmitter = new NativeEventEmitter(NativeCodePush);
-          // Use event subscription to obtain download progress.
-          downloadProgressSubscription = codePushEventEmitter.addListener(
-            "CodePushDownloadProgress",
-            downloadProgressCallback
-          );
+
+          if (downloadProgressCallback) {
+            // Use event subscription to obtain download progress.
+            downloadProgressSubscription = codePushEventEmitter.addListener(
+              "CodePushDownloadProgress",
+              downloadProgressCallback
+            );
+          }
+
+          if (downloadCompleteCallback) {
+            // Listen for download complete event (HTTP download done, post-processing starts)
+            downloadCompleteSubscription = codePushEventEmitter.addListener(
+              "CodePushDownloadComplete",
+              downloadCompleteCallback
+            );
+          }
         }
 
         // Use the downloaded package info. Native code will save the package info
@@ -33,6 +45,7 @@ module.exports = (NativeCodePush) => {
           return { ...downloadedPackage, ...local };
         } finally {
           downloadProgressSubscription && downloadProgressSubscription.remove();
+          downloadCompleteSubscription && downloadCompleteSubscription.remove();
         }
       },
 
@@ -58,4 +71,4 @@ module.exports = (NativeCodePush) => {
   };
 
   return { local, remote };
-};
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algocare/react-native-code-push",
-  "version": "12.6.2",
+  "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."

package/typings/react-native-code-push.d.ts

@@ -167,9 +167,11 @@ export interface RemotePackage extends Package {
    * Downloads the available update from the CodePush service.
    *
    * @param downloadProgressCallback An optional callback that allows tracking the progress of the update while it is being downloaded.
+   * @param downloadCompleteCallback An optional callback that is called when the HTTP download completes and post-processing begins (iOS only).
    */
   download(
-    downloadProgressCallback?: DownloadProgressCallback
+    downloadProgressCallback?: DownloadProgressCallback,
+    downloadCompleteCallback?: () => void
   ): Promise<LocalPackage>
 
   /**
@@ -490,6 +492,12 @@ declare namespace CodePush {
      * An available update was downloaded and is about to be installed.
      */
     INSTALLING_UPDATE,
+
+    /**
+     * The update has been downloaded and post-processing (unzip/file copy) is in progress.
+     * This status is only reported on iOS when the native module supports it.
+     */
+    PREPARING_UPDATE,
   }
 
   /**