@kodiak-finance/orderly-utils 2.8.30-alpha.0 → 2.8.30

package/dist/index.d.mts

@@ -149,4 +149,45 @@ type FormatNumWithNamespace = typeof formatNum & {
 };
 declare const formatNumWithNamespace: FormatNumWithNamespace;
 
-export { camelCaseToUnderscoreCase, capitalizeString, checkIsNaN, commify, commifyOptional, cutNumber, findLongestCommonSubString, formatNumWithNamespace as formatNum, formatSymbol, getBBOType, getGlobalObject, getPrecisionByNumber, getTPSLDirection, getTimestamp, getTrailingStopPrice, hex2int, int2hex, isSolana, isTestnet, numberToHumanStyle, optimizeSymbolDisplay, parseChainIdToNumber, parseNumStr, praseChainId, praseChainIdToNumber, removeTrailingZeros, subtractDaysFromCurrentDate, timeConvertString, timestampToString, toNonExponential, todpIfNeed, transSymbolformString, windowGuard, zero };
+/**
+ * CSV Export Service
+ * Handles CSV generation for positions, position history, and liquidations with proper formatting and column mapping.
+ * Shared by trading and portfolio packages.
+ */
+interface CSVColumnConfig {
+    key: string;
+    title: string;
+    formatter?: (value: any) => string | number;
+}
+interface ExportOptions {
+    filename: string;
+    columns: CSVColumnConfig[];
+    data: any[];
+}
+/**
+ * Convert data to CSV format
+ */
+declare const generateCSV: (options: ExportOptions) => string;
+/**
+ * Trigger browser download
+ */
+declare const downloadCSV: (csv: string, filename: string) => void;
+/**
+ * Format timestamp to readable date
+ */
+declare const formatTimestamp: (timestamp: number | string) => string;
+/**
+ * Format number with decimal precision
+ */
+declare const formatNumber: (value: any, decimals?: number) => string;
+/**
+ * Format percentage
+ */
+declare const formatPercent: (value: any, decimals?: number) => string;
+declare const getPositionExportColumns: () => CSVColumnConfig[];
+declare const getOrderExportColumns: (tabType: string) => CSVColumnConfig[];
+declare const getPositionHistoryExportColumns: () => CSVColumnConfig[];
+declare const getLiquidationExportColumns: () => CSVColumnConfig[];
+declare const exportToCSVFile: (options: ExportOptions) => void;
+
+export { type ExportOptions, camelCaseToUnderscoreCase, capitalizeString, checkIsNaN, commify, commifyOptional, cutNumber, downloadCSV, exportToCSVFile, findLongestCommonSubString, formatNumWithNamespace as formatNum, formatNumber, formatPercent, formatSymbol, formatTimestamp, generateCSV, getBBOType, getGlobalObject, getLiquidationExportColumns, getOrderExportColumns, getPositionExportColumns, getPositionHistoryExportColumns, getPrecisionByNumber, getTPSLDirection, getTimestamp, getTrailingStopPrice, hex2int, int2hex, isSolana, isTestnet, numberToHumanStyle, optimizeSymbolDisplay, parseChainIdToNumber, parseNumStr, praseChainId, praseChainIdToNumber, removeTrailingZeros, subtractDaysFromCurrentDate, timeConvertString, timestampToString, toNonExponential, todpIfNeed, transSymbolformString, windowGuard, zero };

package/dist/index.d.ts

@@ -149,4 +149,45 @@ type FormatNumWithNamespace = typeof formatNum & {
 };
 declare const formatNumWithNamespace: FormatNumWithNamespace;
 
