@fugle/node-twstock 2.2.1-alpha.0

package/lib/utils/as-index.util.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asIndex = void 0;
+const enums_1 = require("../enums");
+function asIndex(index) {
+    const indices = {
+        '發行量加權股價指數': enums_1.Index.TAIEX,
+        '未含金融指數': enums_1.Index.NonFinance,
+        '未含電子指數': enums_1.Index.NonElectronics,
+        '未含金融電子指數': enums_1.Index.NonFinanceNonElectronics,
+        '水泥類指數': enums_1.Index.Cement,
+        '食品類指數': enums_1.Index.Food,
+        '塑膠類指數': enums_1.Index.Plastic,
+        '水泥窯製類指數': enums_1.Index.CementAndCeramic,
+        '塑膠化工類指數': enums_1.Index.PlasticAndChemical,
+        '機電類指數': enums_1.Index.Electrical,
+        '紡織纖維類指數': enums_1.Index.Textiles,
+        '電機機械類指數': enums_1.Index.ElectricMachinery,
+        '電器電纜類指數': enums_1.Index.ElectricalAndCable,
+        '化學生技醫療類指數': enums_1.Index.ChemicalBiotechnologyAndMedicalCare,
+        '化學類指數': enums_1.Index.Chemical,
+        '生技醫療類指數': enums_1.Index.BiotechnologyAndMedicalCare,
+        '玻璃陶瓷類指數': enums_1.Index.GlassAndCeramic,
+        '造紙類指數': enums_1.Index.PaperAndPulp,
+        '鋼鐵類指數': enums_1.Index.IronAndSteel,
+        '橡膠類指數': enums_1.Index.Rubber,
+        '汽車類指數': enums_1.Index.Automobile,
+        '電子工業類指數': enums_1.Index.Electronics,
+        '半導體類指數': enums_1.Index.Semiconductors,
+        '電腦及週邊設備類指數': enums_1.Index.ComputerAndPeripheralEquipment,
+        '光電類指數': enums_1.Index.Optoelectronics,
+        '通信網路類指數': enums_1.Index.CommunicationsTechnologyAndInternet,
+        '電子零組件類指數': enums_1.Index.ElectronicPartsComponents,
+        '電子通路類指數': enums_1.Index.ElectronicProductsDistirbution,
+        '資訊服務類指數': enums_1.Index.InformationService,
+        '其他電子類指數': enums_1.Index.OtherElectronics,
+        '建材營造類指數': enums_1.Index.BuildingMaterialsAndConstruction,
+        '航運類指數': enums_1.Index.ShippingAndTransportation,
+        '觀光餐旅類指數': enums_1.Index.TourismAndHospitality,
+        '金融保險類指數': enums_1.Index.FinancialAndInsurance,
+        '貿易百貨類指數': enums_1.Index.TradingAndConsumerGoods,
+        '油電燃氣類指數': enums_1.Index.OilGasAndElectricity,
+        '其他類指數': enums_1.Index.Other,
+        '綠能環保類指數': enums_1.Index.GreenEnergyAndEnvironmentalServices,
+        '數位雲端類指數': enums_1.Index.DigitalAndCloudServices,
+        '運動休閒類指數': enums_1.Index.SportsAndLeisure,
+        '居家生活類指數': enums_1.Index.Household,
+        '櫃買指數': enums_1.Index.TPEX,
+        '櫃買紡纖類指數': enums_1.Index.TPExTextiles,
+        '櫃買機械類指數': enums_1.Index.TPExElectricMachinery,
+        '櫃買鋼鐵類指數': enums_1.Index.TPExIronAndSteel,
+        '櫃買電子類指數': enums_1.Index.TPExElectronic,
+        '櫃買營建類指數': enums_1.Index.TPExBuildingMaterialsAndConstruction,
+        '櫃買航運類指數': enums_1.Index.TPExShippingAndTransportation,
+        '櫃買觀光餐旅類指數': enums_1.Index.TPExTourismAndHospitality,
+        '櫃買化工類指數': enums_1.Index.TPExChemical,
+        '櫃買生技醫療類指數': enums_1.Index.TPExBiotechnologyAndMedicalCare,
+        '櫃買半導體類指數': enums_1.Index.TPExSemiconductors,
+        '櫃買電腦及週邊類指數': enums_1.Index.TPExComputerAndPeripheralEquipment,
+        '櫃買光電業類指數': enums_1.Index.TPExOptoelectronic,
+        '櫃買通信網路類指數': enums_1.Index.TPExCommunicationsAndInternet,
+        '櫃買電子零組件類指數': enums_1.Index.TPExElectronicPartsComponents,
+        '櫃買電子通路類指數': enums_1.Index.TPExElectronicProductsDistribution,
+        '櫃買資訊服務類指數': enums_1.Index.TPExInformationService,
+        '櫃買文化創意業類指數': enums_1.Index.TPExCulturalAndCreative,
+        '櫃買其他電子類指數': enums_1.Index.TPExOtherElectronic,
+        '櫃買其他類指數': enums_1.Index.TPExOther,
+        '櫃買綠能環保類指數': enums_1.Index.TPExGreenEnergyAndEnvironmentalServices,
+        '櫃買數位雲端類指數': enums_1.Index.TPExDigitalAndCloudServices,
+        '櫃買居家生活類指數': enums_1.Index.TPExHousehold,
+        /* 其他別稱 */
+        '加權股價': enums_1.Index.TAIEX,
+        '未含金融': enums_1.Index.NonFinance,
+        '未含電子': enums_1.Index.NonElectronics,
+        '未含金融電子': enums_1.Index.NonFinanceNonElectronics,
+        '綜合平均': '綜合平均',
+        '工業平均': '工業平均',
+        '水泥類': enums_1.Index.Cement,
+        '水泥工業': enums_1.Index.Cement,
+        '水泥工業類': enums_1.Index.Cement,
+        '食品類': enums_1.Index.Food,
+        '食品工業': enums_1.Index.Food,
+        '食品工業類': enums_1.Index.Food,
+        '塑膠類': enums_1.Index.Plastic,
+        '塑膠工業': enums_1.Index.Plastic,
+        '塑膠工業類': enums_1.Index.Plastic,
+        '紡織纖維': enums_1.Index.Textiles,
+        '紡織纖維類': enums_1.Index.Textiles,
+        '電機機械': enums_1.Index.ElectricMachinery,
+        '電機機械類': enums_1.Index.ElectricMachinery,
+        '電器電纜': enums_1.Index.ElectricalAndCable,
+        '電器電纜類': enums_1.Index.ElectricalAndCable,
+        '化學工業類': enums_1.Index.ChemicalBiotechnologyAndMedicalCare,
+        '化學生技醫': enums_1.Index.ChemicalBiotechnologyAndMedicalCare,
+        '化學生技醫療': enums_1.Index.ChemicalBiotechnologyAndMedicalCare,
+        '化學生技醫療類': enums_1.Index.ChemicalBiotechnologyAndMedicalCare,
+        '玻璃陶瓷': enums_1.Index.GlassAndCeramic,
+        '玻璃陶瓷類': enums_1.Index.GlassAndCeramic,
+        '造紙類': enums_1.Index.PaperAndPulp,
+        '造紙工業': enums_1.Index.PaperAndPulp,
+        '造紙工業類': enums_1.Index.PaperAndPulp,
+        '鋼鐵類': enums_1.Index.IronAndSteel,
+        '鋼鐵工業': enums_1.Index.IronAndSteel,
+        '鋼鐵工業類': enums_1.Index.IronAndSteel,
+        '橡膠類': enums_1.Index.Rubber,
+        '橡膠工業': enums_1.Index.Rubber,
+        '橡膠工業類': enums_1.Index.Rubber,
+        '汽車類': enums_1.Index.Automobile,
+        '汽車工業': enums_1.Index.Automobile,
+        '汽車工業類': enums_1.Index.Automobile,
+        '電子類': enums_1.Index.Electronics,
+        '電子工業': enums_1.Index.Electronics,
+        '電子工業類': enums_1.Index.Electronics,
+        '建材營造': enums_1.Index.BuildingMaterialsAndConstruction,
+        '營造建材類': enums_1.Index.BuildingMaterialsAndConstruction,
+        '建材營造類': enums_1.Index.BuildingMaterialsAndConstruction,
+        '運輸類': enums_1.Index.ShippingAndTransportation,
+        '航運業': enums_1.Index.ShippingAndTransportation,
+        '航運業類': enums_1.Index.ShippingAndTransportation,
+        '觀光類': enums_1.Index.TourismAndHospitality,
+        '觀光事業': enums_1.Index.TourismAndHospitality,
+        '觀光事業類': enums_1.Index.TourismAndHospitality,
+        '金融保險': enums_1.Index.FinancialAndInsurance,
+        '金融保險類': enums_1.Index.FinancialAndInsurance,
+        '貿易百貨': enums_1.Index.TradingAndConsumerGoods,
+        '百貨貿易類': enums_1.Index.TradingAndConsumerGoods,
+        '貿易百貨類': enums_1.Index.TradingAndConsumerGoods,
+        '百貨貿易類指數': enums_1.Index.TradingAndConsumerGoods,
+        '其它': enums_1.Index.Other,
+        '其它類': enums_1.Index.Other,
+        '其他': enums_1.Index.Other,
+        '其他類': enums_1.Index.Other,
+        '化學工業': enums_1.Index.Chemical,
+        '生技醫療': enums_1.Index.BiotechnologyAndMedicalCare,
+        '油電燃氣': enums_1.Index.OilGasAndElectricity,
+        '半導體': enums_1.Index.Semiconductors,
+        '電腦及週邊設備': enums_1.Index.ComputerAndPeripheralEquipment,
+        '光電': enums_1.Index.Optoelectronics,
+        '通信網路': enums_1.Index.CommunicationsTechnologyAndInternet,
+        '電子零組件': enums_1.Index.ElectronicPartsComponents,
+        '電子通路': enums_1.Index.ElectronicProductsDistirbution,
+        '資訊服務': enums_1.Index.InformationService,
+        '其他電子': enums_1.Index.OtherElectronics,
+        '未含金融保險股指數': enums_1.Index.NonFinance,
+        '未含電子股指數': enums_1.Index.NonElectronics,
+        '未含金融電子股指數': enums_1.Index.NonFinanceNonElectronics,
+        '電子類指數': enums_1.Index.Electronics,
+        '觀光類指數': enums_1.Index.TourismAndHospitality,
+        '航運業類指數': enums_1.Index.ShippingAndTransportation,
+        '觀光事業類指數': enums_1.Index.TourismAndHospitality,
+        '櫃買觀光類指數': enums_1.Index.TPExTourismAndHospitality,
+        '櫃買生技類指數': enums_1.Index.TPExBiotechnologyAndMedicalCare,
+        '櫃買電腦週邊類指數': enums_1.Index.TPExComputerAndPeripheralEquipment,
+        '櫃買光電類指數': enums_1.Index.TPExOptoelectronic,
+        '櫃買電子零件類指數': enums_1.Index.TPExElectronicPartsComponents,
+        '櫃買文化創意類指數': enums_1.Index.TPExCulturalAndCreative,
+        '櫃買紡織纖維類指數': enums_1.Index.TPExTextiles,
+        '櫃買電機機械類指數': enums_1.Index.TPExElectricMachinery,
+        '櫃買鋼鐵工業類指數': enums_1.Index.TPExIronAndSteel,
+        '櫃買建材營造類指數': enums_1.Index.TPExBuildingMaterialsAndConstruction,
+        '櫃買航運業類指數': enums_1.Index.TPExShippingAndTransportation,
+        '櫃買化學工業類指數': enums_1.Index.TPExChemical,
+        '櫃買半導體業類指數': enums_1.Index.TPExSemiconductors,
+        '櫃買電腦週邊業類指數': enums_1.Index.TPExComputerAndPeripheralEquipment,
+        '櫃買通信網路業類指數': enums_1.Index.TPExCommunicationsAndInternet,
+        '櫃買電子零組件業類指數': enums_1.Index.TPExElectronicPartsComponents,
+        '櫃買電子通路業類指數': enums_1.Index.TPExElectronicProductsDistribution,
+        '櫃買資訊服務業類指數': enums_1.Index.TPExInformationService,
+        '櫃買其他電子業類指數': enums_1.Index.TPExOtherElectronic,
+        '櫃買電子工業類指數': enums_1.Index.TPExElectronic,
+        '櫃買電腦及週邊設備業類指數': enums_1.Index.TPExComputerAndPeripheralEquipment,
+        '櫃買觀光事業類指數': enums_1.Index.TPExTourismAndHospitality,
+        '櫃買紡纖纖維類指數': enums_1.Index.TPExTextiles,
+        '櫃買線上遊戲類指數': enums_1.Index.TPExGame,
+    };
+    return indices[index];
+}
+exports.asIndex = asIndex;

