gangtise-openapi-cli 0.11.0 → 0.12.0

package/dist/src/core/endpoints.js

@@ -1,76 +1,79 @@
 export const ENDPOINTS = {
-    authLogin: {
+    // ─── auth ───
+    "auth.login": {
         key: "auth.login",
         method: "POST",
         path: "/application/auth/oauth/open/loginV2",
         kind: "json",
         description: "Get access token",
     },
-    lookupResearchAreas: {
+    // ─── lookup (served from local data, not HTTP) ───
+    "lookup.research-areas.list": {
         key: "lookup.research-areas.list",
         method: "GET",
         path: "/guide/research-area-local",
         kind: "json",
         description: "List research areas from local docs",
     },
-    lookupBrokerOrgs: {
+    "lookup.broker-orgs.list": {
         key: "lookup.broker-orgs.list",
         method: "GET",
         path: "/guide/broker-orgs-local",
         kind: "json",
         description: "List broker orgs from local docs",
     },
-    lookupMeetingOrgs: {
+    "lookup.meeting-orgs.list": {
         key: "lookup.meeting-orgs.list",
         method: "GET",
         path: "/guide/meeting-orgs-local",
         kind: "json",
         description: "List meeting orgs from local docs",
     },
-    lookupIndustries: {
+    "lookup.industries.list": {
         key: "lookup.industries.list",
         method: "GET",
         path: "/guide/industries-local",
         kind: "json",
         description: "List industries from local docs",
     },
-    lookupRegions: {
+    "lookup.regions.list": {
         key: "lookup.regions.list",
         method: "GET",
         path: "/guide/regions-local",
         kind: "json",
         description: "List regions from local docs",
     },
-    lookupAnnouncementCategories: {
+    "lookup.announcement-categories.list": {
         key: "lookup.announcement-categories.list",
         method: "GET",
         path: "/guide/announcement-categories-local",
         kind: "json",
         description: "List announcement categories from local docs",
     },
-    lookupIndustryCodes: {
+    "lookup.industry-codes.list": {
         key: "lookup.industry-codes.list",
         method: "GET",
         path: "/guide/industry-codes-local",
         kind: "json",
         description: "List Shenwan industry codes from local docs",
     },
-    lookupThemeIds: {
+    "lookup.theme-ids.list": {
         key: "lookup.theme-ids.list",
         method: "GET",
         path: "/guide/theme-ids-local",
         kind: "json",
         description: "List theme IDs from local docs",
     },
-    insightOpinionList: {
+    // ─── insight ───
+    "insight.opinion.list": {
         key: "insight.opinion.list",
         method: "POST",
         path: "/application/open-insight/chief-opinion/getList",
         kind: "json",
-        description: "List chief opinions",
+        description: "List domestic institution chief opinions",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightSummaryList: {
+    "insight.summary.list": {
         key: "insight.summary.list",
         method: "POST",
         path: "/application/open-insight/summary/v2/getList",
@@ -78,14 +81,14 @@ export const ENDPOINTS = {
         description: "List summaries",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightSummaryDownload: {
+    "insight.summary.download": {
         key: "insight.summary.download",
         method: "GET",
         path: "/application/open-insight/summary/v2/download/file",
         kind: "download",
         description: "Download summary file",
     },
-    insightRoadshowList: {
+    "insight.roadshow.list": {
         key: "insight.roadshow.list",
         method: "POST",
         path: "/application/open-insight/schedule/roadshow/getList",
@@ -93,7 +96,7 @@ export const ENDPOINTS = {
         description: "List roadshows",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightSiteVisitList: {
+    "insight.site-visit.list": {
         key: "insight.site-visit.list",
         method: "POST",
         path: "/application/open-insight/schedule/site-visit/getList",
@@ -101,7 +104,7 @@ export const ENDPOINTS = {
         description: "List site visits",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightStrategyList: {
+    "insight.strategy.list": {
         key: "insight.strategy.list",
         method: "POST",
         path: "/application/open-insight/schedule/strategy-meeting/getList",
@@ -109,7 +112,7 @@ export const ENDPOINTS = {
         description: "List strategy meetings",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightForumList: {
+    "insight.forum.list": {
         key: "insight.forum.list",
         method: "POST",
         path: "/application/open-insight/schedule/forum/getList",
@@ -117,7 +120,7 @@ export const ENDPOINTS = {
         description: "List forums",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightResearchList: {
+    "insight.research.list": {
         key: "insight.research.list",
         method: "POST",
         path: "/application/open-insight/broker-report/getList",
@@ -125,14 +128,14 @@ export const ENDPOINTS = {
         description: "List broker research reports",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightResearchDownload: {
+    "insight.research.download": {
         key: "insight.research.download",
         method: "GET",
         path: "/application/open-insight/broker-report/download/file",
         kind: "download",
         description: "Download broker research report",
     },
-    insightForeignReportList: {
+    "insight.foreign-report.list": {
         key: "insight.foreign-report.list",
         method: "POST",
         path: "/application/open-insight/foreign-report/getList",
@@ -140,113 +143,183 @@ export const ENDPOINTS = {
         description: "List foreign reports",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightForeignReportDownload: {
+    "insight.foreign-report.download": {
         key: "insight.foreign-report.download",
         method: "GET",
         path: "/application/open-insight/foreign-report/download/file",
         kind: "download",
         description: "Download foreign report",
     },
-    insightAnnouncementList: {
+    "insight.announcement.list": {
         key: "insight.announcement.list",
         method: "POST",
         path: "/application/open-insight/announcement/getList",
         kind: "json",
-        description: "List announcements",
+        description: "List A-share announcements",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    insightAnnouncementDownload: {
+    "insight.announcement.download": {
         key: "insight.announcement.download",
         method: "GET",
         path: "/application/open-insight/announcement/download/file",
         kind: "download",
-        description: "Download announcement file",
+        description: "Download A-share announcement file",
     },
-    quoteDayKline: {
+    "insight.announcement-hk.list": {
+        key: "insight.announcement-hk.list",
+        method: "POST",
+        path: "/application/open-insight/announcement-hk/getList",
+        kind: "json",
+        description: "List HK announcements",
+        pagination: { enabled: true, maxPageSize: 50 },
+    },
+    "insight.announcement-hk.download": {
+        key: "insight.announcement-hk.download",
+        method: "GET",
+        path: "/application/open-insight/announcement-hk/download/file",
+        kind: "download",
+        description: "Download HK announcement file",
+    },
+    "insight.foreign-opinion.list": {
+        key: "insight.foreign-opinion.list",
+        method: "POST",
+        path: "/application/open-insight/foreign-opinion/getList",
+        kind: "json",
+        description: "List foreign institution opinions",
+        pagination: { enabled: true, maxPageSize: 50 },
+    },
+    "insight.independent-opinion.list": {
+        key: "insight.independent-opinion.list",
+        method: "POST",
+        path: "/application/open-insight/independent-opinion/getList",
+        kind: "json",
+        description: "List foreign independent analyst opinions",
+        pagination: { enabled: true, maxPageSize: 50 },
+    },
+    "insight.independent-opinion.download": {
+        key: "insight.independent-opinion.download",
+        method: "GET",
+        path: "/application/open-insight/independent-opinion/download/file",
+        kind: "download",
+        description: "Download foreign independent opinion file",
+    },
+    // ─── reference ───
+    "reference.securities-search": {
+        key: "reference.securities-search",
+        method: "POST",
+        path: "/application/open-reference/securities/search",
+        kind: "json",
+        description: "Search GTS codes (securities)",
+    },
+    // ─── quote ───
+    "quote.day-kline": {
         key: "quote.day-kline",
         method: "POST",
         path: "/application/open-quote/kline/daily",
         kind: "json",
         description: "Query A-share daily kline (SH/SZ/BJ)",
     },
-    quoteDayKlineHk: {
+    "quote.day-kline-hk": {
         key: "quote.day-kline-hk",
         method: "POST",
         path: "/application/open-quote/kline-hk/daily",
         kind: "json",
         description: "Query HK stock daily kline (HK)",
     },
-    quoteIndexDayKline: {
+    "quote.index-day-kline": {
         key: "quote.index-day-kline",
         method: "POST",
         path: "/application/open-quote/index/kline/daily",
         kind: "json",
         description: "Query SH/SZ/BJ index daily kline",
     },
-    fundamentalIncomeStatement: {
+    "quote.minute-kline": {
+        key: "quote.minute-kline",
+        method: "POST",
+        path: "/application/open-quote/kline/minute",
+        kind: "json",
+        description: "Query A-share minute kline (SH/SZ/BJ)",
+    },
+    // ─── fundamental ───
+    "fundamental.income-statement": {
         key: "fundamental.income-statement",
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/accumulated",
         kind: "json",
         description: "Query income statement (accumulated)",
     },
-    fundamentalBalanceSheet: {
+    "fundamental.income-statement-quarterly": {
+        key: "fundamental.income-statement-quarterly",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/income-statement/quarterly",
+        kind: "json",
+        description: "Query income statement (quarterly)",
+    },
+    "fundamental.balance-sheet": {
         key: "fundamental.balance-sheet",
         method: "POST",
         path: "/application/open-fundamental/financial-report/balance-sheet/accumulated",
         kind: "json",
         description: "Query balance sheet (accumulated)",
     },
-    fundamentalCashFlow: {
+    "fundamental.cash-flow": {
         key: "fundamental.cash-flow",
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/accumulated",
         kind: "json",
         description: "Query cash flow statement (accumulated)",
     },
-    fundamentalMainBusiness: {
-        key: "fundamental.main-business",
+    "fundamental.cash-flow-quarterly": {
+        key: "fundamental.cash-flow-quarterly",
         method: "POST",
-        path: "/application/open-fundamental/main-business",
+        path: "/application/open-fundamental/financial-report/cash-flow-statement/quarterly",
         kind: "json",
-        description: "Query main business composition",
+        description: "Query cash flow statement (quarterly)",
     },
-    fundamentalEarningForecast: {
-        key: "fundamental.earning-forecast",
+    "fundamental.main-business": {
+        key: "fundamental.main-business",
         method: "POST",
-        path: "/application/open-fundamental/earning-forecast",
+        path: "/application/open-fundamental/main-business",
         kind: "json",
-        description: "Query earning forecast (consensus estimates)",
+        description: "Query main business composition",
     },
-    fundamentalValuationAnalysis: {
+    "fundamental.valuation-analysis": {
         key: "fundamental.valuation-analysis",
         method: "POST",
         path: "/application/open-fundamental/valuation-analysis",
         kind: "json",
         description: "Query valuation analysis",
     },
-    fundamentalTopHolders: {
+    "fundamental.top-holders": {
         key: "fundamental.top-holders",
         method: "POST",
         path: "/application/open-fundamental/capital-structure/top-holders",
         kind: "json",
         description: "Query top holders (top10 / top10 float)",
     },
-    aiKnowledgeBatch: {
+    "fundamental.earning-forecast": {
+        key: "fundamental.earning-forecast",
+        method: "POST",
+        path: "/application/open-fundamental/earning-forecast",
+        kind: "json",
+        description: "Query earning forecast (consensus estimates)",
+    },
+    // ─── ai ───
+    "ai.knowledge-batch": {
         key: "ai.knowledge-batch",
         method: "POST",
         path: "/application/open-data/ai/search/knowledge/batch",
         kind: "json",
         description: "Batch knowledge search",
     },
-    aiKnowledgeResource: {
+    "ai.knowledge-resource.download": {
         key: "ai.knowledge-resource.download",
         method: "GET",
         path: "/application/open-data/ai/resource/download",
         kind: "download",
         description: "Download knowledge resource",
     },
-    aiSecurityClue: {
+    "ai.security-clue.list": {
         key: "ai.security-clue.list",
         method: "POST",
         path: "/application/open-ai/security-clue/getList",
@@ -254,56 +327,56 @@ export const ENDPOINTS = {
         description: "List security clues",
         pagination: { enabled: true, maxPageSize: 500 },
     },
-    aiOnePager: {
+    "ai.one-pager": {
         key: "ai.one-pager",
         method: "POST",
         path: "/application/open-ai/agent/one-pager",
         kind: "json",
         description: "Generate one pager",
     },
-    aiInvestmentLogic: {
+    "ai.investment-logic": {
         key: "ai.investment-logic",
         method: "POST",
         path: "/application/open-ai/agent/investment-logic",
         kind: "json",
         description: "Generate investment logic",
     },
-    aiPeerComparison: {
+    "ai.peer-comparison": {
         key: "ai.peer-comparison",
         method: "POST",
         path: "/application/open-ai/agent/peer-comparison",
         kind: "json",
         description: "Generate peer comparison",
     },
-    aiEarningsReviewGetId: {
+    "ai.earnings-review.get-id": {
         key: "ai.earnings-review.get-id",
         method: "POST",
         path: "/application/open-ai/agent/earnings-review-getid",
         kind: "json",
         description: "Get earnings review ID",
     },
-    aiEarningsReviewGetContent: {
+    "ai.earnings-review.get-content": {
         key: "ai.earnings-review.get-content",
         method: "POST",
         path: "/application/open-ai/agent/earnings-review-getcontent",
         kind: "json",
         description: "Get earnings review content",
     },
-    aiThemeTracking: {
+    "ai.theme-tracking": {
         key: "ai.theme-tracking",
         method: "POST",
         path: "/application/open-ai/agent/theme-tracking",
         kind: "json",
         description: "Get theme tracking daily report",
     },
-    aiResearchOutline: {
+    "ai.research-outline": {
         key: "ai.research-outline",
         method: "POST",
         path: "/application/open-ai/agent/research-outline",
         kind: "json",
         description: "Get company research outline",
     },
-    aiHotTopic: {
+    "ai.hot-topic": {
         key: "ai.hot-topic",
         method: "POST",
         path: "/application/open-ai/hot-topic/getList",
@@ -311,56 +384,36 @@ export const ENDPOINTS = {
         description: "List hot topic reports",
         pagination: { enabled: true, maxPageSize: 20 },
     },
-    aiManagementDiscussAnnouncement: {
+    "ai.management-discuss-announcement": {
         key: "ai.management-discuss-announcement",
         method: "POST",
         path: "/application/open-ai/management-discuss/from-announcement",
         kind: "json",
         description: "Management discussion from financial reports (half-year/annual)",
     },
-    aiManagementDiscussEarningsCall: {
+    "ai.management-discuss-earnings-call": {
         key: "ai.management-discuss-earnings-call",
         method: "POST",
         path: "/application/open-ai/management-discuss/from-earningsCall",
         kind: "json",
         description: "Management discussion from earnings calls",
     },
-    aiViewpointDebateGetId: {
+    "ai.viewpoint-debate.get-id": {
         key: "ai.viewpoint-debate.get-id",
         method: "POST",
         path: "/application/open-ai/agent/viewpoint-debate-getid",
         kind: "json",
         description: "Get viewpoint debate ID",
     },
-    aiViewpointDebateGetContent: {
+    "ai.viewpoint-debate.get-content": {
         key: "ai.viewpoint-debate.get-content",
         method: "POST",
         path: "/application/open-ai/agent/viewpoint-debate-getcontent",
         kind: "json",
         description: "Get viewpoint debate content",
     },
-    quoteMinuteKline: {
-        key: "quote.minute-kline",
-        method: "POST",
-        path: "/application/open-quote/kline/minute",
-        kind: "json",
-        description: "Query A-share minute kline (SH/SZ/BJ)",
-    },
-    fundamentalIncomeStatementQuarterly: {
-        key: "fundamental.income-statement-quarterly",
-        method: "POST",
-        path: "/application/open-fundamental/financial-report/income-statement/quarterly",
-        kind: "json",
-        description: "Query income statement (quarterly)",
-    },
-    fundamentalCashFlowQuarterly: {
-        key: "fundamental.cash-flow-quarterly",
-        method: "POST",
-        path: "/application/open-fundamental/financial-report/cash-flow-statement/quarterly",
-        kind: "json",
-        description: "Query cash flow statement (quarterly)",
-    },
-    vaultDriveList: {
+    // ─── vault ───
+    "vault.drive.list": {
         key: "vault.drive.list",
         method: "POST",
         path: "/application/open-vault/drive/getList",
@@ -368,14 +421,14 @@ export const ENDPOINTS = {
         description: "List vault drive files",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    vaultDriveDownload: {
+    "vault.drive.download": {
         key: "vault.drive.download",
         method: "GET",
         path: "/application/open-vault/drive/download/file",
         kind: "download",
         description: "Download vault drive file",
     },
-    vaultRecordList: {
+    "vault.record.list": {
         key: "vault.record.list",
         method: "POST",
         path: "/application/open-vault/record/getList",
@@ -383,14 +436,14 @@ export const ENDPOINTS = {
         description: "List voice recording transcriptions",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    vaultRecordDownload: {
+    "vault.record.download": {
         key: "vault.record.download",
         method: "GET",
         path: "/application/open-vault/record/download/file",
         kind: "download",
         description: "Download voice recording transcription file",
     },
-    vaultMyConferenceList: {
+    "vault.my-conference.list": {
         key: "vault.my-conference.list",
         method: "POST",
         path: "/application/open-vault/my-conference/getList",
@@ -398,14 +451,14 @@ export const ENDPOINTS = {
         description: "List my conferences",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    vaultMyConferenceDownload: {
+    "vault.my-conference.download": {
         key: "vault.my-conference.download",
         method: "GET",
         path: "/application/open-vault/my-conference/download/file",
         kind: "download",
         description: "Download my conference resource",
     },
-    vaultWechatMessageList: {
+    "vault.wechat-message.list": {
         key: "vault.wechat-message.list",
         method: "POST",
         path: "/application/open-vault/wechatgroupmsg/list",
@@ -413,7 +466,7 @@ export const ENDPOINTS = {
         description: "List WeChat group messages",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    vaultWechatChatroomList: {
+    "vault.wechat-chatroom.list": {
         key: "vault.wechat-chatroom.list",
         method: "POST",
         path: "/application/open-vault/wechatgroupmsg/chatroomId",
@@ -421,7 +474,3 @@ export const ENDPOINTS = {
         description: "List WeChat group chatroom IDs",
     },
 };
-export const ENDPOINT_REGISTRY = Object.values(ENDPOINTS).reduce((accumulator, endpoint) => {
-    accumulator[endpoint.key] = endpoint;
-    return accumulator;
-}, {});

package/dist/src/core/output.js

@@ -100,6 +100,70 @@ export function renderOutput(value, format) {
             return renderTable(rows);
     }
 }
+/** Stream large jsonl/csv output row-by-row to avoid building a full string in memory. */
+export async function streamOutputToFile(value, format, outputPath) {
+    if (format !== "jsonl" && format !== "csv")
+        return false;
+    const list = pickListForStreaming(value);
+    if (!list)
+        return false;
+    // Below this row count the join() approach is cheaper than per-row writes.
+    if (list.length < 1000)
+        return false;
+    const { dirname } = await import("node:path");
+    const { createWriteStream } = await import("node:fs");
+    await fs.mkdir(dirname(outputPath), { recursive: true });
+    const stream = createWriteStream(outputPath, { encoding: "utf8" });
+    try {
+        if (format === "jsonl") {
+            for (const item of list) {
+                await writeLine(stream, JSON.stringify(item));
+            }
+        }
+        else {
+            const objectRows = list.filter((row) => Boolean(row && typeof row === "object" && !Array.isArray(row)));
+            const columns = Array.from(new Set(objectRows.flatMap((row) => Object.keys(row))));
+            await writeLine(stream, columns.join(","));
+            for (const row of objectRows) {
+                const cells = columns.map((column) => csvEscape(formatScalar(row[column])));
+                await writeLine(stream, cells.join(","));
+            }
+        }
+    }
+    finally {
+        await new Promise((resolve, reject) => {
+            stream.end((err) => err ? reject(err) : resolve());
+        });
+    }
+    return true;
+}
+function pickListForStreaming(value) {
+    if (Array.isArray(value))
+        return value;
+    if (value && typeof value === "object") {
+        const list = value.list;
+        if (Array.isArray(list))
+            return list;
+    }
+    return null;
+}
+function csvEscape(value) {
+    let out = value;
+    if (/^[=+\-@\t\r]/.test(out))
+        out = "'" + out;
+    if (/[",\n]/.test(out))
+        return `"${out.replaceAll("\"", "\"\"")}"`;
+    return out;
+}
+function writeLine(stream, line) {
+    return new Promise((resolve, reject) => {
+        const ok = stream.write(line + "\n", (err) => err ? reject(err) : undefined);
+        if (ok)
+            resolve();
+        else
+            stream.once("drain", () => resolve());
+    });
+}
 export async function saveOutputIfNeeded(content, outputPath) {
     if (!outputPath) {
         return;

package/dist/src/core/printer.js

@@ -1,5 +1,5 @@
 import { normalizeRows } from "./normalize.js";
-import { renderOutput, saveOutputIfNeeded } from "./output.js";
+import { renderOutput, saveOutputIfNeeded, streamOutputToFile } from "./output.js";
 import { extractTitles, writeTitleCache } from "./titleCache.js";
 export async function printData(data, format, output, cache) {
     const normalized = normalizeRows(data);
@@ -21,11 +21,15 @@ export async function printData(data, format, output, cache) {
             process.stderr.write(`Total: ${meta.total}, showing: ${listLen}\n`);
         }
     }
-    const content = renderOutput(normalized, format);
     if (output) {
+        if (await streamOutputToFile(normalized, format, output)) {
+            process.stdout.write(`${output}\n`);
+            return;
+        }
+        const content = renderOutput(normalized, format);
         await saveOutputIfNeeded(content, output);
         process.stdout.write(`${output}\n`);
         return;
     }
-    process.stdout.write(`${content}\n`);
+    process.stdout.write(`${renderOutput(normalized, format)}\n`);
 }