@bolta-io/cli 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @bolta-io/cli
 
+## 0.2.0
+
+### Minor Changes
+
+- 1570031: 발급자 관리와 인증서 API를 issuer 계약으로 전환하고 발행 기본 인증에서 별도 발급자 키를 제거합니다. 기존 supplier/customer 명령과 키 설정은 2026-12-31까지 숨김 호환으로 유지하며, 레거시 키로 403이 발생하면 설정 출처에 맞는 해제 방법을 안내합니다. `bolta guide issuer`는 CLI가 실제 지원하는 발행 흐름만 안내합니다.
+
 ## 0.1.1
 
 ### Patch Changes

package/CLAUDE.md

@@ -7,24 +7,20 @@
 ```bash
 # 인증 설정 (환경변수)
 export BOLTA_API_KEY="test_your_key"
-export BOLTA_SUPPLIER_KEY="SupplierKey_abc123"
 
 # 또는 config 명령어로 설정
 bolta config set api-key test_your_key
-bolta config set supplier-key SupplierKey_abc123
 ```
 
-## 핵심 개념: Supplier Key (중요!)
+## 핵심 개념: 발급자
 
-supplierKey는 세금계산서나 현금영수증을 발행하는 **공급자 본인**을 식별하는 키입니다.
+발급자는 세금계산서나 현금영수증 발행에 사용하는 인증서의 소유자입니다.
 
-- 획득: 공급자의 사업자 정보로 `bolta supplier create` 호출 → 응답의 supplierKey
-- 설정: `bolta config set supplier-key <값>` 또는 `BOLTA_SUPPLIER_KEY` 환경변수
-- API 키 단위로 독립 관리 (test_/live_ 키별로 별도 생성 필요, 상호 호환 안 됨)
+- 등록: `bolta issuer create` 호출 → 응답의 `issuerId`
+- 관리: `issuerId`는 발급자 조회와 인증서 등록·조회·해제에만 사용
+- 발행: API 키로 인증하고 요청 본문의 사업자등록번호로 발급자를 선택
 
-**주의: Supplier-Key에 받는 쪽의 키를 넣지 마세요.** 받는 쪽 정보는 세금계산서 JSON의 `supplied` 또는 현금영수증 JSON의 `recipient` 필드에 포함합니다.
-
-> 구 명칭 `customer`(명령어·`--customer-key`·`BOLTA_CUSTOMER_KEY`·`config set customer-key`)는 deprecated이며 당분간 동작합니다(경고 출력).
+일반 정발행과 역발행은 `supplier.identificationNumber`, 현금영수증은 `issuer.businessRegistrationNumber`를 사용합니다.
 
 ## 요금 안내
 
@@ -38,14 +34,14 @@ Bolta API는 **사전 충전 포인트 차감 방식** 유료 서비스입니다
 
 ### 세금계산서 발행 (가장 일반적인 업무)
 
-1. **공급자 등록** (최초 1회):
+1. **발급자 등록** (최초 1회):
 ```bash
-bolta supplier create --data '{"identificationNumber":"1234567890","organizationName":"주식회사 테스트","representativeName":"홍길동"}'
+bolta issuer create --data '{"identificationNumber":"1234567890","organizationName":"주식회사 테스트","representativeName":"홍길동"}'
 ```
 
 2. **인증서 확인** (정발행 시 공급자 인증서 필요):
 ```bash
-bolta certificate status SupplierKey_abc123
+bolta certificate status <issuerId>
 ```
 
 3. **세금계산서 정발행**:
@@ -58,7 +54,7 @@ bolta invoice issue --data '{
     "identificationNumber": "1234567890",
     "organizationName": "공급자",
     "representativeName": "김공급",
