@onebullex-group/cli 1.3.1 → 1.5.0

package/dist/chunk-SGLPG2FL.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// src/core/download.ts
+import { existsSync, mkdirSync, statSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join, resolve } from "path";
+var DOWNLOAD_PATH = "/v2/system/download";
+var DEFAULT_DOWNLOAD_DIR = join(homedir(), ".onebullex", "downloads");
+function defaultFilename(downloadId) {
+  return `position_history_${downloadId.replace(/[^\w.-]/g, "_")}.xlsx`;
+}
+function resolveTarget(out, filename, cwd = process.cwd()) {
+  if (!out) return join(DEFAULT_DOWNLOAD_DIR, filename);
+  const abs = resolve(cwd, out);
+  const looksLikeDir = /[\\/]$/.test(out) || existsSync(abs) && statSync(abs).isDirectory();
+  return looksLikeDir ? join(abs, filename) : abs;
+}
+async function downloadToFile(opts) {
+  const downloadId = opts.downloadId.trim();
+  if (!downloadId) throw new Error("downloadId is required");
+  const file = await opts.client.getPrivateBinary(DOWNLOAD_PATH, { downloadId });
+  const target = resolveTarget(opts.out, file.filename ?? defaultFilename(downloadId), opts.cwd);
+  mkdirSync(dirname(target), { recursive: true });
+  writeFileSync(target, file.bytes);
+  return {
+    downloadId,
+    path: target,
+    bytes: file.bytes.length,
+    contentType: file.contentType
+  };
+}
+
+export {
+  DOWNLOAD_PATH,
+  DEFAULT_DOWNLOAD_DIR,
+  defaultFilename,
+  resolveTarget,
+  downloadToFile
+};

package/dist/{chunk-NKWXNVLA.js → chunk-YE5LER6U.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
-  OneBullExError
-} from "./chunk-JRUFIHU7.js";
+  generateNonce,
+  sign
+} from "./chunk-LVNSFQXS.js";
 import {
   redactObject
 } from "./chunk-OOLZIYXS.js";
 import {
-  generateNonce,
-  sign
-} from "./chunk-LVNSFQXS.js";
+  OneBullExError
+} from "./chunk-JRUFIHU7.js";
 
 // src/core/http-client.ts
 function flattenForSign(body) {
@@ -46,6 +46,37 @@ var HttpClient = class {
   async postPrivate(path, body) {
     return this.send("POST", path, void 0, body, true, false);
   }
+  /**
+   * 签名 GET，返回原始字节（用于 /v2/system/download 这类文件流接口）。
+   *
+   * 业务错误（文件未就绪、次数超限等）仍以 JSON 返回，此时按普通响应校验并
+   * 抛 OneBullExError；对齐 Java 端 BaseClientV2.executeWithRetryBytes。
+   */
+  async getPrivateBinary(path, query) {
+    return this.withRetry(async () => {
+      const res = await this.request("GET", path, query, void 0, true);
+      const bytes = new Uint8Array(await res.arrayBuffer());
+      const contentType = res.headers.get("content-type") ?? "";
+      if (isJsonBody(contentType, bytes)) {
+        const json = JSON.parse(new TextDecoder().decode(bytes));
+        this.unwrap(json, res.status, path);
+        throw new OneBullExError(
+          "Expected a file stream but the server returned a JSON success body",
+          "UNEXPECTED_JSON",
+          res.status,
+          path
+        );
+      }
+      if (this.cfg.debug) {
+        console.error("[debug response]", `${bytes.length} bytes (${contentType})`);
+      }
+      return {
+        bytes,
+        contentType,
+        filename: parseFilename(res.headers.get("content-disposition"))
+      };
+    });
+  }
   /**
    * GET 请求重试包装：网络错误最多重试 2 次（共 3 次尝试），延迟 300ms / 900ms。
    * OneBullExError（业务错误）不重试。
@@ -66,12 +97,34 @@ var HttpClient = class {
     throw lastErr;
   }
   async send(method, path, query, body, requireAuth, raw) {
+    const res = await this.request(method, path, query, body, requireAuth);
+    const json = await res.json();
+    if (this.cfg.debug) {
+      console.error("[debug response]", JSON.stringify(redactObject(json)));
+    }
+    if (raw) {
+      return json;
+    }
+    return this.unwrap(json, res.status, path);
+  }
+  /** Normalize: V2 API uses "code"/"msg"; some endpoints use "returnCode"/"msgInfo" */
+  unwrap(json, status, path) {
+    const returnCode = json.code ?? json.returnCode;
+    const msgInfo = json.msg ?? json.msgInfo ?? "";
+    if (returnCode !== 0 && returnCode !== "0") {
+      throw new OneBullExError(msgInfo, returnCode ?? "UNKNOWN", status, path);
+    }
+    return json.data;
+  }
+  /** 签名 + 发送，返回 HTTP 层成功（2xx）的 Response，由调用方决定如何解析 body。 */
+  async request(method, path, query, body, requireAuth) {
     const headers = {
       "Content-Type": "application/json",
       Accept: "application/json",
       "User-Agent": "@onebullex-group/cli"
     };
     let url = `${this.cfg.baseUrl}${path}`;
+    if (method === "GET") query = normalizeQuery(query);
     const params = method === "GET" ? { ...query ?? {} } : flattenForSign(body);
     if (requireAuth) {
       if (!this.cfg.apiKey || !this.cfg.secret) {
@@ -124,23 +177,37 @@ var HttpClient = class {
         path
       );
     }
-    const json = await res.json();
-    if (this.cfg.debug) {
-      console.error("[debug response]", JSON.stringify(redactObject(json)));
-    }
-    if (raw) {
-      return json;
-    }
-    const returnCode = json.code ?? json.returnCode;
-    const msgInfo = json.msg ?? json.msgInfo ?? "";
-    if (returnCode !== 0 && returnCode !== "0") {
-      throw new OneBullExError(msgInfo, returnCode ?? "UNKNOWN", res.status, path);
-    }
-    return json.data;
+    return res;
   }
 };
+function normalizeQuery(query) {
+  if (!query || typeof query.direction !== "string") return query;
+  return { ...query, direction: query.direction.toUpperCase() };
+}
+function isJsonBody(contentType, bytes) {
+  if (contentType.toLowerCase().includes("json")) return true;
+  let i = 0;
+  while (i < bytes.length && /\s/.test(String.fromCharCode(bytes[i] ?? 0))) i++;
+  return i < bytes.length && bytes[i] === 123;
+}
+function parseFilename(disposition) {
+  if (!disposition) return void 0;
+  const star = /filename\*\s*=\s*(?:[\w-]+'[^']*')?([^;]+)/i.exec(disposition);
+  const plain = /filename\s*=\s*"?([^";]+)"?/i.exec(disposition);
+  let name = star?.[1] ?? plain?.[1];
+  if (!name) return void 0;
+  try {
+    name = decodeURIComponent(name.trim());
+  } catch {
+    name = name.trim();
+  }
+  const base = name.split(/[\\/]/).pop()?.trim();
+  return base && base !== "." && base !== ".." ? base : void 0;
+}
 
 export {
   flattenForSign,
-  HttpClient
+  HttpClient,
+  normalizeQuery,
+  parseFilename
 };