package/lib/utils/as-industry.util.d.ts

@@ -0,0 +1,2 @@
+import { Industry } from '../enums';
+export declare function asIndustry(industry: string): Industry;

package/lib/utils/as-industry.util.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asIndustry = void 0;
+const enums_1 = require("../enums");
+function asIndustry(industry) {
+    var _a;
+    const industries = {
+        '水泥工業': enums_1.Industry.Cement,
+        '食品工業': enums_1.Industry.Food,
+        '塑膠工業': enums_1.Industry.Plastic,
+        '紡織纖維': enums_1.Industry.Textiles,
+        '電機機械': enums_1.Industry.ElectricMachinery,
+        '電器電纜': enums_1.Industry.ElectricalAndCable,
+        '玻璃陶瓷': enums_1.Industry.GlassAndCeramic,
+        '造紙工業': enums_1.Industry.PaperAndPulp,
+        '鋼鐵工業': enums_1.Industry.IronAndSteel,
+        '橡膠工業': enums_1.Industry.Rubber,
+        '汽車工業': enums_1.Industry.Automobile,
+        '建材營造業': enums_1.Industry.BuildingMaterialsAndConstruction,
+        '航運業': enums_1.Industry.ShippingAndTransportation,
+        '觀光餐旅': enums_1.Industry.TourismAndHospitality,
+        '金融保險業': enums_1.Industry.FinancialAndInsurance,
+        '貿易百貨業': enums_1.Industry.TradingAndConsumerGoods,
+        '綜合': enums_1.Industry.Miscellaneous,
+        '其他業': enums_1.Industry.Other,
+        '化學工業': enums_1.Industry.Chemical,
+        '生技醫療業': enums_1.Industry.BiotechnologyAndMedicalCare,
+        '油電燃氣業': enums_1.Industry.OilGasAndElectricity,
+        '半導體業': enums_1.Industry.Semiconductors,
+        '電腦及週邊設備業': enums_1.Industry.ComputerAndPeripheralEquipment,
+        '光電業': enums_1.Industry.Optoelectronics,
+        '通信網路業': enums_1.Industry.CommunicationsTechnologyAndInternet,
+        '電子零組件業': enums_1.Industry.ElectronicPartsComponents,
+        '電子通路業': enums_1.Industry.ElectronicProductsDistirbution,
+        '資訊服務業': enums_1.Industry.InformationService,
+        '其他電子業': enums_1.Industry.OtherElectronics,
+        '文化創意業': enums_1.Industry.CulturalAndCreative,
+        '農業科技業': enums_1.Industry.AgriculturalTechnology,
+        '電子商務': enums_1.Industry.Ecommerce,
+        '綠能環保': enums_1.Industry.GreenEnergyAndEnvironmentalServices,
+        '數位雲端': enums_1.Industry.DigitalAndCloudServices,
+        '運動休閒': enums_1.Industry.SportsAndLeisure,
+        '居家生活': enums_1.Industry.Household,
+        '管理股票': enums_1.Industry.ManagedStock,
+        '無所屬產業': enums_1.Industry.None,
+    };
+    return (_a = industries[industry]) !== null && _a !== void 0 ? _a : enums_1.Industry.None;
+}
+exports.asIndustry = asIndustry;