-    "manager": {"email": "supplier@example.com"}
+    "manager": {"email": "seller@example.com"}
   },
   "supplied": {
     "identificationNumber": "0987654321",
@@ -106,11 +102,11 @@ bolta cash-receipt status --reference-id cash-2026-001
 
 | 커맨드 | 설명 | 데이터 필요 |
 |--------|------|------------|
-| `bolta supplier create` | 공급자 생성 | --data |
-| `bolta supplier get <key>` | 공급자 조회 | - |
-| `bolta certificate url <key>` | 인증서 등록 URL | - |
-| `bolta certificate status <key>` | 인증서 상태 | - |
-| `bolta certificate deregister <key>` | 인증서 해제 | - |
+| `bolta issuer create` | 발급자 등록 | --data |
+| `bolta issuer get <issuerId>` | 발급자 조회 | - |
+| `bolta certificate url <issuerId>` | 인증서 등록 URL | - |
+| `bolta certificate status <issuerId>` | 인증서 상태 | - |
+| `bolta certificate deregister <issuerId>` | 인증서 해제 | - |
 | `bolta invoice issue` | 세금계산서 정발행 | --data |
 | `bolta invoice issue-request` | 역발행 요청 | --data |
 | `bolta invoice get <issuanceKey>` | 세금계산서 조회 | - |
@@ -128,8 +124,6 @@ bolta cash-receipt status --reference-id cash-2026-001
 | `bolta schema [command]` | 입력 스키마 | - |
 | `bolta guide [topic]` | 주요 개념 안내 | - |
 
-> 인증서 명령의 `<key>`에는 신규 supplierKey를 쓰세요. deprecated `CustomerKey_` 키도 당분간 동작합니다.
-
 ## 입력 방법
 
 데이터가 필요한 커맨드에서 3가지 방식 지원:
@@ -154,7 +148,7 @@ bolta cash-receipt status --reference-id cash-2026-001
 | `INPUT_ERROR` | 명령어·옵션·입력 방식 오류 | `bolta --help` 또는 하위 명령의 `--help`로 사용법 확인 |
 | `HTTP_402` | 포인트 잔액 부족 | https://developers.bolta.io 에서 포인트 충전 |
 | `HTTP_400` | 잘못된 요청 | error.message 확인, 필수 필드 누락 체크 |
-| `HTTP_404` | 리소스 없음 | issuanceKey/supplierKey 확인 |
+| `HTTP_404` | 리소스 없음 | issuanceKey/issuerId 확인 |
 | `HTTP_429` | 요청 제한 초과 | 자동 재시도 (최대 3회) |
 | `NETWORK_ERROR` | 네트워크 오류 | 인터넷 연결 확인 |
 

package/README.md

@@ -35,11 +35,9 @@ Bolta API를 사용하려면 API 키가 필요합니다. 환경변수 또는 CLI
 ```bash
 # 방법 1: 환경변수 (권장)
 export BOLTA_API_KEY="test_your_key"
-export BOLTA_SUPPLIER_KEY="SupplierKey_abc123"
 
 # 방법 2: CLI 명령 (영구 저장 - ~/.bolta/config.json)
 bolta config set api-key test_your_key
-bolta config set supplier-key SupplierKey_abc123
 
 # 연결 테스트
 bolta config test
@@ -49,36 +47,34 @@ bolta config test
 
 ### 커맨드 전체 목록
 
-#### 공급자 관리
+#### 발급자 관리
 
 ```bash
-# 공급자 생성
-bolta supplier create --data '{
+# 발급자 등록
+bolta issuer create --data '{
   "identificationNumber": "1234567890",
   "organizationName": "주식회사 테스트",
   "representativeName": "홍길동"
 }'
 
-# 공급자 조회
-bolta supplier get <supplierKey>
+# 발급자 조회
+bolta issuer get <issuerId>
 ```
 
-> 구 `customer` 명령(`bolta customer ...`)은 deprecated이며 당분간 동작합니다(경고 출력).
-
 #### 인증서 관리
 
 ```bash
 # 인증서 등록 URL 조회
-bolta certificate url <supplierKey>
+bolta certificate url <issuerId>
 
 # 인증서 등록 상태 조회
-bolta certificate status <supplierKey>
+bolta certificate status <issuerId>
 
 # 인증서 해제
-bolta certificate deregister <supplierKey>
+bolta certificate deregister <issuerId>
 ```
 
-> deprecated `CustomerKey_` 키도 인증서 명령에서 당분간 사용할 수 있습니다.
+`issuerId`는 발급자와 인증서 관리에만 사용합니다. 발행 요청은 본문의 사업자등록번호로 발급자를 찾습니다.
 
 #### 세금계산서 발행/조회
 
@@ -92,7 +88,7 @@ bolta invoice issue --data '{
     "identificationNumber": "1234567890",
     "organizationName": "공급자 주식회사",
     "representativeName": "김공급",
-    "manager": { "email": "supplier@example.com" }
+    "manager": { "email": "seller@example.com" }
   },
   "supplied": {
     "identificationNumber": "0987654321",
@@ -185,7 +181,7 @@ bolta cash-receipt status --reference-id cash-2026-001-cancel
 #### 설정
 
 ```bash