package/dist/core/bill-no.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 划转幂等单号（billNo）生成与解析。
+ *
+ * `/v2/balance/transfer` 要求调用方提供唯一的 billNo 作为幂等键。文档标注必填，
+ * 但为了 CLI / MCP 两条路的易用性，我们允许省略并在此补一个 UUID v4。
+ *
+ * 幂等语义提醒：自动生成只在"首次发起"时安全。重试同一笔划转必须复用上一次的
+ * billNo，否则服务端会当成两笔新划转。dry-run 预览里展示的就是最终会发出去的
+ * billNo，confirm 时应原样带回。
+ */
+/** 生成一个 `obe-` 前缀的 UUID v4，便于在对账时区分来源。 */
+declare function generateBillNo(): string;
+/**
+ * 解析调用方传入的 billNo：有值则去掉首尾空白后原样返回，
+ * 空/仅空白/未传则生成一个新的。
+ */
+declare function resolveBillNo(supplied: string | undefined | null): string;
+
+export { generateBillNo, resolveBillNo };

package/dist/core/bill-no.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  generateBillNo,
+  resolveBillNo
+} from "../chunk-6DC55RF7.js";
+export {
+  generateBillNo,
+  resolveBillNo
+};

package/dist/core/download.d.ts

@@ -0,0 +1,41 @@
+import { HttpClient } from './http-client.js';
+import './types.js';
+
+/**
+ * 异步导出文件下载（`GET /v2/system/download`）。
+ *
+ * 接口成功时返回文件流（Excel），未就绪/失败/超限时返回 JSON 错误。CLI 命令与
+ * MCP 工具共用这里的落盘逻辑：MCP 不能把二进制塞进 JSON 文本结果，只能写到本地
+ * 再把路径返回给 AI。
+ *
+ * 限制提醒：同一 downloadId 一小时内最多成功下载 5 次 —— 每次调用都会消耗额度，
+ * 不要用它来"轮询"任务是否完成。
+ */
+
+declare const DOWNLOAD_PATH = "/v2/system/download";
+/** `--out` 省略时的落盘目录 */
+declare const DEFAULT_DOWNLOAD_DIR: string;
+interface DownloadResult {
+    downloadId: string;
+    /** 实际写入的绝对路径 */
+    path: string;
+    bytes: number;
+    contentType: string;
+}
+/** 服务端未给出 Content-Disposition 时的文件名，与 Java 端 downloadToFile 一致 */
+declare function defaultFilename(downloadId: string): string;
+/**
+ * 解析最终落盘路径：
+ * - 未给 out → DEFAULT_DOWNLOAD_DIR/<filename>
+ * - out 是已存在的目录，或以 / \ 结尾 → out/<filename>
+ * - 否则 out 视为文件路径
+ */
+declare function resolveTarget(out: string | undefined, filename: string, cwd?: string): string;
+declare function downloadToFile(opts: {
+    client: HttpClient;
+    downloadId: string;
+    out?: string;
+    cwd?: string;
+}): Promise<DownloadResult>;
+
+export { DEFAULT_DOWNLOAD_DIR, DOWNLOAD_PATH, type DownloadResult, defaultFilename, downloadToFile, resolveTarget };

