@rich-automation/lotto 2.0.5 → 2.1.0

package/README.md

@@ -20,6 +20,7 @@ yarn add @rich-automation/lotto
 
 1. 내부적으로 Playwright 또는 Puppeteer를 사용하므로, Chromium이 사전에 설치되어 있어야 합니다. ([링크](https://github.com/rich-automation/lotto-module/blob/main/package.json#L38-L39))
 2. 구매는 [동행복권](https://dhlottery.co.kr/common.do?method=main) 사이트에서 진행되며, 예치금 충전 기능은 없으므로 미리 계정에 예치금을 충전해두어야 합니다.
+3. 건전 구매 서약서에 동의하세요 (https://www.dhlottery.co.kr/hpns/sdnsCamPainView), 1년 주기로 동의가 필요합니다.
 
 ## 사용법
 

package/lib/cjs/controllers/factory.js

@@ -3,11 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBrowserController = void 0;
 const puppeteer_1 = require("./puppeteer");
 const playwright_1 = require("./playwright");
+const webview_1 = require("./webview");
 const api_1 = require("./api");
 function createBrowserController(configs, logger) {
     if (isAPIMode(configs)) {
         return new api_1.APIModeController(configs, logger);
     }
+    if (isWebView(configs)) {
+        return new webview_1.WebViewController(configs, logger);
+    }
     if (isPlaywright(configs)) {
         return new playwright_1.PlaywrightController(configs, logger);
     }
@@ -20,6 +24,9 @@ exports.createBrowserController = createBrowserController;
 function isAPIMode(configs) {
     return configs.controller === 'api';
 }
+function isWebView(configs) {
+    return (typeof configs.controller === 'object' && '__type' in configs.controller && configs.controller.__type === 'webview');
+}
 function isPlaywright(configs) {
     return typeof configs.controller !== 'string' && 'connectOverCDP' in configs.controller;
 }

package/lib/cjs/controllers/playwright/playwright.page.js

@@ -23,9 +23,10 @@ class PlaywrightPage {
             return this.page.url();
         });
     }
-    goto(url) {
+    goto(url, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.page.goto(url, { waitUntil: 'load' });
+            const waitUntil = (options === null || options === void 0 ? void 0 : options.waitUntil) === 'idle' ? 'networkidle' : 'load';
+            yield this.page.goto(url, { waitUntil });
         });
     }
     fill(selector, value) {

package/lib/cjs/controllers/puppeteer/puppeteer.page.js

@@ -22,9 +22,10 @@ class PuppeteerPage {
             return this.page.url();
         });
     }
-    goto(url) {
+    goto(url, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.page.goto(url, { waitUntil: 'load' });
+            const waitUntil = (options === null || options === void 0 ? void 0 : options.waitUntil) === 'idle' ? 'networkidle0' : 'load';
+            yield this.page.goto(url, { waitUntil });
         });
     }
     fill(selector, value) {

package/lib/cjs/controllers/webview/bridgeScript.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRIDGE_SCRIPT = void 0;
+// WebView에 주입되는 브릿지 스크립트
+// 모든 DOM 조작은 이 스크립트 내부에서 실행되며, postMessage로 결과를 반환함
+exports.BRIDGE_SCRIPT = `
+(function() {
+  if (window.__LOTTO_BRIDGE__) return;
+
+  window.__LOTTO_BRIDGE__ = {
+    fill: function(selector, value) {
+      var el = document.querySelector(selector);
+      if (!el) return { ok: false, error: 'Element not found: ' + selector };
+      el.focus();
+      el.value = value;
+      el.dispatchEvent(new Event('input', { bubbles: true }));
+      el.dispatchEvent(new Event('change', { bubbles: true }));
+      return { ok: true };
+    },
+
+    click: function(selector, domDirect) {
+      var el = document.querySelector(selector);
+      if (!el) return { ok: false, error: 'Element not found: ' + selector };
+      el.click();
+      return { ok: true };
+    },
+
+    select: function(selector, value) {
+      var el = document.querySelector(selector);
+      if (!el) return { ok: false, error: 'Element not found: ' + selector };
+      el.value = value;
+      el.dispatchEvent(new Event('change', { bubbles: true }));
+      return { ok: true };
+    },
+
+    exists: function(selector, containsText) {
+      var el = document.querySelector(selector);
+      if (!el) return false;
+      if (containsText) return (el.textContent || '').indexOf(containsText) !== -1;
+      return true;
+    },
+
+    querySelectorAll: function(selector) {
+      var MAX_DEPTH = 5;
+      function toFakeDOM(el, depth) {
+        return {
+          className: el.className || '',
+          innerHTML: el.innerHTML || '',
+          children: depth < MAX_DEPTH
+            ? Array.from(el.children).map(function(c) { return toFakeDOM(c, depth + 1); })
+            : []
+        };
+      }
+      return Array.from(document.querySelectorAll(selector)).map(function(el) { return toFakeDOM(el, 0); });
+    },
+
+    getUrl: function() {
+      return window.location.href;
+    },
+
+    getCookies: function() {
+      return document.cookie;
+    },
+
+    setCookies: function(cookieString) {
+      cookieString.split('; ').forEach(function(cookie) {
+        document.cookie = cookie;
+      });
+      return { ok: true };
+    },
+
+    waitForSelector: function(selector, timeout) {
+      return new Promise(function(resolve) {
+        var el = document.querySelector(selector);
+        if (el) { resolve({ ok: true }); return; }
+
+        var observer = new MutationObserver(function() {
+          var found = document.querySelector(selector);
+          if (found) {
+            observer.disconnect();
+            clearTimeout(timer);
+            resolve({ ok: true });
+          }
+        });
+        observer.observe(document.body || document.documentElement, { childList: true, subtree: true });
+
+        var timer = setTimeout(function() {
+          observer.disconnect();
+          resolve({ ok: false, error: 'Timeout waiting for: ' + selector });
+        }, timeout || 10000);
+      });
+    }
+  };
+
+  var ALLOWED_METHODS = ['fill','click','select','exists','querySelectorAll','getUrl','getCookies','setCookies','waitForSelector'];
+
+  // 커맨드 수신 리스너
+  window.addEventListener('message', function(e) {
+    try {
+      var msg = typeof e.data === 'string' ? JSON.parse(e.data) : e.data;
+      if (!msg || !msg.__lotto_call_id__ || !msg.method) return;
+      if (ALLOWED_METHODS.indexOf(msg.method) === -1) return;
+
+      var fn = window.__LOTTO_BRIDGE__[msg.method];
+      if (!fn) return;
+
+      Promise.resolve(fn.apply(null, msg.args || [])).then(function(result) {
+        window.ReactNativeWebView.postMessage(JSON.stringify({
+          __lotto_call_id__: msg.__lotto_call_id__,
+          result: result
+        }));
+      });
+    } catch (err) {
+      if (msg && msg.__lotto_call_id__) {
+        window.ReactNativeWebView.postMessage(JSON.stringify({
+          __lotto_call_id__: msg.__lotto_call_id__,
+          result: { ok: false, error: String(err) }
+        }));
+      }
+    }
+  });
+
+  true;
+})();
+`;

package/lib/cjs/controllers/webview/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebViewController = void 0;
+const webview_page_1 = require("./webview.page");
+class WebViewController {
+    constructor(configs, logger) {
+        this.page = null;
+        this.focus = () => __awaiter(this, void 0, void 0, function* () {
+            if (!this.page) {
+                this.page = new webview_page_1.WebViewPage(this.configs.controller, this.logger);
+            }
+            return this.page;
+        });
+        this.close = () => __awaiter(this, void 0, void 0, function* () {
+            this.configs.controller.destroy();
+            this.page = null;
+        });
+        this.cleanPages = () => __awaiter(this, void 0, void 0, function* () {
+            // WebView는 단일 페이지이므로 no-op
+            this.logger.debug('[WebViewController]', 'cleanPages is no-op for WebView');
+        });
+        this.configs = configs;
+        this.logger = logger;
+    }
+}
+exports.WebViewController = WebViewController;

package/lib/cjs/controllers/webview/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/controllers/webview/webview.page.js

@@ -0,0 +1,106 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebViewPage = void 0;
+const lazyRun_1 = require("../../utils/lazyRun");
+const deferred_1 = require("../../utils/deferred");
+class WebViewPage {
+    constructor(bridge, logger) {
+        this.bridge = bridge;
+        this.logger = logger;
+    }
+    url() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.bridge.getCurrentUrl();
+        });
+    }
+    goto(url, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.bridge.navigateTo(url, options === null || options === void 0 ? void 0 : options.waitUntil);
+        });
+    }
+    fill(selector, value) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = (yield this.bridge.call('fill', [selector, value.toString()]));
+            if (!result.ok) {
+                (_a = this.logger) === null || _a === void 0 ? void 0 : _a.warn('[WebViewPage]', 'fill failed', result.error);
+            }
+        });
+    }
+    click(selector, _domDirect = false) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = (yield this.bridge.call('click', [selector]));
+            if (!result.ok) {
+                (_a = this.logger) === null || _a === void 0 ? void 0 : _a.warn('[WebViewPage]', 'click failed', result.error);
+            }
+        });
+    }
+    select(selector, value) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = (yield this.bridge.call('select', [selector, value]));
+            if (!result.ok) {
+                (_a = this.logger) === null || _a === void 0 ? void 0 : _a.warn('[WebViewPage]', 'select failed', result.error);
+            }
+        });
+    }
+    querySelectorAll(selector, callback) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const elems = (yield this.bridge.call('querySelectorAll', [selector]));
+            return callback(elems);
+        });
+    }
+    exists(selector, containsText) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (yield this.bridge.call('exists', [selector, containsText]));
+        });
+    }
+    wait(param) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const p = (0, deferred_1.deferred)();
+            if (param === 'idle' || param === 'load') {
+                // WebView에서는 네비게이션 대기를 직접 지원하지 않으므로 짧은 대기로 대체
+                yield (0, lazyRun_1.lazyRun)(() => __awaiter(this, void 0, void 0, function* () { return p.resolve(); }), 1000);
+            }
+            if (typeof param === 'number') {
+                yield (0, lazyRun_1.lazyRun)(() => __awaiter(this, void 0, void 0, function* () { return p.resolve(); }), param);
+            }
+            return p.promise;
+        });
+    }
+    waitForSelector(selector, timeout = 10000) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = (yield this.bridge.call('waitForSelector', [selector, timeout]));
+            if (!result.ok) {
+                throw new Error((_a = result.error) !== null && _a !== void 0 ? _a : `waitForSelector timeout: ${selector}`);
+            }
+        });
+    }
+    getCookies() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (yield this.bridge.call('getCookies', []));
+        });
+    }
+    setCookies(cookies) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.bridge.call('setCookies', [cookies]);
+        });
+    }
+    on(_event, _callback) {
+        var _a;
+        (_a = this.logger) === null || _a === void 0 ? void 0 : _a.warn('[WebViewPage]', 'on() is not supported in WebView controller');
+        return () => { };
+    }
+}
+exports.WebViewPage = WebViewPage;

