@watsonserve/stock-base 0.0.29 → 0.1.0

package/build.mjs

@@ -0,0 +1,27 @@
+import { readFile, writeFile } from 'fs/promises';
+
+(async function run() {
+  const txt = await readFile('./package.json', 'utf-8');
+  const pkg = JSON.parse(txt);
+  pkg.main = 'index.js';
+  pkg.types = './types/index.d.ts';
+  delete pkg.devDependencies;
+  delete pkg.packageManager;
+  pkg.publishConfig = { access: 'public' };
+  await writeFile('dist/package.json', JSON.stringify(pkg, null, 2));
+})();
+
+// const tsc = spawn('tsc', ['-p', 'tsconfig.json']);
+
+// tsc.stdout.on('data', (data) => {
+//   console.log(`stdout: ${data}`);
+// });
+
+// tsc.stderr.on('data', (data) => {
+//   console.error(`stderr: ${data}`);
+// });
+
+// tsc.on('close', (code) => {
+//   console.log(`child process exited with code ${code}`);
+//   !code && run();
+// });

package/{index.js → dist/index.js}

@@ -7,6 +7,17 @@ export * from './helper.js';
 function parseUTCDate(str) {
     return ~~(Date.UTC(+str.slice(0, 4), +str.slice(4, 6) - 1, +str.slice(6, 8)) / 1000);
 }
