@rich-automation/lotto 0.1.7 → 2.0.0

package/README.md

@@ -1,4 +1,134 @@
 # @rich-automation/lotto
 
-[![ci](https://github.com/rich-automation/lotto-module/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/rich-automation/lotto-module/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@rich-automation/lotto.svg?style=popout&colorB=yellow)](https://www.npmjs.com/package/@rich-automation/lotto)  
+[![ci](https://github.com/rich-automation/lotto-module/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/rich-automation/lotto-module/actions/workflows/ci.yml)  
 [![codecov](https://codecov.io/gh/rich-automation/lotto-module/branch/main/graph/badge.svg?token=18IAW1OW77)](https://codecov.io/gh/rich-automation/lotto-module)
+
+`@rich-automation/lotto`는 headless browser를 활용해 JS 환경에서 로또를 자동으로 구매할 수 있는 인터페이스를 제공합니다.
+
+## 설치
+
+```bash
+# npm
+npm install @rich-automation/lotto
+
+# yarn
+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) 사이트에서 진행되며, 예치금 충전 기능은 없으므로 미리 계정에 예치금을 충전해두어야 합니다.
+
+## 사용법
+
+### 기본 설정
+
+```js
+import { LottoService } from '@rich-automation/lotto';
+import { chromium } from 'playwright';
+import puppeteer from 'puppeteer';
+
+// playwright 로 시작, 모든 기능 사용 가능
+const lottoService = new LottoService({
+  controller: chromium // puppeteer
+});
+
+// puppeteer 로 시작, 모든 기능 사용 가능
+const lottoService = new LottoService({
+  controller: puppeteer
+});
+
+// API 모드로 시작, check / getCheckWinningLink 기능만 사용 가능
+const lottoService = new LottoService({
+  controller: 'api'
+});
+```
+
+옵션 설명:
+
+- `controller`: (필수) `puppeteer`, `playwright` 모듈 또는 `"api"`
+- `headless`: 기본값 `false`
+- `defaultViewport`: 기본값 `{ width: 1080, height: 1024 }`
+- `logLevel`: 기본값 `2` (NONE = -1, ERROR = 0, WARN = 1, INFO = 2, DEBUG = 3)
+
+```js
+import { LottoService, LogLevel } from '@rich-automation/lotto';
+
+const lottoService = new LottoService({
+  controller: chromium,
+  headless: true,
+  defaultViewport: { width: 1280, height: 720 },
+  logLevel: LogLevel.DEBUG
+});
+```
+
+### 로또 구매
+
+```js
+const ID = '<YOUR_ID>';
+const PWD = '<YOUR_PASSWORD>';
+
+await lottoService.signIn(ID, PWD);
+
+const numbers = await lottoService.purchase(5);
+
+console.log(numbers); // [[ 1, 14, 21, 27, 30, 44 ],[ 4, 5, 27, 29, 40, 44 ],[ 9, 18, 19, 24, 38, 42 ],[ 4, 6, 13, 20, 38, 39 ],[ 8, 9, 10, 19, 32, 40 ]]
+```
+
+### 당첨 확인
+
+이번 회차 확인:
+
+```js
+import { getLastLottoRound } from '@rich-automation/lotto';
+
+const numbers = [
+  [1, 2, 3, 4, 5, 6],
+  [5, 6, 7, 8, 9, 10]
+];
+
+const currentRound = getLastLottoRound();
+
+const result = await lottoService.check(numbers, currentRound);
+
+console.log(result); // [{rank:1,matchedNumbers:[1,2,3,4,5,6]},{rank:5,matchedNumbers:[5,6]]
+```
+
+다음 회차 링크 생성:
+
+```js
+import { getNextLottoRound } from '@rich-automation/lotto';
+
+const nextRound = getNextLottoRound();
+const link = lottoService.getCheckWinningLink(numbers, nextRound);
+
+console.log(link); // "https://dhlottery.co.kr/qr.do?method=winQr&v=1071q010203040506q050607080910";
+```
+
+## API
+
+### `signIn(id: string, password: string): Promise<string>`
+
+동행복권 로그인, 성공 시 로그인 쿠키 반환
+
+### `signInWithCookie(cookies: string): Promise<string>`
+
+쿠키 기반 로그인
+
+### `purchase(amount?: number): Promise<number[][]>`
+
+로또 번호 자동 구매 (1~5 게임)
+
+### `check(numbers: number[][], round?: number): Promise<{ rank:number; matchedNumbers:number[] }[]>`
+
+(API) 당첨 결과 확인
+
+### `getCheckWinningLink(numbers: number[][], round?: number): string`
+
+(API) 당첨 확인 링크 생성
+
+### `destroy(): Promise<void>`
+
+브라우저 인스턴스 종료

package/lib/cjs/constants/index.js

@@ -9,5 +9,5 @@ exports.CONST = {
     BROWSER_PAGE_POPUP_WAIT: 1500,
     BROWSER_PAGE_DIALOG_WAIT: 10000,
     WEEK_TO_MILLISECOND: 604800000,
-    THOUSAND_ROUND_DATE: '2022-01-29T11:50:00'
+    THOUSAND_ROUND_DATE: '2022-01-29T11:50:00Z'
 };

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

@@ -0,0 +1,28 @@
+"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.APIModeController = void 0;
+class APIModeController {
+    constructor(configs, logger) {
+        this.focus = () => __awaiter(this, void 0, void 0, function* () {
+            throw new Error('APIModeController does not support focus method');
+        });
+        this.close = () => __awaiter(this, void 0, void 0, function* () {
+            this.logger.warn('APIModeController does not support close method');
+        });
+        this.cleanPages = () => __awaiter(this, void 0, void 0, function* () {
+            this.logger.warn('APIModeController does not support cleanPages method');
+        });
+        this.logger = logger;
+        this.configs = configs;
+    }
+}
+exports.APIModeController = APIModeController;

package/lib/cjs/controllers/factory.js

@@ -3,12 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBrowserController = void 0;
 const puppeteer_1 = require("./puppeteer");
 const playwright_1 = require("./playwright");
-function createBrowserController(name, configs, logger) {
-    switch (name) {
-        case 'puppeteer':
-            return new puppeteer_1.PuppeteerController(configs, logger);
-        case 'playwright':
-            return new playwright_1.PlaywrightController(configs, logger);
+const api_1 = require("./api");
+function createBrowserController(configs, logger) {
+    if (isAPIMode(configs)) {
+        return new api_1.APIModeController(configs, logger);
     }
+    if (isPlaywright(configs)) {
+        return new playwright_1.PlaywrightController(configs, logger);
+    }
+    if (isPuppeteer(configs)) {
+        return new puppeteer_1.PuppeteerController(configs, logger);
+    }
+    throw new Error('Invalid browser controller');
 }
 exports.createBrowserController = createBrowserController;
+function isAPIMode(configs) {
+    return configs.controller === 'api';
+}
+function isPlaywright(configs) {
+    return typeof configs.controller !== 'string' && 'connectOverCDP' in configs.controller;
+}
+function isPuppeteer(configs) {
+    return typeof configs.controller !== 'string' && 'executablePath' in configs.controller;
+}

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

@@ -10,7 +10,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlaywrightController = void 0;
-const playwright_1 = require("playwright");
 const deferred_1 = require("../../utils/deferred");
 const playwright_page_1 = require("./playwright.page");
 const constants_1 = require("../../constants");
@@ -69,7 +68,7 @@ class PlaywrightController {
         });
         this.configs = configs;
         this.logger = logger;
-        playwright_1.chromium.launch(this.configs).then((browser) => __awaiter(this, void 0, void 0, function* () {
+        this.configs.controller.launch(this.configs).then((browser) => __awaiter(this, void 0, void 0, function* () {
             this.browser = browser;
             this.context = yield browser.newContext();
         }));

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

@@ -8,12 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PuppeteerController = void 0;
-const puppeteer_1 = __importDefault(require("puppeteer"));
 const deferred_1 = require("../../utils/deferred");
 const puppeteer_page_1 = require("./puppeteer.page");
 const constants_1 = require("../../constants");
@@ -71,8 +67,8 @@ class PuppeteerController {
         });
         this.configs = configs;
         this.logger = logger;
-        puppeteer_1.default
-            .launch(Object.assign(Object.assign({}, this.configs), { headless: this.configs.headless === true ? 'new' : this.configs.headless }))
+        configs.controller
+            .launch(Object.assign(Object.assign({}, this.configs), { headless: this.configs.headless === true }))
             .then((browser) => __awaiter(this, void 0, void 0, function* () {
             this.browser = browser;
         }));

package/lib/cjs/index.js

@@ -14,11 +14,17 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = exports.getCurrentLottoRound = exports.LottoService = void 0;
+exports.checkWinning = exports.getCheckWinningLink = exports.getNextLottoRound = exports.getLastLottoRound = exports.LogLevel = exports.LottoService = void 0;
 var lottoService_1 = require("./lottoService");
 Object.defineProperty(exports, "LottoService", { enumerable: true, get: function () { return lottoService_1.LottoService; } });
-var getCurrentLottoRound_1 = require("./utils/getCurrentLottoRound");
-Object.defineProperty(exports, "getCurrentLottoRound", { enumerable: true, get: function () { return getCurrentLottoRound_1.getCurrentLottoRound; } });
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
 __exportStar(require("./types"), exports);
+var getLastLottoRound_1 = require("./utils/getLastLottoRound");
+Object.defineProperty(exports, "getLastLottoRound", { enumerable: true, get: function () { return getLastLottoRound_1.getLastLottoRound; } });
+var getNextLottoRound_1 = require("./utils/getNextLottoRound");
+Object.defineProperty(exports, "getNextLottoRound", { enumerable: true, get: function () { return getNextLottoRound_1.getNextLottoRound; } });
+var getCheckWinningLink_1 = require("./utils/getCheckWinningLink");
+Object.defineProperty(exports, "getCheckWinningLink", { enumerable: true, get: function () { return getCheckWinningLink_1.getCheckWinningLink; } });
+var checkWinning_1 = require("./utils/checkWinning");
+Object.defineProperty(exports, "checkWinning", { enumerable: true, get: function () { return checkWinning_1.checkWinning; } });

package/lib/cjs/lottoError.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const invertObject_1 = require("./utils/invertObject");
 const BaseErrorCode = {
     NETWORK_ERROR: 100001,
+    NOT_SUPPORTED: 110000,
     UNKNOWN_ERROR: 199999
 };
 const LoginErrorCode = {
@@ -25,7 +26,8 @@ const ErrorMessage = {
     [ErrorCode.INVALID_ROUND]: '로또 회차가 올바르지 않습니다.',
     [ErrorCode.INVALID_LOTTO_NUMBER]: '로또 번호가 올바르지 않습니다.',
     [ErrorCode.NOT_AUTHENTICATED]: '인증되지 않았습니다.',
-    [ErrorCode.PURCHASE_UNAVAILABLE]: '현재는 로또 구매가 불가능합니다.'
+    [ErrorCode.PURCHASE_UNAVAILABLE]: '현재는 로또 구매가 불가능합니다.',
+    [ErrorCode.NOT_SUPPORTED]: '지원되지 않는 기능입니다.'
 };
 class LottoError extends Error {
     static NetworkError() {
@@ -52,6 +54,9 @@ class LottoError extends Error {
     static PurchaseUnavailable() {
         return new LottoError(ErrorCode.PURCHASE_UNAVAILABLE);
     }
+    static NotSupported(message) {
+        return new LottoError(ErrorCode.NOT_SUPPORTED, message);
+    }
     static get code() {
         return ErrorCode;
     }

package/lib/cjs/lottoService.js

@@ -21,22 +21,28 @@ const deferred_1 = require("./utils/deferred");
 const constants_1 = require("./constants");
 const lazyRun_1 = require("./utils/lazyRun");
 const logger_1 = __importDefault(require("./logger"));
-const getCurrentLottoRound_1 = require("./utils/getCurrentLottoRound");
+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) {
-        var _a;
         this.context = {
             authenticated: false
         };
         this.destroy = () => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw lottoError_1.default.NotSupported('API mode does not support destroy.');
+            }
             return (0, lazyRun_1.lazyRun)(this.browserController.close, constants_1.CONST.BROWSER_DESTROY_SAFE_TIMEOUT);
         });
         this.signInWithCookie = (cookies) => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw lottoError_1.default.NotSupported('API mode does not support signInWithCookie.');
+            }
             // 쿠키 설정 & 페이지 이동
             const page = yield this.browserController.focus(0);
             this.logger.debug('[signInWithCookie]', 'setCookies');
@@ -58,6 +64,9 @@ class LottoService {
             return page.getCookies();
         });
         this.signIn = (id, password) => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw lottoError_1.default.NotSupported('API mode does not support signIn.');
+            }
             const p = (0, deferred_1.deferred)();
             queueMicrotask(() => __awaiter(this, void 0, void 0, function* () {
                 // 페이지 이동
@@ -98,6 +107,9 @@ class LottoService {
             return p.promise;
         });
         this.purchase = (amount = 5) => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw lottoError_1.default.NotSupported('API mode does not support purchase.');
+            }
             if (!this.context.authenticated)
                 throw lottoError_1.default.NotAuthenticated();
             this.logger.debug('[purchase]', 'validatePurchaseAvailability');
@@ -131,18 +143,18 @@ class LottoService {
                 return elems.map(it => Array.from(it.children).map(child => Number(child.innerHTML)));
             });
         });
-        this.check = (numbers, round = (0, getCurrentLottoRound_1.getCurrentLottoRound)()) => __awaiter(this, void 0, void 0, function* () {
-            (0, validateLottoNumber_1.validateLottoNumber)(numbers);
+        this.check = (numbers, round = (0, getLastLottoRound_1.getLastLottoRound)()) => __awaiter(this, void 0, void 0, function* () {
+            numbers.forEach(number => (0, validateLottoNumber_1.validateLottoNumber)(number));
             this.logger.debug('[check]', 'getWinningNumbers');
             const winningNumbers = yield (0, getWinningNumbers_1.getWinningNumbers)(round);
-            return (0, checkWinning_1.checkWinning)(numbers, winningNumbers);
+            return numbers.map(game => (0, checkWinning_1.checkWinning)(game, winningNumbers));
         });
-        this.getCheckWinningLink = (round, numbers) => {
+        this.getCheckWinningLink = (numbers, round = (0, getNextLottoRound_1.getNextLottoRound)()) => {
             this.logger.debug('[getCheckWinningLink]', 'getCheckWinningLink');
-            return (0, getCheckWinningLink_1.getCheckWinningLink)(round, numbers);
+            return (0, getCheckWinningLink_1.getCheckWinningLink)(numbers, round);
         };
-        this.logger = new logger_1.default(configs === null || configs === void 0 ? void 0 : configs.logLevel, '[LottoService]');
-        this.browserController = (0, factory_1.createBrowserController)((_a = configs === null || configs === void 0 ? void 0 : configs.controller) !== null && _a !== void 0 ? _a : 'playwright', Object.assign({ defaultViewport: { width: 1080, height: 1024 } }, configs), this.logger);
+        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);
     }
 }
 exports.LottoService = LottoService;

package/lib/cjs/utils/checkWinning.js

@@ -1,16 +1,7 @@
 "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.checkWinning = void 0;
-const checkWinning = (myNumber, winningNumbers) => __awaiter(void 0, void 0, void 0, function* () {
+const checkWinning = (myNumber, winningNumbers) => {
     const mainWinningNumbers = winningNumbers.slice(0, 6);
     const bonusNumber = winningNumbers.at(-1);
     const matchedNumbers = myNumber.filter(n => mainWinningNumbers.includes(n));
@@ -33,5 +24,5 @@ const checkWinning = (myNumber, winningNumbers) => __awaiter(void 0, void 0, voi
         rank = 5;
     }
     return { rank, matchedNumbers };
-});
+};
 exports.checkWinning = checkWinning;

package/lib/cjs/utils/getCheckWinningLink.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCheckWinningLink = void 0;
 const urls_1 = require("../constants/urls");
-function getCheckWinningLink(round, numbers) {
+function getCheckWinningLink(numbers, round) {
     const nums = numbers.map(it => 'q' + it.map(n => String(n).padStart(2, '0')).join('')).join('');
     return `${urls_1.URLS.CHECK_WINNING}?method=winQr&v=${round}${nums}`;
 }

package/lib/cjs/utils/{getCurrentLottoRound.js → getLastLottoRound.js}

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurrentLottoRound = void 0;
+exports.getLastLottoRound = void 0;
 const constants_1 = require("../constants");
-const getCurrentLottoRound = () => {
+const getLastLottoRound = () => {
     const standardDate = new Date(constants_1.CONST.THOUSAND_ROUND_DATE);
     const now = new Date(global.Date.now());
     const ADDITIONAL_ROUND = Math.floor((now.getTime() - standardDate.getTime()) / constants_1.CONST.WEEK_TO_MILLISECOND);
     return 1000 + ADDITIONAL_ROUND;
 };
-exports.getCurrentLottoRound = getCurrentLottoRound;
+exports.getLastLottoRound = getLastLottoRound;

package/lib/cjs/utils/getNextLottoRound.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextLottoRound = void 0;
+const constants_1 = require("../constants");
+const getNextLottoRound = () => {
+    const standardDate = new Date(constants_1.CONST.THOUSAND_ROUND_DATE);
+    const now = new Date(global.Date.now());
+    const ADDITIONAL_ROUND = Math.floor((now.getTime() - standardDate.getTime()) / constants_1.CONST.WEEK_TO_MILLISECOND) + 1;
+    return 1000 + ADDITIONAL_ROUND;
+};
+exports.getNextLottoRound = getNextLottoRound;

package/lib/esm/constants/index.js

@@ -6,5 +6,5 @@ export const CONST = {
     BROWSER_PAGE_POPUP_WAIT: 1500,
     BROWSER_PAGE_DIALOG_WAIT: 10000,
     WEEK_TO_MILLISECOND: 604800000,
-    THOUSAND_ROUND_DATE: '2022-01-29T11:50:00'
+    THOUSAND_ROUND_DATE: '2022-01-29T11:50:00Z'
 };

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

@@ -0,0 +1,25 @@
+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 {} from '../../logger';
+export class APIModeController {
+    constructor(configs, logger) {
+        this.focus = () => __awaiter(this, void 0, void 0, function* () {
+            throw new Error('APIModeController does not support focus method');
+        });
+        this.close = () => __awaiter(this, void 0, void 0, function* () {
+            this.logger.warn('APIModeController does not support close method');
+        });
+        this.cleanPages = () => __awaiter(this, void 0, void 0, function* () {
+            this.logger.warn('APIModeController does not support cleanPages method');
+        });
+        this.logger = logger;
+        this.configs = configs;
+    }
+}

package/lib/esm/controllers/factory.js

@@ -1,10 +1,24 @@
 import { PuppeteerController } from './puppeteer';
 import { PlaywrightController } from './playwright';
-export function createBrowserController(name, configs, logger) {
-    switch (name) {
-        case 'puppeteer':
-            return new PuppeteerController(configs, logger);
-        case 'playwright':
-            return new PlaywrightController(configs, logger);
+import { APIModeController } from './api';
+export function createBrowserController(configs, logger) {
+    if (isAPIMode(configs)) {
+        return new APIModeController(configs, logger);
     }
+    if (isPlaywright(configs)) {
+        return new PlaywrightController(configs, logger);
+    }
+    if (isPuppeteer(configs)) {
+        return new PuppeteerController(configs, logger);
+    }
+    throw new Error('Invalid browser controller');
+}
+function isAPIMode(configs) {
+    return configs.controller === 'api';
+}
+function isPlaywright(configs) {
+    return typeof configs.controller !== 'string' && 'connectOverCDP' in configs.controller;
+}
+function isPuppeteer(configs) {
+    return typeof configs.controller !== 'string' && 'executablePath' in configs.controller;
 }

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

@@ -7,7 +7,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { chromium } from 'playwright';
 import { deferred } from '../../utils/deferred';
 import { PlaywrightPage } from './playwright.page';
 import { CONST } from '../../constants';
@@ -67,7 +66,7 @@ export class PlaywrightController {
         });
         this.configs = configs;
         this.logger = logger;
-        chromium.launch(this.configs).then((browser) => __awaiter(this, void 0, void 0, function* () {
+        this.configs.controller.launch(this.configs).then((browser) => __awaiter(this, void 0, void 0, function* () {
             this.browser = browser;
             this.context = yield browser.newContext();
         }));

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

@@ -7,7 +7,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import puppeteer, { Browser } from 'puppeteer';
 import { deferred } from '../../utils/deferred';
 import { PuppeteerPage } from './puppeteer.page';
 import { CONST } from '../../constants';
@@ -66,8 +65,8 @@ export class PuppeteerController {
         });
         this.configs = configs;
         this.logger = logger;
-        puppeteer
-            .launch(Object.assign(Object.assign({}, this.configs), { headless: this.configs.headless === true ? 'new' : this.configs.headless }))
+        configs.controller
+            .launch(Object.assign(Object.assign({}, this.configs), { headless: this.configs.headless === true }))
             .then((browser) => __awaiter(this, void 0, void 0, function* () {
             this.browser = browser;
         }));

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

@@ -7,7 +7,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { Page } from 'puppeteer';
 import { deferred } from '../../utils/deferred';
 import { lazyRun } from '../../utils/lazyRun';
 export class PuppeteerPage {

package/lib/esm/index.js

@@ -1,4 +1,7 @@
 export { LottoService } from './lottoService';
-export { getCurrentLottoRound } from './utils/getCurrentLottoRound';
 export { LogLevel } from './logger';
 export * from './types';
+export { getLastLottoRound } from './utils/getLastLottoRound';
+export { getNextLottoRound } from './utils/getNextLottoRound';
+export { getCheckWinningLink } from './utils/getCheckWinningLink';
+export { checkWinning } from './utils/checkWinning';

package/lib/esm/lottoError.js

@@ -1,6 +1,7 @@
 import { invertObject } from './utils/invertObject';
 const BaseErrorCode = {
     NETWORK_ERROR: 100001,
+    NOT_SUPPORTED: 110000,
     UNKNOWN_ERROR: 199999
 };
 const LoginErrorCode = {
@@ -23,7 +24,8 @@ const ErrorMessage = {
     [ErrorCode.INVALID_ROUND]: '로또 회차가 올바르지 않습니다.',
     [ErrorCode.INVALID_LOTTO_NUMBER]: '로또 번호가 올바르지 않습니다.',
     [ErrorCode.NOT_AUTHENTICATED]: '인증되지 않았습니다.',
-    [ErrorCode.PURCHASE_UNAVAILABLE]: '현재는 로또 구매가 불가능합니다.'
+    [ErrorCode.PURCHASE_UNAVAILABLE]: '현재는 로또 구매가 불가능합니다.',
+    [ErrorCode.NOT_SUPPORTED]: '지원되지 않는 기능입니다.'
 };
 export default class LottoError extends Error {
     static NetworkError() {
@@ -50,6 +52,9 @@ export default class LottoError extends Error {
     static PurchaseUnavailable() {
         return new LottoError(ErrorCode.PURCHASE_UNAVAILABLE);
     }
+    static NotSupported(message) {
+        return new LottoError(ErrorCode.NOT_SUPPORTED, message);
+    }
     static get code() {
         return ErrorCode;
     }

package/lib/esm/lottoService.js

@@ -15,22 +15,28 @@ import { deferred } from './utils/deferred';
 import { CONST } from './constants';
 import { lazyRun } from './utils/lazyRun';
 import Logger, {} from './logger';
-import { getCurrentLottoRound } from './utils/getCurrentLottoRound';
+import { getLastLottoRound } from './utils/getLastLottoRound';
 import { validateLottoNumber } from './utils/validateLottoNumber';
 import { getWinningNumbers } from './apis/dhlottery/getWinningNumbers';
 import { checkWinning } from './utils/checkWinning';
 import { validatePurchaseAvailability } from './utils/validatePurchaseAvailability';
 import { getCheckWinningLink } from './utils/getCheckWinningLink';
+import { getNextLottoRound } from './utils/getNextLottoRound';
 export class LottoService {
     constructor(configs) {
-        var _a;
         this.context = {
             authenticated: false
         };
         this.destroy = () => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw LottoError.NotSupported('API mode does not support destroy.');
+            }
             return lazyRun(this.browserController.close, CONST.BROWSER_DESTROY_SAFE_TIMEOUT);
         });
         this.signInWithCookie = (cookies) => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw LottoError.NotSupported('API mode does not support signInWithCookie.');
+            }
             // 쿠키 설정 & 페이지 이동
             const page = yield this.browserController.focus(0);
             this.logger.debug('[signInWithCookie]', 'setCookies');
@@ -52,6 +58,9 @@ export class LottoService {
             return page.getCookies();
         });
         this.signIn = (id, password) => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw LottoError.NotSupported('API mode does not support signIn.');
+            }
             const p = deferred();
             queueMicrotask(() => __awaiter(this, void 0, void 0, function* () {
                 // 페이지 이동
@@ -92,6 +101,9 @@ export class LottoService {
             return p.promise;
         });
         this.purchase = (amount = 5) => __awaiter(this, void 0, void 0, function* () {
+            if (this.browserController.configs.controller === 'api') {
+                throw LottoError.NotSupported('API mode does not support purchase.');
+            }
             if (!this.context.authenticated)
                 throw LottoError.NotAuthenticated();
             this.logger.debug('[purchase]', 'validatePurchaseAvailability');
@@ -125,17 +137,17 @@ export class LottoService {
                 return elems.map(it => Array.from(it.children).map(child => Number(child.innerHTML)));
             });
         });
-        this.check = (numbers, round = getCurrentLottoRound()) => __awaiter(this, void 0, void 0, function* () {
-            validateLottoNumber(numbers);
+        this.check = (numbers, round = getLastLottoRound()) => __awaiter(this, void 0, void 0, function* () {
+            numbers.forEach(number => validateLottoNumber(number));
             this.logger.debug('[check]', 'getWinningNumbers');
             const winningNumbers = yield getWinningNumbers(round);
-            return checkWinning(numbers, winningNumbers);
+            return numbers.map(game => checkWinning(game, winningNumbers));
         });
-        this.getCheckWinningLink = (round, numbers) => {
+        this.getCheckWinningLink = (numbers, round = getNextLottoRound()) => {
             this.logger.debug('[getCheckWinningLink]', 'getCheckWinningLink');
-            return getCheckWinningLink(round, numbers);
+            return getCheckWinningLink(numbers, round);
         };
-        this.logger = new Logger(configs === null || configs === void 0 ? void 0 : configs.logLevel, '[LottoService]');
-        this.browserController = createBrowserController((_a = configs === null || configs === void 0 ? void 0 : configs.controller) !== null && _a !== void 0 ? _a : 'playwright', Object.assign({ defaultViewport: { width: 1080, height: 1024 } }, configs), this.logger);
+        this.logger = new Logger(configs.logLevel, '[LottoService]');
+        this.browserController = createBrowserController(Object.assign({ defaultViewport: { width: 1080, height: 1024 } }, configs), this.logger);
     }
 }

package/lib/esm/utils/checkWinning.js

@@ -1,13 +1,4 @@
-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());
-    });
-};
-export const checkWinning = (myNumber, winningNumbers) => __awaiter(void 0, void 0, void 0, function* () {
+export const checkWinning = (myNumber, winningNumbers) => {
     const mainWinningNumbers = winningNumbers.slice(0, 6);
     const bonusNumber = winningNumbers.at(-1);
     const matchedNumbers = myNumber.filter(n => mainWinningNumbers.includes(n));
@@ -30,4 +21,4 @@ export const checkWinning = (myNumber, winningNumbers) => __awaiter(void 0, void
         rank = 5;
     }
     return { rank, matchedNumbers };
-});
+};

package/lib/esm/utils/getCheckWinningLink.js

@@ -1,5 +1,5 @@
 import { URLS } from '../constants/urls';
-export function getCheckWinningLink(round, numbers) {
+export function getCheckWinningLink(numbers, round) {
     const nums = numbers.map(it => 'q' + it.map(n => String(n).padStart(2, '0')).join('')).join('');
     return `${URLS.CHECK_WINNING}?method=winQr&v=${round}${nums}`;
 }

package/lib/esm/utils/{getCurrentLottoRound.js → getLastLottoRound.js}

@@ -1,5 +1,5 @@
 import { CONST } from '../constants';
-export const getCurrentLottoRound = () => {
+export const getLastLottoRound = () => {
     const standardDate = new Date(CONST.THOUSAND_ROUND_DATE);
     const now = new Date(global.Date.now());
     const ADDITIONAL_ROUND = Math.floor((now.getTime() - standardDate.getTime()) / CONST.WEEK_TO_MILLISECOND);

package/lib/esm/utils/getNextLottoRound.js

@@ -0,0 +1,7 @@
+import { CONST } from '../constants';
+export const getNextLottoRound = () => {
+    const standardDate = new Date(CONST.THOUSAND_ROUND_DATE);
+    const now = new Date(global.Date.now());
+    const ADDITIONAL_ROUND = Math.floor((now.getTime() - standardDate.getTime()) / CONST.WEEK_TO_MILLISECOND) + 1;
+    return 1000 + ADDITIONAL_ROUND;
+};

package/lib/typescript/controllers/api/index.d.ts

@@ -0,0 +1,13 @@
+import type { BrowserConfigs, BrowserControllerInterface } from '../../types';
+import type { Browser, BrowserContext } from 'playwright';
+import { type LoggerInterface } from '../../logger';
+export declare class APIModeController implements BrowserControllerInterface {
+    configs: BrowserConfigs;
+    logger: LoggerInterface;
+    browser: Browser;
+    context: BrowserContext;
+    constructor(configs: BrowserConfigs, logger: LoggerInterface);
+    focus: () => Promise<never>;
+    close: () => Promise<void>;
+    cleanPages: () => Promise<void>;
+}

package/lib/typescript/controllers/factory.d.ts

@@ -1,3 +1,3 @@
-import type { BrowserConfigs, BrowserControllerInterface } from '../types';
+import type { BrowserConfigs, BrowserController, BrowserControllerInterface } from '../types';
 import type { LoggerInterface } from '../logger';
-export declare function createBrowserController(name: 'puppeteer' | 'playwright', configs: BrowserConfigs, logger: LoggerInterface): BrowserControllerInterface;
+export declare function createBrowserController<T extends BrowserController>(configs: BrowserConfigs<T>, logger: LoggerInterface): BrowserControllerInterface;

package/lib/typescript/controllers/playwright/index.d.ts

@@ -1,13 +1,14 @@
 import type { BrowserConfigs, BrowserControllerInterface } from '../../types';
 import type { Browser, BrowserContext } from 'playwright';
+import type { BrowserType } from 'playwright-core';
 import { PlaywrightPage } from './playwright.page';
 import { type LoggerInterface } from '../../logger';
-export declare class PlaywrightController implements BrowserControllerInterface {
-    configs: BrowserConfigs;
+export declare class PlaywrightController implements BrowserControllerInterface<BrowserType> {
+    configs: BrowserConfigs<BrowserType>;
     logger: LoggerInterface;
     browser: Browser;
     context: BrowserContext;
-    constructor(configs: BrowserConfigs, logger: LoggerInterface);
+    constructor(configs: BrowserConfigs<BrowserType>, logger: LoggerInterface);
     private getBrowserContext;
     focus: (pageIndex?: number) => Promise<PlaywrightPage>;
     close: () => Promise<void>;

package/lib/typescript/controllers/puppeteer/index.d.ts

@@ -1,12 +1,12 @@
 import type { BrowserConfigs, BrowserControllerInterface } from '../../types';
-import { Browser } from 'puppeteer';
 import { PuppeteerPage } from './puppeteer.page';
 import { type LoggerInterface } from '../../logger';
-export declare class PuppeteerController implements BrowserControllerInterface {
-    configs: BrowserConfigs;
+import type { PuppeteerNode, Browser } from 'puppeteer';
+export declare class PuppeteerController implements BrowserControllerInterface<PuppeteerNode> {
+    configs: BrowserConfigs<PuppeteerNode>;
     logger: LoggerInterface;
     browser: Browser;
-    constructor(configs: BrowserConfigs, logger: LoggerInterface);
+    constructor(configs: BrowserConfigs<PuppeteerNode>, logger: LoggerInterface);
     private getBrowser;
     focus: (pageIndex?: number) => Promise<PuppeteerPage>;
     close: () => Promise<void>;

package/lib/typescript/controllers/puppeteer/puppeteer.page.d.ts

@@ -1,5 +1,5 @@
 import type { BrowserPageEvents, BrowserPageInterface, FakeDOMElement, StringifiedCookies } from '../../types';
-import { Page } from 'puppeteer';
+import type { Page } from 'puppeteer';
 import type { LoggerInterface } from '../../logger';
 export declare class PuppeteerPage implements BrowserPageInterface {
     page: Page;

package/lib/typescript/index.d.ts

@@ -1,4 +1,7 @@
 export { LottoService } from './lottoService';
-export { getCurrentLottoRound } from './utils/getCurrentLottoRound';
 export { LogLevel } from './logger';
 export * from './types';
+export { getLastLottoRound } from './utils/getLastLottoRound';
+export { getNextLottoRound } from './utils/getNextLottoRound';
+export { getCheckWinningLink } from './utils/getCheckWinningLink';
+export { checkWinning } from './utils/checkWinning';

package/lib/typescript/lottoError.d.ts

@@ -6,6 +6,7 @@ declare const ErrorCode: {
     CREDENTIALS_INCORRECT: 200001;
     INVALID_COOKIE: 200002;
     NETWORK_ERROR: 100001;
+    NOT_SUPPORTED: 110000;
     UNKNOWN_ERROR: 199999;
 };
 type ErrorCodeNumber = (typeof ErrorCode)[keyof typeof ErrorCode];
@@ -18,6 +19,7 @@ export default class LottoError extends Error {
     static InvalidLottoNumber(): LottoError;
     static NotAuthenticated(): LottoError;
     static PurchaseUnavailable(): LottoError;
+    static NotSupported(message?: string): LottoError;
     static get code(): {
         INVALID_ROUND: 300001;
         INVALID_LOTTO_NUMBER: 300002;
@@ -26,10 +28,11 @@ export default class LottoError extends Error {
         CREDENTIALS_INCORRECT: 200001;
         INVALID_COOKIE: 200002;
         NETWORK_ERROR: 100001;
+        NOT_SUPPORTED: 110000;
         UNKNOWN_ERROR: 199999;
     };
     static getMessage(code: ErrorCodeNumber): string;
-    static getName(code: ErrorCodeNumber): "INVALID_ROUND" | "INVALID_LOTTO_NUMBER" | "NOT_AUTHENTICATED" | "PURCHASE_UNAVAILABLE" | "CREDENTIALS_INCORRECT" | "INVALID_COOKIE" | "NETWORK_ERROR" | "UNKNOWN_ERROR";
+    static getName(code: ErrorCodeNumber): "INVALID_ROUND" | "INVALID_LOTTO_NUMBER" | "NOT_AUTHENTICATED" | "PURCHASE_UNAVAILABLE" | "CREDENTIALS_INCORRECT" | "INVALID_COOKIE" | "NETWORK_ERROR" | "NOT_SUPPORTED" | "UNKNOWN_ERROR";
     code: number;
     constructor(code: ErrorCodeNumber, message?: string);
 }

package/lib/typescript/lottoService.d.ts

@@ -6,14 +6,14 @@ export declare class LottoService implements LottoServiceInterface {
     };
     browserController: BrowserControllerInterface;
     logger: LoggerInterface;
-    constructor(configs?: BrowserConfigs);
+    constructor(configs: BrowserConfigs);
     destroy: () => Promise<void>;
     signInWithCookie: (cookies: string) => Promise<string>;
     signIn: (id: string, password: string) => Promise<string>;
     purchase: (amount?: number) => Promise<number[][]>;
-    check: (numbers: number[], round?: number) => Promise<{
+    check: (numbers: number[][], round?: number) => Promise<{
         rank: number;
         matchedNumbers: number[];
-    }>;
-    getCheckWinningLink: (round: number, numbers: number[][]) => string;
+    }[]>;
+    getCheckWinningLink: (numbers: number[][], round?: number) => string;
 }

package/lib/typescript/types.d.ts

@@ -1,17 +1,20 @@
 import type { LogLevel } from './logger';
+import type { PuppeteerNode } from 'puppeteer';
+import type { BrowserType } from 'playwright-core';
 export interface LottoServiceInterface {
     destroy(): Promise<void>;
     signIn(id: string, password: string): Promise<string>;
     signInWithCookie(cookie: string): Promise<string>;
-    check(numbers: number[], volume?: number): Promise<{
+    check(numbers: number[][], volume?: number): Promise<{
         rank: number;
         matchedNumbers: number[];
-    }>;
+    }[]>;
     purchase(amount: number): Promise<number[][]>;
-    getCheckWinningLink(round: number, numbers: number[][]): string;
+    getCheckWinningLink(numbers: number[][], round: number): string;
 }
-export interface BrowserConfigs {
-    controller?: 'puppeteer' | 'playwright';
+export type BrowserController = PuppeteerNode | BrowserType | 'api';
+export interface BrowserConfigs<T extends BrowserController = BrowserController> {
+    controller: T;
     logLevel?: LogLevel;
     headless?: boolean;
     defaultViewport?: {
@@ -21,8 +24,8 @@ export interface BrowserConfigs {
     [key: string]: unknown;
     args?: string[];
 }
-export interface BrowserControllerInterface {
-    configs: BrowserConfigs;
+export interface BrowserControllerInterface<T extends BrowserController = BrowserController> {
+    configs: BrowserConfigs<T>;
     focus(pageIndex?: number): Promise<BrowserPageInterface>;
     cleanPages(remainingPageIndex: number[]): Promise<void>;
     close(): Promise<void>;

package/lib/typescript/utils/checkWinning.d.ts

@@ -1,4 +1,4 @@
-export declare const checkWinning: (myNumber: number[], winningNumbers: number[]) => Promise<{
+export declare const checkWinning: (myNumber: number[], winningNumbers: number[]) => {
     rank: number;
     matchedNumbers: number[];
-}>;
+};

package/lib/typescript/utils/getCheckWinningLink.d.ts

@@ -1 +1 @@
-export declare function getCheckWinningLink(round: number, numbers: number[][]): string;
+export declare function getCheckWinningLink(numbers: number[][], round: number): string;

package/lib/typescript/utils/getLastLottoRound.d.ts

@@ -0,0 +1 @@
+export declare const getLastLottoRound: () => number;

package/lib/typescript/utils/getNextLottoRound.d.ts

@@ -0,0 +1 @@
+export declare const getNextLottoRound: () => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rich-automation/lotto",
-  "version": "0.1.7",
+  "version": "2.0.0",
   "description": "Lotto module",
   "publishConfig": {
     "access": "public",
@@ -35,7 +35,7 @@
     "build:esm": "tsc --project tsconfig.esm.json && echo '{\"type\": \"module\"}' > lib/esm/package.json",
     "build:dts": "tsc --project tsconfig.json --emitDeclarationOnly --declaration --declarationDir lib/typescript",
     "test": "jest --forceExit --detectOpenHandles",
-    "install:puppeteer": "node ./node_modules/puppeteer/install.js",
+    "install:puppeteer": "node ./node_modules/puppeteer/install.mjs",
     "install:playwright": "npx playwright install chromium --with-deps",
     "fix": "yarn fix:eslint && yarn fix:prettier",
     "fix:eslint": "eslint --fix src --ext js,jsx,ts,tsx ",
@@ -46,11 +46,21 @@
     "lint:prettier": "prettier --check \"src/**/*.{ts,tsx,js}\""
   },
   "dependencies": {
-    "axios": "^1.3.5",
-    "dayjs": "^1.11.7",
+    "axios": "^1.8.4",
+    "dayjs": "^1.11.13"
+  },
+  "peerDependencies": {
     "playwright": "^1.35.0",
     "puppeteer": "^20.5.0"
   },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    },
+    "puppeteer": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@babel/core": "^7.21.4",
     "@babel/preset-env": "^7.21.4",
@@ -64,7 +74,9 @@
     "eslint-config-prettier": "^8.8.0",
     "eslint-plugin-prettier": "^4.2.1",
     "jest": "^29.5.0",
+    "playwright": "^1.51.1",
     "prettier": "^2.8.7",
+    "puppeteer": "^24.6.1",
     "release-it": "^15.10.3",
     "ts-node": "^10.9.1",
     "typescript": "^5.0.4"

package/lib/typescript/utils/getCurrentLottoRound.d.ts

@@ -1 +0,0 @@
-export declare const getCurrentLottoRound: () => number;