-bolta config set <key> <value>   # api-key, supplier-key, base-url
+bolta config set <key> <value>   # api-key, base-url, update-check
 bolta config show                # 현재 설정 확인
 bolta config test                # API 연결 테스트
 ```
@@ -193,7 +189,7 @@ bolta config test                # API 연결 테스트
 #### 도움말
 
 ```bash
-# 주요 개념 안내 (supplier-key, payment, workflow, cash-receipt, glossary)
+# 주요 개념 안내 (issuer, payment, workflow, cash-receipt, glossary)
 bolta guide [topic]
 
 # 바로 쓸 수 있는 샘플 JSON
@@ -237,8 +233,6 @@ cat invoice.json | bolta invoice issue --stdin
 | 옵션 | 설명 |
 |------|------|
 | `--api-key <key>` | API 키 오버라이드 |
-| `--supplier-key <key>` | Supplier Key 오버라이드 |
-| `--customer-key <key>` | (deprecated) `--supplier-key`를 사용하세요 |
 | `--verbose` | 상세 로그 출력 (stderr) |
 | `--dry-run` | API 호출 없이 요청 데이터만 출력 |
 
@@ -263,7 +257,7 @@ cat invoice.json | bolta invoice issue --stdin
 | `INPUT_ERROR` | 명령어·옵션·입력 방식 오류 | `bolta --help` 또는 하위 명령의 `--help`로 사용법 확인 |
 | `HTTP_402` | 포인트 잔액 부족 | https://developers.bolta.io 에서 포인트 충전 |
 | `HTTP_400` | 잘못된 요청 | error.message 확인 |
-| `HTTP_404` | 리소스 없음 | issuanceKey/supplierKey 확인 |
+| `HTTP_404` | 리소스 없음 | issuanceKey/issuerId 확인 |
 | `HTTP_429` | 요청 제한 초과 | 자동 재시도 (최대 3회) |
 | `NETWORK_ERROR` | 네트워크 오류 | 인터넷 연결 확인 |
 

package/dist/bin/bolta.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
-import { Command, CommanderError } from 'commander';
-import { registerSupplierCommands } from '../src/commands/supplier/index.js';
+import { Command, CommanderError, Option } from 'commander';
+import { registerIssuerCommands } from '../src/commands/issuer/index.js';
+import { registerLegacyIssuerCommands } from '../src/commands/supplier/legacy.js';
 import { registerCertificateCommands } from '../src/commands/certificate/index.js';
 import { registerInvoiceCommands } from '../src/commands/invoice/index.js';
 import { registerConfigCommands } from '../src/commands/config/index.js';
@@ -10,7 +11,7 @@ import { registerUpdateCommands } from '../src/commands/update/index.js';
 import { maybeNudgeUpdate, refreshUpdateCache, UPDATE_CACHE_COMMAND, } from '../src/commands/update/nudge.js';
 import { registerGuideCommand } from '../src/commands/guide/index.js';
 import { registerCashReceiptCommands } from '../src/commands/cash-receipt/index.js';
-import { outputError, deprecationWarning } from '../src/utils/output.js';
+import { legacyIssuerWarning, outputError } from '../src/utils/output.js';
 import { BoltaInputError } from '../src/utils/errors.js';
 import { getCurrentVersion } from '../src/utils/version.js';
 import { loadConfig, saveConfig } from '../src/config/config-manager.js';
@@ -25,24 +26,30 @@ program
     .description('Bolta API CLI - 전자세금계산서·현금영수증 발행/조회/관리 도구 (AI 에이전트 최적화)')
     .version(getCurrentVersion())
     .option('--api-key <key>', 'Bolta API 키 (환경변수 BOLTA_API_KEY 대체)')