+const HKDict = Object.entries({
+    'The first day of January': 'New Year\'s Day',
+    'Lunar New Year’s Day': 'Chinese New Year',
+    'Hong Kong Special Administrative Region': 'HK SAR',
+    '香港公眾假期 -': '',
+    'Hong Kong Public Holidays -': '',
+    'The day following': ''
+});
+function simpleTitle(title = '') {
+    return HKDict.reduce((str, [k, v]) => str.replace(k, v), title).trim();
+}
 export class StockLoader extends DividendLoader {
     async loadHolidaysSG(year) {
         const resp = await fetch(`https://www.mom.gov.sg/-/media/mom/documents/employment-practices/public-holidays/public-holidays-sg-${year}.ics`);
@@ -29,11 +40,11 @@ export class StockLoader extends DividendLoader {
         }, []);
     }
     async loadHolidaysHK() {
-        const resp = await fetch('https://www.hkex.com.hk/News/HKEX-Calendar/Subscribe-Calendar?sc_lang=zh-HK');
+        const resp = await fetch('https://www.hkex.com.hk/News/HKEX-Calendar/Subscribe-Calendar?sc_lang=en');
         const text = (await resp.text()).replace(/\r\n/g, '\n').replace(/\n\n/g, '\n'); // handle line folding
         return text.split('\nEND:VEVENT\nBEGIN:VEVENT\n').reduce((pre, blk) => {
             const ev = new Map(blk.split('\n').map(line => line.split(':', 2)));
-            if ('香港市場休市' !== ev.get('DESCRIPTION'))
+            if (!['香港市場休市', 'Hong Kong Market is closed'].includes(ev.get('DESCRIPTION') || ''))
                 return pre;
             const start = parseUTCDate(ev.get('DTSTART;VALUE=DATE') || '');
             let end = parseUTCDate(ev.get('DTEND;VALUE=DATE') || '');
@@ -45,7 +56,7 @@ export class StockLoader extends DividendLoader {
                 lastOne.end = end;
             }
             else {
-                pre.push({ market: 'HK', title: ev.get('SUMMARY') || '', start, end });
+                pre.push({ market: 'HK', title: simpleTitle(ev.get('SUMMARY')), start, end });
             }
             return pre;
         }, []);

package/dist/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@watsonserve/stock-base",
+  "version": "0.1.0",
+  "description": "",
+  "type": "module",
+  "main": "index.js",
+  "types": "./types/index.d.ts",
+  "scripts": {
+    "build": "rm -rf ./dist && tsc && node ./build.mjs"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "playwright": "^1.58.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/package.json

@@ -1,20 +1,22 @@
 {
   "name": "@watsonserve/stock-base",
-  "version": "0.0.29",
+  "version": "0.1.0",
   "description": "",
   "type": "module",
-  "main": "index.js",
-  "types": "./types/index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
   "scripts": {
     "build": "rm -rf ./dist && tsc && node ./build.mjs"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
+  "packageManager": "pnpm@10.33.0",
   "peerDependencies": {
     "playwright": "^1.58.2"
   },
-  "publishConfig": {
-    "access": "public"
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2"
   }
-}
+}

package/src/close-time.ts

@@ -0,0 +1,124 @@
+import { EnMarket } from './stock.js';
+
+export const A_MIN_MS = 60000;
+export const A_HOUR_MS = 3600000;
+export const A_DAY_MS = 86400000;
+export const A_DAY_S = 86400;
+
+// 夏令时：3月最后一个周日凌晨1AM开始夏令时，10月最后一个周日凌晨2AM结束夏令时
+function isDST_ByUK(timestamp: number): boolean {
+  const date = new Date(timestamp);
+  const year = date.getUTCFullYear();
+
+  // 英国夏令时：3月最后一个周日开始，10月最后一个周日结束
+  const march = new Date(Date.UTC(year, 2, 31));
+  const october = new Date(Date.UTC(year, 9, 31));
+
+  // 夏令时开始和结束的日期
+  const dstStart = new Date(Date.UTC(year, 2, 31 - march.getUTCDay(), 1)); // 3月最后一个周日凌晨1点
+  const dstEnd = new Date(Date.UTC(year, 9, 31 - october.getUTCDay(), 1)); // 10月最后一个周日凌晨2点 = UTC时间凌晨1点
+
+  return timestamp >= dstStart.getTime() && timestamp < dstEnd.getTime();
+}
+
+/**
+ * 判断给定时间戳（毫秒）是否处于美国东部夏令时（EDT）
+ * 夏令时：3月第二个周日 02:00 开始（时钟拨快至 03:00），11月第一个周日 02:00 结束（时钟拨回至 01:00）
+ */
+function isDST_ByEST(timestamp: number): boolean {
+  const date = new Date(timestamp);
+  const year = date.getUTCFullYear();
+
+  // 计算3月1日是星期几（UTC）
+  const march = new Date(Date.UTC(year, 2, 1)); // UTC 时间：3月1日 00:00
+  const november = new Date(Date.UTC(year, 10, 1));
+
+  const marchDay = (7 - march.getUTCDay()) % 7 + 8; // 第二个周日（1~7是第一个周日，8~14是第二个）
+  const novemberDay = (7 - november.getUTCDay()) % 7 + 1; // 第一个周日
+
+  const dstStart = Date.UTC(year, 2, marchDay, 7); // UTC 时间 7点
+  const dstEnd = Date.UTC(year, 10, novemberDay, 6); // UTC 时间 6点
+
+  // 处于夏令时：在开始之后，结束之前
+  return timestamp >= dstStart && timestamp < dstEnd;
+}
+
+/**
+ * 获取市场 正式开盘时区偏移，单位分钟
+ * @param dst 是否夏令时
+ * @returns 分钟数
+ */
+function getOpenTimeByUTC(market: EnMarket, time: number): number {
+  switch (market) {
+    case EnMarket.JPX:
+      return 0; // 9:00
+    case EnMarket.CHN:
+      return 90; // 9:30
+    case EnMarket.HKEX:
+      return 90; // 9:30
+    case EnMarket.SGX:
+      return 60; // 9:00
+    case EnMarket.LSE:
+      return isDST_ByUK(time) ? 420 : 480; // 7:00 or 8:00
+    case EnMarket.USA:
+      return isDST_ByEST(time) ? 810 : 870; // 13:30 or 14:30
+    default:
+  }
+  throw new Error(`Unsupported market: ${market}`);
+}
+
+/**
+ * 获取市场时区偏移，单位分钟
+ * @param dst 是否夏令时
+ * @returns 分钟数
+ */
+function getCloseTimeByUTC(market: EnMarket, time: number): number {
+  switch (market) {
+    case EnMarket.JPX:
+      return 390; // 6:30
+    case EnMarket.CHN:
+      return 420; // 7:00
+    case EnMarket.HKEX:
+      return 490; // 8:10
+    case EnMarket.SGX:
+      return 556; // 9:16
+    case EnMarket.LSE:
+      return isDST_ByUK(time) ? 930 : 990; // 15:30 or 16:30
+    case EnMarket.USA:
+      return isDST_ByEST(time) ? 1200 : 1260; // 20:00 or 21:00
+    case EnMarket.FX:
+      return isDST_ByEST(time) ? 1260 : 1320; // 21:00 or 22:00
+    default:
+  }
+  throw new Error(`Unsupported market: ${market}`);
+}
+
+/**
+ * 获取市场收盘时间戳，单位秒
+ * @param market 市场
+ * @param time 可选时间戳（毫秒），默认为当前时间，用于确定日期和夏令时状态
+ * @returns 市场收盘秒级时间戳
+ */
+export function getMarketCloseTime(market: EnMarket, time = Date.now()): number {
+  const d = new Date(time); // 确保 time 是有效的时间戳
+  switch (d.getUTCDay()) {
+    case 6:
+      time -= 86400000;
+      break;
+    case 0:
+      time -= 172800000;
+      break;
+    default:
+  }
+  const dayStart = (~~(time / A_DAY_MS)) * A_DAY_MS;
+  const closeTimestamp = dayStart + getCloseTimeByUTC(market, time) * A_MIN_MS;
+  let openTimestamp = 0;
+  if (EnMarket.FX !== market) {
+    openTimestamp = dayStart + getOpenTimeByUTC(market, time) * A_MIN_MS;
+  }
+
+  // after market open time, return close time of the day
+  if (openTimestamp < time) return ~~(closeTimestamp / 1000);
+  // return close time of the previous day
+  return getMarketCloseTime(market, closeTimestamp - A_DAY_MS);
+}

package/src/dividend-loader.ts

@@ -0,0 +1,195 @@
+import { log } from './log.js';
+import PriceLoader from './price-loader.js';
+import { ttm } from './helper.js';
+import { type IDiv, type IDividend } from './stock.js';
+
+function toDivPoint(fullNc: string, div: IDividend) {
+  const { annc, ex, paid, ...another } = div;
+  return {
+    ...another,
+    nc: fullNc,
+    annc: ~~(annc.getTime() / 1000),
+    ex: ~~(ex.getTime() / 1000),
+    paid: ~~(paid.getTime() / 1000)
+  } as IDiv;
+}
+
+const rxDate = /\d+/g;
+
+function dateCNtoDate(str: string) {
+  const ymd = (str as string).match(rxDate)?.slice(0, 3).map(i => +i);
+  if (!ymd) return null;
+  if ('number' === typeof ymd?.[1]) {
+    ymd[1] -= 1;
+  }
+  return new Date(Date.UTC.apply(null, ymd as any));
+}
+
+export class DividendLoader extends PriceLoader {
+  private async __laodIbmCode(nc: string) {
+    const resp = await super.get(`https://api.sgx.com/marketmetadata/v2?stock-code=${nc}`);
+    return resp.data?.[0]?.ibmCode || '';
+  }
+
+  private async __loadHKDividend(nc: string) {
+    const token = await super._loadHkexToken();
+    const qid = Date.now();
+    const callback = `jsonp_${qid}`;
+    const params = { sym: +nc, token, lang: 'chi', recperpage: 5, page: 1, qid, callback };
+
+    const resp: string = await super.get('https://www1.hkex.com.hk/hkexwidget/data/getequityentitlement', params);
+    const strJson = resp.substring(callback.length + 1, resp.length - 1);
+    const { entitlementlist } = JSON.parse(strJson).data;
+
+    const list: IDividend[] = [];
+    for (const item of entitlementlist) {
+      const { detail, announcement_date, ex_date, payment_date, announcement_URL } = item;
+
+      const annc = dateCNtoDate(announcement_date);
+      const ex = dateCNtoDate(ex_date);
+      const paid = dateCNtoDate(payment_date);
+
+      const divid = Array.from<string>(detail.match(/(USD|HKD|GBP) (\d+\.\d+)/g) || [])
+        .reduce<Record<string, any>>((pre, item) => {
+          const [currency, amount] = item.split(' ');
+          pre[currency] = { currency, amount: +amount };
+          return pre;
+        }, {});
+
+      list.push({ ...(divid['HKD'] || divid['USD'] || divid['GBP']), annc, ex, paid, announcement_URL });
+    }
+
+    return [ttm<IDividend>('ex', list), []];
+  }
+
+  private async __loadSGDividend(nc: string) {
+    const ibmcode = await this.__laodIbmCode(nc);
+    const params = {
+      pagesize: 15,
+      pagestart: 0,
+      ibmcode,
+      params: 'id,anncType,dateAnnc,exDate,name,particulars,recDate,datePaid',
+      order: 'desc',
+      orderBy: 'dateAnnc'
+    };
+
+    const { data } = await super.get('https://api.sgx.com/corporateactions/v1.0', params);
+
+    const bonus: IDividend[] = [];
+    const dividend: IDividend[] = [];
+
+    for (const item of data as any[]) {
+      const { anncType, particulars, dateAnnc, exDate, recDate, datePaid } = item;
+      const annc = new Date(dateAnnc);
+      const ex = new Date(exDate);
+      const rec = new Date(recDate); // 登记日
+      const paid = new Date(datePaid);
+
+      if ('DIVIDEND' === anncType) {
+        const amount = +particulars.match(/SGD (\d+\.\d+)/)?.[1] || 0;
+        const lstIdx = dividend.length - 1;
+        if (dividend[lstIdx]?.ex.getTime() === ex.getTime() && amount) {
+          dividend[lstIdx].amount! += amount;
+        } else {
+          dividend.push({ currency: 'SGD', amount, annc, ex, rec, paid } as IDividend);
+        }
+        continue;
+      }
+      if ('BONUS' === anncType) { // particulars: 'Ratio: 10:1'
+        const ratio = particulars.match(/Ratio: (\d+:\d+)/);
+        const [foo, bar] = ratio[1].split(':');
+
+        bonus.push({ currency: 'SGD', ratio: 1+(+bar)/(+foo), annc, ex, rec, paid } as IDividend);
+        continue;
+      }
+    }
+
+    return [ttm<IDividend>('ex', dividend), bonus];
+  }
+
+  private async __loadUSDividend(nc: string) {
+    const params = {
+      reportName: 'RPT_USF10_INFO_DIVIDEND',
+      columns: 'SECUCODE,SECURITY_CODE,SECURITY_NAME_ABBR,SECURITY_INNER_CODE,NOTICE_DATE,ASSIGN_TYPE,PLAN_EXPLAIN,EQUITY_RECORD_DATE,BONUS_PAY_DATE,EX_DIVIDEND_DATE,ASSIGN_PERIOD',
+      // filter: `(SECUCODE="${nc}.N")`,
+      filter: `(SECURITY_CODE="${nc.replace('.', '_')}")`,
+      pageNumber: 1,
+      pageSize: 200,
+      sortTypes: -1,
+      sortColumns: 'EX_DIVIDEND_DATE',
+      source: 'SECURITIES',
+      client: 'PC',
+      v: Math.random().toString().substring(2).padStart(17, '0')
+    };
+
+    const strResp = await super.get('https://datacenter.eastmoney.com/securities/api/data/v1/get', params);
+    const data = (JSON.parse(strResp).result?.data || [])as any[];
+
+    const dividend: IDividend[] = [];
+
+    for (const item of data) {
+      const { ASSIGN_TYPE, PLAN_EXPLAIN, NOTICE_DATE, EX_DIVIDEND_DATE, BONUS_PAY_DATE } = item;
+
+      if ('Cash' === ASSIGN_TYPE || 'Special cash' === ASSIGN_TYPE) {
+        const amount = +PLAN_EXPLAIN.match(/(\d*\.?\d+)美元/)[1]; // 每1股派0.82美元股息
+        if (!amount) console.warn(item);
+        dividend.push({
+          currency: 'USD',
+          amount,
+          annc: new Date(NOTICE_DATE),
+          ex: new Date(EX_DIVIDEND_DATE),
+          paid: new Date(BONUS_PAY_DATE),
+        });
+        continue;
+      }
+    }
+
+    return [ttm<IDividend>('ex', dividend), []];
+  }
+
+  async loadDividend(fullNc: string) {
+    const nc = fullNc.substring(0, fullNc.length - 3);
+    const market = fullNc.substring(fullNc.length - 2);
+    let data: IDividend[][];
+    log.info(`start loading ${fullNc} dividend...`);
+
+    switch (market) {
+      case 'SG':
+        data = await this.__loadSGDividend(nc);
+        break;
+      case 'HK':
+        data = await this.__loadHKDividend(nc);
+        break;
+      case 'US':
+        data = await this.__loadUSDividend(nc);
+        break;
+      default:
+        throw new Error(`Unsupported market: ${market}`);
+    }
+    const [div, bonus] = data;
+    const dps = div.map(item => toDivPoint(fullNc, item));
+    const bps = bonus.map(item => toDivPoint(fullNc, item));
+
+    log.info(`finished loading ${fullNc} dividend`);
+
+    return { fullNc, nc, dps, bps };
+  }
+
+  async loadDividends(ncs: string[]) {
+    const ign: string[] = [];
+    let points: IDiv[] = [];
+    const divPool: Record<string, IDiv[]> = {};
+
+    const divs = await Promise.all(ncs.map(fullNc => this.loadDividend(fullNc)));
+    for (const { fullNc, nc, dps, bps } of divs) {
+      if (!dps.length && !bps.length) {
+        ign.push(fullNc);
+      } else {
+        points = points.concat(dps, bps);
+      }
+      divPool[nc] = ttm('ex', dps);
+    }
+
+    return { ign, points, divPool };
+  }
+}

package/src/helper.ts

@@ -0,0 +1,37 @@
+import { EnMarket } from './stock.js';
+
+export function sleep(t = 0) {
+  return new Promise(resolve => setTimeout(resolve, t));
+}
+
+export function splitFullNc(fullNc: string) {
+  const nc = fullNc.substring(0, fullNc.length - 3);
+  const market = {
+    US: EnMarket.USA,
+    SG: EnMarket.SGX,
+    HK: EnMarket.HKEX
+  }[fullNc.substring(fullNc.length - 2)];
+  return { nc, market };
+}
+
+export function groupBy<T extends Record<string, any>>(key: string, list: T[], delKey = false) {
+  return list.reduce<Record<string, T[]>>((pre, item) => {
+    const foo = item[key];
+    const fooList = pre[foo] || [];
+    pre[foo] = fooList;
+    if (delKey) delete item[key];
+    fooList.push(item);
+    return pre;
+  }, {});
+}
+
+export function ttm<T>(by: string, list: any[]): T[] {
+  if (!Array.isArray(list) || !list.length) return [];
+
+  const latest = new Date(list[0][by]);
+  const sinceTime = Date.UTC(latest.getUTCFullYear()-1, latest.getUTCMonth());
+  return list.filter(item => {
+    const val = new Date(item[by]);
+    return sinceTime < Date.UTC(val.getUTCFullYear(), val.getUTCMonth());
+  });
+}

package/src/history-loader.ts

@@ -0,0 +1,114 @@
+import fs from 'fs/promises';
+import { EnMarket, IFx, type IStockPoint } from './stock.js';
+import { getMarketCloseTime } from './close-time.js';
+import WebRequest from './web-request.js';
+import { sleep, splitFullNc } from './helper.js';
+
+// 历史数据
+export default class HistoryLoader extends WebRequest {
+  private async __getHKOrUSAHistory(market: EnMarket, nc: string): Promise<IStockPoint[]> {
+    let cntry = EnMarket.USA === market ? 'us' : 'hk';
+    await this.goto(`https://quote.eastmoney.com/${cntry}/${nc}.html`);
+
+    let secid = `116.${nc}`;
+    if (EnMarket.USA === market) {
+      await sleep(500);
+      // secid = await this.get_em_code(nc);
+      secid = await this.read('quotecode');
+    }
+
+    const params = {
+      fields1: 'f1,f2,f3,f4,f5,f6',
+      fields2: 'f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61',
+      klt: 101, // 60 hour, 101 day, 102 week, 103 month
+      fqt: 0,
+      secid,
+      beg: 0,
+      end: 20500000,
+      // ut: 'bd1d9ddb04089700cf9c27f6f7426281',
+      // lmt: 1000000,
+    };
+    if (this.isDebug) {
+      await sleep(5000);
+    }
+    const resp = await super.get('https://push2his.eastmoney.com/api/qt/stock/kline/get', params);
+    // const resp = JSON.parse(await fs.readFile(path.join(import.meta.dirname, 'hsbc.json'), 'utf-8'));
+    const { klines } = resp.data;
+    return (klines as string[]).map(line => {
+      const [date, open, close, hight, low, vol] = line.split(',');
+      return {
+        market,
+        timestamp: getMarketCloseTime(market, new Date(`${date}T15:00:00Z`).getTime()),
+        st: { nc, n: '', o:+open, c:+close, h:+hight, l:+low, v:+vol }
+      };
+    });
+  }
+
+  private async __getSGXHistory(nc: string): Promise<IStockPoint[]> {
+    const rsp = await super.get(`https://api.sgx.com/securities/v1.1/charts/historic/stocks/code/${nc}/5y`, { params: 'trading_time,vl,lt' });
+    const { historic } = rsp.data;
+    return (historic as any[]).map(st => {
+      const { trading_time, vl: v, lt: c } = st;
+      const fullYear = trading_time.substring(0, 4);
+      const month = trading_time.substring(4, 6);
+      const date = trading_time.substring(6, 8);
+      const timestamp = ~~(new Date(`${fullYear}-${month}-${date}T09:16:00Z`).getTime() / 1000);
+      return { market: EnMarket.SGX, timestamp, st: { nc, n: '', o: 0, c, h: 0, l: 0, v } };
+    });
+  }
+
+  async loadFxHistory() {
+    const fxs = await Promise.all(['USDHKD', 'USDSGD', 'USDCNY'].map(
+      code => this.get(
+        'https://finance.pae.baidu.com/vapi/v1/getquotation',
+        { group: 'huilv_kline', ktype: 'day', code, finClientType: 'pc' }
+      )
+    ));
+    const [hk, sg, cn] = fxs.map(body => (body.Result.newMarketData.marketData as string).split(';'));
+    const base = new Map(hk.map(line => {
+      const [_0, date, _1, c] = line.split(',');
+      const stamp = getMarketCloseTime(EnMarket.FX, new Date(`${date}T15:00:00Z`).getTime());
+      return [stamp, { date, HKD: +c } as Partial<IFx>];
+    }));
+    sg.forEach(line => {
+      const [_0, date, _1, c] = line.split(',');
+      const stamp = getMarketCloseTime(EnMarket.FX, new Date(`${date}T15:00:00Z`).getTime());
+      const fx = base.get(stamp) || { date } as Partial<IFx>;
+      fx.SGD = +c;
+      base.set(stamp, fx);
+    });
+    cn.map(line => {
+      const [_0, date, _1, c] = line.split(',');
+      const stamp = getMarketCloseTime(EnMarket.FX, new Date(`${date}T15:00:00Z`).getTime());
+      const fx = base.get(stamp) || { date } as Partial<IFx>;
+      fx.CNY = +c;
+      base.set(stamp, fx);
+    });
+    const result: IFx[] = [];
+    const remain: IFx[] = [];
+    [...base.entries()].forEach(([stamp, fx]) => {
+      const _fx = { stamp, ...fx } as IFx;
+      if (!fx.HKD || !fx.SGD || !fx.CNY) {
+        remain.push(_fx);
+        return;
+      }
+      result.push(_fx);
+    });
+
+    return { result, remain };
+  }
+
+  loadHistory(fullNc: string) {
+    const { nc, market } = splitFullNc(fullNc);
+
+    switch (market) {
+      case EnMarket.SGX:
+        return this.__getSGXHistory(nc);
+      case EnMarket.HKEX:
+      case EnMarket.USA:
+        return this.__getHKOrUSAHistory(market, nc);
+      default:
+    }
+    throw new Error(`Unsupported market: ${market}`);
+  }
+}

package/src/index.ts

@@ -0,0 +1,83 @@
+import { A_DAY_S } from './close-time.js';
+import { DividendLoader } from './dividend-loader.js';
+import { IHoliday } from './stock.js';
+
+export * from './close-time.js';
+export * from './stock.js';
+export * from './log.js';
+export * from './helper.js';
+
+function parseUTCDate(str: string) {
+  return ~~(Date.UTC(+str.slice(0, 4), +str.slice(4, 6) - 1, +str.slice(6, 8)) / 1000);
+}
+
+const HKDict = Object.entries({
+  'The first day of January': 'New Year\'s Day',
+  'Lunar New Year’s Day': 'Chinese New Year',
+  'Hong Kong Special Administrative Region': 'HK SAR',
+  '香港公眾假期 -': '',
+  'Hong Kong Public Holidays -': '',
+  'The day following': ''
+});
+
+function simpleTitle(title = '') {
+  return HKDict.reduce((str, [k, v]) => str.replace(k, v), title).trim();
+}
+
+export class StockLoader extends DividendLoader {
+  async loadHolidaysSG(year: number) {
+    const resp = await fetch(`https://www.mom.gov.sg/-/media/mom/documents/employment-practices/public-holidays/public-holidays-sg-${year}.ics`);
+    const text = (await resp.text()).replace(/\r\n/g, '\n').replace(/\n\n/g, '\n'); // handle line folding
+
+    return text.split('\nEND:VEVENT\nBEGIN:VEVENT\n').reduce<IHoliday[]>((pre, blk) => {
+      const ev = new Map(blk.split('\n').map(line => line.split(':', 2) as [string, string]));
+      let start = parseUTCDate(ev.get('DTSTART;VALUE=DATE') || '');
+      let end = parseUTCDate(ev.get('DTEND;VALUE=DATE') || '');
+      if (start === end) {
+        end += A_DAY_S;
+      }
+      // recording to SG calendar, we will move it to next day(Monday, 1) if holiday is Sunday(0)
+      if (!new Date(start * 1000).getUTCDay()) {
+        end += A_DAY_S;
+      }
+      const firstOne = pre[0];
+      const title = ev.get('SUMMARY') || '';
+
+      (firstOne && end === firstOne.start) ? Object.assign(firstOne, { title, start }) : pre.unshift({ market: 'SG', title, start, end });
+      return pre;
+    }, []);
+  }
+
+  async loadHolidaysHK() {
+    const resp = await fetch('https://www.hkex.com.hk/News/HKEX-Calendar/Subscribe-Calendar?sc_lang=en');
+    const text = (await resp.text()).replace(/\r\n/g, '\n').replace(/\n\n/g, '\n'); // handle line folding
+
+    return text.split('\nEND:VEVENT\nBEGIN:VEVENT\n').reduce<IHoliday[]>((pre, blk) => {
+      const ev = new Map(blk.split('\n').map(line => line.split(':', 2) as [string, string]));
+
+      if (!['香港市場休市', 'Hong Kong Market is closed'].includes(ev.get('DESCRIPTION') || '')) return pre;
+
+      const start = parseUTCDate(ev.get('DTSTART;VALUE=DATE') || '');
+      let end = parseUTCDate(ev.get('DTEND;VALUE=DATE') || '');
+      if (start === end) {
+        end += A_DAY_S;
+      }
+      const lastOne = pre[pre.length - 1];
+      if (lastOne && start === lastOne.end) {
+        lastOne.end = end;
+      } else {
+        pre.push({ market: 'HK', title: simpleTitle(ev.get('SUMMARY')), start, end });
+      }
+
+      return pre;
+    }, []);
+  }
+
+  async loadHolidays() {
+    const [holidaysSG, holidaysHK] = await Promise.all([
+      this.loadHolidaysSG(new Date().getUTCFullYear()),
+      this.loadHolidaysHK()
+    ]);
+    return holidaysSG.concat(holidaysHK);
+  }
+}

package/src/log.ts

@@ -0,0 +1,49 @@
+import { appendFile } from 'fs/promises';
+
+export enum EnLogLevel {
+  DEBUG = 7,
+  INFO = 6,
+  WARN = 4,
+  ERROR = 3,
+}
+
+function findAppName() {
+  const __dirPath = process.argv.find(arg => arg.endsWith('.js'))?.split('/').reverse().slice(1) || [];
+  if (['release', 'src', 'dist'].includes(__dirPath[0])) {
+    __dirPath.shift();
+  }
+  return __dirPath[0];
+}
+
+export class Log {
+  private _logDir = `/var/log/${process.env.APP_NAME || findAppName()}`;
+  public level = EnLogLevel.INFO;
+
+  constructor(logDir = '') {
+    if (!logDir) return;
+    this._logDir = logDir;
+  }
+
+  log(lev: EnLogLevel, msg: string) {
+    if (lev > this.level) return Promise.resolve();
+    return appendFile(`${this._logDir}/${EnLogLevel[lev].toLowerCase()}.log`, `[${new Date().toISOString()}] ${msg}\n`);
+  }
+
+  debug(msg: string) {
+    return this.log(EnLogLevel.DEBUG, msg);
+  }
+
+  info(msg: string) {
+    return this.log(EnLogLevel.INFO, msg);
+  }
+
+  warn(msg: string) {
+    return this.log(EnLogLevel.WARN, msg);
+  }
+
+  error(msg: string | Error) {
+    return this.log(EnLogLevel.ERROR, msg.toString());
+  }
+}
+
+export const log = new Log();

package/src/price-loader.ts

@@ -0,0 +1,125 @@
+import { EnCurrency, EnMarket, type IFx, IStock } from './stock.js';
+import { getMarketCloseTime } from './close-time.js';
+import HistoryLoader from './history-loader.js';
+
+export default class PriceLoader extends HistoryLoader {
+  // 匯率
+  private async __loadFx(ncs: EnCurrency[]) {
+    try {
+      const data = new Map<EnCurrency, number>();
+      for (const nc of ncs) {
+        const body = await this.get('https://finance.pae.baidu.com/selfselect/sug', {wd: `USD${nc}`, skip_login: 1, finClientType: 'pc'});
+        const fx = body.Result.stock[0];
+        data.set(nc, +fx.price);
+      }
+      return Object.fromEntries(data.entries());
+    } catch (err) {
+      throw new Error(`failed to load fx ${(err as Error).message}`); 
+    }
+  }
+
+  async loadFx() {
+    const fxs = await this.__loadFx([EnCurrency.SGD, EnCurrency.HKD, EnCurrency.CNY]);
+    const stamp = getMarketCloseTime(EnMarket.FX);
+    return { ...fxs, stamp } as IFx;
+  }
+
+  // 新加坡交易所全量股票
+  protected async sgx() {
+    try {
+      const body = await this.get('https://api.sgx.com/securities/v1.1/stocks', { params: 'nc,lt,ptd,n,o,h,l,vl,trading_time' });
+      const stockList = body.data.prices as any[];
+      return stockList.map(({ trading_time:t,nc,lt:c,n,o,h,l,vl:v }) => ({ t, nc,n,o,c,h,l,v } as IStock));
+    } catch (err) {
+      throw new Error(`failed to load sgx ${(err as Error).message}`);
+    }
+  }
+
+  // 香港交易所主板股票
+  protected async hkex() {
+    try {
+      const token = await this._loadHkexToken();
+      const qid = Date.now();
+      const callback = `jsonp_${qid}`;
+      const params = {
+        lang: 'chi',
+        token,
+        sort: 5,
+        order: 0,
+        all: 1,
+        subcat: 1,
+        market: 'MAIN',
+        qid,
+        callback,
+      };
+      const resp = await this.get('https://www1.hkex.com.hk/hkexwidget/data/getequityfilter', params);
+      const strJson = resp.substring(callback.length + 1, resp.length - 1);
+      const body = JSON.parse(strJson);
+      const { stocklist } = body.data;
+      return (stocklist as any[]).map(item => {
+        const { sym, nm: n, ls } = item;
+        return { nc: sym.padStart(5, '0'), n, c: +ls } as IStock;
+      });
+    } catch (err) {
+      throw new Error(`failed to load hkex ${(err as Error).message}`);
+    }
+  }
+
+  // 标普500成份股
+  private async __sp500(pn = 0, rn = 100) {
+    const params = {
+      financeType: 'index',
+      market: 'us',
+      code: 'SPX',
+      sortKey: 'marketValue',
+      sortType: 'desc',
+      style: 'tablelist',
+      finClientType: 'pc',
+      pn, rn,
+    };
+
+    try {
+      const resp = await this.get('https://finance.pae.baidu.com/sapi/v1/constituents', params);
+      const stocklist = resp.Result.list.body as any[];
+      return stocklist.map(item => {
+        const { code: nc, name: n, rawData } = item;
+        const { lastPx: c, volume: v, marketValue: mv } = rawData;
+        return { nc, n, c, v, mv } as IStock;
+      });
+    } catch (err) {
+      throw new Error(`failed to load s&p ${(err as Error).message}`);
+    }
+  }
+
+  protected async sp500() {
+    let pn = 0, rn = 100;
+    let sts: IStock[] = [];
+    while (true) {
+      const _sts = await this.__sp500(pn, rn);
+      const _len = _sts.length;
+      sts = sts.concat(_sts);
+      if (_len < rn) break;
+      pn += _len;
+    }
+    return sts;
+  }
+
+  async loadPrice(market: EnMarket) {
+    const stamp = getMarketCloseTime(market);
+    let sts = Promise.resolve<IStock[]>([]);
+    switch (market) {
+      case EnMarket.HKEX:
+        sts = this.hkex();
+        break;
+      case EnMarket.SGX:
+        sts = this.sgx();
+        break;
+      case EnMarket.USA:
+        sts = this.sp500();
+        break;
+      default:
+        throw new Error(`unsupported market ${market}`);
+    }
+    return { sts: await sts, stamp };
+  }
+}

package/src/stock.ts

@@ -0,0 +1,104 @@
+export enum EnMarket {
+  FX = 'FX',
+  JPX = 'JPX',
+  CHN = 'CHN',
+  HKEX = 'HKEX',
+  SGX = 'SGX',
+  LSE = 'LSE',
+  USA = 'USA',
+}
+
+export enum EnCurrency {
+  SGD = 'SGD',
+  USD = 'USD',
+  HKD = 'HKD',
+  CNY = 'CNY',
+}
+
+export interface IFx {
+  stamp: number;
+  [EnCurrency.SGD]: number;
+  [EnCurrency.HKD]: number;
+  [EnCurrency.CNY]: number;
+}
+
+export interface IStockBase {
+  c: number;
+  o?: number;
+  h?: number;
+  l?: number;
+  v?: number;
+}
+
+export interface IStockNum {
+  boll_u: number;
+  boll_l: number;
+  ma_5: number;
+  ma_20: number;
+  ma_60: number;
+  ma_250: number;
+}
+
+export interface IStock extends IStockBase, Partial<IStockNum> {
+  nc: string;
+  n: string;
+}
+
+export interface IStockPoint {
+  market: string;
+  timestamp: number;
+  st: IStock;
+}
+
+export interface IDividend {
+  currency: string;
+  amount?: number;
+  ratio?: number;
+  annc: Date;
+  ex: Date;
+  paid: Date;
+  announcement_URL?: string;
+}
+
+
+export interface IDiv {
+  nc: string;
+  annc: number;
+  ex: number;
+  paid: number;
+  currency: string;
+  amount: number;
+}
+
+export interface IHoliday {
+  market: string;
+  title: string;
+  start: number;
+  end: number;
+}
+
+export class Stock {
+  public nc: string;
+  public name: string;
+  public currency: EnCurrency;
+  public o: number = 0;
+  public c: number = 0;
+  public h: number = 0;
+  public l: number = 0;
+  public v: number = 0;
+
+  constructor(code: string, name = '', currency = EnCurrency.USD) {
+    this.nc = code;
+    this.name = name;
+    this.currency = currency;
+  }
+
+  setInfo(name: string, close: number, open = 0, height = 0, low = 0, vol = 0) {
+    this.name = name;
+    this.o = open;
+    this.c = close;
+    this.h = height;
+    this.l = low;
+    this.v = vol;
+  }
+}

package/src/web-request.ts

@@ -0,0 +1,131 @@
+import { chromium, type Browser, type BrowserContext, type Page } from 'playwright';
+import { A_DAY_MS } from './close-time.js';
+
+export default class WebRequest {
+  private static HKEX_TOKEN = { token: '', t: 0 };
+  private static browser?: Browser;
+  private static context?: BrowserContext;
+  private static pageCnt = 0;
+  private static __promise?: Promise<void>;
+  protected static isDebug: boolean = false;
+  protected page?: Page;
+
+  private static async __getInstance(debug = false) {
+    if (WebRequest.context) return;
+    // 1. 启动 Chromium，禁用 web security（解除 CORS）
+    WebRequest.browser = await chromium.launch({
+      headless: !debug,
+      channel: 'msedge',
+      args: [
+        '--disable-web-security',
+        '--disable-features=IsolateOrigins,site-per-process',
+        '--no-sandbox',
+        '--disable-setuid-sandbox'
+      ]
+    });
+    WebRequest.context = await WebRequest.browser.newContext({});
+  }
+
+  get isDebug() {
+    return WebRequest.isDebug;
+  }
+
+  static async init(isDebug = false) {
+    WebRequest.isDebug = isDebug;
+    if (!WebRequest.__promise)
+      WebRequest.__promise = WebRequest.__getInstance(isDebug);
+  }
+
+  constructor() {}
+
+  async mount() {
+    await WebRequest.__promise;
+
+    this.page = await WebRequest.context!.newPage();
+    WebRequest.pageCnt++;
+    await this.page.goto('about:blank');
+  }
+
+  private static async destroy() {
+    WebRequest.pageCnt--;
+    if (0 < WebRequest.pageCnt) return;
+
+    await WebRequest.context?.close();
+    await WebRequest.browser?.close();
+    WebRequest.context = undefined;
+    WebRequest.browser = undefined;
+    WebRequest.pageCnt = 0;
+    WebRequest.__promise = undefined;
+  }
+
+  async destroy() {
+    if (!this.page) return;
+
+    await this.page.close();
+    this.page = undefined;
+    return WebRequest.destroy();
+  }
+
+  protected fetch(url: string, method: string = 'GET', params?: Record<string, any>, headers?: Record<string, any>) {
+    method = method.toUpperCase();
+    let data = '';
+    if (params) {
+      if (['HEAD', 'GET'].includes(method)) {
+        const uri = new URL(url);
+        const urlParams = Object.fromEntries(uri.searchParams);
+        
+        uri.search = new URLSearchParams(Object.assign(urlParams, params)).toString();
+        url = uri.toString();
+      } else {
+        const ct = (headers?.['Content-Type'] || '').split(';')[0];
+        switch (ct) {
+          case 'application/json':
+            data = JSON.stringify(params);
+            break;
+          default:
+            data = new URLSearchParams(params).toString();
+        }
+        
+      }
+    }
+
+    return this.page!.evaluate(async (conf: any) => {
+      const resp = await fetch(conf.url, {
+        method: conf.method,
+        credentials: 'include', // 如果需要 Cookie
+        headers: conf.headers,
+        body: conf.data || undefined,
+      });
+      if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+      const ct = resp.headers.get('Content-Type')?.split(';')[0] || '';
+      if ('application/json' === ct) return resp.json();
+      if (ct.startsWith('text/')) return resp.text();
+      return resp.arrayBuffer();
+    }, { method, url, headers, data });
+  }
+
+  protected get(url: string, params?: Record<string, any>, headers?: Record<string, any>) {
+    return this.fetch(url, 'GET', params, headers);
+  }
+
+  protected goto(pageUrl: string) {
+    return this.page!.goto(pageUrl);
+  }
+
+  protected read<T>(key: string) : Promise<T> {
+    return this.page!.evaluate(async (conf: any) => {
+      return (window as any)[conf.key];
+    }, { key });
+  }
+
+  protected async _loadHkexToken() {
+    const expiry = Date.now() - A_DAY_MS;
+    if (WebRequest.HKEX_TOKEN?.t > expiry) return WebRequest.HKEX_TOKEN.token;
+
+    const doc = await this.get('https://www.hkex.com.hk/Market-Data/Securities-Prices/Equities?sc_lang=zh-HK');
+    const token = doc.split('//return "Base64-AES-Encrypted-Token";')[1].split('";')[0].split('"')[1];
+    const decodedToken = decodeURIComponent(token);
+    WebRequest.HKEX_TOKEN = { token: decodedToken, t: Date.now() };
+    return decodedToken;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "esnext",           // 👈 关键：编译成 CommonJS 模块
+    "module": "NodeNext",          // 👈 关键：Node.js 默认用 CommonJS
+    "lib": ["es2022", "dom"],      // 包含 includes + 浏览器 API
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "NodeNext",    // 👈 关键：用 Node.js 模块解析
+    "resolveJsonModule": true,
+    "sourceMap": false,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationDir": "./dist/types",
+    "types": ["node", "playwright"] // 显式包含类型
+  },
+  "include": ["src/*.ts"],           // 包含根目录 .ts 文件
+  "exclude": ["node_modules", "build.mjs"]
+}