dart-fss-cli 0.4.5 → 0.4.7

package/dist/bin.js

@@ -2,7 +2,7 @@
 import {
   createDartProgram,
   formatErrorJson
-} from "./chunk-JYPAIE4W.js";
+} from "./chunk-2WVCVNX6.js";
 
 // src/bin.ts
 createDartProgram().parseAsync(process.argv).catch((err) => {

package/dist/{chunk-JYPAIE4W.js → chunk-2WVCVNX6.js}

@@ -2,11 +2,12 @@
 import { Command } from "commander";
 
 // src/config.ts
-import { homedir } from "os";
+import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
 
 // src/env.ts
 import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
 import { join, resolve } from "path";
 var loaded = false;
 function loadEnv() {
@@ -15,7 +16,8 @@ function loadEnv() {
   const candidates = [
     process.cwd(),
     resolve(process.cwd(), ".."),
-    resolve(import.meta.dirname, "..")
+    resolve(import.meta.dirname, ".."),
+    join(homedir(), ".dart-fss")
   ];
   for (const base of candidates) {
     const envPath = join(base, ".env");
@@ -40,7 +42,7 @@ function loadEnv() {
 // src/config.ts
 loadEnv();
 var DART_BASE_URL = "https://opendart.fss.or.kr/api/";
-var CACHE_DIR = join2(homedir(), ".dart-fss");
+var CACHE_DIR = join2(homedir2(), ".dart-fss");
 var CORP_CODE_CACHE_PATH = join2(CACHE_DIR, "corp-codes.json");
 var CORP_CODE_CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
 function getApiKey(optionKey) {
@@ -1175,7 +1177,7 @@ function registerDisclosureCommands(program) {
   );
   group.command("list").description(
     "Search DART disclosure filings. Returns paginated results with report name, filing date, receipt number.\nWithout --corp, searches ALL companies (date range limited to 3 months).\nWith --corp, searches specific company with no date limit.\nDisclosure types: A=Regular, B=Major events, C=Issuance, D=Equity, E=Other, F=Audit, G=Fund, H=ABS, I=Exchange, J=FTC"
-  ).option("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').option("--from <YYYYMMDD>", "Start date in YYYYMMDD format (e.g. 20240101)").option("--to <YYYYMMDD>", "End date in YYYYMMDD format (e.g. 20241231)").option("--type <code>", "Disclosure type: A=Regular, B=Major events, C=Issuance, D=Equity, E=Other, F=Audit, G=Fund, H=ABS, I=Exchange, J=FTC").option("--corp-cls <cls>", "Corp class filter: Y=KOSPI, K=KOSDAQ, N=KONEX, E=Other").option("--page <n>", "Page number, starting from 1 (default: 1)", "1").option("--count <n>", "Items per page, 1-100 (default: 10)", "10").action(async (opts) => {
+  ).option("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').option("--from <YYYYMMDD>", "Start date in YYYYMMDD format (e.g. 20240101)").option("--to <YYYYMMDD>", "End date in YYYYMMDD format (e.g. 20241231)").option("--type <code>", "Disclosure type: A=Regular, B=Major events, C=Issuance, D=Equity, E=Other, F=Audit, G=Fund, H=ABS, I=Exchange, J=FTC").option("--corp-cls <cls>", "Corp class filter: Y=KOSPI, K=KOSDAQ, N=KONEX, E=Other").option("--page <n>", "Page number, starting from 1 (default: 1)", "1").option("--count <n>", "Items per page, 1-100 (default: 10)", "10").addHelpText("after", '\nExamples:\n  dart-fss disclosure list --corp "\uC0BC\uC131\uC804\uC790" --from 20250101 --to 20251231 --pretty\n  dart-fss disclosure list --from 20250101 --to 20250131 --count 20').action(async (opts) => {
     const globalOpts = getGlobalOpts(group);
     const apiKey = getApiKey(globalOpts.apiKey);
     if (globalOpts.json) {
@@ -1201,7 +1203,7 @@ function registerDisclosureCommands(program) {
   });
   group.command("company").description(
     'Get company profile from DART. Returns corp name, CEO, address, stock code, industry code, incorporation date, fiscal month.\nAccepts company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code.'
-  ).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').action(async (opts) => {
+  ).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').addHelpText("after", '\nExamples:\n  dart-fss disclosure company --corp "\uC0BC\uC131\uC804\uC790" --pretty\n  dart-fss disclosure company --corp 00126380 --fields "corp_name,ceo_nm,adres"').action(async (opts) => {
     const globalOpts = getGlobalOpts(group);
     const apiKey = getApiKey(globalOpts.apiKey);
     if (globalOpts.json) {
@@ -1293,7 +1295,10 @@ function registerPeriodicReportCommands(program) {
     (ep) => ep.pattern === "periodic"
   );
   for (const ep of endpoints) {
-    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--year <YYYY>", "Business year in YYYY format (e.g. 2024). Data from 2015 onward").requiredOption("--quarter <q1|half|q3|annual>", "Report quarter: q1 (Q1), half (semi-annual), q3 (Q3), annual (full year)").action(async (opts) => {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--year <YYYY>", "Business year in YYYY format (e.g. 2024). Data from 2015 onward").requiredOption("--quarter <q1|half|q3|annual>", "Report quarter: q1 (Q1), half (semi-annual), q3 (Q3), annual (full year)").addHelpText("after", `
+Examples:
+  dart-fss report ${ep.cliName} --corp "\uC0BC\uC131\uC804\uC790" --year 2025 --quarter annual --pretty
+  dart-fss report ${ep.cliName} --corp "\uC0BC\uC131\uC804\uC790" --year 2025 --quarter annual --fields "corp_name,nm"`).action(async (opts) => {
       const globalOpts = getGlobalOpts2(group);
       const apiKey = getApiKey(globalOpts.apiKey);
       if (globalOpts.json) {
@@ -1449,7 +1454,10 @@ function registerEquityDisclosureCommands(program) {
     (ep) => ep.pattern === "corpOnly"
   );
   for (const ep of endpoints) {
-    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", "Company name or corp_code").action(async (opts) => {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", "Company name or corp_code").addHelpText("after", `
+Examples:
+  dart-fss equity ${ep.cliName} --corp "\uC0BC\uC131\uC804\uC790" --pretty
+  dart-fss equity ${ep.cliName} --corp "\uC0BC\uC131\uC804\uC790" --fields "repror,stkqy,stkrt"`).action(async (opts) => {
       const globalOpts = getGlobalOpts4(group);
       const apiKey = getApiKey(globalOpts.apiKey);
       if (globalOpts.json) {
@@ -1482,7 +1490,10 @@ function registerMajorReportCommands(program) {
     (ep) => ep.pattern === "dateRange"
   );
   for (const ep of endpoints) {
-    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--from <YYYYMMDD>", "Start date in YYYYMMDD format (filing date). Data from 2015 onward").requiredOption("--to <YYYYMMDD>", "End date in YYYYMMDD format (filing date)").action(async (opts) => {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--from <YYYYMMDD>", "Start date in YYYYMMDD format (filing date). Data from 2015 onward").requiredOption("--to <YYYYMMDD>", "End date in YYYYMMDD format (filing date)").addHelpText("after", `
+Examples:
+  dart-fss major ${ep.cliName} --corp "\uC0BC\uC131\uC804\uC790" --from 20230101 --to 20251231 --pretty
+  dart-fss major ${ep.cliName} --corp "\uCE74\uCE74\uC624" --from 20250101 --to 20251231`).action(async (opts) => {
       const globalOpts = getGlobalOpts5(group);
       const apiKey = getApiKey(globalOpts.apiKey);
       if (globalOpts.json) {
@@ -1515,7 +1526,9 @@ function registerSecuritiesFilingCommands(program) {
     (ep) => ep.pattern === "dateRange"
   );
   for (const ep of endpoints) {
-    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--from <YYYYMMDD>", "Start date in YYYYMMDD format (filing date). Data from 2015 onward").requiredOption("--to <YYYYMMDD>", "End date in YYYYMMDD format (filing date)").action(async (opts) => {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--from <YYYYMMDD>", "Start date in YYYYMMDD format (filing date). Data from 2015 onward").requiredOption("--to <YYYYMMDD>", "End date in YYYYMMDD format (filing date)").addHelpText("after", `
+Examples:
+  dart-fss securities ${ep.cliName} --corp "\uC0BC\uC131\uC804\uC790" --from 20230101 --to 20251231 --pretty`).action(async (opts) => {
       const globalOpts = getGlobalOpts6(group);
       const apiKey = getApiKey(globalOpts.apiKey);
       if (globalOpts.json) {
@@ -1664,7 +1677,15 @@ function createDartProgram() {
   const program = new Command();
   program.name("dart-fss").description(
     'DART Open API CLI \u2014 access Korea Financial Supervisory Service (FSS) electronic disclosure system.\nProvides 83 API endpoints for company filings, financial statements, equity disclosures, and more.\nAuthentication: set DART_API_KEY env var or pass --api-key. Get a key at https://opendart.fss.or.kr\nCompanies are identified by 8-digit corp_code or company name. Use "dart-fss lookup <name>" to find corp_code.\nOutput is JSON by default (compact single-line). Use --pretty for formatted output.\nRate limit: approximately 20,000 requests per day per API key.'
-  ).version("0.4.5").option("--api-key <key>", "DART API key (default: DART_API_KEY env). Get one at https://opendart.fss.or.kr").option("--pretty", "Pretty-print JSON output (default: compact single-line JSON)").option("--output <file>", "Save result to file instead of stdout").option("--json <params>", "Pass raw API parameters as JSON string, bypassing flag parsing").option("--fields <f1,f2,...>", "Comma-separated field names to include in output (reduces response size for agents)").option("--dry-run", "Validate parameters and print the resolved API request without calling the API");
+  ).version("0.4.7").option("--api-key <key>", "DART API key (default: DART_API_KEY env). Get one at https://opendart.fss.or.kr").option("--pretty", "Pretty-print JSON output (default: compact single-line JSON)").option("--output <file>", "Save result to file instead of stdout").option("--json <params>", "Pass raw API parameters as JSON string, bypassing flag parsing").option("--fields <f1,f2,...>", "Comma-separated field names to include in output (reduces response size for agents)").option("--dry-run", "Validate parameters and print the resolved API request without calling the API").addHelpText("after", `
+Examples:
+  dart-fss lookup "\uC0BC\uC131\uC804\uC790"
+  dart-fss disclosure company --corp "\uC0BC\uC131\uC804\uC790" --pretty
+  dart-fss report employee --corp "\uC0BC\uC131\uC804\uC790" --year 2025 --quarter annual --pretty
+  dart-fss financial single-account --corp "SK\uD558\uC774\uB2C9\uC2A4" --year 2025 --quarter annual --fields "account_nm,thstrm_amount"
+  dart-fss major lawsuit --corp "\uCE74\uCE74\uC624" --from 20230101 --to 20251231
+  dart-fss endpoints --json-output
+  dart-fss schema employee`);
   registerDisclosureCommands(program);
   registerPeriodicReportCommands(program);
   registerFinancialCommands(program);

package/dist/cli.js

@@ -1,6 +1,6 @@
 import {
   createDartProgram
-} from "./chunk-JYPAIE4W.js";
+} from "./chunk-2WVCVNX6.js";
 export {
   createDartProgram
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dart-fss-cli",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "DART (금융감독원 전자공시) Open API CLI",
   "type": "module",
   "bin": {