package/lib/utils/date-converter.util.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Convert ROC (Republic of China) date to Western (Gregorian) calendar date
+ *
+ * @param rocDate - ROC date string in formats:
+ *   - "114年01月02日" (year/month/day with Chinese characters)
+ *   - "114/01/02" (slash format)
+ *   - "114年1月2日" (without leading zeros)
+ * @returns ISO format date string "YYYY-MM-DD" or original string if format not recognized
+ *
+ * @example
+ * rocToWestern("114年01月02日") // "2025-01-02"
+ * rocToWestern("114/01/02")     // "2025-01-02"
+ * rocToWestern("114年1月2日")   // "2025-01-02"
+ */
+export declare function rocToWestern(rocDate: string): string;
+/**
+ * Convert Western (Gregorian) calendar date to ROC (Republic of China) date
+ *
+ * @param westernDate - Western date string in ISO format "YYYY-MM-DD"
+ * @param format - Output format: "chinese" (default) or "slash"
+ * @returns ROC date string or original string if format not recognized
+ *
+ * @example
+ * westernToRoc("2025-01-02")              // "114年01月02日"
+ * westernToRoc("2025-01-02", "slash")     // "114/01/02"
+ * westernToRoc("2025-01-02", "chinese")   // "114年01月02日"
+ */
+export declare function westernToRoc(westernDate: string, format?: 'chinese' | 'slash'): string;
+/**
+ * Parse financial report date that may contain HTML link
+ *
+ * @param value - Date string that may contain HTML link in parentheses
+ *   - "113年06月28日(https://mops.twse.com.tw/mops/web/t78sb35)" (date format)
+ *   - "114年第3季(https://mops.twse.com.tw/mops/web/t163sb01)" (quarterly format)
+ *   - "113年06月28日" (date without link)
+ *   - "114年第3季" (quarter without link)
+ *   - "N/A" or empty string
+ * @returns ISO format date string "YYYY-MM-DD", quarterly string "XXX年第X季", or null
+ *
+ * @example
+ * parseFinancialReportDate("113年06月28日(https://...)") // "2024-06-28"
+ * parseFinancialReportDate("114年第3季(https://...)")     // "114年第3季"
+ * parseFinancialReportDate("113年06月28日")             // "2024-06-28"
+ * parseFinancialReportDate("114年第1季")                 // "114年第1季"
+ * parseFinancialReportDate("N/A")                        // null
+ */
+export declare function parseFinancialReportDate(value: string): string | null;