-    .option('--supplier-key <key>', 'Supplier Key (환경변수 BOLTA_SUPPLIER_KEY 대체)')
-    .option('--customer-key <key>', '(deprecated) --supplier-key를 사용하세요')
+    .addOption(new Option('--supplier-key <key>').hideHelp())
+    .addOption(new Option('--customer-key <key>').hideHelp())
     .option('--verbose', '상세 로그 출력 (stderr)', false)
     .option('--dry-run', 'API 호출 없이 요청 데이터만 출력', false)
     .hook('preAction', (thisCommand, actionCommand) => {
     const opts = thisCommand.optsWithGlobals();
+    if (opts.supplierKey) {
+        legacyIssuerWarning("'--supplier-key' 플래그");
+    }
+    else if (opts.customerKey) {
+        legacyIssuerWarning("'--customer-key' 플래그");
+    }
     if (opts.verbose) {
         process.env.BOLTA_VERBOSE = '1';
     }
     // 백그라운드 캐시 갱신 자식 프로세스: 힌트/넛지 없이 본연의 작업만 (재귀 spawn 방지)
     if (actionCommand.name() === UPDATE_CACHE_COMMAND)
         return;
-    warnDeprecatedUsage();
     const config = loadConfig();
     checkFirstRun(actionCommand, config);
     checkForUpdate(actionCommand, config);
 });
-registerSupplierCommands(program);
+registerIssuerCommands(program);
+registerLegacyIssuerCommands(program);
 registerCertificateCommands(program);
 registerInvoiceCommands(program);
 registerCashReceiptCommands(program);
@@ -51,28 +58,6 @@ registerExamplesCommand(program);
 registerSchemaCommand(program);
 registerUpdateCommands(program);
 registerGuideCommand(program);
