k-dhlottery-api 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fhwang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# 비공식 동행복권 API (Node.js)
+
+[동행복권](https://dhlottery.co.kr/) 사이트를 터미널에서 이용할 수 있게 랩핑한 API입니다.  
+원본 Python 프로젝트 [roeniss/dhlottery-api](https://github.com/roeniss/dhlottery-api)를 Node.js로 마이그레이션한 버전입니다.
+
+## 요구사항
+
+- Node.js 18 이상
+
+## 설치 및 사용법
+
+### npm 패키지로 설치 (배포 후)
+
+```bash
+npm install -g k-dhlottery-api
+# 또는
+npx k-dhlottery-api --help
+
+dhapi buy-lotto645 -y
+```
+
+설치 후 실행 명령어는 `dhapi`입니다 (패키지 이름은 `k-dhlottery-api`).
+
+### 소스에서 설치
+
+```bash
+git clone <this-repo>
+cd k-dhlottery-api
+npm install
+npm run build
+
+# 기본 도움말
+dhapi --help
+# 또는
+node dist/cli.js --help
+
+# 로또6/45 구매 도움말
+dhapi buy-lotto645 --help
+
+# 자동모드 5장 구매 & 확인절차 스킵
+dhapi buy-lotto645 -y
+```
+
+전역 설치 후 사용:
+
+```bash
+npm link
+dhapi buy-lotto645 -y
+```
+
+## 구현된 기능들
+
+- [로또6/45 구매](https://dhlottery.co.kr/gameInfo.do?method=gameMethod&wiselog=H_B_1_1) (`buy-lotto645`)
+  - 자동, 수동, 반자동 모드로 구매 가능합니다.
+  - 한 번에 최대 5장까지 구매 가능합니다.
+  - 매주 최대 5장까지 구매 가능합니다 (동행복권 측의 온라인 구매 관련 정책입니다).
+- [예치금 현황 조회](https://dhlottery.co.kr/userSsl.do?method=myPage) (`show-balance`)
+  - 현재 보유한 예치금 정보를 조회합니다.
+- [고정 가상계좌 입금을 위한 세팅](https://dhlottery.co.kr/userSsl.do?method=myPage) (`assign-virtual-account`)
+  - 개인에게 할당된 가상계좌에 입금하는 형태로 예치금을 충전할 수 있습니다. 이 때 얼마를 입금할건지 사이트에서 미리 선택해두어야 하는데, 이 작업을 대신 수행합니다.
+  - 입금은 직접 진행해야 합니다.
+  - 간편 충전 기능은 구현되지 않았습니다.
+
+### 유틸성 기능들
+
+- 복수 프로필 지정
+  - 두 개 이상의 프로필을 사용할 수 있습니다. 고급 설정 섹션을 참고해주세요.
+- 프로필 목록 조회 (`show-profiles`)
+  - 설정된 프로필 이름들을 확인할 수 있습니다.
+
+## 고급 설정
+
+### 프로필 (계정) 설정
+
+> [!NOTE] 최초 프로그램을 실행할 때 프로필 정보를 세팅하는 과정이 진행됩니다. 이 섹션에선 직접 프로필 정보 파일을 수정하는 법을 안내합니다.
+
+`~/.dhapi/credentials` (Windows: `%USERPROFILE%\.dhapi\credentials`) 파일을 사용해 프로필 정보를 수정하거나 여러 계정을 설정할 수 있습니다. toml 포맷을 사용하고 있으며, 아래와 같은 형식으로 작성할 수 있습니다.
+
+```toml
+[default]
+username = "dhlotter_id"
+password = "****"
+
+[another_profile]
+username = "dhlotter_second_id"
+password = "****"
+```
+
+이후 `-p` 플래그로 프로필을 골라 사용합니다.
+
+## 명령어 예시
+
+```bash
+# 자동 5장 (기본)
+dhapi buy-lotto645
+
+# 자동 1장
+dhapi buy-lotto645 ""
+
+# 수동 1장
+dhapi buy-lotto645 "1,2,3,4,5,6"
+
+# 반자동 1장 (1,2,3 고정)
+dhapi buy-lotto645 "1,2,3"
+
+# 수동 1장 + 반자동 1장
+dhapi buy-lotto645 "1,2,3,4,5,6" "7,8,9"
+
+# 확인 없이 자동 5장
+dhapi buy-lotto645 -y
+
+# 예치금 조회
+dhapi show-balance
+
+# 구매 내역 (최근 14일)
+dhapi show-buy-list -f json
+
+# 기간 지정
+dhapi show-buy-list -s 20250101 -e 20250131
+```
+
+## 백엔드 API 서버 (REST API)
+
+CLI 외에 HTTP API 서버로 같은 기능을 사용할 수 있습니다.
+
+```bash
+npm run server
+# 포트 지정 (Windows: set PORT=4000 && npm run server)
+PORT=4000 npm run server
+```
+
+| 메서드 | 경로 | 설명 |
+|--------|------|------|
+| GET | `/api/profiles` | 프로필 목록 |
+| GET | `/api/balance` | 예치금 현황 (query: `profile`) |
+| POST | `/api/buy-lotto645` | 로또 구매 (body: `profile`, `tickets`, `skipConfirm`) |
+| GET | `/api/buy-list` | 구매 내역 (query: `profile`, `format`, `startDate`, `endDate`) |
+| POST | `/api/assign-virtual-account` | 가상계좌 세팅 (body: `profile`, `amount`) |
+
+성공 시 `{ "success": true, "data": ... }`, 실패 시 `{ "success": false, "error": "메시지" }` 형식입니다.
+
+## npm 패키지 배포
+
+이 프로젝트를 npm에 배포하려면:
+
+1. [npmjs.com](https://www.npmjs.com/) 회원가입 후 `npm login`
+2. 패키지 이름: 이 프로젝트는 `k-dhlottery-api`로 npm에 배포됩니다. 스코프 패키지(예: `@내계정/dhapi`)로 쓰려면 `name`을 변경하면 됩니다.
+3. 버전 업데이트 후 배포:
+
+```bash
+npm run build
+npm test
+npm publish
+```
+
+- `prepublishOnly` 스크립트로 publish 전에 자동으로 `npm run build`가 실행됩니다.
+- 스코프 패키지(`@xxx/dhapi`)로 배포할 때는 `npm publish --access public`이 필요할 수 있습니다. (`publishConfig.access`가 이미 `public`으로 설정되어 있음)
+
+배포 전에 포함되는 파일 확인: `npm pack --dry-run`
+
+### GitHub Actions로 태그 푸시 시 자동 배포
+
+`v*` 형태의 태그를 푸시하면 자동으로 npm에 배포됩니다.
+
+1. **npm 인증 토큰 발급**  
+   [npm → Access Tokens](https://www.npmjs.com/account/tokens)에서 "Generate New Token" → "Automation" 또는 "Classic" 선택 후 토큰 복사.
+
+2. **GitHub 저장소에 시크릿 추가**  
+   저장소 **Settings → Secrets and variables → Actions**에서 New repository secret 추가:
+   - Name: `NPM_TOKEN`
+   - Value: 위에서 복사한 npm 토큰
+
+3. **버전 올리고 태그 푸시**
+
+```bash
+# package.json의 version 수정 후 (예: 1.0.1)
+git add package.json
+git commit -m "chore: release 1.0.1"
+git tag v1.0.1
+git push origin main
+git push origin v1.0.1
+```
+
+태그 `v1.0.1`을 푸시하면 `.github/workflows/publish-npm.yml`이 실행되어 빌드·테스트 후 npm에 publish됩니다.
+
+## 기부하기
+
+이 프로그램을 사용해서 1등에 당첨된다면, [원작자 roeniss](https://github.com/roeniss)에게 꼭 1000만원을 기부해주시길 바랍니다.
+
+원본 Python 프로젝트: [Buy Me A Coffee](https://www.buymeacoffee.com/roeniss)
+
+## 기여하기
+
+기여는 대환영합니다! [CONTRIBUTING.md](docs/CONTRIBUTING.md) 파일을 참고해주세요.
+
+## 라이선스
+
+MIT. 원본 [dhlottery-api](https://github.com/roeniss/dhlottery-api)는 Apache-2.0 라이선스입니다.

package/dist/api/routes.d.ts

@@ -0,0 +1,2 @@
+import { Router } from "express";
+export declare function createApiRouter(): Router;

package/dist/api/routes.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApiRouter = createApiRouter;
+const express_1 = require("express");
+const deposit_1 = require("../domain/deposit");
+const lotto645_ticket_1 = require("../domain/lotto645-ticket");
+const lottery_api_endpoint_1 = require("../endpoint/lottery-api-endpoint");
+const credentials_provider_1 = require("../port/credentials-provider");
+const lottery_client_1 = require("../port/lottery-client");
+function getProfile(req) {
+    return req.query.profile || req.body?.profile || "default";
+}
+function jsonSuccess(res, data, status = 200) {
+    res.status(status).json({ success: true, data });
+}
+function jsonError(res, message, status = 500) {
+    res.status(status).json({ success: false, error: message });
+}
+function createApiRouter() {
+    const router = (0, express_1.Router)();
+    /** GET /api/profiles - 등록된 프로필 목록 */
+    router.get("/profiles", (req, res) => {
+        try {
+            const profiles = credentials_provider_1.CredentialsProvider.listProfiles();
+            jsonSuccess(res, { profiles });
+        }
+        catch (e) {
+            jsonError(res, e.message || "프로필 목록을 불러올 수 없습니다.", 404);
+        }
+    });
+    /** GET /api/balance - 예치금 현황 (query: profile) */
+    router.get("/balance", async (req, res) => {
+        const profile = getProfile(req);
+        try {
+            const user = new credentials_provider_1.CredentialsProvider(profile).getUser();
+            const endpoint = new lottery_api_endpoint_1.LotteryApiEndpoint();
+            const client = new lottery_client_1.LotteryClient(user, endpoint);
+            await client.showBalance();
+            if (!endpoint.result.showBalance) {
+                return jsonError(res, "예치금 정보를 가져오지 못했습니다.", 502);
+            }
+            jsonSuccess(res, endpoint.result.showBalance);
+        }
+        catch (e) {
+            jsonError(res, e.message || "예치금 조회에 실패했습니다.", 500);
+        }
+    });
+    /** POST /api/buy-lotto645 - 로또 6/45 구매 (body: { profile?, tickets?: string[], skipConfirm?: boolean }) */
+    router.post("/buy-lotto645", async (req, res) => {
+        const profile = getProfile(req);
+        const ticketsInput = req.body?.tickets;
+        const skipConfirm = !!req.body?.skipConfirm;
+        try {
+            const user = new credentials_provider_1.CredentialsProvider(profile).getUser();
+            const tickets = ticketsInput && ticketsInput.length > 0
+                ? lotto645_ticket_1.Lotto645Ticket.createTickets(ticketsInput)
+                : lotto645_ticket_1.Lotto645Ticket.createAutoTickets(5);
+            if (!skipConfirm && tickets.length > 0) {
+                // API에서는 기본적으로 확인 스킵 (skipConfirm=true 권장)
+            }
+            const endpoint = new lottery_api_endpoint_1.LotteryApiEndpoint();
+            const client = new lottery_client_1.LotteryClient(user, endpoint);
+            await client.buyLotto645(tickets);
+            if (!endpoint.result.buyLotto645) {
+                return jsonError(res, "구매 결과를 가져오지 못했습니다.", 502);
+            }
+            jsonSuccess(res, endpoint.result.buyLotto645);
+        }
+        catch (e) {
+            jsonError(res, e.message || "로또 구매에 실패했습니다.", 500);
+        }
+    });
+    /** GET /api/buy-list - 구매 내역 (query: profile, format?, startDate?, endDate?) */
+    router.get("/buy-list", async (req, res) => {
+        const profile = getProfile(req);
+        const format = req.query.format || "json";
+        const startDate = req.query.startDate;
+        const endDate = req.query.endDate;
+        try {
+            const user = new credentials_provider_1.CredentialsProvider(profile).getUser();
+            const endpoint = new lottery_api_endpoint_1.LotteryApiEndpoint();
+            const client = new lottery_client_1.LotteryClient(user, endpoint);
+            await client.showBuyList(format, startDate, endDate);
+            if (!endpoint.result.showBuyList) {
+                return jsonError(res, "구매 내역을 가져오지 못했습니다.", 502);
+            }
+            jsonSuccess(res, endpoint.result.showBuyList);
+        }
+        catch (e) {
+            jsonError(res, e.message || "구매 내역 조회에 실패했습니다.", 500);
+        }
+    });
+    /** POST /api/assign-virtual-account - 가상계좌 세팅 (body: { profile?, amount: number }) */
+    router.post("/assign-virtual-account", async (req, res) => {
+        const profile = getProfile(req);
+        const amount = req.body?.amount != null ? Number(req.body.amount) : 50000;
+        try {
+            const user = new credentials_provider_1.CredentialsProvider(profile).getUser();
+            const deposit = new deposit_1.Deposit(amount);
+            const endpoint = new lottery_api_endpoint_1.LotteryApiEndpoint();
+            const client = new lottery_client_1.LotteryClient(user, endpoint);
+            await client.assignVirtualAccount(deposit);
+            if (!endpoint.result.assignVirtualAccount) {
+                return jsonError(res, "가상계좌 정보를 가져오지 못했습니다.", 502);
+            }
+            jsonSuccess(res, endpoint.result.assignVirtualAccount);
+        }
+        catch (e) {
+            jsonError(res, e.message || "가상계좌 할당에 실패했습니다.", 500);
+        }
+    });
+    return router;
+}

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const deposit_1 = require("./domain/deposit");
+const lotto645_ticket_1 = require("./domain/lotto645-ticket");
+const lottery_stdout_printer_1 = require("./endpoint/lottery-stdout-printer");
+const credentials_provider_1 = require("./port/credentials-provider");
+const lottery_client_1 = require("./port/lottery-client");
+const lotto645_buy_confirmer_1 = require("./purchase/lotto645-buy-confirmer");
+const pkg = require("../package.json");
+const program = new commander_1.Command();
+program
+    .name("dhapi")
+    .description("동행복권 비공식 API\n\n각 명령어에 대한 자세한 도움말은 'dhapi [명령어] -h'를 입력하세요.")
+    .version(pkg.version, "-V, --version", "dhapi 버전을 출력합니다.");
+program
+    .command("assign-virtual-account")
+    .description("예치금 충전용 가상계좌를 세팅합니다. dhapi에서는 본인 전용 계좌를 발급받는 것까지만 가능합니다. 출력되는 계좌로 직접 입금해주세요.")
+    .argument("[amount]", "입금할 금액 (5천원, 1만원, 2만원, 3만원, 5만원, 10만원, 20만원, 30만원, 50만원, 70만원, 100만원 중 하나)", "50000")
+    .option("-p, --profile <name>", "프로필을 지정합니다", "default")
+    .option("-d, --debug", "debug 로그를 활성화합니다")
+    .action(async (amountStr, opts) => {
+    const user = new credentials_provider_1.CredentialsProvider(opts.profile).getUser();
+    const amount = parseInt(amountStr, 10);
+    const deposit = new deposit_1.Deposit(amount);
+    const endpoint = new lottery_stdout_printer_1.LotteryStdoutPrinter();
+    const client = new lottery_client_1.LotteryClient(user, endpoint);
+    await client.assignVirtualAccount(deposit);
+});
+program
+    .command("show-balance")
+    .description("예치금 현황을 조회합니다.")
+    .option("-p, --profile <name>", "프로필을 지정합니다", "default")
+    .option("-d, --debug", "debug 로그를 활성화합니다")
+    .action(async (opts) => {
+    const user = new credentials_provider_1.CredentialsProvider(opts.profile).getUser();
+    const endpoint = new lottery_stdout_printer_1.LotteryStdoutPrinter();
+    const client = new lottery_client_1.LotteryClient(user, endpoint);
+    await client.showBalance();
+});
+program
+    .command("show-buy-list")
+    .description("구매 내역을 조회합니다. 기본적으로 최근 14일간의 내역을 조회하며, --start-date 및 --end-date 옵션을 통해 조회 기간을 지정할 수 있습니다.")
+    .option("-p, --profile <name>", "프로필을 지정합니다", "default")
+    .option("-f, --format <format>", "출력 형식 (table, json)", "table")
+    .option("-s, --start-date <YYYYMMDD>", "조회 시작 날짜")
+    .option("-e, --end-date <YYYYMMDD>", "조회 종료 날짜")
+    .option("-d, --debug", "debug 로그를 활성화합니다")
+    .action(async (opts) => {
+    const user = new credentials_provider_1.CredentialsProvider(opts.profile).getUser();
+    const endpoint = new lottery_stdout_printer_1.LotteryStdoutPrinter();
+    const client = new lottery_client_1.LotteryClient(user, endpoint);
+    await client.showBuyList(opts.format, opts.startDate, opts.endDate);
+});
+program
+    .command("show-profiles")
+    .description("등록된 프로필 목록을 출력합니다.")
+    .action(() => {
+    try {
+        const profiles = credentials_provider_1.CredentialsProvider.listProfiles();
+        const table = new cli_table3_1.default({ head: ["profiles"], style: { head: [] } });
+        profiles.forEach((name) => table.push([name]));
+        console.log(table.toString());
+    }
+    catch (e) {
+        console.error("❌", e.message);
+        process.exit(1);
+    }
+});
+program
+    .command("buy-lotto645")
+    .description(`로또6/45 복권을 구매합니다. 매주 최대 다섯 장까지 구매할 수 있습니다.
+
+예시:
+  dhapi buy-lotto645              자동모드 5장 (default)
+  dhapi buy-lotto645 ''           자동모드 1장
+  dhapi buy-lotto645 '1,2,3,4,5,6'   수동모드 1장
+  dhapi buy-lotto645 '1,2,3'     반자동모드 1장
+  dhapi buy-lotto645 '1,2,3,4,5,6' '7,8,9'  수동 1장 + 반자동 1장
+  dhapi buy-lotto645 -y           확인 스킵하고 자동 5장 구매`)
+    .argument("[tickets...]", "구매할 번호 (생략 시 자동 5장)")
+    .option("-y, --yes", "구매 전 확인 절차를 스킵합니다.")
+    .option("-p, --profile <name>", "프로필을 지정합니다", "default")
+    .option("-d, --debug", "debug 로그를 활성화합니다")
+    .action(async (ticketArgs, opts) => {
+    const user = new credentials_provider_1.CredentialsProvider(opts.profile).getUser();
+    const tickets = ticketArgs && ticketArgs.length > 0
+        ? lotto645_ticket_1.Lotto645Ticket.createTickets(ticketArgs)
+        : lotto645_ticket_1.Lotto645Ticket.createAutoTickets(5);
+    const endpoint = new lottery_stdout_printer_1.LotteryStdoutPrinter();
+    const client = new lottery_client_1.LotteryClient(user, endpoint);
+    const confirmer = new lotto645_buy_confirmer_1.Lotto645BuyConfirmer();
+    const ok = confirmer.confirm(tickets, !!opts.yes);
+    if (!ok)
+        process.exit(0);
+    await client.buyLotto645(tickets);
+});
+program.parse();

package/dist/domain/deposit.d.ts

@@ -0,0 +1,4 @@
+export declare class Deposit {
+    readonly amount: number;
+    constructor(amount: number | string);
+}

package/dist/domain/deposit.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deposit = void 0;
+const ALLOWED_AMOUNTS = [
+    5000, 10000, 20000, 30000, 50000, 100000, 200000, 300000, 500000, 700000,
+    1000000,
+];
+class Deposit {
+    constructor(amount) {
+        const n = typeof amount === "string" ? parseInt(amount, 10) : amount;
+        if (Number.isNaN(n)) {
+            throw new Error(`숫자를 입력하세요 (입력된 값: ${amount}).`);
+        }
+        if (!ALLOWED_AMOUNTS.includes(n)) {
+            throw new Error("입금 가능한 금액은 5천원, 1만원, 2만원, 3만원, 5만원, 10만원, 20만원, 30만원, 50만원, 70만원, 100만원입니다 (입력된 값: " +
+                amount +
+                ").");
+        }
+        this.amount = n;
+    }
+}
+exports.Deposit = Deposit;

package/dist/domain/lotto645-ticket.d.ts

@@ -0,0 +1,13 @@
+export declare enum Lotto645Mode {
+    AUTO = "auto",
+    SEMIAUTO = "semiauto",
+    MANUAL = "manual"
+}
+export declare class Lotto645Ticket {
+    readonly numbers: number[];
+    readonly mode: Lotto645Mode;
+    constructor(numbersStr?: string);
+    get modeKor(): string;
+    static createAutoTickets(count: number): Lotto645Ticket[];
+    static createTickets(numbersList: string[]): Lotto645Ticket[];
+}

package/dist/domain/lotto645-ticket.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Lotto645Ticket = exports.Lotto645Mode = void 0;
+var Lotto645Mode;
+(function (Lotto645Mode) {
+    Lotto645Mode["AUTO"] = "auto";
+    Lotto645Mode["SEMIAUTO"] = "semiauto";
+    Lotto645Mode["MANUAL"] = "manual";
+})(Lotto645Mode || (exports.Lotto645Mode = Lotto645Mode = {}));
+class Lotto645Ticket {
+    constructor(numbersStr) {
+        if (!numbersStr || numbersStr.trim() === "") {
+            this.numbers = [];
+            this.mode = Lotto645Mode.AUTO;
+            return;
+        }
+        const parts = numbersStr.split(",").map((s) => s.trim());
+        const numbers = parts
+            .map((s) => {
+            const n = parseInt(s, 10);
+            if (Number.isNaN(n))
+                throw new Error(`숫자를 입력하세요 (입력된 값: ${numbersStr}).`);
+            return n;
+        })
+            .sort((a, b) => a - b);
+        const unique = [...new Set(numbers)];
+        if (numbers.length !== unique.length) {
+            throw new Error(`중복되지 않도록 숫자들을 입력하세요 (입력된 값: ${numbersStr}).`);
+        }
+        for (const n of numbers) {
+            if (n < 1 || n > 45) {
+                throw new Error(`각 번호는 1부터 45까지의 숫자만 사용할 수 있습니다 (입력된 값: ${n}).`);
+            }
+        }
+        this.numbers = numbers;
+        if (numbers.length === 6) {
+            this.mode = Lotto645Mode.MANUAL;
+        }
+        else if (numbers.length >= 1 && numbers.length <= 5) {
+            this.mode = Lotto645Mode.SEMIAUTO;
+        }
+        else if (numbers.length === 0) {
+            this.mode = Lotto645Mode.AUTO;
+        }
+        else {
+            throw new Error(`숫자는 0개 이상 6개 이하의 숫자를 입력해야 합니다 (입력된 값: ${numbersStr}).`);
+        }
+    }
+    get modeKor() {
+        switch (this.mode) {
+            case Lotto645Mode.AUTO:
+                return "자동";
+            case Lotto645Mode.SEMIAUTO:
+                return "반자동";
+            case Lotto645Mode.MANUAL:
+                return "수동";
+            default:
+                throw new Error("지원하지 않는 게임 타입입니다.");
+        }
+    }
+    static createAutoTickets(count) {
+        return Array.from({ length: count }, () => new Lotto645Ticket());
+    }
+    static createTickets(numbersList) {
+        return numbersList.map((n) => new Lotto645Ticket(n));
+    }
+}
+exports.Lotto645Ticket = Lotto645Ticket;

package/dist/domain/user.d.ts

@@ -0,0 +1,5 @@
+export declare class User {
+    readonly username: string;
+    readonly password: string;
+    constructor(username: string, password: string);
+}

package/dist/domain/user.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.User = void 0;
+class User {
+    constructor(username, password) {
+        this.username = username;
+        this.password = password;
+    }
+}
+exports.User = User;

package/dist/endpoint/lottery-api-endpoint.d.ts

@@ -0,0 +1,55 @@
+import type { LotteryEndpoint } from "../port/lottery-endpoint";
+/**
+ * Endpoint adapter that captures results for API responses (no stdout).
+ */
+export interface ApiResult {
+    buyLotto645?: {
+        slots: Array<{
+            slot: string;
+            mode: string;
+            numbers: string[];
+        }>;
+    };
+    showBalance?: {
+        totalDeposit: number;
+        purchaseAvailable: number;
+        reservedAmount: number;
+        withdrawalPending: number;
+        purchaseUnavailable: number;
+        lastMonthTotalPurchase: number;
+    };
+    showBuyList?: {
+        startDate: string;
+        endDate: string;
+        format: string;
+        data: Array<{
+            headers: string[];
+            rows: string[][];
+        }>;
+    };
+    assignVirtualAccount?: {
+        accountNumber: string;
+        amount: string;
+    };
+}
+export declare class LotteryApiEndpoint implements LotteryEndpoint {
+    readonly result: ApiResult;
+    printResultOfBuyLotto645(slots: Array<{
+        slot: string;
+        mode: string;
+        numbers: string[];
+    }>): void;
+    printResultOfShowBalance(data: {
+        totalDeposit: number;
+        purchaseAvailable: number;
+        reservedAmount: number;
+        withdrawalPending: number;
+        purchaseUnavailable: number;
+        lastMonthTotalPurchase: number;
+    }): void;
+    printResultOfShowBuyList(data: Array<{
+        headers: string[];
+        rows: string[][];
+    }>, outputFormat: string, startDate: string, endDate: string): void;
+    printResultOfAssignVirtualAccount(accountNumber: string, amount: string): void;
+}

package/dist/endpoint/lottery-api-endpoint.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LotteryApiEndpoint = void 0;
+class LotteryApiEndpoint {
+    constructor() {
+        this.result = {};
+    }
+    printResultOfBuyLotto645(slots) {
+        this.result.buyLotto645 = { slots };
+    }
+    printResultOfShowBalance(data) {
+        this.result.showBalance = { ...data };
+    }
+    printResultOfShowBuyList(data, outputFormat, startDate, endDate) {
+        this.result.showBuyList = {
+            startDate,
+            endDate,
+            format: outputFormat,
+            data,
+        };
+    }
+    printResultOfAssignVirtualAccount(accountNumber, amount) {
+        this.result.assignVirtualAccount = { accountNumber, amount };
+    }
+}
+exports.LotteryApiEndpoint = LotteryApiEndpoint;

package/dist/endpoint/lottery-stdout-printer.d.ts

@@ -0,0 +1,21 @@
+import type { LotteryEndpoint } from "../port/lottery-endpoint";
+export declare class LotteryStdoutPrinter implements LotteryEndpoint {
+    printResultOfAssignVirtualAccount(accountNumber: string, amountStr: string): void;
+    printResultOfShowBalance(data: {
+        totalDeposit: number;
+        purchaseAvailable: number;
+        reservedAmount: number;
+        withdrawalPending: number;
+        purchaseUnavailable: number;
+        lastMonthTotalPurchase: number;
+    }): void;
+    printResultOfBuyLotto645(slots: Array<{
+        slot: string;
+        mode: string;
+        numbers: string[];
+    }>): void;
+    printResultOfShowBuyList(data: Array<{
+        headers: string[];
+        rows: string[][];
+    }>, outputFormat: string, startDate: string, endDate: string): void;
+}