package/dist/core/download.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_DOWNLOAD_DIR,
+  DOWNLOAD_PATH,
+  defaultFilename,
+  downloadToFile,
+  resolveTarget
+} from "../chunk-SGLPG2FL.js";
+export {
+  DEFAULT_DOWNLOAD_DIR,
+  DOWNLOAD_PATH,
+  defaultFilename,
+  downloadToFile,
+  resolveTarget
+};

package/dist/core/http-client.d.ts

@@ -20,12 +20,43 @@ declare class HttpClient {
         raw?: boolean;
     }): Promise<T>;
     postPrivate<T>(path: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * 签名 GET，返回原始字节（用于 /v2/system/download 这类文件流接口）。
+     *
+     * 业务错误（文件未就绪、次数超限等）仍以 JSON 返回，此时按普通响应校验并
+     * 抛 OneBullExError；对齐 Java 端 BaseClientV2.executeWithRetryBytes。
+     */
+    getPrivateBinary(path: string, query?: Query): Promise<BinaryResponse>;
     /**
      * GET 请求重试包装：网络错误最多重试 2 次（共 3 次尝试），延迟 300ms / 900ms。
      * OneBullExError（业务错误）不重试。
      */
     private withRetry;
     private send;
+    /** Normalize: V2 API uses "code"/"msg"; some endpoints use "returnCode"/"msgInfo" */
+    private unwrap;
+    /** 签名 + 发送，返回 HTTP 层成功（2xx）的 Response，由调用方决定如何解析 body。 */
+    private request;
+}
+/**
+ * GET query 归一化，在签名之前执行（签名与 URL 用同一份值）。
+ *
+ * `direction` 在所有 V2 GET 接口里都是大写枚举（游标 `NEXT`/`PREV`，
+ * listUnfinished 的 `BUY`/`SELL`），服务端区分大小写，`next` 会返回
+ * `invalid_direction`。放在这里而不是各命令里，是因为 MCP 路径不经过
+ * commander action。
+ */
+declare function normalizeQuery(query: Query | undefined): Query | undefined;
+interface BinaryResponse {
+    bytes: Uint8Array;
+    contentType: string;
+    /** 从 Content-Disposition 解析出的文件名；服务端未给出时为 undefined */
+    filename?: string;
 }
+/**
+ * 解析 `attachment; filename="x.xlsx"` / `filename*=UTF-8''x.xlsx`。
+ * 只取 basename，防止服务端给出 `../` 之类的路径。
+ */
+declare function parseFilename(disposition: string | null): string | undefined;
 
-export { type FetchFn, HttpClient, type Query, flattenForSign };
+export { type BinaryResponse, type FetchFn, HttpClient, type Query, flattenForSign, normalizeQuery, parseFilename };

package/dist/core/http-client.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env node
 import {
   HttpClient,
-  flattenForSign
-} from "../chunk-NKWXNVLA.js";
-import "../chunk-JRUFIHU7.js";
+  flattenForSign,
+  normalizeQuery,
+  parseFilename
+} from "../chunk-YE5LER6U.js";
+import "../chunk-LVNSFQXS.js";
 import "../chunk-OOLZIYXS.js";
 import "../chunk-ZYO5P4DH.js";
-import "../chunk-LVNSFQXS.js";
+import "../chunk-JRUFIHU7.js";
 export {
   HttpClient,
-  flattenForSign
+  flattenForSign,
+  normalizeQuery,
+  parseFilename
 };