sales-frontend-components 4.0.0 → 4.1.0

package/dist/index.cjs.js

@@ -4445,9 +4445,12 @@ async function convertSourceToFile(source, convertType) {
   }
   return imageUrlToFile(source.uri, convertType);
 }
-async function captureNativeDocuments({ pageLimit }) {
+async function captureNativeDocuments({
+  pageLimit,
+  responseFileType
+}) {
   const clampedPageLimit = clampPageLimit(pageLimit);
-  logCameraDebug("native documentCapture requested", { pageLimit: clampedPageLimit });
+  logCameraDebug("native documentCapture requested", { pageLimit: clampedPageLimit, responseFileType });
   const response = await salesFrontendBridge.Bridge.native.documentCapture({ pageLimit: clampedPageLimit });
   if (response.uris && response.uris.length > 0) {
     logCameraDebug("native documentCapture android uris", { count: response.uris.length });
@@ -4456,6 +4459,11 @@ async function captureNativeDocuments({ pageLimit }) {
   if (response.sessionId) {
     return pullIosSession(response.sessionId, response.count ?? 0);
   }
+  if (response.uri) {
+    const kind = responseFileType ?? (response.uri.startsWith("data:") ? "base64" : "scheme");
+    logCameraDebug("native documentCapture legacy single uri", { kind });
+    return [{ kind, uri: response.uri }];
+  }
   logCameraDebug("native documentCapture canceled or empty");
   return [];
 }
@@ -4931,6 +4939,7 @@ function useCameraV3({
   captureEngineType,
   resizeTiming = "onCapture",
   pageLimit,
+  responseFileType,
   useNativeCamera = false,
   convertType = "canvas",
   maxPhotos,
@@ -5039,7 +5048,9 @@ function useCameraV3({
       resizeTiming
     });
     if (resolvedCaptureEngineType === "native") {
-      captureNativeDocuments({ pageLimit }).then((sources) => storeCapturedSources(sources, "native"));
+      captureNativeDocuments({ pageLimit, responseFileType }).then(
+        (sources) => storeCapturedSources(sources, "native")
+      );
       return;
     }
     if (resolvedCaptureEngineType === "video") {
@@ -5160,7 +5171,7 @@ function useCameraV3({
 }
 
 function useCamera(options = {}) {
-  const camera = useCameraV3({ pageLimit: 1, ...options, resizeTiming: "onCapture" });
+  const camera = useCameraV3({ ...options, pageLimit: 1, resizeTiming: "onCapture" });
   const getImage = (imageId) => {
     return camera.attachedPhotos.find((image) => image.id === imageId);
   };
@@ -5168,7 +5179,7 @@ function useCamera(options = {}) {
 }
 
 function useCameraV2(options) {
-  return useCameraV3({ pageLimit: 1, ...options, resizeTiming: "onRetrieve" });
+  return useCameraV3({ ...options, pageLimit: 1, resizeTiming: "onRetrieve" });
 }
 
 const HISTORY_SIZE = 100;

package/dist/index.d.ts

@@ -176,9 +176,16 @@ interface cameraOptions {
     resizeTiming?: ResizeTiming;
     /**
      * 네이티브 멀티페이지 촬영 시 최대 촬영 장수입니다. 1 ~ 20 범위로 clamp 되며 기본값은 1 입니다.
-     * V1/V2 래퍼는 항상 1로 고정되어 기존 단일 촬영 동작을 유지합니다.
+     * `useCameraV3`부터 파라미터로 사용할 수 있으며, V1/V2 래퍼는 항상 1로 고정되어 기존 단일 촬영 동작을 유지합니다.
      */
     pageLimit?: number;
+    /**
+     * 네이티브 응답 형식 힌트입니다. (기존 V1/V2 호환 옵션)
+     * 신규 멀티페이지 프로토콜에서는 플랫폼별 응답(Android `uris`, iOS 세션 pull)이 우선하며,
+     * 구버전 앱이 단일 `uri`만 반환하는 경우 `scheme`/`base64` 해석 힌트로만 사용됩니다.
+     * 브리지 함수(`Bridge.native.documentCapture`)에는 전달되지 않습니다.
+     */
+    responseFileType?: 'scheme' | 'base64';
     /**
      * 앱 환경에서 브리지 기반 네이티브 카메라/문서 캡처를 사용할지 여부입니다.
      * @deprecated 신규 구현에서는 `captureEngineType: 'native'` 또는 `'input'`을 사용하세요.
@@ -188,11 +195,6 @@ interface cameraOptions {
     cameraOnly: boolean;
     /** 기본 첨부 버튼 문구를 덮어쓸 때 사용하는 텍스트입니다. */
     buttonText?: string;
-    /**
-     * 네이티브 캡처 결과의 응답 형식입니다.
-     * `scheme`은 파일/커스텀 스킴 URI를, `base64`는 Base64 문자열을 반환하도록 요청합니다.
-     */
-    responseFileType: 'base64' | 'scheme';
     /**
      * 이미지 URL을 `File`로 바꿀 때 사용할 변환 방식입니다.
      * `fetch`, `xhr`, `canvas` 중 환경 제약과 호환성에 맞는 전략을 선택할 수 있습니다.
@@ -213,21 +215,30 @@ interface cameraOptions {
      * 핸들러가 호출되면 훅은 해당 입력을 첨부 목록에 등록하지 않습니다.
      */
     maxPhotosErrorHandler?: (overflow: MaxPhotosOverflowInfo) => void;
-    /** 첨부 후 이미지 크기와 용량을 줄이기 위한 리사이즈 옵션입니다. */
-    resize?: {
-        /** 반복 축소 시 한 번에 줄일 비율입니다. `5`면 매 반복마다 약 5%씩 축소합니다. */
-        resizeRatio?: number;
-        /** 어떤 기준으로 축소할지 결정합니다. 품질만, 픽셀 크기만, 또는 둘 다 조합해 처리할 수 있습니다. */
-        processType?: 'quality' | 'px' | 'mixed';
-        /** 최종 목표 너비(px)입니다. 높이만 없는 경우 원본 비율을 유지해 자동 계산합니다. */
-        width?: number;
-        /** 최종 목표 높이(px)입니다. 너비만 없는 경우 원본 비율을 유지해 자동 계산합니다. */
-        height?: number;
-        /** 최종 목표 파일 크기(byte)입니다. 예: `300 * 1024`는 약 300KB입니다. */
-        filesize?: number;
-        /** 출력 이미지 확장자입니다. 일반적으로 `jpeg` 또는 `png`를 사용합니다. */
-        ext?: string;
-    };
+    /**
+     * 첨부 후 이미지 크기와 용량을 줄이기 위한 리사이즈 옵션입니다.
+     * - 미지정 시 기본 리사이즈 옵션(width 1920 / 약 300KB / jpeg)이 적용됩니다.
+     * - `false`를 명시하면 리사이즈/변환 가공을 건너뛰고 원본을 그대로 사용합니다.
+     *   (네이티브 브릿지가 이미 리사이즈한 이미지를 반환하는 경우 이중 가공을 방지)
+     */
+    resize?: ResizeOption | false;
+}
+/**
+ * 이미지 리사이즈 가공 옵션입니다.
+ */
+interface ResizeOption {
+    /** 반복 축소 시 한 번에 줄일 비율입니다. `5`면 매 반복마다 약 5%씩 축소합니다. */
+    resizeRatio?: number;
+    /** 어떤 기준으로 축소할지 결정합니다. 품질만, 픽셀 크기만, 또는 둘 다 조합해 처리할 수 있습니다. */
+    processType?: 'quality' | 'px' | 'mixed';
+    /** 최종 목표 너비(px)입니다. 높이만 없는 경우 원본 비율을 유지해 자동 계산합니다. */
+    width?: number;
+    /** 최종 목표 높이(px)입니다. 너비만 없는 경우 원본 비율을 유지해 자동 계산합니다. */
+    height?: number;
+    /** 최종 목표 파일 크기(byte)입니다. 예: `300 * 1024`는 약 300KB입니다. */
+    filesize?: number;
+    /** 출력 이미지 확장자입니다. 일반적으로 `jpeg` 또는 `png`를 사용합니다. */
+    ext?: string;
 }
 type cameraItemType = 'single' | 'multiple' | 'linear';
 interface AddImageInfo {
@@ -286,9 +297,12 @@ type MaxPhotosOverflowInfo = {
  *
  * 내부적으로 `useCameraV3`를 호출하며, 기존 호환성을 위해 다음을 고정합니다.
  * - `resizeTiming: 'onCapture'` : 촬영 즉시 가공 후 가공본을 썸네일로 저장합니다.
+ * - `pageLimit: 1` : 멀티페이지 촬영을 막아 기존의 단일 등록 방식만 허용합니다. (호출부에서 덮어쓸 수 없음)
  * - `getImage` : 기존 동기 시그니처를 유지합니다.
  *
- * `pageLimit` 기본값은 1이며, 멀티페이지 촬영이 필요하면 2 이상(최대 20)을 전달할 수 있습니다.
+ * 멀티페이지(`pageLimit` 2 이상) 촬영이 필요하면 `useCameraV3`를 직접 사용하세요.
+ * `responseFileType`는 그대로 `useCameraV3`로 전달되어 구버전 앱의 단일 `uri` 해석 힌트로만 쓰이며,
+ * 브리지 함수(`Bridge.native.documentCapture`)에는 전달되지 않습니다.
  *
  * @param options 카메라 동작 옵션입니다.
  * @returns 첨부 UI 컴포넌트와 첨부 제어 함수들입니다.
@@ -308,9 +322,12 @@ declare function useCamera(options?: Partial<cameraOptions>): {
  *
  * 내부적으로 `useCameraV3`를 호출하며, 기존 호환성을 위해 다음을 고정합니다.
  * - `resizeTiming: 'onRetrieve'` : 원본을 즉시 썸네일로 표시하고 `getImage` 호출 시점에 가공합니다.
+ * - `pageLimit: 1` : 멀티페이지 촬영을 막아 기존의 단일 등록 방식만 허용합니다. (호출부에서 덮어쓸 수 없음)
  * - `getImage` : 기존 비동기 시그니처를 그대로 유지합니다.
  *
- * `pageLimit` 기본값은 1이며, 멀티페이지 촬영이 필요하면 2 이상(최대 20)을 전달할 수 있습니다.
+ * 멀티페이지(`pageLimit` 2 이상) 촬영이 필요하면 `useCameraV3`를 직접 사용하세요.
+ * `responseFileType`는 그대로 `useCameraV3`로 전달되어 구버전 앱의 단일 `uri` 해석 힌트로만 쓰이며,
+ * 브리지 함수(`Bridge.native.documentCapture`)에는 전달되지 않습니다.
  *
  * @param options 카메라 동작 옵션입니다.
  * @returns 첨부 UI 컴포넌트와 첨부 제어 함수들입니다.
@@ -330,6 +347,8 @@ declare function useCameraV2(options: cameraOptions): {
  *
  * - 캡처 엔진: `captureEngineType`(`native` 멀티페이지 / `input` / `video`)으로 선택합니다.
  * - 가공 시점: `resizeTiming`(`onCapture` V1식 / `onRetrieve` V2식)으로 선택합니다.
+ * - 리사이즈: `resize` 옵션. 미지정 시 기본 리사이즈가 적용되며, `resize: false`면 리사이즈를 건너뜁니다.
+ *   (네이티브 브릿지가 이미 리사이즈한 이미지를 반환하는 경우 이중 가공 방지)
  * - 촬영 장수: `pageLimit`(1~20)으로 네이티브 멀티페이지 장수를 선택합니다.
  *
  * ### `maxPhotos` × `pageLimit` 누적 동작 (`type`이 `'multiple'` / `'linear'`)
@@ -353,7 +372,7 @@ declare function useCameraV2(options: cameraOptions): {
  *
  * 공개 API는 단일·자기완결 형태(`getImage`는 항상 비동기)라, 추후 V1/V2 래퍼를 제거해도 단독으로 동작합니다.
  */
-declare function useCameraV3({ onChange, resize: resizeOption, cameraOnly, onDelete, show, type, buttonText, initData, captureEngineType, resizeTiming, pageLimit, useNativeCamera, convertType, maxPhotos, overMaxPhotosBehavior, maxPhotosErrorHandler }?: Partial<cameraOptions>): {
+declare function useCameraV3({ onChange, resize: resizeOption, cameraOnly, onDelete, show, type, buttonText, initData, captureEngineType, resizeTiming, pageLimit, responseFileType, useNativeCamera, convertType, maxPhotos, overMaxPhotosBehavior, maxPhotosErrorHandler }?: Partial<cameraOptions>): {
     onClick: () => void;
     getImage: (imageId: string) => Promise<AttachedPhoto>;
     deleteImage: (imageId: string) => void;
@@ -371,7 +390,7 @@ declare function useCameraV3({ onChange, resize: resizeOption, cameraOnly, onDel
  * @param resizeRatio 1회 반복 시 축소 비율 (단위: %)
  *                    기본값 5 = 1회 반복 시 5%씩 축소
  */
-declare function resize<T extends string | File>(image: T, options?: cameraOptions['resize']): Promise<T>;
+declare function resize<T extends string | File>(image: T, options?: ResizeOption): Promise<T>;
 
 interface AttachmentProps {
     photos: AttachedPhoto[];
@@ -1309,4 +1328,4 @@ interface UseTermsReturn<T> {
 declare function useTerms<T extends object>(initialValue: T): UseTermsReturn<T>;
 
 export { AUTH_TEMPLATE_CODES, Attachment, BANK_STOCK_ICON_LIST, BANK_STOCK_SEARCH_MODAL_TABS, BankStockSearchModal, CustomerSearch, CustomerSearchModal, DeaCustomerSearchModal, DudDownload, DudUpload, EmployeeSearchModal, GtmIframe, HookFormCheckbox, HookFormCheckboxButton, HookFormDatePickerRenew, HookFormDateRangePickerRenew, HookFormSearchJobField, HookFormSegmentGroup, HookFormSelect, HookFormTextField, JobVehicleSearchModal, OrganizationSearchModal, RATING_DATA, RIV_SEARCH_PARAM_MAP, RemoteIdentityVerification, RivModalIframe, StepIndicator, TermsCancerCollectQR, TermsCancerMarketing, TermsCancerProvideQR, TermsCancerSystem, TermsCheckboxButton, TermsDesign, TermsExecution, TermsLoan, TermsMarketing, TermsMarketingCollectQR, TermsMarketingProviderQR, TermsMobileCard, TermsRadio, TermsRatingBar, TermsSignature, TermsTransfer, VERIFICATION_CODES, highlightOnSearchKeyword, resize, testSignatureBase64Data, useAddressComponent, useBankStockSearch, useCamera, useCameraV2, useCameraV3, useCanvasPaint, useCustomerSearch, useDownloader, useJobSearchModal, useJobVehicleSearch, useJobVehicleSearchModal, useNationalityComponent, useNxlOneModal, useRemoteIdentityVerification, useRemoteIdentityVerificationIframe, useSearchAddress, useSearchNationality, useSearchVisa, useTerms, useVisaComponent };
-export type { AddImageInfo, AttachedPhoto, AttachmentProps, AuthCodeSet, AuthStep, BankStockSearchModalProps, BaseTermsProps, CaptureEngineType, CapturedSource, CustomerSearchProps, DownloadProps, DownloadTargetInfo, DownloaderProps, FormFactor, HookFormCheckboxButtonProps, HookFormCheckboxProps, HookFormDatePickerRenewProps, HookFormDateRangePickerRenewProps, HookFormSearchJobFieldProps, HookFormSegmentGroupProps, HookFormSelectProps, HookFormTextFieldProps, InitSearchParams, MaxPhotosOverflowInfo, MaxPhotosOverflowSource, OverMaxPhotosBehavior, PaintProps, Pen, RemoteIdentityVerificationProps, RemoteIdentityVerificationSuccess, RemoteIdentityVerificationViewForwardProps, RemoteIdentityVerificationViewProps, ResizeTiming, RivModalIframeProps, RivModalIframeReturnProps, RivUrlParams, SearchInputProps, StepIndicatorProps, StepItem, TermsCancerMarketingData, TermsCancerMarketingProps, TermsCancerSystemData, TermsCancerSystemDataProps, TermsDesignData, TermsDesignProps, TermsExecutionData, TermsExecutionProps, TermsLoanData, TermsLoanDataProps, TermsMarketingData, TermsMarketingProps, TermsRadioOption, TermsRatingType, TermsSignatureData, UseRemoteIdentityVerificationProps, UseRemoteIdentityVerificationReturn, UseTermsReturn, Vehicle, VerificationResponse, cameraItemType, cameraOptions };
+export type { AddImageInfo, AttachedPhoto, AttachmentProps, AuthCodeSet, AuthStep, BankStockSearchModalProps, BaseTermsProps, CaptureEngineType, CapturedSource, CustomerSearchProps, DownloadProps, DownloadTargetInfo, DownloaderProps, FormFactor, HookFormCheckboxButtonProps, HookFormCheckboxProps, HookFormDatePickerRenewProps, HookFormDateRangePickerRenewProps, HookFormSearchJobFieldProps, HookFormSegmentGroupProps, HookFormSelectProps, HookFormTextFieldProps, InitSearchParams, MaxPhotosOverflowInfo, MaxPhotosOverflowSource, OverMaxPhotosBehavior, PaintProps, Pen, RemoteIdentityVerificationProps, RemoteIdentityVerificationSuccess, RemoteIdentityVerificationViewForwardProps, RemoteIdentityVerificationViewProps, ResizeOption, ResizeTiming, RivModalIframeProps, RivModalIframeReturnProps, RivUrlParams, SearchInputProps, StepIndicatorProps, StepItem, TermsCancerMarketingData, TermsCancerMarketingProps, TermsCancerSystemData, TermsCancerSystemDataProps, TermsDesignData, TermsDesignProps, TermsExecutionData, TermsExecutionProps, TermsLoanData, TermsLoanDataProps, TermsMarketingData, TermsMarketingProps, TermsRadioOption, TermsRatingType, TermsSignatureData, UseRemoteIdentityVerificationProps, UseRemoteIdentityVerificationReturn, UseTermsReturn, Vehicle, VerificationResponse, cameraItemType, cameraOptions };

package/dist/index.esm.js

@@ -4443,9 +4443,12 @@ async function convertSourceToFile(source, convertType) {
   }
   return imageUrlToFile(source.uri, convertType);
 }
-async function captureNativeDocuments({ pageLimit }) {
+async function captureNativeDocuments({
+  pageLimit,
+  responseFileType
+}) {
   const clampedPageLimit = clampPageLimit(pageLimit);
-  logCameraDebug("native documentCapture requested", { pageLimit: clampedPageLimit });
+  logCameraDebug("native documentCapture requested", { pageLimit: clampedPageLimit, responseFileType });
   const response = await Bridge.native.documentCapture({ pageLimit: clampedPageLimit });
   if (response.uris && response.uris.length > 0) {
     logCameraDebug("native documentCapture android uris", { count: response.uris.length });
@@ -4454,6 +4457,11 @@ async function captureNativeDocuments({ pageLimit }) {
   if (response.sessionId) {
     return pullIosSession(response.sessionId, response.count ?? 0);
   }
+  if (response.uri) {
+    const kind = responseFileType ?? (response.uri.startsWith("data:") ? "base64" : "scheme");
+    logCameraDebug("native documentCapture legacy single uri", { kind });
+    return [{ kind, uri: response.uri }];
+  }
   logCameraDebug("native documentCapture canceled or empty");
   return [];
 }
@@ -4929,6 +4937,7 @@ function useCameraV3({
   captureEngineType,
   resizeTiming = "onCapture",
   pageLimit,
+  responseFileType,
   useNativeCamera = false,
   convertType = "canvas",
   maxPhotos,
@@ -5037,7 +5046,9 @@ function useCameraV3({
       resizeTiming
     });
     if (resolvedCaptureEngineType === "native") {
-      captureNativeDocuments({ pageLimit }).then((sources) => storeCapturedSources(sources, "native"));
+      captureNativeDocuments({ pageLimit, responseFileType }).then(
+        (sources) => storeCapturedSources(sources, "native")
+      );
       return;
     }
     if (resolvedCaptureEngineType === "video") {
@@ -5158,7 +5169,7 @@ function useCameraV3({
 }
 
 function useCamera(options = {}) {
-  const camera = useCameraV3({ pageLimit: 1, ...options, resizeTiming: "onCapture" });
+  const camera = useCameraV3({ ...options, pageLimit: 1, resizeTiming: "onCapture" });
   const getImage = (imageId) => {
     return camera.attachedPhotos.find((image) => image.id === imageId);
   };
@@ -5166,7 +5177,7 @@ function useCamera(options = {}) {
 }
 
 function useCameraV2(options) {
-  return useCameraV3({ pageLimit: 1, ...options, resizeTiming: "onRetrieve" });
+  return useCameraV3({ ...options, pageLimit: 1, resizeTiming: "onRetrieve" });
 }
 
 const HISTORY_SIZE = 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sales-frontend-components",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs.js",
@@ -45,13 +45,13 @@
     "sales-frontend-stores": "0.0.15",
     "sales-frontend-typescript-config": "0.0.2",
     "sales-frontend-assets": "0.0.29",
-    "sales-frontend-api": "1.0.0",
-    "sales-frontend-design-system": "0.4.0",
-    "sales-frontend-bridge": "0.1.0",
+    "sales-frontend-api": "1.0.1",
+    "sales-frontend-design-system": "0.4.1",
+    "sales-frontend-bridge": "0.1.1",
     "sales-frontend-hooks": "0.0.182",
     "sales-frontend-solution": "0.0.61",
     "sales-frontend-debug": "0.0.80",
-    "sales-frontend-headless": "1.0.0",
+    "sales-frontend-headless": "1.0.1",
     "sales-frontend-vitest-config": "0.0.4"
   },
   "peerDependencies": {
@@ -59,12 +59,12 @@
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "react-hook-form": "^7.58.1",
-    "sales-frontend-api": "1.0.0",
+    "sales-frontend-api": "1.0.1",
     "sales-frontend-assets": "0.0.29",
     "sales-frontend-stores": "0.0.15",
-    "sales-frontend-design-system": "0.4.0",
-    "sales-frontend-bridge": "0.1.0",
-    "sales-frontend-headless": "1.0.0",
+    "sales-frontend-design-system": "0.4.1",
+    "sales-frontend-bridge": "0.1.1",
+    "sales-frontend-headless": "1.0.1",
     "sales-frontend-hooks": "0.0.182",
     "sales-frontend-solution": "0.0.61"
   },