@bolta-io/cli 0.0.14 → 0.0.15

package/dist/src/commands/supplier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/supplier/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwD/D"}

package/dist/src/commands/supplier/index.js

@@ -0,0 +1,56 @@
+import { createSupplierAction } from './create.js';
+import { getSupplierAction } from './get.js';
+import { createLegacyCustomerAction, getLegacyCustomerAction } from './legacy-customer.js';
+export function registerSupplierCommands(program) {
+    const supplier = program
+        .command('supplier')
+        .description('공급자(Supplier) 관리');
+    supplier
+        .command('create')
+        .description('공급자 생성 (POST /v1/suppliers)')
+        .option('--data <json>', '인라인 JSON 데이터')
+        .option('--file <path>', 'JSON 파일 경로')
+        .option('--stdin', '표준 입력에서 읽기')
+        .addHelpText('after', `
+Example:
+  bolta supplier create --data '{
+    "identificationNumber": "1234567890",
+    "organizationName": "주식회사 테스트",
+    "representativeName": "홍길동"
+  }'
+
+  bolta supplier create --file supplier.json`)
+        .action(createSupplierAction);
+    supplier
+        .command('get <supplierKey>')
+        .description('공급자 조회 (GET /v1/suppliers/{supplierKey})')
+        .addHelpText('after', `
+Example:
+  bolta supplier get SupplierKey_bf8paz`)
+        .action(getSupplierAction);
+    const customer = program
+        .command('customer', { hidden: true })
+        .description('(deprecated) 공급자 관리. supplier 명령어를 사용하세요.');
+    customer
+        .command('create')
+        .description('(deprecated) 공급자 생성 (POST /v1/customers)')
+        .option('--data <json>', '인라인 JSON 데이터')
+        .option('--file <path>', 'JSON 파일 경로')
+        .option('--stdin', '표준 입력에서 읽기')
+        .addHelpText('after', `
+Example:
+  bolta customer create --data '{
+    "identificationNumber": "1234567890",
+    "organizationName": "주식회사 테스트",
+    "representativeName": "홍길동"
+  }'`)
+        .action(createLegacyCustomerAction);
+    customer
+        .command('get <customerKey>')
+        .description('(deprecated) 공급자 조회 (GET /v1/customers/{customerKey})')
+        .addHelpText('after', `
+Example:
+  bolta customer get CustomerKey_bf8paz`)
+        .action(getLegacyCustomerAction);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/commands/supplier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/supplier/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAEnC,QAAQ;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;SACrC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC;SAC/B,WAAW,CAAC,OAAO,EAAE;;;;;;;;6CAQmB,CAAC;SACzC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,QAAQ;SACL,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,0CAA0C,CAAC;SACvD,WAAW,CAAC,OAAO,EAAE;;wCAEc,CAAC;SACpC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7B,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SACrC,WAAW,CAAC,2CAA2C,CAAC,CAAC;IAE5D,QAAQ;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;SACrC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC;SAC/B,WAAW,CAAC,OAAO,EAAE;;;;;;KAMrB,CAAC;SACD,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEtC,QAAQ;SACL,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,uDAAuD,CAAC;SACpE,WAAW,CAAC,OAAO,EAAE;;wCAEc,CAAC;SACpC,MAAM,CAAC,uBAAuB,CAAC,CAAC;AACrC,CAAC"}

package/dist/src/commands/supplier/legacy-customer.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+import type { DataInputOptions } from '../../types/api.js';
+export declare function createLegacyCustomerAction(options: DataInputOptions, command: Command): Promise<void>;
+export declare function getLegacyCustomerAction(customerKey: string, options: Record<string, unknown>, command: Command): Promise<void>;
+//# sourceMappingURL=legacy-customer.d.ts.map

package/dist/src/commands/supplier/legacy-customer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-customer.d.ts","sourceRoot":"","sources":["../../../../src/commands/supplier/legacy-customer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAK3D,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3G;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/src/commands/supplier/legacy-customer.js

@@ -0,0 +1,56 @@
+import { resolveApiKey, resolveBaseUrl } from '../../config/config-manager.js';
+import { BoltaClient } from '../../client/bolta-client.js';
+import { resolveInput } from '../../utils/input.js';
+import { deprecationWarning, outputError, outputSuccess, verbose } from '../../utils/output.js';
+import { createSupplierSchema } from '../../validators/schemas.js';
+import { BoltaAuthError, BoltaValidationError } from '../../utils/errors.js';
+import { ZodError } from 'zod';
+const LEGACY_CUSTOMER_COMMAND_WARNING = "'customer' 명령어는 'supplier'로 변경되었습니다. 'bolta supplier ...'를 사용하세요.";
+export async function createLegacyCustomerAction(options, command) {
+    try {
+        deprecationWarning(LEGACY_CUSTOMER_COMMAND_WARNING);
+        const globalOpts = command.optsWithGlobals();
+        const apiKey = resolveApiKey(globalOpts.apiKey);
+        if (!apiKey)
+            throw new BoltaAuthError('API 키가 설정되지 않았습니다.');
+        const client = new BoltaClient({ apiKey, baseUrl: resolveBaseUrl() });
+        const raw = await resolveInput(options);
+        let validated;
+        try {
+            validated = createSupplierSchema.parse(raw);
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                const details = Object.fromEntries(err.errors.map((e) => [e.path.join('.'), e.message]));
+                throw new BoltaValidationError('입력 데이터가 유효하지 않습니다.', details);
+            }
+            throw err;
+        }
+        if (globalOpts.dryRun) {
+            outputSuccess({ dryRun: true, requestBody: validated, endpoint: 'POST /v1/customers' });
+            return;
+        }
+        verbose('공급자 생성 요청 (legacy customer)', { identificationNumber: validated.identificationNumber });
+        const result = await client.createCustomer(validated);
+        outputSuccess(result);
+    }
+    catch (err) {
+        outputError(err);
+    }
+}
+export async function getLegacyCustomerAction(customerKey, options, command) {
+    try {
+        deprecationWarning(LEGACY_CUSTOMER_COMMAND_WARNING);
+        const globalOpts = command.optsWithGlobals();
+        const apiKey = resolveApiKey(globalOpts.apiKey);
+        if (!apiKey)
+            throw new BoltaAuthError('API 키가 설정되지 않았습니다.');
+        const client = new BoltaClient({ apiKey, baseUrl: resolveBaseUrl() });
+        const result = await client.getCustomer(customerKey);
+        outputSuccess(result);
+    }
+    catch (err) {
+        outputError(err);
+    }
+}
+//# sourceMappingURL=legacy-customer.js.map