package/lib/utils/date-converter.util.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFinancialReportDate = exports.westernToRoc = exports.rocToWestern = void 0;
+/**
+ * Convert ROC (Republic of China) date to Western (Gregorian) calendar date
+ *
+ * @param rocDate - ROC date string in formats:
+ *   - "114年01月02日" (year/month/day with Chinese characters)
+ *   - "114/01/02" (slash format)
+ *   - "114年1月2日" (without leading zeros)
+ * @returns ISO format date string "YYYY-MM-DD" or original string if format not recognized
+ *
+ * @example
+ * rocToWestern("114年01月02日") // "2025-01-02"
+ * rocToWestern("114/01/02")     // "2025-01-02"
+ * rocToWestern("114年1月2日")   // "2025-01-02"
+ */
+function rocToWestern(rocDate) {
+    if (!rocDate || typeof rocDate !== 'string') {
+        return rocDate;
+    }
+    // Format: "114年01月02日" or "114年1月2日"
+    const yearMonthDayMatch = rocDate.match(/(\d+)年(\d+)月(\d+)日/);
+    if (yearMonthDayMatch) {
+        const [, year, month, day] = yearMonthDayMatch;
+        const westernYear = parseInt(year) + 1911;
+        return `${westernYear}-${month.padStart(2, '0')}-${day.padStart(2, '0')}`;
+    }
+    // Format: "114/01/02" or "114/1/2"
+    const slashMatch = rocDate.match(/^(\d+)\/(\d+)\/(\d+)$/);
+    if (slashMatch) {
+        const [, year, month, day] = slashMatch;
+        const westernYear = parseInt(year) + 1911;
+        return `${westernYear}-${month.padStart(2, '0')}-${day.padStart(2, '0')}`;
+    }
+    // Format: "1141231" (YYYMMDD - 3-digit year + 2-digit month + 2-digit day)
+    const compactMatch = rocDate.match(/^(\d{3})(\d{2})(\d{2})$/);
+    if (compactMatch) {
+        const [, year, month, day] = compactMatch;
+        const westernYear = parseInt(year) + 1911;
+        return `${westernYear}-${month}-${day}`;
+    }
+    // Return original if format not recognized
+    return rocDate;
+}
+exports.rocToWestern = rocToWestern;
+/**
+ * Convert Western (Gregorian) calendar date to ROC (Republic of China) date
+ *
+ * @param westernDate - Western date string in ISO format "YYYY-MM-DD"
+ * @param format - Output format: "chinese" (default) or "slash"
+ * @returns ROC date string or original string if format not recognized
+ *
+ * @example
+ * westernToRoc("2025-01-02")              // "114年01月02日"
+ * westernToRoc("2025-01-02", "slash")     // "114/01/02"
+ * westernToRoc("2025-01-02", "chinese")   // "114年01月02日"
+ */
+function westernToRoc(westernDate, format = 'chinese') {
+    if (!westernDate || typeof westernDate !== 'string') {
+        return westernDate;
+    }
+    // Format: "YYYY-MM-DD"
+    const match = westernDate.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!match) {
+        return westernDate;
+    }
+    const [, year, month, day] = match;
+    const rocYear = parseInt(year) - 1911;
+    if (rocYear < 1) {
+        // Date before 1912 cannot be represented in ROC calendar
+        return westernDate;
+    }
+    if (format === 'slash') {
+        return `${rocYear}/${month}/${day}`;
+    }
+    return `${rocYear}年${month}月${day}日`;
+}
+exports.westernToRoc = westernToRoc;
+/**
+ * Parse financial report date that may contain HTML link
+ *
+ * @param value - Date string that may contain HTML link in parentheses
+ *   - "113年06月28日(https://mops.twse.com.tw/mops/web/t78sb35)" (date format)
+ *   - "114年第3季(https://mops.twse.com.tw/mops/web/t163sb01)" (quarterly format)
+ *   - "113年06月28日" (date without link)
+ *   - "114年第3季" (quarter without link)
+ *   - "N/A" or empty string
+ * @returns ISO format date string "YYYY-MM-DD", quarterly string "XXX年第X季", or null
+ *
+ * @example
+ * parseFinancialReportDate("113年06月28日(https://...)") // "2024-06-28"
+ * parseFinancialReportDate("114年第3季(https://...)")     // "114年第3季"
+ * parseFinancialReportDate("113年06月28日")             // "2024-06-28"
+ * parseFinancialReportDate("114年第1季")                 // "114年第1季"
+ * parseFinancialReportDate("N/A")                        // null
+ */
+function parseFinancialReportDate(value) {
+    if (!value || value === 'N/A' || value.trim() === '') {
+        return null;
+    }
+    // Extract content before the link: "113年06月28日(https://..." or "114年第3季(https://..."
+    const contentMatch = value.match(/^(.+?)\(/);
+    const content = contentMatch ? contentMatch[1].trim() : value.trim();
+    // Check if it's a quarterly format: "114年第3季"
+    const quarterMatch = content.match(/^\d+年第[1-4]季$/);
+    if (quarterMatch) {
+        return content; // Return original quarterly string
+    }
+    // Otherwise, try to convert as date format
+    return rocToWestern(content);
+}
+exports.parseFinancialReportDate = parseFinancialReportDate;

package/lib/utils/html-cleaner.util.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Strip HTML tags from a string
+ *
+ * Removes all HTML tags and trims whitespace.
+ * Useful for cleaning HTML content in API responses.
+ *
+ * @param html - String potentially containing HTML tags
+ * @returns Plain text with HTML tags removed and whitespace trimmed
+ *
+ * @example
+ * stripHtmlTags("<p>Hello</p>")                                    // "Hello"
+ * stripHtmlTags("<p style='color:red;'>World</p>")                 // "World"
+ * stripHtmlTags("<p>待公告實際收益分配金額</p>")                  // "待公告實際收益分配金額"
+ * stripHtmlTags("Plain text")                                      // "Plain text"
+ */
+export declare function stripHtmlTags(html: string | null | undefined): string;
+/**
+ * Extract text content from table cell that may contain HTML
+ *
+ * This is a convenience wrapper around stripHtmlTags specifically
+ * for extracting text from table cells in scraped data.
+ *
+ * @param cell - Cell content that may contain HTML
+ * @returns Plain text content
+ *
+ * @example
+ * extractTextFromCell("<p style='text-align:center;'>待公告</p>")  // "待公告"
+ */
+export declare function extractTextFromCell(cell: string | null | undefined): string;

package/lib/utils/html-cleaner.util.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTextFromCell = exports.stripHtmlTags = void 0;
+/**
+ * Strip HTML tags from a string
+ *
+ * Removes all HTML tags and trims whitespace.
+ * Useful for cleaning HTML content in API responses.
+ *
+ * @param html - String potentially containing HTML tags
+ * @returns Plain text with HTML tags removed and whitespace trimmed
+ *
+ * @example
+ * stripHtmlTags("<p>Hello</p>")                                    // "Hello"
+ * stripHtmlTags("<p style='color:red;'>World</p>")                 // "World"
+ * stripHtmlTags("<p>待公告實際收益分配金額</p>")                  // "待公告實際收益分配金額"
+ * stripHtmlTags("Plain text")                                      // "Plain text"
+ */
+function stripHtmlTags(html) {
+    if (html == null) {
+        return '';
+    }
+    const strValue = String(html);
+    // Remove all HTML tags
+    const withoutTags = strValue.replace(/<[^>]*>/g, '');
+    // Trim whitespace
+    return withoutTags.trim();
+}
+exports.stripHtmlTags = stripHtmlTags;
+/**
+ * Extract text content from table cell that may contain HTML
+ *
+ * This is a convenience wrapper around stripHtmlTags specifically
+ * for extracting text from table cells in scraped data.
+ *
+ * @param cell - Cell content that may contain HTML
+ * @returns Plain text content
+ *
+ * @example
+ * extractTextFromCell("<p style='text-align:center;'>待公告</p>")  // "待公告"
+ */
+function extractTextFromCell(cell) {
+    return stripHtmlTags(cell);
+}
+exports.extractTextFromCell = extractTextFromCell;

package/lib/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './as-index.util';
+export * from './as-industry.util';
+export * from './as-exchange.util';
+export * from './is-warrant.util';
+export * from './date-converter.util';
+export * from './parse-numeric.util';
+export * from './html-cleaner.util';

package/lib/utils/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./as-index.util"), exports);
+__exportStar(require("./as-industry.util"), exports);
+__exportStar(require("./as-exchange.util"), exports);
+__exportStar(require("./is-warrant.util"), exports);
+__exportStar(require("./date-converter.util"), exports);
+__exportStar(require("./parse-numeric.util"), exports);
+__exportStar(require("./html-cleaner.util"), exports);

package/lib/utils/is-warrant.util.d.ts

@@ -0,0 +1 @@
+export declare function isWarrant(symbol: string): boolean;

package/lib/utils/is-warrant.util.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWarrant = void 0;
+function isWarrant(symbol) {
+    const rules = [
+        /^0[3-8][0-9][0-9][0-9][0-9]$/,
+        /^0[3-8][0-9][0-9][0-9]P$/,
+        /^0[3-8][0-9][0-9][0-9]F$/,
+        /^0[3-8][0-9][0-9][0-9]Q$/,
+        /^0[3-8][0-9][0-9][0-9]C$/,
+        /^0[3-8][0-9][0-9][0-9]B$/,
+        /^0[3-8][0-9][0-9][0-9]X$/,
+        /^0[3-8][0-9][0-9][0-9]Y$/,
+        /^7[0-3][0-9][0-9][0-9][0-9]$/,
+        /^7[0-3][0-9][0-9][0-9]P$/,
+        /^7[0-3][0-9][0-9][0-9]F$/,
+        /^7[0-3][0-9][0-9][0-9]Q$/,
+        /^7[0-3][0-9][0-9][0-9]C$/,
+        /^7[0-3][0-9][0-9][0-9]B$/,
+        /^7[0-3][0-9][0-9][0-9]X$/,
+        /^7[0-3][0-9][0-9][0-9]Y$/, // 上櫃國內標的可展延上限型認售權證
+    ];
+    return rules.some(regex => regex.test(symbol));
+}
+exports.isWarrant = isWarrant;

package/lib/utils/parse-numeric.util.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parse numeric value from string with null-safe handling
+ *
+ * Handles various empty/invalid representations:
+ * - Empty string, null, undefined
+ * - "--" (common placeholder)
+ * - "N/A" (not applicable)
+ * - Whitespace-only strings
+ *
+ * @param value - String value to parse
+ * @returns Parsed number or null if value is empty/invalid
+ *
+ * @example
+ * parseNumeric("123.45")    // 123.45
+ * parseNumeric("--")        // null
+ * parseNumeric("")          // null
+ * parseNumeric("N/A")       // null
+ * parseNumeric("  ")        // null
+ * parseNumeric("0")         // 0
+ */
+export declare function parseNumeric(value: string | null | undefined): number | null;

package/lib/utils/parse-numeric.util.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNumeric = void 0;
+const numeral = require("numeral");
+/**
+ * Parse numeric value from string with null-safe handling
+ *
+ * Handles various empty/invalid representations:
+ * - Empty string, null, undefined
+ * - "--" (common placeholder)
+ * - "N/A" (not applicable)
+ * - Whitespace-only strings
+ *
+ * @param value - String value to parse
+ * @returns Parsed number or null if value is empty/invalid
+ *
+ * @example
+ * parseNumeric("123.45")    // 123.45
+ * parseNumeric("--")        // null
+ * parseNumeric("")          // null
+ * parseNumeric("N/A")       // null
+ * parseNumeric("  ")        // null
+ * parseNumeric("0")         // 0
+ */
+function parseNumeric(value) {
+    // Check for null/undefined
+    if (value == null) {
+        return null;
+    }
+    // Convert to string if needed
+    const strValue = String(value).trim();
+    // Check for empty or placeholder values
+    if (isEmptyValue(strValue)) {
+        return null;
+    }
+    // Parse using numeral
+    const parsed = numeral(strValue).value();
+    // Validate result
+    if (parsed === null || isNaN(parsed)) {
+        return null;
+    }
+    return parsed;
+}
+exports.parseNumeric = parseNumeric;
+/**
+ * Check if a value represents an empty/invalid numeric value
+ *
+ * @param value - String value to check
+ * @returns true if value is considered empty/invalid
+ */
+function isEmptyValue(value) {
+    if (!value || value.trim() === '') {
+        return true;
+    }
+    // Common placeholder values
+    const placeholders = ['--', 'N/A', 'n/a', '－－', '尚未公告', '待公告'];
+    return placeholders.includes(value);
+}