gangtise-openapi-cli 0.42.0 → 0.43.1

package/dist/src/core/download.js

@@ -1,7 +1,7 @@
 import fs from "node:fs/promises";
 import { dirname, extname } from "node:path";
 import { DownloadError } from "./errors.js";
-import { saveOutputIfNeeded, stagingPath } from "./output.js";
+import { saveOutputIfNeeded, stagingPath, trackClaim } from "./output.js";
 import { extractTitles, lookupTitleCache, readTitleCache, TITLE_LOOKUP_SIZE, writeTitleCache } from "./titleCache.js";
 function sanitizeFilename(name) {
     return name.replace(/[/\\:*?"<>|\u0000-\u001f]/g, "_");
@@ -15,6 +15,10 @@ function truncateFilename(name, maxBytes = 200) {
         stem.pop();
     return stem.join("") + ext;
 }
+function trackedClaim(p) {
+    trackClaim(p);
+    return p;
+}
 export async function uniquePath(p) {
     const claim = async (f) => {
         try {
@@ -30,13 +34,13 @@ export async function uniquePath(p) {
     };
     await fs.mkdir(dirname(p) || ".", { recursive: true });
     if (await claim(p))
-        return p;
+        return trackedClaim(p);
     const ext = extname(p);
     const stem = p.slice(0, p.length - ext.length);
     for (let i = 1; i <= 99; i++) {
         const candidate = `${stem}-${i}${ext}`;
         if (await claim(candidate))
-            return candidate;
+            return trackedClaim(candidate);
     }
     throw new DownloadError(`Refusing to overwrite: 100 files already share the name "${p}" — pass --output or clean up the directory`);
 }
@@ -199,7 +203,7 @@ export async function saveDownloadResult(result, fallbackName, output) {
         const autoName = (file.filename ? sanitizeFilename(file.filename) : undefined) ?? (safeFallback + extFromContentType(file.contentType));
         const outputPath = output ?? await uniquePath(truncateFilename(autoName));
         try {
-            await saveOutputIfNeeded(file.data, outputPath);
+            await saveOutputIfNeeded(file.data, outputPath, false);
         }
         catch (error) {
             if (!output)
@@ -212,7 +216,7 @@ export async function saveDownloadResult(result, fallbackName, output) {
     if (typeof file.text === "string") {
         const outputPath = output ?? await uniquePath(truncateFilename(`${safeFallback}.txt`));
         try {
-            await saveOutputIfNeeded(file.text, outputPath);
+            await saveOutputIfNeeded(file.text, outputPath, false);
         }
         catch (error) {
             if (!output)

package/dist/src/core/endpoints.js

@@ -25,13 +25,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/chief-opinion/v2/getList",
         kind: "json",
         description: "List domestic institution chief opinions (brief only; body via detail)",
+        billing: { per: "row", price: 1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "chiefOpinionId",
     },
     "insight.opinion.list-with-content": {
         method: "POST",
         path: "/application/open-insight/chief-opinion/getList",
         kind: "json",
         description: "List domestic institution chief opinions with the full body (v1 list)",
+        billing: { per: "row", price: 30 },
         pagination: { enabled: true, maxPageSize: 50 },
         retry: "no-replay",
     },
@@ -40,6 +43,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/chief-opinion/getDetail",
         kind: "json",
         description: "Get domestic chief opinion bodies by ID (max 20 IDs per call)",
+        billing: { per: "row", price: 30, maxUnits: 20 },
         retry: "no-replay",
         expects: "array",
     },
@@ -48,13 +52,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/summary/v2/getList",
         kind: "json",
         description: "List summaries",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "summaryId",
     },
     "insight.summary.download": {
         method: "GET",
         path: "/application/open-insight/summary/v2/download/file",
         kind: "download",
         description: "Download summary file",
+        billing: { per: "document", price: 50 },
         retry: "no-replay",
     },
     "insight.pamirs-summary.list": {
@@ -63,6 +70,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List Pamirs expert summaries (requires the expert-summary database)",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "summaryId",
     },
     "insight.pamirs-summary.download": {
         method: "GET",
@@ -76,67 +84,88 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/schedule/roadshow/getList",
         kind: "json",
         description: "List roadshows",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.site-visit.list": {
         method: "POST",
         path: "/application/open-insight/schedule/site-visit/getList",
         kind: "json",
         description: "List site visits",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.strategy.list": {
         method: "POST",
         path: "/application/open-insight/schedule/strategy-meeting/getList",
         kind: "json",
         description: "List strategy meetings",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.forum.list": {
         method: "POST",
         path: "/application/open-insight/schedule/forum/getList",
         kind: "json",
         description: "List forums",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.performance-calendar.list": {
         method: "POST",
         path: "/application/open-insight/schedule/performance-calendar/getList",
         kind: "json",
         description: "List earnings calendar events (forecast / express / announcement)",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "performanceReportId",
     },
     "insight.performance-calendar.download": {
         method: "GET",
         path: "/application/open-insight/schedule/performance-calendar/download/file",
         kind: "download",
         description: "Download an earnings report file (A-share 10 credits, HK/US 20)",
+        billing: { per: "document", price: 20 },
     },
     "insight.research.list": {
         method: "POST",
         path: "/application/open-insight/broker-report/getList",
         kind: "json",
         description: "List broker research reports",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "reportId",
     },
     "insight.research.download": {
         method: "GET",
         path: "/application/open-insight/broker-report/download/file",
         kind: "download",
         description: "Download broker research report",
+        billing: { per: "document", price: 10 },
     },
     "insight.foreign-report.list": {
         method: "POST",
         path: "/application/open-insight/foreign-report/getList",
         kind: "json",
         description: "List foreign reports",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "reportId",
     },
     "insight.foreign-report.download": {
         method: "GET",
         path: "/application/open-insight/foreign-report/download/file",
         kind: "download",
         description: "Download foreign report",
+        billing: { per: "document", price: 50 },
         retry: "no-replay",
     },
     "insight.announcement.list": {
@@ -144,52 +173,64 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/announcement/getList",
         kind: "json",
         description: "List A-share announcements",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "announcementId",
     },
     "insight.announcement.download": {
         method: "GET",
         path: "/application/open-insight/announcement/download/file",
         kind: "download",
         description: "Download A-share announcement file",
+        billing: { per: "document", price: 10 },
     },
     "insight.announcement-hk.list": {
         method: "POST",
         path: "/application/open-insight/announcement-hk/getList",
         kind: "json",
         description: "List HK announcements",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "announcementId",
     },
     "insight.announcement-hk.download": {
         method: "GET",
         path: "/application/open-insight/announcement-hk/download/file",
         kind: "download",
         description: "Download HK announcement file",
+        billing: { per: "document", price: 20 },
     },
     "insight.announcement-us.list": {
         method: "POST",
         path: "/application/open-insight/announcement-us/getList",
         kind: "json",
         description: "List US announcements",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "announcementId",
     },
     "insight.announcement-us.download": {
         method: "GET",
         path: "/application/open-insight/announcement-us/download/file",
         kind: "download",
         description: "Download US announcement file",
+        billing: { per: "document", price: 20 },
     },
     "insight.foreign-opinion.list": {
         method: "POST",
         path: "/application/open-insight/foreign-opinion/v2/getList",
         kind: "json",
         description: "List foreign institution opinions (brief only; body via detail)",
+        billing: { per: "row", price: 1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "foreignOpinionId",
     },
     "insight.foreign-opinion.list-with-content": {
         method: "POST",
         path: "/application/open-insight/foreign-opinion/getList",
         kind: "json",
         description: "List foreign institution opinions with the full body (v1 list)",
+        billing: { per: "row", price: 30 },
         pagination: { enabled: true, maxPageSize: 50 },
         retry: "no-replay",
     },
@@ -198,6 +239,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/foreign-opinion/getDetail",
         kind: "json",
         description: "Get foreign opinion bodies by ID (max 20 IDs per call)",
+        billing: { per: "row", price: 30, maxUnits: 20 },
         retry: "no-replay",
         expects: "array",
     },
@@ -206,32 +248,40 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/independent-opinion/getList",
         kind: "json",
         description: "List foreign independent analyst opinions",
+        billing: { per: "row", price: 5 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "independentOpinionId",
+        rowIdUnverified: true,
     },
     "insight.independent-opinion.download": {
         method: "GET",
         path: "/application/open-insight/independent-opinion/download/file",
         kind: "download",
         description: "Download foreign independent opinion file",
+        billing: { per: "document", price: 30 },
     },
     "insight.official-account.list": {
         method: "POST",
         path: "/application/open-insight/officialAccount/getList",
         kind: "json",
         description: "List WeChat official account articles",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "articleId",
     },
     "insight.official-account.download": {
         method: "GET",
         path: "/application/open-insight/officialAccount/download/file",
         kind: "download",
         description: "Download WeChat official account article (txt/HTML)",
+        billing: { per: "document", price: 10 },
     },
     "insight.qa.list": {
         method: "POST",
         path: "/application/open-insight/Q&A-data/getList",
         kind: "json",
         description: "List investor Q&A (conference/interactive/survey) for a security",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 500 },
     },
     "insight.report-image.list": {
@@ -245,7 +295,9 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/summary/highlight/getList",
         kind: "json",
         description: "List meeting highlights (核心要点信息流; content is an HTML fragment)",
+        billing: { per: "row", price: 5 },
         pagination: { enabled: true, maxPageSize: 50, maxWindow: 10000 },
+        rowId: "highlightId",
         retry: "no-replay",
         expects: "list",
     },
@@ -254,6 +306,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/report-image/download/file",
         kind: "download",
         description: "Download a research report image by chunkId",
+        billing: { per: "document", price: 0.1 },
     },
     "reference.securities-search": {
         method: "POST",
@@ -448,12 +501,15 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/earning-forecast",
         kind: "json",
         description: "Query earning forecast (consensus estimates)",
+        billing: { per: "row", price: 0.5, maxUnits: Number.POSITIVE_INFINITY },
+        retry: "no-replay",
     },
     "bond.basic-info": {
         method: "POST",
         path: "/application/open-fundamental/bond/basic-info",
         kind: "json",
         description: "Query bond static profiles (issuance, term, coupon, rating, options)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -462,6 +518,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuer-info",
         kind: "json",
         description: "Query bond issuer profiles (by bond code or issuer name)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -470,6 +527,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-quote/bond/daily-quote-exchange-cfets",
         kind: "json",
         description: "Query bond daily close quotes (exchange + CFETS; dirty/clean price, YTM, duration)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -478,6 +536,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/valuation-shclearing",
         kind: "json",
         description: "Query Shanghai Clearing House bond valuations (price, yield, risk measures)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -486,6 +545,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/cash-flow",
         kind: "json",
         description: "Query bond interest payment and redemption schedule",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -494,6 +554,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/announcement",
         kind: "json",
         description: "Query bond announcements (pageNo/pageSize; the only paged endpoint of the family)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -502,6 +563,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuance-detail",
         kind: "json",
         description: "Query bond issuance and re-issuance records (bidding, pricing, cover ratios)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -510,6 +572,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/rating-overview",
         kind: "json",
         description: "Query bond / issuer / guarantor ratings side by side (max 10 bonds per call)",
+        billing: { per: "row", price: 0.4, maxUnits: 10 },
         retry: "no-replay",
         expects: "list",
     },
@@ -518,6 +581,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/rating-change",
         kind: "json",
         description: "Query bond rating change history (max 10 bonds per call)",
+        billing: { per: "security", price: 0.4, maxUnits: 10 },
         retry: "no-replay",
         expects: "list",
     },
@@ -526,6 +590,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuer-rating-change",
         kind: "json",
         description: "Query issuer rating change history (by bond code or issuer name)",
+        billing: { per: "issuer", price: 0.4, maxUnits: 10 },
         retry: "no-replay",
         expects: "list",
     },
@@ -534,6 +599,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuance-plan",
         kind: "json",
         description: "Query the rate-bond issuance calendar over a date range",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -542,6 +608,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/exercise-notice",
         kind: "json",
         description: "Query put/call exercise schedules and results for option-embedded bonds",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -550,12 +617,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/stock-summary/getList",
         kind: "json",
         description: "Stock highlights (refined research summary per security)",
+        billing: { per: "row", price: 3, maxUnits: 6000 },
+        retry: "no-replay",
+        timeoutMs: 120_000,
     },
     "ai.knowledge-batch": {
         method: "POST",
         path: "/application/open-data/ai/search/knowledge/batch",
         kind: "json",
         description: "Batch knowledge search",
+        billing: { per: "call", price: 10 },
         retry: "no-replay",
     },
     "ai.knowledge-resource.download": {
@@ -569,6 +640,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/security-clue/getList",
         kind: "json",
         description: "List security clues",
+        billing: { per: "row", price: 5 },
         pagination: { enabled: true, maxPageSize: 500 },
     },
     "ai.one-pager": {
@@ -576,6 +648,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/one-pager",
         kind: "json",
         description: "Generate one pager",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -584,6 +657,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/investment-logic",
         kind: "json",
         description: "Generate investment logic",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -592,6 +666,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/peer-comparison",
         kind: "json",
         description: "Generate peer comparison",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -600,6 +675,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/earnings-review-getid",
         kind: "json",
         description: "Get earnings review ID",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "ai.earnings-review.get-content": {
@@ -613,6 +689,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/theme-tracking",
         kind: "json",
         description: "Get theme tracking daily report",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -621,6 +698,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/research-outline",
         kind: "json",
         description: "Get company research outline",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -629,6 +707,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/hot-topic/getList",
         kind: "json",
         description: "List hot topic reports",
+        billing: { per: "row", price: 50 },
         pagination: { enabled: true, maxPageSize: 20 },
         retry: "no-replay",
     },
@@ -637,6 +716,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/management-discuss/from-announcement",
         kind: "json",
         description: "Management discussion from financial reports (half-year/annual)",
+        billing: { per: "call", price: 10 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -645,6 +725,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/management-discuss/from-earningsCall",
         kind: "json",
         description: "Management discussion from earnings calls",
+        billing: { per: "call", price: 10 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -653,6 +734,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/viewpoint-debate-getid",
         kind: "json",
         description: "Get viewpoint debate ID",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "ai.viewpoint-debate.get-content": {
@@ -667,6 +749,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List vault drive files",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "fileId",
     },
     "vault.drive.download": {
         method: "GET",
@@ -745,6 +828,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List voice recording transcriptions",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "recordId",
     },
     "vault.record.download": {
         method: "GET",
@@ -757,13 +841,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/my-conference/getList",
         kind: "json",
         description: "List my conferences",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "conferenceId",
     },
     "vault.my-conference.download": {
         method: "GET",
         path: "/application/open-vault/my-conference/download/file",
         kind: "download",
         description: "Download my conference resource",
+        billing: { per: "document", price: 50 },
         retry: "no-replay",
     },
     "vault.wechat-message.list": {
@@ -771,7 +858,8 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/wechatgroupmsg/list",
         kind: "json",
         description: "List WeChat group messages",
-        pagination: { enabled: true, maxPageSize: 50 },
+        pagination: { enabled: true, maxPageSize: 50, maxWindow: 10000 },
+        rowId: "msgId",
     },
     "vault.wechat-chatroom.list": {
         method: "POST",
@@ -779,6 +867,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List WeChat group chatroom IDs",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "chatroomId",
     },
     "vault.stock-pool.list": {
         method: "POST",
@@ -844,6 +933,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/v2/info",
         kind: "json",
         description: "Query latest concept (theme index) profile by conceptId",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "alternative.concept-info-full": {
@@ -851,6 +941,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/info",
         kind: "json",
         description: "Query latest concept profile incl. catalyst events (keyEvents; v1)",
+        billing: { per: "call", price: 500 },
         retry: "no-replay",
     },
     "alternative.concept-securities": {
@@ -858,6 +949,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/v2/securities",
         kind: "json",
         description: "Query concept (theme index) constituent securities, grouped",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "alternative.concept-securities-full": {
@@ -865,6 +957,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/securities",
         kind: "json",
         description: "Query concept constituents incl. isKey / inclusionReason (v1)",
+        billing: { per: "call", price: 500 },
         retry: "no-replay",
     },
     "indicator.search": {
@@ -900,6 +993,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-tool/file-parse/submit",
         kind: "upload",
         description: "Submit a PDF for parsing (multipart upload), returns taskId",
+        billing: { per: "page", price: 0.8 },
         timeoutMs: 300_000,
         retry: "no-replay",
         bigIntFields: ["taskId"],
@@ -915,10 +1009,18 @@ const ENDPOINT_DEFS = {
         path: "/application/open-tool/web-search/search",
         kind: "json",
         description: "Search the public web for research (tiered sources, optional page content)",
+        billing: { per: "call", price: 1 },
         retry: "no-replay",
         expects: "list",
     },
 };
+export const NO_REPLAY_ABOVE_CREDITS = 3000;
+export function worstRequestCredits(endpoint) {
+    if (!endpoint.billing)
+        return 0;
+    const units = endpoint.pagination?.maxPageSize ?? endpoint.billing.maxUnits ?? 1;
+    return units * endpoint.billing.price;
+}
 export const ENDPOINTS = Object.fromEntries(Object.entries(ENDPOINT_DEFS).map(([key, def]) => [key, { key, ...def }]));
 export function listEndpoints() {
     return Object.values(ENDPOINTS).map(({ key, method, path, description }) => ({ key, method, path, description }));

package/dist/src/core/opinionDetail.js

@@ -1,4 +1,4 @@
-import { ApiError, ValidationError } from "./errors.js";
+import { ApiError, markStructural, ValidationError } from "./errors.js";
 export async function fetchOpinionDetails(client, endpointKey, idListField, idField, ids) {
     const BATCH = 20;
     const unique = [...new Set(ids)];
@@ -7,18 +7,28 @@ export async function fetchOpinionDetails(client, endpointKey, idListField, idFi
     const list = [];
     let unfetched = [];
     let unfetchedError;
+    let nulls = 0;
     for (let i = 0; i < unique.length; i += BATCH) {
         try {
             const rows = await client.call(endpointKey, { [idListField]: unique.slice(i, i + BATCH) });
-            list.push(...rows);
+            const bodies = rows.filter((row) => row !== null && typeof row === "object" && !Array.isArray(row));
+            const odd = rows.filter((row) => row !== null && (typeof row !== "object" || Array.isArray(row))).length;
+            list.push(...bodies);
+            if (odd > 0) {
+                throw markStructural(new ApiError(`${endpointKey} returned ${odd} non-object element(s) in its body list — the response layout may have changed`, undefined, undefined, rows));
+            }
+            nulls += rows.length - bodies.length;
         }
         catch (error) {
-            if (i === 0)
+            if (i === 0 && list.length === 0)
                 throw error;
-            unfetched = unique.slice(i);
+            const kept = new Set(list.map((row) => String(row[idField])));
+            unfetched = unique.slice(i).filter((id) => !kept.has(id));
             const message = error instanceof Error ? error.message : String(error);
             unfetchedError = { message, ...(error instanceof ApiError ? { code: error.code, traceId: error.traceId } : {}) };
-            process.stderr.write(`[gangtise] warning: ${endpointKey} failed on batch ${i / BATCH + 1} (${message}); ${unfetched.length} ID(s) not fetched: ${unfetched.join(", ")}. The bodies already returned are kept below — re-run for the IDs in unfetchedIds only.\n`);
+            process.stderr.write(unfetched.length > 0
+                ? `[gangtise] warning: ${endpointKey} failed on batch ${i / BATCH + 1} (${message}); ${unfetched.length} ID(s) not fetched: ${unfetched.join(", ")}. The bodies already returned are kept below — re-run for the IDs in unfetchedIds only.\n`
+                : `[gangtise] warning: ${message} (batch ${i / BATCH + 1}); every ID in it came back with a body.\n`);
             break;
         }
     }
@@ -26,7 +36,7 @@ export async function fetchOpinionDetails(client, endpointKey, idListField, idFi
     const missing = unique.filter((id) => !returned.has(id) && !unfetched.includes(id));
     const out = { total: list.length, list };
     if (missing.length > 0) {
-        process.stderr.write(`[gangtise] warning: no body returned for ${missing.length} ID(s): ${missing.join(", ")} — the server skips an ID it has no body for without an error (e.g. a wrong ID; a just-published opinion may also not have its body yet). Result marked partial (exit 3).\n`);
+        process.stderr.write(`[gangtise] warning: no body returned for ${missing.length} ID(s): ${missing.join(", ")}${nulls > 0 ? ` (${nulls} came back as a null element)` : ""} — the server gives no error for an ID it has no body for (e.g. a wrong ID; a just-published opinion may also not have its body yet). Result marked partial (exit 3).\n`);
         out.missingIds = missing;
     }
     if (unfetched.length > 0) {