package/dist/src/commands/supplier/legacy-customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-customer.js","sourceRoot":"","sources":["../../../../src/commands/supplier/legacy-customer.ts"],"names":[],"mappings":"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"}

package/dist/src/config/config-manager.d.ts

@@ -2,7 +2,7 @@ import type { BoltaConfig } from '../types/api.js';
 export declare function loadConfig(): BoltaConfig;
 export declare function saveConfig(config: BoltaConfig): void;
 export declare function resolveApiKey(cliFlag?: string): string | undefined;
-export declare function resolveCustomerKey(cliFlag?: string): string | undefined;
+export declare function resolveSupplierKey(cliFlag?: string, legacyCliFlag?: string): string | undefined;
 export declare function resolveBaseUrl(): string;
 export declare function maskApiKey(key: string): string;
 //# sourceMappingURL=config-manager.d.ts.map

package/dist/src/config/config-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../../src/config/config-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,wBAAgB,UAAU,IAAI,WAAW,CAOxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAGpD;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C"}
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../../src/config/config-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD,wBAAgB,UAAU,IAAI,WAAW,CAOxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAGpD;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB/F;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/src/config/config-manager.js

@@ -1,6 +1,7 @@
 import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { deprecationWarning } from '../utils/output.js';
 const CONFIG_DIR = join(homedir(), '.bolta');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 export function loadConfig() {
@@ -19,8 +20,28 @@ export function saveConfig(config) {
 export function resolveApiKey(cliFlag) {
     return cliFlag || process.env.BOLTA_API_KEY || loadConfig().apiKey;
 }
-export function resolveCustomerKey(cliFlag) {
-    return cliFlag || process.env.BOLTA_CUSTOMER_KEY || loadConfig().customerKey;
+export function resolveSupplierKey(cliFlag, legacyCliFlag) {
+    if (cliFlag)
+        return cliFlag;
+    if (legacyCliFlag) {
+        deprecationWarning("'--customer-key' 플래그는 '--supplier-key'로 변경되었습니다.");
+        return legacyCliFlag;
+    }
+    const config = loadConfig();
+    if (process.env.BOLTA_SUPPLIER_KEY)
+        return process.env.BOLTA_SUPPLIER_KEY;
+    if (config.supplierKey)
+        return config.supplierKey;
+    // 하위호환 폴백: 구 환경변수 / config 필드
+    if (process.env.BOLTA_CUSTOMER_KEY) {
+        deprecationWarning("'BOLTA_CUSTOMER_KEY' 환경변수는 'BOLTA_SUPPLIER_KEY'로 변경되었습니다.");
+        return process.env.BOLTA_CUSTOMER_KEY;
+    }
+    if (config.customerKey) {
+        deprecationWarning("config의 'customer-key'는 'supplier-key'로 변경되었습니다. 'bolta config set supplier-key <값>'으로 갱신하세요.");
+        return config.customerKey;
+    }
+    return undefined;
 }
 export function resolveBaseUrl() {
     return process.env.BOLTA_API_BASE_URL || loadConfig().baseUrl || 'https://xapi.bolta.io/v1';

package/dist/src/config/config-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../../src/config/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAa,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC,MAAM,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,CAAC,WAAW,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,CAAC,OAAO,IAAI,0BAA0B,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../../src/config/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAa,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC,MAAM,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,aAAsB;IACzE,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,aAAa,EAAE,CAAC;QAClB,kBAAkB,CAAC,kDAAkD,CAAC,CAAC;QACvE,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1E,IAAI,MAAM,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC,WAAW,CAAC;IAElD,8BAA8B;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,kBAAkB,CAAC,2DAA2D,CAAC,CAAC;QAChF,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,kBAAkB,CAAC,+FAA+F,CAAC,CAAC;QACpH,OAAO,MAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,CAAC,OAAO,IAAI,0BAA0B,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/types/api.d.ts

@@ -69,13 +69,27 @@ export interface AmendChangeSupplyCostRequest {
     date: string;
     items: TaxInvoiceItem[];
 }
-export interface CreateCustomerRequest {
+export interface CreateSupplierRequest {
     identificationNumber: string;
     organizationName: string;
     representativeName: string;
     taxRegistrationId?: string | null;
 }
-export interface CustomerResponse {
+/** @deprecated 신규 코드에서는 CreateSupplierRequest를 사용하세요. */
+export type CreateCustomerRequest = CreateSupplierRequest;
+export interface SupplierResponse {
+    supplierKey: string;
+    identificationNumber: string;
+    organizationName: string;
+    representativeName: string;
+    taxRegistrationId?: string | null;
+    certificate?: {
+        issuedAt: string;
+        expiresAt: string;
+    };
+}
+/** @deprecated legacy `customer` CLI 응답 호환용입니다. */
+export interface LegacyCustomerResponse {
     customerKey: string;
     identificationNumber: string;
     organizationName: string;
@@ -109,6 +123,8 @@ export interface CliErrorResponse {
 export type CliResponse<T = unknown> = CliSuccessResponse<T> | CliErrorResponse;
 export interface BoltaConfig {
     apiKey?: string;
+    supplierKey?: string;
+    /** @deprecated supplierKey로 대체됨. 읽기 폴백(마이그레이션) 용도로만 유지 */
     customerKey?: string;
     baseUrl?: string;
     timeout?: number;
@@ -122,6 +138,8 @@ export interface GlobalOptions {
     human?: boolean;
     verbose?: boolean;
     apiKey?: string;
+    supplierKey?: string;
+    /** @deprecated --supplier-key로 대체됨 */
     customerKey?: string;
     dryRun?: boolean;
 }

package/dist/src/types/api.d.ts.map

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

package/dist/src/utils/output.d.ts

@@ -1,4 +1,14 @@
 export declare function outputSuccess<T>(data: T): void;
 export declare function outputError(error: unknown): never;
 export declare function verbose(message: string, data?: Record<string, unknown>): void;
+/**
+ * Deprecation 경고를 stderr로 1회 출력한다.
+ * JSON 응답(stdout)을 오염시키지 않도록 항상 stderr를 사용한다.
+ */
+export declare function deprecationWarning(message: string): void;
+/**
+ * 구 이름(alias)을 신규 이름으로 매핑한다. 매핑되면 deprecation 경고를 출력한다.
+ * schema/examples/guide의 customer-* → supplier-* 하위호환 처리에 공통 사용한다.
+ */
+export declare function resolveDeprecatedName(input: string, aliases: Record<string, string>, label: string): string;
 //# sourceMappingURL=output.d.ts.map

package/dist/src/utils/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAG9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAyBjD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK7E"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAG9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAyBjD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK7E;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,KAAK,EAAE,MAAM,GACZ,MAAM,CAOR"}

package/dist/src/utils/output.js

@@ -34,4 +34,27 @@ export function verbose(message, data) {
         console.error(line);
     }
 }
+const shownDeprecations = new Set();
+/**
+ * Deprecation 경고를 stderr로 1회 출력한다.
+ * JSON 응답(stdout)을 오염시키지 않도록 항상 stderr를 사용한다.
+ */
+export function deprecationWarning(message) {
+    if (shownDeprecations.has(message))
+        return;
+    shownDeprecations.add(message);
+    console.error(`[bolta] ⚠ deprecated: ${message}`);
+}
+/**
+ * 구 이름(alias)을 신규 이름으로 매핑한다. 매핑되면 deprecation 경고를 출력한다.
+ * schema/examples/guide의 customer-* → supplier-* 하위호환 처리에 공통 사용한다.
+ */
+export function resolveDeprecatedName(input, aliases, label) {
+    const mapped = aliases[input];
+    if (mapped) {
+        deprecationWarning(`${label} '${input}'는 '${mapped}'로 변경되었습니다.`);
+        return mapped;
+    }
+    return input;
+}
 //# sourceMappingURL=output.js.map

package/dist/src/utils/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAI,IAAO;IACtC,MAAM,QAAQ,GAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAgB;YAC5B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;SACF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,MAAM,QAAQ,GAAgB;QAC5B,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE;KACF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,IAA8B;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC;QACxF,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAI,IAAO;IACtC,MAAM,QAAQ,GAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAgB;YAC5B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;SACF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,MAAM,QAAQ,GAAgB;QAC5B,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE;KACF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,IAA8B;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC;QACxF,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAC3C,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,OAA+B,EAC/B,KAAa;IAEb,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,EAAE,CAAC;QACX,kBAAkB,CAAC,GAAG,KAAK,KAAK,KAAK,OAAO,MAAM,aAAa,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/validators/schemas.d.ts

@@ -730,7 +730,7 @@ export declare const createTaxInvoiceIssueRequestSchema: z.ZodEffects<z.ZodObjec
     }[];
     description?: string | null | undefined;
 }>;
-export declare const createCustomerSchema: z.ZodObject<{
+export declare const createSupplierSchema: z.ZodObject<{
     identificationNumber: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>;
     organizationName: z.ZodString;
     representativeName: z.ZodString;

package/dist/src/validators/schemas.js

@@ -154,9 +154,9 @@ export const createTaxInvoiceIssueRequestSchema = taxInvoiceBaseSchema.superRefi
     }
 });
 // ========================
-// Customer Schemas
+// Supplier Schemas
 // ========================
-export const createCustomerSchema = z.object({
+export const createSupplierSchema = z.object({
     identificationNumber: businessIdentificationNumberSchema,
     organizationName: z.string().min(1, '상호명은 필수입니다').max(100),
     representativeName: z.string().min(1, '대표자명은 필수입니다').max(50),
@@ -183,7 +183,7 @@ export const amendChangeSupplyCostSchema = z.object({
 // JSON Schema Export (for `bolta schema` command)
 // ========================
 export const jsonSchemas = {
-    'customer-create': {
+    'supplier-create': {
         type: 'object',
         required: ['identificationNumber', 'organizationName', 'representativeName'],
         properties: {

package/llms.txt

@@ -9,21 +9,23 @@ AI 에이전트(Claude Code 등)가 세금계산서 업무를 자동화할 때
 
 환경변수로 설정:
 - BOLTA_API_KEY: API 키 (test_ 접두사: 샌드박스, live_ 접두사: 프로덕션)
-- BOLTA_CUSTOMER_KEY: 고객 키 (세금계산서 발행 시 필요)
+- BOLTA_SUPPLIER_KEY: 공급자 키 (세금계산서 발행 시 필요)
 
 또는 CLI로 설정:
 - bolta config set api-key <value>
-- bolta config set customer-key <value>
+- bolta config set supplier-key <value>
 
 ## 핵심 개념
 
-### Customer Key
-customerKey는 세금계산서를 발행하는 공급자 본인을 식별하는 키입니다.
-- 형식: customer_ 접두사 문자열 (예: customer_bf8paz)
-- 획득: 공급자의 사업자 정보로 bolta customer create 호출 → 응답의 customerKey
-- 설정: BOLTA_CUSTOMER_KEY 환경변수, --customer-key 플래그, 또는 bolta config set customer-key
+### Supplier Key
+supplierKey는 세금계산서를 발행하는 공급자 본인을 식별하는 키입니다.
+- 형식: SupplierKey_ 접두사 문자열 (예: SupplierKey_bf8paz)
+- 획득: 공급자의 사업자 정보로 bolta supplier create 호출 → 응답의 supplierKey
+- 설정: BOLTA_SUPPLIER_KEY 환경변수, --supplier-key 플래그, 또는 bolta config set supplier-key
 - API 키(test_/live_) 단위로 독립 관리. 상호 호환 안 됨
-주의: Customer-Key는 공급자(발행자) 본인의 키입니다. 세금계산서를 받는 거래처(공급받는자)의 정보는 Customer-Key 헤더가 아니라 요청 본문의 supplied 필드에 포함합니다.
+주의: Supplier-Key는 공급자(발행자) 본인의 키입니다. 세금계산서를 받는 거래처(공급받는자)의 정보는 Supplier-Key 헤더가 아니라 요청 본문의 supplied 필드에 포함합니다.
+
+참고: 구 명칭(customer)은 deprecated이며 당분간 동작합니다. `bolta customer ...`, `--customer-key`, `BOLTA_CUSTOMER_KEY`, `config set customer-key` 사용 시 경고가 출력됩니다.
 
 ### 요금
 Bolta API는 사전 충전 포인트 차감 방식 유료 서비스입니다.
@@ -33,32 +35,34 @@ Bolta API는 사전 충전 포인트 차감 방식 유료 서비스입니다.
 - 포인트 충전: https://developers.bolta.io 개발자센터
 
 ### 개념 안내 커맨드
-bolta guide                 주요 개념 안내 (customer-key, payment, workflow, glossary)
+bolta guide                 주요 개념 안내 (supplier-key, payment, workflow, glossary)
 
 ## Commands
 
-### Customer Management
+### Supplier Management
 
-bolta customer create --data '<json>'
-  고객 생성. 필수: identificationNumber(10자리), organizationName, representativeName
+bolta supplier create --data '<json>'
+  공급자 생성. 필수: identificationNumber(10자리), organizationName, representativeName
 
-bolta customer get <customerKey>
-  고객 조회.
+bolta supplier get <supplierKey>
+  공급자 조회.
 
 ### Certificate Management
 
-bolta certificate url <customerKey>
+bolta certificate url <supplierKey>
   공동인증서 등록 URL 조회.
 
-bolta certificate status <customerKey>
+bolta certificate status <supplierKey>
   인증서 등록 내역 조회.
 
-bolta certificate deregister <customerKey>
+bolta certificate deregister <supplierKey>
   인증서 등록 해제.
 
+deprecated CustomerKey_ 키도 인증서 명령에서 당분간 사용할 수 있습니다.
+
 ### Tax Invoice
 
-bolta invoice issue --data '<json>' [--reference-id <id>] [--customer-key <key>]
+bolta invoice issue --data '<json>' [--reference-id <id>] [--supplier-key <key>]
   세금계산서 정발행. 필수 필드:
   - date (YYYY-MM-DD)
   - purpose (CLAIM | RECEIPT)
@@ -72,7 +76,7 @@ bolta invoice issue --data '<json>' [--reference-id <id>] [--customer-key <key>]
   - description (최대 200자)
   외국인등록번호 공급받는자는 정발행만 지원. 이 경우 supplied.taxRegistrationId와 최상위 description은 null/미입력이어야 함. 여권번호는 미지원.
 
-bolta invoice issue-request --data '<json>' [--reference-id <id>] [--customer-key <key>]
+bolta invoice issue-request --data '<json>' [--reference-id <id>] [--supplier-key <key>]
   세금계산서 역발행 요청. supplied.identificationNumber는 사업자등록번호 10자리만 허용.
 
 bolta invoice get <issuanceKey>
@@ -81,16 +85,16 @@ bolta invoice get <issuanceKey>
 bolta invoice status --reference-id <id>
   Client-Reference-Id로 세금계산서 상태 조회.
 
-bolta invoice amend termination <issuanceKey> --date <YYYY-MM-DD> [--customer-key <key>]
+bolta invoice amend termination <issuanceKey> --date <YYYY-MM-DD> [--supplier-key <key>]
   수정발행: 계약 해제.
 
-bolta invoice amend change-supply-cost <issuanceKey> --data '<json>' [--customer-key <key>]
+bolta invoice amend change-supply-cost <issuanceKey> --data '<json>' [--supplier-key <key>]
   수정발행: 공급가액 변동. JSON: {date, items: [{date, name, supplyCost, tax?}]}
 
 ### Configuration
 
 bolta config set <key> <value>
-  설정 저장. key: api-key, customer-key, base-url
+  설정 저장. key: api-key, supplier-key, base-url
 
 bolta config show
   현재 설정 확인.
@@ -102,7 +106,7 @@ bolta config test
 
 bolta examples [command]
   샘플 JSON 출력. command 없이 실행하면 목록 표시.
-  사용 가능: customer-create, invoice-issue, invoice-issue-foreign-supplied, invoice-issue-request, amend-termination, amend-change-supply-cost
+  사용 가능: supplier-create, invoice-issue, invoice-issue-foreign-supplied, invoice-issue-request, amend-termination, amend-change-supply-cost
 
 bolta schema [command]
   입력 JSON 스키마 출력. command 없이 실행하면 목록 표시.
@@ -110,7 +114,7 @@ bolta schema [command]
 ## Global Options
 
 --api-key <key>       API 키 오버라이드
---customer-key <key>  Customer Key 오버라이드
+--supplier-key <key>  Supplier Key 오버라이드
 --verbose             상세 로그 (stderr)
 --dry-run             API 호출 없이 요청 데이터만 출력
 
@@ -127,7 +131,7 @@ bolta schema [command]
 
 ## Common Workflow
 
-1. bolta customer create --data '{"identificationNumber":"1234567890","organizationName":"회사명","representativeName":"대표자"}'
-2. bolta certificate status <customerKey>
+1. bolta supplier create --data '{"identificationNumber":"1234567890","organizationName":"회사명","representativeName":"대표자"}'
+2. bolta certificate status <supplierKey>
 3. bolta invoice issue --data '<세금계산서 JSON>'
 4. bolta invoice get <issuanceKey>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolta-io/cli",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "Bolta API CLI for Korean electronic tax invoices (전자세금계산서)",
   "type": "module",
   "bin": {

package/dist/src/commands/customer/index.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerCustomerCommands(program: Command): void;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/commands/customer/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/customer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B/D"}

package/dist/src/commands/customer/index.js

@@ -1,29 +0,0 @@
-import { createCustomerAction } from './create.js';
-import { getCustomerAction } from './get.js';
-export function registerCustomerCommands(program) {
-    const customer = program.command('customer').description('고객(Customer) 관리');
-    customer
-        .command('create')
-        .description('고객 생성 (POST /v1/customers)')
-        .option('--data <json>', '인라인 JSON 데이터')
-        .option('--file <path>', 'JSON 파일 경로')
-        .option('--stdin', '표준 입력에서 읽기')
-        .addHelpText('after', `
-Example:
-  bolta customer create --data '{
-    "identificationNumber": "1234567890",
-    "organizationName": "주식회사 테스트",
-    "representativeName": "홍길동"
-  }'
-
-  bolta customer create --file customer.json`)
-        .action(createCustomerAction);
-    customer
-        .command('get <customerKey>')
-        .description('고객 조회 (GET /v1/customers/{customerKey})')
-        .addHelpText('after', `
-Example:
-  bolta customer get customer_bf8paz`)
-        .action(getCustomerAction);
-}
-//# sourceMappingURL=index.js.map

package/dist/src/commands/customer/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/customer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE5E,QAAQ;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;SACrC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC;SAC/B,WAAW,CAAC,OAAO,EAAE;;;;;;;;6CAQmB,CAAC;SACzC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,QAAQ;SACL,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,yCAAyC,CAAC;SACtD,WAAW,CAAC,OAAO,EAAE;;qCAEW,CAAC;SACjC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC"}