-export { camelCaseToUnderscoreCase, capitalizeString, checkIsNaN, commify, commifyOptional, cutNumber, findLongestCommonSubString, formatNumWithNamespace as formatNum, formatSymbol, getBBOType, getGlobalObject, getPrecisionByNumber, getTPSLDirection, getTimestamp, getTrailingStopPrice, hex2int, int2hex, isSolana, isTestnet, numberToHumanStyle, optimizeSymbolDisplay, parseChainIdToNumber, parseNumStr, praseChainId, praseChainIdToNumber, removeTrailingZeros, subtractDaysFromCurrentDate, timeConvertString, timestampToString, toNonExponential, todpIfNeed, transSymbolformString, windowGuard, zero };
+/**
+ * CSV Export Service
+ * Handles CSV generation for positions, position history, and liquidations with proper formatting and column mapping.
+ * Shared by trading and portfolio packages.
+ */
+interface CSVColumnConfig {
+    key: string;
+    title: string;
+    formatter?: (value: any) => string | number;
+}
+interface ExportOptions {
+    filename: string;
+    columns: CSVColumnConfig[];
+    data: any[];
+}
+/**
+ * Convert data to CSV format
+ */
+declare const generateCSV: (options: ExportOptions) => string;
+/**
+ * Trigger browser download
+ */
+declare const downloadCSV: (csv: string, filename: string) => void;
+/**
+ * Format timestamp to readable date
+ */
+declare const formatTimestamp: (timestamp: number | string) => string;
+/**
+ * Format number with decimal precision
+ */
+declare const formatNumber: (value: any, decimals?: number) => string;
+/**
+ * Format percentage
+ */
+declare const formatPercent: (value: any, decimals?: number) => string;
+declare const getPositionExportColumns: () => CSVColumnConfig[];
+declare const getOrderExportColumns: (tabType: string) => CSVColumnConfig[];
+declare const getPositionHistoryExportColumns: () => CSVColumnConfig[];
+declare const getLiquidationExportColumns: () => CSVColumnConfig[];
+declare const exportToCSVFile: (options: ExportOptions) => void;
+
+export { type ExportOptions, camelCaseToUnderscoreCase, capitalizeString, checkIsNaN, commify, commifyOptional, cutNumber, downloadCSV, exportToCSVFile, findLongestCommonSubString, formatNumWithNamespace as formatNum, formatNumber, formatPercent, formatSymbol, formatTimestamp, generateCSV, getBBOType, getGlobalObject, getLiquidationExportColumns, getOrderExportColumns, getPositionExportColumns, getPositionHistoryExportColumns, getPrecisionByNumber, getTPSLDirection, getTimestamp, getTrailingStopPrice, hex2int, int2hex, isSolana, isTestnet, numberToHumanStyle, optimizeSymbolDisplay, parseChainIdToNumber, parseNumStr, praseChainId, praseChainIdToNumber, removeTrailingZeros, subtractDaysFromCurrentDate, timeConvertString, timestampToString, toNonExponential, todpIfNeed, transSymbolformString, windowGuard, zero };

package/dist/index.js

@@ -28,8 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   Decimal: () => decimal_default,
   camelCaseToUnderscoreCase: () => camelCaseToUnderscoreCase,
   capitalizeString: () => capitalizeString,
