sales-frontend-bridge 0.0.43 → 0.0.44

package/dist/index.cjs

@@ -1803,6 +1803,7 @@ var NativeBridge = class extends CommonBridge {
   createOZViewer(options) {
     return this.core.callToTarget(
       "createOZViewer",
+      // delimiter 미입력시 \n 으로 기본값 처리
       Object.assign({ delimiter: "\n" }, options)
     );
   }
@@ -1823,34 +1824,33 @@ var NativeBridge = class extends CommonBridge {
    * 오즈 파라미터에서 사용할 OZD를 다운받는 브릿지입니다
    * @example
    * ```tsx
-   * const data = [
-   *   { name: "문서1", file: ["doc1.ozd"], complete: true },
-   *   { name: "문서2", file: ["doc2.ozd", "doc3.ozd"], complete: true }
-   * ]
-   * await Bridge.native.downloadDocument(data)
-   * ```
-   * returnData는 file 경로가 절대경로로 매핑되어 돌아온다
-   * ```json
-   * {
-   *    "action":"downloadDocument",
-   *    "data":[
-   *       {
-   *          "name":"aaa",
-   *          "file":[
-   *             "/data/user/0/com.hanwhalife.ssp.stg/files/A0010.ozd",
-   *             "/data/user/0/com.hanwhalife.ssp.stg/files/C0401.ozd"
-   *          ],
-   *          "complete":false
-   *       },
-   *       {
-   *          "name":"bbb",
-   *          "file":[
-   *             "/data/user/0/com.hanwhalife.ssp.stg/files/A1500.ozd"
-   *          ],
-   *          "complete":false
-   *       }
-   *    ]
+   * const options = {
+   *   // 현재 증권번호
+   *   policyNumber: "300034894",
+   *   // FP 사번
+   *   fpInfo: { "uniqNo": "2210000" }
+   *   // 서식 목록들
+   *   data: [{
+   *     // 서식에 대한 정보들
+   *     "name": "[A0010]청약서",
+   *     "complete": false,
+   *     "startPage": 0,
+   *     "endPage": 0,
+   *     "focus": false,
+   *     "doc": [{
+   *       // 서식에 속한 OZD 파일들
+   *       "docCode": "A0010",
+   *       "fileID": "1HLqZJCNt6idLKkAA",
+   *       "imageFormatCode": "RT003001",
+   *       "imageDocumentTypeCode": "IT00",
+   *       // ozd 파일이 다운로드된 경로
+   *       "filePath": "",
+   *       "startPage": 0,
+   *       "endPage": 0
+   *     }]
+   *   }, ],
    * }
+   * await Bridge.native.downloadDocument(options)
    * ```
    */
   async downloadDocument(options) {
@@ -1869,6 +1869,7 @@ var NativeBridge = class extends CommonBridge {
     return this.core.callToTarget("getOzFontParam");
   }
   /**
+   * ### Bridge for Oz
    * 로더 컴포넌트 show
    * @example
    * ```tsx
@@ -1880,6 +1881,7 @@ var NativeBridge = class extends CommonBridge {
     return this.core.callToTarget("showLoader");
   }
   /**
+   * ### Bridge for Oz
    * 로더 컴포넌트 hide
    * @example
    * ```tsx
@@ -1890,6 +1892,16 @@ var NativeBridge = class extends CommonBridge {
   async hideLoader() {
     return this.core.callToTarget("hideLoader");
   }
+  /**
+   * ### Bridge for Oz
+   * 태블릿 로컬에 있는 파일을 fetch하기 위한 url을 만들어주는 브릿지
+   *
+   * 파일의 절대경로는 saveSignImg 혹은 pdfExport시 확보할수 있다
+   * @example
+   * ```tsx
+   * await Bridge.native.localFetchBridge({filePath: "/data/0/~~~/file.ext"});
+   * ```
+   */
   async localFetchBridge(options) {
     return this.core.callToTarget("localFetchBridge", options);
   }
@@ -2013,8 +2025,10 @@ var NativeBridgeOz = class extends CommonBridge {
    * 오즈 뷰어의 정보를 가져옵니다
    * @example
    * ```tsx
-   * // 사용 예시
-   * await Bridge.native.getInformation({ command: "INPUT_JSON" });
+   * // 사용 예시:
+   * // OZ가 반환하는 모든 값은 문자열(string)입니다.
+   * // 숫자도 '1', boolean도 'true' 형태로 전달됩니다.
+   * const { data } = await Bridge.nativeOz.getInformation({ command: 'INPUT_JSON' });
    * ```
    */
   async getInformation(options) {
@@ -2026,7 +2040,9 @@ var NativeBridgeOz = class extends CommonBridge {
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.getGlobal({ key: "AAA" })
+   * // OZ가 반환하는 모든 값은 문자열(string)입니다.
+   * // 숫자도 '1', boolean도 'true' 형태로 전달됩니다.
+   * await Bridge.nativeOz.getGlobal({ key: "AAA" })
    * ```
    */
   async getGlobal(options) {
@@ -2038,7 +2054,8 @@ var NativeBridgeOz = class extends CommonBridge {
    * @example
    * ```tsx
    * // 사용 예시
-   * Bridge.native.setGlobal({ key: "AAA", value: JSON.stringify({ aaa: 111 }) });
+   * // value 자리에 string이 아닌 값을 넣어도 getGlobal시 string으로 변환되어 리턴됩니다
+   * Bridge.nativeOz.setGlobal({ key: "AAA", value: "myValue" });
    * ```
    */
   setGlobal(options) {
@@ -2051,7 +2068,7 @@ var NativeBridgeOz = class extends CommonBridge {
    * ```tsx
    * // 사용 예시
    * const command = `movepage=2`;
-   * Bridge.native.script({ command });
+   * Bridge.nativeOz.script({ command });
    * ```
    */
   script(options) {
@@ -2069,7 +2086,7 @@ var NativeBridgeOz = class extends CommonBridge {
    * const param2 = `eform.signpad_iconposition=sign_bottom`;
    * // param이 여러개인경우 \n으로 묶는다
    * const param = `${param1}\n${param2}`;
-   * Bridge.native.scriptEX({ command, param });
+   * Bridge.nativeOz.scriptEX({ command, param });
    * ```
    */
   scriptEx(options) {
@@ -2081,10 +2098,12 @@ var NativeBridgeOz = class extends CommonBridge {
   /**
    * ### Bridge for Oz
    * 현재 보고서의 `OnExternalEvent` 이벤트를 실행하고, `OnExternalEvent` 이벤트에서 전달한 값을 string 형태로 리턴받습니다.
+   * - 서명이미지 크롭
+   * - 중간저장 서명이미지 추출
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.triggerExternalEvent({ param1: 'signer' });
+   * await Bridge.nativeOz.triggerExternalEvent({ param1: 'signer' });
    * ```
    */
   async triggerExternalEvent(options) {
@@ -2096,10 +2115,12 @@ var NativeBridgeOz = class extends CommonBridge {
   /**
    * ### Bridge for Oz
    * 지정한 보고서의 `OnExternalEvent` 이벤트를 실행하고, `OnExternalEvent` 이벤트에서 전달한 값을 string 형태로 리턴받습니다.
+   * - 서명이미지 크롭
+   * - 중간저장 서명이미지 추출
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.triggerExternalEventByDocIndex({ docIndex: 0, param1: 'signer' });
+   * await Bridge.nativeOz.triggerExternalEventByDocIndex({ docIndex: 0, param1: 'signer' });
    * ```
    */
   async triggerExternalEventByDocIndex(options) {
@@ -2111,17 +2132,23 @@ var NativeBridgeOz = class extends CommonBridge {
   /**
    * ### Bridge for Oz
    * 서식의 진행중/완료 상태를 업데이트하는 브릿지
+   * @example
+   * ```tsx
+   * // 사용 예시
+   * await Bridge.nativeOz.updateOzDocumentStatus(document);
+   * ```
    */
   async updateOzDocumentStatus(options) {
     return this.core.callToTarget("updateOzDocumentStatus", options);
   }
   /**
    * ### Bridge for Oz
-   * 오즈뷰어에 출력되고있는 서식을 PDF로 export
+   * 오즈뷰어에 출력되고있는 서식을 PDF로 export 요청
+   * export 결과는 `OZViewerEvent.OZExportCommand`로 트리거 된다
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.savePdf({ exportType: "PDF", fileName: "test.pdf", startPage: 1, endPage: 1 })
+   * await Bridge.nativeOz.savePdf({ exportType: "PDF", fileName: "test.pdf", startPage: 1, endPage: 1 })
    * ```
    */
   async savePdf(options) {
@@ -2136,7 +2163,7 @@ var NativeBridgeOz = class extends CommonBridge {
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.saveSignImg({ exportType: "IMG", fileName: "sign.png", signImageKey: "SIGN_IMG" })
+   * await Bridge.nativeOz.saveSignImg({ fileName: 'sign.png', signImageKey: 'A0010_mynm_sg', policyNumber });
    * ```
    */
   async saveSignImg(options) {
@@ -2148,7 +2175,7 @@ var NativeBridgeOz = class extends CommonBridge {
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.createOzPdfViewer({ filename: "total.pdf", filepaths: "/data/0/app/total.pdf", password: "" })
+   * await Bridge.nativeOz.createOzPdfViewer({ filePath: "/data/0/app/total.pdf" });
    * ```
    */
   async createOzPdfViewer(options) {
@@ -2160,38 +2187,69 @@ var NativeBridgeOz = class extends CommonBridge {
    * @example
    * ```tsx
    * // 사용 예시
-   * await Bridge.native.hideOzPdfViewer()
+   * await Bridge.nativeOz.hideOzPdfViewer()
    * ```
    */
   async hideOzPdfViewer() {
     return this.core.callToTarget("hideOzPdfViewer");
   }
   /**
+   * ### Bridge for Oz
    * 서식 바로가기 버튼 화면에 표시하기
+   * @example
+   * ```tsx
+   * // 사용 예시
+   * await Bridge.nativeOz.showSignatureShortcut();
    */
   async showSignatureShortcut() {
     return this.core.callToTarget("showSignatureShortcut");
   }
   /**
+   * ### Bridge for Oz
    * 서식 바로가기 버튼 숨기기
+   * @example
+   * ```tsx
+   * // 사용 예시
+   * await Bridge.nativeOz.hideSignatureShortcut();
    */
   async hideSignatureShortcut() {
     return this.core.callToTarget("hideSignatureShortcut");
   }
   /**
+   * ### Bridge for Oz
    * 느낌표 버튼(미입력 서식 발생 알림 버튼) 화면에 표시하기
+   * @example
+   * ```tsx
+   * // 사용 예시
+   * await Bridge.nativeOz.showMissingFieldWarning();
    */
   async showMissingFieldWarning() {
     return this.core.callToTarget("showMissingFieldWarning");
   }
   /**
+   * ### Bridge for Oz
    * 느낌표 버튼(미입력 서식 발생 알림 버튼) 숨기기
+   * @example
+   * ```tsx
+   * // 사용 예시
+   * await Bridge.nativeOz.hideMissingFieldWarning();
    */
   async hideMissingFieldWarning() {
     return this.core.callToTarget("hideMissingFieldWarning");
   }
   /**
-   * Alert 표시하기
+   * ### Bridge for Oz
+   * Alert 표시용 브릿지
+   * @example
+   * ```tsx
+   * // 사용 예시
+   * await Bridge.nativeOz.showAlert({
+   *   title: '모달 타이틀',
+   *   message: '모달 내용',
+   *   // 모달에 표시할 버튼들 설정
+   *   buttons: { close: false, main: "확인" }
+   * })
+   * ```
    */
   async showAlert(options) {
     return this.core.callToTarget("showAlert", options);
@@ -2395,7 +2453,7 @@ var ExtraData = {
 };
 var policyNumber = "300034894";
 var fpInfo = { uniqNo: "2210000" };
-var roleCode = [`11`, `21`];
+var roleCode = [`11`, `28`];
 
 // src/oz/hooks/use-document-info.tsx
 var import_react = __toESM(require_react());
@@ -2475,6 +2533,7 @@ var OZViewerEvent = /* @__PURE__ */ ((OZViewerEvent2) => {
 })(OZViewerEvent || {});
 var OZTriggerExternalEvent = /* @__PURE__ */ ((OZTriggerExternalEvent2) => {
   OZTriggerExternalEvent2["GetDraftData"] = "getDraftData";
+  OZTriggerExternalEvent2["CropImage"] = "cropimage";
   return OZTriggerExternalEvent2;
 })(OZTriggerExternalEvent || {});
 
@@ -2937,7 +2996,7 @@ async function getFileFromDud(fileMgmtId) {
 }
 
 // src/oz/utils/bridge-util/create-report-util.ts
-async function CreateOzParam(documentList, extraData = {}) {
+async function CreateOzParam({ documentList, extraData = {}, roleCd }) {
   if (documentList.length === 0) {
     throw new Error("\uBB38\uC11C\uBAA9\uB85D\uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4");
   }
@@ -2957,7 +3016,8 @@ async function CreateOzParam(documentList, extraData = {}) {
     const args = [
       // 모든서식에 공통으로 필요한 docCd param 추가
       `docCd=${docCode}`,
-      `roleCd=11,28`,
+      // `roleCd=11,28`,
+      `${roleCd}`,
       ...ensureArray(data.args)
     ];
     args.forEach((arg, idx2) => result.push(`${prefix}connection.args${idx2 + 1}=${arg}`));
@@ -2997,7 +3057,7 @@ async function triggerCropImageOnAllDocuments(reportCount) {
   const count = reportCount ?? await getReportCountMemo();
   for (let i = 0; i < count; i++) {
     await sleep();
-    await Bridge.nativeOz.triggerExternalEventByDocIndex({ docIndex: Number(i), param1: "cropimage" });
+    await Bridge.nativeOz.triggerExternalEventByDocIndex({ param1: "cropimage" /* CropImage */, docIndex: Number(i) });
   }
 }
 async function getTotalPageOnAllDocuments(reportCount) {