-// 값을 받는 전역 옵션(공백 구분 형태일 때 다음 토큰을 값으로 소비)
-const GLOBAL_VALUE_OPTIONS = new Set(['--api-key', '--supplier-key', '--customer-key']);
-function warnDeprecatedUsage() {
-    // 구 명령어 'customer'를 alias로 사용한 경우 경고.
-    // 첫 번째 위치 인자(=명령어)만 검사해 데이터 값에 'customer'가 들어가도 오탐하지 않는다.
-    // (--customer-key 플래그/BOLTA_CUSTOMER_KEY/config customer-key는 resolveSupplierKey에서 경고)
-    const argv = process.argv.slice(2);
-    for (let i = 0; i < argv.length; i++) {
-        const token = argv[i];
-        if (GLOBAL_VALUE_OPTIONS.has(token)) {
-            i++; // 옵션 값 건너뛰기
-            continue;
-        }
-        if (token.startsWith('-'))
-            continue; // boolean 플래그(--verbose 등)
-        // 첫 위치 인자 = 명령어
-        if (token === 'customer') {
-            deprecationWarning("'customer' 명령어는 'supplier'로 변경되었습니다. 'bolta supplier ...'를 사용하세요.");
-        }
-        break;
-    }
-}
 function checkFirstRun(actionCommand, config) {
     const commandName = actionCommand.name();
     const parentName = actionCommand.parent?.name();

package/dist/bin/bolta.js.map

@@ -1 +1 @@
-{"version":3,"file":"bolta.js","sourceRoot":"","sources":["../../bin/bolta.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,eAAe,CAAC;IACf,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;CACtB,CAAC;KACD,YAAY,EAAE,CAAC;AAElB,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,iBAAiB,EAAE,CAAC;KAC5B,MAAM,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;KAChE,MAAM,CAAC,sBAAsB,EAAE,2CAA2C,CAAC;KAC3E,MAAM,CAAC,sBAAsB,EAAE,oCAAoC,CAAC;KACpE,MAAM,CAAC,WAAW,EAAE,mBAAmB,EAAE,KAAK,CAAC;KAC/C,MAAM,CAAC,WAAW,EAAE,sBAAsB,EAAE,KAAK,CAAC;KAClD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC;IAClC,CAAC;IACD,sDAAsD;IACtD,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,oBAAoB;QAAE,OAAO;IAC1D,mBAAmB,EAAE,CAAC;IACtB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEL,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,2BAA2B,CAAC,OAAO,CAAC,CAAC;AACrC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,2BAA2B,CAAC,OAAO,CAAC,CAAC;AACrC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAE9B,yCAAyC;AACzC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAExF,SAAS,mBAAmB;IAC1B,sCAAsC;IACtC,0DAA0D;IAC1D,uFAAuF;IACvF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,CAAC,EAAE,CAAC,CAAC,YAAY;YACjB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,2BAA2B;QAChE,gBAAgB;QAChB,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACzB,kBAAkB,CAAC,mEAAmE,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM;IACR,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,aAAsB,EAAE,MAAmB;IAChE,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAEhD,sCAAsC;IACtC,IAAI,WAAW,KAAK,OAAO;QAAE,OAAO;IACpC,IAAI,UAAU,KAAK,QAAQ,IAAI,WAAW,KAAK,QAAQ;QAAE,OAAO;IAChE,IAAI,WAAW,KAAK,QAAQ,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO;IAEhE,IAAI,MAAM,CAAC,UAAU;QAAE,OAAO;IAE9B,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAExE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,aAAsB,EAAE,MAAmB;IACjE,6BAA6B;IAC7B,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,QAAQ;QAAE,OAAO;IAE3F,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,2CAA2C;AAC3C,OAAO;KACJ,OAAO,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAC/C,WAAW,CAAC,iBAAiB,CAAC;KAC9B,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,kBAAkB,EAAE,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO;QAE/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACtD,WAAW,CACT,IAAI,eAAe,CACjB,OAAO,EACP,iFAAiF,CAClF,CACF,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bolta.js","sourceRoot":"","sources":["../../bin/bolta.ts"],"names":[],"mappings":"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"}

package/dist/src/client/bolta-client.d.ts

@@ -1,53 +1,51 @@
-import type { CreateTaxInvoiceRequest, IssuanceResponse, TaxInvoiceDetail, StatusResponse, AmendTerminationRequest, AmendChangeSupplyCostRequest, CreateSupplierRequest, SupplierResponse, CreateCustomerRequest, LegacyCustomerResponse, CertificateUrlResponse, CreateCashReceiptRequest, CashReceiptCancellationResponse, CashReceiptStatusResponse } from '../types/api.js';
+import type { CreateTaxInvoiceRequest, IssuanceResponse, TaxInvoiceDetail, StatusResponse, AmendTerminationRequest, AmendChangeSupplyCostRequest, CreateIssuerRequest, IssuerResponse, CreateSupplierRequest, LegacySupplierResponse, CreateCustomerRequest, LegacyCustomerResponse, CertificateUrlResponse, CertificateStatusResponse, CreateCashReceiptRequest, CashReceiptCancellationResponse, CashReceiptStatusResponse } from '../types/api.js';
+import { type LegacyIssuerHeader } from '../utils/legacy-issuer.js';
 interface ClientConfig {
     apiKey: string;
     baseUrl: string;
-    supplierKey?: string;
-    /** supplierKey를 어느 소스에서 가져왔는지(env/config 등). 진단 로그·에러에 노출된다. */
-    supplierKeySource?: string;
+    /** 구 설정이 남아 있을 때만 지정한다. 지정하면 Supplier-Key 헤더를 싣는다. */
+    legacyIssuer?: LegacyIssuerHeader;
     timeout?: number;
     maxRetries?: number;
 }
 export declare class BoltaClient {
     private readonly baseUrl;
     private readonly encodedApiKey;
-    private readonly supplierKey?;
-    private readonly supplierKeySource;
+    private readonly legacyIssuer?;
     private readonly timeout;
     private readonly maxRetries;
     constructor(config: ClientConfig);
-    createSupplier(data: CreateSupplierRequest): Promise<SupplierResponse>;
-    getSupplier(supplierKey: string): Promise<SupplierResponse>;
-    /** @deprecated 신규 코드에서는 createSupplier를 사용하세요. */
+    createIssuer(data: CreateIssuerRequest): Promise<IssuerResponse>;
+    getIssuer(issuerId: string): Promise<IssuerResponse>;
+    /** @deprecated 2026-12-31까지 숨김 `supplier` CLI 호환용입니다. */
+    createSupplier(data: CreateSupplierRequest): Promise<LegacySupplierResponse>;
+    /** @deprecated 2026-12-31까지 숨김 `supplier` CLI 호환용입니다. */
+    getSupplier(supplierKey: string): Promise<LegacySupplierResponse>;
+    /** @deprecated 2026-12-31까지 숨김 `customer` CLI 호환용입니다. */
     createCustomer(data: CreateCustomerRequest): Promise<LegacyCustomerResponse>;
-    /** @deprecated 신규 코드에서는 getSupplier를 사용하세요. */
+    /** @deprecated 2026-12-31까지 숨김 `customer` CLI 호환용입니다. */
     getCustomer(customerKey: string): Promise<LegacyCustomerResponse>;
-    getCertificateUrl(supplierKey: string): Promise<CertificateUrlResponse>;
-    getCertificateStatus(supplierKey: string): Promise<unknown>;
-    deregisterCertificate(supplierKey: string): Promise<unknown>;
+    getCertificateUrl(issuerId: string): Promise<CertificateUrlResponse>;
+    getCertificateStatus(issuerId: string): Promise<CertificateStatusResponse>;
+    deregisterCertificate(issuerId: string): Promise<unknown>;
     issueTaxInvoice(data: CreateTaxInvoiceRequest, options?: {
-        supplierKey?: string;
         referenceId?: string;
     }): Promise<IssuanceResponse>;
     issueRequestTaxInvoice(data: CreateTaxInvoiceRequest, options?: {
-        supplierKey?: string;
         referenceId?: string;
     }): Promise<IssuanceResponse>;
     getTaxInvoice(issuanceKey: string): Promise<TaxInvoiceDetail>;
     getTaxInvoiceStatus(clientReferenceId: string): Promise<StatusResponse>;
-    amendTermination(issuanceKey: string, data: AmendTerminationRequest, supplierKey?: string): Promise<IssuanceResponse>;
-    amendChangeSupplyCost(issuanceKey: string, data: AmendChangeSupplyCostRequest, supplierKey?: string): Promise<IssuanceResponse>;
-    amendDoubleIssuance(issuanceKey: string, supplierKey?: string): Promise<IssuanceResponse>;
+    amendTermination(issuanceKey: string, data: AmendTerminationRequest): Promise<IssuanceResponse>;
+    amendChangeSupplyCost(issuanceKey: string, data: AmendChangeSupplyCostRequest): Promise<IssuanceResponse>;
+    amendDoubleIssuance(issuanceKey: string): Promise<IssuanceResponse>;
     issueCashReceipt(data: CreateCashReceiptRequest, options: {
-        supplierKey: string;
         referenceId: string;
     }): Promise<IssuanceResponse>;
     getCashReceiptStatus(clientReferenceId: string): Promise<CashReceiptStatusResponse>;
     cancelCashReceipt(issuanceKey: string, options: {
-        supplierKey: string;
         referenceId: string;
     }): Promise<CashReceiptCancellationResponse>;
-    private certificatePath;
     private request;
 }
 export {};

package/dist/src/client/bolta-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bolta-client.d.ts","sourceRoot":"","sources":["../../../src/client/bolta-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bolta-client.d.ts","sourceRoot":"","sources":["../../../src/client/bolta-client.ts"],"names":[],"mappings":"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"}

package/dist/src/client/bolta-client.js

@@ -1,12 +1,11 @@
 import { BoltaApiError, BoltaAuthError, BoltaNetworkError } from '../utils/errors.js';
-import { deprecationWarning, verbose, maskSecret } from '../utils/output.js';
+import { verbose, maskSecret } from '../utils/output.js';
 import { getCurrentVersion } from '../utils/version.js';
-const DEPRECATED_CUSTOMER_KEY_PREFIX = 'CustomerKey_';
+import { describeLegacyIssuerKeySource, } from '../utils/legacy-issuer.js';
 export class BoltaClient {
     baseUrl;
     encodedApiKey;
-    supplierKey;
-    supplierKeySource;
+    legacyIssuer;
     timeout;
     maxRetries;
     constructor(config) {
@@ -15,28 +14,38 @@ export class BoltaClient {
         }
         this.baseUrl = config.baseUrl.replace(/\/+$/, '');
         this.encodedApiKey = Buffer.from(`${config.apiKey}:`).toString('base64');
-        this.supplierKey = config.supplierKey;
-        this.supplierKeySource = config.supplierKeySource ?? 'unknown';
+        this.legacyIssuer = config.legacyIssuer;
         this.timeout = config.timeout ?? 30_000;
         this.maxRetries = config.maxRetries ?? 3;
     }
     // ========================
-    // Supplier Methods
+    // Issuer Methods
     // ========================
+    async createIssuer(data) {
+        return this.request({ method: 'POST', path: '/issuers', body: data });
+    }
+    async getIssuer(issuerId) {
+        return this.request({ method: 'GET', path: `/issuers/${encodeURIComponent(issuerId)}` });
+    }
+    // ========================
+    // Legacy Issuer Methods
+    // ========================
+    /** @deprecated 2026-12-31까지 숨김 `supplier` CLI 호환용입니다. */
     async createSupplier(data) {
         return this.request({ method: 'POST', path: '/suppliers', body: data });
     }
+    /** @deprecated 2026-12-31까지 숨김 `supplier` CLI 호환용입니다. */
     async getSupplier(supplierKey) {
-        return this.request({ method: 'GET', path: `/suppliers/${encodeURIComponent(supplierKey)}` });
+        return this.request({
+            method: 'GET',
+            path: `/suppliers/${encodeURIComponent(supplierKey)}`,
+        });
     }
-    // ========================
-    // Legacy Customer Methods
-    // ========================
-    /** @deprecated 신규 코드에서는 createSupplier를 사용하세요. */
+    /** @deprecated 2026-12-31까지 숨김 `customer` CLI 호환용입니다. */
     async createCustomer(data) {
         return this.request({ method: 'POST', path: '/customers', body: data });
     }
-    /** @deprecated 신규 코드에서는 getSupplier를 사용하세요. */
+    /** @deprecated 2026-12-31까지 숨김 `customer` CLI 호환용입니다. */
     async getCustomer(customerKey) {
         return this.request({
             method: 'GET',
@@ -46,22 +55,22 @@ export class BoltaClient {
     // ========================
     // Certificate Methods
     // ========================
-    async getCertificateUrl(supplierKey) {
+    async getCertificateUrl(issuerId) {
         return this.request({
             method: 'GET',
-            path: this.certificatePath(supplierKey, '/url'),
+            path: `/issuers/${encodeURIComponent(issuerId)}/certificates/url`,
         });
     }
-    async getCertificateStatus(supplierKey) {
+    async getCertificateStatus(issuerId) {
         return this.request({
             method: 'GET',
-            path: this.certificatePath(supplierKey),
+            path: `/issuers/${encodeURIComponent(issuerId)}/certificates/latestHistory`,
         });
     }
-    async deregisterCertificate(supplierKey) {
+    async deregisterCertificate(issuerId) {
         return this.request({
             method: 'DELETE',
-            path: this.certificatePath(supplierKey),
+            path: `/issuers/${encodeURIComponent(issuerId)}/certificates`,
         });
     }
     // ========================
@@ -72,7 +81,6 @@ export class BoltaClient {
             method: 'POST',
             path: '/taxInvoices/issue',
             body: data,
-            supplierKey: options?.supplierKey,
             referenceId: options?.referenceId,
         });
     }
@@ -81,7 +89,6 @@ export class BoltaClient {
             method: 'POST',
             path: '/taxInvoices/issueRequest',
             body: data,
-            supplierKey: options?.supplierKey,
             referenceId: options?.referenceId,
         });
     }
@@ -97,27 +104,24 @@ export class BoltaClient {
             path: `/taxInvoices/issue/status?clientReferenceId=${encodeURIComponent(clientReferenceId)}`,
         });
     }
-    async amendTermination(issuanceKey, data, supplierKey) {
+    async amendTermination(issuanceKey, data) {
         return this.request({
             method: 'POST',
             path: `/taxInvoices/${encodeURIComponent(issuanceKey)}/amend/termination`,
             body: data,
-            supplierKey,
         });
     }
-    async amendChangeSupplyCost(issuanceKey, data, supplierKey) {
+    async amendChangeSupplyCost(issuanceKey, data) {
         return this.request({
             method: 'POST',
             path: `/taxInvoices/${encodeURIComponent(issuanceKey)}/amend/changeSupplyCost`,
             body: data,
-            supplierKey,
         });
     }
-    async amendDoubleIssuance(issuanceKey, supplierKey) {
+    async amendDoubleIssuance(issuanceKey) {
         return this.request({
             method: 'POST',
             path: `/taxInvoices/${encodeURIComponent(issuanceKey)}/amend/doubleIssuance`,
-            supplierKey,
         });
     }
     // ========================
@@ -128,7 +132,6 @@ export class BoltaClient {
             method: 'POST',
             path: '/cashReceipts',
             body: data,
-            supplierKey: options.supplierKey,
             referenceId: options.referenceId,
         });
     }
@@ -142,19 +145,12 @@ export class BoltaClient {
         return this.request({
             method: 'POST',
             path: `/cashReceipts/${encodeURIComponent(issuanceKey)}/cancellation`,
-            supplierKey: options.supplierKey,
             referenceId: options.referenceId,
         });
     }
     // ========================
     // Internal Request Method
     // ========================
-    certificatePath(key, suffix = '') {
-        if (key.startsWith(DEPRECATED_CUSTOMER_KEY_PREFIX)) {
-            deprecationWarning("'CustomerKey_' 키는 deprecated입니다. 신규 supplierKey를 사용하세요.");
-        }
-        return `/suppliers/${encodeURIComponent(key)}/certificates${suffix}`;
-    }
     async request(options) {
         const url = `${this.baseUrl}${options.path}`;
         const headers = {
@@ -162,23 +158,22 @@ export class BoltaClient {
             'Content-Type': 'application/json',
             'User-Agent': `bolta-cli/${getCurrentVersion()}`,
         };
-        const sk = options.supplierKey || this.supplierKey;
-        const supplierKeySource = options.supplierKey && options.supplierKey !== this.supplierKey
-            ? 'argument'
-            : this.supplierKeySource;
-        const maskedSupplierKey = sk ? maskSecret(sk, 8, 4) : undefined;
-        if (sk) {
-            headers['Supplier-Key'] = sk;
-            verbose('Supplier-Key 사용', { supplierKey: maskedSupplierKey, source: supplierKeySource });
+        const legacyIssuer = this.legacyIssuer;
+        const maskedLegacyIssuerKey = legacyIssuer ? maskSecret(legacyIssuer.key, 8, 4) : undefined;
+        if (legacyIssuer) {
+            headers['Supplier-Key'] = legacyIssuer.key;
+            verbose('레거시 발급자 헤더 사용', {
+                legacyIssuerKey: maskedLegacyIssuerKey,
+                source: legacyIssuer.source,
+            });
         }
         if (options.referenceId) {
             headers['Bolta-Client-Reference-Id'] = options.referenceId;
         }
-        // supplierKey 관련 4xx(특히 403)일 때 "무엇을·어디서 보냈는지"를 에러에 노출한다.
-        const supplierKeyDetails = sk
-            ? { supplierKey: maskedSupplierKey, supplierKeySource }
+        const legacyIssuerDetails = legacyIssuer
+            ? { legacyIssuerKey: maskedLegacyIssuerKey, source: legacyIssuer.source, legacyHeader: true }
             : undefined;
-        const makeApiError = (status, code, message) => new BoltaApiError(message, code, status, getSuggestion(status, code, { hasSupplierKey: Boolean(sk) }), status === 403 ? supplierKeyDetails : undefined);
+        const makeApiError = (status, code, message) => new BoltaApiError(message, code, status, getSuggestion(status, code, { legacyIssuer }), status === 403 ? legacyIssuerDetails : undefined);
         let lastError = null;
         for (let attempt = 1; attempt <= this.maxRetries; attempt++) {
             try {
@@ -271,9 +266,11 @@ function getSuggestion(status, code, ctx) {
     if (status === 402)
         return "포인트 잔액이 부족합니다. Bolta API는 사전 충전 포인트 차감 방식입니다. https://developers.bolta.io 개발자센터에서 포인트를 충전하세요. 'bolta guide payment'로 요금 정보를 확인할 수 있습니다.";
     if (status === 403) {
-        // 요청에 Supplier-Key가 실렸다면 supplierKey ↔ apiKey 불일치가 가장 흔한 원인이다.
-        if (ctx?.hasSupplierKey) {
-            return "이 API 키에 유효한 supplierKey인지 확인하세요. ① supplierKey는 test_/live_ 및 API 키마다 다릅니다(상호 호환 안 됨) ② 'bolta supplier get <supplierKey>'로 조회 ③ 환경변수 BOLTA_SUPPLIER_KEY/BOLTA_CUSTOMER_KEY가 config를 덮고 있지 않은지 'env | grep BOLTA'로 확인 ④ 'bolta config test'로 일괄 점검하세요.";
+        if (ctx?.legacyIssuer) {
+            // 레거시 키를 실어 보낸 요청의 403은 키 ↔ API 키 불일치가 가장 흔한 원인이다.
+            // 어느 소스에서 왔는지 이미 알고 있으므로 해제 방법을 그대로 알려준다.
+            const { origin, removal, verifyCommand } = describeLegacyIssuerKeySource(ctx.legacyIssuer.source);
+            return `이 요청에는 ${origin}에서 온 레거시 Supplier-Key 헤더가 실렸습니다. 해제 방법: ${removal}. 요청 본문의 사업자등록번호로 발급자를 지정하세요. 등록 상태는 '${verifyCommand}'로 확인하세요.`;
         }
         return '해당 작업에 대한 권한이 없습니다. API 키의 권한을 확인하세요.';
     }