package/lib/cjs/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkWinning = exports.getCheckWinningLink = exports.getNextLottoRound = exports.getLastLottoRound = exports.LogLevel = exports.LottoService = void 0;
-var lottoService_1 = require("./lottoService");
+var lottoService_1 = require("./services/lottoService");
 Object.defineProperty(exports, "LottoService", { enumerable: true, get: function () { return lottoService_1.LottoService; } });
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });

package/lib/cjs/{lottoService.js → services/lottoService.core.js}

@@ -12,23 +12,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LottoService = void 0;
-const lottoError_1 = __importDefault(require("./lottoError"));
-const selectors_1 = require("./constants/selectors");
-const factory_1 = require("./controllers/factory");
-const urls_1 = require("./constants/urls");
-const constants_1 = require("./constants");
-const lazyRun_1 = require("./utils/lazyRun");
-const logger_1 = __importDefault(require("./logger"));
-const getLastLottoRound_1 = require("./utils/getLastLottoRound");
-const validateLottoNumber_1 = require("./utils/validateLottoNumber");
-const getWinningNumbers_1 = require("./apis/dhlottery/getWinningNumbers");
-const checkWinning_1 = require("./utils/checkWinning");
-const validatePurchaseAvailability_1 = require("./utils/validatePurchaseAvailability");
-const getCheckWinningLink_1 = require("./utils/getCheckWinningLink");
-const getNextLottoRound_1 = require("./utils/getNextLottoRound");
-class LottoService {
-    constructor(configs) {
+exports.LottoServiceCore = void 0;
+const lottoError_1 = __importDefault(require("../lottoError"));
+const selectors_1 = require("../constants/selectors");
+const urls_1 = require("../constants/urls");
+const constants_1 = require("../constants");
+const lazyRun_1 = require("../utils/lazyRun");
+const getLastLottoRound_1 = require("../utils/getLastLottoRound");
+const validateLottoNumber_1 = require("../utils/validateLottoNumber");
+const getWinningNumbers_1 = require("../apis/dhlottery/getWinningNumbers");
+const checkWinning_1 = require("../utils/checkWinning");
+const validatePurchaseAvailability_1 = require("../utils/validatePurchaseAvailability");
+const getCheckWinningLink_1 = require("../utils/getCheckWinningLink");
+const getNextLottoRound_1 = require("../utils/getNextLottoRound");
+class LottoServiceCore {
+    constructor(controller, logger) {
         this.context = {
             authenticated: false
         };
@@ -66,10 +64,10 @@ class LottoService {
             if (this.browserController.configs.controller === 'api') {
                 throw lottoError_1.default.NotSupported('API mode does not support signIn.');
             }
-            // 페이지 이동
+            // 페이지 이동 (RSA 키 로딩 등 비동기 스크립트 완료까지 대기)
             const page = yield this.browserController.focus(0);
             this.logger.debug('[signIn]', 'goto', 'login page');
-            yield page.goto(urls_1.URLS.LOGIN);
+            yield page.goto(urls_1.URLS.LOGIN, { waitUntil: 'idle' });
             this.logger.debug('[signIn]', 'page url', yield page.url());
             // 로그인 시도
             this.logger.debug('[signIn]', 'try login');
@@ -179,8 +177,8 @@ class LottoService {
             this.logger.debug('[getCheckWinningLink]', 'getCheckWinningLink');
             return (0, getCheckWinningLink_1.getCheckWinningLink)(numbers, round);
         };
-        this.logger = new logger_1.default(configs.logLevel, '[LottoService]');
-        this.browserController = (0, factory_1.createBrowserController)(Object.assign({ defaultViewport: { width: 1080, height: 1024 } }, configs), this.logger);
+        this.browserController = controller;
+        this.logger = logger;
     }
 }
-exports.LottoService = LottoService;
+exports.LottoServiceCore = LottoServiceCore;

package/lib/cjs/services/lottoService.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LottoService = void 0;
+const factory_1 = require("../controllers/factory");
+const logger_1 = __importDefault(require("../logger"));
+const lottoService_core_1 = require("./lottoService.core");
+class LottoService extends lottoService_core_1.LottoServiceCore {
+    constructor(configs) {
+        const logger = new logger_1.default(configs.logLevel, '[LottoService]');
+        const controller = (0, factory_1.createBrowserController)(Object.assign({ defaultViewport: { width: 1080, height: 1024 } }, configs), logger);
+        super(controller, logger);
+    }
+}
+exports.LottoService = LottoService;

package/lib/esm/controllers/factory.js

@@ -1,10 +1,14 @@
 import { PuppeteerController } from './puppeteer';
 import { PlaywrightController } from './playwright';
+import { WebViewController } from './webview';
 import { APIModeController } from './api';
 export function createBrowserController(configs, logger) {
     if (isAPIMode(configs)) {
         return new APIModeController(configs, logger);
     }
+    if (isWebView(configs)) {
+        return new WebViewController(configs, logger);
+    }
     if (isPlaywright(configs)) {
         return new PlaywrightController(configs, logger);
     }
@@ -16,6 +20,9 @@ export function createBrowserController(configs, logger) {
 function isAPIMode(configs) {
     return configs.controller === 'api';
 }
+function isWebView(configs) {
+    return (typeof configs.controller === 'object' && '__type' in configs.controller && configs.controller.__type === 'webview');
+}
 function isPlaywright(configs) {
     return typeof configs.controller !== 'string' && 'connectOverCDP' in configs.controller;
 }

package/lib/esm/controllers/playwright/playwright.page.js

@@ -20,9 +20,10 @@ export class PlaywrightPage {
             return this.page.url();
         });
     }
-    goto(url) {
+    goto(url, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.page.goto(url, { waitUntil: 'load' });
+            const waitUntil = (options === null || options === void 0 ? void 0 : options.waitUntil) === 'idle' ? 'networkidle' : 'load';
+            yield this.page.goto(url, { waitUntil });
         });
     }
     fill(selector, value) {

package/lib/esm/controllers/puppeteer/puppeteer.page.js

@@ -19,9 +19,10 @@ export class PuppeteerPage {
             return this.page.url();
         });
     }
-    goto(url) {
+    goto(url, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.page.goto(url, { waitUntil: 'load' });
+            const waitUntil = (options === null || options === void 0 ? void 0 : options.waitUntil) === 'idle' ? 'networkidle0' : 'load';
+            yield this.page.goto(url, { waitUntil });
         });
     }
     fill(selector, value) {

package/lib/esm/controllers/webview/bridgeScript.js

@@ -0,0 +1,122 @@
+// WebView에 주입되는 브릿지 스크립트
+// 모든 DOM 조작은 이 스크립트 내부에서 실행되며, postMessage로 결과를 반환함
+export const BRIDGE_SCRIPT = `
+(function() {
+  if (window.__LOTTO_BRIDGE__) return;
+
+  window.__LOTTO_BRIDGE__ = {
+    fill: function(selector, value) {
+      var el = document.querySelector(selector);
+      if (!el) return { ok: false, error: 'Element not found: ' + selector };
+      el.focus();
+      el.value = value;
+      el.dispatchEvent(new Event('input', { bubbles: true }));
+      el.dispatchEvent(new Event('change', { bubbles: true }));
+      return { ok: true };
+    },
+
+    click: function(selector, domDirect) {
+      var el = document.querySelector(selector);
+      if (!el) return { ok: false, error: 'Element not found: ' + selector };
+      el.click();
+      return { ok: true };
+    },
+
+    select: function(selector, value) {
+      var el = document.querySelector(selector);
+      if (!el) return { ok: false, error: 'Element not found: ' + selector };
+      el.value = value;
+      el.dispatchEvent(new Event('change', { bubbles: true }));
+      return { ok: true };
+    },
+
+    exists: function(selector, containsText) {
+      var el = document.querySelector(selector);
+      if (!el) return false;
+      if (containsText) return (el.textContent || '').indexOf(containsText) !== -1;
+      return true;
+    },
+
+    querySelectorAll: function(selector) {
+      var MAX_DEPTH = 5;
+      function toFakeDOM(el, depth) {
+        return {
+          className: el.className || '',
+          innerHTML: el.innerHTML || '',
+          children: depth < MAX_DEPTH
+            ? Array.from(el.children).map(function(c) { return toFakeDOM(c, depth + 1); })
+            : []
+        };
+      }
+      return Array.from(document.querySelectorAll(selector)).map(function(el) { return toFakeDOM(el, 0); });
+    },
+
+    getUrl: function() {
+      return window.location.href;
+    },
+
+    getCookies: function() {
+      return document.cookie;
+    },
+
+    setCookies: function(cookieString) {
+      cookieString.split('; ').forEach(function(cookie) {
+        document.cookie = cookie;
+      });
+      return { ok: true };
+    },
+
+    waitForSelector: function(selector, timeout) {
+      return new Promise(function(resolve) {
+        var el = document.querySelector(selector);
+        if (el) { resolve({ ok: true }); return; }
+
+        var observer = new MutationObserver(function() {
+          var found = document.querySelector(selector);
+          if (found) {
+            observer.disconnect();
+            clearTimeout(timer);
+            resolve({ ok: true });
+          }
+        });
+        observer.observe(document.body || document.documentElement, { childList: true, subtree: true });
+
+        var timer = setTimeout(function() {
+          observer.disconnect();
+          resolve({ ok: false, error: 'Timeout waiting for: ' + selector });
+        }, timeout || 10000);
+      });
+    }
+  };
+
+  var ALLOWED_METHODS = ['fill','click','select','exists','querySelectorAll','getUrl','getCookies','setCookies','waitForSelector'];
+
+  // 커맨드 수신 리스너
+  window.addEventListener('message', function(e) {
+    try {
+      var msg = typeof e.data === 'string' ? JSON.parse(e.data) : e.data;
+      if (!msg || !msg.__lotto_call_id__ || !msg.method) return;
+      if (ALLOWED_METHODS.indexOf(msg.method) === -1) return;
+
+      var fn = window.__LOTTO_BRIDGE__[msg.method];
+      if (!fn) return;
+
+      Promise.resolve(fn.apply(null, msg.args || [])).then(function(result) {
+        window.ReactNativeWebView.postMessage(JSON.stringify({
+          __lotto_call_id__: msg.__lotto_call_id__,
+          result: result
+        }));
+      });
+    } catch (err) {
+      if (msg && msg.__lotto_call_id__) {
+        window.ReactNativeWebView.postMessage(JSON.stringify({
+          __lotto_call_id__: msg.__lotto_call_id__,
+          result: { ok: false, error: String(err) }
+        }));
+      }
+    }
+  });
+
+  true;
+})();
+`;

package/lib/esm/controllers/webview/index.js

@@ -0,0 +1,31 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { WebViewPage } from './webview.page';
+export class WebViewController {
+    constructor(configs, logger) {
+        this.page = null;
+        this.focus = () => __awaiter(this, void 0, void 0, function* () {
+            if (!this.page) {
+                this.page = new WebViewPage(this.configs.controller, this.logger);
+            }
+            return this.page;
+        });
+        this.close = () => __awaiter(this, void 0, void 0, function* () {
+            this.configs.controller.destroy();
+            this.page = null;
+        });
+        this.cleanPages = () => __awaiter(this, void 0, void 0, function* () {
+            // WebView는 단일 페이지이므로 no-op
+            this.logger.debug('[WebViewController]', 'cleanPages is no-op for WebView');
+        });
+        this.configs = configs;
+        this.logger = logger;
+    }
+}

package/lib/esm/controllers/webview/types.js

@@ -0,0 +1 @@
+export {};