@fugle/node-twstock 3.0.0-alpha.2 → 3.0.0-alpha.4

package/README.md

@@ -895,8 +895,8 @@ twstock.stocks.splits({ startDate: '2022-07-01', endDate: '2022-07-31', exchange
   * `haltDate`: {string} 停止買賣日期
   * `resumeDate`: {string} 恢復買賣日期
   * `splitRatio`: {number} 每股換發新股比例
-  * `oldFaceValue`: {number} 舊面額 (元)
-  * `newFaceValue`: {number} 新面額 (元)
+  * `parValueBefore`: {number} 變更前面額 (元)
+  * `parValueAfter`: {number} 變更後面額 (元)
   * `referencePrice`: {number} 恢復買賣參考價 (TPEx 提供，TWSE 為 null)
   * **當 `includeDetail=true` 時 (僅適用於 TWSE)，額外包含以下欄位：**
     * `sharesPerOldShare`: {number} 每股換發新股票
@@ -913,8 +913,8 @@ twstock.stocks.splitAnnouncement({ symbol: '1234' })
 //     haltDate: '2026-01-15',
 //     resumeDate: '2026-01-25',
 //     splitRatio: 0.5,
-//     oldFaceValue: 10,
-//     newFaceValue: 5
+//     parValueBefore: 10,
+//     parValueAfter: 5
 //   }
 // ]
 ```

package/lib/interfaces/stock-splits.interface.d.ts

@@ -3,6 +3,7 @@ export interface StockSplits {
     exchange: string;
     symbol: string;
     name: string;
+    splitType: 'split' | 'reverse-split';
     previousClose: number;
     referencePrice: number;
     limitUpPrice: number;

package/lib/interfaces/stocks-split-announcement.interface.d.ts

@@ -5,7 +5,7 @@ export interface StocksSplitAnnouncement {
     haltDate: string;
     resumeDate: string;
     splitRatio: number | null;
-    oldFaceValue: number | null;
-    newFaceValue: number | null;
+    parValueBefore: number | null;
+    parValueAfter: number | null;
     sharesPerOldShare?: number | null;
 }

package/lib/scrapers/tpex-scraper.js

@@ -403,6 +403,7 @@ class TpexScraper extends scraper_1.Scraper {
             data.exchange = enums_1.Exchange.TPEx;
             data.symbol = symbol;
             data.name = name.trim();
+            data.splitType = 'split';
             data.previousClose = numeral(values[0]).value();
             data.referencePrice = numeral(values[1]).value();
             data.limitUpPrice = numeral(values[2]).value();
@@ -429,6 +430,7 @@ class TpexScraper extends scraper_1.Scraper {
             data.exchange = enums_1.Exchange.TPEx;
             data.symbol = symbol;
             data.name = name.trim();
+            data.splitType = 'reverse-split';
             data.previousClose = numeral(values[0]).value();
             data.referencePrice = numeral(values[1]).value();
             data.limitUpPrice = numeral(values[2]).value();
@@ -690,7 +692,7 @@ class TpexScraper extends scraper_1.Scraper {
         if (!json)
             return [];
         const data = json.tables[0].data.map((row) => {
-            const [symbol, name, haltDate, splitRatio, oldFaceValue, newFaceValue, resumeDate,] = row;
+            const [symbol, name, haltDate, splitRatio, parValueBefore, parValueAfter, resumeDate,] = row;
             return {
                 symbol,
                 name: name.trim(),
@@ -698,8 +700,8 @@ class TpexScraper extends scraper_1.Scraper {
                 haltDate: (0, utils_1.rocToWestern)(haltDate),
                 resumeDate: (0, utils_1.rocToWestern)(resumeDate),
                 splitRatio: (0, utils_1.parseNumeric)(splitRatio),
-                oldFaceValue: (0, utils_1.parseNumeric)(oldFaceValue),
-                newFaceValue: (0, utils_1.parseNumeric)(newFaceValue),
+                parValueBefore: (0, utils_1.parseNumeric)(parValueBefore),
+                parValueAfter: (0, utils_1.parseNumeric)(parValueAfter),
             };
         });
         return filterSymbol

package/lib/scrapers/twse-scraper.js

@@ -505,8 +505,8 @@ class TwseScraper extends scraper_1.Scraper {
         data.name = name.trim();
         data.haltDate = (0, utils_1.rocToWestern)(values[0]);
         data.sharesPerOldShare = (0, utils_1.parseNumeric)(values[1]);
-        data.oldFaceValue = (0, utils_1.parseNumeric)(values[2]);
-        data.newFaceValue = (0, utils_1.parseNumeric)(values[3]);
+        data.parValueBefore = (0, utils_1.parseNumeric)(values[2]);
+        data.parValueAfter = (0, utils_1.parseNumeric)(values[3]);
         return data;
     }
     async fetchStocksCapitalReductionAnnouncement(options) {
@@ -607,20 +607,20 @@ class TwseScraper extends scraper_1.Scraper {
             data.exchange = enums_1.Exchange.TWSE;
             data.symbol = symbol;
             data.name = name.trim();
-            data.type = type;
             data.previousClose = (0, utils_1.parseNumeric)(values[0]);
             data.referencePrice = (0, utils_1.parseNumeric)(values[1]);
             data.limitUpPrice = (0, utils_1.parseNumeric)(values[2]);
             data.limitDownPrice = (0, utils_1.parseNumeric)(values[3]);
             data.openingReferencePrice = (0, utils_1.parseNumeric)(values[4]);
+            const inferredType = type || (data.previousClose > data.referencePrice ? '分割' : '反分割');
+            data.splitType = inferredType === '分割' ? 'split' : 'reverse-split';
             return data;
         })
             .filter((row) => {
             if (splitType === 'all')
                 return true;
-            return splitType === 'split' ? row.type === '分割' : row.type === '反分割';
-        })
-            .map((row) => _.omit(row, ['type']));
+            return row.splitType === splitType;
+        });
         return symbol ? data.filter((data) => data.symbol === symbol) : data;
     }
     async fetchStocksSplitAnnouncement(options) {
@@ -636,7 +636,7 @@ class TwseScraper extends scraper_1.Scraper {
         if (!json || !json.data)
             return [];
         const data = await Promise.all(json.data.map(async (row) => {
-            const [haltDate, symbol, name, resumeDate, splitRatio, oldFaceValue, newFaceValue, detailField1, // row[7]: "7780  ,20251230"
+            const [haltDate, symbol, name, resumeDate, splitRatio, parValueBefore, parValueAfter, detailField1, // row[7]: "7780  ,20251230"
             detailField2, // row[8]: "7780  ,20260109,20260119"
             detailField3 // row[9]: ",10.00,1.00"
             ] = row;
@@ -647,8 +647,8 @@ class TwseScraper extends scraper_1.Scraper {
             data.haltDate = (0, utils_1.rocToWestern)(haltDate);
             data.resumeDate = (0, utils_1.rocToWestern)(resumeDate);
             data.splitRatio = (0, utils_1.parseNumeric)(splitRatio);
-            data.oldFaceValue = (0, utils_1.parseNumeric)(oldFaceValue);
-            data.newFaceValue = (0, utils_1.parseNumeric)(newFaceValue);
+            data.parValueBefore = (0, utils_1.parseNumeric)(parValueBefore);
+            data.parValueAfter = (0, utils_1.parseNumeric)(parValueAfter);
             // Extract detail query date from detailField1 (format: "symbol,date")
             // Example: "7780  ,20251230" → extract "20251230"
             let detailQueryDate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugle/node-twstock",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.4",
   "description": "A client library for scraping Taiwan stock market data",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -49,7 +49,7 @@
     "@commitlint/cli": "^16.3.0",
     "@commitlint/config-conventional": "^16.2.4",
     "@release-it/conventional-changelog": "^5.1.1",
-    "@types/jest": "^27.5.2",
+    "@types/jest": "^30.0.0",
     "@types/lodash": "^4.14.200",
     "@types/luxon": "^3.3.6",
     "@types/node": "^16.18.18",
@@ -59,11 +59,11 @@
     "codecov": "^3.8.3",
     "eslint": "^7.32.0",
     "husky": "^7.0.4",
-    "jest": "^27.5.1",
+    "jest": "^30.2.0",
     "jest-mock-axios": "^4.7.3",
     "release-it": "^15.10.0",
     "rimraf": "^3.0.2",
-    "ts-jest": "^27.1.5",
+    "ts-jest": "^29.4.6",
     "ts-node": "^10.9.1",
     "typescript": "^4.9.5"
   }