@@ -38,11 +38,21 @@ __export(src_exports, {
   commifyOptional: () => commifyOptional,
   cutNumber: () => cutNumber,
   dayjs: () => import_dayjs.default,
+  downloadCSV: () => downloadCSV,
+  exportToCSVFile: () => exportToCSVFile,
   findLongestCommonSubString: () => findLongestCommonSubString,
   formatNum: () => formatNumWithNamespace,
+  formatNumber: () => formatNumber,
+  formatPercent: () => formatPercent,
   formatSymbol: () => formatSymbol,
+  formatTimestamp: () => formatTimestamp,
+  generateCSV: () => generateCSV,
   getBBOType: () => getBBOType,
   getGlobalObject: () => getGlobalObject,
+  getLiquidationExportColumns: () => getLiquidationExportColumns,
+  getOrderExportColumns: () => getOrderExportColumns,
+  getPositionExportColumns: () => getPositionExportColumns,
+  getPositionHistoryExportColumns: () => getPositionHistoryExportColumns,
   getPrecisionByNumber: () => getPrecisionByNumber,
   getTPSLDirection: () => getTPSLDirection,
   getTimestamp: () => getTimestamp,
@@ -67,7 +77,7 @@ __export(src_exports, {
   windowGuard: () => windowGuard,
   zero: () => zero
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/decimal.ts
 var import_decimal = __toESM(require("decimal.js-light"));
@@ -233,8 +243,7 @@ var import_orderly_types = require("@kodiak-finance/orderly-types");
 var hex2int = (chainId) => parseInt(chainId);
 var int2hex = (chainId) => `0x${chainId.toString(16)}`;
 var praseChainId = (chainId) => {
-  if (typeof chainId === "string")
-    return hex2int(chainId);
+  if (typeof chainId === "string") return hex2int(chainId);
   return chainId;
 };
 var praseChainIdToNumber = (chainId) => {
@@ -472,6 +481,473 @@ formatNumWithNamespace.assetValue = (num) => {
 formatNumWithNamespace.collateral = (num) => {
   return formatNum(4 /* collateral */, 2, num);
 };
+
+// src/csvExport.ts
+var generateCSV = (options) => {
+  const { columns, data } = options;
+  const headers = columns.map((col) => `"${col.title}"`).join(",");
+  const rows = data.map((row) => {
+    return columns.map((col) => {
+      let value = row[col.key];
+      if (col.formatter) {
+        value = col.formatter(value);
+      }
+      const stringValue = String(value != null ? value : "");
+      const escapedValue = stringValue.replace(/"/g, '""');
+      return `"${escapedValue}"`;
+    }).join(",");
+  });
+  return [headers, ...rows].join("\n");
+};
+var downloadCSV = (csv, filename) => {
+  const blob = new Blob([csv], { type: "text/csv;charset=utf-8;" });
+  const link = document.createElement("a");
+  const url = URL.createObjectURL(blob);
+  link.setAttribute("href", url);
+  link.setAttribute("download", `${filename}.csv`);
+  link.style.visibility = "hidden";
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+};
+var formatTimestamp = (timestamp) => {
+  if (!timestamp) return "--";
+  const numTimestamp = Number(timestamp);
+  const date = new Date(
+    numTimestamp > 1e10 ? numTimestamp : numTimestamp * 1e3
+  );
+  return date.toISOString().split("T")[0] + " " + date.toTimeString().slice(0, 8);
+};
+var formatNumber = (value, decimals = 2) => {
+  if (value === null || value === void 0) return "--";
+  const num = Number(value);
+  if (isNaN(num)) return "--";
+  return num.toFixed(decimals);
+};
+var formatPercent = (value, decimals = 2) => {
+  if (value === null || value === void 0) return "--";
+  const num = Number(value);
+  if (isNaN(num)) return "--";
+  return (num * 100).toFixed(decimals) + "%";
+};
+var getPositionExportColumns = () => [
+  { key: "symbol", title: "Symbol" },
+  {
+    key: "position_qty",
+    title: "Position Qty",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "average_open_price",
+    title: "Avg Open Price",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "mark_price",
+    title: "Mark Price",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "settle_price",
+    title: "Settle Price",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "est_liq_price",
+    title: "Est. Liquidation Price",
+    formatter: (v) => v === null ? "--" : formatNumber(v, 4)
+  },
+  {
+    key: "cost_position",
+    title: "Cost Position",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "unsettled_pnl",
+    title: "Unsettled PnL",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "pnl_24_h",
+    title: "PnL 24h",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "leverage",
+    title: "Leverage",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "imr",
+    title: "Initial Margin Ratio",
+    formatter: (v) => formatPercent(v, 4)
+  },
+  {
+    key: "mmr",
+    title: "Maintenance Margin Ratio",
+    formatter: (v) => formatPercent(v, 4)
+  },
+  {
+    key: "IMR_withdraw_orders",
+    title: "IMR with Withdraw Orders",
+    formatter: (v) => formatPercent(v, 4)
+  },
+  {
+    key: "MMR_with_orders",
+    title: "MMR with Orders",
+    formatter: (v) => formatPercent(v, 4)
+  },
+  {
+    key: "pending_long_qty",
+    title: "Pending Long Qty",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "pending_short_qty",
+    title: "Pending Short Qty",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "last_sum_unitary_funding",
+    title: "Last Sum Unitary Funding",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "fee_24_h",
+    title: "Fee 24h",
+    formatter: (v) => formatNumber(v, 8)
+  },
+  {
+    key: "seq",
+    title: "Sequence"
+  },
+  {
+    key: "timestamp",
+    title: "Timestamp",
+    formatter: formatTimestamp
+  },
+  {
+    key: "updated_time",
+    title: "Updated Time",
+    formatter: formatTimestamp
+  }
+];
+var getOrderExportColumns = (tabType) => {
+  if (tabType === "orderHistory") {
+    return [
+      {
+        key: "order_id",
+        title: "Order ID"
+      },
+      { key: "symbol", title: "Symbol" },
+      { key: "side", title: "Side" },
+      { key: "type", title: "Order Type" },
+      { key: "status", title: "Status" },
+      {
+        key: "quantity",
+        title: "Quantity",
+        formatter: (v) => formatNumber(v, 4)
+      },
+      {
+        key: "visible_quantity",
+        title: "Visible Quantity",
+        formatter: (v) => formatNumber(v, 4)
+      },
+      {
+        key: "total_executed_quantity",
+        title: "Total Executed Qty",
+        formatter: (v) => formatNumber(v, 4)
+      },
+      {
+        key: "average_executed_price",
+        title: "Avg Executed Price",
+        formatter: (v) => v === null ? "--" : formatNumber(v, 4)
+      },
+      {
+        key: "total_fee",
+        title: "Fee",
+        formatter: (v) => formatNumber(v, 8)
+      },
+      {
+        key: "fee_asset",
+        title: "Fee Asset"
+      },
+      {
+        key: "realized_pnl",
+        title: "Realized PnL",
+        formatter: (v) => formatNumber(v, 2)
+      },
+      {
+        key: "created_time",
+        title: "Created Time",
+        formatter: formatTimestamp
+      },
+      {
+        key: "updated_time",
+        title: "Updated Time",
+        formatter: formatTimestamp
+      }
+    ];
+  }
+  const baseColumns = [
+    { key: "symbol", title: "Symbol" },
+    {
+      key: "order_id",
+      title: "Order ID"
+    },
+    {
+      key: "user_id",
+      title: "User ID"
+    },
+    { key: "side", title: "Side" },
+    { key: "type", title: "Order Type" },
+    { key: "status", title: "Status" },
+    {
+      key: "price",
+      title: "Price",
+      formatter: (v) => v === null ? "--" : formatNumber(v, 4)
+    },
+    {
+      key: "quantity",
+      title: "Quantity",
+      formatter: (v) => formatNumber(v, 4)
+    },
+    {
+      key: "visible",
+      title: "Visible",
+      formatter: (v) => formatNumber(v, 4)
+    },
+    {
+      key: "visible_quantity",
+      title: "Visible Quantity",
+      formatter: (v) => formatNumber(v, 4)
+    },
+    {
+      key: "executed",
+      title: "Executed",
+      formatter: (v) => formatNumber(v, 4)
+    },
+    {
+      key: "total_executed_quantity",
+      title: "Total Executed Qty",
+      formatter: (v) => formatNumber(v, 4)
+    },
+    {
+      key: "average_executed_price",
+      title: "Avg Executed Price",
+      formatter: (v) => v === null ? "--" : formatNumber(v, 4)
+    },
+    {
+      key: "amount",
+      title: "Amount",
+      formatter: (v) => v === null ? "--" : formatNumber(v, 2)
+    },
+    {
+      key: "total_fee",
+      title: "Fee",
+      formatter: (v) => formatNumber(v, 8)
+    },
+    {
+      key: "fee_asset",
+      title: "Fee Asset"
+    },
+    {
+      key: "realized_pnl",
+      title: "Realized PnL",
+      formatter: (v) => formatNumber(v, 2)
+    },
+    {
+      key: "created_time",
+      title: "Created Time",
+      formatter: formatTimestamp
+    },
+    {
+      key: "updated_time",
+      title: "Updated Time",
+      formatter: formatTimestamp
+    }
+  ];
+  if (tabType === "tp_sl") {
+    baseColumns.splice(6, 0, {
+      key: "trigger_price",
+      title: "Trigger Price",
+      formatter: (v) => formatNumber(v, 4)
+    });
+  }
+  return baseColumns;
+};
+var getPositionHistoryExportColumns = () => [
+  {
+    key: "position_id",
+    title: "Position ID"
+  },
+  { key: "symbol", title: "Symbol" },
+  {
+    key: "position_status",
+    title: "Status"
+  },
+  {
+    key: "type",
+    title: "Type"
+  },
+  {
+    key: "side",
+    title: "Side"
+  },
+  {
+    key: "closed_position_qty",
+    title: "Closed Position Qty",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "max_position_qty",
+    title: "Max Position Qty",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "avg_open_price",
+    title: "Avg Open Price",
+    formatter: (v) => v === null ? "--" : formatNumber(v, 4)
+  },
+  {
+    key: "avg_close_price",
+    title: "Avg Close Price",
+    formatter: (v) => v === null ? "--" : formatNumber(v, 4)
+  },
+  {
+    key: "realized_pnl",
+    title: "Realized PnL",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "accumulated_funding_fee",
+    title: "Accumulated Funding Fee",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "trading_fee",
+    title: "Trading Fee",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "insurance_fund_fee",
+    title: "Insurance Fund Fee",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "liquidator_fee",
+    title: "Liquidator Fee",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "leverage",
+    title: "Leverage",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "open_timestamp",
+    title: "Time Opened",
+    formatter: formatTimestamp
+  },
+  {
+    key: "close_timestamp",
+    title: "Time Closed",
+    formatter: (v) => v ? formatTimestamp(v) : "--"
+  },
+  {
+    key: "last_update_time",
+    title: "Updated Time",
+    formatter: formatTimestamp
+  }
+];
+var getLiquidationExportColumns = () => [
+  {
+    key: "timestamp",
+    title: "Time",
+    formatter: formatTimestamp
+  },
+  {
+    key: "type",
+    title: "Type"
+  },
+  {
+    key: "liquidation_id",
+    title: "Liquidation ID"
+  },
+  {
+    key: "symbol",
+    title: "Symbol"
+  },
+  {
+    key: "position_qty",
+    title: "Position Qty",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "mark_price",
+    title: "Mark Price",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "transfer_price",
+    title: "Transfer Price",
+    formatter: (v) => formatNumber(v, 4)
+  },
+  {
+    key: "liquidator_fee",
+    title: "Liquidator Fee",
+    formatter: (v) => formatNumber(v, 8)
+  },
+  {
+    key: "abs_liquidation_fee",
+    title: "Abs Liquidation Fee",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "insurance_fund_fee",
+    title: "Insurance Fund Fee",
+    formatter: (v) => formatNumber(v, 8)
+  },
+  {
+    key: "abs_insurance_fund_fee",
+    title: "Abs Insurance Fund Fee",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "cost_position_transfer",
+    title: "Cost Position Transfer",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "margin_ratio",
+    title: "Margin Ratio",
+    formatter: (v) => formatPercent(v, 4)
+  },
+  {
+    key: "account_mmr",
+    title: "Account MMR",
+    formatter: (v) => formatPercent(v, 4)
+  },
+  {
+    key: "position_notional",
+    title: "Position Notional",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "collateral_value",
+    title: "Collateral Value",
+    formatter: (v) => formatNumber(v, 2)
+  },
+  {
+    key: "transfer_amount_to_insurance_fund",
+    title: "Transfer Amount to Insurance Fund",
+    formatter: (v) => formatNumber(v, 2)
+  }
+];
+var exportToCSVFile = (options) => {
+  const csv = generateCSV(options);
+  downloadCSV(csv, options.filename);
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Decimal,
@@ -482,11 +958,21 @@ formatNumWithNamespace.collateral = (num) => {
   commifyOptional,
   cutNumber,
   dayjs,
+  downloadCSV,
+  exportToCSVFile,
   findLongestCommonSubString,
   formatNum,
+  formatNumber,
+  formatPercent,
   formatSymbol,
+  formatTimestamp,
+  generateCSV,
   getBBOType,
   getGlobalObject,
+  getLiquidationExportColumns,
+  getOrderExportColumns,
+  getPositionExportColumns,
+  getPositionHistoryExportColumns,
   getPrecisionByNumber,
   getTPSLDirection,
   getTimestamp,